py-simple-wrap 0.1.0__tar.gz

py_simple_wrap-0.1.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sara Czasak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py_simple_wrap-0.1.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: py_simple_wrap
+Version: 0.1.0
+Summary: A package to make complex python functionality simple
+Author-email: Sara Czasak <sara.p.czasak.m@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Sara Czasak
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Homepage, https://github.com/sara-czasak/py_simple
+Project-URL: Repository, https://github.com/sara-czasak/py_simple
+Project-URL: Bug Tracker, https://github.com/sara-czasak/py_simple/issues
+Keywords: python,beginner-friendly,wrapper,education
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: requests>=2.25.0
+Requires-Dist: beautifulsoup4>=4.9.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Dynamic: license-file
+
+# Py_simple 🚀
+
+Making Python feel like plain English.
+
+Py_simple is a beginner-friendly Python wrapper package designed to help beginners and developers perform common tasks using simple, intuitive functions.
+
+The goal of this project is to remove the need for memorizing complex syntax or writing repetitive boilerplate code, making Python more accessible and enjoyable for everyone.
+
+---
+
+## 🛠️ Module Menu
+
+Py_simple provides simple modules designed to make common Python tasks easier.
+
+### 📂 Easy File Manager
+
+Simplify everyday file operations with beginner-friendly utilities.
+
+Features include:
+
+- File management helpers
+- Easier file operations
+- Cleaner Python workflows
+
+---
+
+### 🕰️ Easy Date Formatter
+
+Make working with dates simpler and more readable.
+
+Features include:
+
+- Date formatting utilities
+- Easier date manipulation
+- Simple date-related functions
+
+---
+
+### 🔢 Easy Numbers
+
+Perform common number operations using simple and readable functions.
+
+Features include:
+
+- Number utilities
+- Beginner-friendly calculations
+- Cleaner mathematical operations
+
+---
+### 🔤 Easy Strings
+
+Handle common string operations using clear, beginner-friendly functions.
+
+Features include:
+
+- Removing repeated spaces
+- Converting text to `snake_case`
+- Converting text to `kebab-case`
+- Checking whether text is a palindrome
+
+### 🔄 Easy Converter
+
+Convert values easily using simple utility functions.
+
+Features include:
+
+- Simple conversions
+- Easy-to-use helpers
+- Less repetitive code
+
+---
+
+### ✅ Easy Validator
+
+Validate common input formats using simple, readable functions.
+
+Features include:
+
+- Email, username, and URL validation
+- US zip code validation
+- Password strength validation
+
+---
+
+### 🌐 Easy Web
+[Easy Web Documentation](docs/easy_web.md)
+
+Make getting data from the web less complex.
+
+Features include:
+
+- Checking if website is up
+- Getting page content
+
+More examples and documentation will be added as the project grows.
+
+---
+
+## 🤝 Contributing
+
+I would love to have your help in making Python simpler for everyone!
+
+Contributions of all sizes are welcome:
+
+- Fix documentation
+- Improve existing modules
+- Suggest new features
+- Add new functionality
+- Improve examples
+
+Please check [CONTRIBUTING.md](CONTRIBUTING.md) before submitting changes.
+
+Every contribution helps make Py_simple better for beginners and developers.
+
+---
+
+## 🌟 Hall of Fame
+
+A huge thank you to the wonderful people who have helped build Py_simple:
+
+- **Sara Czasak** (Creator)
+- **ghostfix-pm** (Major features & Refactoring)
+- **jagjitkaur0000** (Added tests for easy_numbers module)
+- **Onion0121** (Improved documentation)
+- **averyquinnhq** (Added tests for easy_converter.py)
+- **gaoharimran29-glitch** (Added tests for easy_validator.py)
+- **mmaxjr** (Improved documentation)
+- **sol4nki** (Expanded easy_converter.py module)
+- **shivams786** (Added easy_strings.py)
+- **HeaTTap** (Added tests for easy_web module)
+
+See the full list of contributions in [CONTRIBUTORS.md](CONTRIBUTORS.md).
+
+---
+
+## ⚖️ License
+
+This project is licensed under the MIT License.
+
+You are free to use, modify, and distribute it.
+
+See the [LICENSE.md](LICENSE.md) file for the full legal text.

py_simple_wrap-0.1.0/README.md

