developer-assistant 0.3.6__tar.gz → 0.3.7__tar.gz

{developer_assistant-0.3.6/developer_assistant.egg-info → developer_assistant-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: developer-assistant
-Version: 0.3.6
+Version: 0.3.7
 Summary: A lightweight TUI app for managing and simplifying your Markdown changelogs.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/Ivory-Hubert/Developer-Assistant
@@ -55,7 +55,7 @@ Developer Assistant is a lightweight TUI for simplifying and managing your chang
 
 You can create as many profiles as you need. Each profile gets its own **project specific** `.ini` files, created automatically through the menu based on the information you provide. These act as links that tell DA where your changelogs are, which profile owns them and what's the last version number.
 
-Each project `.ini` can also hold a custom terminal command, that is run in that projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
+Each project `.ini` can also hold a custom terminal command, that's run in the projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
 
 **Your files are kept safe at all times.** Before adding new changes, your existing `CHANGELOG.md` is automatically backed up. While editing, all changes are written to a temporary file first and only prepended to & replaced with your real changelog once you confirm them.
 
@@ -121,6 +121,11 @@ New changes are first written to a temporary file and only prepended to & replac
 This ensures your existing changelog is never overwritten or corrupted, and you always have a fallback copy.
 If the temporary changelog is present on startup you are prompted to remove or keep it.
 
+Furthermore, you can safely work on one changelog in separate sessions, your changes are staged in the temporary log file and only deleted with your confirmation. 
+
+> **Note:**
+> DA can only keep **one** projects WIP changes staged, switching projects with staged changes appends the same file. If you update/reinstall the program with unsaved changes they are lost for good, so it's **not** long-term storage.
+
 
 **Ease of navigation**
 

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/PYPI.md

@@ -35,7 +35,7 @@ Developer Assistant is a lightweight TUI for simplifying and managing your chang
 
 You can create as many profiles as you need. Each profile gets its own **project specific** `.ini` files, created automatically through the menu based on the information you provide. These act as links that tell DA where your changelogs are, which profile owns them and what's the last version number.
 
-Each project `.ini` can also hold a custom terminal command, that is run in that projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
+Each project `.ini` can also hold a custom terminal command, that's run in the projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
 
 **Your files are kept safe at all times.** Before adding new changes, your existing `CHANGELOG.md` is automatically backed up. While editing, all changes are written to a temporary file first and only prepended to & replaced with your real changelog once you confirm them.
 
@@ -101,6 +101,11 @@ New changes are first written to a temporary file and only prepended to & replac
 This ensures your existing changelog is never overwritten or corrupted, and you always have a fallback copy.
 If the temporary changelog is present on startup you are prompted to remove or keep it.
 
+Furthermore, you can safely work on one changelog in separate sessions, your changes are staged in the temporary log file and only deleted with your confirmation. 
+
+> **Note:**
+> DA can only keep **one** projects WIP changes staged, switching projects with staged changes appends the same file. If you update/reinstall the program with unsaved changes they are lost for good, so it's **not** long-term storage.
+
 
 **Ease of navigation**
 

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/README.md

@@ -38,7 +38,7 @@ Developer Assistant is a lightweight TUI for simplifying and managing your chang
 
 You can create as many profiles as you need. Each profile gets its own **project specific** `.ini` files, created automatically through the menu based on the information you provide. These act as links that tell DA where your changelogs are, which profile owns them and what's the last version number.
 
-Each project `.ini` can also hold a custom terminal command, that is run in that projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
+Each project `.ini` can also hold a custom terminal command, that's run in the projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
 
 **Your files are kept safe at all times.** Before adding new changes, your existing `CHANGELOG.md` is automatically backed up. While editing, all changes are written to a temporary file first and only prepended to & replaced with your real changelog once you confirm them.
 
@@ -106,6 +106,11 @@ New changes are first written to a temporary file and only prepended to & replac
 This ensures your existing changelog is never overwritten or corrupted, and you always have a fallback copy.
 If the temporary changelog is present on startup you are prompted to remove or keep it.
 
+Furthermore, you can safely work on one changelog in separate sessions, your changes are staged in the temporary log file and only deleted with your confirmation. 
+
+> [!NOTE]
+> DA can only keep **one** projects WIP changes staged, switching projects with staged changes appends the same file. If you update/reinstall the program with unsaved changes they are lost for good, so it's **not** long-term storage.
+
 
 **Ease of navigation**
 

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/da/interface.py

@@ -1,33 +1,33 @@
 import os, sys
-import time
 import platform
-import subprocess
 import shutil
+import time
+from importlib import resources
 from pathlib import Path
 
-from termcolor import colored
-from rich.progress import track
 from rich.console import Console
 from rich.markdown import Markdown
+from rich.progress import track
+from termcolor import colored
 
-from da.modules.projects_manager import ProjectsManager
 from da.modules.config_manager import ConfigManager
 from da.modules.opener import Opener
-from importlib import resources
+from da.modules.projects_manager import ProjectsManager
+
 
 class Interface:
     def __init__(self):
-        self.version = "0.3.6"
-        self.clear = 'cls' if platform.system() == 'Windows' else 'clear'
+        self.version = "0.3.7"
+        self.clear = "cls" if platform.system() == "Windows" else "clear"
 
         title = f"DA - {self.version}"
 
         if platform.system() == "Windows":
-            os.system(f'title {title}')
+            os.system(f"title {title}")
         else:
-            print(f'\33]0;{title}\a', end='', flush=True)
+            print(f"\33]0;{title}\a", end="", flush=True)
 
-        self.config = ConfigManager('memory.ini', profile="Default")
+        self.config = ConfigManager("memory.ini", profile="Default")
 
         self.memory = None
         self.color = None
@@ -35,11 +35,12 @@ class Interface:
         self.user_path = None
 
         self.first_run = False
-    
+
+
     def run(self):
         steps = [
             ("Initializing runtime...", self.runtime_init),
-            ("Checking configuration...", self.config.data_check)
+            ("Checking configuration...", self.config.data_check),
         ]
 
         for label, step in track(steps):
@@ -57,8 +58,13 @@ class Interface:
         if os.path.exists(temp_log):
             while True:
                 os.system(self.clear)
-                print(colored(f"Temporary changelog detected from your last session!\n", "yellow"))
-                print(colored("D", "light_red") + "elete or " + colored("K", "light_red") + "eep?\n")
+                print(colored("Unsaved changes detected from your last session!\n", "yellow",))
+                print(
+                    colored("D", "light_red")
+                    + "elete or "
+                    + colored("K", "light_red")
+                    + "eep?\n"
+                )
                 choice = input(f"{self.user_path}> ").lower()
                 if choice == "d":
                     os.remove(temp_log)
@@ -68,7 +74,7 @@ class Interface:
                 else:
                     print(colored("\nPlease make a valid choice.", "light_red"))
                     time.sleep(0.5)
-        
+
         state = "intro" if self.first_run else "menu"
 
         while state != "exit":
@@ -90,22 +96,26 @@ class Interface:
                     state = "exit"
 
     def menu(self):
-        self.active_profile = self.memory.get('profile')
+        self.active_profile = self.memory.get("profile")
+        last_project = self.memory.get("last_project")
 
         projects_manager = ProjectsManager(
             config=self.config,
             color=self.color,
             header=self.header,
             cls=self.clear,
-            user_path=self.user_path
+            user_path=self.user_path,
         )
 
-        last_project = self.memory.get('last_project')
         while True:
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu")
+            print(
+                colored(
+                f"{self.active_profile}", f"{self.color}")
+                + " / Main menu"
+            )
             print(self.header)
-            print("E. Exit\n")
+            print("Q. Exit\n")
             print("Last project:")
             print(colored(last_project, f"{self.color}"))
             print("\n1. Projects")
@@ -114,7 +124,7 @@ class Interface:
 
             choice = input(f"{self.user_path}> ").strip()
 
-            if choice.lower() == "e":
+            if choice.lower() == "q":
                 os.system(self.clear)
                 print(self.header)
                 print("Bye!")
@@ -130,16 +140,18 @@ class Interface:
             elif choice == "3":
                 return "settings"
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(0.5)
-    
+
     def settings(self):
         while True:
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Settings")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Settings"
+            )
             print(self.header)
