Finaliza ajustes para iniciar Repositorio Git do SDK de Integração do Notion separado do meu projeto original

---

- Cria singleton de `client` com func `configure` para inicializar e `get_instance` para buscar instância do client;
- Ajusta clients para buscar headers vindo do pai `client` e fixa versão legacy no client de databases;
- Adiciona inicialização de `client` no init do projeto com api_token e api_version informados pelo usuário;
- Altera `NotionConfig` para inserir `database_id` no lugar de `database_name`;
- Altera sistema para receber `database_id` no lugar de `database_name`;
- Altera tipo de `properties` em `schemas.responses.pages.Page` de `Union[Dict[str, Any]], TDB` para `Union[Any, TDB]` para resolver reclamações de type hint;
- Adiciona param `generic_response` no init de `client` e nos clients e databases e pages para pular uso de mapping ao usar `.generic`;
- Adiciona param `raw_response` para pular parser e mappings e retornar resposta original da api;
- Finaliza `types` com subpastas para importações mas com init mãe vazio para evitar dependência circular e permitir uso de `notion.types.` pelo usuário;
- Remove importações do projeto original não relacionadas com o SDK;
- Adiciona param `timezone` na func `start_date` em `orm.common.SetProperty` que antes vinha do env, para posteriormente puxar da init da integração;
- Monta `LICENSE`, `README.md` e `pyproject.toml` base simples para commit inicial do projeto permitindo build de pacote;

---
This commit is contained in:
2026-01-20 22:26:39 -03:00
commit aff0446458
72 changed files with 2910 additions and 0 deletions
+52
View File
@@ -0,0 +1,52 @@
from typing import Type, TypeVar, Generic, Union, Literal
from .auth import headers as _headers
from .schemas.orm.database.DatabasesContainer import DatabasesContainer as _DatabasesContainer
from .orm.repositories import _Repositories
from .client import Client as _Client
TContainer = TypeVar('TContainer', bound = _DatabasesContainer)
class Notion(Generic[TContainer]):
"Classe principal para configurar a integração Notion."
orm: '_ORM[TContainer]'
def __init__(self,
api_token : str,
api_version : Union[Literal["legacy", "data_sources"], str] = "data_sources",
orm_container : Type[TContainer] = _DatabasesContainer,
timezone : str = "Etc/UTC"
):
"""
### Integration Params
- **api_token** = Bearer Token de Integração com a API Notion.
- **api_version** = Seleção entre versão `legacy` com Databases e versão mais nova com `data_sources`, permitindo inserir versão personalizada. Valor padrão: `legacy` *(2022-06-28)*.
- **orm_container** = Databases Container com configuração de ORM personalizada com classe base de tipo `types.DatabasesContainer`
"""
headers = _headers(
api_token = api_token,
api_version = api_version
)
_Client.configure(headers)
self.client = _Client.get_instance()
self.orm = _ORM(databases_container = orm_container)
self.DatabasesContainer = _DatabasesContainer
class _ORM(Generic[TContainer]):
"Namespace ORM com tipo propagado"
repo: _Repositories[TContainer]
def __init__(self,
databases_container : Type[TContainer]
):
self.repo = _Repositories()
self.repo.databases.container = databases_container()
__all__ = ["Notion"]