good-utilities 0.1.37__tar.gz

good_utilities-0.1.37/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.3
+Name: good-utilities
+Version: 0.1.37
+Summary: Collection of utility functions
+Author: SmartCookie
+Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Description-Content-Type: text/markdown
+
+
+# Good Utilities
+
+---
+
+## 📦 Overview
+
+**Good Utilities** is a powerful and flexible Python package that provides a comprehensive collection of utility functions to simplify and speed up your development workflow. Whether you're working with files, text, images, or data, this package offers essential tools designed for efficiency and ease of use.
+
+Say goodbye to repetitive coding tasks and focus on building great applications!
+
+---
+
+## 🚀 Features
+
+- **Comprehensive Utility Modules:** Organized modules for file handling, text processing, image manipulation, networking, and more.
+- **Clean and Readable Code:** Designed with simplicity and readability in mind, making it easy to integrate into any project.
+- **Type Hints Included:** All functions include type hints for better development experience and fewer bugs.
+- **Lightweight and Fast:** Minimal dependencies ensure quick installation and execution.
+
+---
+
+## 🛠 Installation
+
+Install the package using **Poetry**:
+
+```bash
+poetry add good-utilities
+```
+
+Or via **pip**:
+
+```bash
+pip install good-utilities
+```
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Feel free to open issues or submit pull requests to improve **Good Utilities**.
+
+---
+
+## 📜 License
+
+This project is licensed under the MIT License.
+
+---
+
+## 💡 Future Plans
+
+- Expand utility modules with more advanced features.
+- Optimize performance for large-scale applications.
+- Provide detailed documentation and examples.
+
+---
+
+## 🔗 Connect
+
+For feedback or suggestions, feel free to reach out!
+

good_utilities-0.1.37/README.md

@@ -0,0 +1,61 @@
+
+# Good Utilities
+
+---
+
+## 📦 Overview
+
+**Good Utilities** is a powerful and flexible Python package that provides a comprehensive collection of utility functions to simplify and speed up your development workflow. Whether you're working with files, text, images, or data, this package offers essential tools designed for efficiency and ease of use.
+
+Say goodbye to repetitive coding tasks and focus on building great applications!
+
+---
+
+## 🚀 Features
+
+- **Comprehensive Utility Modules:** Organized modules for file handling, text processing, image manipulation, networking, and more.
+- **Clean and Readable Code:** Designed with simplicity and readability in mind, making it easy to integrate into any project.
+- **Type Hints Included:** All functions include type hints for better development experience and fewer bugs.
+- **Lightweight and Fast:** Minimal dependencies ensure quick installation and execution.
+
+---
+
+## 🛠 Installation
+
+Install the package using **Poetry**:
+
+```bash
+poetry add good-utilities
+```
+
+Or via **pip**:
+
+```bash
+pip install good-utilities
+```
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Feel free to open issues or submit pull requests to improve **Good Utilities**.
+
+---
+
+## 📜 License
+
+This project is licensed under the MIT License.
+
+---
+
+## 💡 Future Plans
+
+- Expand utility modules with more advanced features.
+- Optimize performance for large-scale applications.
+- Provide detailed documentation and examples.
+
+---
+
+## 🔗 Connect
+
+For feedback or suggestions, feel free to reach out!

good_utilities-0.1.37/good_utilities/date_utils.py

@@ -0,0 +1,21 @@
+# Date utility functions
+
+import datetime
+
+def get_days_between_dates(start_date: str, end_date: str) -> int:
+    """
+    Calculate the number of days between two dates.
+    
+    Parameters:
+        start_date (str): The start date in 'YYYY-MM-DD' format.
+        end_date (str): The end date in 'YYYY-MM-DD' format.
+    
+    Returns:
+        int: The number of days between the two dates. Returns a negative number if the start date is after the end date.
+
+    Imports:
+        import datetime
+    """
+    start = datetime.datetime.strptime(start_date, '%Y-%m-%d')
+    end = datetime.datetime.strptime(end_date, '%Y-%m-%d')
+    return (end - start).days

good_utilities-0.1.37/good_utilities/name_utils.py

@@ -0,0 +1,22 @@
+# Name utility functions
+
+import datetime
+import uuid
+
+def generate_unique_name(prefix: str) -> str:
+    """
+    Generate a unique name based on UUID and current timestamp.
+    
+    Parameters:
+        prefix (str): A prefix to prepend to the unique name.
+    
+    Returns:
+        str: A unique name combining the prefix, UUID, and current timestamp.
+
+    Imports:
+        import uuid
+        import datetime
+    """
+    unique_id = uuid.uuid4()
+    timestamp = datetime.datetime.now().strftime('%Y%m%d%H%M%S')
+    return f'{prefix}_{unique_id}_{timestamp}'

good_utilities-0.1.37/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "good-utilities"
+version = "0.1.37"
+description = "Collection of utility functions"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = []
+[[project.authors]]
+name = "SmartCookie"
+
+[build-system]
+requires = [ "poetry-core>=2.0.0,<3.0.0",]
+build-backend = "poetry.core.masonry.api"