infra-core-sdk 0.1.0

Secure and extensible credential management SDK for Python applications.

🔐 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:

pip install -e caminho/para/infra_core

Exemplo:

pip install -e C:\Users\rafael.m.cavalcante\PycharmProjects\infra_core

---

🔹 Produção

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

name="aws" → secret/aws.json

---

🧩 Criando um modelo de credenciais

from dataclasses import dataclass
from infra_core import BaseCredentials

@dataclass(frozen=True)
class MyCreds(BaseCredentials):
    api_token: str

---

💾 Salvando credenciais (Setup)

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)

from infra_core import CredentialsLoader, FernetEncryption

creds = CredentialsLoader.load(
    MyCreds,
    FernetEncryption,
    name="pipefy"
)

print(creds.api_token)

---

🔄 Multi-credenciais

setup.setup(..., name="aws")
setup.setup(..., name="pipefy")
setup.setup(..., name="stripe")

---

🔐 Encryption

Default

from infra_core import FernetEncryption

---

Custom (avançado)

class CustomEncryption:
    def encrypt(self, value: str) -> str:
        ...

    def decrypt(self, value: str) -> str:
        ...

---

⚠️ Regras importantes

❌ Não faça

Fernet.generate_key()
FernetEncryption(key)

---

✅ Faça

CredentialsSetupService(FernetEncryption)

---

🧪 Testes

pytest tests

---

🧠 Arquitetura

infra_core/
├── core/            # Path management
├── credentials/
│   ├── models/      # BaseCredentials
│   ├── services/    # Load / Save
│   ├── setup/       # Setup flow
│   └── exceptions/
├── security/        # Encryption

---

⚠️ Problemas comuns

ModuleNotFoundError

pip install -e caminho/infra_core

---

Dependência não encontrada

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