Skip to content

Repository files navigation

🐍 my-pythonic-zoo

Minimum Runtime Requirement: Python 3.10+ (Utilises modern type-hinting features).

Housing a variety of self-contained Python scripts built with clean formatting and clear logic. - improvements welcome 🧐

Have an idea or optimization? Please review our CONTRIBUTING.md guide before starting; you must first place a comment on an existing Issue to request assignment to prevent duplication of effort, or use our Bug Report / Feature Request templates using the New Issue option including a request to be assigned if required. Direct Pull Requests from unassigned developers will not be accepted.


🤖 AI & Automated Contributions

We welcome contributions assisted by AI tools and autonomous workflows, provided that:

  1. Full Disclosure: All AI-generated or agent-assisted code and documentation must be explicitly disclosed in the Pull Request description, detailing the tools or frameworks used.
  2. Human Oversight: The submitting contributor takes full responsibility for reviewing, testing, and understanding every line of submitted code. Undisclosed or unreviewed automated submissions may be closed without review.

🗺️ Zoo Map (Curated Progression)

This repository is organized as an exhibition cookbook. Every script is entirely self-contained, using built-in standard libraries to remain immediately runnable and easily forkable.

Foundational text and data preprocessing utilities.

  • string_cleaner.py: Optimised text standardisation using Pythonic list comprehensions to fix whitespace and capitalization on raw datasets.
  • phone_sanitiser.py: Standalone Australian phone number sanitisation and structural block formatting with support for mobile, landlines (Perth/WA area codes), 13/1300/1800 numbers, and international prefixes.

Authentication mechanisms and secure input architecture.

  • password_hasher.py: Cryptographic credential handling implementing hashlib.pbkdf2_hmac with unique byte salts to defend against rainbow table and brute-force attacks.
  • email_validator.py: Lightweight, regex-free input validation module using fast Pythonic string parsing boundaries to catch and sanitize malformed data before database staging.

System durability, context safety, and resource management.

  • connection_tester.py: Safe SQLite execution environments wrapping queries in strict try-except-finally blocks to guarantee resource closure and prevent server memory leaks.

Cross-platform Graphical User Interface examples using Python's standard built-in library Tkinter.

  • basic_window_viewer.py: Simple window display (runs autonomously from Terminal via launch_window.pyw)

Code Quality

This repository enforces strict code hygiene, style guidelines, and bug prevention rules using the Ruff linter. Configuration maps are located in pyproject.toml.


🚀 How to Run an Exhibit

Every script in this zoo includes its own mock data block and execution wrapper. You do not need to install complex dependencies or configure global environments.

  1. Clone or fork this repository.
  2. Navigate to the desired folder.
  3. Run the script directly from your terminal:
    python string_cleaner.py
  4. If using VS Code or similar, right-click on python file to choose Run Python File in Terminal.

🛠️ Work in Progress & Upcoming Exhibits

This zoo is an active, evolving cookbook. We are continuously curating and deploying new standalone use cases.

🚀 On the Way / Teasers:

  • Database Operations (CRUD): Implementing complete Create, Read, Update, and Delete transactional structures using safe parameterized queries.
  • Core Communication & API Routing: Setting up lightweight endpoints, request parsing, and custom status code returns.
  • System Automation & DevOps: Writing robust Python scripts for automated file system archiving, backup routines, and local directory cleanup operations.
  • Data Science & AI Foundations: Deploying mathematical array manipulations and lightweight data synthesis modules.

File Last Updated Maintainer
README.md 6 August 2026 lizc-au

About

Housing a variety of self-contained Python scripts built with clean formatting and clear logic - improvements welcome🧐

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages