Python Login System

• Readme

  

  Simple file-based authentication system with messaging, permissions, and moderation.

  Documentation • Report Bug • Request Feature

  

  ---

  🌟 Why This Login System? 🌟

  • Fully customizable and easy to extend
  • Includes real-world features (messaging, permissions, banning, etc.)
  • Optimized and Lightweight — no database required

  ---

  ✨ Features ✨

  • User authentication (login & signup)
  • Password hashing using SHA-256
  • Between-user messaging
  • Mailbox system (read, send, clear)
  • Permission system (5 tiers)
  • User promotion system
  • User banning system
  • Account deletion
  • Initial setup mode

  ---

  📁 Data Storage Overview

  • users.txt → Stores usernames and hashed passwords
  • bannedusers.txt → Stores banned usernames
  • user_(id).txt → Stores user permissions
  • mailbox_(username).txt → Stores user messages

  ---

  🚀 Quick-Start Guide

  download the program by running:

  pip install simple-login-system==0.{version}

  Run it by typing

  python -m simplelogin.login

  Run the program and type:

  setup

  !DISCLAIMER!

  Setup user can only be used for promoting and some default features

  Make a different user and promote it to use more features

  This will:

  • Create a default admin account
  • Grant admin promotion permissions

  Default credentials:

  • Username: setup
  • Password: setup

  Important: Delete this account after creating your own admin account and give it perms.

  ---

  Commands

  Command	Description
  help	Show all commands
  date/time	Shows the current date and time
  message	Send a message to a user
  readmail	Read your mailbox
  promote	Promote a user (requires permission)
  ban	Ban a user
  blacklist	Blacklists a username from use for a new account
  deleteaccount	Delete your account
  changelog	View changes
  quit	Exit the program

  ---

  🤝 Contributing

  • Found a bug? Open an issue
  • Have an idea? Suggest a feature
  • Want to improve the code? Submit a PR

  All contributions are welcome.

  ---

  AI declaration

  Used copilot for deployment to PyPi and chatgpt for simple bug fixes early on.

  ---

  Optimization

  • I made the program as optimized as possible by using defs to make it run smooth, I also dont use any databases or external programs that might make it take more memory or cpu capability.
  • I made it run fast and smooth with not too much random bulk that would be in the way of users access to the program

  ---

  
  

  Made with learning in mind.
  If you like it, consider ⭐ starring the repo!

  **I will try to update this program once in a while so I have a changelog aswel.**

• Github Repository