forked from platformio/platformio-core
111 lines
2.8 KiB
ReStructuredText
111 lines
2.8 KiB
ReStructuredText
.. _cmd_ci:
|
|
|
|
platformio ci
|
|
=============
|
|
|
|
.. contents::
|
|
|
|
Usage
|
|
-----
|
|
|
|
.. code-block:: bash
|
|
|
|
platformio ci [OPTIONS] [SRC]
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
:ref:`cmd_ci` command is conceived of as "hot key" for building project with
|
|
arbitrary source code structure. In a nutshell, using ``SRC`` and
|
|
:option:`platformio ci --lib` contents PlatformIO initialises via
|
|
:ref:`cmd_init` new project in :option:`platformio ci --build-dir`
|
|
with the build environments (using :option:`platformio ci --board` or
|
|
:option:`platformio ci --project-conf`) and processes them via :ref:`cmd_run`
|
|
command.
|
|
|
|
For more details as for integration with the popular Continuous Integration
|
|
Systems please follow to :ref:`ci` page.
|
|
|
|
.. note::
|
|
:ref:`cmd_ci` command accepts **multiple** ``SRC`` arguments,
|
|
:option:`platformio ci --lib` and :option:`platformio ci --exclude` options
|
|
which can be a path to directory, file or
|
|
`Glob Pattern <http://en.wikipedia.org/wiki/Glob_(programming)>`_.
|
|
|
|
.. note::
|
|
You can omit ``SRC`` argument and set path (multiple paths are allowed
|
|
denoting with ``:``) to
|
|
``PLATFORMIO_CI_SRC`` `Environment variable <http://en.wikipedia.org/wiki/Environment_variable>`_
|
|
|
|
Options
|
|
-------
|
|
|
|
.. program:: platformio ci
|
|
|
|
.. option::
|
|
-l, --lib
|
|
|
|
Source code which will be copied to ``%build_dir%/lib`` directly.
|
|
|
|
If :option:`platformio ci --lib` is a path to file (not to directory), then
|
|
PlatformIO will create temporary directory within ``%build_dir%/lib`` and copy
|
|
the rest files into it.
|
|
|
|
|
|
.. option::
|
|
--exclude
|
|
|
|
Exclude directories and/-or files from :option:`platformio ci --build-dir`. The
|
|
path must be relative to PlatformIO project within
|
|
:option:`platformio ci --build-dir`.
|
|
|
|
For example, exclude from project ``src`` directory:
|
|
|
|
* ``examples`` folder
|
|
* ``*.h`` files from ``foo`` folder
|
|
|
|
.. code-block:: bash
|
|
|
|
platformio ci --exclude=src/examples --exclude=src/foo/*.h [SRC]
|
|
|
|
.. option::
|
|
-b, --board
|
|
|
|
Build project with automatically pre-generated environments based on board
|
|
settings.
|
|
|
|
For more details please look into :option:`platformio init --board`.
|
|
|
|
.. option::
|
|
--build-dir
|
|
|
|
Path to directory where PlatformIO will initialise new project. By default it's
|
|
temporary directory within your operation system.
|
|
|
|
.. note::
|
|
|
|
This directory will be removed at the end of build process. If you want to
|
|
keep it, please use :option:`platformio ci --keep-build-dir`.
|
|
|
|
.. option::
|
|
--keep-build-dir
|
|
|
|
Don't remove :option:`platformio ci --build-dir` after build process.
|
|
|
|
.. option::
|
|
--project-conf
|
|
|
|
Buid project using pre-configured :ref:`projectconf`.
|
|
|
|
.. option::
|
|
-v, --verbose
|
|
|
|
Shows details about the results of processing environments. More details
|
|
:option:`platformio run --verbose`
|
|
|
|
Examples
|
|
--------
|
|
|
|
For the examples please follow to :ref:`ci` page.
|