Go high-level bindings for the CPython-3 C-API

Important

Currently supports python-3.11 only.

The package provides a higher level for interacting with Python-3 C-API without directly using the PyObject.

Main goals:

• Provide generic a Object that interact with Golang types.
• Automatically marshal and unmarshal Golang types to Python types.

Prerequisites

• Go >= 1.22
• Python = 3.11

Install

go get go.nhat.io/python/v3

Examples

package main

import (
    "fmt"

    python3 "go.nhat.io/python/v3"
)

func main() {
    sys := python3.MustImportModule("sys")
    version := sys.GetAttr("version_info")

    pyMajor := version.GetAttr("major")
    defer pyMajor.DecRef()

    pyMinor := version.GetAttr("minor")
    defer pyMinor.DecRef()

    pyReleaseLevel := version.GetAttr("releaselevel")
    defer pyReleaseLevel.DecRef()

    major := python3.AsInt(pyMajor)
    minor := python3.AsInt(pyMinor)
    releaseLevel := python3.AsString(pyReleaseLevel)

    fmt.Println("major:", major)
    fmt.Println("minor:", minor)
    fmt.Println("release level:", releaseLevel)

    // Output:
    // major: 3
    // minor: 11
    // release level: final
}

package main

import (
    "fmt"

    python3 "go.nhat.io/python/v3"
)

func main() { //nolint: govet
    math := python3.MustImportModule("math")

    pyResult := math.CallMethodArgs("sqrt", 4)
    defer pyResult.DecRef()

    result := python3.AsFloat64(pyResult)

    fmt.Printf("sqrt(4) = %.2f\n", result)

    // Output:
    // sqrt(4) = 2.00
}

Donation

If this project help you reduce time to develop, you can give me a cup of coffee :)

Paypal donation

       or scan this