pub_api_client

Breaking changes

• Added SearchOrder.trending for pub.dev's trend-score ordering. Consumers
  with an exhaustive switch over SearchOrder must add a trending case.

Added

• packageLikes — public like count of a package, no authentication required.
• publisherInfo — public publisher profile.
• packageVersionScore — score of a single package version.
• packageVersionOptions — retraction status of a single package version.
• topicNameCompletion — every topic mapped to its package count.
• SearchResults.message, set when pub.dev could not fully honor the query.
• PackageScoreCard.weeklyVersionDownloads, WeeklyVersionDownloads, and
  VersionRangeWeeklyDownloads for total and version-range download histories.
• Repository.fromMap and Repository.fromJson.
• Re-exported the pubspec_parse dependency types exposed through
  PubPackage.latestPubspec.

Fixed

• Search queries and tags now percent-encode reserved characters such as #
  and & instead of silently truncating the request.
• fetchGooglePackages no longer sends a malformed tools.dart.dev publisher
  tag and now includes labs.dart.dev.

Deprecated

• SearchOrder.popularity; use SearchOrder.downloads.
• PackageScore.popularityScore; use
  PackageScore.downloadCount30Days.
• LatestVersion; compare PubPackage.version directly. Removal is scheduled
  for 5.0.0.

Other changes

• Documented pub.dev's 10-page search limit and its effect on recursive search
  helpers.
• Modernized analysis, CI, and automated publishing. Releases now authenticate
  to pub.dev with GitHub OIDC instead of a long-lived workflow credential.

Full changelog: 3.2.0...4.0.0

Breaking changes

• Added SearchOrder.trending for pub.dev's trend-score ordering. Consumers with an exhaustive switch over SearchOrder must add a trending case

Added

• packageLikes — public like count of a package, no authentication required (GET /api/packages/<package>/likes)
• publisherInfo — public publisher profile (GET /api/publishers/<publisherId>)
• packageVersionScore — score of a single package version (GET /api/packages/<package>/versions/<version>/score)
• packageVersionOptions — retraction status of a single package version (GET /api/packages/<package>/versions/<version>/options)
• topicNameCompletion — every topic mapped to its package count (GET /api/topic-name-completion-data)
• SearchResults.message, set when pub.dev could not fully honour the query
• PackageScoreCard.weeklyVersionDownloads, WeeklyVersionDownloads, and VersionRangeWeeklyDownloads — total weekly downloads plus major, minor, and patch version-range histories #78
• Repository.fromMap and Repository.fromJson, matching the other models
• Re-export the pubspec_parse dependency types (Dependency, HostedDependency, GitDependency, PathDependency, SdkDependency, HostedDetails, Pubspec) so consumers can name the types reachable from PubPackage.latestPubspec #78

Fixed

• Search queries are now percent-encoded. Previously a # or & in the query or in a tag silently truncated the request, so searches like c# & c++ returned results for c
• fetchGooglePackages no longer sends a malformed tools.dart.dev publisher tag, and now includes the labs.dart.dev publisher

Deprecated

• SearchOrder.popularity — pub.dev retired the popularity score and serves these requests as SearchOrder.top. Use SearchOrder.downloads
• PackageScore.popularityScore — pub.dev no longer returns this field. Use PackageScore.downloadCount30Days
• LatestVersion — unreachable model; no endpoint returns it and no client method produces it. Scheduled for removal in 5.0.0

Changed

• Documented that search paging is capped at 10 pages (100 results) by pub.dev. The cap applies once to fetchAllPackages, fetchPublisherPackages, and fetchFlutterFavorites, and separately for each publisher queried by fetchGooglePackages
• Generated *.mapper.dart files are excluded from analysis, and three lint rules removed from the Dart SDK were dropped from analysis_options.yaml

Breaking changes

• Added SearchOrder.trending for pub.dev's trend-score ordering. Consumers with an exhaustive switch over SearchOrder must add a trending case

Added

• packageLikes — public like count of a package, no authentication required ( GET /api/packages/<package>/likes )

• publisherInfo — public publisher profile ( GET /api/publishers/<publisherId> )

• packageVersionScore — score of a single package version ( GET /api/packages/<package>/versions/<version>/score )

• packageVersionOptions — retraction status of a single package version ( GET /api/packages/<package>/versions/<version>/options )

• topicNameCompletion — every topic mapped to its package count ( GET /api/topic-name-completion-data )

• SearchResults.message , set when pub.dev could not fully honour the query

• PackageScoreCard.weeklyVersionDownloads , WeeklyVersionDownloads , and VersionRangeWeeklyDownloads — total weekly downloads plus major, minor, and patch version-range histories #78

• Repository.fromMap and Repository.fromJson , matching the other models

