license-normaliser 0.1__tar.gz

license_normaliser-0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artur Barseghyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

license_normaliser-0.1/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: license-normaliser
+Version: 0.1
+Summary: Comprehensive license normalization with a three-level hierarchy.
+Author-email: Artur Barseghyan <artur.barseghyan@gmail.com>
+Maintainer-email: Artur Barseghyan <artur.barseghyan@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/barseghyanartur/license-normaliser/
+Project-URL: Repository, https://github.com/barseghyanartur/license-normaliser/
+Project-URL: Issues, https://github.com/barseghyanartur/license-normaliser/issues
+Keywords: license,normalization,spdx,creative commons,open source
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Provides-Extra: all
+Requires-Dist: license-normaliser[build,dev,docs,test]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: detect-secrets; extra == "dev"
+Requires-Dist: doc8; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: uv; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-codeblock; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-autobuild; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
+Requires-Dist: sphinx-no-pragma; extra == "docs"
+Requires-Dist: sphinx-markdown-builder; extra == "docs"
+Requires-Dist: sphinx-llms-txt-link; extra == "docs"
+Requires-Dist: sphinx-source-tree; extra == "docs"
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+Requires-Dist: wheel; extra == "build"
+Dynamic: license-file
+
+==================
+license-normaliser
+==================
+
+.. image:: https://raw.githubusercontent.com/barseghyanartur/license-normaliser/main/docs/_static/license_normaliser_logo.webp
+   :alt: License Normaliser Logo
+   :align: center
+
+Comprehensive license normalization with a three-level hierarchy.
+
+.. image:: https://img.shields.io/pypi/v/license-normaliser.svg
+   :target: https://pypi.python.org/pypi/license-normaliser
+   :alt: PyPI Version
+
+.. image:: https://img.shields.io/pypi/pyversions/license-normaliser.svg
+   :target: https://pypi.python.org/pypi/license-normaliser/
+   :alt: Supported Python versions
+
+.. image:: https://github.com/barseghyanartur/license-normaliser/actions/workflows/test.yml/badge.svg?branch=main
+   :target: https://github.com/barseghyanartur/license-normaliser/actions
+   :alt: Build Status
+
+.. image:: https://readthedocs.org/projects/license-normaliser/badge/?version=latest
+    :target: http://license-normaliser.readthedocs.io
+    :alt: Documentation Status
+
+.. image:: https://img.shields.io/badge/license-MIT-blue.svg
+   :target: https://github.com/barseghyanartur/license-normaliser/#License
+   :alt: MIT
+
+``license-normaliser`` is a comprehensive license normalization library that
+maps any license representation (SPDX tokens, URLs, prose descriptions) to a
+canonical three-level hierarchy.
+
+Features
+========
+
+- **Three-level hierarchy** - LicenseFamily → LicenseName → LicenseVersion
+- **Wide format support** - SPDX tokens, URLs, prose descriptions
+- **Creative Commons support** - Full CC family with versions and IGO variants
+- **Publisher-specific licenses** - Elsevier, Wiley, Springer, ACS, and more
+- **Caching** - LRU caching for performance
+- **CLI** - Command-line interface for quick normalization
+
+Hierarchy
+=========
+
+The library uses a three-level hierarchy:
+
+1. **LicenseFamily** - broad bucket: ``"cc"``, ``"osi"``, ``"copyleft"``,
+   ``"publisher-tdm"``, ...
+2. **LicenseName** - version-free: ``"cc-by"``, ``"cc-by-nc-nd"``, ``"mit"``,
+   ``"wiley-tdm"``
+3. **LicenseVersion** - fully resolved: ``"cc-by-3.0"``, ``"cc-by-nc-nd-4.0"``
+
+Installation
+============
+
+With ``uv``:
+
+.. code-block:: sh
+
+    uv pip install license-normaliser
+
+Or with ``pip``:
+
+.. code-block:: sh
+
+    pip install license-normaliser
+
+Quick start
+===========
+
+.. code-block:: python
+    :name: test_quick_start
+
+    from license_normaliser import normalise_license
+
+    v = normalise_license("CC BY-NC-ND 4.0")
+    str(v)                 # "cc-by-nc-nd-4.0"  ← LicenseVersion
+    str(v.license)         # "cc-by-nc-nd"      ← LicenseName
+    str(v.license.family)  # "cc"               ← LicenseFamily
+
+Resolution pipeline (first match wins)
+======================================
+
+1. Direct registry lookup (cleaned lowercase key)
+2. Alias table (prose variants, SPDX tokens, mixed-case short-forms)
+3. Exact URL map (http/https, trailing-slash normalised, fragment-aware)
+4. Structural CC URL regex (any creativecommons.org URL not in the map)
+5. Prose keyword scan (full sentences from license documents)
+6. Fallback (key = cleaned string, everything else unknown/None)
+
+CLI usage
+=========
+
+Normalize a single license:
+
+.. code-block:: sh
+
+    license-normaliser normalise "MIT"
+    # Output: mit
+
+    license-normaliser normalise --full "CC BY 4.0"
+    # Output:
+    # Key: cc-by-4.0
+    # URL: https://creativecommons.org/licenses/by/4.0/
+    # License: cc-by
+    # Family: cc
+
+Batch normalize multiple licenses:
+
+.. code-block:: sh
+
+    license-normaliser batch MIT "Apache-2.0" "CC BY 4.0"
+    # Output:
+    # MIT: mit
+    # Apache-2.0: apache-2.0
+    # CC BY 4.0: cc-by-4.0
+
+Testing
+=======
+
+All tests run inside Docker to prevent accidental side effects:
+
+.. code-block:: sh
+
+    make test
+
+To test a specific Python version:
+
+.. code-block:: sh
+
+    make test-env ENV=py312
+
+License
+=======
+
+MIT
+
+Support
+=======
+
+For issues, go to `GitHub <https://github.com/barseghyanartur/license-normaliser/issues>`_.
+
+Author
+======
+
+Artur Barseghyan <artur.barseghyan@gmail.com>