-            print("E. Back\n")
+            print("Q. Back\n")
 
             print(colored("Configuration options", attrs=["underline"]))
             print("1. Edit pinned projects [WIP]")
@@ -152,12 +164,12 @@ class Interface:
 
             choice = input(f"{self.user_path}> ").strip()
 
-            if choice.lower() == "e":
+            if choice.lower() == "q":
                 return
-            #elif choice == "1":
-                #pass
-            #elif choice == "2":
-                #pass
+            # elif choice == "1":
+            # pass
+            # elif choice == "2":
+            # pass
             elif choice == "3":
                 Opener.open(self.config.memory_ini)
             elif choice == "4":
@@ -165,16 +177,18 @@ class Interface:
             elif choice == "5":
                 Opener.open(self.config.templates_folder)
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(0.5)
 
     def profiles(self):
         while True:
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Profiles")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Profiles"
+            )
             print(self.header)
-            print("E. Back\n")
+            print("Q. Back\n")
 
             print("1. Switch profiles\n")
 
@@ -183,7 +197,7 @@ class Interface:
 
             choice = input(f"{self.user_path}> ").strip()
 
-            if choice.lower() == "e":
+            if choice.lower() == "q":
                 return
             elif choice == "1":
                 self.switch_profile()
@@ -192,8 +206,7 @@ class Interface:
             elif choice == "3":
                 self.delete_profile()
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(0.5)
 
     def switch_profile(self):
