Skip to content

[appengine] Name Exception subclasses with the Exception suffix#328

Open
martin-dehlan wants to merge 1 commit into
dart-lang:mainfrom
martin-dehlan:appengine-exception-naming
Open

[appengine] Name Exception subclasses with the Exception suffix#328
martin-dehlan wants to merge 1 commit into
dart-lang:mainfrom
martin-dehlan:appengine-exception-naming

Conversation

@martin-dehlan

Copy link
Copy Markdown

Fixes #99.

Types implementing Exception are conventionally named *Exception, but the appengine error types were named *Error. This renames them:

  • AppEngineErrorAppEngineException
  • NetworkErrorNetworkException
  • ProtocolErrorProtocolException
  • ServiceErrorServiceException
  • ApplicationErrorApplicationException

The old *Error names are retained as @Deprecated type aliases, so the change is non-breaking — as suggested by @sigurdm in the issue. Internal references and test matchers are updated to the new names; the unrelated package:gcloud ApplicationError references are left untouched.

dart analyze reports no issues and dart format is clean. Added a CHANGELOG entry and bumped the version to 0.13.13-wip.

Types implementing `Exception` are conventionally named `*Exception`, but the
appengine error types were named `*Error`. Rename them to `AppEngineException`,
`NetworkException`, `ProtocolException`, `ServiceException` and
`ApplicationException`.

The old `*Error` names are kept as deprecated type aliases so the change is
non-breaking, as suggested in the issue.

Fixes dart-lang#99
@martin-dehlan martin-dehlan requested a review from a team as a code owner June 14, 2026 00:50
@google-cla

google-cla Bot commented Jun 14, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@martin-dehlan

Copy link
Copy Markdown
Author

@googlebot I signed it!

2 similar comments
@martin-dehlan

Copy link
Copy Markdown
Author

@googlebot I signed it!

@martin-dehlan

Copy link
Copy Markdown
Author

@googlebot I signed it!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Subclasses of of Exception should be named *Exception

1 participant