Metadata-Version: 2.1
Name: east-tool
Version: 0.10.1
Summary: Tool built on top of West for managing nRF Connect SDK projects.
Author-email: Marko Sagadin <marko.sagadin42@gmail.com>
License: MIT License
        
        Copyright (c) [year] [fullname]
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/IRNAS/irnas-east-software
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich (==12.5.1)
Requires-Dist: click (==8.1.3)
Requires-Dist: rich-click (==1.5.2)
Requires-Dist: requests (==2.28.1)
Requires-Dist: PyYAML (==6.0)
Requires-Dist: pykwalify (==1.8.0)
Provides-Extra: dev
Requires-Dist: black (==23.1.0) ; extra == 'dev'
Requires-Dist: isort (==5.12.0) ; extra == 'dev'
Requires-Dist: flake8 (==5.0.4) ; extra == 'dev'
Requires-Dist: pytest (==7.1.3) ; extra == 'dev'
Requires-Dist: pytest-mock (==3.10.0) ; extra == 'dev'
Requires-Dist: build (==0.8.0) ; extra == 'dev'
Requires-Dist: twine (==4.0.1) ; extra == 'dev'
Requires-Dist: setuptools-scm (==7.0.5) ; extra == 'dev'
Requires-Dist: tox (==3.26.0) ; extra == 'dev'

# East - tool for building NCS/Zephyr applications

East is a command line meta-tool, useful for creating, managing, and deploying
[Zephyr] or [nRF Connect SDK] (NCS) projects.

[zephyr]: https://docs.zephyrproject.org/latest/
[nrf connect sdk]:
  https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/introduction.html

It is built on top of Zephyr's RTOS meta-tool [West] and Nordic's [nRF Connect
Toolchain Manager].

[west]: https://github.com/zephyrproject-rtos/west
[nrf connect toolchain manager]:
  https://github.com/NordicSemiconductor/pc-nrfconnect-toolchain-manager

## Reasoning behind East

There are several reasons why someone would like to create yet another tool on
top of `west`:

- Working on several projects at once means using different versions of the NCS
  repository and different versions of the toolchain. Managing these differences
  is not a trivial task.
- There is no reproducible build guarantee between the developer's machines.
  Slight differences between tool versions can manifest into hard-to-find bugs.
- Creating GitHub releases manually takes ages as you have to run the build
  process for every combination of the board, application, build variant, etc.
  and properly rename the release binary. The release procedure gets longer with
  every addition of new hardware and build variation option.

East automates the above tasks and tries to make the developer more productive.

## Key features

- Automated detection and installation of tooling required for NCS projects.
- Common `west` commands used for the development, such as `build`, `flash`,
  etc.
- Sandboxed development environment, thanks to the nRF Connect Toolchain
  Manager, every `build`, `flash`, etc. command runs inside of its toolchain
  environment.
- Automated process of generating release artefacts for your entire project, no
  matter the number of applications, samples or boards.
- Support for build types, which is integrated into the usual build process.
- RTT utility commands to connect and see the RTT stream.

## Documentation

`docs` directory contains several markdown documents about East:

- [Getting stared] - Quickly setup an example project and get it building with
  East.
- [How East works] - How East works under the hood and what to expect from it.
- [Configuration] - How to configure build types and release procedure via
  `east.yml` file.
- [Development guide] - How to setup development environment for working on
  East.

[getting stared]: docs/getting_started.md
[how east works]: docs/how_east_works.md
[configuration]: docs/configuration.md
[development guide]: docs/development_guide.md
