User Management System (Python)

A comprehensive user management system built in Python for testing Code Index MCP's analysis capabilities.

Features

User Management: Create, update, delete, and search users
Authentication: Password-based authentication with session management
Authorization: Role-based access control (Admin, User, Guest)
Data Validation: Comprehensive input validation and sanitization
Export/Import: JSON and CSV export capabilities
CLI Interface: Command-line interface for system management

Project Structure

user_management/
├── models/
│   ├── __init__.py
│   ├── person.py          # Basic Person model
│   └── user.py            # User model with auth features
├── services/
│   ├── __init__.py
│   ├── user_manager.py    # User management service
│   └── auth_service.py    # Authentication service
├── utils/
│   ├── __init__.py
│   ├── validators.py      # Input validation utilities
│   ├── exceptions.py      # Custom exception classes
│   └── helpers.py         # Helper functions
├── tests/                 # Test directory (empty for now)
├── __init__.py
└── cli.py                 # Command-line interface

Installation

Install dependencies:

pip install -r requirements.txt

Install the package in development mode:

pip install -e .

Usage

Running the Demo

python main.py

Using the CLI

# Create a new user
user-cli create-user --name "John Doe" --username "john" --age 30 --email "john@example.com"

# List all users
user-cli list-users

# Get user information
user-cli get-user john

# Update user
user-cli update-user john --age 31

# Delete user
user-cli delete-user john

# Search users
user-cli search "john"

# Show statistics
user-cli stats

# Export users
user-cli export --format json --output users.json

Programmatic Usage

from user_management import UserManager, UserRole
from user_management.services.auth_service import AuthService

# Create user manager
user_manager = UserManager()

# Create a user
user = user_manager.create_user(
    name="Jane Smith",
    username="jane",
    age=28,
    email="jane@example.com",
    role=UserRole.USER
)

# Set password
user.set_password("SecurePass123!")

# Authenticate
auth_service = AuthService(user_manager)
authenticated_user = auth_service.authenticate("jane", "SecurePass123!")

# Create session
session_id = auth_service.create_session(authenticated_user)

Testing Features

This project tests the following Python language features:

Classes and Inheritance: Person and User classes with inheritance
Dataclasses: Modern Python data structures
Enums: Role and status enumerations
Type Hints: Comprehensive type annotations
Properties: Getter/setter methods
Class Methods: Factory methods and utilities
Static Methods: Utility functions
Context Managers: Resource management
Decorators: Method decorators
Generators: Iteration patterns
Exception Handling: Custom exceptions
Package Structure: Modules and imports
CLI Development: Click framework integration
JSON/CSV Processing: Data serialization
Regular Expressions: Input validation
Datetime Handling: Time-based operations
Cryptography: Password hashing
File I/O: Data persistence

Dependencies

click: Command-line interface framework
pytest: Testing framework
pydantic: Data validation (optional)

License

MIT License - This is a sample project for testing purposes.

3.6 KiB Raw Blame History