@@ -259,11 +272,11 @@ class Interface:
 
         self.memory = self.config.load_memory()
 
-        profile = self.memory.get('profile')
+        profile = self.memory.get("profile")
         self.config = ConfigManager("memory.ini", profile=profile)
 
         self.memory = self.config.load_memory()
-        self.active_profile = self.memory.get('profile')
+        self.active_profile = self.memory.get("profile")
 
     def runtime_init(self):
         if not self.config.memory_ini.exists():
@@ -276,10 +289,11 @@ class Interface:
         self.config = ConfigManager("memory.ini", profile=active_profile)
         self.memory = self.config.load_memory()
 
-        self.color = self.memory.get('color') or "light_blue"
-        self.user_path = os.environ.get('USERPROFILE') or os.environ.get('HOME', 'User')
+        self.color = self.memory.get("color") or "light_blue"
+        self.user_path = os.environ.get("USERPROFILE") or os.environ.get("HOME", "User")
 
-        brand = (colored(" Developer Assistant ", f"{self.color}"))
+
+        brand = colored(" Developer Assistant ", f"{self.color}")
         text = " Developer Assistant "
 
         columns, _ = shutil.get_terminal_size()
@@ -289,7 +303,7 @@ class Interface:
         self.header = f"{bars}{brand}{bars}"
 
     def local_init(self):
-        #==Works together with ConfigManager.data_check==
+        # Works together with ConfigManager.data_check()
         default_files = resources.files("da.default")
         dest = self.config.memory_ini
 
@@ -306,7 +320,11 @@ class Interface:
 
     def intro(self):
         os.system(self.clear)
-        print(colored("Welcome to the Developer Assistant\n", f"{self.color}", attrs=["bold"]))
+        print(
+            colored("Welcome to the Developer Assistant\n",
+            f"{self.color}", attrs=["bold"]
+            )
+        )
         print("Here's everything you need to get started...\n")
 
         time.sleep(2)
