wardy-utils 0.1.0__tar.gz

wardy_utils-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+*/package.zip
+*/packages/
+*/requirements.txt
+__pycache__/
+output.html
+.vscode/settings.json

wardy_utils-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13.3

wardy_utils-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: wardy-utils
+Version: 0.1.0
+Summary: General Utilities
+Author-email: Wardy <wardy3+gitlab@gmail.com>
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.13.3
+Requires-Dist: hishel>=0.1.2
+Requires-Dist: httpx>=0.28.1
+Description-Content-Type: text/markdown
+
+# Wardy Utils
+
+**Wardy Utils** is a collection of general-purpose utilities designed to simplify and enhance your Python scripting experience. This library provides reusable components that can be integrated into your projects to save time and effort.
+
+## Features
+
+### HTTP Utilities
+
+- **`http`**: A high-level HTTP client built on top of `httpx` and `hishel`, setting some caching and timeout comment settings.
+
+## Installation
+
+To install Wardy Utils, use pip:
+
+```bash
+pip install wardy-utils
+```
+
+## Usage
+
+### HTTP Client Example
+
+```python
+from wardy_utils.web import CachedClient
+
+client = CachedClient()
+response = client.get("https://example.com")
+print(response.text)
+```
+
+## Requirements
+
+- Python 3.13.3 or higher
+
+## Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests to improve the library.
+
+## License
+
+This project is licensed under the MIT License.
+
+## Author
+
+Created by **Wardy**  
+Email: [wardy3+gitlab@gmail.com](mailto:wardy3+gitlab@gmail.com)

wardy_utils-0.1.0/README.md

@@ -0,0 +1,46 @@
+# Wardy Utils
+
+**Wardy Utils** is a collection of general-purpose utilities designed to simplify and enhance your Python scripting experience. This library provides reusable components that can be integrated into your projects to save time and effort.
+
+## Features
+
+### HTTP Utilities
+
+- **`http`**: A high-level HTTP client built on top of `httpx` and `hishel`, setting some caching and timeout comment settings.
+
+## Installation
+
+To install Wardy Utils, use pip:
+
+```bash
+pip install wardy-utils
+```
+
+## Usage
+
+### HTTP Client Example
+
+```python
+from wardy_utils.web import CachedClient
+
+client = CachedClient()
+response = client.get("https://example.com")
+print(response.text)
+```
+
+## Requirements
+
+- Python 3.13.3 or higher
+
+## Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests to improve the library.
+
+## License
+
+This project is licensed under the MIT License.
+
+## Author
+
+Created by **Wardy**  
+Email: [wardy3+gitlab@gmail.com](mailto:wardy3+gitlab@gmail.com)

wardy_utils-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+authors = [{ name = "Wardy", email = "wardy3+gitlab@gmail.com" }]
+description = "General Utilities"
+name = "wardy-utils"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.13.3"
+version = "0.1.0"
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = ["hishel>=0.1.2", "httpx>=0.28.1"]
+
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[[tool.uv.index]]
+explicit = true
+name = "private-idaho"
+
+publish-url = "https://gitlab.com/api/v4/projects/68880898/packages/pypi"
+url = "https://gitlab.com/api/v4/projects/68880898/packages/pypi/simple"

wardy_utils-0.1.0/src/wardy_utils/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from wardy-utils!"

wardy_utils-0.1.0/src/wardy_utils/web.py

@@ -0,0 +1,38 @@
+"""General internet helpers."""
+
+from __future__ import annotations
+
+import logging
+from datetime import timedelta
+from typing import Final
+
+import hishel
+
+logging.getLogger("hishel.controller").setLevel(logging.DEBUG)
+
+
+class CachedClient(hishel.CacheClient):
+    """Handle httpx client and hishel caching."""
+
+    def __init__(
+        self, *, force_cache: bool = False, cache_minutes: int = 30, timeout_seconds: int = 20
+    ) -> None:
+        """Initialize the client.
+
+        Args:
+            force_cache (bool): Force cache to be used on all pages.
+            cache_minutes (int): Number of minutes to cache.
+            timeout_seconds (int): Number of seconds to timeout.
+        """
+        cache: Final = timedelta(minutes=cache_minutes).total_seconds()
+        timeout: Final = timedelta(seconds=timeout_seconds).total_seconds()
+
+        self.storage = hishel.FileStorage(ttl=cache)
+        self.controller = hishel.Controller(force_cache=force_cache)
+
+        super().__init__(
+            follow_redirects=True,
+            storage=self.storage,
+            controller=self.controller,
+            timeout=timeout,
+        )