license_normaliser-0.1/README.rst

@@ -0,0 +1,149 @@
+==================
+license-normaliser
+==================
+
+.. image:: https://raw.githubusercontent.com/barseghyanartur/license-normaliser/main/docs/_static/license_normaliser_logo.webp
+   :alt: License Normaliser Logo
+   :align: center
+
+Comprehensive license normalization with a three-level hierarchy.
+
+.. image:: https://img.shields.io/pypi/v/license-normaliser.svg
+   :target: https://pypi.python.org/pypi/license-normaliser
+   :alt: PyPI Version
+
+.. image:: https://img.shields.io/pypi/pyversions/license-normaliser.svg
+   :target: https://pypi.python.org/pypi/license-normaliser/
+   :alt: Supported Python versions
+
+.. image:: https://github.com/barseghyanartur/license-normaliser/actions/workflows/test.yml/badge.svg?branch=main
+   :target: https://github.com/barseghyanartur/license-normaliser/actions
+   :alt: Build Status
+
+.. image:: https://readthedocs.org/projects/license-normaliser/badge/?version=latest
+    :target: http://license-normaliser.readthedocs.io
+    :alt: Documentation Status
+
+.. image:: https://img.shields.io/badge/license-MIT-blue.svg
+   :target: https://github.com/barseghyanartur/license-normaliser/#License
+   :alt: MIT
+
+``license-normaliser`` is a comprehensive license normalization library that
+maps any license representation (SPDX tokens, URLs, prose descriptions) to a
+canonical three-level hierarchy.
+
+Features
+========
+
+- **Three-level hierarchy** - LicenseFamily → LicenseName → LicenseVersion
+- **Wide format support** - SPDX tokens, URLs, prose descriptions
+- **Creative Commons support** - Full CC family with versions and IGO variants
+- **Publisher-specific licenses** - Elsevier, Wiley, Springer, ACS, and more
+- **Caching** - LRU caching for performance
+- **CLI** - Command-line interface for quick normalization
+
+Hierarchy
+=========
+
+The library uses a three-level hierarchy:
+
+1. **LicenseFamily** - broad bucket: ``"cc"``, ``"osi"``, ``"copyleft"``,
+   ``"publisher-tdm"``, ...
+2. **LicenseName** - version-free: ``"cc-by"``, ``"cc-by-nc-nd"``, ``"mit"``,
+   ``"wiley-tdm"``
+3. **LicenseVersion** - fully resolved: ``"cc-by-3.0"``, ``"cc-by-nc-nd-4.0"``
+
+Installation
+============
+
+With ``uv``:
+
+.. code-block:: sh
+
+    uv pip install license-normaliser
+
+Or with ``pip``:
+
+.. code-block:: sh
+
+    pip install license-normaliser
+
+Quick start
+===========
+
+.. code-block:: python
+    :name: test_quick_start
+
+    from license_normaliser import normalise_license
+
+    v = normalise_license("CC BY-NC-ND 4.0")
+    str(v)                 # "cc-by-nc-nd-4.0"  ← LicenseVersion
+    str(v.license)         # "cc-by-nc-nd"      ← LicenseName
+    str(v.license.family)  # "cc"               ← LicenseFamily
+
+Resolution pipeline (first match wins)
+======================================
+
+1. Direct registry lookup (cleaned lowercase key)
+2. Alias table (prose variants, SPDX tokens, mixed-case short-forms)
+3. Exact URL map (http/https, trailing-slash normalised, fragment-aware)
+4. Structural CC URL regex (any creativecommons.org URL not in the map)
+5. Prose keyword scan (full sentences from license documents)
+6. Fallback (key = cleaned string, everything else unknown/None)
+
+CLI usage
+=========
+
+Normalize a single license:
+
+.. code-block:: sh
+
+    license-normaliser normalise "MIT"
+    # Output: mit
+
+    license-normaliser normalise --full "CC BY 4.0"
+    # Output:
+    # Key: cc-by-4.0
+    # URL: https://creativecommons.org/licenses/by/4.0/
+    # License: cc-by
+    # Family: cc
+
+Batch normalize multiple licenses:
+
+.. code-block:: sh
+
+    license-normaliser batch MIT "Apache-2.0" "CC BY 4.0"
+    # Output:
+    # MIT: mit
+    # Apache-2.0: apache-2.0
+    # CC BY 4.0: cc-by-4.0
+
+Testing
+=======
+
+All tests run inside Docker to prevent accidental side effects:
+
+.. code-block:: sh
+
+    make test
+
+To test a specific Python version:
+
+.. code-block:: sh
+
+    make test-env ENV=py312
+
+License
+=======
+
+MIT
+
+Support
+=======
+
+For issues, go to `GitHub <https://github.com/barseghyanartur/license-normaliser/issues>`_.
+
+Author
+======
+
+Artur Barseghyan <artur.barseghyan@gmail.com>