@@ -0,0 +1,142 @@
+# Py_simple 🚀
+
+Making Python feel like plain English.
+
+Py_simple is a beginner-friendly Python wrapper package designed to help beginners and developers perform common tasks using simple, intuitive functions.
+
+The goal of this project is to remove the need for memorizing complex syntax or writing repetitive boilerplate code, making Python more accessible and enjoyable for everyone.
+
+---
+
+## 🛠️ Module Menu
+
+Py_simple provides simple modules designed to make common Python tasks easier.
+
+### 📂 Easy File Manager
+
+Simplify everyday file operations with beginner-friendly utilities.
+
+Features include:
+
+- File management helpers
+- Easier file operations
+- Cleaner Python workflows
+
+---
+
+### 🕰️ Easy Date Formatter
+
+Make working with dates simpler and more readable.
+
+Features include:
+
+- Date formatting utilities
+- Easier date manipulation
+- Simple date-related functions
+
+---
+
+### 🔢 Easy Numbers
+
+Perform common number operations using simple and readable functions.
+
+Features include:
+
+- Number utilities
+- Beginner-friendly calculations
+- Cleaner mathematical operations
+
+---
+### 🔤 Easy Strings
+
+Handle common string operations using clear, beginner-friendly functions.
+
+Features include:
+
+- Removing repeated spaces
+- Converting text to `snake_case`
+- Converting text to `kebab-case`
+- Checking whether text is a palindrome
+
+### 🔄 Easy Converter
+
+Convert values easily using simple utility functions.
+
+Features include:
+
+- Simple conversions
+- Easy-to-use helpers
+- Less repetitive code
+
+---
+
+### ✅ Easy Validator
+
+Validate common input formats using simple, readable functions.
+
+Features include:
+
+- Email, username, and URL validation
+- US zip code validation
+- Password strength validation
+
+---
+
+### 🌐 Easy Web
+[Easy Web Documentation](docs/easy_web.md)
+
+Make getting data from the web less complex.
+
+Features include:
+
+- Checking if website is up
+- Getting page content
+
+More examples and documentation will be added as the project grows.
+
+---
+
+## 🤝 Contributing
+
+I would love to have your help in making Python simpler for everyone!
+
+Contributions of all sizes are welcome:
+
+- Fix documentation
+- Improve existing modules
+- Suggest new features
+- Add new functionality
+- Improve examples
+
+Please check [CONTRIBUTING.md](CONTRIBUTING.md) before submitting changes.
+
+Every contribution helps make Py_simple better for beginners and developers.
+
+---
+
+## 🌟 Hall of Fame
+
+A huge thank you to the wonderful people who have helped build Py_simple:
+
+- **Sara Czasak** (Creator)
+- **ghostfix-pm** (Major features & Refactoring)
+- **jagjitkaur0000** (Added tests for easy_numbers module)
+- **Onion0121** (Improved documentation)
+- **averyquinnhq** (Added tests for easy_converter.py)
+- **gaoharimran29-glitch** (Added tests for easy_validator.py)
+- **mmaxjr** (Improved documentation)
+- **sol4nki** (Expanded easy_converter.py module)
+- **shivams786** (Added easy_strings.py)
+- **HeaTTap** (Added tests for easy_web module)
+
+See the full list of contributions in [CONTRIBUTORS.md](CONTRIBUTORS.md).
+
+---
+
+## ⚖️ License
+
+This project is licensed under the MIT License.
+
+You are free to use, modify, and distribute it.
+
+See the [LICENSE.md](LICENSE.md) file for the full legal text.

py_simple_wrap-0.1.0/py_simple_package/src/py_simple/__init__.py

