Repo: https://github.com/Kynlos/KynlosWebServer

Kynlos Python Web Server with PHP Support

This is a Python-based web server that supports serving static files, executing PHP scripts, file uploads, rate limiting, IP whitelisting/blacklisting, HTTPS using self-signed certificates, CORS support, custom error pages, static file caching, Gzip/Brotli compression, basic authentication, virtual hosts, URL redirects, graceful shutdown, browser auto-open, email verification, and SQLite database integration for user management. The server is highly configurable via a `config.json` file.

Features

[*]Serves static files from the `htdocs` directory
[*]Executes PHP scripts using the `php` command
[*]Supports file uploads via POST requests to `/upload`, with uploaded files saved in the `htdocs/downloads` directory
[*]Provides a file download page at `htdocs/download.html` for accessing uploaded files
[*]Rate limiting to prevent abuse (configurable requests per minute and burst limits)
[*]IP whitelisting and blacklisting for access control
[*]HTTPS support using self-signed certificates with configurable certificate details and renewal options
[*]Cross-Origin Resource Sharing (CORS) support
[*]Serves custom HTML pages for different HTTP error codes (configurable via `config.json`)
[*]Implements caching for static files to improve performance (configurable cache size and TTL)
[*]Gzip and Brotli compression for improved transfer speeds
[*]Basic authentication with configurable authorized users
[*]Virtual hosts support for hosting multiple websites or domains
[*]URL redirects for redirecting users from old or outdated URLs to new ones or external websites
[*]Customizable entry point (default: `index.html`)
[*]Logging of requests to a log file
[*]Graceful shutdown on Ctrl-C
[*]Opens the entry point in a web browser on server start
[*]Email verification for new user registrations to prevent spam accounts
[*]SQLite database integration for managing user accounts and enabling user registration and login
[/list]

Requirements

[*]Python 3.x
[*]`php` command available in PATH (for PHP script execution)
[*]`OpenSSL` Python library (for HTTPS support)
[*]`sqlite3` Python library (for SQLite database integration)
[/list]

Configuration

The server can be configured using a `config.json` file in the same directory as the script. The following options are available:

[*]`port`: The port number to run the server on (default: 80)
[*]`entry_point`: The default file to serve when accessing the root URL (default: `index.html`)
[*]`use_https`: Whether to enable HTTPS using a self-signed certificate (default: `false`)
[*]`certfile`: The path to the certificate file for HTTPS (default: `cert.pem`)
[*]`keyfile`: The path to the private key file for HTTPS (default: `key.pem`)
[*]`rate_limit`: The maximum number of requests per minute per IP (default: 10)
[*]`rate_limit_burst`: The maximum number of burst requests allowed (default: 5)
[*]`log_file`: The path to the log file for request logging (default: `server.log`)
[*]`whitelist`: A list of IP addresses that are allowed to access the server (default: [])
[*]`blacklist`: A list of IP addresses that are blocked from accessing the server (default: [])
[*]`htdocs_dir`: The directory to serve static files from (default: `htdocs`)
[*]`downloads_dir`: The directory to save uploaded files to (default: `htdocs/downloads`)
[*]`cert_config`: Configuration options for generating the self-signed certificate
   

[*]`key_size`: The size of the private key in bits (default: 2048)
    [*]`subject`: The subject information for the certificate
       

[*]`C`: Country (default: US)
        [*]`ST`: State (default: California)
        [*]`L`: Locality (default: San Francisco)
        [*]`O`: Organization (default: My Company)
        [*]`OU`: Organizational Unit (default: My Organization)
        [*]`CN`: Common Name (default: localhost)
        [/list]
    [*]`serial_number`: Serial number (default: 1000)
    [*]`valid_days`: Number of days the certificate is valid for (default: 3650)
    [*]`signing_algorithm`: The signing algorithm to use (default: sha256)
    [/list]
[*]`cert_renewal_days`: The number of days before certificate expiration to renew (default: 30)
[*]`cache_max_size`: The maximum size of the static file cache in bytes (default: 10485760)
[*]`cache_ttl`: The time-to-live (TTL) for cached files in seconds (default: 60)
[*]`enable_gzip_compression`: Whether to enable Gzip compression (default: true)
[*]`enable_brotli_compression`: Whether to enable Brotli compression (default: true)
[*]`enable_basic_auth`: Whether to enable basic authentication (default: false)
[*]`auth_users`: A dictionary of authorized usernames and passwords for basic authentication
[*]`enable_virtual_hosts`: Whether to enable virtual hosts support (default: false)
[*]`virtual_hosts`: A dictionary of virtual host mappings, with each key representing a domain and the value specifying the `htdocs_dir` and `entry_point` for that domain
[*]`enable_custom_error_pages`: Whether to enable custom error pages (default: false)
[*]`error_pages`: A dictionary mapping HTTP error codes to custom HTML pages
[*]`redirects`: A dictionary of URL redirects, with each key representing the old URL and the value specifying the new URL or external website
[*]`enable_email_verification`: Whether to enable email verification for new user registrations (default: false)
[*]`smtp_config`: Configuration options for sending verification emails via SMTP
   

