qgis-plugin-dev-tools 0.8.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

qgis_plugin_dev_tools/__init__.py

@@ -20,7 +20,7 @@
 import logging
 import sys
 
-__version__ = "0.8.0"
+__version__ = "0.9.0"
 
 LOGGER = logging.getLogger(__name__)
 _handler = logging.StreamHandler(sys.stdout)

qgis_plugin_dev_tools/build/__init__.py

@@ -35,6 +35,7 @@ from qgis_plugin_dev_tools.build.metadata import update_metadata_file
 from qgis_plugin_dev_tools.build.packaging import (
     copy_plugin_code,
     copy_runtime_requirements,
+    copy_license,
 )
 from qgis_plugin_dev_tools.config import DevToolsConfig, VersionNumberSource
 
@@ -84,6 +85,7 @@ def make_plugin_zip(
             changelog_contents,
         )
         copy_runtime_requirements(dev_tools_config, build_directory_path)
+        copy_license(dev_tools_config, build_directory_path)
 
         LOGGER.debug("creating built plugin zip file from build directory")
 

qgis_plugin_dev_tools/build/packaging.py

@@ -20,6 +20,8 @@
 import logging
 import shutil
 import sys
+from typing import Generator, Optional
+
 from importlib_metadata import Distribution
 from pathlib import Path
 
@@ -133,6 +135,45 @@ def copy_runtime_requirements(
                 )
 
 
+def copy_license(dev_tools_config: DevToolsConfig, build_directory_path: Path) -> None:
+    plugin_build_path = build_directory_path / dev_tools_config.plugin_package_name
+    target_license_file = plugin_build_path / "LICENSE"
+    license_file = dev_tools_config.license_file_path
+    if license_file is not None:
+        if not license_file.exists():
+            LOGGER.error(
+                f"Configured license file "
+                f"{license_file} "
+                f"does not exist. Check the configuration."
+            )
+            return
+
+        if target_license_file.exists():
+            LOGGER.warning(
+                f"Overwriting existing license {target_license_file} "
+                f"with configured license {license_file}"
+            )
+        LOGGER.debug(f"Copying license file {license_file} to {build_directory_path}")
+        shutil.copy(license_file, target_license_file)
+        return
+
+    if target_license_file.exists():
+        LOGGER.debug(f"Existing license file {target_license_file} found.")
+        return
+
+    # Try finding the license
+    license_file = _find_existing_license_file(dev_tools_config.pyproject_path)
+    if not license_file:
+        LOGGER.warning(
+            "Cannot copy LICENSE file since it does not exist. "
+            "Configure valid LICENSE file with license_file_path in pyproject.toml"
+        )
+        return
+
+    LOGGER.debug(f"Copying license file {license_file} to {build_directory_path}")
+    shutil.copy(license_file, target_license_file)
+
+
 def _copy_distribution_files(
     distribution: Distribution,
     top_level_names: set[str],
@@ -190,3 +231,15 @@ def _copy_distribution_files(
             src=original_path,
             dst=new_path,
         )
+
+
+def _find_existing_license_file(search_path: Path) -> Optional[Path]:
+    def generate_license_candidates() -> Generator[Path, None, None]:
+        for base_name in ("LICENSE", "license"):
+            for extension in ("", ".md", ".MD"):
+                yield search_path / f"{base_name}{extension}"
+
+    for potential_path in generate_license_candidates():
+        if potential_path.exists():
+            return potential_path
+    return None

qgis_plugin_dev_tools/config/__init__.py

@@ -21,6 +21,7 @@ from collections import ChainMap
 from enum import Enum, auto
 from importlib.util import find_spec
 from pathlib import Path
+from typing import Optional
 
 from importlib_metadata import Distribution, distribution
 from packaging.requirements import Requirement
@@ -42,6 +43,7 @@ class VersionNumberSource(Enum):
 
 
 class DevToolsConfig:
+    pyproject_path: Path
     plugin_package_name: str
     plugin_package_path: Path
     runtime_distributions: list[Distribution]
@@ -49,9 +51,11 @@ class DevToolsConfig:
     append_distributions_to_path: bool
     version_number_source: VersionNumberSource
     disabled_extra_plugins: list[str]
+    license_file_path: Optional[Path]
 
     def __init__(  # noqa: PLR0913
         self,
+        pyproject_path: Path,
         plugin_package_name: str,
         runtime_requires: list[str],
         changelog_file_path: Path,
@@ -59,6 +63,7 @@ class DevToolsConfig:
         auto_add_recursive_runtime_dependencies: bool,
         version_number_source: VersionNumberSource,
         disabled_extra_plugins: list[str],
+        license_file_path: Optional[Path],
     ) -> None:
         plugin_package_spec = find_spec(plugin_package_name)
         if plugin_package_spec is None or plugin_package_spec.origin is None:
@@ -66,6 +71,7 @@ class DevToolsConfig:
                 f"could not find {plugin_package_name=} in the current environment"
             )
 