@@ -0,0 +1,32 @@
+from .easy_file_manager import (
+    make_blank_file, is_file_there, add_a_line, read_file_to_list,
+    remove_file, rename_file, list_files, copy_file,
+)
+from .easy_date_formatter import (
+    get_pretty_date, get_past_pretty_date, get_future_pretty_date,
+    dd_mm_yyyy, past_dd_mm_yyyy, future_dd_mm_yyyy,
+    mm_dd_yyyy, past_mm_dd_yyyy, future_mm_dd_yyyy,
+    slash_dd_mm_yyyy, past_slash_dd_mm_yyyy, future_slash_dd_mm_yyyy,
+    slash_mm_dd_yyyy, past_slash_mm_dd_yyyy, future_slash_mm_dd_yyyy,
+    list_available_formats,
+)
+from .easy_converter import (
+    seconds_to_hh_mm_ss, miles_to_km, km_to_mile, fluid_oz_to_ml,
+    ml_to_fluid_oz, celsius_to_fahrenheit, fahrenheit_to_celsius, kg_to_lb,
+    lb_to_kg, meters_to_feet, feet_to_meters, cm_to_inches, inches_to_cm,
+    sq_feet_to_sq_meters, sq_meters_to_sq_feet
+)
+from .easy_numbers import (
+    is_even, is_odd, is_evenly_divisible, is_negative, is_positive,
+    average, is_prime, percentage_of
+)
+from .easy_validator import (
+    is_valid_email, is_valid_username, is_valid_zipcode, is_valid_url,
+    is_password_secure,
+)
+from .easy_web import (
+    get_page_content, is_page_up,
+)
+from .easy_strings import (
+    is_palindrome, remove_extra_spaces, to_kebab_case, to_snake_case,
+)

py_simple_wrap-0.1.0/py_simple_package/src/py_simple/easy_converter.py

