semantic_release.errors module

Custom Errors

exception semantic_release.errors.AssetUploadError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure uploading an asset to a remote hvcs’s release artifact storage.

exception semantic_release.errors.BuildDistributionsError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure to build the distribution files.

exception semantic_release.errors.CommitParseError[source]

Bases: SemanticReleaseBaseError

Raised when a commit cannot be parsed by a commit parser. Custom commit parsers should also raise this Exception

exception semantic_release.errors.DetachedHeadGitError[source]

Bases: SemanticReleaseBaseError

Raised when the git repository is in a detached HEAD state

exception semantic_release.errors.GitAddError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure to add files to the git index.

exception semantic_release.errors.GitCommitEmptyIndexError[source]

Bases: SemanticReleaseBaseError

Raised when there is an attempt to commit an empty index.

exception semantic_release.errors.GitCommitError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure to commit the changes.

exception semantic_release.errors.GitPushError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure to push to the git remote.

exception semantic_release.errors.GitTagError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure to tag the release.

exception semantic_release.errors.IncompleteReleaseError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure amongst one of the api requests when creating a release on a remote hvcs.

exception semantic_release.errors.InternalError[source]

Bases: SemanticReleaseBaseError

Raised when an internal error occurs, which should never happen

exception semantic_release.errors.InvalidConfiguration[source]

Bases: SemanticReleaseBaseError

Raised when configuration is deemed invalid

exception semantic_release.errors.InvalidVersion[source]

Bases: ValueError, SemanticReleaseBaseError

Raised when Version.parse attempts to parse a string containing an invalid version.

exception semantic_release.errors.MissingGitRemote[source]

Bases: SemanticReleaseBaseError

Raised when repository is missing the configured remote origin or upstream

exception semantic_release.errors.MissingMergeBaseError[source]

Bases: SemanticReleaseBaseError

Raised when the merge base cannot be found with the current history. Generally because of a shallow git clone.

exception semantic_release.errors.NotAReleaseBranch[source]

Bases: InvalidConfiguration

Raised when semantic_release is invoked on a branch which isn’t configured for releases

exception semantic_release.errors.ParserLoadError[source]

Bases: SemanticReleaseBaseError

Raised when there is a failure to find, load, or instantiate a custom parser definition.

exception semantic_release.errors.SemanticReleaseBaseError[source]

Bases: Exception

Base Exception from which all other custom Exceptions defined in semantic_release inherit

exception semantic_release.errors.UnexpectedResponse[source]

Bases: SemanticReleaseBaseError

Raised when an HTTP response cannot be parsed properly or the expected structure is not found.