Add admin-cli

README.md

@@ -95,7 +95,7 @@ Create yourself an admin user:
 ```
 
 At this stage you need to create accounts to be used with the EteSync apps. To do that, please go to:
-`www.your-etesync-install.com/admin` and create a new user to be used with the service. No need to set
+`www.your-etesync-install.com/admin` or use CLI `./manage.py createuser <username>` and create a new user to be used with the service. No need to set
 a password, as Etebase uses a zero-knowledge proof for authentication, so the user will just create
 a password when creating the account from the apps.
 
@@ -152,7 +152,7 @@ A quick summary can be found [on tldrlegal](https://tldrlegal.com/license/gnu-af
 
 ## Commercial licensing
 
-For commercial licensing options, contact [email protected] 
+For commercial licensing options, contact [email protected]
 
 # Financially Supporting Etebase
 

django_etebase/admin-cli/management/commands/_utils.py

@@ -0,0 +1,14 @@
+from distutils.util import strtobool
+from datetime import datetime
+import pytz
+
+def argbool(arg):
+ if arg == None: return None
+ return bool(strtobool(arg))
+
+def argdate(arg):
+ if arg == None: return None
+ try:
+ return pytz.utc.localize(datetime.strptime(arg, '%Y-%m-%d %H:%M:%S'))
+ except ValueError:
+ return pytz.utc.localize(datetime.strptime(arg, '%Y-%m-%d %H:%M:%S.%f'))

django_etebase/admin-cli/management/commands/group-create.py

@@ -0,0 +1,30 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth.models import Group, Permission
+from django.db.utils import IntegrityError
+
+class Command(BaseCommand):
+
+ def add_arguments(self, parser):
+ parser.add_argument( 'name'
+ , type=str
+ , help="New group's name." )
+ parser.add_argument( '--permissions'
+ , type=str
+ , nargs='*'
+ , default=[]
+ , help="New group's permissions." )
+
+ def handle(self, *args, **options):
+ try:
+ for index,permission in enumerate(options["permissions"]):
+ options["permissions"][index] = Permission.objects.get(name=permission)
+
+ group = Group.objects.create(name=options["name"])
+ group.permissions.set(options["permissions"])
+ group.save()
+ except (IntegrityError,Permission.DoesNotExist) as exception:
+ self.stdout.write(self.style.ERROR(f'Unable to create group "{options["name"]}": ' + str(exception)))
+ exit(1)
+
+ self.stdout.write(self.style.SUCCESS(f'Group "{options["name"]}" has been created.'))
+ exit(0)

django_etebase/admin-cli/management/commands/group-delete.py

@@ -0,0 +1,16 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth.models import Group
+
+class Command(BaseCommand):
+
+ def add_arguments(self, parser):
+ parser.add_argument( 'name'
+ , type=str
+ , help="Name of the group to be deleted." )
+
+ def handle(self, *args, **options):
+ try:
+ Group.objects.get(name = options["name"]).delete()
+ self.stdout.write(self.style.SUCCESS(f'Grop "{options["name"]}" has been deleted.'))
+ except Group.DoesNotExist as exception:
+ self.stdout.write(self.style.ERROR(f'Unable to delete group "{options["name"]}": ' + str(exception)))

django_etebase/admin-cli/management/commands/group-modify.py

@@ -0,0 +1,48 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth.models import Group, Permission
+from django.db.utils import IntegrityError
+
+class Command(BaseCommand):
+
+ def add_arguments(self, parser):
+ parser.add_argument( 'name'
+ , type=str
+ , help="Group's name." )
+ parser.add_argument( '-n'
+ , '--new_name'
+ , '--new-name'
+ , type=str
+ , default=None
+ , help="Group's new name." )
+ parser.add_argument( '-m'
+ , '--mode'
+ , type=str
+ , choices=['set', 'add', 'remove']
+ , default='set'
+ , help="Set modification mode. Affects --permissions." )
+ parser.add_argument( '--permissions'
+ , type=str
+ , nargs='*'
+ , default=None
+ , help="Group's new permissions." )
+
+ def handle(self, *args, **options):
+ try:
+ if options["permissions"] != None:
+ for index,permission in enumerate(options["permissions"]):
+ options["permissions"][index] = Permission.objects.get(name=permission)
+
+ group = Group.objects.get(name=options["name"])
+
+ if options["new_name"] != None:
+ group.name = options["new_name"]
+ if options["permissions"] != None:
+ if options["mode"] == "set" : group.permissions.set ( options["permissions"])
+ if options["mode"] == "add" : group.permissions.add (*options["permissions"])
+ if options["mode"] == "remove" : group.permissions.remove(*options["permissions"])
+
+ group.save()
+ self.stdout.write(self.style.SUCCESS(f'Group "{options["name"]}" has been modified.'))
+
+ except (User.DoesNotExist, ValueError) as exception:
+ self.stdout.write(self.style.ERROR(f'Unable to modify group "{options["name"]}": ' + str(exception)))

django_etebase/admin-cli/management/commands/groups-delete.py

@@ -0,0 +1,27 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth.models import Group
+
+class Command(BaseCommand):
+
+ def add_arguments(self, parser):
+ parser.add_argument( '-y'
+ , '--yes'
+ , action='store_true'
+ , default=False
+ , help="Allow deletion of all groups!" )
+
+ def handle(self, *args, **options):
+ if options["yes"] != True:
+ print('Do you really want to delete all groups? [y/N]: ', end='')
+ if input() not in ('y', 'Y', 'yes', 'YES', 'Yes'):
+ self.stdout.write(self.style.SUCCESS(f'No groups have been deleted.'))
+ exit(0)
+
+ try:
+ for group in Group.objects.all():
+ group.delete()
+ self.stdout.write(self.style.SUCCESS(f'All groups have been deleted.'))
+ exit(0)
+ except Group.DoesNotExist as exception:
+ self.stdout.write(self.style.ERROR(f'Unable to delete all groups: ' + str(exception)))
+ exit(1)

django_etebase/admin-cli/management/commands/groups-list.py

@@ -0,0 +1,8 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth.models import Group
+
+class Command(BaseCommand):
+
+ def handle(self, *args, **options):
+ for group in Group.objects.all():
+ print(group.name)

django_etebase/admin-cli/management/commands/permissions-list.py

@@ -0,0 +1,8 @@
+from django.core.management.base import BaseCommand
+from django.contrib.auth.models import Permission
+
+class Command(BaseCommand):
+
+ def handle(self, *args, **options):
+ for permission in Permission.objects.all():
+ print(permission.name)

django_etebase/admin-cli/management/commands/user-create.py

@@ -0,0 +1,111 @@
+from django.core.management.base import BaseCommand
+from django_etebase.users.management.commands._utils import argbool, argdate
+from myauth.models import User
+from django.contrib.auth.models import Group, Permission
+from django.db.utils import IntegrityError
+
+class Command(BaseCommand):
+
+ def add_arguments(self, parser):
+ parser.add_argument( 'username'
+ , type=str
+ , help="New user's login username." )
+ parser.add_argument( '-p'
+ , '--password'
+ , type=str
+ , help="New user's plain text login password." )
+ parser.add_argument( '-f'
+ , '--first_name'
+ , '--first'
+ , type=str
+ , default=''
+ , help="New user's first name." )
+ parser.add_argument( '-l'
+ , '--last_name'
+ , '--last'
+ , type=str
+ , default=''
+ , help="New user's last name." )
+ parser.add_argument( '-e'
+ , '--email'
+ , type=str
+ , default=''
+ , help="New user's email address." )
+ parser.add_argument( '-a'
+ , '--is_active'
+ , '--active'
+ , nargs='?'
+ , type=argbool
+ , const=True
+ , default=False
+ , help="Enable login. [YES]" )
+ parser.add_argument( '-s'
+ , '--is_staff'
+ , '--staff'
+ , nargs='?'
+ , type=argbool
+ , const=True
+ , default=False
+ , help="Mark user as staff. [NO]" )
+ parser.add_argument( '-S'
+ , '--is_superuser'
+ , '--superuser'
+ , nargs='?'
+ , type=argbool
+ , const=True
+ , default=False
+ , help="Mark user as superuser. [NO]" )
+ parser.add_argument( '-g'
+ , '--groups'
+ , type=str
+ , nargs='*'
+ , default=[]
+ , help="New user's groups." )
+ parser.add_argument( '--user_permissions'
+ , '--user-permissions'
+ , '--permissions'
+ , type=str
+ , nargs='*'
+ , default=[]
+ , help="New user's user permissions." )
+ parser.add_argument( '-j'
+ , '--date_joined'
+ , '--date-joined'
+ , type=str
+ , default=None
+ , help="New user's date joined, formated as '%Y-%m-%d %H:%M:%S.%f'." )
+ parser.add_argument( '--last_login'
+ , '--last-login'
+ , type=str
+ , default=None
+ , help="New user's last login date, formated as '%Y-%m-%d %H:%M:%S.%f'." )
+
+ def handle(self, *args, **options):
+ try:
+ for index,group in enumerate(options["groups"]):
+ options["groups"][index] = Group.objects.get(name=group)
+ for index,permission in enumerate(options["user_permissions"]):
+ options["user_permissions"][index] = Permission.objects.get(name=permission)
+ options["date_joined"] = argdate(options["date_joined"])
+ options["last_login" ] = argdate(options["last_login" ])
+
+ user = User.objects.create_user( username = options["username" ]
+ , password = options["password" ]
+ , email = options["email" ]
+ , first_name = options["first_name" ]
+ , last_name = options["last_name" ]
+ , is_superuser = options["is_superuser" ]
+ , is_staff = options["is_staff" ]
+ , is_active = options["is_active" ]
+ , last_login = options["last_login" ] )
+ user.groups.set(options["groups"])
+ user.user_permissions.set(options["user_permissions"])
+ if options["date_joined"] != None:
+ user.date_joined = options["date_joined"]
+ user.save()
+ except (IntegrityError,Group.DoesNotExist,Permission.DoesNotExist) as exception:
+ self.stdout.write(self.style.ERROR(f'Unable to create user "{options["username"]}": ' + str(exception)))
+ exit(1)
+
+ self.stdout.write(self.style.SUCCESS(f'User "{options["username"]}" has been created.'))
+ exit(0)

django_etebase/admin-cli/management/commands/user-delete.py

@@ -0,0 +1,16 @@
+from django.core.management.base import BaseCommand
+from myauth.models import User
+
+class Command(BaseCommand):
+
+ def add_arguments(self, parser):
+ parser.add_argument( 'username'
+ , type=str
+ , help="Login username of the user to be deleted." )
+
+ def handle(self, *args, **options):
+ try:
+ User.objects.get(username = options["username"]).delete()
+ self.stdout.write(self.style.SUCCESS(f'User "{options["username"]}" has been deleted.'))
+ except User.DoesNotExist as exception:
+ self.stdout.write(self.style.ERROR(f'Unable to delete user "{options["username"]}": ' + str(exception)))