Ceedling

Ceedling

26 de outubro de 2024 ? Ceedling 1.0.0 será lançado em breve. Versões de pré-lançamento já estão disponíveis. Veja o novo README para uma reintrodução ao Ceedling e links para uma variedade de recursos complementares. Consulte as Notas de Lançamento para uma visão geral de tudo o que há de novo desde 0.31.1, além de links para um Changelog detalhado e uma lista de alterações recentes.

Ceedling é um sistema de compilação para projetos C que é uma espécie de extensão do sistema de compilação Rake (make-ish) do Ruby. Ceedling também facilita o TDD (Desenvolvimento Orientado a Testes) em C, integrando CMock, Unity e CException - três outros projetos incríveis de código aberto sem os quais você não pode viver se estiver criando coisas incríveis na linguagem C. Ceedling também é extensível com um prático mecanismo de plugin.

Documentação de uso

A documentação e as informações de licença existem no repositório em docs/

Começando

Primeiro certifique-se de que Ruby esteja instalado em seu sistema (se ainda não estiver). Então, em um prompt de comando:

 > gem install ceedling

(Instalação alternativa para aqueles que planejam ser desenvolvedores Ceedling)

 > git clone --recursive https://github.com/throwtheswitch/ceedling.git
> cd ceedling
> bundle install # Ensures you have all RubyGems needed
> git submodule update --init --recursive # Updates all submodules
> bundle exec rake # Run all Ceedling library tests

Se o bundler não estiver instalado em seu sistema ou você tiver problemas, talvez seja necessário instalá-lo:

 > sudo gem install bundler

Se você tiver problemas ao executar o bundler e receber mensagens como esta can't find gem bundler (>= 0.a) with executable bundle (Gem::GemNotFoundException) , pode ser necessário instalar uma versão diferente do bundler. Para isso, consulte a versão no Gemfile.lock. Um exemplo baseado no Gemfile.lock atual é o seguinte:

 > sudo gem install bundler -v 1.16.2

Criando um projeto

Criar um projeto com Ceedling é fácil. Basta informar ao ceedling o nome do projeto e ele criará um subdiretório chamado esse nome e o preencherá com uma estrutura e configuração de diretório padrão.

 ceedling new YourNewProjectName

Você pode adicionar arquivos aos diretórios src e test e eles se tornarão instantaneamente parte de sua compilação de teste. Precisa de uma estrutura diferente? Você pode começar a ajustar o arquivo project.yml imediatamente com seu novo caminho ou requisitos de ferramenta.

Você pode atualizar para a versão mais recente do Ceedling a qualquer momento, obtendo automaticamente acesso ao pacote Unity e CMock que o acompanha.

 gem update ceedling

Documentação

Você está apenas começando com Ceedling? Talvez você queira que seu projeto seja instalado com alguma de sua documentação útil? Sem problemas! Você pode fazer isso ao criar um novo projeto.

 ceedling new --docs MyAwesomeProject

Unindo suas ferramentas e projeto

Ceedling também pode implantar toda a sua coragem no projeto. Isso permite que ele seja usado sem se preocupar com dependências externas. Você não precisa se preocupar com mudanças no Ceedling para este projeto específico só porque você atualizou suas gemas... não precisa se preocupar com mudanças no Unity ou CMock quebrando sua construção no futuro. Se você quiser usar o Ceedling desta forma, diga que deseja uma cópia local ao criar seu projeto:

 ceedling new --local YourNewProjectName

Isso instalará todo o Unity, CMock e Ceedling em uma nova pasta chamada vendor dentro do seu projeto YourNewProjectName . Ele ainda criará uma estrutura de diretório simples para você com pastas src e test .

PONTUAÇÃO!

Se você quiser forçar uma versão instalada localmente do Ceedling a atualizar para corresponder à sua jóia mais recente mais tarde, é fácil! Basta emitir o seguinte comando:

 ceedling upgrade --local YourNewProjectName

Assim como o new comando, ele é chamado no diretório pai do seu projeto.

Você tem medo de perder todas as alterações locais quando isso acontecer? Você pode impedir que Ceedling atualize seu arquivo de projeto emitindo no_configs .

 ceedling upgrade --local --no_configs TheProject

Integração Git

Você está usando Git? Você pode querer que Ceedling crie automaticamente um arquivo gitignore para você adicionando --gitignore à sua new chamada.

FELIZ TESTE!