data-sourcerer 0.1.1__tar.gz → 0.2.1__tar.gz

{data_sourcerer-0.1.1 → data_sourcerer-0.2.1}/PKG-INFO

@@ -1,29 +1,41 @@
 Metadata-Version: 2.4
 Name: data-sourcerer
-Version: 0.1.1
+Version: 0.2.1
 Summary: Sourcerer is a terminal cloud storage navigator.
 Author-email: Bohdana Kuzmenko <bohdana.kuzmenko.dev@gmail.com>
 License: MIT
-Keywords: cloud,s3,gcp,cli,termanal,storage,textual,ui
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
 License-File: LICENSE
+Keywords: cli,cloud,gcp,s3,storage,terminal,textual,ui
+Requires-Python: >=3.9
+Requires-Dist: azure-identity<2.0.0,>=1.22.0
+Requires-Dist: azure-mgmt-storage<23.0.0,>=22.2.0
+Requires-Dist: azure-storage-blob<13.0.0,>=12.25.1
 Requires-Dist: boto3<2.0.0,>=1.26.0
 Requires-Dist: cryptography<45.0.0,>=44.0.2
 Requires-Dist: dependency-injector<5.0.0,>=4.43.0
 Requires-Dist: google-cloud-storage<4.0.0,>=3.1.0
 Requires-Dist: humanize<5.0.0,>=4.12.1
-Requires-Dist: sqlalchemy<3.0.0,>=2.0.38
+Requires-Dist: pyopenssl>=22.1.0; sys_platform == 'linux'
 Requires-Dist: sqlalchemy-utils<1.0.0,>=0.41.2
+Requires-Dist: sqlalchemy<3.0.0,>=2.0.38
 Requires-Dist: textual[syntax]<4.0.0,>=2.0.0
-Requires-Dist: pyOpenSSL>=22.1.0; sys_platform == "linux"
-Dynamic: license-file
+Provides-Extra: dev
+Requires-Dist: bandit>=1.8.3; extra == 'dev'
+Requires-Dist: black>=25.1.0; extra == 'dev'
+Requires-Dist: coverage>=7.8.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.6.12; extra == 'dev'
+Requires-Dist: pre-commit>=4.2.0; extra == 'dev'
+Requires-Dist: pylint>=3.3.6; extra == 'dev'
+Requires-Dist: pyright>=1.1.400; extra == 'dev'
+Requires-Dist: ruff>=0.11.7; extra == 'dev'
+Requires-Dist: textual-dev>=1.7.0; extra == 'dev'
+Description-Content-Type: text/markdown
 
 # 🧙‍♂️ Sourcerer
 
 **Sourcerer** is a CLI-based cloud storage explorer that provides a unified interface for developers and DevOps 
 engineers to view and manage files across multiple cloud providers like 
-**GCP**, **AWS S3**, and **S3-compatible services**.
+**GCP Storage**, **Azure Storage**, **AWS S3**, and **S3-compatible services**.
 
 > Your terminal. Your storages. Your control.
 
@@ -31,7 +43,7 @@ engineers to view and manage files across multiple cloud providers like
 
 ## ✨ Features
 
