mtrust_api_guard 3.0.0 copy "mtrust_api_guard: ^3.0.0" to clipboard
mtrust_api_guard: ^3.0.0 copied to clipboard

A package to generate and compare API docs

3.0.0 #

Released on: 1/7/2026, changelog automatically generated.

Features #

  • add configurable tag prefix for version command (#14) (fa6fbdc)

API Changes #

💣 Breaking changes

function calculateNextVersion (lib/version/calculate_next_version.dart)

  • ❇️ Param added in function calculateNextVersion: tagPrefix (positional, required)

function version (lib/version/version.dart)

  • ❇️ Param added in function version: tagPrefix (named, required)

✨ Minor changes

class GitUtils (lib/doc_generator/git_utils.dart)

  • ❇️ Param added in method getVersions: tagPrefix (named, optional, default: 'v')
  • ❇️ Param added in method getPreviousRef: tagPrefix (named, optional, default: 'v')

class VersionCommand (lib/version/version_command.dart)

  • ❇️ Property added: tagPrefix

2.1.0 #

Released on: 12/17/2025, changelog automatically generated.

Bug Fixes #

  • disable commit flag in PR workflow (f4676e8)
  • correctly extract commits in changelog generation (c15f23e)

Features #

  • support enums, extensions, mixins, typedefs, superclasses and annotations (e2f7226)
  • enhance changelog generation with compare URLs (b317b55)
  • enhance API change detection with new operations for superclass, interfaces, and mixins (e151ce9)
  • add base URL option for changelog and API change formatting (7c38812)
  • add support for annotation addition and removal in API changes (50f71a3)
  • add support for mixins, extensions, typedefs and enums (45c9e96)

API Changes #

✨ Minor changes

class ApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Properties added: annotation, changedValue

class ApiChangeFormatter (lib/doc_comparator/api_change_formatter.dart)

  • ❇️ Param added in default constructor: fileUrlBuilder (named, optional)
  • ❇️ Property added: fileUrlBuilder

enum ApiChangeOperation (lib/doc_comparator/api_change.dart)

  • ❇️ Properties added: annotationAdded, annotationRemoved, superClassChanged, interfaceAdded, interfaceRemoved, mixinAdded, mixinRemoved

class ChangelogGenerator (lib/changelog_generator/changelog_generator.dart)

  • ❇️ Params added in default constructor: baseRef (named, optional), newRef (named, optional)
  • ❇️ Properties added: baseRef, newRef

class ComponentApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Params added in default constructor: annotation (named, optional), changedValue (named, optional)
  • ❇️ Properties added: annotation, changedValue

class ConstructorApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: annotation (named, optional)
  • ❇️ Properties added: annotation, changedValue

class ConstructorParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: annotation (named, optional)
  • ❇️ Properties added: annotation, changedValue

class DocComparatorCommand (lib/doc_comparator/doc_comparator_command.dart)

  • ❇️ Property added: baseUrl

class DocComponent (lib/models/doc_items.dart)

  • ❇️ Params added in default constructor: aliasedType (named, optional), annotations (named, optional, default: const []), superClass (named, optional), interfaces (named, optional, default: const []), mixins (named, optional, default: const [])
  • ❇️ Properties added: aliasedType, annotations, superClass, interfaces, mixins

enum DocComponentType (lib/models/doc_items.dart)

  • ❇️ Properties added: mixinType, enumType, typedefType, extensionType

class DocConstructor (lib/models/doc_items.dart)

  • ❇️ Param added in default constructor: annotations (named, optional, default: const [])
  • ❇️ Property added: annotations

class DocMethod (lib/models/doc_items.dart)

  • ❇️ Param added in default constructor: annotations (named, optional, default: const [])
  • ❇️ Property added: annotations

class DocParameter (lib/models/doc_items.dart)

  • ❇️ Param added in default constructor: annotations (named, optional, default: const [])
  • ❇️ Property added: annotations

class DocProperty (lib/models/doc_items.dart)

  • ❇️ Param added in default constructor: annotations (named, optional, default: const [])
  • ❇️ Property added: annotations

class DocVisitor (lib/doc_generator/doc_visitor.dart)

  • ❇️ Class added: DocVisitor

class GitUtils (lib/doc_generator/git_utils.dart)

  • ❇️ Methods added: getCurrentCommitHash, getRemoteUrl, buildCompareUrl, getCommits, getCommitsSinceLastTag

class MethodApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: annotation (named, optional)
  • ❇️ Properties added: annotation, changedValue

class MethodParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: annotation (named, optional)
  • ❇️ Properties added: annotation, changedValue

class ParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: annotation (named, optional)
  • ❇️ Properties added: annotation, changedValue

class PropertyApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: annotation (named, optional)
  • ❇️ Properties added: annotation, changedValue

👀 Patch changes

class ApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Params added in private constructor _: annotation (named, optional), changedValue (named, optional)

class ApiChangeFormatter (lib/doc_comparator/api_change_formatter.dart)

  • ❇️ Method added: _getComponentTypeLabel

class ChangelogGenerator (lib/changelog_generator/changelog_generator.dart)

  • ❌ Methods removed: _parseCommitLog, _getPackageVersion
  • ❇️ Method added: _getPubspecInfo

2.0.0 #

Released on: 12/11/2025, changelog automatically generated.

Bug Fixes #

  • git: stage new files before committing version bump (451dcb1)

Features #

  • enhance API change detection to include top-level functions (bd902f3)
  • enhance API change detection with method parameter comparison logic (2fa9470)
  • add MethodApiChange class and comparison logic for method changes (f5f7254)
  • add CacheCommand to manage/clear cache (547327a)

API Changes #

💣 Breaking changes

ConstructorParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❌ Property removed: parameter
  • ❌ Method removed: getMagnitude

DocComponent (lib/models/doc_items.dart)

  • 🔄 Param type changed in default constructor: methods (named, required)
  • 🔄 Property type changed: methods

✨ Minor changes

Cache (lib/doc_generator/cache.dart)

  • ❇️ Method added: getCacheDir

CacheCommand (lib/cache/cache_command.dart)

  • ❇️ Class added: CacheCommand

ConstructorParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Param added in default constructor: oldName (named, optional)

DocComponent (lib/models/doc_items.dart)

  • ❇️ Param added in default constructor: type (named, optional, default: DocComponentType.classType)
  • ❇️ Property added: type

DocMethod (lib/models/doc_items.dart)

  • ❇️ Class added: DocMethod

DocParameter (lib/models/doc_items.dart)

  • ❇️ Param added in default constructor: defaultValue (named, optional)
  • ❇️ Property added: defaultValue

MethodApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Class added: MethodApiChange

MethodParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Class added: MethodParameterApiChange

ParameterApiChange (lib/doc_comparator/api_change.dart)

  • ❇️ Class added: ParameterApiChange

👀 Patch changes

_$DocMethodFromJson (lib/models/doc_items.dart)

  • ❇️ Function added: _$DocMethodFromJson

_$DocMethodToJson (lib/models/doc_items.dart)

  • ❇️ Function added: _$DocMethodToJson

1.0.1 #

Released on: 12/8/2025, changelog automatically generated.

Bug Fixes #

  • add annotation message to git tag command so that the --follow-tags param from the workflow succeeds (e23fb1d)
  • properly push version badge and tag from workflow (ae2ffd9)
  • properly push version badge and tag from workflow (452c9c2)
  • string escaping comment, honor analysis_options.yaml excludes and use mason_logger (#1) (99079e9)
  • git: stage new files before committing version bump (451dcb1)
  • remove examples/ dir in order to satisfy pub.dev package requirements (da32b65)

1.0.0 #

Released on: 12/8/2025, changelog automatically generated.

Bug Fixes #

  • add annotation message to git tag command so that the --follow-tags param from the workflow succeeds (e23fb1d)
  • properly push version badge and tag from workflow (ae2ffd9)
  • properly push version badge and tag from workflow (452c9c2)
  • string escaping comment, honor analysis_options.yaml excludes and use mason_logger (#1) (99079e9)
  • update constructor reference in API change tracking (4028006)

Features #

  • add JSON serialization methods for documentation types and move library types to a new file (e04c07c)
  • add Git ref inputs for base documentation context (fd47bb5)
  • add customizable PR comment message template and prepare content dynamically (6ed85f0)
  • initial commit of M-Trust API Guard (ed5f21d)
  • remove examples/ dir in order to satisfy pub.dev package requirements (da32b65)

API Changes #

💣 Breaking changes

ApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Property type changed: component

ApiChangeFormatter (lib/doc_comparator/api_change_formatter.dart)

  • ❌ Property removed: showUpToMagnitude

ComponentApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

ConstructorApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

ConstructorParameterApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

PropertyApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

✨ Minor changes

ApiChangeFormatter (lib/doc_comparator/api_change_formatter.dart)

  • ❌ Param removed in constructor new: showUpToMagnitude
  • ❇️ Params added in constructor new: markdownHeaderLevel, magnitudes
  • ❇️ Properties added: magnitudes, markdownHeaderLevel, hasRelevantChanges, highestMagnitudeText

ApiGuardConfig (lib/config/config.dart)

  • ❇️ Class added: ApiGuardConfig

BadgeGeneratorCommand (lib/badges/badge_generator_command.dart)

  • ❇️ Class added: BadgeGeneratorCommand

Cache (lib/doc_generator/cache.dart)

  • ❇️ Class added: Cache

ChangelogGenerator (lib/changelog_generator/changelog_generator.dart)

  • ❇️ Class added: ChangelogGenerator

ChangelogGeneratorCommand (lib/changelog_generator/changelog_generator_command.dart)

  • ❇️ Class added: ChangelogGeneratorCommand

DocComparatorCommand (lib/doc_comparator/doc_comparator.dart)

  • ❇️ Properties added: out, magnitudes

DocComponent (lib/doc_items.dart)

  • ❇️ Param added in constructor new: filePath
  • ❇️ Property added: filePath

DocGeneratorCommand (lib/doc_generator/doc_generator.dart)

  • ❇️ Properties added: argParser, out, ref, help

GitException (lib/doc_generator/git_utils.dart)

  • ❇️ Class added: GitException

GitUtils (lib/doc_generator/git_utils.dart)

  • ❇️ Class added: GitUtils

PubspecUtils (lib/pubspec_utils.dart)

  • ❇️ Class added: PubspecUtils

VersionCommand (lib/version/version_command.dart)

  • ❇️ Class added: VersionCommand

VersionResult (lib/version/version.dart)

  • ❇️ Class added: VersionResult

👀 Patch changes

ApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in private constructor _: component

1.0.2 #

Released on: 12/8/2025, changelog automatically generated.

Bug Fixes #

  • add annotation message to git tag command so that the --follow-tags param from the workflow succeeds (e23fb1d)
  • properly push version badge and tag from workflow (ae2ffd9)
  • properly push version badge and tag from workflow (452c9c2)

1.0.1 #

Released on: 12/8/2025, changelog automatically generated.

Bug Fixes #

  • properly push version badge and tag from workflow (ae2ffd9)
  • properly push version badge and tag from workflow (452c9c2)
  • string escaping comment, honor analysis_options.yaml excludes and use mason_logger (#1) (99079e9)

1.0.0 #

Released on: 11/4/2025, changelog automatically generated.

Bug Fixes #

  • string escaping comment, honor analysis_options.yaml excludes and use mason_logger (#1) (99079e9)
  • update constructor reference in API change tracking (4028006)

Features #

  • add JSON serialization methods for documentation types and move library types to a new file (e04c07c)
  • add Git ref inputs for base documentation context (fd47bb5)
  • add customizable PR comment message template and prepare content dynamically (6ed85f0)
  • initial commit of M-Trust API Guard (ed5f21d)

API Changes #

💣 Breaking changes

ApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Property type changed: component

ApiChangeFormatter (lib/doc_comparator/api_change_formatter.dart)

  • ❌ Property removed: showUpToMagnitude

ComponentApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

ConstructorApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

ConstructorParameterApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

PropertyApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in constructor new: component

✨ Minor changes

ApiChangeFormatter (lib/doc_comparator/api_change_formatter.dart)

  • ❌ Param removed in constructor new: showUpToMagnitude
  • ❇️ Params added in constructor new: markdownHeaderLevel, magnitudes
  • ❇️ Properties added: magnitudes, markdownHeaderLevel, hasRelevantChanges, highestMagnitudeText

ApiGuardConfig (lib/config/config.dart)

  • ❇️ Class added: ApiGuardConfig

BadgeGeneratorCommand (lib/badges/badge_generator_command.dart)

  • ❇️ Class added: BadgeGeneratorCommand

Cache (lib/doc_generator/cache.dart)

  • ❇️ Class added: Cache

ChangelogGenerator (lib/changelog_generator/changelog_generator.dart)

  • ❇️ Class added: ChangelogGenerator

ChangelogGeneratorCommand (lib/changelog_generator/changelog_generator_command.dart)

  • ❇️ Class added: ChangelogGeneratorCommand

DocComparatorCommand (lib/doc_comparator/doc_comparator.dart)

  • ❇️ Properties added: out, magnitudes

DocComponent (lib/doc_items.dart)

  • ❇️ Param added in constructor new: filePath
  • ❇️ Property added: filePath

DocGeneratorCommand (lib/doc_generator/doc_generator.dart)

  • ❇️ Properties added: argParser, out, ref, help

GitException (lib/doc_generator/git_utils.dart)

  • ❇️ Class added: GitException

GitUtils (lib/doc_generator/git_utils.dart)

  • ❇️ Class added: GitUtils

PubspecUtils (lib/pubspec_utils.dart)

  • ❇️ Class added: PubspecUtils

VersionCommand (lib/version/version_command.dart)

  • ❇️ Class added: VersionCommand

VersionResult (lib/version/version.dart)

  • ❇️ Class added: VersionResult

👀 Patch changes

ApiChange (lib/doc_comparator/api_change.dart)

  • 🔄 Param type changed in private constructor _: component

0.0.1 #

  • First release