JustRunAlready — Cross‑Platform App Bundler
Minimal, predictable bundler that stages your built app into a runnable bundle across Linux, macOS, and Windows. It discovers dependencies, copies what you ship, patches load paths (RPATH/@rpath/PE), and places assets consistently. One CLI and one config on every platform.
Features
- Single CLI and TOML config for Linux/macOS/Windows
- Dependency closure for ELF/Mach‑O/PE (patchelf/install_name_tool aware)
- Canonical layouts (AppDir on Linux, .app on macOS, flat on Windows)
Examples
Basic example:
[app]
name = "MyApp"
staging_root = "install"
[layout.linux]
appdir = "AppDir"
bin_dir = "usr/bin"
lib_dir = "usr/lib"
binary = "myapp" # name inside bin_dir
rpath = ["$ORIGIN", "$ORIGIN/../lib"]
[layout.macos]
app_bundle = "install/MyApp.app"
lib_dir = "Contents/Frameworks"
rpath = ["@executable_path/../Frameworks"]
[layout.windows]
bin_dir = "bin"
binary = "myapp.exe" # name inside bin_dir
# Platform-specific include patterns
[include.linux]
patterns = ["lib/*.so"]
[include.macos]
patterns = ["lib/*.dylib"]
[include.windows]
patterns = ["bin/*.dll"]
CLI
Bundle up your built project:
jra bundle --config jra.toml [--platform auto|linux|macos|windows] [--dry-run] [--verbose]
(Optionally) verify nothing is missing:
jra verify --config jra.toml [--platform linux|macos|windows]
Check your environment and tooling:
jra doctor
Configuration
Platform-Specific Binary
Each platform specifies its own binary location. The binary value is the filename inside the platform’s bin_dir:
[layout.linux]
bin_dir = "usr/bin"
binary = "myapp" # Linux executable name inside bin_dir
[layout.windows]
bin_dir = "bin"
binary = "myapp.exe" # Windows executable name inside bin_dir
# macOS uses app_bundle instead
[layout.macos]
app_bundle = "install/MyApp.app"
Include Patterns with Exclusions
Use platform-specific include patterns to control which files are bundled. Patterns starting with ! exclude previously matched files:
[include.linux]
patterns = [
"lib/*.so", # Include all .so files
"!lib/*_debug.so", # But exclude debug libraries
"!lib/*_test.so" # And test libraries
]
Copy Mappings
Copy non-library files to specific locations in the bundle:
[copy.linux]
files = [
# Simple pattern - copies to bundle root
"myapp.desktop",
"myapp.png",
# Pattern-based copy - copies multiple files to directory
{ pattern = "share/icons/*.png", dest = "usr/share/icons" },
{ pattern = "docs/*", dest = "usr/share/doc" },
# Exact source copy - copies and renames a single file
{ source = "logo.png", dest = "index.png" },
{ source = "readme.txt", dest = "docs/README" }
]
Two types of copy specifications are supported:
- Pattern-based: Use
patternfor glob patterns that match multiple files. Thedestis treated as a directory. - Exact source: Use
sourcefor copying a single file with optional renaming. Thedestis the complete target path.
This is particularly useful for Linux AppImage bundles that require .desktop files in the AppDir root.
Metadata
Release files for justrunalready 0.1.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| justrunalready-0.1.13.tar.gz | 22.2 kB | Without provenance | Details for justrunalready-0.1.13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| justrunalready-0.1.13-py3-none-any.whl | Python 3 | none | any | Details for justrunalready-0.1.13-py3-none-any.whl |
Total release size: 59.2 kB
Release files / justrunalready-0.1.13.tar.gz
| Download URL | justrunalready-0.1.13.tar.gz |
|---|---|
| Size | 22.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
601d7fbdc5b2985cffe6d55dcc5220e143e0e57414500cc99c76dd2034a97146
|
|
BLAKE2b-256 checksum How to use checksums |
21c0341dd726dad3db573b7cdbc00e18957d7e1d0aac2298e532b39603b68e28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.8.19
|
Release files / justrunalready-0.1.13-py3-none-any.whl
| Download URL | justrunalready-0.1.13-py3-none-any.whl |
|---|---|
| Size | 37.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7cb64dfe95525840067a68f789196f836c890c31d79222956fb4d77ba3f97d38
|
|
BLAKE2b-256 checksum How to use checksums |
b68d706be4202e5eeee132d954a8b469d57d132ed6ffd3ebc8f1dfadb6f20f23
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.8.19
|
Security for justrunalready 0.1.13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.