README
⚡[Quickstart](../QUICKSTART.md) · 📦[Modules](../MODULES.md) · 🆘[Support](../SUPPORT.md) · 🚀[Contributing](../CONTRIBUTING.md) · 🌟[Contributors](../CONTRIBUTORS.md) · 📜[Changelog](../CHANGELOG.md) · 🔒[Security](../SECURITY.md) · 🌱[Code of Conduct](../CODE_OF_CONDUCT.md) · ⚖️[License](../LICENSE.md)
# py-simple-wrap
**Making Python feel like plain English.**
[](https://pypi.org/project/py-simple-wrap/)
[](https://github.com/sara-czasak/py-simple-wrap/actions/workflows/tests.yml)
[](../CONTRIBUTORS.md)
[](../LICENSE.md)
[](https://discord.gg/Ge5HnVw2p)
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 | | | | | | | | | | | |:-----------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [📂 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_file_manager/) | [🕰️ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_date_formatter/) | [🔢 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_numbers/) | [📋 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_lists/) | [🔤 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_strings/) | [✂️ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_text/) | [🔄 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_converter/) | [✅ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_validator/) | [🌐 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_web/) | [🎨 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_colors/) | | [🔄 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_flow/) | [📄 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_json/) | [🔍 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_regex/) | [⚡ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_async/) | [🔑 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_dict/) | [🖼️ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_images/) | [🧮 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_math/) | [📊 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_stats/) | [📑 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_csv/) | [📈 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_data_visualization/) | | [🎮 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_game/) | [🎲 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_generator/) | [🗜️ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_archive/) | [❔ ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_sql/) | [🔀 ](https://sara-czasak.github.io/py-simple-wrap/docs/reference/easy_random/) | | | | | | ### Legend: | | | | | | | |------------------------------------------------|-----------------------------------------------------|--------------------------------------------------|-------------------------------------------------------|-------------------------------------------------|----------------------------------------------------| |
🟦 Files & data
| 🟩 Text & validation
| 🟨 Numbers & math
| 🟧 Time & control flow
| 🟪 Web & visuals
| 🟥 Fun & generators
|
## Documentation
| 📦 **[Module reference](../MODULES.md)**
| 🤝 **[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 | 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! |
pip install py-simple-wrap
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
from py_simple import get_page_title
print(get_page_title("https://github.com"))
⭐ 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.
**[Contributing](../CONTRIBUTING.md) · [Changelog](../CHANGELOG.md) · [License](../LICENSE.md)**
Built for beginners, grown by 30+ contributors ✨