build ¤

def __init__(
    self,
    repository: str | Path,
    *,
    provider: ProviderRefParser | type[ProviderRefParser] | None = None,
    convention: ConventionType | None = None,
    parse_provider_refs: bool = False,
    parse_trailers: bool = False,
    sections: list[str] | None = None,
    bump_latest: bool = False,
    bump: str | None = None,
    zerover: bool = True,
    filter_commits: str | None = None,
    versioning: Literal["semver", "pep440"] = "semver",
):
    """Initialization method.

    Arguments:
        repository: The repository (directory) for which to build the changelog.
        provider: The provider to use (github.com, gitlab.com, etc.).
        convention: The commit convention to use (angular, etc.).
        parse_provider_refs: Whether to parse provider-specific references in the commit messages.
        parse_trailers: Whether to parse Git trailers in the commit messages.
        sections: The sections to render (features, bug fixes, etc.).
        bump_latest: Deprecated, use `bump="auto"` instead. Whether to try and bump latest version to guess new one.
        bump: Whether to try and bump to a given version.
        zerover: Keep major version at zero, even for breaking changes.
        filter_commits: The Git revision-range used to filter commits in git-log (e.g: `v1.0.1..`).
    """
    self.repository: str | Path = repository
    self.parse_provider_refs: bool = parse_provider_refs
    self.parse_trailers: bool = parse_trailers
    self.zerover: bool = zerover
    self.filter_commits: str | None = filter_commits

    # set provider
    if not isinstance(provider, ProviderRefParser):
        remote_url = self.get_remote_url()
        split = remote_url.split("/")
        provider_url = "/".join(split[:3])
        namespace, project = "/".join(split[3:-1]), split[-1]
        if callable(provider):
            provider = provider(namespace, project, url=provider_url)
        elif "github" in provider_url:
            provider = GitHub(namespace, project, url=provider_url)
        elif "gitlab" in provider_url:
            provider = GitLab(namespace, project, url=provider_url)
        elif "bitbucket" in provider_url:
            provider = Bitbucket(namespace, project, url=provider_url)
        else:
            provider = None
        self.remote_url: str = remote_url
    self.provider = provider

    # set convention
    if isinstance(convention, str):
        try:
            convention = self.CONVENTION[convention]()
        except KeyError:
            print(  # noqa: T201
                f"git-changelog: no such convention available: {convention}, using default convention",
                file=sys.stderr,
            )
            convention = BasicConvention()
    elif convention is None:
        convention = BasicConvention()
    elif not isinstance(convention, CommitConvention) and issubclass(convention, CommitConvention):
        convention = convention()
    self.convention: CommitConvention = convention

    # set sections
    sections = (
        [self.convention.TYPES[section] for section in sections] if sections else self.convention.DEFAULT_RENDER
    )
    self.sections = sections

    # get version parser based on selected versioning scheme
    self.version_parser, self.version_bumper = {
        "semver": (parse_semver, bump_semver),
        "pep440": (parse_pep440, bump_pep440),
    }[versioning]

    # get git log and parse it into list of commits
    self.raw_log: str = self.get_log()
    self.commits: list[Commit] = self.parse_commits()
    self.tag_commits: list[Commit] = [commit for commit in self.commits[1:] if commit.tag]
    self.tag_commits.insert(0, self.commits[0])

    # apply dates to commits and group them by version
    v_list, v_dict = self._group_commits_by_version()
    self.versions_list = v_list
    self.versions_dict = v_dict

    # TODO: remove at some point
    if bump_latest:
        warnings.warn(
            "`bump_latest=True` is deprecated in favor of `bump='auto'`",
            DeprecationWarning,
            stacklevel=1,
        )
        if bump is None:
            bump = "auto"
    if bump:
        self._bump(bump)

def __init__(self, section_type: str = "", commits: list[Commit] | None = None):
    """Initialization method.

    Arguments:
        section_type: The section section_type.
        commits: The list of commits.
    """
    self.type: str = section_type
    self.commits: list[Commit] = commits or []

def __init__(
    self,
    tag: str = "",
    date: datetime.date | None = None,
    sections: list[Section] | None = None,
    commits: list[Commit] | None = None,
    url: str = "",
    compare_url: str = "",
):
    """Initialization method.

    Arguments:
        tag: The version tag.
        date: The version date.
        sections: The version sections.
        commits: The version commits.
        url: The version URL.
        compare_url: The version 'compare' URL.
    """
    self.tag = tag
    self.date = date

    self.sections_list: list[Section] = sections or []
    self.sections_dict: dict[str, Section] = {section.type: section for section in self.sections_list}
    self.commits: list[Commit] = commits or []
    self.url: str = url
    self.compare_url: str = compare_url
    self.previous_version: Version | None = None
    self.next_version: Version | None = None
    self.planned_tag: str | None = None