@@ -319,13 +337,40 @@ class Interface:
 
         input("\nContinue..." + colored("[Enter]", f"{self.color}"))
 
+        # [WIP code, implementation could change]
+
+        # print(colored("\nChoose an accent colour.\n", attrs=["underline"]))
+        # print("1. Default - " + colored("light blue", f"{self.color}"))
+        #
+        # print("\n2. " + colored("red", "red"))
+        # print("3. " + colored("green", "green"))
+        # print("4. " + colored("blue", "blue"))
+        # print("5. " + colored("yellow", "yellow"))
+        # print("6. " + colored("cyan", "cyan"))
+        # print("7. " + colored("magenta", "magenta"))
+        #
+        # print("\n8. " + colored("light green", "light_green"))
+        # print("9. " + colored("light yellow", "light_yellow"))
+        # print("10. " + colored("light magenta", "light_magenta"))
+        # print("11. " + colored("light cyan", "light_cyan"))
+        #
+        # choice = input("\nChoice > ").strip()
+        #
+        # key_map = {
+        #     "1": "",
+        #     "2": "red",
+        # }
+
 def main():
     try:
         app = Interface()
         app.run()
         os.system(app.clear)
     except KeyboardInterrupt:
-        print("\n\n" + colored("Execution interrupted. Exiting...", "cyan", attrs=["bold"]))
+        print(
+            "\n\n"
+            + colored("Execution interrupted. Exiting...", "cyan", attrs=["bold"])
+        )
         time.sleep(0.5)
         os.system(app.clear)
         sys.exit(0)

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/da/intro.md

@@ -31,14 +31,14 @@ Don't change the folder structure or modify variable names inside `.ini` files.
 
 The `da-ui/` folder and subfolders will be created automatically.
 
-> Tip:
+> **Tip:**
 > You can access its content quickly when going to: `Main menu / Settings`
 
 **Profiles for seperate projects and templates**
 
 The program comes with the "Default" profile, you can choose to either stick with this one or create your own profiles in `Main menu / Profiles`. Each profile has seperate projects and they can't be accessed by other profiles. You can choose to customize the templates seperately too.
 
-> Note:
+> **Note:**
 > Migrating a project or template from one profile to another is currently manual, **make sure to also change the "*owner*" value in `.ini` files accordingly**.
 
 ---
@@ -74,6 +74,11 @@ New changes are first written to a temporary file and only prepended to & replac
 This ensures your existing changelog is never overwritten or corrupted, and you always have a fallback copy.
 If the temporary changelog is present on startup you are prompted to remove or keep it.
 
+Furthermore, you can safely work on one changelog in separate sessions, your changes are staged in the temporary log file and only deleted with your confirmation. 
+
+> **Note:**
+> DA can only keep **one** projects WIP changes staged, switching projects with staged changes appends the same file. If you update/reinstall the program with unsaved changes they are lost for good, so it's **not** long-term storage.
+
 
 **Ease of navigation**
 
@@ -94,4 +99,5 @@ The `memory.ini` file does exactly what you'd expect, it features:
 
 Last project & active profile get updated automatically, the rest are up to you.
 
-> **`Ctrl+C` works everywhere to quickly exit DA.**
+> **Tip:**
+> `Ctrl+C` works everywhere to quickly exit DA.

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/da/modules/config_manager.py

@@ -9,6 +9,7 @@ from platformdirs import user_config_path
 
 from importlib import resources
 
+
 class ConfigManager:
     def __init__(self, config_file, profile=None):
         if not profile:
@@ -30,6 +31,7 @@ class ConfigManager:
 
         self.update_last_project = Path(config_file).stem
 
+
     def load_memory(self):
         self.config.read(self.memory_ini)
         prj = self.config['ITEMS']
