Chat: FontBakery

Acho que o primeiro passo é dar uma olhadinha no repositório do projeto e ver a descrição e um pouco do código

https://github.com/googlefonts/fontbakery/

googlefonts/fontbakery

fontbakery - Tools to prepare font families for inclusion in github.com/google/fonts

Essa ferramenta é uma suite de testes para fontes

Cesar Scavone:

Felipe, você vai orientar os iniciantes em programação? Minha experiência é pouca.

a função da ferramenta é gerar um relatório de problemas em arquivos de fontes

ou em famílias tipográficas (família = conjunto de fontes que compartilham um mesmo aspecto visual, mas com pesos/estilos diferentes, por exemplo, Regular, Bold, Italics, etc...)

O projeto é todo escrito em python

se vocês quiserem eu posso fazer um evento no Garoa algum dia pra dar uma visão geral do projeto

Cesar Scavone:

Pode marcar, eu vou.

Jeferson:

Opa, eu topo

vou tentar ver uma data boa aqui na minha agenda e eu aviso aqui

por enquanto podemos ir conversando por aqui mesmo

vocês conhecem o projeto Google Fonts ?

o Google Fonts é um acervo de tipografias livres

tem 800 e poucas famílias tipográficas disponíveis (o que significa um total de cerca de 3 mil fontes livres)

Jeferson:

Vou dar um google mais fundo no assunto

Os designers de páginas web podem usar essas fontes em seus sites

entrando no site google.com/fonts dá pra navegar no acervo e escolher as fontes desejadas e o site informa qual o trecho de HTML/CSS que precisa ser adicionado a um site para usar aquelas fontes escolhidas

Making the web more beautiful, fast, and open through great typography

O FontBakery é uma suíte de testes que ajuda os designers a corrigirem todos os problemas que possam existir nas fontes antes delas serem disponibilizadas no site do Google

Esse é o principal objetivo do FontBakery: Controle de qualidade para o acervo do projeto Google Fonts.

Mas também é útil como ferramenta genérica para controle de qualidade de qualquer fonte tipográfica

todo o código é escrito em python

e a principal parte são os testes em si, que estão implementados aqui: https://github.com/googlefonts/fontbakery/blob/master/Lib/fontbakery/specifications/googlefonts.py

googlefonts/fontbakery

fontbakery - Tools to prepare font families for inclusion in github.com/google/fonts

Dá também pra instalar o FontBakery a partir do PyPI: https://pypi.python.org/pypi/fontbakery/

fontbakery 0.3.1 : Python Package Index

Font Bakery is a set of command-line tools for testing font projects

De tempos em tempos eu faço um release novo. No momento estou trabalhando no desenvolvimento do que será em breve a versão 0.3.2

Os bugs que falta resolver antes de lançar a versão 0.3.2 são esses aqui: https://github.com/googlefonts/fontbakery/milestone/57

googlefonts/fontbakery

fontbakery - Tools to prepare font families for inclusion in github.com/google/fonts

Se vocês quiserem dar uma lida no código e talvez também em alguns dos bugs do nosso bug-tracker, eu posso tirar dúvidas pra esclarecer o que eles significam. É só perguntar aqui que eu tento esclarecer.

Jeferson:

Amanha eu consigo olhar o repo

Jeferson:

E me familiarizar com os codigos

Jeferson:

Consigo separar um tempo no trampo msm pra ler

cada um no seu rítmo. Ficarei feliz se eu coneguir ajudar alguns de vocês a conhecerem de perto como funciona um projeto de software livre (caso já não conheçam, claro)

Jeferson:

Eu ainda nao conheco, mas to imteressado

Jeferson:

E no processo de engenharia de software na pratica tbm

eu não faço engenharia de software. Eu faço software. :-D

Tem um alemão no time que ajuda a dar umas reorganizadas gerais no projeto. Mas em geral a coisa é feita no dia-a-dia aos pouquinhos

e melhorando graduamente

Jeferson:

Rsrsrs...de boa

Jeferson:

Seria um "continuous delivery"?

prefiro chamar de "cada dia melhor"

Vinicyus:

Cara, alguma dica de como começar a contribuir? Tipo pegar issues ou algo assim

