# Album plugin for packaging solutions into executables
This plugin is used to create installation executables for Album and Album solutions, so Album and a solution can be
installed with a simple double click. The executable creates a shortcut for running Albums UI on the desktop of the
user. The executables can be distributed to a different system running the same operating system. To create executables
for different operating systems, run this plugin on a system running the target operating system. If the the target
system runs Windows or MacOS it doesn't need to have anything preinstalled, the executable will install every needed
component (Micromamba and album) into the ~/.album directory if they are not already installed in this location. Linux users
need to have the binutils package installed.
## Installation:
1. [Install Album](https://docs.album.solutions/en/latest/installation-instructions.html#)
2. Activate the album environment:
```
conda activate album
```
3. Install the album package plugin:
```
pip install album-package
```
4. If you are using a linux system, make sure the source and the target system got the binutils package installed. For
example on ubuntu it can be installed with the following command:
```
apt-get update && apt-get install binutils
```
## Usage:
To create an executable which installs Album run following command:
```
album package --output_path /your/output/path
```
To create an executable which installs Album and a solution in one go run following command:
```
album package --solution /path/to/your/solution.py --output_path /your/output/path
```
### Input parameter:
- solution: The album solution.py file which should be packed into an executable.
If you provide the path to a directory containing a solution.py all files in the directory will be packaged into the
solution executable. If you provide the direct path to a solution.py only the solution will packaged. If your solution
contains local imports, make sure all imported files lie in the same directory as the solution and you provide the
path containing the solution.py. If this parameter is not set, the resulting executable will only install Album without
a solution.
- output_path: The path where the executable should be saved
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/album-app/plugins/album-package",
"name": "album-package",
"maintainer": "Lucas Rieckert, Jan Philipp Albrecht, Deborah Schmidt",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "album@kyleharrington.com",
"keywords": "virtual,environments,imaging,data analysis",
"author": "Lucas Rieckert, Jan Philipp Albrecht, Deborah Schmidt",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/f2/90/24b74ea8192f926e108408eb5e94dae9912fb5654f9b0781ebebbaf07ee5/album_package-0.4.0.tar.gz",
"platform": "any",
"description": "# Album plugin for packaging solutions into executables\n\nThis plugin is used to create installation executables for Album and Album solutions, so Album and a solution can be\ninstalled with a simple double click. The executable creates a shortcut for running Albums UI on the desktop of the\nuser. The executables can be distributed to a different system running the same operating system. To create executables\nfor different operating systems, run this plugin on a system running the target operating system. If the the target\nsystem runs Windows or MacOS it doesn't need to have anything preinstalled, the executable will install every needed\ncomponent (Micromamba and album) into the ~/.album directory if they are not already installed in this location. Linux users\nneed to have the binutils package installed.\n\n## Installation:\n\n1. [Install Album](https://docs.album.solutions/en/latest/installation-instructions.html#)\n2. Activate the album environment:\n\n```\nconda activate album\n```\n\n3. Install the album package plugin:\n\n```\npip install album-package\n```\n\n4. If you are using a linux system, make sure the source and the target system got the binutils package installed. For\n example on ubuntu it can be installed with the following command:\n\n```\napt-get update && apt-get install binutils\n```\n\n## Usage:\n\nTo create an executable which installs Album run following command:\n\n```\nalbum package --output_path /your/output/path\n```\n\nTo create an executable which installs Album and a solution in one go run following command:\n\n```\nalbum package --solution /path/to/your/solution.py --output_path /your/output/path\n```\n\n\n### Input parameter:\n\n- solution: The album solution.py file which should be packed into an executable.\n If you provide the path to a directory containing a solution.py all files in the directory will be packaged into the\n solution executable. If you provide the direct path to a solution.py only the solution will packaged. If your solution\n contains local imports, make sure all imported files lie in the same directory as the solution and you provide the\n path containing the solution.py. If this parameter is not set, the resulting executable will only install Album without\n a solution. \n- output_path: The path where the executable should be saved\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "album plugin to package solutions into executable install wizards",
"version": "0.4.0",
"project_urls": {
"Homepage": "https://gitlab.com/album-app/plugins/album-package",
"Source": "https://gitlab.com/album-app/plugins/album-package",
"Tracker": "https://gitlab.com/album-app/plugins/album-package/issues"
},
"split_keywords": [
"virtual",
"environments",
"imaging",
"data analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "214ff10e85745e6e1c3b9b11e9699ffc70cb10946bd84652155c37e8c2e2aea2",
"md5": "ad3f38d752f14aa93b34f8e530011b88",
"sha256": "e0826618c668f4ea788bf4ce3bf2a1a1a1d889cb0c43b50a39552f29c9614ef0"
},
"downloads": -1,
"filename": "album_package-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ad3f38d752f14aa93b34f8e530011b88",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 11446,
"upload_time": "2024-03-05T14:23:56",
"upload_time_iso_8601": "2024-03-05T14:23:56.735526Z",
"url": "https://files.pythonhosted.org/packages/21/4f/f10e85745e6e1c3b9b11e9699ffc70cb10946bd84652155c37e8c2e2aea2/album_package-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f29024b74ea8192f926e108408eb5e94dae9912fb5654f9b0781ebebbaf07ee5",
"md5": "37c40a2c59d75f9cf289a581fefcb06b",
"sha256": "f3c412a0f199c66ab33aa454a69d8c5d4190b3ed20161831a3f28c86a106764d"
},
"downloads": -1,
"filename": "album_package-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "37c40a2c59d75f9cf289a581fefcb06b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 10485,
"upload_time": "2024-03-05T14:23:58",
"upload_time_iso_8601": "2024-03-05T14:23:58.418535Z",
"url": "https://files.pythonhosted.org/packages/f2/90/24b74ea8192f926e108408eb5e94dae9912fb5654f9b0781ebebbaf07ee5/album_package-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-05 14:23:58",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "album-app",
"gitlab_project": "plugins",
"lcname": "album-package"
}
JSON