infra-core-sdk 0.1.0__tar.gz

infra_core_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: infra-core-sdk
+Version: 0.1.0
+Summary: Secure and extensible credential management SDK for Python applications.
+Author: Rafael Cavalcante
+Project-URL: Homepage, https://github.com/rmcavalcante7/
+Project-URL: Repository, https://github.com/rmcavalcante7/infra-core-sdk
+Requires-Python: <3.15,>=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: cryptography>=46.0.6
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# 🔐 infra_core
+
+**infra_core** é um SDK Python para gerenciamento seguro de credenciais com suporte a criptografia automática, múltiplos ambientes e arquitetura extensível.
+
+---
+
+## 🚀 Features
+
+* 🔐 Criptografia automática (Fernet)
+* 📦 Suporte a múltiplas credenciais (`name`)
+* ⚙️ Setup e Load desacoplados
+* 📁 Gerenciamento automático de paths
+* 🧩 Arquitetura modular e extensível
+* 🔄 Compatível com `pip install -e` (desenvolvimento)
+
+---
+
+## 📦 Instalação
+
+### 🔹 Desenvolvimento (recomendado)
+
+Dentro do projeto que irá **usar o SDK**:
+
+```bash
+pip install -e caminho/para/infra_core
+```
+
+Exemplo:
+
+```bash
+pip install -e C:\Users\rafael.m.cavalcante\PycharmProjects\infra_core
+```
+
+---
+
+### 🔹 Produção
+
+```bash
+pip install infra-core
+```
+
+---
+
+## 🧱 Estrutura esperada
+
+Após o uso:
+
+```
+seu_projeto/
+├── main.py
+├── secret/
+│   ├── secret.key
+│   ├── aws.json
+│   ├── pipefy.json
+```
+
+---
+
+## 🧠 Conceitos principais
+
+### 🔑 Secret Key
+
+* Gerada automaticamente no primeiro uso
+* Armazenada em `secret/secret.key`
+* Nunca deve ser criada manualmente
+
+---
+
+### 📄 Credenciais
+
+* Cada credencial é armazenada em um arquivo separado
+* Nome controlado pelo parâmetro `name`
+
+```python
+name="aws" → secret/aws.json
+```
+
+---
+
+## 🧩 Criando um modelo de credenciais
+
+```python
+from dataclasses import dataclass
+from infra_core import BaseCredentials
+
+@dataclass(frozen=True)
+class MyCreds(BaseCredentials):
+    api_token: str
+```
+
+---
+
+## 💾 Salvando credenciais (Setup)
+
+```python
+from infra_core import FernetEncryption
+from infra_core.credentials.setup.credentials_setup_service import CredentialsSetupService
+
+setup = CredentialsSetupService(FernetEncryption)
+
+setup.setup(
+    MyCreds(api_token="123"),
+    name="pipefy"
+)
+```
+
+---
+
+## 🔓 Carregando credenciais (Load)
+
+```python
+from infra_core import CredentialsLoader, FernetEncryption
+
+creds = CredentialsLoader.load(
+    MyCreds,
+    FernetEncryption,
+    name="pipefy"
+)
+
+print(creds.api_token)
+```
+
+---
+
+## 🔄 Multi-credenciais
+
+```python
+setup.setup(..., name="aws")
+setup.setup(..., name="pipefy")
+setup.setup(..., name="stripe")
+```
+
+---
+
+## 🔐 Encryption
+
+### Default
+
+```python
+from infra_core import FernetEncryption
+```
+
+---
+
+### Custom (avançado)
+
+```python
+class CustomEncryption:
+    def encrypt(self, value: str) -> str:
+        ...
+
+    def decrypt(self, value: str) -> str:
+        ...
+```
+
+---
+
+## ⚠️ Regras importantes
+
+### ❌ Não faça
+
+```python
+Fernet.generate_key()
+FernetEncryption(key)
+```
+
+---
+
+### ✅ Faça
+
+```python
+CredentialsSetupService(FernetEncryption)
+```
+
+---
+
+## 🧪 Testes
+
+```bash
+pytest tests
+```
+
+---
+
+## 🧠 Arquitetura
+
+```
+infra_core/
+├── core/            # Path management
+├── credentials/
+│   ├── models/      # BaseCredentials
+│   ├── services/    # Load / Save
+│   ├── setup/       # Setup flow
+│   └── exceptions/
+├── security/        # Encryption
+```
+
+---
+
+## ⚠️ Problemas comuns
+
+### ModuleNotFoundError
+
+```bash
+pip install -e caminho/infra_core
+```
+
+---
+
+### Dependência não encontrada
+
+```bash
+pip install cryptography
+```
+
+---
+
+### PyCharm não reconhece imports
+
+```
+File → Invalidate Caches → Restart
+```
+
+---
+
+## 🎯 Fluxo completo
+
+```
+SETUP:
+    → gera key
+    → criptografa
+    → salva arquivo
+
+LOAD:
+    → lê key
+    → descriptografa
+    → retorna objeto tipado
+```
+
+---
+
+## 🚀 Roadmap
+
+* [ ] CLI (`infra-core setup`)
+* [ ] Registry de credenciais
+* [ ] Multi-env (dev/prod)
+* [ ] Publish no PyPI
+
+---
+
+## 📄 Licença
+
+MIT
+
+---
+
+## 👨‍💻 Autor
+
+Rafael Cavalcante