[*]`host`: SMTP server hostname
    [*]`port`: SMTP server port
    [*]`username`: SMTP username
    [*]`password`: SMTP password
    [*]`use_tls`: Whether to use TLS encryption (default: true)
    [*]`from_email`: The email address to send verification emails from
    [/list]
[/list]

Usage

[list=1]
[*]Clone the repository or download the `main.py` file.
[*]Create a `config.json` file in the same directory as `main.py` with your desired configuration options.
[*]Place your static files and PHP scripts in the `htdocs` directory or subdirectories.
[*]Run the server using `python main.py`.
[*]Access the server in a web browser at `http://localhost` (or the configured port).
[*]Upload files via the `/upload` endpoint and access them from the `htdocs/download.html` page.
[*]Register new user accounts and verify email addresses to enable user-specific features.
[/list]

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.

License

This project is open-source and available under the MIT License.

Repo:

https://github.com/Kynlos/KynlosWebServer

Hello & good day Kynlo! Just wanted to cheer you up on the new section & releases :Thmbsup:

Keep up the good work!

(P.S.: I'm your first follower on GitHub --you'll surely grow a following in no time)

Cheers!
Vic

-publicdomain (March 06, 2024, 08:01 PM)

Hey Vic!

Thanks for the follow, but I feel I should be honest and mention you're not the first {actually, you are, turns out I was thinking starred, not followers [oops]} (and I'm sponsored on GH for another project on there haha).

Followed you back though :)

RepoRover - GitHub Repository Automation Companion 🚀

Overview
Welcome to RepoRover, your indispensable companion for seamlessly navigating the expansive realm of GitHub repositories! 🌌 This Python script, aptly named RepoRover (reporover.py), brings a touch of sophistication to your repository-related tasks, making automation both enjoyable and efficient.

Features

[*] Commit Exploration: Embark on an insightful journey through commit history, unraveling the details of each SHA, message, author, and date.
[*] Real-time Console Updates: Stay informed with dynamic updates in the console as RepoRover diligently explores the GitHub cosmos.
[*] Tailored Log Files: Craft individual log files for each repository, capturing changes with the precision of a seasoned explorer.
[*] Consolidated Log Hub: Assemble all logs into a unified hub for a comprehensive view of your GitHub ventures.
[*] HTML Data Maps: Generate HTML logs for a polished and organized representation, enhancing your journey through repositories.
[*] Configuration Mastery: Harness the power of RepoRover's customizable behavior through the config.ini file, offering flexibility and control.
[*] Database Integration Excellence: Store repository data in an SQLite database, creating a robust archive of historical changes.
[/list]

Usage

[*] Plot your course by configuring repository URLs in the config.ini file under the [GitHubRepos] section.
[*] Tailor your journey with preferences, scheduling, HTML logs, and database options in the config.ini file.
[*] Launch RepoRover using the command: [/list], and witness its automatic navigation through the GitHub galaxy, uncovering the intricacies of each repository.
[/list]

Configuration Options

[*] GitHub Token: Secure your GitHub token in the config.ini file under the [GitHub] section.
[*] Log Preferences: Choose the specific information to log, such as stars, forks, popularity comparisons, and latest releases.
[*] Scheduling Mastery: Set the time interval for RepoRover to embark on its automatic explorations.
[*] HTML Logging Elegance: Toggle HTML log generation for visually appealing representations of your GitHub expeditions.
[*] Database Integration Wisdom: Decide whether to store repository data in a robust database and specify the database file.
[/list]

Getting Started

[*] Ensure you have Python installed and are ready for a productive coding session.
[*] Configure your config.ini file with repository URLs and preferences.
[*] Install required packages by running: .
[*] Launch RepoRover using the command:

.

Note: If you haven't set a GitHub token, RepoRover will prompt you during its exploration.

Embark on your GitHub journey with RepoRover, and may your code explorations be both enriching and enjoyable! 🌟🚀 If you have any questions or wish to share your experiences, feel free to reach out. Happy coding! 🌌✨

Known Issues
HTML Output and Combined Outputs are not currently filling with data. Will be fixed in a future update.

---

Link: https://github.com/Kynlos/RepoRover