https://github.com/amari-calipso/ianthe
A simple Python executables build tool
https://github.com/amari-calipso/ianthe
build-tool pyinstaller python python3
Last synced: 4 months ago
JSON representation
A simple Python executables build tool
- Host: GitHub
- URL: https://github.com/amari-calipso/ianthe
- Owner: amari-calipso
- License: mit
- Created: 2023-03-12T12:55:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-08T20:20:03.000Z (11 months ago)
- Last Synced: 2025-04-03T05:03:45.081Z (7 months ago)
- Topics: build-tool, pyinstaller, python, python3
- Language: Python
- Homepage:
- Size: 58.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ianthe
Ianthe is a Python executables build tool that generates PyInstaller commands and executes them, aiming to achieve more compact executables with a simpler syntax.
# Command line arguments
- `--export`: Prints out the generated PyInstaller arguments and quits.
- `--generate-build-script`: Generates a Python script that executes the given project file.
# Python usage
```py
from ianthe import Ianthe
Ianthe("project_file.iproj").execute()
```
# Setting up a project file
## The structure
A Ianthe project file gets interpreted as a Python `dict` (outermost curly braces get added by Ianthe itself). It's composed of options, all of which (aside `source`) are optional. The order of options doesn't matter. Example:
```
source: "test.py",
destination: "my_folder",
display_mode: console,
icon: "icon.ico"
```
## The options
### `source` or `"source"`
Specifies which file should be built. Requires a `str` or a path-like argument.
### `destination` or `"destination"`
Specifies where the result should be saved. Requires a `str` or a path-like argument.
### `onefile` or `"onefile"`
Equivalent to PyInstaller's `--onefile` argument. Specifies whether a single executable should be built instead of a folder. Requires a `bool` argument (`True`, `False`, `yes` or `no`)
### `scan` or `"scan"`
Enables (`True` or `yes`) or disables (`False` or `no`) used modules scanning and keeps Python's standard library. Default is `True`.
### `keep` or `"keep"`
Tells Ianthe to keep some specific modules. Useful when the result of an application built using Ianthe is broken due to some missing modules that Ianthe can't find. Requires a `list` argument containing module names.
### `copy` or `"copy"`
If data needs to be copied to the result folder, you can specify which files and folders need to be copied. Requires a `dict` argument containing the file or folder path as key and `file`, `"file"`, `folder` or `"folder"` as value to specify the type of data. Example:
```
copy: {
"my_folder": folder,
"my_file.txt": file
}
```
### `embed` or `"embed"`
Equivalent to PyInstaller's `--add-data` and `--add-binary` arguments. Requires a `dict` argument containing the file path as key and `file`, `"file"`, `binary` or `"binary"` as value to specify the type of data.
### `hidden_imports` or `"hidden-imports"`
Equivalent to PyInstaller's `--hidden-import` argument. Requires a `list` argument containing module names.
### `collect` or `"collect"`
Requires a `dict` argument specifying the type of `collect` command, and a list of modules that needs that type of data as value:
- `data` or `"data"`
- Equivalent to PyInstaller's `--collect-data` argument.
- `submodules` or `"submodules"`
- Equivalent to PyInstaller's `--collect-submodules` argument.
- `binaries` or `"binaries"`
- Equivalent to PyInstaller's `--collect-binaries` argument.
- `all` or `"all"`
- Equivalent to PyInstaller's `--collect-all` argument.
### `copy_metadata` or `"copy-metadata"`
Requires a `dict` argument that contains a `modules` or `"modules"` argument as key and a `list` containing module names as value. Equivalent to PyInstaller's `--copy-metadata` unless a `recursive` or `"recursive"` option is used and set to a `True` (or `yes`) value. In that case, it's equivalent to `--recursive-copy-metadata`. Example:
```
copy_metadata: {
recursive: yes,
modules: [
"my_module0",
"my_module1"
]
}
```
### `display_mode` or `"display-mode"`
Requires either `console`, `"console"`, `windowed` or `"windowed"`.
### `icon` or `"icon"`
Sets the program's icon. Requires a `str` or a path-like argument.
### `windows`, `win` or `"win"`
Requires a `dict` containing Windows specific options.
- `version_file` or `"version-file"`
- Equivalent to PyInstaller's `--version-file` argument.
- `manifest` or `"manifest"`
- Equivalent to PyInstaller's `--manifest` argument.
- `embed_manifest` or `"embed-manifest"`
- If set to a `False` (or `no`) value, it's equivalent to PyInstaller's `--no-embed-manifest` argument.
- `requires_admin` or `"requires-admin"`
- If set to a `True` (or `yes`) value, it's equivalent to PyInstaller's `--uac-admin` and `--uac-uiaccess` arguments.
### `osx`, `macOS` or `"osx"`
Requires a `dict` containing macOS specific options.
- `emul_argv` or `"emul-argv"`
- If set to a `True` (or `yes`) value, it's equivalent to PyInstaller's `--argv-emulation` argument.
- `target_arch` or `"target-arch"`
- Equivalent to PyInstaller's `--target-architecture` argument. It only accepts as values: "x86_64", "arm64" and "universal2".
- `bundle_id` or `"bundle-id"`
- Equivalent to PyInstaller's `--osx-bundle-identifier` argument.
- `entitlements` or `"entitlements"`
- Equivalent to PyInstaller's `--osx-entitlements-file` argument.
- `codesign_id` or `"codesign-id"`
- Equivalent to PyInstaller's `--codesign-identity` argument.
### `pyinstaller_args` or `"pyinstaller-args"`
Adds additional PyInstaller arguments. Requires a `list` argument containing PyInstaller arguments.