@@ -117,7 +119,8 @@ class ConfigManager:
         default_templates = resources.files("da.templates")
 
         messages = []
-        #==Always ensure fallback profile exists, not just on first run==
+
+        # Always ensure fallback profile exists, not just on first run
         if not (self.profile_dir / "Default").exists():
             default = self.profile_dir / "Default"
             default.mkdir()
@@ -146,7 +149,7 @@ class ConfigManager:
             shutil.move(str(old_projects), str(self.projects_folder))
             messages.append(f"Migrated Projects folder to: {self.projects_folder}")
 
-        #==Always ensure default templates exist, no matter what profile is active==
+        # Always ensure default templates exist, no matter what profile is active
         if not self.templates_folder.exists():
             user_templates = self.templates_folder
 

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/da/modules/opener.py

@@ -1,9 +1,11 @@
+import os
 import subprocess
 import platform
-import os
 import time
+
 from termcolor import colored
 
+
 class Opener:
     @staticmethod
     def open(path):

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/da/modules/projects_manager.py

@@ -1,7 +1,5 @@
 import os, sys
 import time
-import subprocess
-import platform
 from pathlib import Path
 from datetime import datetime
 
@@ -12,6 +10,7 @@ from da.modules.config_manager import ConfigManager
 from da.modules.version_logic import VersionLogic
 from da.modules.opener import Opener
 
+
 class ProjectsManager:
     def __init__(self, config, color, header, cls, user_path):
         self.config = config
@@ -20,14 +19,19 @@ class ProjectsManager:
         self.clear = cls
         self.user_path = user_path
     
+
     def projects(self, profile):
         self.active_profile = profile
         while True:
             self.memory = self.config.load_memory()
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Projects")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Projects"
+            )
             print(self.header)
-            print("E. Back\n")
+            print("Q. Back\n")
+
             print(colored("1. Last project:", attrs=["underline"]))
             print(colored(self.memory.get('last_project'), f"{self.color}"))
 
@@ -43,7 +47,7 @@ class ProjectsManager:
             print("")
             choice = input(f"{self.user_path}> ").strip()
 
-            if choice.lower() == "e":
+            if choice.lower() == "q":
                 return
 
             elif choice == "1":
@@ -76,8 +80,7 @@ class ProjectsManager:
             elif choice == "3":
                 self.prf_projects()
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(0.5)
 
     def new_project(self):
@@ -87,10 +90,11 @@ class ProjectsManager:
         today = now.strftime("%Y-%m-%d")
 
         print(self.header)
-        print("E. Abort/back\n")
+        print("Q. Abort/back")
+        print("[*] - Optional\n")
         
         name = prompt("Enter new project name > ")
-        if name.lower() == "e":
+        if name.lower() == "q":
             return
         path = prompt("\nEnter project path > ")
 
@@ -98,9 +102,9 @@ class ProjectsManager:
 
         version = prompt("\nCurrent project version > ")
 
-        command = prompt("\nCustom commit command > ")
+        command = prompt("\nCustom commit command* > ")
 
-        #cloud = prompt("\nCloud service (not required) > ")
+        #cloud = prompt("\nCloud service* > ")
 
         confirm = input("\nConfirm(Y) or abort(E) > ").strip()
         if confirm.lower() == "e":
@@ -121,17 +125,19 @@ class ProjectsManager:
             return
             
         else:
-            print("")
-            print(colored("Unknown option, try again...", "light_red", attrs=["bold"]))
+            print(colored("\nUnknown option, try again...", "light_red", attrs=["bold"]))
             time.sleep(1)
             return
 
     def prf_projects(self):
         while True:
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Projects / Profile projects")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Projects / Profile projects"
+            )
             print(self.header)
-            print("E. Back\n")
+            print("Q. Back\n")
             prof_prj = self.config.projects_folder
             contents = os.listdir(prof_prj)
 
