Metadata-Version: 2.1
Name: gothon
Version: 0.5.0
Summary: Gothon runs GO Code from Python, just import *.go files from Python.
Home-page: https://github.com/juancarlospaco/gothon#gothon
Author: Juan Carlos
Author-email: juancarlospaco@gmail.com
Maintainer: Juan Carlos
Maintainer-email: juancarlospaco@gmail.com
License: BSD
Download-URL: https://github.com/juancarlospaco/gothon#gothon
Project-URL: Docs, https://github.com/juancarlospaco/gothon/README.md
Project-URL: Bugs, https://github.com/juancarlospaco/gothon/issues
Project-URL: C.I., https://travis-ci.org/juancarlospaco/gothon
Project-URL: Chat, https://t.me/juancarlospaco
Description: # Gothon
        
        Python 3 modules written on pure Go. No CFFI, no CTypes, no CGo, no PyBindGen, just import `*.go` files from Python.
        
        It works using IPC RPC. Inspired by [Cythons `pyximport`](http://cython.readthedocs.io/en/latest/src/tutorial/cython_tutorial.html?highlight=pyximport#pyximport-cython-compilation-for-developers) and [CPPImport](https://github.com/tbenthompson/cppimport#import-c-or-c-files-directly-from-python). Designed to speed up Python using Go.
        
        Open Repo access to anyone who want to contribute, just contact me. **This is a Work In Progress.**
        
        ![screenshot](https://source.unsplash.com/FqkBXo2Nkq0/850x420 "Illustrative Photo by https://unsplash.com/@stickermule")
        
        
        # Use
        
        ```python
        $ ls
        gothon.py  python_module.go
        
        $ python
        Python 3.6.4 (default, Jan  5 2018, 02:35:40)
        
        >>> import gothon                   # Import & enable Gothon.
        >>> gothon.import_hook()
        >>> import python_module            # Import *.go files.
        >>> repr(python_module)
        '<Gothon object 140066220608272 from python_module.go>'
        >>> python_module.__doc__
        'Gothon runs GO Code from Python using IPC RPC JSON.'
        >>> worker = python_module.start()
        >>> worker.call("Echo.Echo", "Hello from Python to Go")
        'Hello from Python to Go'
        >>>
        ```
        
        
        # Install
        
        ```
        pip install gothon
        ```
        - Uninstall `pip uninstall gothon`
        
        
        # Documentation
        
        <details>
            <summary><b>gothon.py</b></summary>
        
        **Description:**
        Gothon runs GO Code from Python using IPC RPC JSON.
        
        Unix Socket are used because from benchmarks it performs 3x faster than TCP/UDP Sockets.
        
        This does not connect to the network, nor internet, nor use HTTP.
        
        Delegates the Parse, Compile, Build and Cache to Go itself.
        
        This project is oriented to Developers, NOT end-users.
        
        This project can be used with Fades, FireJails, Docker, RKT.
        
        This project assumes at least very basic knowledge of the Go programming language.
        
        Feel free to contact us if you need help integrating it on your project.
        
        **Arguments:**
        - `go_file` A GO file to compile and run as a python module, string type, defaults to `python_module.go`, required.
        - `startup_delay` A startup delay, after building the go file but before returning the IPC RPC to Python, float type, defaults to `0.1`, optional.
        
        **Keyword Arguments:** None.
        
        **Returns:** `gothon.RPCJSONClient()` an custom IPC RPC.
        
        **Base Class:** `object`.
        
        **Type:** `object`.
        
        **Source Code file:** https://github.com/juancarlospaco/gothon/blob/master/gothon.py
        
        | State              | OS          | Description |
        | ------------------ |:-----------:| -----------:|
        | :white_check_mark: | **Linux**   | Works Ok    |
        | :white_check_mark: | **Os X**    | Works Ok    |
        
        **Usage Example:**
        
        ```python
        >>> from gothon import Gothon
        >>> unemployed = Gothon()
        >>> worker = unemployed.start()
        >>> worker.call("Echo.Echo", "Hello from Python to Go")
        'Hello from Python to Go'
        >>> worker.stop()
        >>>
        ```
        
        </details>
        
        
        # Requisites
        
        - [Python 3.6+](https://python.org)
        - [Go 1.10+](https://golang.org)
        
        
        ##### Troubleshoot
        
        <details>
            <summary>Not working</summary>
        
        - Delete all `__pycache__` and `*.pyc`.
        - Execute `go clean -x -cache` (Usually Go takes care of cleaning Cache automatically).
        - Update your Go to the latest version.
        </details>
        
        
        # Why
        
        Things that Ive tried and didnt work (2018, Linux):
        
        - https://blog.filippo.io/building-python-modules-with-go-1-5/ (Go 1.5 only)
        - https://github.com/go-python/gopy/issues/83 (Python 2 only)
        - https://github.com/go-python/gopy/blob/master/gen.go#L81 (Python 2 only)
        - https://github.com/sbinet/go-python (Python 2 only)
        - https://dustymabe.com/2016/09/13/sharing-a-go-library-to-python-using-cffi/ (Compiler Errors on embebed obfuscated C)
        - http://pybindgen.readthedocs.io/en/latest/tutorial/#supported-python-versions (Compiler Errors on obfuscated C)
        - https://hackernoon.com/extending-python-3-in-go-78f3a69552ac (All of the above)
        - Other solutions call Python from Go, the reverse of Gothon.
        - Others I dont remember the links.
        
        
        ### Contributors
        
        - **Please Star this Repo on Github !**, it helps to show up faster on searchs.
        - [Help](https://help.github.com/articles/using-pull-requests) and more [Help](https://help.github.com/articles/fork-a-repo) and Interactive Quick [Git Tutorial](https://try.github.io).
        - English is the primary default spoken language, unless explicitly stated otherwise *(eg. Dont send Translation Pull Request)*
        - Pull Requests for working passing unittests welcomed.
        
        
        ### Licence
        
        - BSD.
        
        
        ### Ethics and Humanism Policy
        
        - Religions is not allowed. Contributing means you agree with the COC.
        
Keywords: minimalism,python3,go,golang,ipc,rpc,json,socket,import-hook,speed
Platform: Linux
Platform: Darwin
Classifier: Environment :: Console
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Other Audience
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides: gothon
Requires-Python: >=3.6
Description-Content-Type: text/markdown
