py-simple-wrap

Making Python feel like plain English.

Modules at a glance

📂	🕰️	🔢	📋	🔤	✂️	🔄	✅	🌐	🎨
🔄	📄	🔍	⚡	🔑	🖼️	🧮	📊	📑	📈
🎮	🎲	🗜️	❔	🔀	⚙️	🤖	🪵	🖥️	🔤
📦	🔗	💵	#️⃣

Legend:

🟦 Files & data	🟩 Text & validation	🟨 Numbers & math	🟧 Time & control flow	🟪 Web & visuals	🟥 Fun & generators	🟫 AI

Documentation

HOME PAGE

📦 Module reference	📃 Docs	🤝 Contributor hub	🗺️ Contributors quest
More detailed overview of all modules, links to documentation and tutorials, in other words everything you need to get started	Here you will find everything you need! From references through module tutorials all the way to contributor tutorials!	templates for contributors. This project is meant to help everyone learn and grow, including beginner contributors. The goal is to try to help everyone succeed on there journey with py-simple-wrap and python as a whole.	This is a gamified hub for contributors. You can participate in challenges, earn achievements, join a guild (or two). Search through open issues faster and check your progress in the leaderboard. This is meant to make contributing more fun!

py-simple-wrap collaborators

atiqur rahman	Cid-oe	Dane Parin	David King	Gaohar Imran	ghostfix-pm	jagjitkaur0000
Sara Czasak	Pratham Pansare	Utkarsh Arya	Vidyavathi GK	Yassin Azzouzi	Ymax27

🐍 Python Compatibility

py-simple-wrap v0.9.0+ requires Python 3.11 or newer.

Supported versions: Python 3.11, 3.12, 3.13, and 3.14.

⚠️ Python 3.10 support has been discontinued due to security vulnerabilities affecting Pillow, a dependency used by the image utilities.

If you're using Python 3.10, please upgrade to a supported version before installing v0.9.0 or later.

For more details, see our Security Policy.

pip install py-simple-wrap

This installs the lightweight core; a few modules need extra packages — see Installation in the Quickstart for the full list.

from py_simple import make_blank_file, miles_to_km, is_valid_email

make_blank_file("notes.txt")
print(miles_to_km(26.2))  # 42.16...
print(is_valid_email("hello@example.com"))  # True

Full walkthrough in QUICKSTART.md, or browse the documentation site.

😰 → 😎 See the difference

The traditional way

import requests
from bs4 import BeautifulSoup

try:
    response = requests.get("https://github.com", timeout=10)
    response.raise_for_status()
    page = BeautifulSoup(response.content, "html.parser")
    title = page.title.string
except Exception as e:
    print("The site is down or address is invalid.")

The py-simple-wrap way

Needs the [web] extra: pip install py-simple-wrap[web]

from py_simple import get_page_title
 
print(get_page_title("https://github.com"))

🧩 Project tutorials

Want to see modules working together? Check out the project-based tutorials — small, fun builds that combine 2+ modules into something you'd actually want to make.

📣 Share what you build

Made something with py-simple-wrap? Post about it and tag #py-simple-wrap. I'd love to see it!

⭐ If py-simple-wrap made something easier for you

Consider giving it a star — it helps other beginners find it. And if there's a function you wish existed, fork it and add it; this project grew because other people did exactly that.

📢 Got 2 minutes? Help shape what's next

Whether you've used one function or ten, your feedback decides what gets built next. Take the 2-minute survey →