PythonRuns

Tests on Python Code Examples.

Installation

This project uses uv for fast and reliable Python package management.

Installing uv

If you don't have uv installed yet:

# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or with pip
pip install uv

Setting up the project

Create and activate a virtual environment, then install dependencies:

# Create a virtual environment and install dependencies (one step)
uv sync

# Or manually:
# 1. Create a virtual environment
uv venv

# 2. Activate it
# On Linux/macOS:
source .venv/bin/activate
# On Windows:
# .venv\Scripts\activate

# 3. Sync all dependencies
uv sync

Alternatively, you can use the provided makefile:

make install

Working with uv

Common uv commands:

# Sync dependencies from uv.lock (recommended for consistent environments)
uv sync

# Sync with all dependency groups (including dev)
uv sync --all-groups

# Update dependencies and regenerate lockfile
uv lock --upgrade
uv sync

# Add a new dependency
# (Edit pyproject.toml, then run:)
uv lock
uv sync

# Run a command in the virtual environment
uv run python -m pythonruns
uv run pytest

# Use pip if needed for one-off packages (not recommended for project deps)
uv pip install package-name

How to Run

To run some function:

python3 -m sources.file_to_run

To run all the tests in directory 'tests':

python -m unittest discover -s tests

Examples

• calculate_power.py: calculate a power x^y of a number.
• camel_2_snake_case.py: converts a file text content from camel case to snake case.
• convert_pdf_to_docx.py: converts a pdf file to a docx file.
• float_format.py: tests and prints multiple float formats.
• happy_teacher_day.py: prints a heart in the console with the word Teachers, for happy teachers day.
• I_love_you.py: prints a heart in the console with a given 8-character word.
• remove_background.py: removes background from images, letting only the main subject.
• split_script.py: splits a text input file (like a log) into a given number of chunks.
• fake_data.py: creates fake test data using Faker.
• qrcode.py: creates a QR-Code from your data.
• fines_ibama_brazil.py: Environmental fines research in Brazil's government site.
• app_logging.py: the basics of logging in Python.

📝 Latest Articles, Publications and Tech-Talks

• [Code & Coffee - Substack] Java turns 30: An Innovation Journey Through Time and Technology - What 30 years of Java can teach us about building tech that lasts. A timeline on what happened to Java from May 23rd 1995, when Sun Microsystems introduced Java 1.0 to the world, until modern days that made Java essentially great.
• [Dev Community] FastAPI Unleashed: Building Modern and High-Performance APIs - Demostranting FastAPI, a web framework designed for building APIs quickly and efficiently. Python based natively async, it takes advantage of non-blocking I/O to handle high loads, with extra features such as embedded data validation with Pydantic and auto-documentation with Swagger/Redoc.
• [Dev Community] NoSQL Fighters Arena: The Battle of Data Titans - Explore NoSQL databases reimagined as superheroes, each with unique powers and weaknesses, in a fun and visual battle-style format.
• [LinkedIn Pulse] Java is turning 30 soon! Here's Why You Should Care, Even if You're Not a Tech Person - Java is a super famous programming language, and it is almost turning 30. But wait, what exactly is Java, and why should it matter to you?
• [DZone] Top NoSQL Databases and When to Use Each - A practical guide comparing NoSQL technologies like MongoDB, Cassandra, Redis, and more, highlighting their strengths, limitations, and best use cases.
• [Dev Community] Test Python Code Like a Pro with Poetry, Tox, Nox and CI/CD - Improving your test coverage with multiple python versions through the use of of tools like Poetry, Pytest, Tox, Nox and CI/CD.
• [Dev Community] Python Multithreading: Unlocking Concurrency for Better Performance - The essentials of Python multithreading with practical examples and best practices to enhance application performance through concurrency. A must-read, to understand threading application performance in deep.
• [DZone] Secure Password Hashing in Java: Best Practices and Code Examples - Secure password hashing using modern algorithms like BCrypt, Argon2, and PBKDF2 with salting and computational intensity for better security, as alternative to SHA-512.
• More available on my LinkedIn page.

Author

• Wallace Espindola, Sr. Software Engineer / Solution Architect / Java & Python Dev
• LinkedIn: linkedin.com/in/wallaceespindola/
• GitHub: github.com/wallaceespindola
• E-mail: [email protected]
• Twitter: @wsespindola
• Gravatar: gravatar.com/wallacese
• Dev Community: dev.to/wallaceespindola
• DZone Articles: DZone Profile
• Pulse Linkedin: LinkedIn Articles
• Website: W-Tech IT Solutions
• Substack: wallaceespindola.substack.com
• Medium: medium.com/@wallaceespindola
• Slides: speakerdeck.com/wallacese

License

• This project is released under the Apache 2.0 License.
• See the LICENSE file for details.
• Copyright © 2025 Wallace Espindola.