https://github.com/iapyeh/go-python3

https://github.com/iapyeh/go-python3

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/iapyeh/go-python3
• Owner: iapyeh
• License: mit
• Created: 2020-02-24T09:35:17.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-07-26T03:05:42.000Z (over 4 years ago)
• Last Synced: 2024-09-23T09:04:41.208Z (3 months ago)
• Language: Go
• Size: 168 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-python3

**Currently supports python-3.7 only.**

Golang bindings for the C-API of CPython-3.

This package provides a ``go`` package named "python" under which most of the

``PyXYZ`` functions and macros of the public C-API of CPython have been

exposed. Theoretically, you should be able use https://docs.python.org/3/c-api

and know what to type in your ``go`` program.

This project was inspired by https://github.com/sbinet/go-python. Go and take a look if we need something for python-2.7!

# Install

## Deps

We will need `pkg-config` and a working `python3.7` environment to build these

bindings. Make sure you have Python libraries and header files installed as

well (`python3.7-dev` on Debian or `python3-devel` on Centos for example)..

By default `pkg-config` will look at the `python3` library so if you want to

choose a specific version just symlink `python-X.Y.pc` to `python3.pc` or use

the `PKG_CONFIG_PATH` environment variable.

## Go get

Then simply `go get github.com/DataDog/go-python3`

# API

Some functions mix go code and call to Python function. Those functions will

return and `int` and `error` type. The `int` represent the Python result code

and the `error` represent any issue from the Go layer.

Example:

`func PyRun_AnyFile(filename string)` open `filename` and then call CPython API

function `int PyRun_AnyFile(FILE *fp, const char *filename)`.

Therefore its signature is `func PyRun_AnyFile(filename string) (int, error)`,

the `int` represent the error code from the CPython `PyRun_AnyFile` function

and error will be set if we failed to open `filename`.

If an error is raise before calling th CPython function `int` default to `-1`.

Take a look at some [examples](examples)