from __future__ import annotations from datetime import timedelta from itertools import count from pathlib import Path from typing import TYPE_CHECKING import pytest from semantic_release.cli.config import ChangelogOutputFormat import tests.conftest import tests.const import tests.util from tests.const import ( EXAMPLE_HVCS_DOMAIN, INITIAL_COMMIT_MESSAGE, RepoActionStep, ) if TYPE_CHECKING: from typing import Sequence from tests.conftest import ( GetCachedRepoDataFn, GetMd5ForSetOfFilesFn, GetStableDateNowFn, ) from tests.fixtures.example_project import ExProjectDir from tests.fixtures.git_repo import ( BuildRepoFromDefinitionFn, BuildRepoOrCopyCacheFn, BuildSpecificRepoFn, BuiltRepoResult, CommitConvention, ConvertCommitSpecsToCommitDefsFn, ExProjectGitRepoFn, GetRepoDefinitionFn, RepoActions, RepoActionWriteChangelogsDestFile, TomlSerializableTypes, ) @pytest.fixture(scope="session") def deps_files_4_repo_w_prereleases( deps_files_4_example_git_project: list[Path], ) -> list[Path]: return [ *deps_files_4_example_git_project, # This file Path(__file__).absolute(), # because of imports Path(tests.const.__file__).absolute(), Path(tests.util.__file__).absolute(), # because of the fixtures Path(tests.conftest.__file__).absolute(), ] @pytest.fixture(scope="session") def build_spec_hash_4_repo_w_prereleases( get_md5_for_set_of_files: GetMd5ForSetOfFilesFn, deps_files_4_repo_w_prereleases: list[Path], ) -> str: # Generates a hash of the build spec to set when to invalidate the cache return get_md5_for_set_of_files(deps_files_4_repo_w_prereleases) @pytest.fixture(scope="session") def get_repo_definition_4_trunk_only_repo_w_prerelease_tags( convert_commit_specs_to_commit_defs: ConvertCommitSpecsToCommitDefsFn, changelog_md_file: Path, changelog_rst_file: Path, stable_now_date: GetStableDateNowFn, ) -> GetRepoDefinitionFn: """ Builds a repository with trunk-only committing (no-branching) strategy with official and prereleases releases. """ def _get_repo_from_definition( commit_type: CommitConvention, hvcs_client_name: str = "github", hvcs_domain: str = EXAMPLE_HVCS_DOMAIN, tag_format_str: str | None = None, extra_configs: dict[str, TomlSerializableTypes] | None = None, mask_initial_release: bool = True, ignore_merge_commits: bool = True, ) -> Sequence[RepoActions]: stable_now_datetime = stable_now_date() commit_timestamp_gen = ( (stable_now_datetime + timedelta(seconds=i)).isoformat(timespec="seconds") for i in count(step=1) ) changelog_file_definitions: Sequence[RepoActionWriteChangelogsDestFile] = [ { "path": changelog_md_file, "format": ChangelogOutputFormat.MARKDOWN, }, { "path": changelog_rst_file, "format": ChangelogOutputFormat.RESTRUCTURED_TEXT, }, ] repo_construction_steps: list[RepoActions] = [] repo_construction_steps.append( { "action": RepoActionStep.CONFIGURE, "details": { "commit_type": commit_type, "hvcs_client_name": hvcs_client_name, "hvcs_domain": hvcs_domain, "tag_format_str": tag_format_str, "mask_initial_release": mask_initial_release, "extra_configs": { # Set the default release branch "tool.semantic_release.branches.main": { "match": r"^(main|master)$", "prerelease": False, }, "tool.semantic_release.allow_zero_version": True, **(extra_configs or {}), }, }, } ) # Make initial release new_version = "0.1.0" repo_construction_steps.extend( [ { "action": RepoActionStep.MAKE_COMMITS, "details": { "commits": convert_commit_specs_to_commit_defs( [ { "conventional": INITIAL_COMMIT_MESSAGE, "emoji": INITIAL_COMMIT_MESSAGE, "scipy": INITIAL_COMMIT_MESSAGE, "datetime": next(commit_timestamp_gen), "include_in_changelog": bool( commit_type == "emoji" ), }, { "conventional": "feat: add new feature", "emoji": ":sparkles: add new feature", "scipy": "ENH: add new feature", "datetime": next(commit_timestamp_gen), "include_in_changelog": True, }, ], commit_type, ), }, }, { "action": RepoActionStep.RELEASE, "details": { "version": new_version, "datetime": next(commit_timestamp_gen), "pre_actions": [ { "action": RepoActionStep.WRITE_CHANGELOGS, "details": { "new_version": new_version, "dest_files": changelog_file_definitions, }, }, ], }, }, ] ) # Make a fix and release it as a release candidate new_version = "0.1.1-rc.1" repo_construction_steps.extend( [ { "action": RepoActionStep.MAKE_COMMITS, "details": { "commits": convert_commit_specs_to_commit_defs( [ { "conventional": "fix: correct some text\n\nfixes: #123\n", "emoji": ":bug: correct some text\n\nfixes: #123\n", "scipy": "MAINT: correct some text\n\nfixes: #123\n", "datetime": next(commit_timestamp_gen), "include_in_changelog": True, }, ], commit_type, ), }, }, { "action": RepoActionStep.RELEASE, "details": { "version": new_version, "datetime": next(commit_timestamp_gen), "pre_actions": [ { "action": RepoActionStep.WRITE_CHANGELOGS, "details": { "new_version": new_version, "dest_files": changelog_file_definitions, }, }, ], }, }, ] ) # Make an additional feature change and release it as a new release candidate new_version = "0.2.0-rc.1" repo_construction_steps.extend( [ { "action": RepoActionStep.MAKE_COMMITS, "details": { "commits": convert_commit_specs_to_commit_defs( [ { "conventional": "feat: add some more text", "emoji": ":sparkles: add some more text", "scipy": "ENH: add some more text", "datetime": next(commit_timestamp_gen), "include_in_changelog": True, }, ], commit_type, ), }, }, { "action": RepoActionStep.RELEASE, "details": { "version": new_version, "datetime": next(commit_timestamp_gen), "pre_actions": [ { "action": RepoActionStep.WRITE_CHANGELOGS, "details": { "new_version": new_version, "dest_files": changelog_file_definitions, }, }, ], }, }, ] ) # Make an additional feature change and officially release the latest new_version = "0.2.0" repo_construction_steps.extend( [ { "action": RepoActionStep.MAKE_COMMITS, "details": { "commits": convert_commit_specs_to_commit_defs( [ { "conventional": "feat(cli): add cli command", "emoji": ":sparkles:(cli) add cli command", "scipy": "ENH: cli: add cli command", "datetime": next(commit_timestamp_gen), "include_in_changelog": True, }, ], commit_type, ), }, }, { "action": RepoActionStep.RELEASE, "details": { "version": new_version, "datetime": next(commit_timestamp_gen), "pre_actions": [ { "action": RepoActionStep.WRITE_CHANGELOGS, "details": { "new_version": new_version, "dest_files": changelog_file_definitions, }, }, ], }, }, ] ) return repo_construction_steps return _get_repo_from_definition @pytest.fixture(scope="session") def build_trunk_only_repo_w_prerelease_tags( build_repo_from_definition: BuildRepoFromDefinitionFn, get_repo_definition_4_trunk_only_repo_w_prerelease_tags: GetRepoDefinitionFn, get_cached_repo_data: GetCachedRepoDataFn, build_repo_or_copy_cache: BuildRepoOrCopyCacheFn, build_spec_hash_4_repo_w_prereleases: str, ) -> BuildSpecificRepoFn: def _build_specific_repo_type( repo_name: str, commit_type: CommitConvention, dest_dir: Path ) -> Sequence[RepoActions]: def _build_repo(cached_repo_path: Path) -> Sequence[RepoActions]: repo_construction_steps = ( get_repo_definition_4_trunk_only_repo_w_prerelease_tags( commit_type=commit_type, ) ) return build_repo_from_definition(cached_repo_path, repo_construction_steps) build_repo_or_copy_cache( repo_name=repo_name, build_spec_hash=build_spec_hash_4_repo_w_prereleases, build_repo_func=_build_repo, dest_dir=dest_dir, ) if not (cached_repo_data := get_cached_repo_data(proj_dirname=repo_name)): raise ValueError("Failed to retrieve repo data from cache") return cached_repo_data["build_definition"] return _build_specific_repo_type # --------------------------------------------------------------------------- # # Test-level fixtures that will cache the built directory & set up test case # # --------------------------------------------------------------------------- # @pytest.fixture def repo_w_trunk_only_n_prereleases_conventional_commits( build_trunk_only_repo_w_prerelease_tags: BuildSpecificRepoFn, example_project_git_repo: ExProjectGitRepoFn, example_project_dir: ExProjectDir, change_to_ex_proj_dir: None, ) -> BuiltRepoResult: repo_name = repo_w_trunk_only_n_prereleases_conventional_commits.__name__ commit_type: CommitConvention = repo_name.split("_")[-2] # type: ignore[assignment] return { "definition": build_trunk_only_repo_w_prerelease_tags( repo_name=repo_name, commit_type=commit_type, dest_dir=example_project_dir, ), "repo": example_project_git_repo(), } @pytest.fixture def repo_w_trunk_only_n_prereleases_emoji_commits( build_trunk_only_repo_w_prerelease_tags: BuildSpecificRepoFn, example_project_git_repo: ExProjectGitRepoFn, example_project_dir: ExProjectDir, change_to_ex_proj_dir: None, ) -> BuiltRepoResult: repo_name = repo_w_trunk_only_n_prereleases_emoji_commits.__name__ commit_type: CommitConvention = repo_name.split("_")[-2] # type: ignore[assignment] return { "definition": build_trunk_only_repo_w_prerelease_tags( repo_name=repo_name, commit_type=commit_type, dest_dir=example_project_dir, ), "repo": example_project_git_repo(), } @pytest.fixture def repo_w_trunk_only_n_prereleases_scipy_commits( build_trunk_only_repo_w_prerelease_tags: BuildSpecificRepoFn, example_project_git_repo: ExProjectGitRepoFn, example_project_dir: ExProjectDir, change_to_ex_proj_dir: None, ) -> BuiltRepoResult: repo_name = repo_w_trunk_only_n_prereleases_scipy_commits.__name__ commit_type: CommitConvention = repo_name.split("_")[-2] # type: ignore[assignment] return { "definition": build_trunk_only_repo_w_prerelease_tags( repo_name=repo_name, commit_type=commit_type, dest_dir=example_project_dir, ), "repo": example_project_git_repo(), }