usys 0.1.0__tar.gz

usys-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wattox
+
+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.

usys-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: usys
+Version: 0.1.0
+Summary: Linux user manager
+Author: Wattox00
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# USYS – Linux User Manager
+
+USYS is a simple command-line Linux user and group management tool.
+It provides an interactive interface to manage users and groups using
+clear commands and short aliases.
+
+## Features
+
+- Create, modify, and delete users
+- Create and manage groups
+- Add users to groups
+- View user and group information
+- Simple command aliases for faster usage
+
+## Main Menu
+```
+Command   Alias   Description
+
+user      (u)     User management
+group     (g)     Group management
+help      (h)     Show help menu
+exit      (q)     Exit the program
+```
+
+
+## User Commands
+```
+Command     Alias   Description
+
+adduser     (au)    Create a new user account
+deluser     (du)    Delete an existing user
+passwd      (pw)    Change user password
+chname      (cn)    Change username
+chshell     (cs)    Change user shell
+listuser    (lu)    List all users
+homedir     (hd)    View user's home directory
+quit        (q)     Quit user menu
+```
+
+## Group Commands
+```
+Command       Alias   Description
+
+addgroup      (ga)    Create a new group
+delgroup      (gd)    Delete an existing group
+appendgroup   (ag)    Add user to an existing group
+listgroups    (lg)    List all groups
+groupinfo     (gi)    Show detailed group information
+quit          (q)     Quit group menu
+```

usys-0.1.0/README.md

@@ -0,0 +1,50 @@
+# USYS – Linux User Manager
+
+USYS is a simple command-line Linux user and group management tool.
+It provides an interactive interface to manage users and groups using
+clear commands and short aliases.
+
+## Features
+
+- Create, modify, and delete users
+- Create and manage groups
+- Add users to groups
+- View user and group information
+- Simple command aliases for faster usage
+
+## Main Menu
+```
+Command   Alias   Description
+
+user      (u)     User management
+group     (g)     Group management
+help      (h)     Show help menu
+exit      (q)     Exit the program
+```
+
+
+## User Commands
+```
+Command     Alias   Description
+
+adduser     (au)    Create a new user account
+deluser     (du)    Delete an existing user
+passwd      (pw)    Change user password
+chname      (cn)    Change username
+chshell     (cs)    Change user shell
+listuser    (lu)    List all users
+homedir     (hd)    View user's home directory
+quit        (q)     Quit user menu
+```
+
+## Group Commands
+```
+Command       Alias   Description
+
+addgroup      (ga)    Create a new group
+delgroup      (gd)    Delete an existing group
+appendgroup   (ag)    Add user to an existing group
+listgroups    (lg)    List all groups
+groupinfo     (gi)    Show detailed group information
+quit          (q)     Quit group menu
+```

usys-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "usys"
+version = "0.1.0"
+description = "Linux user manager"
+readme = "README.md"
+authors = [{ name="Wattox00"}]
+license = { text = "MIT" }
+requires-python = ">=3.8"
+dependencies = []
+
+[project.scripts]
+usys = "usys.main:main"

usys-0.1.0/setup.cfg

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

usys-0.1.0/usys/functions/commands.py

