data-sourcerer 0.1.0__py3-none-any.whl

data_sourcerer-0.1.0.dist-info/METADATA

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: data-sourcerer
+Version: 0.1.0
+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
+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: sqlalchemy-utils<1.0.0,>=0.41.2
+Requires-Dist: textual[syntax]<4.0.0,>=2.0.0
+Dynamic: license-file
+
+# 🧙‍♂️ 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**.
+
+> Your terminal. Your storages. Your control.
+
+---
+
+## ✨ Features
+
+- 🔍 Unified file browser for GCP, 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  
+- 🔐 Secure credential management via local **SQLite database**  
+
+---
+
+## 🪄 Installation
+
+```bash
+pip install sourcerer
+```
+
+
+## 🔮 See in action
+
+![creds_registration.gif](https://github.com/the-impact-craft/sourcerer/blob/main/media/creds_registration.gif?raw=true)
+
+![keys_operations.gif](https://github.com/the-impact-craft/sourcerer/blob/main/media/keys_operations.gif?raw=true)

data_sourcerer-0.1.0.dist-info/RECORD

@@ -0,0 +1,95 @@
+data_sourcerer-0.1.0.dist-info/licenses/LICENSE,sha256=HjZ7RAG3i6izxvitGfY4feHfvW5F8DPj5eF0YBSf2rI,1073
+sourcerer/__init__.py,sha256=h7QH2R5-hJCjx1Yn7krJm8SThocxrzReoc5j7Pae-LI,585
+sourcerer/settings.py,sha256=GebQXsEsiiFKBWsmRO5RToCYzTKpr8hOYipBP5WqzG4,1319
+sourcerer/utils.py,sha256=udr1T2hObYPEchsVyBQvzPuEJcQptLfwF4BnjvvOnvE,841
+sourcerer/domain/__init__.py,sha256=rV21d-dD-e0q4EQ2LfWDSDLlrUOjnHnWBtWPujoue0o,556
+sourcerer/domain/access_credentials/__init__.py,sha256=pFAwnr74uy09e7kubYsuaqzkVPkTA66dwjKzpIGQkAY,217
+sourcerer/domain/access_credentials/entities.py,sha256=0jLhLGjst42TbhnWYVL9wnN8K1KmL8H_vhG2DavaQd0,1541
+sourcerer/domain/access_credentials/exceptions.py,sha256=g7m7zrgEKdtNNynn049vEc6W_V-8yhS4hLOAOaK_NeM,550
+sourcerer/domain/access_credentials/repositories.py,sha256=FDbpbQZd_I0FHUuySYbBlBByvVci1fNIJvN_P63sN0g,2408
+sourcerer/domain/access_credentials/services.py,sha256=Ze2s-w6BB231A8cGziC88o-wyNTyaPAIq-HPy8RP-YA,2383
+sourcerer/domain/file_system/__init__.py,sha256=5diScp5Q8Hw8e_4vqacVocQBw0KA7fPs_YERoNwSEzM,184
+sourcerer/domain/file_system/entities.py,sha256=5W2_I1lng8J2foSJN-FqNZPR6n151VntiD_vkssAqgQ,2069
+sourcerer/domain/file_system/exceptions.py,sha256=pE_Z3gzbPO3JHU3WonBEoMOtPhuHSKr7ABGo-xyp8NY,513
+sourcerer/domain/file_system/services.py,sha256=CTBVL98E7eMNNzQsekzlyrxfJWw_cIzTROhBM5LgV_E,2216
+sourcerer/domain/shared/__init__.py,sha256=pkCn6PfBLIlYT5q4xWq3cNtOfbUrrePiH06TduLq6_o,148
+sourcerer/domain/shared/entities.py,sha256=kZ4F2ExhYIVC6FNtHzvk6n71KaCMgZdf-JL7M1eVOTs,462
+sourcerer/domain/storage_provider/__init__.py,sha256=P3RUH9LFkWez3ehCczgVbnbp0tZZepPeOQf9spsC8FQ,192
+sourcerer/domain/storage_provider/entities.py,sha256=So3mdAfM65W_J9hV78PzQS1R-i7g9LsKYiH-a1ui4XM,1970
+sourcerer/domain/storage_provider/exceptions.py,sha256=0sZuwDfjRDCX7Jdh39xVzEemZoYL_CWzZw2E7cc1AZc,512
+sourcerer/domain/storage_provider/services.py,sha256=3-JVtG3a7U-UCloO8nEguxA1E8Sr-HM0IsJxQ4xuWjE,3885
+sourcerer/infrastructure/__init__.py,sha256=HQoqA8S9Vx2dr1Eua86wu_YxwXyY6jqa4IfEoZJcXcQ,616
+sourcerer/infrastructure/utils.py,sha256=OnIaA2TKzN2yA8YasWEcrWV8ZC4xO0n0vJ7hgKCpbUQ,3042
+sourcerer/infrastructure/access_credentials/__init__.py,sha256=7BSXnI9n59_PuGxHjOra6PG82R_6JlrU4S1tsJx4WGM,249
+sourcerer/infrastructure/access_credentials/exceptions.py,sha256=WGOOH5NFR9sFtOqX-g9KasYSa6tzmaFStzfrTwtPqN8,601
+sourcerer/infrastructure/access_credentials/registry.py,sha256=KLaNQSQBGJ6QEvO8Q63QAjIUIfx3jLH_5sp_eD0xymw,3462
+sourcerer/infrastructure/access_credentials/repositories.py,sha256=og5kAgUlNNGbCQYCMTJ7DE1GotmqLc7owpnXIfOSnng,3839
+sourcerer/infrastructure/access_credentials/services.py,sha256=LBoRsE-CauSrcEduhkRR6DhfFT2QZqS5ErvPw4c83wg,12254
+sourcerer/infrastructure/db/__init__.py,sha256=sjx2F0aDnxej7-FAjhFJYIQQ5d2apmItkquKbvGYIBc,175
+sourcerer/infrastructure/db/config.py,sha256=VUh4S4bEh9GSx3ZDfQTI-ZGdkWNs_KdO9zDjRCGDjPQ,1808
+sourcerer/infrastructure/db/models.py,sha256=yABQtOG7FE8r8nfyg5mIAAZjmH4lj9TQzCV206-YCfY,1743
+sourcerer/infrastructure/file_system/__init__.py,sha256=Swx8arwXeZ4E40ViDSpQglmUrIlpuEvZY6crcWpGC2g,219
+sourcerer/infrastructure/file_system/exceptions.py,sha256=kNTQE24Z440igtiXnmWmhyKM8WMyBVXSXW9uWAqnL1A,3012
+sourcerer/infrastructure/file_system/services.py,sha256=OsNDLPBmjT9ps640ZPv9S_G1bCK3ThdAaR5Z_PdYgoI,5694
+sourcerer/infrastructure/storage_provider/__init__.py,sha256=GONjDCsTmd6f_fF3lzxDAfLlyuSQDhO4bz0eF9a35tI,229
+sourcerer/infrastructure/storage_provider/exceptions.py,sha256=LLtDv0Qrrjjw9NWeGOLFSpI4NkXEtLPKRQbXA4aINMM,2702
+sourcerer/infrastructure/storage_provider/registry.py,sha256=8mNrOemCvFPO71nOSCY4s0QtGnXNWk8GnwhwpalOVzo,2279
+sourcerer/infrastructure/storage_provider/services.py,sha256=26tOuuLwugtn3L17qUOBaM_Xzg4Ptrbj74VkgXbVCkM,16756
+sourcerer/presentation/__init__.py,sha256=kzOeaTpy9hm61MLl_nybdooRrawFUd1uEX4f3Y-84ZU,472
+sourcerer/presentation/app.py,sha256=ROu3vSWzo6d8W30A9Zqi5zdLcVeHJsGLDJMLTKrthHE,1018
+sourcerer/presentation/di_container.py,sha256=mbK8tDY0LgVRfQfXVZ5tGXPHSfr_8JraCMIQlZn0hBc,1641
+sourcerer/presentation/settings.py,sha256=OcNrvwqHwAq3ZqWOfEmZ0PqyvQpAY1fmBpMc9lBNfgI,1062
+sourcerer/presentation/utils.py,sha256=9kXYKV2ECCWzDuz4bIdjCsM4Q1ycvUPFI_YUWAtEsx8,2474
+sourcerer/presentation/screens/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/critical_error/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/critical_error/main.py,sha256=eRKR4xTpgf9AMPz2K9mVUGN_8MauVbTBb7v0JfhT6Ck,2242
+sourcerer/presentation/screens/critical_error/styles.tcss,sha256=mURvbf0_npkRtzVBs2bVBybbyNK9cO_6Ar2Muk1Mpv8,604
+sourcerer/presentation/screens/file_system_finder/main.py,sha256=sCTwuAFV8VxN2VsT6JkSfw292lE9GQAz9rJZ693WV2Y,10118
+sourcerer/presentation/screens/file_system_finder/styles.tcss,sha256=fZkdwXFsDkjXkaIskLxoQ_YHsLWKjgrn6hYseugg_68,718
+sourcerer/presentation/screens/file_system_finder/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/file_system_finder/widgets/file_system_navigator.py,sha256=f2w4rTkUMRMFCG4_W3xrsE4T5QqdJALObtIHT3fa2FQ,30875
+sourcerer/presentation/screens/main/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/main/main.py,sha256=jLexn2hiJlQEXK2Yy9y6Ex_doyR-2LzC9CHKs1Q4pgI,19466
+sourcerer/presentation/screens/main/styles.tcss,sha256=Ruv2vBKzM8njH7OS2TCpZqCmRVEp7XQLeBN4XhVB5AU,381
+sourcerer/presentation/screens/main/messages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/main/messages/delete_request.py,sha256=b8rjpe2E0p-BNYQTwuT0yD9qGzHat23N7ip_FbzhRaY,227
+sourcerer/presentation/screens/main/messages/download_request.py,sha256=PpLtx3A-s_sq7ThavtwR-2EkSjM0_NevZ5xvJ8JaCN8,229
+sourcerer/presentation/screens/main/messages/preview_request.py,sha256=px8N3E2VEexKmpZESb9nYDQvhXUThPxM0dU41B533tM,184
+sourcerer/presentation/screens/main/messages/resizing_rule.py,sha256=ws7lzS08h6qqeihF66XV5FsX26YkjQOje_4vgCw2mqI,332
+sourcerer/presentation/screens/main/messages/select_storage_item.py,sha256=xBu0UH5A6iyZPJECt_f_vfWVaCmE0bJo5hq2FJXMHQo,237
+sourcerer/presentation/screens/main/messages/uncheck_files_request.py,sha256=CMpYVwos1JHknqDcqru1hG8RJy5f1Lwjsxtrse1ZDGw,140
+sourcerer/presentation/screens/main/messages/upload_request.py,sha256=KXPTliqdvRvtMwob5bQUuBDxCjWmFcSjt-eUgQoRv7g,185
+sourcerer/presentation/screens/main/mixins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/main/mixins/resize_containers_watcher_mixin.py,sha256=PMtPFwEuxRaeFsaELzOEwOw6m30yMbIUTVkxkMbNRqU,5647
+sourcerer/presentation/screens/main/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/main/widgets/gradient.py,sha256=aaKg0rMlMhiZzwss_qVFNKMBSMh6rZHE4C6goo5CpNc,1268
+sourcerer/presentation/screens/main/widgets/resizing_rule.py,sha256=nn-Yucvq7DK9RM7hcgkfPpqLjPq5qfswm2X7Y3XMw5k,2040
+sourcerer/presentation/screens/main/widgets/storage_content.py,sha256=mOg13MdCPextpu4El1SY6huMPUWEcSnUC0njF74Stlc,21880
+sourcerer/presentation/screens/main/widgets/storage_list_sidebar.py,sha256=xYDW6S9GSn747s06WbE691mogLKg0JrK9bh1T7Nf-5o,4588
+sourcerer/presentation/screens/preview_content/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/preview_content/main.py,sha256=DGbiplvxZIE3gHKWZPsw3imqQWESO0Ej-YvN6t1j3uI,2267
+sourcerer/presentation/screens/preview_content/styles.tcss,sha256=wuLIX9UyniZ8EUBEqQ-_vn-CZ45q0PNxnbQFNG4QTxE,356
+sourcerer/presentation/screens/provider_creds_list/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/provider_creds_list/main.py,sha256=tU8Vi7OxUIjiC1pxZk3dIJh71zOWnu9VGaOSl8LWDoE,6203
+sourcerer/presentation/screens/provider_creds_list/styles.tcss,sha256=PmO_JKNR7NhYhT9CXLSZqh_q3rxFJ1HkSzVxOjJs_P8,904
+sourcerer/presentation/screens/provider_creds_registration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/provider_creds_registration/main.py,sha256=CGBNZ2asPupanb7Ds1x4WLuunYdIMBKJisjlEQKZHa0,10613
+sourcerer/presentation/screens/provider_creds_registration/styles.tcss,sha256=gd1SNeRoHTYwNzdGxK-2aDqNPeY5b2wFWajtoNn5--Y,612
+sourcerer/presentation/screens/question/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/question/main.py,sha256=2hhFhVf52IIuIgeiQPfBRQEP9hSuXxnJD55TFl4rYug,901
+sourcerer/presentation/screens/question/styles.tcss,sha256=fJl0Votob2sfRQP4s8Oqd5P2OQ0WiGMdoLpTsMgISfw,418
+sourcerer/presentation/screens/shared/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/shared/containers.py,sha256=n2eGBb-lGZoMBNV1e0HdAfCkCObZuaVusfRVvosVAfo,378
+sourcerer/presentation/screens/shared/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/shared/widgets/button.py,sha256=MpzxKZ7KGe5g4aNkNnFN6novnXv1au3WdgsVN-ITOns,1558
+sourcerer/presentation/screens/shared/widgets/labeled_input.py,sha256=q1y5XGWOtP9buk_hkLvc2QwDEd5XtK-_hFk_WQCARa8,2750
+sourcerer/presentation/screens/storage_action_progress/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/screens/storage_action_progress/main.py,sha256=1Y7zemJlgJ_twZI_bJYZ4r_7NHU7qS9hCtzLOPpkXJk,17298
+sourcerer/presentation/screens/storage_action_progress/styles.tcss,sha256=auV7H_JT68--Ry5SMLxsGamOcAnPhHul4NkIj2WOht0,667
+sourcerer/presentation/themes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sourcerer/presentation/themes/github_dark.py,sha256=9E1mEOr701nU-ZDSKBccMl3GYchroCEsxEVelm5oI-E,497
+data_sourcerer-0.1.0.dist-info/METADATA,sha256=7UC4aOLGSz3TxMMN8xPXlOrIYJSN5mBKRsJEKaLMaIM,1692
+data_sourcerer-0.1.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+data_sourcerer-0.1.0.dist-info/entry_points.txt,sha256=CyD02GehPW6QuhR5oDY5tLLRHQ9qbPXe0v3aT1pK3N8,62
+data_sourcerer-0.1.0.dist-info/top_level.txt,sha256=_9Nul_xiROuGIUDltaPqy-HyRzvv80MF_uquhggP9So,10
+data_sourcerer-0.1.0.dist-info/RECORD,,

data_sourcerer-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.3.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

data_sourcerer-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sourcerer = sourcerer.presentation.app:main

data_sourcerer-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 The Impact Craft
+
+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.

data_sourcerer-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+sourcerer

sourcerer/__init__.py

@@ -0,0 +1,15 @@
+"""
+Sourcerer - Cloud Storage Management Application.
+
+This package provides a comprehensive solution for managing and interacting
+with various cloud storage providers through a unified interface. It supports
+operations like browsing, uploading, downloading, and managing files across
+different cloud storage services.
+
+The application is structured using a clean architecture approach with:
+- Domain layer: Core business logic and entities
+- Infrastructure layer: Implementation details and external services
+- Presentation layer: User interface components
+"""
+
+__version__ = "0.1.0"

sourcerer/domain/__init__.py

@@ -0,0 +1,13 @@
+"""
+Domain layer for the Sourcerer application.
+
+This package contains the core business logic, entities, and service interfaces
+for the application. It defines the domain model and business rules independent
+of any external frameworks or technologies.
+
+The domain layer is organized into several subpackages:
+- file_system: File system entities and services
+- storage_provider: Cloud storage provider entities and services
+- access_credentials: Authentication and credential management
+- shared: Common entities and utilities shared across the domain
+"""

sourcerer/domain/access_credentials/__init__.py

@@ -0,0 +1,7 @@
+"""
+Access credentials domain module.
+
+This package defines the domain model for access credentials,
+including entities, services, repositories, and exceptions related
+to authentication and credential management.
+"""

sourcerer/domain/access_credentials/entities.py

@@ -0,0 +1,53 @@
+"""
+Access credentials entity classes.
+
+This module defines data classes representing access credentials
+used for authentication with various cloud providers.
+"""
+
+from dataclasses import dataclass
+from datetime import datetime
+
+import boto3
+
+
+@dataclass
+class Credentials:
+    """
+    Represents access credentials for a provider.
+
+    Attributes:
+        uuid (str): Unique identifier for the credentials.
+        name (str): Name of the credentials.
+        provider (str): Name of the service provider.
+        credentials_type (str): Type of credentials (e.g., key_pair).
+        credentials (str): Serialized credentials data.
+        active (bool): Indicates if the credentials are active.
+        created_at (datetime | None): Timestamp when the credentials were created.
+        updated_at (datetime | None): Timestamp when the credentials were last updated.
+    """
+
+    uuid: str
+    name: str
+    provider: str
+    credentials_type: str
+    credentials: str
+    active: bool
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+
+
+@dataclass
+class Boto3Credentials:
+    """
+    Represents AWS credentials using boto3 session.
+
+    Attributes:
+        session (boto3.Session): The boto3 session object for AWS authentication.
+        endpoint_url (str|None): Optional custom endpoint URL for AWS services.
+        signature_version (str|None): Optional signature version for AWS API requests.
+    """
+
+    session: boto3.Session
+    endpoint_url: str | None = None
+    signature_version: str | None = None

sourcerer/domain/access_credentials/exceptions.py

@@ -0,0 +1,17 @@
+"""
+Access credentials exception base class.
+
+This module defines the base exception class for errors related to
+access credentials operations.
+"""
+
+
+class BaseAccessCredentialsException(Exception):
+    """
+    Base exception class for access credentials-related errors.
+
+    This class serves as the base for all exceptions that arise
+    within the access credentials module. It provides a foundation for
+    more specific exceptions to inherit from, making it easier to
+    handle different credential error scenarios in a structured way.
+    """

sourcerer/domain/access_credentials/repositories.py

@@ -0,0 +1,84 @@
+"""
+Base credentials repository interface.
+
+This module defines the abstract base class for credentials repositories,
+providing a common interface for different storage implementations.
+"""
+
+from abc import abstractmethod, ABCMeta
+
+from sourcerer.domain.access_credentials.entities import Credentials
+
+
+class BaseCredentialsRepository(metaclass=ABCMeta):
+    """Base abstract class for credentials repository implementations.
+
+    Defines the interface for storing and retrieving credentials.
+    """
+
+    @abstractmethod
+    def create(self, credentials: Credentials):
+        """Create new credentials entry in the repository.
+
+        Args:
+            credentials (Credentials): The credentials object to store
+
+        Raises:
+            NotImplementedError: Method must be implemented by concrete classes
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def get(self, uuid):
+        """Retrieve credentials by UUID.
+
+        Args:
+            uuid: Unique identifier for the credentials
+
+        Returns:
+            Credentials: The credentials object if found, None otherwise
+
+        Raises:
+            NotImplementedError: Method must be implemented by concrete classes
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def list(self, active_only: bool | None = None):
+        """List all credentials in the repository.
+
+        Args:
+            active_only (bool|None, optional): If True, return only active credentials.
+                If False, return all credentials. Defaults to None.
+
+        Returns:
+            List[Credentials]: List of credentials objects
+
+        Raises:
+            NotImplementedError: Method must be implemented by concrete classes
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def activate(self, uuid):
+        """Activate credentials by UUID.
+
+        Args:
+            uuid: Unique identifier for the credentials to activate
+
+        Raises:
+            NotImplementedError: Method must be implemented by concrete classes
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def deactivate(self, uuid):
+        """Deactivate credentials by UUID.
+
+        Args:
+            uuid: Unique identifier for the credentials to deactivate
+
+        Raises:
+            NotImplementedError: Method must be implemented by concrete classes
+        """
+        raise NotImplementedError

sourcerer/domain/access_credentials/services.py

@@ -0,0 +1,91 @@
+"""
+Base access credentials service interfaces.
+
+This module defines the abstract base classes and data structures for
+access credential services, providing a common interface for different
+authentication methods.
+"""
+
+from abc import abstractmethod
+from dataclasses import dataclass
+from typing import List
+
+from sourcerer.domain.access_credentials.repositories import BaseCredentialsRepository
+
+
+@dataclass
+class AuthField:
+    """
+    Data class representing an authentication field.
+
+    Args:
+        key (str): Unique identifier for the auth field
+        label (str): Display label for the auth field
+        required (bool): Whether this field is required
+        description (str | None): Optional description of the field
+    """
+
+    key: str
+    label: str
+    required: bool
+    multiline: bool = False
+    description: str | None = None
+
+
+class BaseAccessCredentialsService:
+    """
+    Base class for access credentials services.
+
+    This abstract class defines the interface for services that manage
+    authentication credentials for various cloud providers and services.
+    """
+
+    def __init__(self, credentials_repo: BaseCredentialsRepository):
+        """
+        Initialize the service.
+
+        Args:
+            credentials_repo (BaseCredentialsRepository): Repository for storing credentials
+        """
+        self.credentials_repo = credentials_repo
+
+    @abstractmethod
+    def store(self, name: str, credentials: dict):
+        """
+        Store credentials.
+
+        Args:
+            name (str): Name identifier for the credentials
+            credentials (dict): Dictionary containing credential information
+        """
+
+    @abstractmethod
+    def extract(self, uuid: str):
+        """
+        Extract credentials by UUID.
+
+        Args:
+            uuid (str): UUID of the credentials to extract
+
+        Returns:
+            Credentials: The credentials object
+        """
+
+    @abstractmethod
+    def authenticate(self, credentials: str):
+        """
+        Authenticate using stored credentials.
+
+        Returns:
+            Any: Authentication result, typically a session or client object
+        """
+
+    @classmethod
+    @abstractmethod
+    def auth_fields(cls) -> List[AuthField]:
+        """
+        Get list of authentication fields.
+
+        Returns:
+            List[AuthField]: List of authentication field definitions
+        """

sourcerer/domain/file_system/__init__.py

@@ -0,0 +1,7 @@
+"""
+File system domain module.
+
+This package defines the domain model for file system operations,
+including entities, services, and exceptions related to file system
+interactions.
+"""

sourcerer/domain/file_system/entities.py

@@ -0,0 +1,70 @@
+"""
+File system entity classes.
+
+This module defines data classes representing file system entities and
+operation results used throughout the application.
+"""
+
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass
+class SearchResult:
+    """
+    Represents the result of a search operation.
+
+    This class encapsulates the details of a single search result, including
+    the matched text, the file where the match was found, and the line number
+    within the file. It is typically used to store and organize search results
+    for further processing or display.
+
+    Attributes:
+        text (str): The text that matched the search pattern.
+        file_name (str): The name of the file where the text was found.
+        line (int): The line number within the file where the text was found.
+    """
+
+    text: str
+    file_name: str
+    line: int
+
+
+@dataclass
+class SearchResultOutput:
+    """
+    Represents the output of a search operation.
+
+    This class encapsulates the results of a search operation, including
+    the search pattern used, the list of search results, and the total
+    number of matches found. It is typically used to organize and present
+    search results to the user.
+
+    Attributes:
+        pattern (str): The search pattern that was used.
+        output (list[SearchResult]): List of search result objects.
+        total (int): Total number of matches found.
+    """
+
+    pattern: str
+    output: list[SearchResult]
+    total: int
+
+
+@dataclass
+class ListDirOutput:
+    """
+    Represents the output of a list directory operation.
+
+    This class encapsulates the details of a list directory operation,
+    including the list of files and directories within the specified
+    directory. It is typically used to store and organize the directory
+    listing for further processing or display.
+
+    Attributes:
+        files (list[Path]): List of file paths found in the directory.
+        directories (list[Path]): List of directory paths found in the directory.
+    """
+
+    files: list[Path]
+    directories: list[Path]

sourcerer/domain/file_system/exceptions.py

@@ -0,0 +1,17 @@
+"""
+File system exception base class.
+
+This module defines the base exception class for errors related to
+file system operations.
+"""
+
+
+class BaseFileSystemException(Exception):
+    """
+    Base exception class for filesystem-related errors.
+
+    This class serves as the base for all exceptions that arise
+    within the filesystem module. It provides a foundation for
+    more specific exceptions to inherit from, making it easier to
+    handle different filesystem error scenarios in a structured way.
+    """

sourcerer/domain/file_system/services.py

@@ -0,0 +1,64 @@
+"""
+Base file system service interface.
+
+This module defines the abstract base class for file system services,
+providing a common interface for file system operations.
+"""
+
+import abc
+from pathlib import Path
+
+from sourcerer.domain.file_system.entities import ListDirOutput
+
+
+class BaseFileSystemService(metaclass=abc.ABCMeta):
+    """
+    Abstract base class for file system services.
+
+    This class defines the interface for file system operations such as
+    listing, reading, creating, and deleting files and directories.
+    Concrete implementations should provide the actual functionality.
+    """
+
+    @abc.abstractmethod
+    def read(self, path: Path) -> str:
+        """
+        Reads and processes the contents of a file located at the specified path.
+
+        This method will attempt to open the file, read its content, and perform
+        any necessary processing on the data. It assumes that the file is in
+        a format appropriate for the specific application logic and that the
+        given path is accessible.
+
+        Args:
+            path (Path): The path to the file to read.
+
+        Returns:
+            str: The processed data extracted from the file.
+
+        Raises:
+            ReadFileException: An error occurred during the file read operation.
+        """
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def list_dir(
+        self, path: Path, relative_paths: bool = False, recursively=False
+    ) -> ListDirOutput:
+        """
+        List all files and directories within the specified directory.
+
+        Args:
+            path (Path): The path to the directory.
+            relative_paths (bool): Whether to return relative paths or full paths.
+            recursively (bool): Whether iterate recursively over the content
+
+        Returns:
+            ListDirOutput: A data class containing the list of files and directories within the specified path.
+                - files (list[Path]): Sorted list of file paths
+                - 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.
+        """
+        raise NotImplementedError

sourcerer/domain/shared/__init__.py

@@ -0,0 +1,6 @@
+"""
+Shared domain components.
+
+This package contains shared entities, constants, and utilities
+used across different parts of the domain layer.
+"""

sourcerer/domain/shared/entities.py

@@ -0,0 +1,18 @@
+"""
+Shared entity classes and constants.
+
+This module defines shared entities and constants used across
+different parts of the application.
+"""
+
+
+class StorageProvider:
+    """
+    Constants representing supported cloud storage providers.
+
+    This class defines string constants for each supported storage provider,
+    which are used throughout the application to identify provider types.
+    """
+
+    S3 = "S3"
+    GoogleCloudStorage = "Google Cloud Storage"