@@ -0,0 +1,302 @@
+"""
+easy_converter is built to simplify different types of conversions
+"""
+
+from datetime import timedelta
+
+
+def seconds_to_hh_mm_ss(seconds: int) -> str:
+    """
+    Returns seconds in HH:MM:SS format.
+
+    Arguments:
+        seconds (int) -- number of seconds to convert
+
+    Example:
+        seconds_to_hh_mm_ss(90)
+        (00:01:30)
+    """
+    return str(timedelta(seconds=seconds))
+
+
+def hh_mm_ss_to_seconds(hours: int = 0, minutes: int = 0, seconds: int = 0) \
+        -> int:
+    """
+        Returns hours, minutes and seconds converted to seconds.
+
+        Arguments:
+            hours (int) -- number of hours to convert. Defaults to 0.
+            minutes (int) -- number of minutes to convert. Defaults to 0.
+            seconds (int) -- number of seconds to convert. Defaults to 0.
+
+        Example:
+            hh_mm_ss_to_seconds(1, 1, 1)
+            (3661)
+        """
+    total_seconds = seconds
+    total_seconds += hours * 3600
+    total_seconds += minutes * 60
+    return total_seconds
+
+
+def km_to_mile(km: float) -> float:
+    """
+    Converts kilometers to miles. Returns miles as a float.
+
+    Arguments:
+        km (float) -- kilometers
+
+    Example:
+        km_to_mile(100)
+        (62.13)
+    """
+    return float(f"{km * 0.621371:.2f}")
+
+
+def miles_to_km(miles: float) -> float:
+    """
+        Converts miles to kilometers. Returns kilometers as a float.
+
+        Arguments:
+            miles (float) -- miles
+
+        Example:
+            miles_to_km(100)
+            (160.93)
+    """
+    return float(f"{miles * 1.60934:.2f}")
+
+
+def fluid_oz_to_ml(oz: float, standard = 'us') -> float | None:
+    """
+    Converts fluid ounces to milliliters. Returns milliliters as a float.
+
+    :param:
+        oz (float) -- fluid ounces
+        standard -- us or uk
+
+    Example:
+        standard = 'us'
+        fluid_oz_to_ml(1)
+        (29.6)
+        standard = 'uk'
+        fluid_oz_to_ml(1)
+        (28.4)
+
+    """
+    match standard:
+        case "uk":
+            return float(f"{oz * 28.4:.2f}")
+        case "us":
+            return float(f"{oz * 29.6:.2f}")
+    return None
+
+
+def ml_to_fluid_oz(milliliters: float, standard = 'us') -> float | None:
+    """
+        Converts milliliters to fluid ounces. Returns fluid ounces as a
+        float.
+
+        :param:
+            milliliters (float) -- milliliters
+            standard -- us or uk
+
+        Example:
+            standard = 'us'
+            ml_to_fluid_oz(1)
+            (0.03)
+            standard = 'uk'
+            ml_to_fluid_oz(1)
+            (0.04)
+
+        """
+    match standard:
+        case "uk":
+            return float(f"{milliliters * 0.035:.2f}")
+        case "us":
+            return float(f"{milliliters * 0.034:.2f}")
+    return None
+
+
+def celsius_to_fahrenheit(temp_celsius: float) -> float:
+    """
+        Converts temperature in Celsius to temperature in Fahrenheit.
+        Returns degrees Fahrenheit as float.
+
+        :param:
+            temp_celsius (float) -- temperature in Celsius
+
+        Example:
+            celsius_to_fahrenheit(40)
+            (104.0)
+
+        """
+    return float(f"{((temp_celsius * 9 / 5) + 32):.2f}")
+
+
+def fahrenheit_to_celsius(temp_fahrenheit: float) -> float:
+    """
+        Converts temperature in Fahrenheit to temperature in Celsius.
+        Returns degrees Celsius as float.
+
+        :param:
+            temp_fahrenheit (float) -- temperature in Fahrenheit
+
+        Example:
+            fahrenheit_to_celsius(104)
+            (40.0)
+        """
+    return float(f"{((temp_fahrenheit - 32) * 5 / 9):.2f}")
+
+
+def kg_to_lb(kg: float) -> float:
+    """
+        Converts kilograms to pounds.
+        Returns pounds as float.
+
+        :param:
+            kg (float) -- kilograms
+
+        Example:
+            kg_to_lb(50)
+            (110.23)
+        """
+    return float(f"{kg * 2.20462:.2f}")
+
+
+def lb_to_kg(lb: float) -> float:
+    """
+        Converts pounds to kilograms.
+        Returns kilograms as float.
+
+        :param:
+            lb (float) -- pounds
+
+        Example:
+            lb_to_kg(110.23)
+            (50.0)
+        """
+    return float(f"{(lb * 0.453592):.2f}")
+
+
+def meters_to_feet(meters: float) -> float:
+    """
+        Converts meters to feet.
+        Returns feet as float.
+
+        Arguments:
+            meters (float) -- meters to be converted to feet.
+
+        Example:
+            meters_to_feet(100)
+            (328.08)
+        """
+    return float(f"{(meters * 3.28084):.2f}")
+
+
+def feet_to_meters(feet: float) -> float:
+    """
+        Converts feet to meters.
+        Returns meters as float.
+
+        Arguments:
+            feet (float) -- feet to be converted to meters.
+
+        Example:
+            feet_to_meters(328.08)
+            (100.0)
+        """
+    return float(f"{(feet * 0.3048):.2f}")
+
+
+def cm_to_inches(cm: float) -> float:
+    """
+        Converts centimeters to inches.
+        Returns inches as float.
+
+        Arguments:
+            cm (float) -- centimeters to be converted to inches.
+
+        Example:
+            cm_to_inches(100)
+            (39.37)
+        """
+    return float(f"{(cm / 2.54):.2f}")
+
+
+def inches_to_cm(inches: float) -> float:
+    """
+        Converts centimeters to inches.
+        Returns inches as float.
+
+        Arguments:
+            inches (float) -- inches to be converted to centimeters.
+
+        Example:
+            inches_to_cm(39.37)
+            (100.0)
+        """
+    return float(f"{(inches * 2.54):.2f}")
+
+
+def sq_meters_to_sq_feet(sq_meters: float) -> float:
+    """
+        Converts square meters to square feet.
+        Returns square feet as float.
+
+        Arguments:
+            sq_meters (float) -- square meters to be converted to
+            square feet.
+
+        Example:
+            sq_meters_to_sq_feet(10)
+            (107.64)
+        """
+    return float(f"{(sq_meters * 10.7639):.2f}")
+
+
+def sq_feet_to_sq_meters(sq_feet: float) -> float:
+    """
+        Converts square feet to square meters.
+        Returns square meters as float.
+
+        Arguments:
+            sq_feet (float) -- square feet to be converted to
+            square meters.
+
+        Example:
+            sq_feet_to_sq_meters(107.64)
+            (10.0)
+        """
+    return float(f"{(sq_feet * 0.092903):.2f}")
+
+def mph_to_kph(mph):
+    """
+        Converts mph speed to kph speed.
+        Returns kph speed as float.
+
+        Arguments:
+            mph (float) -- mph speed to be converted to
+            kph speed.
+
+        Example:
+            mph_to_kph(0.621371)
+            (1.0)
+        """
+    return float(f"{(mph * 1.60934):.2f}")
+
+
+def kph_to_mph(kph):
+    """
+        Converts kph speed to mph speed.
+        Returns mph speed as float.
+
+        Arguments:
+            kph (float) -- kph speed to be converted to
+            kph speed.
+
+        Example:
+            kph_to_mph(1.60934)
+            (1.0)
+        """
+    return float(f"{(kph * 0.621371):.2f}")