@@ -0,0 +1,113 @@
+from functions.group_cfg import GroupFunctions
+from functions.user_cfg import UserFunctions
+from functions.functions import HelpFunctions
+
+USER_COMMANDS = {
+    "adduser": UserFunctions.userAdd,
+    "deluser": UserFunctions.deleteUser,
+    "passwd": UserFunctions.userPassword,
+    "appendgroup": UserFunctions.appendToGroup,
+    "chname": UserFunctions.changeName,
+    "chshell": UserFunctions.changeShell,
+    "listusers": HelpFunctions.listUsers,
+    "listusergroups": HelpFunctions.listUserGroups,
+    "homedir": HelpFunctions.getHomeDir,
+    "help": UserFunctions.helpText,
+    "quit": quit,
+}
+
+USER_ALIASES = {
+    "au": "adduser",
+    "du": "deluser",
+    "pw": "passwd",
+    "ag": "appendgroup",
+    "cn": "chname",
+    "cs": "chshell",
+    "lu": "listusers",
+    "lug": "listusergroups",
+    "hd": "homedir",
+    "h": "help",
+    "q": "quit",
+}
+
+GROUP_COMMANDS = {
+    "addgroup": GroupFunctions.groupAdd,
+    "rmgroup": GroupFunctions.groupRemove,
+    "chgroup": GroupFunctions.chGroupName,
+    "delgroup": GroupFunctions.groupDel,
+    "listgroups": HelpFunctions.listGroups,
+    "groupinfo": HelpFunctions.listGroupInfo,
+    "help": GroupFunctions.helpText,
+    "quit": quit,
+}
+
+GROUP_ALIASES = {
+    "ga": "addgroup",
+    "gr": "rmgroup",
+    "cg": "chgroup",
+    "gd": "delgroup",
+    "lg": "listgroups",
+    "gi": "groupinfo",
+    "h": "help",
+    "q": "quit",
+}
+    
+def root_help():
+    print("""
+    Command     Alias   Description
+
+    user        (u)     User management
+    group       (g)     Group management
+    help        (h)     Show this help menu
+    exit        (q)     Exit the program
+    """)
+
+def helpFull():
+    print("""
+    USYS - linux user manager :)
+
+
+    USER COMMANDS
+
+    adduser     (au)  - Create a new user account
+    deluser     (du)  - Remove an existing user account
+    passwd      (pw)  - Change a user's password
+    chname      (cn)  - Modify an existing username
+    chshell     (cs)  - Change the user's default shell
+    listuser    (lu)  - Display all registered users
+    homedir     (hd)  - Show the user's home directory path
+
+    GROUP COMMANDS
+
+    addgroup    (ga)  - Create a new group
+    delgroup    (gd)  - Delete an existing group
+    appendgroup (ag)  - Add a user to an existing group
+    listgroups  (lg)  - Display all groups
+    groupinfo   (gi)  - Show detailed information about a group
+
+    GENERAL
+
+    quit        (q)   - Exit the program
+    """)
+
+# todo :
+
+# lock/unlock user: usermod -L username ; usermod -U username
+
+# set expire: expireuser (eu) ; setexpiry  (se)
+
+# passinfo (pi) ; setpasspolicy (sp)
+
+# addusertogroup (aug) ; removeusergroup  (rug) ; setgroups (sg)
+
+# chuid (cuid) ; chgid (cgid)
+
+# cloneuser (cu)
+
+# add flags
+
+# add ssh
+# add samba
+# add github ssh setup
+# add apache setup
+# add errorhandling ; user permission managment ; foldere permissions

usys-0.1.0/usys/functions/functions.py

@@ -0,0 +1,52 @@
+class Functions():
+
+    def userName():
+        HelpFunctions.listUsers()
+        username = str(input('User name: ')).lower().strip()
+        return username
+
+    def groupName():
+        HelpFunctions.listGroups()
+        groupname = str(input('Group name: ')).lower().strip()
+        return groupname
+
+    def executeCmd(cmd, check=True, capture=False):
+        import subprocess
+        return subprocess.run(cmd, check=check, capture_output=capture, text=True)
+
+class HelpFunctions():
+
+    #listings
+    def listUsers():
+        result = Functions.executeCmd(["bash", "-c", "getent passwd | awk -F: '$3 >= 1000 {print $1}'"], capture=True)
+        print(result.stdout)
+
+    def listGroups():
+        result = Functions.executeCmd(["bash", "-c", "getent group | awk -F: '$3 >= 1000 || $1 ~ /^(sudo|wheel|docker)$/ {print $1}'"], capture=True)
+        print(result.stdout)
+
+    def getHomeDir():
+        username = Functions.userName()
+        result = Functions.executeCmd(["getent", "passwd", username], capture=True)
+
+        home = result.stdout.split(":")[5]
+        print(home)
+
+    def listGroupInfo():
+        groupname = Functions.groupName()
+        cmd = ["getent", "group", groupname]
+
+        print(Functions.executeCmd(cmd, capture=True).stdout)
+
+    def listUserGroups():
+        username = Functions.userName()
+        cmd = ["groups", username]
+
+        print(Functions.executeCmd(cmd, capture=True).stdout)
+
+    # Helpers
+    def groupName():
+        Functions.listGroups()
+        groupname = str(input('Group name separated by space: ')).lower().strip()
+        return groupname.split(' ')
+

