cosmetic update + new functions, unfinished

Author: Kinderfeld

AUTHORS.md

@@ -0,0 +1,7 @@
+_theUnixManager_ is a project by **Archetypum** with:
+ - **Kinderfeld** as the lead developer and initial creator.
+ (https://github.com/Kinderfeld)
+ - **WretchOfLights** as the documentation writer.
+ (https://github.com/WretchOfLights)
+ - **wazups** as the illustrator
+ (https://github.com/wazups)

CHANGELOG.md

@@ -1,29 +1,34 @@
-# theUnixManager v1.0.0-stable
+# theUnixManager v1.1.1-stable
 
-This is the first stable release of theUnixManager.
+Next stable release of theUnixManager python version.
 
 Features:
 
-    * 7 init systems support (systemd, sysvinit, init, s6, runit, launchd, openrc).
-    * 52 GNU/Linux and BSD UNIX distributions support (and beyond!).
-    * 16 package managers support (apt, aptitude, dpkg, portage, dnf, yum, zypper, apk, xpbs, qi, slackpkg, guix, pacman, pkg, pkg_add, pkgin).
+* _sudo_ and _doas_ support.
+
+* **7** init systems support (_systemd_, _sysvinit_, _init_, _s6_, _runit_, _launchd_, _openrc_).
+
+* **52** _GNU/Linux_ and _BSD UNIX_ distributions support (and beyond!).
+
+* **16** package managers support (_apt_, _aptitude_, _dpkg_, _portage_, _dnf_, _yum_, _zypper_, _apk_, _xpbs_, _qi_, _slackpkg_, _guix_, _pacman_, _pkg_, _pkg_add_, _pkgin_).
 
 Nothing left to say here anymore, its just first stable release.
 
 "cloc ." statistics:
 
 ```text
-      13 text files.
-      12 unique files.                              
-       4 files ignored.
+      14 text files.
+      13 unique files.                              
+       2 files ignored.
 
-github.com/AlDanial/cloc v 1.96  T=0.03 s (464.8 files/s, 104345.4 lines/s)
+github.com/AlDanial/cloc v 1.96  T=0.02 s (706.5 files/s, 190803.3 lines/s)
 -------------------------------------------------------------------------------
 Language                     files          blank        comment           code
 -------------------------------------------------------------------------------
-Python                           3            411            344           1497
-Markdown                         9            161              0            281
+Bourne Shell                     2            501            356           2230
+Markdown                        10            154              0            269
+Text                             1              0              0              1
 -------------------------------------------------------------------------------
-SUM:                            12            572            344           1778
+SUM:                            13            655            356           2500
 -------------------------------------------------------------------------------
 ```

LICENSE.md renamed to LICENSE-LGPL.md

@@ -1,7 +1,7 @@
 # theUnixManager
 ![theUnixManagerEdited](https://github.com/user-attachments/assets/6c0b3fbc-1d09-4d35-9dde-33b22a468c45)
 
-theUnixManager - ultimate package manager && init system handling library made by Archetypum
+**theUnixManager** - ultimate package manager && init system handling library made by Archetypum
 that simplifies interaction with UNIX systems and creation of system-related python scripts. 
 
 ## Installation (as root):
@@ -24,24 +24,14 @@ tum.package_handling(distro, package_list=["git", "vim", "htop", "emacs"], comma
 tum.init_system_handling(init_system, command="start", service="ssh")
 ```
 
-## Credits
-
-theUnixManager is a project by Archetypum with:
- - Kinderfeld as the lead developer and creator.
-(https://github.com/Kinderfeld)
- - WretchOfLights as the documentation writer.
-(https://github.com/WretchOfLights)
-- wazups as the illustrator
-(https://github.com/wazups)
-
 ## License
 
-theUnixManager uses GNU Lesser General Public License V3. 
+_theUnixManager_ uses **GNU Lesser General Public License v3**. 
 
 More information in:
 
-- LICENSE.md
-- https://www.fsf.org
-- https://www.gnu.org
+- _LICENSE.md_
+- _https://www.fsf.org_
+- _https://www.gnu.org_
 
 ![gnu](https://github.com/user-attachments/assets/66935a97-374f-4dbc-9f1c-428070fda139)

README.md

@@ -0,0 +1 @@
+v1.1.1-stable

VERSION.txt

@@ -4,7 +4,7 @@
 
 """
 :authors: Archetypum
-:license: GNU Lesser General Public License V3, see LICENSE.md file.
+:license: GNU Lesser General Public License v3, see LICENSE-LGPL.md file.
 :copyright: (c) 2025 Archetypum
 """
 
@@ -14,16 +14,16 @@
 
 setup(
     name="theUnixManager",
-    version="1.0.0",
-    license="GNU Lesser General Public License V3, see LICENSE.md file",
+    version="1.1.1",
+    license="GNU Lesser General Public License v3, see LICENSE-LGPL.md file",
     author="Archetypum",
     author_email="archetypum@tutamail.com",
     description=(
         "Ultimate package manager and init system handling library made by Archetypum that simplifies interaction with UNIX systems and creation of system-related Python scripts."
     ),
     long_description=long_description,
-    url="https://github.com/Archetypum/theUnixManager-python",
-    download_url="https://github.com/Archetypum/theUnixManager/releases/tag/v1.0.0-stable",
+    url="https://github.com/Archetypum/theUnixManager",
+    download_url="https://github.com/Archetypum/theUnixManager/releases/tag/v1.1.1-stable",
     packages=["the_unix_manager"],
     install_requires=[],
     classifiers=[

setup.py

@@ -2,13 +2,13 @@
 
 """
 :authors: Archetypum
-:license: GNU Lesser General Public License V3, see LICENSE.md file.
+:license: GNU Lesser General Public License v3, see LICENSE-LGPL.md file.
 
 :copyright: (c) 2025 Archetypum 
 """
 
 from .the_unix_manager import *
 
 __author__: str = "Archetypum"
-__version__: str = "1.0.0"
+__version__: str = "1.1.1"
 __email__: str = "archetypum@tutamail.com"

the_unix_manager/__init__.py

@@ -14,7 +14,7 @@
     * test this on more systems.
     * many more?
 
-theUnixManager is licensed by GNU Lesser General Public License V3.
+theUnixManager is licensed by GNU Lesser General Public License v3.
 Date: 18.10.2024
 ---------------------------------------
 """
@@ -116,7 +116,7 @@ def the_unix_manager_version() -> str:
     """
 
     try:
-        with open("VERSION.txt", "r") as version_file:
+        with open("/etc/theunixmanager/python/VERSION.txt", "r") as version_file:
             return version_file.read().strip()
     except FileNotFoundError:
         return f"{RED}[!] Error: 'VERSION.txt' file not found.\nBroken installation?{RESET}"
@@ -135,12 +135,20 @@ def the_unix_manager_tester() -> None:
     test_results: dict = {} 
     init_system: str = get_init_system()
     distro: str = get_user_distro()
+    your_editor: str = get_preferred_editor()
+    root_command: str = sudo_or_doas()
 
     print(f"user distro: {distro}")
     test_results["get_user_distro"] = prompt_user("[?] is that true?")
 
     print(f"user init system: {init_system}")
     test_results["get_init_system"] = prompt_user("[?] is that true?")
+    
+    print(f"user preferred editor: {your_editor}")
+    test_results["get_preferred_editor"] = prompt_user("[?] is that true?")
+
+    print(f"root command: {root_command}")
+    test_results["sudo_or_doas"] = prompt_user("[?] is that true?")
 
     print(f"{BLACK}black text{RESET}")
     test_results["black_text"] = prompt_user("[?] is that true?")
@@ -518,6 +526,63 @@ def get_init_system() -> str:
     return "unknown"
 
 
+def get_preferred_editor() -> str:
+    """
+    Gets user preffered text editor and stores it in '/etc/theunixmanager/bash/EDITOR.txt'.
+	
+	Returns:
+        text_editor (str): User's preferred editor.
+    """
+    
+    editor_config_path: str = "/etc/theunixmanager/python/EDITOR.txt"
+
+    if os.path.isfile(editor_file):
+        with open(editor_file, "r") as editor_config_file:
+            stored_editor: str = editor_config_file.read().strip()
+            if stored_editor:
+                return stored_editor
+
+    print(f"{ORANGE}\n[!] Error: No preferred editor found at {editor_config_path}.{RESET}")
+    user_editor: str = input("[==>] Enter your preferred editor manually: ")
+    with open(editor_file, "w") as editor_config_file:
+        file.write(user_editor)
+
+    return user_editor
+
+
+def sudo_or_doas() -> str | None:
+    """
+    Checks for the preferred command (either sudo or doas) in '/etc/theunixmanager/bash/COMMAND.txt'.
+    If no preference is found, it checks whether sudo or doas is available on the system and stores
+    the preference accordingly. If both are available, sudo is chosen.
+
+    Returns:
+        result (str): The preferred command ('sudo' or 'doas').
+    """
+    
+    command_file: str = "/etc/theunixmanager/python/EDITOR.txt"
+
+    if os.path.isfile(command_file):
+        with open(command_file, "r") as command_config_file:
+            stored_command: str = command_config_file.read().strip()
+            if stored_command in ["sudo", "doas"]:
+                return stored_command
+
+    if which("sudo"):
+        with open(command_file, "w") as command_config_file:
+            command_config_file.write("sudo")
+        return "sudo"
+
+    elif which("doas"):
+        with open(command_file, "w") as file:
+            file.write("doas")
+        return "doas"
+    
+    else:
+        print(f"{RED}[!] Error: Neither sudo nor doas is available.{RESET}")
+        return None
+
+
 class SystemdManagement:
     """
     A class for managing services using systemd.