<!--
Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
SPDX-License-Identifier: Apache-2.0
-->
# Automation Scripts for CI/CD
[](https://armmbed.github.io/continuous-delivery-scripts)
[](https://pypi.org/project/continuous-delivery-scripts/)
[](https://pypi.org/project/continuous-delivery-scripts/)
[](https://pypi.org/project/continuous-delivery-scripts/)
[](https://pepy.tech/project/continuous-delivery-scripts)
[](https://github.com/ARMmbed/continuous-delivery-scripts/blob/master/LICENSE)
[](https://armmbed.github.io/continuous-delivery-scripts/third_party_IP_report.html)
[](https://github.com/ARMmbed/continuous-delivery-scripts/actions/workflows/ci.yml)
[](https://codecov.io/gh/ARMmbed/continuous-delivery-scripts)
[](https://codeclimate.com/github/ARMmbed/continuous-delivery-scripts/maintainability)
## Overview
Project initially forked from [ARMmbed/mbed-tools-ci-scripts](https://github.com/ARMmbed/continuous-delivery-scripts) but modified so that it can be used for any projects and any languages.
Continuous Delivery scripts for any projects:
- Automated release flows (i.e. changelog generation, git tags, versioning)
- third party IP auditing and reporting
## Releases
For release notes and a history of changes of all **production** releases, please see the following:
- [Changelog](https://github.com/ARMmbed/continuous-delivery-scripts/blob/master/CHANGELOG.md)
For a the list of all available versions please, please see the:
- [PyPI Release History](https://pypi.org/project/continuous-delivery-scripts/#history)
## Versioning
The version scheme used follows [PEP440](https://www.python.org/dev/peps/pep-0440/) and
[Semantic Versioning](https://semver.org/). For production quality releases the version will look as follows:
- `<major>.<minor>.<patch>`
Beta releases are used to give early access to new functionality, for testing and to get feedback on experimental
features. As such these releases may not be stable and should not be used for production. Additionally any interfaces
introduced in a beta release may be removed or changed without notice. For **beta** releases the version will look as
follows:
- `<major>.<minor>.<patch>-beta.<pre-release-number>`
## Installation
It is recommended that a virtual environment such as [Pipenv](https://github.com/pypa/pipenv/blob/master/README.md) is
used for all installations to avoid Python dependency conflicts.
To install the most recent production quality release use:
```
pip install continuous-delivery-scripts
```
To install a specific release:
```
pip install continuous-delivery-scripts==<version>
```
## Usage & Documentation
Code documentation is available for the most recent
production release here:
- [GitHub Pages](https://armmbed.github.io/continuous-delivery-scripts)
The package follows the [**Unix tools philosophy**](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/c1089.htm):
> The tools philosophy was to have small programs to accomplish a particular task instead of trying to develop large monolithic programs to do a large number of tasks. To accomplish more complex tasks, tools would simply be connected together, using pipes.
Therefore, it installs the following tools which can be used anywhere within a project/repository comprising a pyproject.toml file such as the [one defining this project](./pyproject.toml):
* `cd-assert-news`: Asserts that the PR/Branch contains a news file describing the changes introduced
* `cd-determine-version`: Returns the version of the tool
* `cd-generate-news`: Generates a changelog file based on the news files present in the repository
* `cd-get-config`: Returns project configuration values
* `cd-tag-and-release`: Releases the project (Language specific actions are run, See [plugins](./continuous_delivery_scripts/plugins))
* `cd-create-news-file`: Generates a news file
* `cd-generate-docs`: Generates project Code documentation which can then be rendered by GitHub pages (See [docs folder](./docs))
* `cd-generate-spdx`: Generates SPDX documents for the project (3rd party IP reporting/ OpenChain)
* `cd-license-files`: Updates the Licence header and copyright to all the source code files
## Project Structure
The follow described the major aspects of the project structure:
- `.github` - CI and GitHub configuration files.
- `docs/` - Interface definition and usage documentation.
- `examples/` - Usage examples.
- `continuous-delivery-scripts/` - Python source files.
- `news/` - Collection of news files for unreleased changes.
- `tests/` - Unit and integration tests.
## Getting Help
- For interface definition and usage documentation, please see [GitHub Pages](https://armmbed.github.io/continuous-delivery-scripts).
- For a list of known issues and possible workarounds, please see [Known Issues](./KNOWN_ISSUES.md).
- To raise a defect or enhancement please use [GitHub Issues](https://github.com/ARMmbed/continuous-delivery-scripts/issues).
## Contributing
- We are committed to fostering a welcoming community, please see our
[Code of Conduct](./CODE_OF_CONDUCT.md) for more information.
- For ways to contribute to the project, please see the [Contributions Guidelines](./CONTRIBUTING.md)
- For a technical introduction into developing this package, please see the [Development Guide](./DEVELOPMENT.md)
Raw data
{
"_id": null,
"home_page": "https://github.com/ARMmbed/continuous-delivery-scripts",
"name": "continuous-delivery-scripts",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4",
"maintainer_email": "",
"keywords": "Arm Tools CI CD Continuous Delivery Scripts Automation",
"author": "CMSIS team",
"author_email": "adrien.cabarbaye@arm.com",
"download_url": "https://files.pythonhosted.org/packages/9d/b6/20a5d1c766875b0927fe29e5fe43bce442c25e8cca2f8b8347339ed16ced/continuous-delivery-scripts-3.0.7.tar.gz",
"platform": null,
"description": "<!--\nCopyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.\nSPDX-License-Identifier: Apache-2.0\n-->\n# Automation Scripts for CI/CD\n\n\n[](https://armmbed.github.io/continuous-delivery-scripts)\n[](https://pypi.org/project/continuous-delivery-scripts/)\n[](https://pypi.org/project/continuous-delivery-scripts/)\n[](https://pypi.org/project/continuous-delivery-scripts/)\n[](https://pepy.tech/project/continuous-delivery-scripts)\n\n[](https://github.com/ARMmbed/continuous-delivery-scripts/blob/master/LICENSE)\n[](https://armmbed.github.io/continuous-delivery-scripts/third_party_IP_report.html)\n\n[](https://github.com/ARMmbed/continuous-delivery-scripts/actions/workflows/ci.yml)\n\n[](https://codecov.io/gh/ARMmbed/continuous-delivery-scripts)\n[](https://codeclimate.com/github/ARMmbed/continuous-delivery-scripts/maintainability)\n\n## Overview\n\nProject initially forked from [ARMmbed/mbed-tools-ci-scripts](https://github.com/ARMmbed/continuous-delivery-scripts) but modified so that it can be used for any projects and any languages.\n\nContinuous Delivery scripts for any projects:\n- Automated release flows (i.e. changelog generation, git tags, versioning)\n- third party IP auditing and reporting\n\n\n## Releases\n\nFor release notes and a history of changes of all **production** releases, please see the following:\n\n- [Changelog](https://github.com/ARMmbed/continuous-delivery-scripts/blob/master/CHANGELOG.md)\n\nFor a the list of all available versions please, please see the:\n\n- [PyPI Release History](https://pypi.org/project/continuous-delivery-scripts/#history)\n\n## Versioning\n\nThe version scheme used follows [PEP440](https://www.python.org/dev/peps/pep-0440/) and \n[Semantic Versioning](https://semver.org/). For production quality releases the version will look as follows:\n\n- `<major>.<minor>.<patch>`\n\nBeta releases are used to give early access to new functionality, for testing and to get feedback on experimental \nfeatures. As such these releases may not be stable and should not be used for production. Additionally any interfaces\nintroduced in a beta release may be removed or changed without notice. For **beta** releases the version will look as\nfollows:\n\n- `<major>.<minor>.<patch>-beta.<pre-release-number>`\n\n## Installation\n\nIt is recommended that a virtual environment such as [Pipenv](https://github.com/pypa/pipenv/blob/master/README.md) is\nused for all installations to avoid Python dependency conflicts.\n\nTo install the most recent production quality release use:\n\n```\npip install continuous-delivery-scripts\n```\n\nTo install a specific release:\n\n```\npip install continuous-delivery-scripts==<version>\n```\n\n## Usage & Documentation\n\nCode documentation is available for the most recent\nproduction release here:\n\n- [GitHub Pages](https://armmbed.github.io/continuous-delivery-scripts)\n\nThe package follows the [**Unix tools philosophy**](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/c1089.htm):\n\n> The tools philosophy was to have small programs to accomplish a particular task instead of trying to develop large monolithic programs to do a large number of tasks. To accomplish more complex tasks, tools would simply be connected together, using pipes.\n\nTherefore, it installs the following tools which can be used anywhere within a project/repository comprising a pyproject.toml file such as the [one defining this project](./pyproject.toml):\n* `cd-assert-news`: Asserts that the PR/Branch contains a news file describing the changes introduced\n* `cd-determine-version`: Returns the version of the tool\n* `cd-generate-news`: Generates a changelog file based on the news files present in the repository\n* `cd-get-config`: Returns project configuration values\n* `cd-tag-and-release`: Releases the project (Language specific actions are run, See [plugins](./continuous_delivery_scripts/plugins))\n* `cd-create-news-file`: Generates a news file\n* `cd-generate-docs`: Generates project Code documentation which can then be rendered by GitHub pages (See [docs folder](./docs))\n* `cd-generate-spdx`: Generates SPDX documents for the project (3rd party IP reporting/ OpenChain)\n* `cd-license-files`: Updates the Licence header and copyright to all the source code files\n\n## Project Structure\n\nThe follow described the major aspects of the project structure:\n\n- `.github` - CI and GitHub configuration files.\n- `docs/` - Interface definition and usage documentation.\n- `examples/` - Usage examples.\n- `continuous-delivery-scripts/` - Python source files.\n- `news/` - Collection of news files for unreleased changes.\n- `tests/` - Unit and integration tests.\n\n## Getting Help\n\n- For interface definition and usage documentation, please see [GitHub Pages](https://armmbed.github.io/continuous-delivery-scripts).\n- For a list of known issues and possible workarounds, please see [Known Issues](./KNOWN_ISSUES.md).\n- To raise a defect or enhancement please use [GitHub Issues](https://github.com/ARMmbed/continuous-delivery-scripts/issues).\n\n## Contributing\n\n- We are committed to fostering a welcoming community, please see our\n [Code of Conduct](./CODE_OF_CONDUCT.md) for more information.\n- For ways to contribute to the project, please see the [Contributions Guidelines](./CONTRIBUTING.md)\n- For a technical introduction into developing this package, please see the [Development Guide](./DEVELOPMENT.md)\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Continuous Delivery scripts to increase automation",
"version": "3.0.7",
"split_keywords": [
"arm",
"tools",
"ci",
"cd",
"continuous",
"delivery",
"scripts",
"automation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f88f6ba128e281047e6587ad1feabf9945d90caeb9619440acb378ef35182ee0",
"md5": "c9fb2bedc6e245621f4903e0963ce5c8",
"sha256": "400c23d8925bbe229835c6234a8f05ce013ce5e3fdc37b5dfa8a451751fa4e68"
},
"downloads": -1,
"filename": "continuous_delivery_scripts-3.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c9fb2bedc6e245621f4903e0963ce5c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4",
"size": 83544,
"upload_time": "2023-01-25T19:09:20",
"upload_time_iso_8601": "2023-01-25T19:09:20.746817Z",
"url": "https://files.pythonhosted.org/packages/f8/8f/6ba128e281047e6587ad1feabf9945d90caeb9619440acb378ef35182ee0/continuous_delivery_scripts-3.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9db620a5d1c766875b0927fe29e5fe43bce442c25e8cca2f8b8347339ed16ced",
"md5": "2cd2321bd04d6f245a4870f8aec28127",
"sha256": "26d22b037d95bea1174c30610c2beb40c897e1f3ebcae69b274644f6d38c7f8f"
},
"downloads": -1,
"filename": "continuous-delivery-scripts-3.0.7.tar.gz",
"has_sig": false,
"md5_digest": "2cd2321bd04d6f245a4870f8aec28127",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4",
"size": 99739,
"upload_time": "2023-01-25T19:09:22",
"upload_time_iso_8601": "2023-01-25T19:09:22.263543Z",
"url": "https://files.pythonhosted.org/packages/9d/b6/20a5d1c766875b0927fe29e5fe43bce442c25e8cca2f8b8347339ed16ced/continuous-delivery-scripts-3.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-25 19:09:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "ARMmbed",
"github_project": "continuous-delivery-scripts",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "continuous-delivery-scripts"
}
JSON
