proxar 0.1.2__tar.gz → 0.2.0__tar.gz

{proxar-0.1.2 → proxar-0.2.0}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to Xify will be documented in this file.
 
+## v0.2.0 (2025-06-29)
+
+### Features
+
+- add storage handler with platformdirs integration
+
 ## v0.1.2 (2025-06-29)
 
 ### Bug Fixes

{proxar-0.1.2 → proxar-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxar
-Version: 0.1.2
+Version: 0.2.0
 Summary: A Python client for fetching public proxies from multiple sources.
 Project-URL: Homepage, https://github.com/filming/proxar
 Project-URL: Repository, https://github.com/filming/proxar
@@ -39,6 +39,8 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.12.13
+Requires-Dist: platformdirs>=4.3.8
 Description-Content-Type: text/markdown
 
 # Proxar

{proxar-0.1.2 → proxar-0.2.0}/pyproject.toml

@@ -4,11 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "proxar"
-version = "0.1.2"
+version = "0.2.0"
 description = "A Python client for fetching public proxies from multiple sources."
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = []
+dependencies = [
+    "aiohttp>=3.12.13",
+    "platformdirs>=4.3.8",
+]
 license = {file = "LICENSE"}
 authors = [
     {name = "Filming"}

proxar-0.2.0/src/proxar/__init__.py

@@ -0,0 +1,26 @@
+import logging
+from pathlib import Path
+
+from .handlers.storage import StorageHandler
+
+logger = logging.getLogger(__name__)
+logger.addHandler(logging.NullHandler())
+
+
+class Proxar:
+    """A Python client for fetching public proxies.
+
+    This library provides an asynchronous, easy-to-use interface to
+    retrieve fresh proxies, handling the complexities of web scraping
+    and source aggregation.
+    """
+
+    def __init__(self, storage_dir: str | Path | None = None):
+        """Initialize the Proxar instance.
+
+        Args:
+            storage_dir (str | Path | None): The path to store proxy
+                files. Defaults to None.
+        """
+        self.storage_manager = StorageHandler(storage_dir)
+        logger.info("Proxar has been initialized.")

proxar-0.2.0/src/proxar/handlers/storage.py

@@ -0,0 +1,28 @@
+import logging
+from pathlib import Path
+
+import platformdirs
+
+logger = logging.getLogger(__name__)
+
+
+class StorageHandler:
+    """Handle storage operations."""
+
+    def __init__(self, storage_dir: str | Path | None):
+        """Initialize the storage handler instance.
+
+        Args:
+            storage_dir (str | Path | None): The path to store proxy
+                files. If None, a default directory is used based on
+                the operating system.
+        """
+        # Set storage path and ensure its existence
+        if storage_dir is None:
+            self.storage_path = Path(platformdirs.user_data_dir("proxar"))
+        else:
+            self.storage_path = Path(storage_dir)
+
+        self.storage_path.mkdir(parents=True, exist_ok=True)
+
+        logger.debug("Storage handler has been initialized.")