Metadata-Version: 2.1
Name: licomp
Version: 0.5.22
Summary: An interface to generalise license compatibility resources
Home-page: https://github.com/hesa/licomp
Author: Henrik Sanklef
Author-email: hesa@sandklef.com
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Legal Industry
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSES/GPL-3.0-or-later.txt
Requires-Dist: PyYaml
Provides-Extra: dev
Requires-Dist: bump2version ~=1.0 ; extra == 'dev'
Requires-Dist: flake8 ~=7.1 ; extra == 'dev'
Requires-Dist: jsonschema ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'

# licomp - License Compatibility

The licomp library provides an interface and code for various license compatibility
resources making them accessible programmatically.

Licomp also provides some basic functionality for such resources to
easily create a command line program.

The licomp resources below can be accessed as a group by:
* [licomp-toolkit](https://github.com/hesa/licomp-toolkit) - (`pip install licomp-toolkit`)

Licomp is used with the following compatibility resources: [licomp-hermione](https://github.com/hesa/licomp-hermione), [licomp-osadl](https://github.com/hesa/licomp-osadl), [licomp-proprietary](https://github.com/hesa/licomp-proprietary), [licomp-reclicense](https://github.com/hesa/licomp-reclicense) and [licomp-dwheeler](https://github.com/hesa/licomp-dwheeler)

<a name="licomp-concepts"></a>
# Licomp basic concepts

Licomp can be used to help determine if a license is compatible with
an outbound license. These compatibility checks needs context which is
often missing. We have tried to organise this context and a way to
provide this to the tool.

## Licomp Context

<a name="licomp-concepts-usecase"></a>
### Usecase

The way you use open source licensed software determines which obligations you trigger. Let's take [GCC](https://gcc.gnu.org/) for example, which is licensed under "[GPL-3.0-or-later](https://www.gnu.org/licenses/gpl-3.0-standalone.html) WITH [GCC-exception-3.1](GCC-exception-3.1)". If you use GCC as a compiler then the output of the compiler, typically your program, is covered by the exception and you distribute your program (the GCC Runtime libraries that comes with GCC) under any license of your choosing. But if you use a snippet from GCC, then the copyleft effect is triggered and you need to license your work under the same license (GPLv3).

The following usecases are supported:

* `library` - you use the licensed component as a library (creating a combined work, a derivative work)
* `compiler` - you use the licensed component as a compiler taking input and producing output (e.g. GCC, Autoconf)
* `snippet` - you use a part of the licensed component's source code from another project, book, web page
* `test` - you use the licensed component for testing your software (e.g. linter, cyclomatic analysis)

<a name="licomp-concepts-provisioning"></a>
### Provisioning

In this context, providioning is the the way you provide the software to your user.

The following types of provisioning are supported:
* `source-code-distribution` - you distribute the licensed component, in source code form
* `binary-distribution` - you distribute the licensed component, in binary (non source code) form
* `local-use` -  you used the licensed component locally (e.g. and editor you use to write software)
* `provide-service` - you provide a service over a REST api. No source is distributed.
* `provide-webui` - you provide a webui which is distributed to the user's browser.

<a name="licomp-concepts-modification"></a>
### Modification

Used for specifying whether or not you have nodified the licensed component.

The following modifications are supported:
* `modified` - you have made modifications to the licensed component
* `unmodified`- you have not made any modifications to the licensed component

# Licomp reply format

See [Licomp Reply Format](https://github.com/hesa/licomp/blob/main/docs/reply-format.md)
