packer-release 0.23.0__py3-none-any.whl

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/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/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/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/assets/version.json

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

packer/change.py

@@ -0,0 +1,222 @@
+from string import Template
+from subprocess import run
+from pathlib import Path
+from git import Repo
+from ollama import chat
+
+from packer.config import _input_via_text_editor, all_settings
+
+def main(git_directory: str | Path = '.', modification_types: list[str] = ['c'], overall_description: str = None,
+         text_editor: str = all_settings.text_editor, wait_flag: str = all_settings.wait_flag,
+         ai_summary: bool = True,
+         check_todo: bool = True, todo_rel_path: str = '/dev/TODO.md', list_start_identifier: str = 'before committing', list_end_identifier: str = '#',
+         bullet_summary_prompt = all_settings.changes_summary_prompt, high_level_summary_prompt = all_settings.high_level_summary_prompt,
+         model: str = all_settings.model, verbose: bool = True):
+    '''
+    Opens a temporary file in the specified text editor for describing the project's modification
+
+    This function creates a temporary file, opens it in the specified text editor,
+    waits for the editor to close, and then removes the temporary file. Afterwards updates the changelog
+    and commits it with the commit message as the project's entered modification as the user had.
+
+    :param git_directory: The root directory of the project (default is '.')
+    :type git_directory: str | Path
+    :param modification_types: The types of modifications to record (a = added, c = changed, f = fixed) (default is ['c'])
+    :type modification_types: list[str]
+    :param overall_description: The overall description of the modifications, if there are multiple (default is None)
+    :type overall_description: str
+    :param ai_summary: Whether to generate an AI summary of the changes (default is True)
+    :type ai_summary: bool
+    :param check_todo: Whether to check for TODO items before committing (default is True)
+    :type check_todo: bool
+    :param todo_rel_path: The relative path to the TODO file (default is '/dev/TODO.md')
+    :type todo_rel_path: str
+    :param list_start_identifier: The identifier for the start of the TODO list (default is 'before committing')
+    :type list_start_identifier: str
+    :param list_end_identifier: The identifier for the end of the TODO list (default is '#')
+    :type list_end_identifier: str
+    :param verbose: Whether to print verbose output (default is True)
+    :type verbose: bool
+    :param bullet_summary_prompt: The prompt template for generating bullet point summaries (default is all_settings.changes_summary_prompt)
+    :type bullet_summary_prompt: list[dict]
+    :param high_level_summary_prompt: The prompt template for generating high-level summaries (default is all_settings.high_level_summary_prompt)
+    :type high_level_summary_prompt: list[dict]
+    :param model: The AI model to use for generating summaries (default is all_settings.model)
+    :type model: str
+    '''
+
+    def input_via_text_editor(message: str) -> str:
+        '''
+        Opens a temporary file in the specified text editor for user input.
+
+        :param message: The initial message to display in the text editor
+        :type message: str
+        :return: The user's input from the text editor
+        :rtype: str
+        '''
+        return _input_via_text_editor(message, text_editor=text_editor, wait_flag=wait_flag)
+
+    if check_todo:
+        with open(f'{git_directory}{todo_rel_path}') as f:
+            content = f.read().lower()
+
+        list_start = content.find(list_start_identifier)
+        list_end = content.find(list_end_identifier, list_start)
+
+        before_committing_list = content[list_start + len(list_start_identifier):list_end].lstrip(':').strip()
+
+        if before_committing_list:
+            print(f'{list_start_identifier} task/s found, please delete them from the list once finished!\nList:\n{before_committing_list}')
+            return
+
+
+    repo = Repo(git_directory)
+    diff_text = repo.git.diff(unified=3)
+
+    if ai_summary:
+        # Update prompts with runtime data
+        summary_data = {
+                'diff': diff_text,
+                'changes': ','.join(modification_types)
+            }
+
+        bullet_summary_prompt[1]['content'] = Template(bullet_summary_prompt[1 if bullet_summary_prompt[1]['role'] == 'user' else 0]['content']).substitute(summary_data)
+        if verbose:
+            print('Generating bullet summary...')
+        bullet_summary = chat(
+        model=model,
+        messages=bullet_summary_prompt
+        )['message']['content'].strip()
+
+
+        high_level_summary_data = {
+            'bullet_summary': bullet_summary
+        }
+
+        high_level_summary_prompt[1]['content'] = Template(high_level_summary_prompt[1 if high_level_summary_prompt[1]['role'] == 'user' else 0]['content']).substitute(high_level_summary_data)
+        if verbose:
+            print('Generating high level summary...')
+        high_level_summary = chat(
+        model=model,
+        messages=high_level_summary_prompt
+        )['message']['content'].strip()
+
+
+
+    with open(f'{git_directory}/CHANGELOG.md', 'r') as f:
+        full_changelog = f.read()
+
+    messages = []
+
+    for i, modification_type in enumerate(modification_types):
+
+        if ai_summary:
+            bullet_summary_list = bullet_summary.splitlines()
+            message = bullet_summary_list[i] if len(bullet_summary_list) > i else 'AI didn\'t generate anything...'
+        else:
+            message = ''
+
+        message = input_via_text_editor(message)
+
+        match modification_type:
+            case 'a':
+                modification_type = 'Added'
+                end = full_changelog.find('### Changed') - 2
+            case 'c':
+                end = full_changelog.find('### Fixed') - 2
+                modification_type = 'Changed'
+            case 'f':
+                end = full_changelog.find('---') - 2
+                modification_type = 'Fixed'
+
+        message = message.lstrip('-')
+        message = message.lstrip()
+        if message.lower().startswith(modification_type.lower()):
+            message = message[len(modification_type):].lstrip()
+        message = message.strip()
+
+        message = f'{message[:1].capitalize()}{message[1:]}'
+        if not message.endswith('.'):
+            message = f'{message}.'
+
+        messages.append([modification_type, message])
+
+        full_changelog = f'{full_changelog[0: end]}\n- {message} {full_changelog[end:]}'
+        with open(f'{git_directory}/CHANGELOG.md', 'w') as f:
+            f.write(full_changelog)
+
+    if len(messages) > 1:
+        git_message = f'feat: {input_via_text_editor(high_level_summary if ai_summary else overall_description)}\n\n'
+        for message in messages:
+            git_message += f'- {message[0]}: {message[1]}\n'
+    else:
+        git_message = f'{messages[0][0]}: {messages[0][1]}'
+
+    run(['git', 'add', '.'])
+    run(['git', 'commit', '-m', git_message.strip()])
+    run(['git', 'push'])
+
+def tui(changes: list[str] | None = None, overall_description: str | None = None, ai_suggestions: bool = True):
+    '''
+    Launches a text-based user interface for creating project change logs and committing them.
+
+    This function is intended to be used as an entry point for a TUI that guides the user
+    through creating changelog entries and committing them to the repository.
+
+    :param changes: A list of modification types (a = added, c = changed, f = fixed) (default is None)
+    :type changes: list[str] | None
+    :param overall_description: An overall description of the modifications, if there are multiple (default is None)
+    :type overall_description: str | None
+    :param ai_suggestions: Whether to generate AI suggestions for the changes (default is True)
+    :type ai_suggestions: bool
+    '''
+
+    if ai_suggestions:
+        try:
+            print(f'AI suggestions:\n{generate_suggestions()}')
+        except KeyboardInterrupt:
+            print('Skipping AI suggestions...')
+
+    if not changes:
+        amount = int(input('Enter the amount of changes: '))
+        if amount > 1:
+            print('Enter each change idvidually, both in terminal and text editor.')
+
+        changes = []
+        for _ in range(amount):
+            changes.append(input('Enter the modification type [a, c, f] ').strip().lower())
+
+    if not overall_description:
+        if len(changes) > 1:
+            overall_description = input('High level description for all changes together [None]: ').strip()
+        else:
+            overall_description = None
+
+    return (changes, overall_description)
+
+def generate_suggestions(git_directory: str | Path = '.', suggestions_prompt = all_settings.suggestions_prompt, model: str = all_settings.model, verbose: bool = True):
+    '''
+    Generates AI suggestions for the changes based on the current git diff.
+
+    :param git_directory: The root directory of the project (default is '.')
+    :type git_directory: str | Path
+    :param suggestions_prompt: The prompt template for generating AI suggestions (default is all_settings.suggestions_prompt)
+    :type suggestions_prompt: list[dict]
+    :param model: The AI model to use for generating suggestions (default is all_settings.model)
+    :type model: str
+    '''
+    repo = Repo(git_directory)
+    diff_text = repo.git.diff(unified=3)
+    
+    suggestions_prompt[1]['content'] = Template(suggestions_prompt[1 if suggestions_prompt[1]['role'] == 'user' else 0]['content']).substitute({'diff': diff_text})
+
+    if verbose:
+        print('Generating AI suggestions...')
+    return chat(
+        model=model,
+        messages=suggestions_prompt
+    )['message']['content'].strip()
+
+if __name__ == '__main__':
+    output = tui()
+    main(modification_types=output[0], overall_description=output[1])