usys-0.1.0/usys/functions/group_cfg.py

@@ -0,0 +1,45 @@
+from functions.functions import Functions
+
+class GroupFunctions():
+    # GROUPS
+ 
+    def groupAdd():
+        groupname = Functions.groupName()
+        cmd = ["sudo", "groupadd", groupname]
+
+        Functions.executeCmd(cmd)
+
+    def groupRemove():
+        username = Functions.userName()
+        groupName = Functions.groupName()
+
+        groups = ','.join(groupName)
+        cmd = ["sudo", "usermod", "-rG", groups, username]
+
+        Functions.executeCmd(cmd)
+
+    def chGroupName():
+        groupname = Functions.groupName()
+        newgroup = str(input('New name of the group: '))
+        cmd = ["sudo", "groupmod", "-n", newgroup, groupname]
+
+        Functions.executeCmd(cmd)
+
+    def groupDel():
+        groupname = Functions.groupName()
+        cmd = ["sudo", "groupdel", groupname]
+
+        Functions.executeCmd(cmd)
+    
+    # Help text
+    def helpText():
+        print("""
+    Command       Alias   Description
+
+    appendgroup   (ag)    Add user to an existing group
+    addgroup      (ga)    Create a new group
+    delgroup      (gd)    Delete an existing group
+    listgroups    (lg)    List all groups
+    groupinfo     (gi)    Show detailed group information
+    quit          (q)     Quit the program
+    """)

usys-0.1.0/usys/functions/user_cfg.py

@@ -0,0 +1,84 @@
+from functions.functions import Functions, HelpFunctions
+class UserFunctions():
+
+    # add a user
+    def userAdd():
+        newUserName = Functions.userName()
+
+        cmd = ["sudo", "useradd"]
+
+        # Home directory
+        homeQ = input(f'Do you want to add home directory [home/{newUserName}] (Y/n) ').lower()
+        if homeQ in ("y", "yes", ""):
+            cmd.append("-m")
+
+        # Groups
+        groupQ = input(f'Do you want to add ({newUserName}) to a group (Y/n) ').lower()
+        if groupQ in ("y", "yes", ""):
+            HelpFunctions.listGroups()
+            groups = Functions.groupName()
+
+            if len(groups) == 1:
+                cmd += ["-g", groups[0]]
+
+            if len(groups) > 1:
+                cmd += ["-G", ",".join(groups[1:])]
+
+        cmd.append(newUserName)
+
+        Functions.executeCmd(cmd)
+
+    # remove user
+    def deleteUser():
+        username = Functions.userName()
+
+        cmd = ["sudo", "userdel", "-r", username]
+
+        Functions.executeCmd(cmd)
+
+    # Add/change password
+    def userPassword():
+        username = Functions.userName()
+        cmd = ["sudo", "passwd", username]
+        Functions.executeCmd(cmd)
+ 
+    # Append to Groups
+    def appendToGroup():
+        username = Functions.userName()
+        groupName = Functions.groupName()
+
+        groups = ','.join(groupName)
+        cmd = ["sudo", "usermod", "-aG", groups, username]
+
+        Functions.executeCmd(cmd)
+
+    # Change name
+    def changeName():
+        old = Functions.userName()
+        new = str(input('New name: '))
+        cmd = ["sudo", "usermod", "-l", new, old]
+
+        Functions.executeCmd(cmd)
+ 
+    # Change shell
+    def changeShell():
+        username = Functions.userName()
+        shellname = str(input('Change shell full path (/bin/bash): '))
+        cmd = ["sudo", "usermod", "-s", shellname, username]
+
+        Functions.executeCmd(cmd)
+
+    # help text
+    def helpText():
+        print("""
+    Command     Alias   Description
+
+    adduser     (au)    Create a new user
+    deluser     (du)    Delete an existing user
+    passwd      (pw)    Change user password
+    chname      (cn)    Change username
+    chshell     (cs)    Change user shell
+    listuser    (lu)    List all users
+    homedir     (hd)    View home directory
+    quit        (q)     Quit the program
+    """)