@@ -147,7 +153,7 @@ class ProjectsManager:
 
             project = input("\nProject name > ").strip()
 
-            if project.lower() == "e":
+            if project.lower() == "q":
                 return
             elif project in projects:
                 self.load_project(project)
@@ -191,22 +197,27 @@ class ProjectsManager:
                 suffix = " days ago"
 
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Projects / Project menu")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Projects / Project menu"
+            )
             print(self.header)
-            print("E. Back\n")
+            print("Q. Back\n")
+
             print(colored("Chosen project:", attrs=["underline"]))
             print(colored(project, f"{self.color}"))
             print("Last edit " + colored(days, f"{self.color}") + f"{suffix}")
+
             print("\n1. Open project folder")
             print("2. Manage the changelog")
 
             print("\n3. Open project configurations")
-            print("4. Restore backup changelog")
-            print("5. Backup to the cloud [WIP]\n")
+            print("4. Restore backup changelog\n")
+            # print("5. Backup to the cloud [WIP]\n")
 
             choice = input(f"{self.user_path}> ").strip()
 
-            if choice.lower() == "e":
+            if choice.lower() == "q":
                 return
 
             elif choice == "1":
@@ -222,7 +233,7 @@ class ProjectsManager:
             elif choice == "4":
                 changelog = Path(setting.get('changelog'))
                 if os.path.exists(changelog):
-                    print(colored("\nThis action will overwrite your existing changelog!\n", "yellow"))
+                    print(colored("\nThis action will overwrite your existing changelog!\n", "yellow", attrs=["bold"]))
                     input("Acknowledge..." + colored("[Enter]", f"{self.color}"))
 
                 self.rest_bak(setting, changelog, project)
@@ -230,8 +241,7 @@ class ProjectsManager:
             #elif choice == "5":
 
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(1)
 
     def rest_bak(self, setting, changelog, project):

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/da/modules/version_logic.py

@@ -1,7 +1,6 @@
 import os, sys
 import time
 import subprocess
-import platform
 import shutil
 from datetime import datetime
 from pathlib import Path
@@ -15,6 +14,7 @@ from rich.markdown import Markdown
 from da.modules.config_manager import ConfigManager
 from da.modules.opener import Opener
 
+
 class VersionLogic:
     def __init__(self, config, color, header, cls, user_path):
         self.config = config
@@ -26,6 +26,7 @@ class VersionLogic:
         self.memory = self.config.load_memory()
         self.console = Console()
     
+
     def project_menu(self, project, profile):
         self.active_project = project
         self.active_profile = profile
@@ -47,12 +48,17 @@ class VersionLogic:
             self.prj_path = Path(self.setting.get('path'))
 
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Projects / Project menu / Changelog")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Projects / Project menu / Changelog"
+            )
             print(self.header)
-            print("E. Back\n")
+            print("Q. Back\n")
+
             print(colored("Chosen project:", attrs=["underline"]))
             print(colored(self.active_project, f"{self.color}"))
             print("Version: " + colored(self.prj_ver, f"{self.color}"))
+
             print("\n1. Format & commit")
             print("2. Add new changes")
             print("\n3. Open the changelog")
@@ -60,7 +66,7 @@ class VersionLogic:
 
             choice = input(f"{self.user_path}> ").strip()
 
-            if choice.lower() == "e":
+            if choice.lower() == "q":
                 return
 
             elif choice == "1":
@@ -72,7 +78,7 @@ class VersionLogic:
 
             elif choice == "2":
                 if not os.path.exists(self.prj_path):
-                    print(colored("\nSystem cannot find the path to this project.", "light_red"))
+                    print(colored("\nSystem cannot find the project path.", "light_red"))
                     time.sleep(1)
                 else:
                     self.update_changelog()
@@ -100,8 +106,7 @@ class VersionLogic:
                     self.view_md(log_content)
 
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(0.5)
             
     def finalise(self):