Vinicyus:

Eu entendo um pouco de python mas nunca contribui pra projeto open source

é... o bug tracker no github tem um monte de coisas que precisam ser feitas. Hoje, por exemplo, eu estou trabalhando na implementação de um teste novo, descrito nessa issue: https://github.com/googlefonts/fontbakery/issues/1488

Check: Combined length of family and style name must not exceed 20 characters · Issue #1488 · googlefonts/fontbakery

https://glyphsapp.com/tutorials/multiple-masters-part-3-setting-up-instances says Keep your style name short to avoid problems in Windows. How short? Well, you are on the safe side if the combined...

Vinicyus:

Legal, vou pegar uma issue quando puder e trabalhar nela

Os testes são implementados no arquivo Lib/fontbakery/specifications/googlefonts.py

são testes para avaliar arquivos de fontes

mas há também testes de código (pra certificar que o código em si está OK). Esses "auto-testes" ficam em Lib/fontbakery/specifications/googlefonts_test.py

implementar mais auto-testes pode ser uma tarefa mais simples pra quem está começando

Vinicius Melo:

Olá! Cheguei agora, sou iniciante em programação e tô pegando python pra estudar 😊

Vinicius Melo:

Agora sou de Salvador (terra de aurium) tem algum problema?

Claro que não! Software livre é pro mundo todo!

Vinicius Melo:

Maravilha

Vinicius Melo:

Dar uma olhada no repo agora

dá uma lida no histórico daqui desse grupo e veja se tem alguma dúvida, curiosidade, etc

Vinicius Melo:

Sim, fui lendo

o código do FontBakery usa muito de uma biblioteca chamada fontTools, que é desenvolvida por um cara que era da RedHat, mas hoje em dia trabalha pro Google. O nome dele é Behdad.

https://github.com/behdad/fonttools

fonttools/fonttools

fonttools - A library to manipulate font files from Python.

Vinicius Melo:

Tu usa bastante da libmagick e C né?

eu, pessoalmente, uso bastante C, sim. Quase não uso libmagick. Mas o FontBakery é todo em python mesmo.

a biblioteca fonttools nos dá acesso aos dados internos de arquivos de fontes OpenType

e são esses dados que a vasta maioria dos testes do fontbakery visa validar, pra ter certeza de que estão todos corretos

eu fiz uma lista de todos os testes que o fontbakery tem hoje em dia aqui: https://github.com/googlefonts/fontbakery/wiki/Documentation-for-the-Google-Fonts-Specification

googlefonts/fontbakery

fontbakery - Tools to prepare font families for inclusion in github.com/google/fonts

seria bacana ter uma forma de listar esses testes por meio da linha de comando... uma opção assim, por exemplo: fontbakery check-googlefonts --list-tests

isso seria muito útil

Vinicius Melo:

Certo, esses foram escritos manualmente?

aquela lista que tá na wiki eu gerei manualmente

usei uns truques de editor de texto pra facilitar minha vida, claro

Vinicius Melo:

Tu se baseou em qual arquivo?

Vinicius Melo:

Claro né kkk

no Lib/fontbakery/specifications/googlefonts.py

Vinicius Melo:

Nessas partes?

Vinicius Melo:

"""Check font has a license"""

Vinicius Melo:

Então em tese, usar regex?

mas eu acho que o lugar pra adicionar o código de listar testes deve ser no arquivo Lib/fontbakery/commands/check_spec.py

Vinicius Melo:

Sim, entendo

eu usaria regex se eu fosse extrair os dados do arquivo de código fonte

Vinicius Melo:

Foi o que tinha pensado kkk

mas o que acho que precisaria ser feito aqui é pegar os dados em runtime

assim como o programa é capaz de exibir essas informações ao usuário no terminal no momento de gerar as mensagens dos resultados dos testes, daria também para coletar essas informações e listar quais testes estão disponíveis

Pessoal, acabei de implementar o teste referente à issue #1488

https://github.com/googlefonts/fontbakery/pull/1583

new test: length of family + style must not exceed 20 chars by felipesanches · Pull Request #1583 · googlefonts/fontbakery