usys-0.1.0/usys/main.py

@@ -0,0 +1,34 @@
+from shell import run_shell
+from functions.commands import USER_COMMANDS, USER_ALIASES, GROUP_COMMANDS, GROUP_ALIASES, root_help, helpFull
+
+def main():
+    while True:
+        try:
+            raw = input("usys ~ $ ").strip().lower()
+        except KeyboardInterrupt:
+            print()
+            break
+
+        if not raw:
+            continue
+
+        if raw == 'exit' or raw == 'q' or raw == 'e':
+            break
+
+        if raw == 'help' or raw == 'h':
+            root_help()
+            continue
+
+        if raw == 'helpf' or raw == 'hf':
+            helpFull()
+            continue
+
+        if raw == 'user' or raw == 'u':
+            run_shell('usys user ~ $ ', USER_COMMANDS, USER_ALIASES)
+            continue
+
+        if raw == 'group' or raw == 'g':
+            run_shell('usys group ~ $ ', GROUP_COMMANDS, GROUP_ALIASES)
+            continue
+
+        print(f"{raw}: command not found")

usys-0.1.0/usys/shell.py

@@ -0,0 +1,25 @@
+def run_shell(prompt, commands, aliases):
+
+    while True:
+        try:
+            raw = input(prompt).strip().lower()
+        except KeyboardInterrupt:
+            print()
+            return
+
+        if not raw:
+            continue
+
+        if raw == 'exit' or raw == 'e':
+            return
+
+        command = aliases.get(raw, raw)
+        func = commands.get(command)
+
+
+
+        if not func:
+            print(f"{command}: command not found")
+            continue
+
+        func()

usys-0.1.0/usys.egg-info/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: usys
+Version: 0.1.0
+Summary: Linux user manager
+Author: Wattox00
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# USYS – Linux User Manager
+
+USYS is a simple command-line Linux user and group management tool.
+It provides an interactive interface to manage users and groups using
+clear commands and short aliases.
+
+## Features
+
+- Create, modify, and delete users
+- Create and manage groups
+- Add users to groups
+- View user and group information
+- Simple command aliases for faster usage
+
+## Main Menu
+```
+Command   Alias   Description
+
+user      (u)     User management
+group     (g)     Group management
+help      (h)     Show help menu
+exit      (q)     Exit the program
+```
+
+
+## User Commands
+```
+Command     Alias   Description
+
+adduser     (au)    Create a new user account
+deluser     (du)    Delete an existing user
+passwd      (pw)    Change user password
+chname      (cn)    Change username
+chshell     (cs)    Change user shell
+listuser    (lu)    List all users
+homedir     (hd)    View user's home directory
+quit        (q)     Quit user menu
+```
+
+## Group Commands
+```
+Command       Alias   Description
+
+addgroup      (ga)    Create a new group
+delgroup      (gd)    Delete an existing group
+appendgroup   (ag)    Add user to an existing group
+listgroups    (lg)    List all groups
+groupinfo     (gi)    Show detailed group information
+quit          (q)     Quit group menu
+```

usys-0.1.0/usys.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+usys/__init__.py
+usys/main.py
+usys/shell.py
+usys.egg-info/PKG-INFO
+usys.egg-info/SOURCES.txt
+usys.egg-info/dependency_links.txt
+usys.egg-info/entry_points.txt
+usys.egg-info/top_level.txt
+usys/functions/commands.py
+usys/functions/functions.py
+usys/functions/group_cfg.py
+usys/functions/permission_cfg.py
+usys/functions/user_cfg.py

usys-0.1.0/usys.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

usys-0.1.0/usys.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+usys = usys.main:main

usys-0.1.0/usys.egg-info/top_level.txt

@@ -0,0 +1 @@
+usys