Skip to content

Quickstart

Get up and running with py-simple-wrap in under a minute.

Installation

pip install py-simple-wrap

This installs the lightweight core — most modules (easy_math, easy_strings, easy_validator, and 15 others) work right away with nothing else to install. A few need extra packages:

Extra Unlocks
[ai] easy_ai
[game] easy_game
[viz] easy_data_visualization
[images] easy_images, and easy_generator's generate_qr_code
[web] easy_web
[config] easy_config's gh_workflow_config(at_root=False)
[json] easy_json's flatten_json

Install everything at once:

pip install py-simple-wrap[all]

Or install just what you need, e.g.:

pip install py-simple-wrap[game]

Note: The PyPI package is named py-simple-wrap (the name py-simple was already taken), but you still import it as py_simple in your code.

Basic Usage

Every function is available directly from the top-level package — no need to dig into submodules:

from py_simple import make_blank_file, miles_to_km, is_valid_email

# Create a new file in one line
make_blank_file("notes.txt")

# Convert units without memorizing formulas
distance_km = miles_to_km(26.2)
print(distance_km)  # 42.16...

# Validate common input formats
print(is_valid_email("hello@example.com"))  # True

A Taste of Each Module

📂 File handling — easy_file_manager

from py_simple import make_blank_file, add_a_line, read_file_to_list

make_blank_file("todo.txt")
add_a_line("todo.txt", "Buy groceries")
print(read_file_to_list("todo.txt"))

🕰️ Dates — easy_date_formatter

from py_simple import get_pretty_date, dd_mm_yyyy

print(get_pretty_date())  # e.g. "July 31, 2026"
print(dd_mm_yyyy())  # e.g. "31-07-2026"

🔄 Unit conversion — easy_converter

from py_simple import celsius_to_fahrenheit, kg_to_lb

print(celsius_to_fahrenheit(20))  # 68.0
print(kg_to_lb(70))  # 154.32...

🔢 Numbers — easy_numbers

from py_simple import is_prime, average

print(is_prime(17))  # True
print(average([4, 8, 15, 16, 23, 42]))

✅ Validation — easy_validator

from py_simple import is_password_secure, is_valid_url

print(is_password_secure("hunter2"))  # False
print(is_valid_url("https://example.com"))  # True

🌐 Web — easy_web

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

from py_simple import is_page_up, get_page_content

print(is_page_up("https://python.org"))  # True

🔤 Strings — easy_strings

from py_simple import to_snake_case, is_palindrome

print(to_snake_case("Hello World"))  # "hello_world"
print(is_palindrome("racecar"))  # True

Next Steps

  • Browse the Reference section in the sidebar for the complete list of functions in every module.
  • See the full MODULES.md for the complete list of functions in each module.
  • Want to contribute? Check out CONTRIBUTING.md.