Module continuous_delivery_scripts.plugins.ci

Plugin for CI projects.

Expand source code
#
# Copyright (C) 2020-2025 Arm Limited or its affiliates and Contributors. All rights reserved.
# SPDX-License-Identifier: Apache-2.0
#
"""Plugin for CI projects."""
import logging
from pathlib import Path
from typing import Optional

from continuous_delivery_scripts.spdx_report.spdx_project import SpdxProject
from continuous_delivery_scripts.utils.configuration import configuration, ConfigurationVariable
from continuous_delivery_scripts.utils.definitions import CommitType
from continuous_delivery_scripts.utils.language_specifics_base import BaseLanguage, get_language_from_file_name

logger = logging.getLogger(__name__)


class CI(BaseLanguage):
    """Specific actions for a CI project."""

    def package_software(self, mode: CommitType, version: str) -> None:
        """Nothing to do."""
        pass

    def generate_code_documentation(self, output_directory: Path, module_to_document: str) -> None:
        """Generates the code documentation."""
        pass

    def get_related_language(self) -> str:
        """Gets the related language."""
        return get_language_from_file_name(__file__)

    def get_version_tag(self, version: str) -> str:
        """Gets tag based on version."""
        cleansed_version = version.strip().lstrip("v")
        return f"v{cleansed_version}"

    def release_package_to_repository(self, mode: CommitType, version: str) -> None:
        """No operation."""
        pass

    def check_credentials(self) -> None:
        """Checks any credentials."""
        super().check_credentials()
        configuration.get_value(ConfigurationVariable.GIT_TOKEN)

    def can_add_licence_headers(self) -> bool:
        """States that licence headers can be added."""
        return True

    def can_get_project_metadata(self) -> bool:
        """States whether project metadata can be retrieved."""
        return False

    def get_current_spdx_project(self) -> Optional[SpdxProject]:
        """Gets current SPDX description."""
        # TODO
        return None

    def should_clean_before_packaging(self) -> bool:
        """States whether the repository must be cleaned before packaging happens."""
        return True

Classes

class CI

Specific actions for a CI project.

Expand source code
class CI(BaseLanguage):
    """Specific actions for a CI project."""

    def package_software(self, mode: CommitType, version: str) -> None:
        """Nothing to do."""
        pass

    def generate_code_documentation(self, output_directory: Path, module_to_document: str) -> None:
        """Generates the code documentation."""
        pass

    def get_related_language(self) -> str:
        """Gets the related language."""
        return get_language_from_file_name(__file__)

    def get_version_tag(self, version: str) -> str:
        """Gets tag based on version."""
        cleansed_version = version.strip().lstrip("v")
        return f"v{cleansed_version}"

    def release_package_to_repository(self, mode: CommitType, version: str) -> None:
        """No operation."""
        pass

    def check_credentials(self) -> None:
        """Checks any credentials."""
        super().check_credentials()
        configuration.get_value(ConfigurationVariable.GIT_TOKEN)

    def can_add_licence_headers(self) -> bool:
        """States that licence headers can be added."""
        return True

    def can_get_project_metadata(self) -> bool:
        """States whether project metadata can be retrieved."""
        return False

    def get_current_spdx_project(self) -> Optional[SpdxProject]:
        """Gets current SPDX description."""
        # TODO
        return None

    def should_clean_before_packaging(self) -> bool:
        """States whether the repository must be cleaned before packaging happens."""
        return True

Ancestors

Subclasses

Methods

def can_add_licence_headers(self) ‑> bool

States that licence headers can be added.

Expand source code
def can_add_licence_headers(self) -> bool:
    """States that licence headers can be added."""
    return True
def check_credentials(self) ‑> None

Checks any credentials.

Expand source code
def check_credentials(self) -> None:
    """Checks any credentials."""
    super().check_credentials()
    configuration.get_value(ConfigurationVariable.GIT_TOKEN)
def get_current_spdx_project(self) ‑> Optional[SpdxProject]

Gets current SPDX description.

Expand source code
def get_current_spdx_project(self) -> Optional[SpdxProject]:
    """Gets current SPDX description."""
    # TODO
    return None

Gets the related language.

Expand source code
def get_related_language(self) -> str:
    """Gets the related language."""
    return get_language_from_file_name(__file__)
def get_version_tag(self, version: str) ‑> str

Gets tag based on version.

Expand source code
def get_version_tag(self, version: str) -> str:
    """Gets tag based on version."""
    cleansed_version = version.strip().lstrip("v")
    return f"v{cleansed_version}"
def package_software(self, mode: CommitType, version: str) ‑> None

Nothing to do.

Expand source code
def package_software(self, mode: CommitType, version: str) -> None:
    """Nothing to do."""
    pass
def release_package_to_repository(self, mode: CommitType, version: str) ‑> None

No operation.

Expand source code
def release_package_to_repository(self, mode: CommitType, version: str) -> None:
    """No operation."""
    pass

Inherited members