Skip to content
Back to top
View this page

# semantic_release.errors module

Custom Errors

exception semantic_release.errors.AssetUploadError

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.BuildDistributionsError

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.CommitParseError

  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

  Bases: `SemanticReleaseBaseError`

  Raised when the git repository is in a detached HEAD state

exception semantic_release.errors.GitAddError

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.GitCommitEmptyIndexError

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.GitCommitError

  Bases: `SemanticReleaseBaseError`

  Raised when there is a failure to commit the changes.

exception semantic_release.errors.GitFetchError

  Bases: `SemanticReleaseBaseError`

  Raised when there is a failure to fetch from the git remote.

exception semantic_release.errors.GitPushError

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.GitTagError

  Bases: `SemanticReleaseBaseError`

  Raised when there is a failure to tag the release.

exception semantic_release.errors.IncompleteReleaseError

  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

  Bases: `SemanticReleaseBaseError`

  Raised when an internal error occurs, which should never happen

exception semantic_release.errors.InvalidConfiguration

  Bases: `SemanticReleaseBaseError`

  Raised when configuration is deemed invalid

exception semantic_release.errors.InvalidParserOptions

  Bases: `InvalidConfiguration`

  Raised when the parser options are invalid

exception semantic_release.errors.InvalidVersion

  Bases: `ValueError`, `SemanticReleaseBaseError`

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

exception semantic_release.errors.LocalGitError

  Bases: `SemanticReleaseBaseError`

  Raised when there is a failure with local git operations.

exception semantic_release.errors.MissingGitRemote

  Bases: `SemanticReleaseBaseError`

  Raised when repository is missing the configured remote origin or upstream

exception semantic_release.errors.MissingMergeBaseError

  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

  Bases: `InvalidConfiguration`

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

exception semantic_release.errors.ParserLoadError

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.SemanticReleaseBaseError

  Bases: `Exception`

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

exception semantic_release.errors.UnexpectedResponse

  Bases: `SemanticReleaseBaseError`

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

exception semantic_release.errors.UnknownUpstreamBranchError

  Bases: `SemanticReleaseBaseError`

  Raised when the upstream branch cannot be determined.

exception semantic_release.errors.UpstreamBranchChangedError

  Bases: `SemanticReleaseBaseError`

  Raised when the upstream branch has changed before pushing.