Introduction
The AboutCode Toolkit and ABOUT files provide a simple way to document the origin, license, usage and other important or interesting information about third-party software components that you use in your project.
You start by storing ABOUT files (a small YAML formatted text file with field/value pairs) side-by-side with each of the third-party software components you use. Each ABOUT file documents origin and license for one software. There are many examples of ABOUT files (valid or invalid) in the testdata/ directory of the whole repository.
The current version of the AboutCode Toolkit can read these ABOUT files so that you can collect and validate the inventory of third-party components that you use.
In addition, this tool is able to generate attribution notices and identify redistributable source code used in your project to help you comply with open source licenses conditions.
This version of the AboutCode Toolkit follows the ABOUT specification version 3.3.2 at: https://aboutcode-toolkit.readthedocs.io/en/latest/specification.html
Build and tests status
Branch |
Linux/macOS |
Windows |
|---|---|---|
Master |
||
Develop |
REQUIREMENTS
The AboutCode Toolkit is tested with Python 3.9 or above only on Linux, Mac and Windows. You will need to install a Python interpreter if you do not have one already installed.
On Linux and Mac, Python is typically pre-installed. To verify which version may be pre-installed, open a terminal and type:
python –version
Note
Debian has decided that distutils is not a core python package, so it is not included in the last versions of debian and debian-based OSes. A solution is to run: sudo apt install python3-distutils
- On Windows or Mac, you can download the latest Python here:
Download the .msi installer for Windows or the .dmg archive for Mac. Open and run the installer using all the default options.
INSTALLATION
- Checkout or download and extract the AboutCode Toolkit from:
- To install all the needed dependencies in a virtualenv, run (on posix):
./configure
- or on windows:
configure
ACTIVATE the VIRTUALENV
- To activate the virtualenv, run (on posix):
source venv/bin/activate
- or on windows:
venv\bin\activate
DEACTIVATE the VIRTUALENV
- To deactivate the virtualenv, run (on both posix and windows):
deactivate
VERSIONING SCHEMA
Starting at AboutCode version 4.0.0, the AboutCode Toolkit will follow SemVer for the versioning schema.
- i.e. MAJOR.MINOR.PATCH format
MAJOR version when making incompatible API changes,
MINOR version when making functionality in a backwards compatible manner, and
PATCH version when making backwards compatible bug fixes.
REFERENCE
See https://aboutcode-toolkit.readthedocs.io/en/latest/ for documentation.
See https://aboutcode-toolkit.readthedocs.io/en/latest/reference.html for reference.
TESTS and DEVELOPMENT
- To install all the needed development dependencies, run (on posix):
./configure –dev
- or on windows:
configure –dev
- To verify that everything works fine you can run the test suite with:
pytest
CLEAN BUILD AND INSTALLED FILES
- To clean the built and installed files, run (on posix):
./configure –clean
- or on windows:
configure –clean
HELP and SUPPORT
If you have a question or find a bug, enter a ticket at:
For issues, you can use:
SOURCE CODE
- The AboutCode Toolkit is available through GitHub. For the latest version visit:
HACKING
We accept pull requests provided under the same license as this tool. You agree to the http://developercertificate.org/
LICENSE
The AboutCode Toolkit is released under the Apache 2.0 license. See (of course) the about.ABOUT file for details.
3 maintainers
Release files for aboutcode-toolkit 11.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aboutcode_toolkit-11.1.1.tar.gz | 410.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aboutcode_toolkit-11.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 480.9 kB
Release files / aboutcode_toolkit-11.1.1.tar.gz
| Download URL | aboutcode_toolkit-11.1.1.tar.gz |
|---|---|
| Size | 410.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
65eccc72699f0940320691d0181628699a3f7e2457d018b7db4b0a645cd0a12c
|
|
BLAKE2b-256 checksum How to use checksums |
38302ac45b1e025bea54d33e34cfce7467edbc37f51807792211788614a2e271
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Release files / aboutcode_toolkit-11.1.1-py3-none-any.whl
| Download URL | aboutcode_toolkit-11.1.1-py3-none-any.whl |
|---|---|
| Size | 70.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bede77e1e8dd051ecb8b4dc56df9a80bb3e7d0922495642ccf2f809a1413a32f
|
|
BLAKE2b-256 checksum How to use checksums |
14eeba139231e3de1287189c2f7940e7e0f8a135421050ff1b4f0145813ae8b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
