micro-users 1.0.1__tar.gz

micro_users-1.0.1/LICENSE

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

micro_users-1.0.1/MANIFEST.in

@@ -0,0 +1,19 @@
+# Include the README so PyPI shows your long description
+include README.md
+
+# Include the license
+include LICENSE
+
+# Include all files inside the users package
+recursive-include users *
+
+# If you have templates inside the users app
+recursive-include users/templates *
+
+# If you have static files
+recursive-include users/static *
+
+# Make sure no unnecessary Python cache files are included
+exclude *.pyc
+exclude __pycache__/
+recursive-exclude * __pycache__ *.pyc *.pyo

micro_users-1.0.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.1
+Name: micro_users
+Version: 1.0.1
+Summary: Django user management app with abstract user, permissions, and activity logging
+Home-page: https://github.com/debeski/micro_users
+Author: DeBeski
+Author-email: DeBeski <debeski1@gmail.com>
+License: MIT
+Keywords: django,users,permissions,authentication
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.17
+Requires-Dist: django-crispy-forms>=2.4
+Requires-Dist: django-tables2>=2.7.5
+Requires-Dist: django-filter>=25.1
+Requires-Dist: pillow>=11.0
+Requires-Dist: babel>=2.1
+
+# Micro Users - Django User Management App
+
+[![PyPI version](https://badge.fury.io/py/micro-users.svg)](https://pypi.org/project/micro-users/)
+
+A lightweight, reusable Django app providing user management with abstract user, permissions, localization, and activity logging.
+
+## Features
+- Custom AbstractUser model
+- User permissions system  
+- Activity logging (login/logout tracking)
+- Localization support
+- Admin interface integration
+- CRUD views and templates
+- Filtering and tabulation
+
+## Installation
+
+```bash
+pip install git+https://github.com/debeski/micro-users.git
+# OR local
+pip install micro-users
+```
+
+## Configuration
+
+1. Add to `INSTALLED_APPS`:
+```python
+INSTALLED_APPS = [
+    ...
+    'django_tables2',
+    'django_filters', 
+    'crispy_forms',
+    'users',  # Add this
+]
+```
+
+2. Set custom user model in settings.py:
+```python
+AUTH_USER_MODEL = 'users.User'
+```
+
+3. Include URLs in your main project folder `urls.py`:
+```python
+urlpatterns = [
+    ...
+    path('users/', include('users.urls')),
+]
+```
+
+4. make migrations and migrate:
+```bash
+python manage.py makemigrations users
+python manage.py migrate users
+```
+
+## Requirements
+- Python 3.9+
+- Django 5.1+
+- See setup.py for full dependencies
+
+## Structure
+```
+users/
+├── models.py      # User model, permissions, activity logs
+├── views.py       # CRUD operations
+├── urls.py        # URL routing
+├── admin.py       # Admin integration
+├── templates/     # HTML templates
+└── migrations/    # Database migrations
+```

micro_users-1.0.1/README.md

@@ -0,0 +1,70 @@
+# Micro Users - Django User Management App
+
+[![PyPI version](https://badge.fury.io/py/micro-users.svg)](https://pypi.org/project/micro-users/)
+
+A lightweight, reusable Django app providing user management with abstract user, permissions, localization, and activity logging.
+
+## Features
+- Custom AbstractUser model
+- User permissions system  
+- Activity logging (login/logout tracking)
+- Localization support
+- Admin interface integration
+- CRUD views and templates
+- Filtering and tabulation
+
+## Installation
+
+```bash
+pip install git+https://github.com/debeski/micro-users.git
+# OR local
+pip install micro-users
+```
+
+## Configuration
+
+1. Add to `INSTALLED_APPS`:
+```python
+INSTALLED_APPS = [
+    ...
+    'django_tables2',
+    'django_filters', 
+    'crispy_forms',
+    'users',  # Add this
+]
+```
+
+2. Set custom user model in settings.py:
+```python
+AUTH_USER_MODEL = 'users.User'
+```
+
+3. Include URLs in your main project folder `urls.py`:
+```python
+urlpatterns = [
+    ...
+    path('users/', include('users.urls')),
+]
+```
+
+4. make migrations and migrate:
+```bash
+python manage.py makemigrations users
+python manage.py migrate users
+```
+
+## Requirements
+- Python 3.9+
+- Django 5.1+
+- See setup.py for full dependencies
+
+## Structure
+```
+users/
+├── models.py      # User model, permissions, activity logs
+├── views.py       # CRUD operations
+├── urls.py        # URL routing
+├── admin.py       # Admin integration
+├── templates/     # HTML templates
+└── migrations/    # Database migrations
+```

micro_users-1.0.1/micro_users.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.1
+Name: micro-users
+Version: 1.0.1
+Summary: Django user management app with abstract user, permissions, and activity logging
+Home-page: https://github.com/debeski/micro_users
+Author: DeBeski
+Author-email: DeBeski <debeski1@gmail.com>
+License: MIT
+Keywords: django,users,permissions,authentication
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.17
+Requires-Dist: django-crispy-forms>=2.4
+Requires-Dist: django-tables2>=2.7.5
+Requires-Dist: django-filter>=25.1
+Requires-Dist: pillow>=11.0
+Requires-Dist: babel>=2.1
+
+# Micro Users - Django User Management App
+
+[![PyPI version](https://badge.fury.io/py/micro-users.svg)](https://pypi.org/project/micro-users/)
+
+A lightweight, reusable Django app providing user management with abstract user, permissions, localization, and activity logging.
+
+## Features
+- Custom AbstractUser model
+- User permissions system  
+- Activity logging (login/logout tracking)
+- Localization support
+- Admin interface integration
+- CRUD views and templates
+- Filtering and tabulation
+
+## Installation
+
+```bash
+pip install git+https://github.com/debeski/micro-users.git
+# OR local
+pip install micro-users
+```
+
+## Configuration
+
+1. Add to `INSTALLED_APPS`:
+```python
+INSTALLED_APPS = [
+    ...
+    'django_tables2',
+    'django_filters', 
+    'crispy_forms',
+    'users',  # Add this
+]
+```
+
+2. Set custom user model in settings.py:
+```python
+AUTH_USER_MODEL = 'users.User'
+```
+
+3. Include URLs in your main project folder `urls.py`:
+```python
+urlpatterns = [
+    ...
+    path('users/', include('users.urls')),
+]
+```
+
+4. make migrations and migrate:
+```bash
+python manage.py makemigrations users
+python manage.py migrate users
+```
+
+## Requirements
+- Python 3.9+
+- Django 5.1+
+- See setup.py for full dependencies
+
+## Structure
+```
+users/
+├── models.py      # User model, permissions, activity logs
+├── views.py       # CRUD operations
+├── urls.py        # URL routing
+├── admin.py       # Admin integration
+├── templates/     # HTML templates
+└── migrations/    # Database migrations
+```

micro_users-1.0.1/micro_users.egg-info/SOURCES.txt

@@ -0,0 +1,29 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+micro_users.egg-info/PKG-INFO
+micro_users.egg-info/SOURCES.txt
+micro_users.egg-info/dependency_links.txt
+micro_users.egg-info/requires.txt
+micro_users.egg-info/top_level.txt
+users/__init__.py
+users/admin.py
+users/apps.py
+users/filters.py
+users/forms.py
+users/models.py
+users/signals.py
+users/tables.py
+users/urls.py
+users/views.py
+users/migrations/__init__.py
+users/static/css/login.css
+users/templates/user_activity_log.html
+users/templates/registration/login.html
+users/templates/users/manage_users.html
+users/templates/users/profile.html
+users/templates/users/profile_edit.html
+users/templates/users/user_actions.html
+users/templates/users/user_form.html

micro_users-1.0.1/micro_users.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

micro_users-1.0.1/micro_users.egg-info/requires.txt

@@ -0,0 +1,6 @@
+Django>=5.17
+django-crispy-forms>=2.4
+django-tables2>=2.7.5
+django-filter>=25.1
+pillow>=11.0
+babel>=2.1

micro_users-1.0.1/micro_users.egg-info/top_level.txt

@@ -0,0 +1 @@
+users

micro_users-1.0.1/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = [
+    "setuptools<69",   # ensures Metadata-Version <= 2.2
+    "wheel<0.41"
+]
+build-backend = "setuptools.build_meta"
+
+
+[project]
+name = "micro_users"
+version = "1.0.1"
+description = "Django user management app with abstract user, permissions, and activity logging"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "DeBeski", email = "debeski1@gmail.com" }
+]
+keywords = ["django", "users", "permissions", "authentication"]
+
+# Dependencies
+dependencies = [
+    "Django>=5.17",
+    "django-crispy-forms>=2.4",
+    "django-tables2>=2.7.5",
+    "django-filter>=25.1",
+    "pillow>=11.0",
+    "babel>=2.1",
+]
+
+# Classifiers
+classifiers = [
+    "Framework :: Django",
+    "Framework :: Django :: 5",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+# Tell setuptools which packages to include
+[tool.setuptools.packages.find]
+include = ["users"]
+
+# Include static/templates files (equivalent to include_package_data=True)
+[tool.setuptools]
+include-package-data = true

micro_users-1.0.1/setup.cfg

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

micro_users-1.0.1/setup.py

@@ -0,0 +1,39 @@
+from setuptools import setup
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="micro_users",
+    version="1.0.1",
+    author="DeBeski",
+    author_email="debeski1@gmail.com",
+    description="Django user management app with abstract user, permissions, and activity logging",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/debeski/micro_users",
+    packages=["users"],
+    include_package_data=True,
+    classifiers=[
+        "Framework :: Django",
+        "Framework :: Django :: 5",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "License :: OSI Approved :: MIT License",  # MIT license
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.9",
+    install_requires=[
+        "Django>=5.17",
+        "django-crispy-forms>=2.4",
+        "django-tables2>=2.7.5",
+        "django-filter>=25.1",
+        "pillow>=11.0",
+        "babel>=2.1",
+    ],
+    license="MIT",
+)

micro_users-1.0.1/users/admin.py

@@ -0,0 +1,18 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin
+from django.contrib.auth import get_user_model
+from django.contrib.auth.models import Group
+
+User = get_user_model()
+
+class CustomUserAdmin(UserAdmin):
+    model = User
+    list_display = ['username', 'email', 'is_staff', 'is_active', 'phone', 'occupation']
+    list_filter = ['is_staff', 'is_active']
+    search_fields = ['username', 'email']
+    ordering = ['username']
+
+admin.site.register(User, CustomUserAdmin)
+admin.site.unregister(Group)

micro_users-1.0.1/users/apps.py

@@ -0,0 +1,30 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.apps import AppConfig
+
+def custom_permission_str(self):
+    """Custom Arabic translations for Django permissions"""
+    model_name = str(self.content_type)
+    permission_name = str(self.name)
+
+    # Translate default permissions
+    if "Can add" in permission_name:
+        permission_name = permission_name.replace("Can add", " إضافة ")
+    elif "Can change" in permission_name:
+        permission_name = permission_name.replace("Can change", " تعديل ")
+    elif "Can delete" in permission_name:
+        permission_name = permission_name.replace("Can delete", " حذف ")
+    elif "Can view" in permission_name:
+        permission_name = permission_name.replace("Can view", " عرض ")
+
+    return f"{permission_name}"
+
+
+class UsersConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'users'
+    verbose_name = "المستخدمين"
+
+    def ready(self):
+        from django.contrib.auth.models import Permission
+        Permission.__str__ = custom_permission_str

micro_users-1.0.1/users/filters.py

@@ -0,0 +1,120 @@
+# Imports of the required python modules and libraries
+######################################################
+import django_filters
+from django.contrib.auth import get_user_model
+from crispy_forms.helper import FormHelper
+from crispy_forms.layout import Layout, Row, Column, Field, HTML
+from django.db.models import Q
+from .models import UserActivityLog
+
+User = get_user_model()  # Use custom user model
+
+class UserFilter(django_filters.FilterSet):
+    keyword = django_filters.CharFilter(
+        method='filter_keyword',
+        label='',
+    )
+
+    class Meta:
+        model = User
+        fields = []
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.form.helper = FormHelper()
+        self.form.helper.form_method = 'GET'
+        self.form.helper.form_class = 'form-inline'
+        self.form.helper.form_show_labels = False
+        self.form.helper.layout = Layout(
+            Row(
+                Column(Field('keyword', placeholder="البحث"), css_class='form-group col-auto flex-fill'),
+                Column(HTML('<button type="submit" class="btn btn-secondary w-100"><i class="bi bi-search bi-font text-light me-2"></i>بحـــث</button>'), css_class='col-auto text-center'),
+                Column(HTML('{% if request.GET and request.GET.keys|length > 1 %} <a href="{% url "manage_users" %}" class="btn btn-warning bi-font">clear</a> {% endif %}'), css_class='form-group col-auto text-center'),
+                css_class='form-row'
+            ),
+        )
+
+    def filter_keyword(self, queryset, name, value):
+        """
+        Filter the queryset by matching the keyword in username, email, phone, and occupation.
+        """
+        return queryset.filter(
+            Q(username__icontains=value) |
+            Q(email__icontains=value) |
+            Q(phone__icontains=value) |
+            Q(occupation__icontains=value) |
+            Q(first_name__icontains=value) |
+            Q(last_name__icontains=value)
+        )
+
+
+
+class UserActivityLogFilter(django_filters.FilterSet):
+    keyword = django_filters.CharFilter(
+        method='filter_keyword',
+        label='',
+    )
+
+    year = django_filters.ChoiceFilter(
+        field_name="timestamp__year",
+        lookup_expr="exact",
+        choices=[],
+        empty_label="السنة",
+    )
+
+    class Meta:
+        model = UserActivityLog
+        fields = {
+            'timestamp': ['gte', 'lte'],
+        }
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        
+        # Fetch distinct years dynamically
+        years = UserActivityLog.objects.dates('timestamp', 'year').distinct()
+        self.filters['year'].extra['choices'] = [(year.year, year.year) for year in years]
+
+        self.filters['year'].field.widget.attrs.update({
+            'onchange': 'this.form.submit();'
+        })
+
+        self.form.helper = FormHelper()
+        self.form.helper.form_method = 'GET'
+        self.form.helper.form_class = 'form-inline'
+        self.form.helper.form_show_labels = False
+        
+        self.form.helper.layout = Layout(
+            Row(
+                Column(Field('keyword', placeholder="البحث"), css_class='form-group col-auto flex-fill'),
+                Column(Field('year', placeholder="السنة", dir="rtl"), css_class='form-group col-auto'),
+                Column(
+                    Row(
+                        Column(Field('timestamp__gte', css_class='flatpickr', placeholder="من "), css_class='col-6'),
+                        Column(Field('timestamp__lte', css_class='flatpickr', placeholder="إلى "), css_class='col-6'),
+                    ), 
+                    css_class='col-auto flex-fill'
+                ),
+                Column(HTML('<button type="submit" class="btn btn-secondary w-100"><i class="bi bi-search bi-font text-light me-2"></i>بحـــث</button>'), css_class='col-auto text-center'),
+                Column(HTML('{% if request.GET and request.GET.keys|length > 1 %} <a href="{% url "user_activity_log" %}" class="btn btn-warning bi-font">clear</a> {% endif %}'), css_class='form-group col-auto text-center'),
+                css_class='form-row'
+            ),
+        )
+
+    def filter_keyword(self, queryset, name, value):
+        """
+        Filter the queryset by matching the keyword in username, email, phone, and occupation.
+        """
+        return queryset.filter(
+            Q(user__username__icontains=value) |
+            Q(user__email__icontains=value) |
+            Q(user__profile__phone__icontains=value) |
+            Q(user__profile__occupation__icontains=value) |
+            Q(action__icontains=value) |
+            Q(model_name__icontains=value) |
+            Q(number__icontains=value) |
+            Q(ip_address__icontains=value)
+        )
+
+
+