+        self.pyproject_path = pyproject_path
         self.plugin_package_path = Path(plugin_package_spec.origin).parent
         self.plugin_package_name = plugin_package_name
         # TODO: check versions are satisfied?
@@ -77,6 +83,7 @@ class DevToolsConfig:
         self.version_number_source = version_number_source
         self.extra_runtime_distributions = []
         self.disabled_extra_plugins = disabled_extra_plugins
+        self.license_file_path = license_file_path
 
         if auto_add_recursive_runtime_dependencies:
             # Add the requirements of the distributions as well
@@ -98,6 +105,7 @@ class DevToolsConfig:
     def from_pyproject_config(pyproject_file_path: Path) -> "DevToolsConfig":
         pyproject_config = read_pyproject_config(pyproject_file_path)
         return DevToolsConfig(
+            pyproject_path=pyproject_file_path,
             plugin_package_name=pyproject_config.plugin_package_name,
             runtime_requires=pyproject_config.runtime_requires,
             # TODO: allow setting path in pyproject file?
@@ -112,4 +120,8 @@ class DevToolsConfig:
                 pyproject_config.version_number_source
             ),
             disabled_extra_plugins=pyproject_config.disabled_extra_plugins,
+            license_file_path=pyproject_file_path.parent
+            / pyproject_config.license_file_path
+            if pyproject_config.license_file_path
+            else None,
         )

qgis_plugin_dev_tools/config/pyproject.py

@@ -20,7 +20,7 @@
 import logging
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import Literal, Union
+from typing import Literal, Optional, Union
 
 import tomli
 
@@ -43,6 +43,7 @@ class PyprojectConfig:
         Literal["changelog"], Literal["distribution"]
     ] = "changelog"
     disabled_extra_plugins: list[str] = field(default_factory=list)
+    license_file_path: Optional[str] = None
 
     def __post_init__(self) -> None:
         if self.version_number_source not in ["changelog", "distribution"]:

