12-open-as-principle

O SDK é princípio arquitectural. Ser open é princípio de vida.

Em 2026 construí três bibliotecas Python open source. Sozinho, à noite e aos fins-de-semana. Licença MIT, sem ads, sem paywall.

Arquitectural porque a tua aplicação não tem de saber que a API legacy chama "valor" e a v1.02 chama "payment.amount.value". Não tem de validar NIF à mão. Não tem de comparar XML linha-a-linha. Há uma camada que faz essas coisas — e a tua app pede apenas o que quer dizer.

Open porque os problemas que estes três SDKs resolvem são problemas portugueses concretos:

→ eupago — pagamentos. Duas gerações de API, três autenticações, Apple Pay sandbox que devolve 400, Pay By Link que expira em silêncio.
→ Vendus — faturação certificada pela AT. Regras fiscais que só descobres ao errar.
→ xmldiffreport — comparar configurações test → uat → bench → prod sem um diff de texto a mentir-te.

A documentação oficial assume que já sabes a parte que ninguém te conta. Agora está no meu código, no CHANGELOG, nos exemplos, nas recipes, nos testes em produção. Para a próxima pessoa não gastar semanas a descobrir o mesmo.

Nas próximas 8 semanas vou partilhar aqui as decisões por trás de cada um.
Começo na quarta com a página de que mais me orgulho — uma tabela de estado.

Sítios: eupago.bilouro.com · vendus.bilouro.com · xmldiffreport.bilouro.com

P.S. Novo post tech toda a quarta-feira aqui no LinkedIn.

#OpenSource #Python #SoftwareArchitecture