This is also the first test using the new markup for rationale, affected applications/OS/browsers, etc... And includes a proper code-test as well. Future new test requests/implementations should tr...

Toda vez que abro um pull request, o Travis roda uma suite de testes automatizados no servidor pra me dizer se tem algum problema impedindo que eu mescle o código no branch master

https://travis-ci.org/googlefonts/fontbakery/pull_requests

Se passar nos testes automatizados, posso fazer o merge e fechar a issue.

Uma coisa interessante é que eu não apenas implementei um teste novo para o FontBakery como também implementei um auto-teste para verificar que meu código funciona corretamente. E são esses "auto-testes" que rodam no Travis.

Se tiverem dúvidas, é só perguntar. Acho que esse é um ótimo exemplo de como as coisas funcionam.

OK! O Travis deu sinal verde! Então eu posso fazer o merge :-)

E fechar a issue também!

Vinicius Melo:

Vc que passa os parâmetros pro Travis?

o Travis já está configurado por meio de um arquivo .travis.yml na raiz do projeto. E uma vez na vida eu configurei pro travis rodar nesse projeto a cada pull request

então ele lê o arquivo de configuração e faz o que tá escrito lá

Vinicius Melo:

Hm, muito bom

que é basicamente rodar um pylint pra ver se tem erros de sintaxe

e também rodar a suite de auto-testes

ele instala todas as dependências no servidor a partir de um container zerado de GNU+Linux e depois roda os auto-testes. Então isso nos dá uma boa garantia de que tá tudo redondinho e de que eu não quebrei nada sem querer com as alterações propostas

os auto-testes são importantes por isso

Vinicius Melo:

Sim, curti

entretanto, hoje em dia só uns 30% dos testes do FontBakery possuem auto-testes

seria importante eu (ou alguém) implementar os auto-testes para todos os outros testes que já temos

de agora em diante estou adotando a política de não adicionar novos testes ao FontBakery se eles não estiverem acompanhados também de auto-testes

assim pelo menos o problema não aumenta

tem uma issue específica sobre essa suite de "auto-testes" aqui: https://github.com/googlefonts/fontbakery/issues/1413

[new-arch] A testsuite for the testsuite! · Issue #1413 · googlefonts/fontbakery

While porting fontbakery checks to the new architecture (#1388) I dealt with a bunch of crash bugs (introduced by a few silly mistakes by myself during the port). I think it would be wise to write ...

esse commit aqui foi meio cabeludo: https://github.com/googlefonts/fontbakery/commit/894957f44e3f0499a5de4e8be4d9b267d46e77c8

pytest 033 + bugfix + OverpassMono reference family · googlefonts/fontbakery@894957f

(issue #1530)

Mas é um bom exemplo de como escrever um auto-teste rigoroso

hoje estou trabalhando na implementação de um auto-teste para o teste com.google.fonts/test/040

Vinicius Melo:

@fsanches depos quero pegar a issue de mostrar os testes na cli

ok, então vou cadastrar uma issua lá descrevendo isso (existe o risco de alguém implementar antes de você, é claro, hahaha)

Talvez o Lasse Fister seja mais rápido

Vinicius Melo:

tranquilo

mas sempre tem mais bugs a serem resolvidos

Vinicius Melo:

como tá teu tempo pra me dar uns helps nessa issue mais tarde?

eu estou focado em implementar os auto-testes. Acho que o que faz mais sentido é você arregaçar as mangas e tentar. Se depois de tentar por um tempo você enroscar, aí pode perguntar aqui que eu tento tirar as dúvidas :-)

Vinicius Melo:

certo

eu estarei indisponível das 16h às 17h

participando de uma reunião

https://github.com/googlefonts/fontbakery/issues/1586

Add a --list-tests command line argument to describe the tests of a given specification · Issue #1586 · googlefonts/fontbakery

For instance, if one wants to know which are the titles, descriptions and IDs of all tests available in the Google Fonts specification, then it would possible to list that info with the following c...

O que acontece com os "Vinis" por aqui? Temos 3 de vocês, @vinicyus_m (Vinicyus) @vmesel (Vinicius Mesel) e @vinimlo (Vinicius Melo) !

Caraca! E os 3 são "Vini M."

Vinicyus:

Eu sou o único com y

Desculpa, gente... eu sou programador. Minha maior habilidade é a detecção de padrões...

Então vou ter que me referir ao Melo, ao Mesel e ao Y :-P

Vinicius Mesel:

uahsauhsahuasuhsauahs

Vinicius Melo:

Krai kkkkk

acabei de implementar um auto-teste para o teste número 098: https://github.com/googlefonts/fontbakery/pull/1587

pytest 098: test for good metadata font.name field format by felipesanches · Pull Request #1587 · googlefonts/fontbakery

This pull request addresses the problems described at issue #1530

job rolando agora no Travis aqui: https://travis-ci.org/googlefonts/fontbakery/builds/278761684

ok, voltei. O próximo auto-teste que vou fazer é o 099 ;-)