-- 🔍 Unified file browser for GCP, AWS S3, and S3-compatible services  
+- 🔍 Unified file browser for GCP Storage, Azure Storage, AWS S3, and S3-compatible services  
 - 🧭 Terminal UI (TUI) built with [Textual](https://github.com/Textualize/textual)  
 - 🗂️ Explore buckets and objects seamlessly  
 - 🔄 Upload, download, and delete files  
@@ -42,7 +54,14 @@ engineers to view and manage files across multiple cloud providers like
 ## 🪄 Installation
 
 ```bash
-pip install sourcerer
+pip install data-sourcerer
+```
+--
+
+## 🪄 Run
+
+```bash
+sourcerer
 ```
 
 

{data_sourcerer-0.1.1 → data_sourcerer-0.2.1}/README.md

@@ -2,7 +2,7 @@
 
 **Sourcerer** is a CLI-based cloud storage explorer that provides a unified interface for developers and DevOps 
 engineers to view and manage files across multiple cloud providers like 
-**GCP**, **AWS S3**, and **S3-compatible services**.
+**GCP Storage**, **Azure Storage**, **AWS S3**, and **S3-compatible services**.
 
 > Your terminal. Your storages. Your control.
 
@@ -10,7 +10,7 @@ engineers to view and manage files across multiple cloud providers like
 
 ## ✨ Features
 
-- 🔍 Unified file browser for GCP, AWS S3, and S3-compatible services  
+- 🔍 Unified file browser for GCP Storage, Azure Storage, AWS S3, and S3-compatible services  
 - 🧭 Terminal UI (TUI) built with [Textual](https://github.com/Textualize/textual)  
 - 🗂️ Explore buckets and objects seamlessly  
 - 🔄 Upload, download, and delete files  
@@ -21,7 +21,14 @@ engineers to view and manage files across multiple cloud providers like
 ## 🪄 Installation
 
 ```bash
-pip install sourcerer
+pip install data-sourcerer
+```
+--
+
+## 🪄 Run
+
+```bash
+sourcerer
 ```
 
 

data_sourcerer-0.2.1/pyproject.toml

@@ -0,0 +1,102 @@
+[project]
+
+name = "data-sourcerer"
+version = "0.2.1"
+description = "Sourcerer is a terminal cloud storage navigator."
+requires-python = ">=3.9"
+
+keywords = ["cloud", "s3", "gcp", "cli", "terminal", "storage", "textual", "ui"]
+license = {text = "MIT"}
+
+authors = [
+  {name = "Bohdana Kuzmenko", email = "bohdana.kuzmenko.dev@gmail.com"},
+]
+
+readme = {file = "README.md", content-type = "text/markdown"}
+
+dependencies = [
+    "boto3>=1.26.0,<2.0.0",
+    "cryptography>=44.0.2,<45.0.0",
+    "dependency-injector>=4.43.0,<5.0.0",
+    "google-cloud-storage>=3.1.0,<4.0.0",
+    "humanize>=4.12.1,<5.0.0",
+    "sqlalchemy>=2.0.38,<3.0.0",
+    "sqlalchemy-utils>=0.41.2,<1.0.0",
+    "textual[syntax]>=2.0.0,<4.0.0",
+    "pyOpenSSL>=22.1.0; sys_platform == 'linux'",
+    "azure-storage-blob>=12.25.1,<13.0.0",
+    "azure-identity>=1.22.0,<2.0.0",
+    "azure-mgmt-storage>=22.2.0,<23.0.0",
+]
+
+[project.scripts]
+sourcerer = "sourcerer.presentation.app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "bandit>=1.8.3",
+    "black>=25.1.0",
+    "coverage>=7.8.0",
+    "mkdocs-material>=9.6.12",
+    "pre-commit>=4.2.0",
+    "pylint>=3.3.6",
+    "pyright>=1.1.400",
+    "ruff>=0.11.7",
+    "textual-dev>=1.7.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "bandit>=1.8.3",
+    "black>=25.1.0",
+    "coverage>=7.8.0",
+    "mkdocs-material>=9.6.12",
+    "pre-commit>=4.2.0",
+    "pylint>=3.3.6",
+    "pyright>=1.1.400",
+    "ruff>=0.11.7",
+    "textual-dev>=1.7.0",
+]
+
+[tool.coverage.run]
+branch = true
+source = [
+    "src/sourcerer/infrastructure",
+]
+
+[tool.coverage.report]
+fail_under = 75
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+# Enable these rules
+select = [
+  "E",    # pycodestyle
+  "F",    # pyflakes
+  "I",    # isort
+  "N",    # pep8-naming
+  "UP",   # pyupgrade
+  "C90",  # mccabe (complexity)
+  "B",    # flake8-bugbear
+  "SIM",  # flake8-simplify
+]
+
+# Allow autofix for these rule sets
+fixable = ["ALL"]
+
+# Disallow autofix for these
+unfixable = ["F401"]  # unused imports - maybe you want to catch it manually
+
+
+[tool.ruff.mccabe]
+max-complexity = 10
+
+[tool.hatch.build]
+include = ["src"]
+sources = ["src"]

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/__init__.py

@@ -12,4 +12,4 @@ The application is structured using a clean architecture approach with:
 - Presentation layer: User interface components
 """
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/access_credentials/entities.py

@@ -9,6 +9,7 @@ from dataclasses import dataclass
 from datetime import datetime
 
 import boto3
+from azure.identity import ClientSecretCredential
 
 
 @dataclass
@@ -51,3 +52,19 @@ class Boto3Credentials:
     session: boto3.Session
     endpoint_url: str | None = None
     signature_version: str | None = None
+
+
+@dataclass
+class AzureCredentials:
+    """
+    Represents Azure credentials.
+
+    Attributes:
+        credentials (ClientSecretCredential): Azure identity credential object for authentication.
+        subscription_id (str): The Azure subscription ID.
+        cloud_suffix (str): The Azure cloud storage suffix (e.g., blob.core.windows.net).
+    """
+
+    credentials: ClientSecretCredential
+    subscription_id: str
+    cloud_suffix: str

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/access_credentials/exceptions.py

@@ -6,7 +6,7 @@ access credentials operations.
 """
 
 
-class BaseAccessCredentialsException(Exception):
+class BaseAccessCredentialsError(Exception):
     """
     Base exception class for access credentials-related errors.
 

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/access_credentials/repositories.py

@@ -5,7 +5,7 @@ This module defines the abstract base class for credentials repositories,
 providing a common interface for different storage implementations.
 """
 
-from abc import abstractmethod, ABCMeta
+from abc import ABCMeta, abstractmethod
 
 from sourcerer.domain.access_credentials.entities import Credentials
 

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/access_credentials/services.py

@@ -8,7 +8,6 @@ authentication methods.
 
 from abc import abstractmethod
 from dataclasses import dataclass
-from typing import List
 
 from sourcerer.domain.access_credentials.repositories import BaseCredentialsRepository
 
@@ -82,10 +81,23 @@ class BaseAccessCredentialsService:
 
     @classmethod
     @abstractmethod
-    def auth_fields(cls) -> List[AuthField]:
+    def auth_fields(cls) -> list[AuthField]:
         """
         Get list of authentication fields.
 
         Returns:
             List[AuthField]: List of authentication field definitions
         """
+
+    @classmethod
+    def validate_auth_fields_values(cls, auth_fields: dict) -> None:
+        """
+        Validate authentication fields.
+
+        Args:
+            auth_fields (dict): Dictionary containing authentication field,
+                                where keys are field names and values are field values
+
+        Raises:
+            MissingAuthFieldsError: If any required authentication fields are missing
+        """

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/file_system/exceptions.py

@@ -6,7 +6,7 @@ file system operations.
 """
 
 
-class BaseFileSystemException(Exception):
+class BaseFileSystemError(Exception):
     """
     Base exception class for filesystem-related errors.
 

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/file_system/services.py

@@ -37,7 +37,7 @@ class BaseFileSystemService(metaclass=abc.ABCMeta):
             str: The processed data extracted from the file.
 
         Raises:
-            ReadFileException: An error occurred during the file read operation.
+            ReadFileError: An error occurred during the file read operation.
         """
         raise NotImplementedError
 
@@ -59,6 +59,6 @@ class BaseFileSystemService(metaclass=abc.ABCMeta):
                 - directories (list[Path]): Sorted list of directory paths
 
         Raises:
-            ListDirException: If the path is invalid, directory doesn't exist, or path is not a directory.
+            ListDirError: If the path is invalid, directory doesn't exist, or path is not a directory.
         """
         raise NotImplementedError

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/shared/entities.py

@@ -16,3 +16,4 @@ class StorageProvider:
 
     S3 = "S3"
     GoogleCloudStorage = "Google Cloud Storage"
+    AzureStorage = "Azure Storage"

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/storage_provider/entities.py

@@ -7,7 +7,6 @@ such as storage containers, files, folders, and permissions.
 
 from dataclasses import dataclass
 from datetime import datetime
-from typing import List
 
 
 @dataclass
@@ -37,7 +36,7 @@ class StoragePermissions:
     """
 
     user: str
-    permissions: List[str]
+    permissions: list[str]
 
 
 @dataclass
@@ -82,5 +81,5 @@ class StorageContent:
         folders (List[Folder]): List of folders in the location
     """
 
-    files: List[File]
-    folders: List[Folder]
+    files: list[File]
+    folders: list[Folder]

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/storage_provider/exceptions.py

@@ -6,7 +6,7 @@ cloud storage provider operations.
 """
 
 
-class BaseStorageProviderException(Exception):
+class BaseStorageProviderError(Exception):
     """
     Base exception class for cloud storage provider-related errors.
 

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/domain/storage_provider/services.py

@@ -6,13 +6,13 @@ providing a common interface for cloud storage operations.
 """
 
 from abc import ABC, abstractmethod
+from collections.abc import Callable
 from pathlib import Path
-from typing import List, Callable
 
 from sourcerer.domain.storage_provider.entities import (
-    StoragePermissions,
-    StorageContent,
     Storage,
+    StorageContent,
+    StoragePermissions,
 )
 
 
@@ -27,7 +27,7 @@ class BaseStorageProviderService(ABC):
     """
 
     @abstractmethod
-    def list_storages(self) -> List[Storage]:
+    def list_storages(self) -> list[Storage]:
         """
         Return a list of available storages.
 
@@ -36,7 +36,7 @@ class BaseStorageProviderService(ABC):
         """
 
     @abstractmethod
-    def get_storage_permissions(self, storage: str) -> List[StoragePermissions]:
+    def get_storage_permissions(self, storage: str) -> list[StoragePermissions]:
         """
         Return the permissions for the specified storage.
 
@@ -75,7 +75,6 @@ class BaseStorageProviderService(ABC):
         Returns:
             bytes: The content of the storage item
         """
-        pass
 
     @abstractmethod
     def delete_storage_item(self, storage: str, key: str) -> None:
@@ -89,13 +88,18 @@ class BaseStorageProviderService(ABC):
 
     @abstractmethod
     def upload_storage_item(
-        self, storage: str, source_path: Path, dest_path: str | None = None
+        self,
+        storage: str,
+        storage_path: str,
+        source_path: Path,
+        dest_path: str | None = None,
     ) -> None:
         """
         Upload a file to the specified storage path.
 
         Args:
             storage (str): The storage identifier
+            storage_path (str): The path within the storage to upload
             source_path (Path): Local file path to upload
             dest_path (str, optional): Destination path in storage. Defaults to None.
         """
@@ -117,7 +121,7 @@ class BaseStorageProviderService(ABC):
         """
 
     @abstractmethod
-    def get_file_size(self, storage: str, key: str) -> dict:
+    def get_file_size(self, storage: str, key: str) -> int:
         """
         Get metadata for a storage item without downloading content.
 
@@ -126,5 +130,5 @@ class BaseStorageProviderService(ABC):
             key (str): The key/path of the item
 
         Returns:
-            dict: Metadata for the specified item
+            int: Size of the storage item in bytes
         """

data_sourcerer-0.2.1/sourcerer/infrastructure/access_credentials/exceptions.py

@@ -0,0 +1,29 @@
+from sourcerer.domain.access_credentials.exceptions import (
+    BaseAccessCredentialsError,
+)
+
+
+class CredentialsAuthError(BaseAccessCredentialsError):
+    """
+    Exception raised when there is an error parsing access credentials.
+
+    This exception is raised when the access credentials cannot be
+    authenticated or parsed correctly. It indicates that the provided
+    credentials are invalid or not in the expected format.
+    This can occur during operations such as login, token validation,
+    or any other authentication process that relies on the provided
+    credentials.
+    """
+
+
+class MissingAuthFieldsError(CredentialsAuthError):
+    """
+    Exception raised when there are missing authentication fields.
+
+    This exception is raised when the required authentication fields
+    are missing from the provided credentials. It indicates that the
+    authentication process cannot proceed without the necessary
+    credentials. This can occur during operations such as login,
+    token validation, or any other authentication process that relies
+    on the provided credentials.
+    """

{data_sourcerer-0.1.1/src → data_sourcerer-0.2.1}/sourcerer/infrastructure/access_credentials/registry.py

@@ -7,7 +7,6 @@ access credential services for various cloud providers.
 
 import functools
 from dataclasses import dataclass
-from typing import Type, Dict
 
 from sourcerer.domain.access_credentials.services import BaseAccessCredentialsService
 from sourcerer.infrastructure.utils import Singleton
@@ -38,19 +37,19 @@ class AccessCredentialsRegistry(metaclass=Singleton):
     def __init__(self, *args, **kwargs):
         """Initialize the registry with an empty dictionary."""
         super().__init__(*args, **kwargs)
-        self._items_: Dict[str, Dict[str, type]] = {}  # type: ignore
+        self._items_: dict[str, dict[str, type]] = {}  # type: ignore
 
     def register(
         self,
         access_credentials_method: AccessCredentialsMethod,
-        cls: Type[BaseAccessCredentialsService],
+        cls: type[BaseAccessCredentialsService],
     ):
         """
         Register a credential service implementation.
 
         Args:
             access_credentials_method (AccessCredentialsMethod): The method descriptor
-            cls (Type[BaseAccessCredentialsService]): The service class to register
+            cls (type[BaseAccessCredentialsService]): The service class to register
         """
         if access_credentials_method.provider not in self._items_:
             self._items_[access_credentials_method.provider] = {}