ufolint

O UFFOLINT é um linhário de arquivo de origem para o desenvolvimento do tipo de desenvolvimento do tipo de letra no Objeto de Fonte Unificado (UFO). Foi projetado para testes de integração contínua de contribuições de origem de OVNI para projetos de tipo de letra.

O aplicativo executa uma análise estática específica da versão UFO dos arquivos de texto de origem em relação às especificações UFO V2 e V3 para questões que incluem:

• Versão de OVNI suportada
• Arquivos e diretórios obrigatórios
• Convenções de nomeação de caminho obrigatório
• Fonte definida Caminho de arquivo e consistência do caminho do diretório entre arquivos de origem
• formato de arquivo xml válido
• *.Plist Arquivo Propriedade da lista de verificações
• *.Plist File Property List Value Type
• Fontinfo.plist Openype Propriedade Nomeação de Propriedades Convenções
• Fontinfo.plist OpenType Property Data Valitações
• *.Glif Format Versat Version Testing
• *.glif Arquivo Survo
• As imagens seguem a especificação UFO V3+ PNG
• Os arquivos de origem importam para a biblioteca UFolib com os métodos públicos de Ufolib

Esses testes são realizados através de uma combinação de métodos públicos na biblioteca Fonttools.ufolib e testes adicionais que são implementados no aplicativo UFolint. O UFolint captura exceções levantadas nos métodos de leitura pública do UFolib para todos os tipos de arquivos _.plist e todas as validações de UFolib realizadas nos arquivos _.glif. Eles são devolvidos aos usuários com mensagens de erro informativas que indicam os filepath (s) de preocupação e saída do código de status 1.

Instalar e atualizar

O UFolint pode ser executado localmente ou com serviços de teste de IC remota.

Instalação local e atualização

Use o comando:

 $ pip install ufolint

Atualize para uma nova versão do aplicativo com o comando:

 $ pip install --upgrade ufolint

Uso local

O processo é totalmente automatizado. Simplesmente aponte o Ufolint para um ou mais diretórios de origem OVNI e ele cuida do resto. O UFFOLINT sai com o código de status 0 se todos os testes passarem e saem com o código de status 1 se algum teste falhar.

 $ ufolint [UFO source path] ([UFO path 2] [UFO path3]...)

Exemplo

 $ ufolint Awesome-Regular.ufo Awesome-Bold.ufo

Para falhas críticas que impedem a conclusão de mais testes, as saídas de UFolint imediatamente e outros testes são abortadas. Em todas as outras circunstâncias, as falhas são coletadas em toda a análise e exibidas na conclusão de todos os testes.

O UFolint fornece mensagens de erro detalhadas e úteis que incluem o (s) arquivo (s) de preocupação, o tipo de erro e, em muitos casos, a linha problemática no arquivo.

Configuração do Travis CI

Para testar continuamente suas alterações de fonte de OVNIs no Travis com cada commit empurrado ou puxar a solicitação enviada ao seu repositório do GitHub, use essas duas etapas iniciais do guia do Travis Toebning:

• Etapa 1 : Faça login no travis com sua conta do Github
• Etapa 2 : Vá para a sua página de perfil Travis e ative o Travis para o repositório do tipo de letra, onde você gostaria de ativar o teste de Ufolint

Então, no seu repositório do GitHub,

• Etapa 3 : Adicione um arquivo no caminho .travis.yml na raiz do seu repositório GitHub que inclui o seguinte texto:

.Travis.yml

 sudo : false
language : python

env :
  - VARIANT=src/Test-Regular.ufo
  - VARIANT=src/Test-Bold.ufo
  - VARIANT=src/Test-Italic.ufo
  - VARIANT=src/Test-BoldItalic.ufo

before_script : pip install ufolint

script : " ufolint $VARIANT "

notifications :
  email : false

• Etapa 4 : substitua a VARIANT=src/Test-*.ufo no arquivo .travis.yml com os caminhos reais para seus arquivos de origem OVNI após o = caractere. Use uma linha por variante e adicione ou subtraia as linhas conforme necessário para testar os diretórios de OVNIs de origem desejada no repositório. Estes devem ser caminhos relativos da raiz do seu repositório Git.

Essa estrutura de configuração do Travis executa os testes variantes em paralelo para cada uma das variantes especificadas no campo env do arquivo de configurações do Travis. Cada variante será rotulada na página de teste Travis como esta:

• Etapa 5 : com cada novo comprometimento empurrado para o seu repositório do GitHub (ou qualquer nova solicitação de tração enviada por outras pessoas) Travis é notificada automaticamente e executa os testes de UFolint nas fontes UFO modificadas (ou propostas para solicitações de tração). Você pode visualizar os resultados do teste na página da sua conta Travis para o repositório.

• Opcional : para adicionar um crachá de resultado do teste Travis à sua página Readme do repositório, insira a seguinte marcação na página ReadMe e modifique [ACCOUNT] e [REPOSITORY] com sua conta Travis e detalhes do repositório:

 [![Build Status](https://travis-ci.org/[ACCOUNT]/[REPOSITORY].svg?branch=master)](https://travis-ci.org/[ACCOUNT]/[REPOSITORY])

Agradecimentos

Construído com a fantástica biblioteca Fonttools Ufolib, onde a maioria do trabalho de validação de OVNIs foi realizada!

Licença

MIT Licença