Rooba
/
gopy
mirror of https://github.com/go-python/gopy.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gopy generates a CPython extension module from a go package.
109 Commits 13 Branches 22 Tags 13 MiB
Go 87.6%
Python 11.7%
Makefile 0.6%
Go to file
Sebastien Binet c8b2a0576b test: typo 
Change-Id: I3dc1c61faee5fa066c73dab7c65fe45caff51587
 		2015-08-07 09:53:39 +02:00
_examples test: typo 2015-08-07 09:53:39 +02:00
bind bind: use GOINTBITS to switch b/w 32b and 64b integers 2015-08-06 18:55:01 +02:00
LICENSE gopy-gen: first import 2015-01-30 18:01:15 +01:00
README.md doc: add tp_as_sequence 2015-08-05 19:51:22 +02:00
cmd_bind.go gopy: reduce verbosity 2015-08-06 18:35:37 +02:00
cmd_gen.go gopy: proper handling of lang option 2015-08-03 14:26:34 +02:00
doc.go all: gopy-gen -> gopy 2015-07-24 16:16:31 +02:00
gen.go all: wire in cpython API version 2015-08-05 14:13:37 +02:00
gopy.py gopy: add gopy convenience python module 2015-08-06 17:28:29 +02:00
main.go all: gopy-gen -> gopy 2015-07-24 16:16:31 +02:00
main_test.go bind: test buffer protocol 2015-08-06 10:01:00 +02:00
python.go gopy: proper handling of lang option 2015-08-03 14:26:34 +02:00

README.md

gopy

gopy generates (and compiles) a CPython extension module from a go package.

Installation

$ go get github.com/go-python/gopy

Documentation

Documentation is available on godoc: https://godoc.org/github.com/go-python/gopy

or directly from the command-line prompt:

$ gopy help
gopy - 

Commands:

    bind        generate and compile (C)Python language bindings for Go
    gen         generate (C)Python language bindings for Go

Use "gopy help <command>" for more information about a command.


$ gopy help gen
Usage: gopy gen <go-package-name>

gen generates (C)Python language bindings for a Go package.

ex:
 $ gopy gen [options] <go-package-name>
 $ gopy gen github.com/go-python/gopy/_examples/hi

Options:
  -lang="python": target language for bindings
  -output="": output directory for bindings


$ gopy help bind
Usage: gopy bind <go-package-name>

bind generates and compiles (C)Python language bindings for a Go package.

ex:
 $ gopy bind [options] <go-package-name>
 $ gopy bind github.com/go-python/gopy/_examples/hi

Options:
  -output="": output directory for bindings

Examples

$ gopy bind -output=out github.com/go-python/gopy/_examples/hi
$ ls out
hi.so

$ cd out
$ python2
>>> import hi
>>> dir(hi)
['Add', 'Concat', 'Hello', 'Hi', 'NewPerson', 'Person', '__doc__', '__file__', '__name__', '__package__']

>>> hi.Hello("you")
hello you from go

You can also run:

go test -v -run=TestBind
=== RUN   TestBind
processing "Add"...
processing "Concat"...
processing "Hello"...
processing "Hi"...
processing "NewPerson"...
processing "Person"...
processing "Add"...
processing "Concat"...
processing "Hello"...
processing "Hi"...
processing "NewPerson"...
processing "Person"...
github.com/go-python/gopy/_examples/hi
_/home/binet/dev/go/root/tmp/gopy-431003574
--- hi.Hi()...
hi from go
--- hi.Hello('you')...
hello you from go
--- hi.Add(1, 41)...
42
--- hi.Concat('4', '2')...
42
--- doc(hi.Person):
Person is a simple struct

--- p = hi.Person()...
<hi.Person object at 0x7fc46cc330f0>
['Age', 'Name', '__class__', '__delattr__', '__doc__', '__format__', '__getattribute__', '__hash__', '__init__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__']
--- p.Name: None
--- p.Age: None
--- doc(p):
Person is a simple struct

--- PASS: TestBind (2.13s)
PASS
ok  	github.com/go-python/gopy	2.135s

Limitations

  • wrap go structs into python classes [DONE]
  • better pythonization: turn go errors into python exceptions [DONE]
  • wrap arrays and slices into types implementing tp_as_sequence [DONE]
  • only python-2 supported for now