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: 15 days ago
JSON representation
Swift framework to interact with Python.
- Host: GitHub
- URL: https://github.com/pvieito/PythonKit
- Owner: pvieito
- License: apache-2.0
- Created: 2018-02-18T22:39:44.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-06T00:09:03.000Z (2 months ago)
- Last Synced: 2024-09-26T21:49:56.037Z (about 2 months ago)
- Language: Swift
- Homepage:
- Size: 273 KB
- Stars: 1,786
- Watchers: 36
- Forks: 208
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-starts - pvieito/PythonKit - Swift framework to interact with Python. (Swift)
- awesome - PythonKit - Swift framework to interact with Python. (etc)
- awesome - PythonKit - Swift framework to interact with Python. (etc)
README
# PythonKit
[](https://swiftpackageindex.com/pvieito/PythonKit)
[](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/).