infra_core_sdk-0.1.0/README.md

@@ -0,0 +1,259 @@
+# 🔐 infra_core
+
+**infra_core** é um SDK Python para gerenciamento seguro de credenciais com suporte a criptografia automática, múltiplos ambientes e arquitetura extensível.
+
+---
+
+## 🚀 Features
+
+* 🔐 Criptografia automática (Fernet)
+* 📦 Suporte a múltiplas credenciais (`name`)
+* ⚙️ Setup e Load desacoplados
+* 📁 Gerenciamento automático de paths
+* 🧩 Arquitetura modular e extensível
+* 🔄 Compatível com `pip install -e` (desenvolvimento)
+
+---
+
+## 📦 Instalação
+
+### 🔹 Desenvolvimento (recomendado)
+
+Dentro do projeto que irá **usar o SDK**:
+
+```bash
+pip install -e caminho/para/infra_core
+```
+
+Exemplo:
+
+```bash
+pip install -e C:\Users\rafael.m.cavalcante\PycharmProjects\infra_core
+```
+
+---
+
+### 🔹 Produção
+
+```bash
+pip install infra-core
+```
+
+---
+
+## 🧱 Estrutura esperada
+
+Após o uso:
+
+```
+seu_projeto/
+├── main.py
+├── secret/
+│   ├── secret.key
+│   ├── aws.json
+│   ├── pipefy.json
+```
+
+---
+
+## 🧠 Conceitos principais
+
+### 🔑 Secret Key
+
+* Gerada automaticamente no primeiro uso
+* Armazenada em `secret/secret.key`
+* Nunca deve ser criada manualmente
+
+---
+
+### 📄 Credenciais
+
+* Cada credencial é armazenada em um arquivo separado
+* Nome controlado pelo parâmetro `name`
+
+```python
+name="aws" → secret/aws.json
+```
+
+---
+
+## 🧩 Criando um modelo de credenciais
+
+```python
+from dataclasses import dataclass
+from infra_core import BaseCredentials
+
+@dataclass(frozen=True)
+class MyCreds(BaseCredentials):
+    api_token: str
+```
+
+---
+
+## 💾 Salvando credenciais (Setup)
+
+```python
+from infra_core import FernetEncryption
+from infra_core.credentials.setup.credentials_setup_service import CredentialsSetupService
+
+setup = CredentialsSetupService(FernetEncryption)
+
+setup.setup(
+    MyCreds(api_token="123"),
+    name="pipefy"
+)
+```
+
+---
+
+## 🔓 Carregando credenciais (Load)
+
+```python
+from infra_core import CredentialsLoader, FernetEncryption
+
+creds = CredentialsLoader.load(
+    MyCreds,
+    FernetEncryption,
+    name="pipefy"
+)
+
+print(creds.api_token)
+```
+
+---
+
+## 🔄 Multi-credenciais
+
+```python
+setup.setup(..., name="aws")
+setup.setup(..., name="pipefy")
+setup.setup(..., name="stripe")
+```
+
+---
+
+## 🔐 Encryption
+
+### Default
+
+```python
+from infra_core import FernetEncryption
+```
+
+---
+
+### Custom (avançado)
+
+```python
+class CustomEncryption:
+    def encrypt(self, value: str) -> str:
+        ...
+
+    def decrypt(self, value: str) -> str:
+        ...
+```
+
+---
+
+## ⚠️ Regras importantes
+
+### ❌ Não faça
+
+```python
+Fernet.generate_key()
+FernetEncryption(key)
+```
+
+---
+
+### ✅ Faça
+
+```python
+CredentialsSetupService(FernetEncryption)
+```
+
+---
+
+## 🧪 Testes
+
+```bash
+pytest tests
+```
+
+---
+
+## 🧠 Arquitetura
+
+```
+infra_core/
+├── core/            # Path management
+├── credentials/
+│   ├── models/      # BaseCredentials
+│   ├── services/    # Load / Save
+│   ├── setup/       # Setup flow
+│   └── exceptions/
+├── security/        # Encryption
+```
+
+---
+
+## ⚠️ Problemas comuns
+
+### ModuleNotFoundError
+
+```bash
+pip install -e caminho/infra_core
+```
+
+---
+
+### Dependência não encontrada
+
+```bash
+pip install cryptography
+```
+
+---
+
+### PyCharm não reconhece imports
+
+```
+File → Invalidate Caches → Restart
+```
+
+---
+
+## 🎯 Fluxo completo
+
+```
+SETUP:
+    → gera key
+    → criptografa
+    → salva arquivo
+
+LOAD:
+    → lê key
+    → descriptografa
+    → retorna objeto tipado
+```
+
+---
+
+## 🚀 Roadmap
+
+* [ ] CLI (`infra-core setup`)
+* [ ] Registry de credenciais
+* [ ] Multi-env (dev/prod)
+* [ ] Publish no PyPI
+
+---
+
+## 📄 Licença
+
+MIT
+
+---
+
+## 👨‍💻 Autor
+
+Rafael Cavalcante

