Skip to content
This repository has been archived by the owner on Nov 14, 2023. It is now read-only.

Latest commit

 

History

History
22 lines (15 loc) · 1.67 KB

README.md

File metadata and controls

22 lines (15 loc) · 1.67 KB
Raw

Python 3 wrapper for Nim nimble

These are raw Python 3 bindings which are used the same as you would in C! If you are looking for a seamless integration between Pyhon 3 and Nim, check out yglukhov's excellent library nimpy.

New static/dynamic functionality incorporated into the wrapper. Please report any bugs!

Description:

Nim wrapper for the Python 3 programming language.
Can be used to link either statically or dynamically to the Python 3 interpreter.

Usage:

There are now three new flags that are used to select the binding type:

  • py3_version: This is a required flag that selects the Python version you wish to compile for. Omitting this flag produces a compile time error.
  • py3_static: This flag selects the bindings to be compiled statically. Static bindings are usually used when you are creating a Nim module that will be imported in Python.
  • py3_dynamic: This flag selects the bindings to be compiled dynamically. Dynamic bindings are used when a Nim application wants to use Python functionality during runtime. A dynamic Python 3 shared library is required to be installed on the system to dynamic bindings (python3.dll on Windows or libpython3.X.so.1/libpython3.Xm.so.1 on Linux/MacOS).

Flags py3_static and py3_dynamic are mutually exclusive!

An example of building a static module for importing into Python:
nim c my_py3_module.nim -d:py3_version:3.5 -d:py3_static

Notes:

Compatible with Python 3.1 to 3.6 (Examples tested with Python 3.4).