Ceedling
v0.31.1
26 октября 2024 г. ? Ceedling 1.0.0 появится в продаже очень скоро. Предварительные версии доступны уже сейчас. Ознакомьтесь с новым README для повторного введения в Ceedling и ссылками на множество дополнительных ресурсов. В примечаниях к выпуску представлен обзор всего нового, начиная с версии 0.31.1, а также ссылки на подробный журнал изменений и список критических изменений.
Ceedling — это система сборки для проектов C, которая является своего рода расширением системы сборки Ruby Rake (make-ish). Ceedling также упрощает TDD (разработку через тестирование) на языке C за счет интеграции CMock, Unity и CException — трех других замечательных проектов с открытым исходным кодом, без которых вы не можете жить, если создаете потрясающие вещи на языке C. Ceedling также расширяется с помощью удобного механизма плагинов.
Информация о документации и лицензии находится в репозитории в docs/.
Сначала убедитесь, что Ruby установлен в вашей системе (если он еще не установлен). Затем из командной строки:
> gem install 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
Если упаковщик не установлен в вашей системе или у вас возникли проблемы, возможно, вам придется его установить:
> sudo gem install bundler
Если у вас возникли проблемы с запуском упаковщика и вы получили такие сообщения, как « can't find gem bundler (>= 0.a) with executable bundle (Gem::GemNotFoundException) , возможно, вам придется установить другую версию упаковщика. Для этого обратитесь к версии в Gemfile.lock. Ниже приведен пример, основанный на текущем Gemfile.lock:
> sudo gem install bundler -v 1.16.2
Создать проект с Ceedling очень просто. Просто сообщите ceedling имя проекта, и он создаст подкаталог с этим именем и заполнит его структурой каталогов и конфигурацией по умолчанию.
ceedling new YourNewProjectName
Вы можете добавлять файлы в каталоги src и test, и они мгновенно станут частью вашей тестовой сборки. Нужна другая структура? Вы можете немедленно приступить к настройке файла project.yml с учетом нового пути или требований к инструменту.
Вы можете обновить Ceedling до последней версии в любое время, автоматически получив доступ к пакету Unity и CMock, который поставляется вместе с ним.
gem update ceedling
Вы только начинаете работать с Ceedling? Может быть, вы хотите, чтобы ваш проект был установлен вместе с полезной документацией? Без проблем! Вы можете сделать это при создании нового проекта.
ceedling new --docs MyAwesomeProject
Ceedling также может использовать все свои силы в проекте. Это позволяет использовать его, не беспокоясь о внешних зависимостях. Вам не нужно беспокоиться об изменении Ceedling для этого конкретного проекта только потому, что вы обновили свои драгоценные камни... не нужно беспокоиться о том, что изменения в Unity или CMock могут нарушить вашу сборку в будущем. Если вы хотите использовать Ceedling таким образом, сообщите ему, что вам нужна локальная копия, при создании проекта:
ceedling new --local YourNewProjectName
Это установит все Unity, CMock и Ceedling в новую папку с vendor внутри вашего проекта YourNewProjectName . Он по-прежнему создаст для вас простую структуру каталогов с папками src и test .
СЧЕТ!
Если вы хотите принудительно обновить локально установленную версию Ceedling, чтобы она соответствовала вашему последнему драгоценному камню, это легко! Просто введите следующую команду:
ceedling upgrade --local YourNewProjectName
Как и new команда, она вызывается из родительского каталога вашего проекта.
Вы боитесь потерять все локальные изменения, когда это произойдет? Вы можете запретить Ceedling обновлять файл проекта, выдав no_configs .
ceedling upgrade --local --no_configs TheProject
Вы используете Git? Возможно, вы захотите, чтобы Ceedling автоматически создал для вас файл gitignore , добавив --gitignore к вашему new вызову.
УДАЧНОГО ТЕСТИРОВАНИЯ!
