Contribute Media
A thank you to everyone who makes this possible: Read More

Como fazer boas libs? O que torna uma biblioteca fácil de usar

Description

Não é fácil escrever uma biblioteca confortável de usar. É difícil agradar a todos. Mas também é difícil agradar até quem acha que a nossa biblioteca faz algo útil. Não é fácil nem mesmo quando fazemos algo reusável só para nós mesmos.

Ainda bem que muitos outros programadores já erraram antes de nós. E existem em Python e fora dele diversos exemplos de boas libs nas quais podemos nos inspirar.

Essa palestra resumirá o que torna uma biblioteca boa, de acordo com nossa experiência e com a experiência de outros programadores que já escreveram sobre isso. Algumas características de boas bibliotecas são:

  • Alta Consistência
  • Muitos dados puros
  • Baixa Verbosidade
  • Respeito ao Principle of Least Astonishment
  • Alta Extensibilidade
  • Baixa Retenção
  • Vários níveis de abstrações
  • Alta granularidade
  • Interesses claros e separados
  • Pythonica

Como você pode ver, alguns aspectos acima são similares ao Zen of Python. Por isso também mostraremos funcionalidades do Python que ajudam a programar boas interfaces. Além disso, para resumir tudo definiremos um checklist que você poderá usar sempre que for escrever um módulo reusável. Esperamos que isso ajude você a programar melhor, o que certamente agradará seus parceiros de trabalho e a comunidade.

UPDATE: Slides em: http://www.vinta.com.br/blog/2016/python-brasil12-talks/

Details

Improve this page