• Re-export the pubspec_parse dependency types ( Dependency , HostedDependency , GitDependency , PathDependency , SdkDependency , HostedDetails , Pubspec ) so consumers can name the types reachable from PubPackage.latestPubspec #78

Fixed

• Search queries are now percent-encoded. Previously a # or & in the query or in a tag silently truncated the request, so searches like c# & c++ returned results for c

• fetchGooglePackages no longer sends a malformed tools.dart.dev publisher tag, and now includes the labs.dart.dev publisher

Deprecated

• SearchOrder.popularity — pub.dev retired the popularity score and serves these requests as SearchOrder.top . Use SearchOrder.downloads

• PackageScore.popularityScore — pub.dev no longer returns this field. Use PackageScore.downloadCount30Days

• LatestVersion — unreachable model; no endpoint returns it and no client method produces it. Scheduled for removal in 5.0.0

Changed

• Documented that search paging is capped at 10 pages (100 results) by pub.dev. The cap applies once to fetchAllPackages , fetchPublisherPackages , and fetchFlutterFavorites , and separately for each publisher queried by fetchGooglePackages

• Generated *.mapper.dart files are excluded from analysis, and three lint rules removed from the Dart SDK were dropped from analysis_options.yaml

• Expose discontinued/advisory metadata on PubPackage and drop the large cached fixture from version control #75
• Include the GitHub repository URL in the default User-Agent header #69
• Improve WWW-Authenticate header parsing for authorization errors #70
• Make lastUpdated optional by @Rexios80 in #61

• Expose discontinued/advisory metadata on PubPackage and drop the large cached fixture from version control #75

• Include the GitHub repository URL in the default User-Agent header #69

• Improve WWW-Authenticate header parsing for authorization errors #70

• Make lastUpdated optional by @Rexios80 in #61

What's Changed

• Download count is nullable by @Rexios80 in #59

Full Changelog: 3.1.0...3.1.1

• Download count is nullable by @Rexios80 in #59

• Download count is nullable by @Rexios80 in #59

What's Changed

• Adds topic tag by @Rexios80 in #53
• Make granted/max points nullable again by @Rexios80 in #56
• Add support for download counts by @Rexios80 in #58
• Better recursive paging by @Rexios80 in #54
• Add package names endpoint by @Rexios80 in #55

Full Changelog: 3.0.0...v3.1.0

• Adds topic tag by @Rexios80 in #53
• Make granted/max points nullable again by @Rexios80 in #56
• Add support for download counts by @Rexios80 in #58
• Better recursive paging by @Rexios80 in #54
• Add package names endpoint by @Rexios80 in #55

• Adds topic tag by @Rexios80 in #53

• Make granted/max points nullable again by @Rexios80 in #56

• Add support for download counts by @Rexios80 in #58

• Better recursive paging by @Rexios80 in #54

• Add package names endpoint by @Rexios80 in #55

• Replaced deprecated pubspec to pubspec_parse package
• Extensions for Pubspec, repository, issueTracker, screenshots, and issueTracker are now properties and not methods, for consistency with pubspec_parse

Full Changelog: 2.7.1...3.0.0

• Replaced deprecated pubspec to pubspec_parse package
• Extensions for Pubspec, repository, issueTracker, screenshots, and issueTracker are now properties and not methods, for consistency with pubspec_parse

• Replaced deprecated pubspec to pubspec_parse package

• Extensions for Pubspec, repository, issueTracker, screenshots, and issueTracker are now properties and not methods, for consistency with pubspec_parse

What's Changed

• Fix result data class by @tilucasoli in #50

New Contributors

• @tilucasoli made their first contribution in #50

Full Changelog: 2.7.0...2.7.1

• Fix result data class schema #50

• Fix result data class schema #50

What's Changed

• Updated schema by @leoafarias in #48
• Add missing field to pubspec by @jxstxn1 in #47

New Contributors

• @jxstxn1 made their first contribution in #47

Full Changelog: 2.6.0...3.0.0

• Updated schema by @leoafarias
• Added missing field to pubspec by @jxstxn1

• Updated schema by @leoafarias

• Added missing field to pubspec by @jxstxn1

What's Changed

• Fixes issue when closing client by @leoafarias in #40
• Added topics to search method by @leoafarias in #41

Full Changelog: 2.5.0...2.6.0

• Feature: Added topics parameters to search method
• Chore: Improved models' equality and toString methods
• Fix: Hanging on close #40

• Feature: Added topics parameters to search method

• Chore: Improved models' equality and toString methods

• Fix: Hanging on close #40

What's Changed

• Update dependencies; Dart SDK version to 3.0.0. by @gmpassos in #36
• Ability to customize user agent by @leoafarias in #37
• Fix/handle invalid json error by @leoafarias in #38
• Chore/update doc endpoint by @leoafarias in #39

