Google Git
Sign in
android / platform / external / licenseclassifier / 55ef64058a75ca6b4ce488c492aa31f7652fcc46
commit55ef64058a75ca6b4ce488c492aa31f7652fcc46[log] [tgz]
authorSadaf Ebrahimi <[email protected]>Fri Mar 03 18:14:06 2023 +0000
committerAutomerger Merge Worker <[email protected]>Fri Mar 03 18:14:06 2023 +0000
treea921d9a97dcebbbeb9dad38e653c20dd0978e835
parent20437486b256b1f014a528899fc7eceecd0ea259 [diff]
parentc8aa5c2c8d1ccdc1e33e19a9ce6fae741bf4be31 [diff]
Upgrade licenseclassifier to v2.2.0 am: 8695ad8fe0 am: 7fa07cd774 am: 34858a172f am: c8aa5c2c8d

Original change: https://android-review.googlesource.com/c/platform/external/licenseclassifier/+/2467502

Change-Id: I319185c2cca6442f6f71fdc63f19c4df6191d859
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: a921d9a97dcebbbeb9dad38e653c20dd0978e835
  1. commentparser/
  2. internal/
  3. licenses/
  4. serializer/
  5. stringclassifier/
  6. tools/
  7. v2/
  8. .travis.yml
  9. CHANGELOG
  10. classifier.go
  11. classifier_test.go
  12. CONTRIBUTING.md
  13. file_system_resources.go
  14. forbidden.go
  15. go.mod
  16. go.sum
  17. LICENSE
  18. license_type.go
  19. METADATA
  20. README.md
README.md

License Classifier

Build status

Introduction

The license classifier is a library and set of tools that can analyze text to determine what type of license it contains. It searches for license texts in a file and compares them to an archive of known licenses. These files could be, e.g., LICENSE files with a single or multiple licenses in it, or source code files with the license text in a comment.

A “confidence level” is associated with each result indicating how close the match was. A confidence level of 1.0 indicates an exact match, while a confidence level of 0.0 indicates that no license was able to match the text.

Adding a new license

Adding a new license is straight-forward:

  1. Create a file in licenses/.

    • The filename should be the name of the license or its abbreviation. If the license is an Open Source license, use the appropriate identifier specified at https://spdx.org/licenses/.
    • If the license is the “header” version of the license, append the suffix “.header” to it. See licenses/README.md for more details.

  2. Add the license name to the list in license_type.go.

  3. Regenerate the licenses.db file by running the license serializer:

    $ license_serializer -output licenseclassifier/licenses

  4. Create and run appropriate tests to verify that the license is indeed present.

Tools

Identify license

identify_license is a command line tool that can identify the license(s) within a file.

$ identify_license LICENSE
LICENSE: GPL-2.0 (confidence: 1, offset: 0, extent: 14794)
LICENSE: LGPL-2.1 (confidence: 1, offset: 18366, extent: 23829)
LICENSE: MIT (confidence: 1, offset: 17255, extent: 1059)

License serializer

The license_serializer tool regenerates the licenses.db archive. The archive contains preprocessed license texts for quicker comparisons against unknown texts.

$ license_serializer -output licenseclassifier/licenses

This is not an official Google product (experimental or otherwise), it is just code that happens to be owned by Google.