packer-release 0.23.0__tar.gz

packer_release-0.23.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 EMILIO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packer_release-0.23.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: packer-release
+Version: 0.23.0
+Summary: A Python automation tool that streamlines python software release workflows
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ollama
+Requires-Dist: pygithub
+Requires-Dist: requests
+Requires-Dist: platformdirs
+Requires-Dist: GitPython
+Requires-Dist: dirhash
+Requires-Dist: pyinstaller
+Requires-Dist: tomlkit
+Requires-Dist: pyzipper
+Requires-Dist: pyperclip
+Requires-Dist: plyer
+Requires-Dist: argcomplete
+Requires-Dist: pygame
+Requires-Dist: cryptography
+Requires-Dist: tdqm
+Requires-Dist: build
+Requires-Dist: twine
+Dynamic: license-file
+
+# Packer
+
+A Python automation tool that streamlines Python release workflows: creating optimized archives, uploading releases to GoFile, updating Git repositories, and publishing GitHub releases with AI-generated notes.
+
+## Contents
+
+- [Installation](#installation)
+- [Binary Downloads](#binary-downloads)
+- [Usage](#usage)
+- [Demos](#demos)
+- [Configuration](#configuration)
+	- [Settings](#settings)
+	- [Config](#config)
+	- [Extra customization](#extra-customization)
+- [Extra notes](#extra-notes)
+- [Warning](#warning)
+- [Features](#features)
+- [Feedback and Suggestions](#feedback-and-suggestions)
+- [Honorable mentions](#honorable-mentions)
+- [Changelog](#changelog)
+- [In future updates](#in-future-updates)
+
+## Installation
+
+Available via:
+
+* **GitHub Releases:** [GitHub Releases](https://github.com/EMILIO888real/Packer/releases/)
+* **Third-party website (GoFile):** [Archive](https://gofile.io/d/OktQl5)
+
+You can also install from source in a virtual environment:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install .
+```
+
+### Binary Downloads
+
+When downloading, please choose the correct build for your operating system:
+
+| File Name | Platform | Description |
+| --- | --- | --- |
+| `packer` | Linux/macOS | Executable for Unix-based systems. |
+| `packer.exe` | Windows | Executable for Windows systems. |
+
+### To install:
+
+* **GitHub:** Download the appropriate binary or archive for your system from the [Releases page](https://github.com/EMILIO888real/Packer/releases/).
+* **Third-party website (GoFile):** Head to the website [Archive](https://gofile.io/d/OktQl5) and download the specific archive for the desired version.
+
+After installing, continue following instructions in this README.
+
+## Usage
+
+After installing the project, you can run it from the command line using the package entry points.
+
+### Basic example
+
+```bash
+python -m packer.main
+```
+
+If the package is installed in your environment, you can also run:
+
+```bash
+packer
+```
+
+## Demos
+
+- `TUI release Demo` - [Watch on youtube](https://youtu.be/dSdyEvqs394)
+- `CLI setup demo` - [Watch on youtube](https://youtu.be/ZC9x80sogzA)
+- `CLI change demo` - [Watch on youtube](https://youtu.be/TEoaclmCq2w)
+
+## Configuration
+
+### Settings
+
+See [docs/SETTINGS.md](docs/SETTINGS.md#L1) for global Packer settings and [docs/PROJECT.md](docs/PROJECT.md#L1) for project-specific settings. For CLI options, see [docs/CLI.md](docs/CLI.md#L1).
+
+### Config
+
+Packer expects a project layout with `src/` code and an `assets/` folder containing at least `version.json` and `integrity.json`. A `CHANGELOG.md` at the project root is required for release-note generation.
+
+### Extra customization
+
+See [docs/PROJECT.md](docs/PROJECT.md#L1) for notes about adding custom assets and creating profiles.
+
+## Extra notes
+
+- Packer integrates with GoFile for archive hosting and GitHub for release publishing.
+- Optional compilation via Nuitka is supported for producing compiled releases.
+
+## Warning
+
+- Possible problems might arise in that case, please back up your project before running for the first time and even if packer messed up, it won't destroy or corrupt your project so GL fixing it! Here is also a guide for manually reverting a release in case it fails catastrophically: [docs/MANUAL_REVERT.md](docs/MANUAL_REVERT.md#L1).
+- Note that automatic error reporting is enabled by default. *You can disable it in the settings*
+
+## Features
+
+- Archive Creation: Packages your program with customizable exclusion rules.
+- Cloud Upload: Uploads archives to GoFile with optional folder management.
+- Git Integration: Handles repository updates and tagging.
+- GitHub Releases: Publishes releases with AI-generated titles and descriptions.
+- Optional Compilation: Supports Nuitka for compiled distributions.
+- Error Handling: Automatic rollback to previous version if a step fails.
+- AI-Powered: Uses Ollama (when available) to generate release notes.
+
+## Feedback and Suggestions
+
+Please open issues or pull requests on the project's GitHub repository, or email [emilspro888@gmail.com] to suggest improvements or report bugs.
+
+## Honorable mentions
+
+- Ollama — used for AI-generated release notes (optional).
+- GoFile — used as archive hosting provider.
+
+## Changelog
+
+See the full history in [CHANGELOG.md](./CHANGELOG.md#L1).
+
+## In future updates
+
+See planned features and roadmap in [docs/ROADMAP.md](docs/ROADMAP.md#L1).

packer_release-0.23.0/README.md

@@ -0,0 +1,125 @@
+# Packer
+
+A Python automation tool that streamlines Python release workflows: creating optimized archives, uploading releases to GoFile, updating Git repositories, and publishing GitHub releases with AI-generated notes.
+
+## Contents
+
+- [Installation](#installation)
+- [Binary Downloads](#binary-downloads)
+- [Usage](#usage)
+- [Demos](#demos)
+- [Configuration](#configuration)
+	- [Settings](#settings)
+	- [Config](#config)
+	- [Extra customization](#extra-customization)
+- [Extra notes](#extra-notes)
+- [Warning](#warning)
+- [Features](#features)
+- [Feedback and Suggestions](#feedback-and-suggestions)
+- [Honorable mentions](#honorable-mentions)
+- [Changelog](#changelog)
+- [In future updates](#in-future-updates)
+
+## Installation
+
+Available via:
+
+* **GitHub Releases:** [GitHub Releases](https://github.com/EMILIO888real/Packer/releases/)
+* **Third-party website (GoFile):** [Archive](https://gofile.io/d/OktQl5)
+
+You can also install from source in a virtual environment:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install .
+```
+
+### Binary Downloads
+
+When downloading, please choose the correct build for your operating system:
+
+| File Name | Platform | Description |
+| --- | --- | --- |
+| `packer` | Linux/macOS | Executable for Unix-based systems. |
+| `packer.exe` | Windows | Executable for Windows systems. |
+
+### To install:
+
+* **GitHub:** Download the appropriate binary or archive for your system from the [Releases page](https://github.com/EMILIO888real/Packer/releases/).
+* **Third-party website (GoFile):** Head to the website [Archive](https://gofile.io/d/OktQl5) and download the specific archive for the desired version.
+
+After installing, continue following instructions in this README.
+
+## Usage
+
+After installing the project, you can run it from the command line using the package entry points.
+
+### Basic example
+
+```bash
+python -m packer.main
+```
+
+If the package is installed in your environment, you can also run:
+
+```bash
+packer
+```
+
+## Demos
+
+- `TUI release Demo` - [Watch on youtube](https://youtu.be/dSdyEvqs394)
+- `CLI setup demo` - [Watch on youtube](https://youtu.be/ZC9x80sogzA)
+- `CLI change demo` - [Watch on youtube](https://youtu.be/TEoaclmCq2w)
+
+## Configuration
+
+### Settings
+
+See [docs/SETTINGS.md](docs/SETTINGS.md#L1) for global Packer settings and [docs/PROJECT.md](docs/PROJECT.md#L1) for project-specific settings. For CLI options, see [docs/CLI.md](docs/CLI.md#L1).
+
+### Config
+
+Packer expects a project layout with `src/` code and an `assets/` folder containing at least `version.json` and `integrity.json`. A `CHANGELOG.md` at the project root is required for release-note generation.
+
+### Extra customization
+
+See [docs/PROJECT.md](docs/PROJECT.md#L1) for notes about adding custom assets and creating profiles.
+
+## Extra notes
+
+- Packer integrates with GoFile for archive hosting and GitHub for release publishing.
+- Optional compilation via Nuitka is supported for producing compiled releases.
+
+## Warning
+
+- Possible problems might arise in that case, please back up your project before running for the first time and even if packer messed up, it won't destroy or corrupt your project so GL fixing it! Here is also a guide for manually reverting a release in case it fails catastrophically: [docs/MANUAL_REVERT.md](docs/MANUAL_REVERT.md#L1).
+- Note that automatic error reporting is enabled by default. *You can disable it in the settings*
+
+## Features
+
+- Archive Creation: Packages your program with customizable exclusion rules.
+- Cloud Upload: Uploads archives to GoFile with optional folder management.
+- Git Integration: Handles repository updates and tagging.
+- GitHub Releases: Publishes releases with AI-generated titles and descriptions.
+- Optional Compilation: Supports Nuitka for compiled distributions.
+- Error Handling: Automatic rollback to previous version if a step fails.
+- AI-Powered: Uses Ollama (when available) to generate release notes.
+
+## Feedback and Suggestions
+
+Please open issues or pull requests on the project's GitHub repository, or email [emilspro888@gmail.com] to suggest improvements or report bugs.
+
+## Honorable mentions
+
+- Ollama — used for AI-generated release notes (optional).
+- GoFile — used as archive hosting provider.
+
+## Changelog
+
+See the full history in [CHANGELOG.md](./CHANGELOG.md#L1).
+
+## In future updates
+
+See planned features and roadmap in [docs/ROADMAP.md](docs/ROADMAP.md#L1).

packer_release-0.23.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "packer-release"
+version = "0.23.0"
+description = "A Python automation tool that streamlines python software release workflows"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "ollama",
+    "pygithub",
+    "requests",
+    "platformdirs",
+    "GitPython",
+    "dirhash",
+    "pyinstaller",
+    "tomlkit",
+    "pyzipper",
+    "pyperclip",
+    "plyer",
+    "argcomplete",
+    "pygame",
+    "cryptography",
+    "tdqm",
+    "build",
+    "twine"
+]
+
+[tool.setuptools]
+include-package-data = true
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+packer = ["assets/**/*"]
+
+[project.scripts]
+packer = "packer.main:main"

packer_release-0.23.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

packer_release-0.23.0/src/packer/__init__.py

@@ -0,0 +1,7 @@
+from packer.core import Packer
+from packer.setup import main as setup
+from packer.change import main as commit_change
+from packer.custom_modules.et import load_config, simple_merge_settings, normalize_settings_keys, tree
+from packer.exceptions import Global_exception_handler
+
+__all__ = ['load_config', 'Packer', 'setup', 'commit_change', 'simple_merge_settings', 'normalize_settings_keys', 'Global_exception_handler', 'tree']

packer_release-0.23.0/src/packer/actions.py

@@ -0,0 +1,25 @@
+from pathlib import Path
+
+from packer.config import Project, all_settings, send_notification, exception_handler
+import sys
+
+from packer.core import Packer
+
+
+def run(new_version: dict, project_directory: Path, project_configuration: Project):
+
+    try:
+        packer = Packer(new_version, project_directory, **project_configuration.model_dump())
+
+        def packer_exception_handler(exc_type, exc_value, exc_traceback):
+            packer.revert_changes(False)
+            if all_settings.desktop_notifications:
+                send_notification('Packer encountered an error and reverted all changes.', 'error')
+            exception_handler.handle_exception(exc_type, exc_value, exc_traceback)
+
+        sys.excepthook = packer_exception_handler # replace the global exception handler with packer's to revert changes in case Packer was running.
+        
+        packer.run()
+    except KeyboardInterrupt:
+        packer.print_and_log('Process interrupted by user!', [255, 255, 0], level=30)
+        packer.revert_changes()

packer_release-0.23.0/src/packer/assets/RELEASE.md

@@ -0,0 +1,70 @@
+# $program_name Update [$new_version]
+
+$version_description
+
+## Installation
+
+Available via:
+
+* **GitHub:** [GitHub Releases](https://github.com/${github_repo_url}/releases/tag/${new_version})
+* **Third-party website (GoFile):** [Archive]($gofile_download_url) (click the download button).
+
+### Binary Downloads
+
+When downloading, please choose the correct build for your operating system:
+
+| File Name | Platform | Description |
+| --- | --- | --- |
+| `$program_name` | Linux/macOS | Executable for Unix-based systems. |
+| `$program_name.exe` | Windows | Executable for Windows systems. |
+
+### To install:
+
+* **GitHub:**
+Download the appropriate binary for your system from the [Releases page](https://github.com/${github_repo_url}/releases/tag/${new_version}).
+* **Third-party website (GoFile):**
+Head to the website [Archive]($gofile_download_url) and download the specific arhive with the appropriate version.
+
+After installing, continue following instructions via the README.
+
+## Changes in $new_version
+
+$latest_changelog
+
+[Full changelog](https://github.com/${github_repo_url}/blob/master/CHANGELOG.md)
+
+## Tips
+
+If you prefer to build from source via **GitHub**, you can clone the repository using:
+
+```bash
+git clone https://github.com/${github_repo_url} --depth 1
+
+```
+
+Using `--depth 1` creates a "shallow clone," which only downloads the latest commit, saving you significant time and storage space compared to a full repository clone.
+
+While downloading the pre-compiled binaries (like `$program_name` or `$program_name.exe`) is usually the fastest way to get started, cloning the repository allows you to easily pull future updates with `git pull` as they are released.
+
+## Verification
+
+To ensure the integrity of the downloaded files, you can verify their SHA256 checksums.
+
+### How to verify:
+
+* **Windows (PowerShell):**
+Open PowerShell and run the following command:
+```powershell
+Get-FileHash .\$program_name.exe -Algorithm SHA256
+
+```
+
+
+* **Linux/macOS (Terminal):**
+Open your terminal and run:
+```bash
+sha256sum $program_name
+
+```
+
+Compare the resulting hash with the one provided in the GitHub release assets list to ensure it matches.

packer_release-0.23.0/src/packer/assets/integrity.json

@@ -0,0 +1 @@
+{"CWD": {"root_hash": "8630217fe25a8f5cffc622b9825526bc14ba74e1a5c0962da2eb4699b84232ea", "tree": {"files": {".gitignore": "d7ba4a10f60365e1b1ebad9c6df3aea7acbd0ae29b3732c614db22d65e0f89fc", "CHANGELOG.md": "bf7d79f61f5080f8bd48996e42d1a6cd14611f12ebb5e61d455391b054f3d84f", "LICENSE": "bf1c380e8205fa5c7872101cd09794e8c1d313d4326c2a7a21a9c150584d2f96", "README.md": "aa3284a20fe8f30bad89b895ccd5473ff6c4c66c4a098937a5a34f2a2ac64cd2", "main.spec": "cc61795424a36b70d1c9d1b0051e445c55610f1a45389206a8f6500855ccc00b", "pyproject.toml": "68e06cb39201354dae20165ec1494116310fa85687da883bb04814c5c84af062"}, ".github": {"workflows": {"files": {"build.yaml": "a5c406080d9bb26d57ef5a6c265ae145309171f3087a6daac63a97494ad196b6"}}}, "docs": {"files": {"CLI.md": "acfcc4d27a6789e3b90cd12ecbb94a7602bead7562cd123e5b68ee6add353fda", "MANUAL_REVERT.md": "ff061a209167f7ab303601ef3a49b147fad54616b955e53a73e103bd332eeac4", "PROJECT.md": "25021c22dfdd43b862f83ca182c528f92d6c5066e29488eeb1a20cea092051b5", "ROADMAP.md": "7aa1b20b64eda32e2482e649932d4bef3b98ebf58de6404f16d03bb018bde8a7", "SETTINGS.md": "0c3625de0701598340879af51261b970135f22ecedd3c677bb8bbdedd1e1be01"}}, "src": {"packer": {"files": {"__init__.py": "2f79f39d09df2cf1f2244835e20904c382ea1344851349a49908beb0a0a4e5a0", "actions.py": "062ec62bcd99b75d679a69aa01c1e9c1afba723bb4ef8480e5236df6de57a634", "change.py": "502cf95c317be92656611a15f9a4292e26d8ce5bf1f011454ab1ef58a8a07a7f", "config.py": "d07e0fd1aa831e649491a459f286f8dade61bbbe043084fd61fa95775607ee52", "core.py": "d9946fb705161189172168f71cbe60481bb656c639d28d77c62740a1498a3c7d", "exceptions.py": "cc4af0b3a01f920badae03f9cc4a702363594d8a77a7a3a0469418bd88b5bb87", "main.py": "5a6218853b4961eefe4100531614a4f889c8b8a6aef03c9071e13b0539f3a512", "paths.py": "691b5fb411de0194382b698754bc0b29969c401823547e5ad7eddfb5ade18322", "setup.py": "a2cecc29f53a8daac96629b015c3eeb0531d115499df7500e3918a1357f0f903", "utils.py": "715ebf84d5b611c97bdcd27e79d42a8259c9170d12902ffd1ff51cf8bea15e78"}, "assets": {"files": {"RELEASE.md": "22f25566487db873890765dd0d98059ad59358606db52daa175b2d0c0500f703", "integrity.json": "4b8972f0d88174e1db151260410eb0c2a16aa70293baef224ffe5ebff3009672", "version.json": "6a079cf0fad3cb40c726916a02a31997fb2c41e61de8192a8a919bccb5909931"}, "audio": {"sounds": {"files": {"new notification 1.wav": "47a227b0403611b4d650dd4322e8784ac8154ac80abbe73b1c259df755daf8da", "new notification 2.wav": "d7a0e41e28cdbaf92fcf77da82f1656c5284e79557f5bdd143d504bb00c3aa81", "new notification 3.wav": "0b3200bd3c279b4acc901c35cd899b1e3da62b6283bf34b8aea96fb82987dae4"}}}, "images": {"files": {"Packer icon.ico": "311cfef9f20c3d377bc3d3b19751a67f66e373cd4c6a5c80294e3dee3deca947", "Packer icon.png": "1d80eca39a6ff0e147ab8795fc6dc2d01b67e5a447780ba94dcee50f86ebd715"}}}, "custom_modules": {"files": {"et.py": "e4c6fb8d81b35f82f8dc6f4940fea9800e2bed2f7aaac1a7e84149852e8c3ce6", "etf.py": "885036a0b0ccd854eb4e4d93d4b2df815984d1a19f4c6ae628379e5ad731af94"}}, "ui": {"files": {"cli.py": "3775d67cf64fe28b39eabef33a5aa985a32b5e06fe2d3a14293d4b72ab8fac6e", "tui.py": "3a81c5e6bede48e2d31bac5ff950d7b110640bd17edcb4bdcf7789c2d77f8d40"}}}}}}}

packer_release-0.23.0/src/packer/assets/version.json

@@ -0,0 +1,5 @@
+{
+    "major": 0,
+    "minor": 23,
+    "patch": 0
+}