{qgis_plugin_dev_tools-0.8.0.dist-info → qgis_plugin_dev_tools-0.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qgis-plugin-dev-tools
-Version: 0.8.0
+Version: 0.9.0
 Summary: QGIS plugin development and packaging tools, which make managing runtime dependencies easy.
 Home-page: https://github.com/nlsfi/qgis-plugin-dev-tools
 Author: National Land Survey of Finland
@@ -22,11 +22,11 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: packaging >=21.0
-Requires-Dist: tomli >=2.0.0
-Requires-Dist: python-dotenv >=0.19.0
-Requires-Dist: importlib-metadata >=4.9.0
-Requires-Dist: requests >=2.27.0
+Requires-Dist: packaging>=21.0
+Requires-Dist: tomli>=2.0.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: importlib-metadata>=4.9.0
+Requires-Dist: requests>=2.27.0
 
 # qgis-plugin-dev-tools
 
@@ -91,6 +91,14 @@ plugin_package_name = "your_plugin_package_name"
 version_number_source = "distribution"  # or "changelog" (default if missing)
 ```
 
+QGIS plugins are required to have a LICENSE file included in the plugin package. However, usually it is more convenient to keep the license file in the root of the repository. LICENSE can be copied automatically to the plugin zip while packaging if such file is found. A relative path to the license file can also be configured with `license_file_path` option.
+
+```toml
+[tool.qgis_plugin_dev_tools]
+plugin_package_name = "your_plugin_package_name"
+license_file_path = "docs/my-license.md"
+```
+
 ## Plugin packaging
 
 Run `qgis-plugin-dev-tools build` (short `qpdt b`) to package the plugin and any runtime dependencies to a standard QGIS plugin zip file, that can be installed and published.
@@ -167,6 +175,10 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.0] - 2025-01-08
+
+- Feat: Copy license into the plugin zip while deploying
+
 ## [0.8.0] - 2024-08-23
 
 - Feat: Add locale and ui ini options to be able to further customize development environment
@@ -240,3 +252,4 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 [0.6.2]: https://github.com/nlsfi/qgis-plugin-dev-tools/releases/tag/v0.6.2
 [0.7.0]: https://github.com/nlsfi/qgis-plugin-dev-tools/releases/tag/v0.7.0
 [0.8.0]: https://github.com/nlsfi/qgis-plugin-dev-tools/releases/tag/v0.8.0
+[0.9.0]: https://github.com/nlsfi/qgis-plugin-dev-tools/releases/tag/v0.9.0

{qgis_plugin_dev_tools-0.8.0.dist-info → qgis_plugin_dev_tools-0.9.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
-qgis_plugin_dev_tools/__init__.py,sha256=EyLJdeFZiG9GjOkxlKxhB9yZDouz8kylbW5tBwmPCo4,1064
+qgis_plugin_dev_tools/__init__.py,sha256=COQRV9RQ7IMaTRLFDWEzoEys0yRJp_kYVplfvn2UNsY,1064
 qgis_plugin_dev_tools/__main__.py,sha256=EqC7agwIoIKbMeOPrcpDWGAQmsaO_oFc0OkIxlowzmA,900
 qgis_plugin_dev_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-qgis_plugin_dev_tools/build/__init__.py,sha256=RbPVZeH29y8efqZRO0dmnH1ArzRvhcpOj9Ka60plX8c,3514
+qgis_plugin_dev_tools/build/__init__.py,sha256=JDxRaPtJfN08AnyKMB8dTc1b2oIFHZBvclyIZQGnCEA,3593
 qgis_plugin_dev_tools/build/changelog_parser.py,sha256=t9u30K2DyWXBOW47r2dMXzP-nbW7oIFCkYeBzsL8r_A,2212
 qgis_plugin_dev_tools/build/distribution.py,sha256=ST2h-YeVh8HWeDURhXoG_Rba9Zha167tdBlVJbXEdQQ,835
 qgis_plugin_dev_tools/build/metadata.py,sha256=rDKRDmvgJxsrlEWKnHNfq3gqOQxClgtNUeeKIIYyMos,1429
-qgis_plugin_dev_tools/build/packaging.py,sha256=ShLrWY_tGlf9orj865MzuET8VRJTpODgb1CPNvISosc,6714
+qgis_plugin_dev_tools/build/packaging.py,sha256=9npf95qRZjAlETUKc98Zs3EHqcUP-GsxBjgqaxX6YYk,8721
 qgis_plugin_dev_tools/build/rewrite_imports.py,sha256=YZ3ORvm_7Gf6tBKqjqzp-BR-Q_CoIbIh7MlxRZIfPQA,5945
 qgis_plugin_dev_tools/cli/__init__.py,sha256=qv0rEGKSUpk9oskNZC0X-bqiZy715XKDWQS0YBloqWI,6230
-qgis_plugin_dev_tools/config/__init__.py,sha256=7l7Iyjst-pqLobiAO2bKLvkQFLVWoq4O_rny9lQvHp8,4678
+qgis_plugin_dev_tools/config/__init__.py,sha256=H8mNa_lBiSxLtAvuW-J8adzhZHP3I7BijxuWh_uQAnM,5165
 qgis_plugin_dev_tools/config/dotenv.py,sha256=CmqPAIPCwRFS5gMuCePZuNAMwsjggCoXejA1Fpq5k8c,2647
-qgis_plugin_dev_tools/config/pyproject.py,sha256=QvhZIk4QQezKSmTm28IG_lHBIO59CUQmAUQNB78Gxa4,2383
+qgis_plugin_dev_tools/config/pyproject.py,sha256=_JUJYU-ejo5zuYNeDdwdbC4bQZlhCvXkBtF_TUpdz0A,2437
 qgis_plugin_dev_tools/publish/__init__.py,sha256=PB0bUWl6vjDSlqPm92hw2Vtn1A3sqymm3pWgkWsPCOI,2081
 qgis_plugin_dev_tools/start/__init__.py,sha256=9eBCJnpLjE7bll2R_YljiTFj9Bq0NqaFGPOKC7DG274,2181
 qgis_plugin_dev_tools/start/config.py,sha256=n8MaHsY-21LVcNnxwTrg9k8Wo2jb03nCKta6OB9dN3s,1326
@@ -20,9 +20,9 @@ qgis_plugin_dev_tools/start/bootstrap/__init__.py,sha256=4FoIYBxXM7zgyaTM4gz5fGD
 qgis_plugin_dev_tools/start/bootstrap/template.py,sha256=KV2EgHSMxKzA7wbKaxYwPnn6c1f7D2Yrd1Qq_Huh6y0,12432
 qgis_plugin_dev_tools/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 qgis_plugin_dev_tools/utils/distributions.py,sha256=Q2jZT44Iw8LIBNrf1X2thfCLiKu9yiu7joj0Pdxk-Oc,3215
-qgis_plugin_dev_tools-0.8.0.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-qgis_plugin_dev_tools-0.8.0.dist-info/METADATA,sha256=AwVTjaFDZk27lJbFbpOXmLmmk0kaXPuMMKPKbBe_IF4,10783
-qgis_plugin_dev_tools-0.8.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
-qgis_plugin_dev_tools-0.8.0.dist-info/entry_points.txt,sha256=RwM8y7cN8cRk003jpw-psB4DvifC5foZKSi04IDRBVw,109
-qgis_plugin_dev_tools-0.8.0.dist-info/top_level.txt,sha256=JjwWwRniudLz30UtQJgmIQDeS3HgU5VBgDlKYJhz-nQ,22
-qgis_plugin_dev_tools-0.8.0.dist-info/RECORD,,
+qgis_plugin_dev_tools-0.9.0.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+qgis_plugin_dev_tools-0.9.0.dist-info/METADATA,sha256=Nl-hFjW6wbOksSx6e6KJ01vofSe27anxGemDM2n4IfE,11431
+qgis_plugin_dev_tools-0.9.0.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
+qgis_plugin_dev_tools-0.9.0.dist-info/entry_points.txt,sha256=RwM8y7cN8cRk003jpw-psB4DvifC5foZKSi04IDRBVw,109
+qgis_plugin_dev_tools-0.9.0.dist-info/top_level.txt,sha256=JjwWwRniudLz30UtQJgmIQDeS3HgU5VBgDlKYJhz-nQ,22
+qgis_plugin_dev_tools-0.9.0.dist-info/RECORD,,

{qgis_plugin_dev_tools-0.8.0.dist-info → qgis_plugin_dev_tools-0.9.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (73.0.1)
+Generator: setuptools (75.7.0)
 Root-Is-Purelib: true
 Tag: py3-none-any