PyServe - v0.3-async

PyServe v0.3-async Release Notes

🚀 Major Features

Asynchronous Architecture

• Complete rewrite using async/await pattern
• Enhanced performance and scalability
• Better handling of concurrent connections
• Improved resource utilization

Basic HTTP Authentication

• Route-based authentication support
• Configurable through YAML configuration
• Multiple protected routes with different credentials
• Detailed authentication logging
• Environment variables support for credentials

Enhanced Logging System

• Structured JSON logging support
• Log rotation capabilities
• Colored console output
• Configurable log levels and destinations
• Performance-optimized for async environments

Improved Configuration Management

• Advanced configuration validation
• Environment variables support
• Enhanced error handling and reporting
• Flexible override options via CLI

Technical Improvements

Security

• SSL/TLS support with proper certificate handling
• Basic HTTP Authentication for route protection
• Secure credential management
• Enhanced error handling for security features

Modular Architecture

• Reorganized codebase for better maintainability
• Clear separation of concerns
• Easier to extend and customize
• Better code organization

Logging Enhancements

• Multiple log formatters
• Log rotation support
• Structured logging in JSON format
• Configurable log levels
• Console and file logging
• Color-coded console output

Configuration

• YAML-based configuration
• Environment variable support
• CLI overrides
• Advanced validation
• Better error messages

Documentation

• Comprehensive documentation rewrite
• New authentication documentation
• Updated configuration guide
• Enhanced logging documentation
• Improved examples and tutorials
• Better troubleshooting guides

Developer Tools

• Enhanced debugging capabilities
• Better error reporting
• Improved test coverage
• Development mode with detailed logging

Bug Fixes

• Fixed SSL certificate handling
• Improved error handling in async operations
• Better handling of concurrent connections
• Fixed configuration validation issues
• Enhanced logging reliability

Configuration Example

http:
  static_dir: ./static
  templates_dir: ./templates
logging:
  level: INFO
  log_file: ./logs/pyserve.log
  console_output: true
  use_colors: true
  use_rotation: false
  structured_logs: false
server:
  host: 127.0.0.1
  port: 8000
  locations:
    /admin:
      auth:
        type: basic
        username: admin
        password: secretpass
ssl:
  enabled: true
  cert_file: ./ssl/cert.pem
  key_file: ./ssl/key.pem

Quick Start

# DO NOT FORGET!
chmod +x run.py

# Basic usage
./run.py

# With SSL enabled
./run.py --ssl --cert ./ssl/cert.pem --key ./ssl/key.pem

# Custom port and host
./run.py -H 0.0.0.0 -p 8080

# Debug mode
./run.py -d

Breaking Changes

• Configuration file structure has been updated
• Logging configuration has changed
• Authentication configuration moved to locations section
• SSL configuration structure modified

Future Plans

• Token-based authentication
• WebSocket support
• Rate limiting
• Custom middleware support
• Plugin system

What's Changed

• v0.3 merge for Release by @ShiftyX1 in #2

Full Changelog: v0.2-async...v0.3-async