license_normaliser-0.1/pyproject.toml

@@ -0,0 +1,319 @@
+[project]
+name = "license-normaliser"
+description = "Comprehensive license normalization with a three-level hierarchy."
+readme = "README.rst"
+version = "0.1"
+requires-python = ">=3.10"
+dependencies = [
+    "pydantic>=2.0",
+]
+authors = [
+    { name = "Artur Barseghyan", email = "artur.barseghyan@gmail.com" },
+]
+maintainers = [
+    { name = "Artur Barseghyan", email = "artur.barseghyan@gmail.com" },
+]
+license = "MIT"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Programming Language :: Python",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = [
+    "license",
+    "normalization",
+    "spdx",
+    "creative commons",
+    "open source",
+]
+
+[project.scripts]
+license-normaliser = "license_normaliser.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/barseghyanartur/license-normaliser/"
+Repository = "https://github.com/barseghyanartur/license-normaliser/"
+Issues = "https://github.com/barseghyanartur/license-normaliser/issues"
+
+[project.optional-dependencies]
+all = ["license-normaliser[dev,test,docs,build]"]
+dev = [
+    "detect-secrets",
+    "doc8",
+    "ipython",
+    "mypy",
+    "ruff",
+    "uv",
+]
+test = [
+    "pytest",
+    "pytest-cov",
+    "pytest-codeblock",
+]
+docs = [
+    "sphinx",
+    "sphinx-autobuild",
+    "sphinx-rtd-theme>=1.3.0",
+    "sphinx-no-pragma",
+    "sphinx-markdown-builder",
+    "sphinx-llms-txt-link",
+    "sphinx-source-tree",
+]
+build = [
+    "build",
+    "twine",
+    "wheel",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["license_normaliser", "license_normaliser.*"]
+
+[build-system]
+requires = ["setuptools>=41.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.ruff]
+line-length = 88
+lint.select = [
+    "B",
+    "C4",
+    "E",
+    "F",
+    "G",
+    "I",
+    "ISC",
+    "INP",
+    "N",
+    "PERF",
+    "Q",
+    "SIM",
+]
+lint.ignore = [
+    "G004",
+    "ISC003",
+]
+fix = true
+src = ["src/license_normaliser"]
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+    "docs",
+]
+target-version = "py310"
+lint.dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.lint.isort]
+known-first-party = ["license_normaliser"]
+
+[tool.ruff.lint.per-file-ignores]
+"conftest.py" = [
+    "PERF203"
+]
+
+[tool.doc8]
+ignore-path = [
+    "docs/requirements.txt",
+    "src/license_normaliser.egg-info/SOURCES.txt",
+]
+
+[tool.pytest.ini_options]
+addopts = [
+    "-ra",
+    "-vvv",
+    "-q",
+    "--cov=license_normaliser",
+    "--ignore=.tox",
+    "--cov-report=html",
+    "--cov-report=term",
+    "--cov-append",
+    "--capture=no",
+]
+testpaths = [
+    "src/license_normaliser/tests",
+    ".",
+    "**/*.rst",
+    "**/*.md",
+]
+pythonpath = ["src"]
+norecursedirs = [".git", ".tox"]
+
+[tool.coverage.run]
+relative_files = true
+omit = [".tox/*"]
+source = ["license_normaliser"]
+
+[tool.coverage.report]
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    "@overload",
+]
+
+[tool.mypy]
+check_untyped_defs = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_unused_configs = true
+ignore_missing_imports = true
+
+[tool.sphinx-source-tree]
+ignore = [
+    "*.egg-info",
+    "*.py,cover",
+    "*.pyc",
+    "*.pyo",
+    ".DS_Store",
+    ".coverage",
+    ".coverage.*",
+    ".git",
+    ".hg",
+    ".hypothesis",
+    ".idea",
+    ".mypy_cache",
+    ".nox",
+    ".pre-commit-config.yaml",
+    ".pre-commit-hooks.yaml",
+    ".pytest_cache",
+    ".readthedocs.yaml",
+    ".ruff_cache",
+    ".secrets.baseline",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "CHANGELOG.rst",
+    "CODE_OF_CONDUCT.rst",
+    "LICENSE",
+    "SECURITY.rst",
+    "Thumbs.db",
+    "__pycache__",
+    "build",
+    "codebin",
+    "dist",
+    "docs/Makefile",
+    "docs/_build",
+    "docs/_static",
+    "docs/changelog.rst",
+    "docs/code_of_conduct.rst",
+    "docs/customization",
+    "docs/make.bat",
+    "docs/requirements.txt",
+    "docs/security.rst",
+    "docs/source_tree.rst",
+    "docs/source_tree_full.rst",
+    "env",
+    "htmlcov",
+    "node_modules",
+    "venv",
+    "ARCHITECTURE.rst",
+    ".coderabbit.yaml",
+    ".coveralls",
+    "docs/full-llms.rst",
+    "docs/llms.rst",
+    "docs/contributor_guidelines.rst",
+    "docs/package.rst",
+    "docs/documentation.rst",
+    "docs/index.rst",
+]
+order = [
+    "README.rst",
+    "CONTRIBUTING.rst",
+    "AGENTS.md",
+]
+
+[[tool.sphinx-source-tree.files]]
+output = "docs/full_llms.rst"
+title = "Full project source-tree"
+
+[[tool.sphinx-source-tree.files]]
+output = "docs/llms.rst"
+title = "Project source-tree"
+ignore = [
+    "*.egg-info",
+    "*.py,cover",
+    "*.pyc",
+    "*.pyo",
+    ".DS_Store",
+    ".coverage",
+    ".coverage.*",
+    ".git",
+    ".hg",
+    ".hypothesis",
+    ".idea",
+    ".mypy_cache",
+    ".nox",
+    ".pre-commit-config.yaml",
+    ".pre-commit-hooks.yaml",
+    ".pytest_cache",
+    ".readthedocs.yaml",
+    ".ruff_cache",
+    ".secrets.baseline",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "CHANGELOG.rst",
+    "CODE_OF_CONDUCT.rst",
+    "LICENSE",
+    "SECURITY.rst",
+    "Thumbs.db",
+    "__pycache__",
+    "build",
+    "codebin",
+    "dist",
+    "docs/Makefile",
+    "docs/_build",
+    "docs/_static",
+    "docs/changelog.rst",
+    "docs/code_of_conduct.rst",
+    "docs/customization",
+    "docs/make.bat",
+    "docs/requirements.txt",
+    "docs/security.rst",
+    "docs/source_tree.rst",
+    "docs/source_tree_full.rst",
+    "env",
+    "htmlcov",
+    "node_modules",
+    "venv",
+    "examples",
+    "docs",
+    "ARCHITECTURE.rst",
+    ".coderabbit.yaml",
+    ".coveralls",
+    "docs/full-llms.rst",
+    "docs/llms.rst",
+    "docs/contributor_guidelines.rst",
+    "docs/package.rst",
+    "docs/documentation.rst",
+    "docs/index.rst",
+]

license_normaliser-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+