Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/pvieito/PythonKit

Swift framework to interact with Python.
https://github.com/pvieito/PythonKit

Last synced: about 1 month ago
JSON representation

Swift framework to interact with Python.

Lists

README 

        

#  PythonKit

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fpvieito%2FPythonKit%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/pvieito/PythonKit)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fpvieito%2FPythonKit%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/pvieito/PythonKit)



Swift framework to interact with Python.



## Usage



Some Python code like this:



```python

import sys



print(f"Python {sys.version_info.major}.{sys.version_info.minor}")

print(f"Python Version: {sys.version}")

print(f"Python Encoding: {sys.getdefaultencoding().upper()}")

```



Can be implemented in Swift through PythonKit with the following code:



```swift

import PythonKit



let sys = Python.import("sys")



print("Python \(sys.version_info.major).\(sys.version_info.minor)")

print("Python Version: \(sys.version)")

print("Python Encoding: \(sys.getdefaultencoding().upper())")

```



### Swift Package Manager



Add the following dependency to your `Package.swift` manifest:



```swift

.package(url: "https://github.com/pvieito/PythonKit.git", branch: "master"),

```



## Environment Variables



As the Python library are loaded at runtime by **PythonKit**, it will try to find the most modern Python version available in the system. You can force a given version with the `PYTHON_VERSION` environment variable or an specific Python library path or name with `PYTHON_LIBRARY`.



```

$ PYTHON_VERSION=3 swift run

[*] Python 3.5

$ PYTHON_VERSION=2.7 swift run

[*] Python 2.7

$ PYTHON_LIBRARY=libpython3.5.so swift run

[*] Python 3.5

$ PYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython2.7.so swift run

[*] Python 2.7

```



If **PythonKit** cannot find and load the Python library you can set the `PYTHON_LOADER_LOGGING` environment variable to know from which locations **PythonKit** is trying to load the library:



```

$ PYTHON_LOADER_LOGGING=TRUE PYTHON_VERSION=3.8 swift run

Loading symbol 'Py_Initialize' from the Python library...

Trying to load library at 'Python.framework/Versions/3.8/Python'...

Trying to load library at '/usr/local/Frameworks/Python.framework/Versions/3.8/Python'...

Fatal error: Python library not found. Set the PYTHON_LIBRARY environment variable with the path to a Python library.

```



## Troubleshooting



- If your are targeting the Mac platform with the [Hardened Runtime](https://developer.apple.com/documentation/security/hardened_runtime) enabled make sure you are properly signing and embedding the Python framework you are trying to load with **PythonKit**. The Hardened Runtime [Library Validation mechanism](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_cs_disable-library-validation) prevents a process from loading libraries that are not signed by Apple or the same developer as the main process.



## Notes



- Originally **PythonKit** was based on the `Python` module from the [**Swift for TensorFlow**](https://github.com/tensorflow/swift) experimental project.

- If you have questions about **PythonKit** you can ask on the [**Swift Forums**](https://forums.swift.org/c/related-projects/).