New Contributors

• @gmpassos made their first contribution in #36

Full Changelog: 2.4.0...2.5.0

• Feature: Ability to customize user-agent
• Chore: Set the minimum Dart SDK version to 3.0.0 by @gmpassos
• Chore: Updated dependencies by @gmpassos
• Chore: Switched analysis to use lints by @gmpassos
• Chore: Pub.dev API no longer returns latestStableVersion for documentation endpoint
• Fix: Handle invalid JSON on exception

• Feature: Ability to customize user-agent

• Chore: Set the minimum Dart SDK version to 3.0.0 by @gmpassos

• Chore: Updated dependencies by @gmpassos

• Chore: Switched analysis to use lints by @gmpassos

• Chore: Pub.dev API no longer returns latestStableVersion for documentation endpoint

• Fix: Handle invalid JSON on exception

• Added the ability to search with any tags #32 thanks @Rexios80

• Added the ability to search with any tags #32 thanks @Rexios80

• Updated dependencies
• Removed freezed

• Updated dependencies

• Removed freezed

Thank you @Rexios80 for all the great contributions

• Chore: Updated dependencies
• Fix: Recursive paging shares client
• Added: More tests

Thank you @Rexios80 for all the great contributions

• Chore: Updated dependencies

• Fix: Recursive paging shares client

• Added: More tests

• Fixed Client interface for custom HTTP Client by @Rexios80 #17
• Added Flutter Favorites, Google Packages, and Publisher Package request helpers.

• Fixed Client interface for custom HTTP Client by @Rexios80 #17

• Added Flutter Favorites, Google Packages, and Publisher Package request helpers.

• Added close method to PubClient

• Added close method to PubClient

Fixed

• Exposed SearchOrder for sorting

Fixed

• Exposed SearchOrder for sorting

Added

• Ability to sort search results

Added

• Ability to sort search results

Changed

• PackageScore nullable fields. Package metrics do not return fields when the package is being processed. #10

Changed

• PackageScore nullable fields. Package metrics do not return fields when the package is being processed. #10

Changed

• PublisherId is now a nullable string

Changed

• PublisherId is now a nullable string

Added

• Better exception messaging

Added

• Better exception messaging

Added

• Support for retrieving pub credentials on Windows

Added

• Support for retrieving pub credentials on Windows

Added

• Ability to list liked packages
• Like and unlike a package

Added

• Ability to list liked packages

• Like and unlike a package

Added

• Ability to get all package names for completion functionality

Changed

• Fetching Google packages calls hosted static file

Removed

• Check latest update API
• Deprecated packages to keep a smaller dependency tree

Added

• Ability to get all package names for completion functionality

Changed

• Fetching Google packages calls hosted static file

Removed

• Check latest update API

• Deprecated packages to keep a smaller dependency tree

Changed

• Deprecated checkUpdatePrinter
• Null safety

Changed

• Deprecated checkUpdatePrinter

• Null safety

Changed

• Ability to pass custom HTTP Client as a parameter
• Changed latest version to display stable version only

Changed

• Ability to pass custom HTTP Client as a parameter

• Changed latest version to display stable version only

Changed

• Added search filter for publisher or for dependency
• Added Google packages helpers

Changed

• Added search filter for publisher or for dependency

• Added Google packages helpers

Changed

• Added package publisher
• Added package options
• Added package version info
• Added documentation
• Exposed models

Changed

• Added package publisher

• Added package options

• Added package version info

• Added documentation

• Exposed models

Changed

• Better pubspec parsing

Changed

• Better pubspec parsing

Changed

• Added check for package update
• Added console printer for package update

Changed

• Added check for package update

• Added console printer for package update

Changed

• Added user-agent to requests

Changed

• Added user-agent to requests

Changed

• Further improvements

Changed

• Further improvements

Changed

• Test improvements and API cleanup

Changed

• Test improvements and API cleanup

Changed

• Initial version

Changed

• Initial version

70

likes

160

points

168k

downloads

Documentation

API reference

Publisher

leoafarias.com

Weekly Downloads

Metadata

An API Client for Pub to interact with public package information.

Repository (GitHub)

View/report issues

License

MIT ( license )

Dependencies

dart_mappable , http , oauth2 , path , pubspec_parse

More

Packages that depend on pub_api_client

← Metadata

70

likes

160

points

168k

downloads

Documentation

API reference

Publisher

leoafarias.com

Weekly Downloads

Metadata

An API Client for Pub to interact with public package information.

Repository (GitHub)

View/report issues

License

MIT ( license )

Dependencies

dart_mappable , http , oauth2 , path , pubspec_parse

More

Packages that depend on pub_api_client

Back