Unix-style user accounts (passwd, groups, permissions) with a web-friendly Python API.

0 downloads

Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/dbbasic-accounts.git
HTTPS
https://gitstable.com/git/askrobots/dbbasic-accounts.git
SSH
ssh://git@gitstable.com:2222/askrobots/dbbasic-accounts.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

danq9 Add comprehensive FAQ section 369661c 1 year ago History
cli.py · 7.4 KB · 227 lines
1"""
2Command-line interface for dbbasic-accounts
3
4Mirrors Unix commands: useradd, usermod, userdel, passwd, groups
5"""
6
7import sys
8import getpass
9from pathlib import Path
10from argparse import ArgumentParser
11
12from .passwd import PasswdDB
13
14
15def main():
16 """Main CLI entry point"""
17 parser = ArgumentParser(
18 description='Unix-style user accounts with web-friendly API',
19 prog='dbaccounts'
20 )
21 parser.add_argument(
22 '--etc-dir',
23 default='./etc',
24 help='Directory for passwd/shadow/group files (default: ./etc)'
25 )
26
27 subparsers = parser.add_subparsers(dest='command', help='Commands')
28
29 # init command
30 init_parser = subparsers.add_parser('init', help='Initialize database')
31
32 # useradd command
33 useradd_parser = subparsers.add_parser('useradd', help='Add a new user')
34 useradd_parser.add_argument('username', help='Username')
35 useradd_parser.add_argument('--fullname', default='', help='Full name')
36 useradd_parser.add_argument('--homedir', help='Home directory')
37 useradd_parser.add_argument('--shell', default='/bin/bash', help='Shell')
38 useradd_parser.add_argument('--groups', help='Comma-separated list of groups')
39 useradd_parser.add_argument('--password', help='Password (prompts if not provided)')
40
41 # usermod command
42 usermod_parser = subparsers.add_parser('usermod', help='Modify a user')
43 usermod_parser.add_argument('username', help='Username')
44 usermod_parser.add_argument('--fullname', help='New full name')
45 usermod_parser.add_argument('--homedir', help='New home directory')
46 usermod_parser.add_argument('--shell', help='New shell')
47 usermod_parser.add_argument('--add-groups', help='Comma-separated groups to add')
48 usermod_parser.add_argument('--remove-groups', help='Comma-separated groups to remove')
49
50 # userdel command
51 userdel_parser = subparsers.add_parser('userdel', help='Delete a user')
52 userdel_parser.add_argument('username', help='Username')
53
54 # passwd command
55 passwd_parser = subparsers.add_parser('passwd', help='Change password')
56 passwd_parser.add_argument('username', help='Username')
57 passwd_parser.add_argument('--password', help='New password (prompts if not provided)')
58
59 # groups command
60 groups_parser = subparsers.add_parser('groups', help='Show user groups')
61 groups_parser.add_argument('username', help='Username')
62
63 # groupadd command
64 groupadd_parser = subparsers.add_parser('groupadd', help='Add a new group')
65 groupadd_parser.add_argument('groupname', help='Group name')
66 groupadd_parser.add_argument('--gid', type=int, help='Group ID')
67
68 # list command
69 list_parser = subparsers.add_parser('list', help='List users or groups')
70 list_parser.add_argument(
71 'type',
72 nargs='?',
73 default='users',
74 choices=['users', 'groups'],
75 help='Type to list (default: users)'
76 )
77
78 args = parser.parse_args()
79
80 if not args.command:
81 parser.print_help()
82 return 1
83
84 # Initialize PasswdDB
85 passwd = PasswdDB(etc_dir=args.etc_dir)
86
87 # Handle commands
88 if args.command == 'init':
89 print(f"Initialized database in {args.etc_dir}/")
90 print(f" - {args.etc_dir}/passwd.tsv")
91 print(f" - {args.etc_dir}/shadow.tsv")
92 print(f" - {args.etc_dir}/group.tsv")
93 return 0
94
95 elif args.command == 'useradd':
96 # Get password
97 if args.password:
98 password = args.password
99 else:
100 password = getpass.getpass('Password: ')
101 password2 = getpass.getpass('Confirm password: ')
102 if password != password2:
103 print("Passwords do not match", file=sys.stderr)
104 return 1
105
106 # Parse groups
107 groups = None
108 if args.groups:
109 groups = [g.strip() for g in args.groups.split(',')]
110
111 try:
112 user = passwd.useradd(
113 username=args.username,
114 password=password,
115 fullname=args.fullname,
116 homedir=args.homedir,
117 shell=args.shell,
118 groups=groups
119 )
120 print(f"User '{user.username}' created (UID {user.uid})")
121 return 0
122 except ValueError as e:
123 print(f"Error: {e}", file=sys.stderr)
124 return 1
125
126 elif args.command == 'usermod':
127 # Parse groups
128 add_groups = None
129 remove_groups = None
130 if args.add_groups:
131 add_groups = [g.strip() for g in args.add_groups.split(',')]
132 if args.remove_groups:
133 remove_groups = [g.strip() for g in args.remove_groups.split(',')]
134
135 result = passwd.usermod(
136 username=args.username,
137 fullname=args.fullname,
138 homedir=args.homedir,
139 shell=args.shell,
140 add_groups=add_groups,
141 remove_groups=remove_groups
142 )
143
144 if result:
145 print(f"User '{args.username}' modified")
146 return 0
147 else:
148 print(f"Error: User '{args.username}' not found", file=sys.stderr)
149 return 1
150
151 elif args.command == 'userdel':
152 result = passwd.userdel(args.username)
153 if result:
154 print(f"User '{args.username}' deleted")
155 return 0
156 else:
157 print(f"Error: User '{args.username}' not found", file=sys.stderr)
158 return 1
159
160 elif args.command == 'passwd':
161 # Check user exists
162 user = passwd.getuser(args.username)
163 if not user:
164 print(f"Error: User '{args.username}' not found", file=sys.stderr)
165 return 1
166
167 # Get password
168 if args.password:
169 new_password = args.password
170 else:
171 new_password = getpass.getpass('New password: ')
172 new_password2 = getpass.getpass('Confirm password: ')
173 if new_password != new_password2:
174 print("Passwords do not match", file=sys.stderr)
175 return 1
176
177 passwd.passwd(args.username, new_password)
178 print(f"Password for '{args.username}' changed")
179 return 0
180
181 elif args.command == 'groups':
182 user = passwd.getuser(args.username)
183 if not user:
184 print(f"Error: User '{args.username}' not found", file=sys.stderr)
185 return 1
186
187 groups = passwd.groups(args.username)
188 print(' '.join(groups))
189 return 0
190
191 elif args.command == 'groupadd':
192 try:
193 group = passwd.groupadd(args.groupname, gid=args.gid)
194 print(f"Group '{group['groupname']}' created (GID {group['gid']})")
195 return 0
196 except ValueError as e:
197 print(f"Error: {e}", file=sys.stderr)
198 return 1
199
200 elif args.command == 'list':
201 if args.type == 'users':
202 users = passwd.list_users()
203 if not users:
204 print("No users")
205 return 0
206
207 # Format like Unix passwd -a
208 for user in users:
209 print(f"{user.username}:x:{user.uid}:{user.gid}:{user.fullname}:{user.homedir}:{user.shell}")
210 else: # groups
211 groups = passwd.list_groups()
212 if not groups:
213 print("No groups")
214 return 0
215
216 # Format like Unix /etc/group
217 for group in groups:
218 members = ','.join(group['members'])
219 print(f"{group['groupname']}:x:{group['gid']}:{members}")
220
221 return 0
222
223 return 0
224
225
226if __name__ == '__main__':
227 sys.exit(main())