Acho que é bem parecido com o anterior, então deve ser fácil

Ma:

Boa noite, estou analisando para entender, aprender e poder ajudar.

hoje implementei um montão de auto-testes

e, de fato, esbarrei em alguns bugs detectados pelos auto-testes

então está sendo benéfico escrever os auto-testes. Estão cumprindo a função de alertar para situações onde o código está errado e precisa ser corrigido

https://github.com/googlefonts/fontbakery/commit/1a4a5f6205bc4db2eea617dcb9577db220ea24be

deprecate test/114: Redundant OS2.usWeightClass test · googlefonts/fontbakery@1a4a5f6

== Rationale == We need to assure coherence among the following pieces of info: (A) A given font canonical filename; (B) Its ttFont["OS/2"].usWeightClass; (C) The METADATA.pb font.weight fiel...

Yabadabaduca:

Bom dia!
Comecei a dar uma estudada este fim de semana

Yabadabaduca:

@fsanches nesses testes vc usa o Jenkins?

Não. Os auto-testes são executados automaticamente no servidor do TravisCI

http://travis-ci.org/

https://travis-ci.org/googlefonts/fontbakery/builds

Yabadabaduca:

Hmmm... Mais leve e clean

hoje fiz uma limpeza geral no código, dei uns tapas nos nomes de todas as funções does testes e revisei várias docstrings

E tropecei num bug, então acabei corrigindo-o, só por costume :-)

https://github.com/googlefonts/fontbakery/pull/1593

bugfix test/095 + rename all test functions and review some of the test and self-test docstrings by felipesanches · Pull Request #1593 · googlefonts/fontbakery

This pull request addresses the problems described at issue #1530

Vinicius Melo:

Bem vindo @aurium !

@aurium é um colega meu de longa-data

Juntos nós fomos na década passada os dois únicos desenvolvedores do Inkscape

Vinicius Melo:

Conheço demais

Vinicius Melo:

Estava com ele tem poucos minutos kkk

depois tiveram alguns outros brazucas que apareceram de forma passageira

Vinicius Melo:

Já resolveram aquela issue da cli pra listar os testes?

não sei... deixa eu ver

https://github.com/googlefonts/fontbakery/issues/1586

Vinicius Melo:

Vou ver se pego essa issue pra fazer

Vinicius Melo:

Mas vou precisar de uma ajuda na lógica

Vinicius Melo:

Onde pesquisar e tudo

hoje estou fechando o dia

amanhã de manhã estarei por aqui

Vinicius Melo:

Beleza

Vinicius Melo:

Manhã é que horas?

se quiser fritar o cérebro ai de madrugada você consegue tirar dúvidas comigo pela manhã hahaha

a partir das 9h eu já tô na frente do laptop

Vinicius Melo:

Maravibelezura

Vinicius Melo:

Vou fazer isso então

Vinicius Melo:

Recomenda algo antes de tudo?

Vinicius Melo:

Alguma leitura*

Lib/fontbakery/specifications/googlefonts.py

Lib/fontbakery/testrunner.py

Vinicius Melo:

Certo..

acho que o mais provável é que o que você procura esteja talvez em Lib/fontbakery/commands/check_spec.py

eu começaria por esse

mas não tenho certeza

Vinicius Melo:

Certo 🤔

Vinicius Melo:

Vou estudar kkk

e Happy Hacking ! :-D

Vinicius Melo:

Hehe, valeu ;-)