@@ -130,12 +135,12 @@ class VersionLogic:
         cmd = self.setting.get('command')
 
         if cmd.strip():
-            print("\nwill run: " + colored(f"{cmd}", f"{self.color}"))
-            print("in folder: " + colored(f"{self.prj_path}", f"{self.color}"))
-            confirm = input("\nConfirm[Enter] or abort[E] > ").strip()
+            print("\nWill run: " + colored(f"{cmd}", f"{self.color}"))
+            print("In folder: " + colored(f"{self.prj_path}", f"{self.color}"))
+            confirm = input("\nConfirm[Enter] or abort[Q] > ").strip()
             print("")
 
-            if confirm.lower() == "e":
+            if confirm.lower() == "q":
                 return
             try:
                 subprocess.run(cmd, cwd=self.prj_path, shell=True, check=True)
@@ -160,12 +165,21 @@ class VersionLogic:
         self.comment = None
         while True:
             os.system(self.clear)
-            print(colored(f"{self.active_profile}", f"{self.color}") + " / Main menu / Projects / Project menu / Changelog / Add changes")
+            print(
+                colored(f"{self.active_profile}", f"{self.color}")
+                + " / Main menu / Projects / Project menu / Changelog / Add changes"
+            )
             print(self.header)
-            print("E. Back/abort")
+            print("Q. Back (stash/abort)")
             print("O. Open templog for fixes")
             print("S. Review changes & save\n")
 
+            if os.path.exists(self.templog_path):
+                print(
+                    colored("There are unsaved changes for a project.\n", "light_yellow", attrs=["bold"])
+                    + "(Open templog to review)\n"
+                )
+
             print(colored("Chosen project:", attrs=["underline"]))
             print(colored(self.active_project, f"{self.color}"))
             print("Version: " + colored(self.prj_ver, f"{self.color}"))
@@ -186,7 +200,7 @@ class VersionLogic:
                 print("Change: " + self.change)
                 print("Comment: " + self.comment + "\n")
 
