API for checking REUSE compliance of a git project
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Sebastian Crane eb970f21c3 Change submodule URL to use HTTPS rather than SSH 10 months ago
.reuse Make HTML pages look better (#26) 3 years ago
LICENSES fix REUSE compliance 1 year ago
api-worker@cf0392dc51 update api-worker 2 years ago
doc Allow to run full API locally (#39) 2 years ago
forms@b4a5ec4ff2 Allow to run full API locally (#39) 2 years ago
reuse_api re-format code with black 1 year ago
tests Make compliant 3 years ago
.dockerignore Replace SPDX-Copyright with SPDX-FileCopyrightText 3 years ago
.drone.yml update drone syntax 1 year ago
.env.default List and count compliant REUSE projects (#42) 2 years ago
.env.default.license Allow to run full API locally (#39) 2 years ago
.gitignore switch to debian base image, and bump dependencies 1 year ago
.gitmodules Change submodule URL to use HTTPS rather than SSH 10 months ago
.gitmodules.license Allow to run full API locally (#39) 2 years ago
Dockerfile update drone syntax 1 year ago
MANIFEST.in Replace SPDX-Copyright with SPDX-FileCopyrightText 3 years ago
Makefile Replace SPDX-Copyright with SPDX-FileCopyrightText 3 years ago
Pipfile switch to debian base image, and bump dependencies 1 year ago
Pipfile.lock switch to debian base image, and bump dependencies 1 year ago
Pipfile.lock.license Make compliant 3 years ago
README.md Verbose README, delete plan 3 years ago
docker-compose.dev.yml Fix multiple enqueue (#40) 2 years ago
docker-compose.yml update drone syntax 1 year ago
pyproject.toml Replace SPDX-Copyright with SPDX-FileCopyrightText 3 years ago
renovate.json Add renovate.json 1 year ago
renovate.json.license make REUSE compliant 1 year ago
setup.py Replace SPDX-Copyright with SPDX-FileCopyrightText 3 years ago

README.md

REUSE API

Build Status REUSE compliant

The REUSE API checks repositories for their compliance with the REUSE best practices. It basically runs the lint command of the REUSE helper tool for the default branch of a project.

REUSE offers many tools and methods to support developers in making their licensing more clear and simple. This API is an additional component and enables other users to see a project's REUSE status transparently.

This repository contains the web part for all user interaction. The parts needed for the external server performing the checks are hosted in the api-worker repository.

This service is accessible via api.reuse.software, but interested users can set up their own instance.

Features

  • Users can register any public Git repository with this API.
  • The API runs the linter on each registered project.
  • Re-check projects if they have been updated (new commit).
  • Informative information page for each registered project.
  • Offer a live badge indicating the REUSE compliance status.
  • Offer a JSON for parsing the current REUSE status.

Background

Copyright and licensing is difficult, especially when reusing software from different projects that are released under various different licenses. REUSE was started by the Free Software Foundation Europe (FSFE) to provide a set of recommendations to make licensing your Free Software projects easier. Not only do these recommendations make it easier for you to declare the licenses under which your works are released, but they also make it easier for a computer to understand how your project is licensed.

As a short summary, the recommendations are threefold:

  1. Choose and provide licenses
  2. Add copyright and licensing information to each file
  3. Confirm REUSE compliance

You are recommended to read the recommendations in full for more details.

Install

Please refer to the /doc directory of this project for information on how to install and configure the REUSE API.

Maintainers

Contribute

Any pull requests or suggestions are welcome at https://git.fsfe.org/reuse/api or via e-mail to one of the maintainers. General inquiries can be sent to the REUSE mailing list.

Information on how to develop and hack around with this project can be found in the file /doc/hack.md.

License

Copyright (C) 2019 Free Software Foundation Europe e.V.

This work is licensed under multiple licences. Because keeping this section up-to-date is challenging, here is a brief summary as of September 2019:

  • All original source code is licensed under GPL-3.0-or-later.
  • All documentation and most graphical files are licensed under CC-BY-SA-4.0.
  • Some borrowed HTML code from the REUSE website is licenses under MIT.
  • Other external web elements like libraries and fonts are licenses under Apache-2.0, MIT, OFL-1.1.
  • Most configuration files are licenses under CC0-1.0.

For more accurate information, check the individual files.