DEV Community

Sara Czasak
Sara Czasak

Posted on

Py_simple: a Python package that makes common tasks read like plain English

#python #showdev #beginners #opensource

Just over a week ago I released a small Python package called py_simple, and it's grown a lot faster than I expected — active contributors, PRs coming in daily, and a full docs site. I wanted to share what it is, why I built it, and why I think it's a genuinely good first open-source project to contribute to, no matter your experience level.

What is py_simple?

py_simple is a beginner-friendly wrapper package for common Python tasks. The whole idea is to remove the need to memorize fiddly syntax or write the same boilerplate over and over.

pip install py-simple-wrap
Enter fullscreen mode Exit fullscreen mode 
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
Enter fullscreen mode Exit fullscreen mode

Every function is importable straight from the top level — no digging through submodules to find what you need.

What's inside

Right now there are 7 modules, each solving one everyday annoyance:

  • easy_file_manager — simpler file operations (make_blank_file, add_a_line, read_file_to_list)
  • easy_date_formatter — readable date formatting (get_pretty_date, dd_mm_yyyy)
  • easy_numbers — beginner-friendly number utilities (is_prime, average)
  • easy_strings — clear string helpers (to_snake_case, is_palindrome) — this one came entirely from a contributor
  • easy_converter — unit conversions without memorizing formulas (celsius_to_fahrenheit, kg_to_lb)
  • easy_validator — validating common input (is_password_secure, is_valid_url)
  • easy_web — checking on websites without touching requests boilerplate (is_page_up, get_page_content) There's a full documentation site built with MkDocs Material, organized so you can either learn from tutorials or jump straight to the reference you need.

Why I built it

I'm a self-taught, junior developer, and I built py_simple out of the same frustration a lot of beginners hit: so much of learning Python is memorizing syntax that has nothing to do with the actual problem you're trying to solve. I wanted a package where the function names basically explain themselves, so beginners can focus on logic instead of syntax.

Why this might be a good project to contribute to

I know how intimidating a first PR can feel, so I tried to make this project a soft landing:

  • The bar for a "good" function is simple: does it make something easier for a beginner? That's it.
  • Issues are scoped to be approachable, so you don't need to understand the whole codebase to make a meaningful contribution.
  • The worst outcome of a PR here is that I ask for a small change before merging — this is meant to be a safe space to learn by doing, not a gauntlet.

  • Every module except easy_strings started as my own code, and easy_strings exists because a contributor added it. That's basically the model for how I'd like the project to keep growing.
    If you want to try it out, install it, poke at the Quickstart, and if there's a function you keep wishing existed — that's usually exactly the kind of thing that becomes a new module here. Stars, issues, and PRs are all genuinely appreciated.

  • 🔗 GitHub: sara-czasak/py_simple

  • 📦 PyPI: py-simple-wrap

  • 📖 Docs: sara-czasak.github.io/py_simple
    Happy to answer questions in the comments, and if you end up contributing something, I'd love to hear about it!

Top comments (0)