infra_core_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = [ "setuptools>=61.0",]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "infra-core-sdk"
+version = "0.1.0"
+description = "Secure and extensible credential management SDK for Python applications."
+readme = "README.md"
+requires-python = ">=3.14,<3.15"
+dependencies = [ "cryptography>=46.0.6",]
+[[project.authors]]
+name = "Rafael Cavalcante"
+
+[project.optional-dependencies]
+dev = [ "pytest>=8.0.0", "pytest-cov>=4.0.0", "black>=24.0.0", "mypy>=1.0.0",]
+
+[project.urls]
+Homepage = "https://github.com/rmcavalcante7/"
+Repository = "https://github.com/rmcavalcante7/infra-core-sdk"
+
+[tool.setuptools.packages.find]
+where = [ "src",]
+
+[tool.black]
+line-length = 88
+target-version = ["py310"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-ra -q"

infra_core_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

infra_core_sdk-0.1.0/src/infra_core/__init__.py

@@ -0,0 +1,27 @@
+# ============================================================
+# Public API - infra_core
+# ============================================================
+
+from infra_core.core.path import (
+    PathManager,
+    PathConfig,
+    DEFAULT_PATH_CONFIG,
+)
+
+from infra_core.credentials.models.base_credentials import BaseCredentials
+
+from infra_core.credentials.services.credentials_service import CredentialsService
+from infra_core.credentials.services.credentials_loader import CredentialsLoader
+from infra_core.security.fernet_encryption import FernetEncryption
+
+__all__ = [
+    # Path
+    "PathManager",
+    "PathConfig",
+    "DEFAULT_PATH_CONFIG",
+    # Credentials
+    "BaseCredentials",
+    "CredentialsService",
+    "CredentialsLoader",
+    "FernetEncryption",
+]

infra_core_sdk-0.1.0/src/infra_core/core/__init__.py

@@ -0,0 +1,25 @@
+# ============================================================
+# Public API - infra_core
+# ============================================================
+
+from infra_core.core.path import (
+    PathManager,
+    PathConfig,
+    DEFAULT_PATH_CONFIG,
+)
+
+from infra_core.credentials.models.base_credentials import BaseCredentials
+
+from infra_core.credentials.services.credentials_service import CredentialsService
+from infra_core.credentials.services.credentials_loader import CredentialsLoader
+
+__all__ = [
+    # Path
+    "PathManager",
+    "PathConfig",
+    "DEFAULT_PATH_CONFIG",
+    # Credentials
+    "BaseCredentials",
+    "CredentialsService",
+    "CredentialsLoader",
+]

infra_core_sdk-0.1.0/src/infra_core/core/path/__init__.py

@@ -0,0 +1,8 @@
+from infra_core.core.path.path_manager import PathManager
+from infra_core.core.path.path_config import PathConfig, DEFAULT_PATH_CONFIG
+
+__all__ = [
+    "PathManager",
+    "PathConfig",
+    "DEFAULT_PATH_CONFIG",
+]

infra_core_sdk-0.1.0/src/infra_core/core/path/exceptions.py

@@ -0,0 +1,22 @@
+# ============================================================
+# Dependencies:
+
+# ============================================================
+
+
+class PathResolutionError(Exception):
+    """
+    Exception raised when path resolution fails.
+
+    This error indicates failure in determining project root or resolving
+    logical paths.
+
+    :example:
+        >>> try:
+        ...     raise PathResolutionError("error")
+        ... except PathResolutionError:
+        ...     True
+        True
+    """
+
+    pass

infra_core_sdk-0.1.0/src/infra_core/core/path/path_config.py

@@ -0,0 +1,51 @@
+# ============================================================
+# Dependencies:
+# - dataclasses
+# - typing
+# ============================================================
+
+from dataclasses import dataclass
+from typing import Dict, Tuple
+
+
+@dataclass(frozen=True)
+class PathConfig:
+    """
+    Configuration object defining path resolution behavior.
+
+    This class encapsulates all configurable aspects of the path system,
+    including how the project root is detected and how logical paths are mapped.
+
+    :param root_markers: Tuple[str, ...] = Files or directories used to detect project root.
+    :param directories: Dict[str, str] = Logical key → relative path mapping.
+
+    :example:
+        >>> config = PathConfig(
+        ...     root_markers=(".git",),
+        ...     directories={"data": "data"}
+        ... )
+        >>> config.directories["data"]
+        'data'
+    """
+
+    root_markers: Tuple[str, ...]
+    directories: Dict[str, str]
+
+
+DEFAULT_PATH_CONFIG: PathConfig = PathConfig(
+    root_markers=(
+        ".git",
+        "pyproject.toml",
+        "requirements.txt",
+        "setup.py",
+        ".root",
+        ".venv",
+        "venv",
+    ),
+    directories={
+        "secret_dir": "secret",
+        "secret_key": "secret/secret.key",
+        "credentials": "secret/{name}.json",
+        "downloads": "downloads",
+    },
+)