gpython

gpython 是用 go 编写的 python 解释器,“不含电池”。「gpython is a python interpreter written in go "batteries not included"」

Github stars Tracking Chart

gpython

Build Status
codecov
GoDoc
License

gpython is a part re-implementation, part port of the Python 3.4
interpreter in Go. Although there are many areas of improvement,
it stands as an noteworthy achievement in capability and potential.

gpython includes:

  • lexer, parser, and compiler
  • runtime and high-level convenience functions
  • multi-context interpreter instancing
  • easy embedding into your Go application
  • interactive mode (REPL) (try online!)

gpython does not include many python modules as many of the core
modules are written in C not python. The converted modules are:

  • builtins
  • marshal
  • math
  • time
  • sys

Install

Download directly from the releases page

Or if you have Go installed:

go install github.com/go-python/gpython

Objectives

gpython started as an experiment to investigate how hard
porting Python to Go might be. It turns out that all those C modules
are a significant barrier to making gpython a complete replacement
to CPython.

However, to those who want to embed a highly popular and known language
into their Go application, gpython could be a great choice over less
capable (or lesser known) alternatives.

Status

gpython currently:

  • Parses all the code in the Python 3.4 distribution
  • Runs Python 3 for the modules that are currently supported
  • Supports concurrent multi-interpreter ("multi-context") execution

Speed hasn't been a goal of the conversions however it runs pystone at
about 20% of the speed of CPython. A π computation test runs quicker under
gpython as the Go long integer primitives are likely faster than the
Python ones.

@ncw started gpython in 2013 and work on is sporadic. If you or someone
you know would be interested to take it futher, it would be much appreciated.

Getting Started

The embedding example demonstrates how to
easily embed and invoke gpython from any Go application.

Of interest, gpython is able to run multiple interpreter instances simultaneously,
allowing you to embed gpython naturally into your Go application. This makes it
possible to use gpython in a server situation where complete interpreter
independence is paramount. See this in action in the multi-context example.

If you are looking to get involved, a light and easy place to start is adding more convenience functions to py/util.go. See notes.txt for bigger ideas.

Other Projects of Interest

  • grumpy - a python to go transpiler

Community

You can chat with the go-python community (or which gpython is part)
at go-python@googlegroups.com
or on the Gophers Slack in the #go-python channel.

License

This is licensed under the MIT licence, however it contains code which
was ported fairly directly directly from the CPython source code under
the PSF LICENSE.

Main metrics

Overview
Name With Ownergo-python/gpython
Primary LanguageGo
Program languagePython (Language Count: 8)
Platform
License:BSD 3-Clause "New" or "Revised" License
所有者活动
Created At2018-08-01 20:08:19
Pushed At2025-03-07 10:17:56
Last Commit At
Release Count6
Last Release Namev0.2.0 (Posted on )
First Release Namev0.0.0 (Posted on )
用户参与
Stargazers Count0.9k
Watchers Count25
Fork Count95
Commits Count578
Has Issues Enabled
Issues Count103
Issue Open Count49
Pull Requests Count116
Pull Requests Open Count2
Pull Requests Close Count15
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private