py-simple-wrap

Making Python feel like plain English.

py-simple-wrap is a beginner-friendly Python toolbox — simple, intuitive functions for common tasks, so you can build something fun before the syntax gets in the way.

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](https://sara-czasak.github.io/py-simple-wrap/docs/)**

🤝 **[Contributor hub](https://sara-czasak.github.io/py-simple-wrap/docs/contributor-hub/)**

🗺️ **[Contributors quest](https://sara-czasak.github.io/py-simple-wrap/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}	_{Dane Parin}	_{David King}	_{Gaohar Imran}	_ghostfix-pm	_{jagjitkaur0000}	_{Sara Czasak}
_{Vidyavathi GK}	_{Yassin Azzouzi}

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.

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 →

Contributing · Changelog · License

_{Built for beginners, grown by 70+ contributors ✨}