gcip2 0.0.1__tar.gz

gcip2-0.0.1/LICENCE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2026] [Arsenii Nikulin]
+
+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.

gcip2-0.0.1/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: gcip2
+Version: 0.0.1
+Summary: pivlab gcip2
+License-File: LICENCE.md
+Author: Arsenii Nikulin
+Author-email: a.nikulin@pivlab.space
+Requires-Python: >=3.11,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: black (>=26.5.1,<27.0.0)
+Requires-Dist: click (>=8.4.1,<9.0.0)
+Requires-Dist: isort (>=8.0.1,<9.0.0)
+Requires-Dist: jsonschema (>=4.26.0,<5.0.0)
+Requires-Dist: pre-commit (>=4.6.0,<5.0.0)
+Requires-Dist: pydantic (>=2.13.4,<3.0.0)
+Requires-Dist: pyyaml (>=6.0.3,<7.0.0)

gcip2-0.0.1/gcip2/builder.py

@@ -0,0 +1,205 @@
+import importlib.util
+import os
+import pathlib
+from enum import Enum
+from typing import Any, Optional, Self
+
+import yaml
+from typing_extensions import override
+
+from .pipeline_core import (
+    Artifacts,
+    Job,
+    JobBuilderImpl,
+    Needs,
+    Pipeline,
+    PipelineBuilderImpl,
+    Trigger,
+    TriggerForward,
+    TriggerIncludeArtifact,
+    TriggerStrategy,
+)
+
+
+class CustomDumper(yaml.SafeDumper):
+    @staticmethod
+    def str_presenter(
+        dumper: yaml.representer.BaseRepresenter,
+        data: str,
+    ) -> yaml.ScalarNode:
+        if "\n" in data:
+            return dumper.represent_scalar(  # type: ignore
+                "tag:yaml.org,2002:str",
+                data,
+                style="|",
+            )
+
+        return dumper.represent_scalar(  # type: ignore
+            "tag:yaml.org,2002:str",
+            data,
+        )
+
+    yaml_representers = {
+        **yaml.SafeDumper.yaml_representers,
+        str: str_presenter,
+    }
+
+    @override
+    def increase_indent(
+        self: Self,
+        flow: bool = False,
+        indentless: bool = False,
+    ):
+        return super().increase_indent(flow, False)
+
+    @override
+    def write_line_break(self, data: Optional[str] = None):
+        super().write_line_break(data)
+
+        if len(self.indents) == 1:
+            super().write_line_break()
+
+
+class TriggerPipelineDefaults(str, Enum):
+    build_pipeline = "build-pipeline"
+    trigger_pipeline = "trigger-pipeline"
+    out_dir = "out"
+    out_file = "out/pipeline.gitlab-ci.yml"
+
+
+class PipelineBuilder:
+    yaml_dumper = CustomDumper
+
+    @staticmethod
+    def _gen_build_pipeline_job():
+        return Job(
+            name=TriggerPipelineDefaults.build_pipeline,
+            before_script=[
+                "pip3 install poetry",
+            ],
+            script=[
+                "poetry install && . .venv/bin/activate",
+                "gcip2 build-pipeline",
+            ],
+            tags=["immortal"],
+            artifacts=Artifacts(paths=[TriggerPipelineDefaults.out_dir]),
+        )
+
+    @staticmethod
+    def _gen_trigger_pipeline_job():
+        return Job(
+            name=TriggerPipelineDefaults.trigger_pipeline,
+            interruptible=False,
+            trigger=Trigger(
+                include=[
+                    TriggerIncludeArtifact(
+                        artifact=TriggerPipelineDefaults.out_file,
+                        job=TriggerPipelineDefaults.build_pipeline,
+                    )
+                ],
+                strategy=TriggerStrategy.DEPEND,
+                forward=TriggerForward(
+                    yaml_variables=True,
+                    pipeline_variables=True,
+                ),
+            ),
+            needs=[
+                Needs(
+                    job=TriggerPipelineDefaults.build_pipeline,
+                    artifacts=True,
+                )
+            ],
+            variables={
+                "PARENT_PIPELINE_ID": "${CI_PIPELINE_ID}",
+            },
+        )
+
+    def build_gitlab_ci(
+        self: Self,
+        out_gitlab_ci: Any,
+        default_tags: str,
+    ) -> None:
+        pipeline_obj = Pipeline(
+            jobs=[
+                self._gen_build_pipeline_job(),
+                self._gen_trigger_pipeline_job(),
+            ]
+        )
+        self.build_pipeline_file(
+            pipeline=pipeline_obj,
+            path=out_gitlab_ci,
+            default_tags=default_tags,
+        )
+
+    def load_pipeline(self: Self, path: Any) -> PipelineBuilderImpl:
+        path = pathlib.Path(path)
+        spec: Any = importlib.util.spec_from_file_location(
+            "user_pipeline",
+            path,
+        )
+        module = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(module)
+
+        for obj in module.__dict__.values():
+
+            if callable(obj) and getattr(obj, "__gcip2_pipeline__", False):
+                return obj  # type: ignore
+
+            if isinstance(obj, type) and issubclass(obj, PipelineBuilderImpl) and obj is not PipelineBuilderImpl:
+                return obj()
+
+        raise RuntimeError("Pipeline class not found")
+
+    def render_pipeline(self: Self, pipeline: Pipeline):
+        pipeline = Pipeline.model_validate(pipeline, strict=True)
+        result: dict[str, Any] = pipeline.dump(exclude=["jobs"])
+
+        for job in pipeline.jobs:
+            if isinstance(job, JobBuilderImpl):
+                job = job.build()
+            if not job.name:
+                raise ValueError("Job name is missing.")
+            if job.name in result.keys():
+                raise ValueError("Job with same name already added.")
+            result[job.name] = job.dump(exclude=["name"])
+        return result
+
+    def build_pipeline_file(
+        self: Self,
+        pipeline: Pipeline,
+        path: Optional[pathlib.Path],
+        default_tags: Optional[str] = None,
+        **_: Any,
+    ) -> None:
+        os.makedirs("out", exist_ok=True)
+        pipeline_copy = pipeline.model_copy(deep=True)
+        if default_tags:
+            for job in pipeline_copy.jobs:
+                if job.name == TriggerPipelineDefaults.build_pipeline:
+                    job.tags = default_tags.split(sep=" ")
+
+        data = yaml.dump(
+            self.render_pipeline(pipeline=pipeline_copy),
+            sort_keys=False,
+            allow_unicode=True,
+            Dumper=CustomDumper,
+        )
+        path = path or pathlib.Path(os.getcwd()) / "out" / "pipeline.gitlab-ci.yml"
+        with open(path, "w") as f:
+            f.write(data)
+
+    def build_pipeline(self: Self, ci_file_path: str, out_pipeline_path: str) -> None:
+        pipeline_entry = self.load_pipeline(ci_file_path)
+
+        # decorator API
+        if callable(pipeline_entry):
+            pipeline: Pipeline = pipeline_entry()  # type: ignore
+
+        # class API
+        else:
+            pipeline: Pipeline = pipeline_entry.apply().build()
+
+        self.build_pipeline_file(
+            pipeline=pipeline,  # type: ignore
+            path=pathlib.Path(out_pipeline_path),
+        )