Esta ação do GitHub instala a ferramenta de garantia de qualidade do projeto Fonttools/FontBakery e executa a ferramenta em um FilePath especificado pelo usuário como parte de um pipeline de teste de integração contínua remota. A ação requer um ambiente python v3.8+ corredor.
Crie um arquivo de configuração do GitHub formatado YAML no caminho do diretório .github/workflows em seu repositório de origem. Revise a documentação das ações do GitHub para obter instruções detalhadas sobre a sintaxe do arquivo de configuração.
Observação : essas etapas exigem que as fontes sejam incorporadas no seu fluxo de trabalho de CI antes que as etapas de teste de FontBakery sejam executadas ou estejam sob controle de versão Git e empurradas para um caminho de diretório de repositório de origem remoto. O exemplo abaixo assume uma compilação baseada em makefile que usa o padrão, make alvo. Personalize o comando Build com a abordagem que você usa em seu projeto.
name : Font Bakery QA Tests
on : [push, pull_request]
jobs :
fontbakery :
runs-on : ubuntu-latest
name : Font Bakery QA tests # Customize to edit the string in your GitHub CI UI
steps :
- name : Check out source repository
uses : actions/checkout@v3
- name : Set up Python environment
uses : actions/setup-python@v4
with :
python-version : " 3.11 " # supports any Py3.6+ version available in Actions
- name : Build fonts
run : make # enter your build shell commands here
- name : fontbakery TTF checks
uses : f-actions/font-bakery@v3
with :
subcmd : " check-universal " # fontbakery sub-command
args : " --loglevel WARN " # optional, arguments to fontbakery
path : " path/to/*.ttf " # font path relative to root of repository
version : " latest " # optional, latest PyPI release is default
- name : fontbakery OTF checks
uses : f-actions/font-bakery@v3
with :
subcmd : " check-universal " # fontbakery sub-command
args : " --loglevel WARN " # optional, arguments to fontbakery
path : " path/to/*.otf " # font path relative to root of repository
version : " latest " # optional, latest PyPI release is defaultConsulte a seção de entradas abaixo para obter detalhes sobre entradas padrão e configurações opcionais.
Definir a ação com as seguintes configurações:
argsOpcional Os argumentos que não são de caminho para o sub-comando executável da FontBakery. Por exemplo, este é um local em que o nível de log pode ser definido. A configuração abaixo limita os relatórios aos níveis de log de aviso e superior:
args: "--loglevel WARN"
Veja os menus da FontBakery para obter detalhes sobre as opções disponíveis.
pathObrigatório o caminho para o (s) arquivo (s) da fonte. Você pode usar curingas nessa definição de caminho.
path: "path/to/*.ttf"
subcmdObrigatório o subcomando de fontbakery. Isso especifica o perfil de teste que é executado em suas fontes.
subcmd: "check-universal"
Consulte fontbakery --help ou a documentação da FontBakery para obter detalhes adicionais.
version Observação : se você definir instalações do FontBakery <V0.9.0 Com este campo de entrada, você deve permanecer na ramificação v2 desta ação do GitHub. Introduzimos alterações incompatíveis com versões anteriores que não funcionarão com a instalação das versões FontBakery <V.0.9.0 a partir da liberação da ação v3.0.0 .
Opcional a versão FontBakery que deve ser usada para teste. Isso suporta liberações de Pypi e instalações de ramificação mestre do repositório de fonte direta.
Padrão: "mais recente" = versão mais recente do Pypi.
Opções:
"0.7.28" (esta abordagem atinge o pacote FontBakery em um número de versão de lançamento) Nenhum
Licença Apache, v2.0