-            type_choice = input(f"{self.user_path}> ").strip()
+            type_choice = input(f"{self.user_path}> ").strip().lower()
 
             type_map = {
                 "1": "Added",
@@ -199,19 +213,30 @@ class VersionLogic:
 
             self.change_type = type_map.get(type_choice.lower())
 
-            if type_choice.lower() == "e":
+            if type_choice == "q":
                 if os.path.exists(self.templog_path):
-                    os.remove(self.templog_path)
+                    print(colored("\nNote: This stash slot is shared between all projects.", "light_yellow"))
+                    choice = input(
+                        colored("\nK", "light_red")
+                        + "eep or "
+                        + colored("D", "light_red")
+                        + "iscard changes? > "
+                    ).strip().lower()
+
+                    if choice == "d":
+                        os.remove(self.templog_path)
                 return
+
             elif type_choice in ("1", "2", "3", "4", "5", "6"):
                 self.prepend_changes()
-            elif type_choice.lower() == "o":
+
+            elif type_choice == "o":
                 Opener.open(self.templog_path)
-            elif type_choice.lower() == "s":
+
+            elif type_choice == "s":
                 self.save_changes()
             else:
-                print("")
-                print(colored("Unknown option...", "light_red", attrs=["bold"]))
+                print(colored("\nUnknown option...", "light_red", attrs=["bold"]))
                 time.sleep(0.5)
 
     def prepend_changes(self):
@@ -249,8 +274,8 @@ class VersionLogic:
             with open(self.templog_path, "a", encoding="utf-8") as f:
                 f.write(rendered + "\n")
 
-            choice = input("\nNew type [E] or add more [Enter] > ").strip()
-            if choice.lower() == "e":
+            choice = input("\nNew type[Q] or add more[Enter] > ").strip()
+            if choice.lower() == "q":
                 return
 
     def save_changes(self):
@@ -271,13 +296,16 @@ class VersionLogic:
             time.sleep(0.5)
             return
 
-        choice = input("\nContinue" + colored("[Enter]", f"{self.color}") + " or add more" + colored("[E] ", f"{self.color}"))
+        choice = input(
+            "\nContinue" + colored("[Enter]", f"{self.color}")
+            + " or add more" + colored("[Q] ", f"{self.color}")
+        )
 
-        if choice.lower() == "e":
+        if choice.lower() == "q":
             return
 
         print("\nCurrent version: " + colored(self.prj_ver, f"{self.color}"))
-        version = input("\nNew version number: ").strip()
+        version = input("\nNew version number > ").strip()
 
         print("\nWorking...")
 
@@ -335,14 +363,17 @@ class VersionLogic:
         return
 
     def view_md(self, log_content, message=None):
+        # Callers: self.project_menu() & self.save_changes()
         flag = 0
         if not message:
+            # Only check size when caller is self.project_menu()
             method = self.check_size()
             if method == "reject":
                 return
             elif method == "print":
                 flag = 1
 
+        # Display the passed down message or full UI
         if message:
             print(message)
         else:
@@ -350,15 +381,23 @@ class VersionLogic:
             print(self.header)
             print("")
 
+        # Respect self.check_size() verdict
         if flag:
-            print(log_content)
+            with self.console.pager():
+                self.console.print(log_content)
+
             print(colored("\nThis log is too large to render in Markdown! (Max 10MB)", "yellow"))
+            input("\nReturn...[Enter]")
+            return
         else:
             md = Markdown(log_content)
             self.console.print(md)
 
         if not message:
-            input("\nReturn..." + colored("[Enter]", f"{self.color}"))
+            choice = input("\nReturn...[Enter] / [P]ager view (Q - return) > ").strip().lower()
+            if choice == "p":
+                with self.console.pager():
+                    self.console.print(md)
         return
 
     def check_size(self):

{developer_assistant-0.3.6 → developer_assistant-0.3.7/developer_assistant.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: developer-assistant
-Version: 0.3.6
+Version: 0.3.7
 Summary: A lightweight TUI app for managing and simplifying your Markdown changelogs.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/Ivory-Hubert/Developer-Assistant
@@ -55,7 +55,7 @@ Developer Assistant is a lightweight TUI for simplifying and managing your chang
 
 You can create as many profiles as you need. Each profile gets its own **project specific** `.ini` files, created automatically through the menu based on the information you provide. These act as links that tell DA where your changelogs are, which profile owns them and what's the last version number.
 
-Each project `.ini` can also hold a custom terminal command, that is run in that projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
+Each project `.ini` can also hold a custom terminal command, that's run in the projects folder. So you can easly integrate updating your changelogs in DA with Git commands for example.
 
 **Your files are kept safe at all times.** Before adding new changes, your existing `CHANGELOG.md` is automatically backed up. While editing, all changes are written to a temporary file first and only prepended to & replaced with your real changelog once you confirm them.
 
@@ -121,6 +121,11 @@ New changes are first written to a temporary file and only prepended to & replac
 This ensures your existing changelog is never overwritten or corrupted, and you always have a fallback copy.
 If the temporary changelog is present on startup you are prompted to remove or keep it.
 
+Furthermore, you can safely work on one changelog in separate sessions, your changes are staged in the temporary log file and only deleted with your confirmation. 
+
+> **Note:**
+> DA can only keep **one** projects WIP changes staged, switching projects with staged changes appends the same file. If you update/reinstall the program with unsaved changes they are lost for good, so it's **not** long-term storage.
+
 
 **Ease of navigation**
 

{developer_assistant-0.3.6 → developer_assistant-0.3.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "developer-assistant"
-version = "0.3.6"
+version = "0.3.7"
 description = "A lightweight TUI app for managing and simplifying your Markdown changelogs."
 readme = "PYPI.md"
 requires-python = ">=3.10"