feat(CLI): Add a script to project

Also fix --help for commands.

Co-authored-by: Wuestengecko <[email protected]>

capella2polarion/__main__.py

@@ -58,10 +58,10 @@ def cli(
     polarion_url: str,
     polarion_pat: str,
     polarion_delete_work_items: bool,
-    capella_model: capellambse.MelodyModel,
+    capella_model: capellambse.MelodyModel | None,
 ) -> None:
     """Synchronise data from Capella to Polarion."""
-    if capella_model.diagram_cache is None:
+    if capella_model is not None and capella_model.diagram_cache is None:
         logger.warning("It's highly recommended to define a diagram cache!")
 
     capella2polarion_cli = Capella2PolarionCli(

ci-templates/gitlab/render_documents.yaml

@@ -21,4 +21,4 @@ capella2polarion_render_documents:
 
   script:
     - pip install "capella2polarion${CAPELLA2POLARION_VERSION:+==$CAPELLA2POLARION_VERSION}"
-    - python -m capella2polarion render-documents
+    - capella2polarion render-documents

ci-templates/gitlab/synchronise_elements.yml

@@ -21,4 +21,4 @@ capella2polarion_synchronise_elements:
 
   script:
     - pip install "capella2polarion${CAPELLA2POLARION_VERSION:+==$CAPELLA2POLARION_VERSION}"
-    - python -m capella2polarion synchronize
+    - capella2polarion synchronize

pyproject.toml

@@ -60,6 +60,9 @@ test = [
   "pytest-cov",
 ]
 
+[project.scripts]
+capella2polarion = "capella2polarion.__main__:cli"
+
 [tool.black]
 line-length = 79
 target-version = ["py312"]