pub_api_client 1.0.5

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

An unofficial API client for Pub.dev

Implements all known endpoints available on pub.dev. If any particular endpoint is missing please open an issue.

Usage

A simple usage example:

import 'package:pub_api_client/pub_api_client.dart';

main() {
  final client =  PubClient();
}

Get Package Info

Retrieves all available information about an specific package.

  final package =  await client.getPackage('pkg_name');

Get Package Score

Returns the following score information about a package.

• Pub Points
• Popularity
• Likes

  final score =  await client.getScore('pkg_name');

Get Package Versions

The method getPackage also returns the versions. However if all you need is versions use this method since it's lighter.

  final package =  await client.getVersions('pkg_name');

Search Packages

Allows you to search for packages on pub.dev. Will return the packages that match the query.

final results =  await client.search('query');
// Returns the packages that match the query
print(results.packages)

Paging Search Results

You are able to page search results.

final results =  await client.search('query');
final nextResults = await results.nextPage();

print(nextResults.packages)

If you want to retrieve a specific result page you can call the page parameter directly.

final results =  await client.search('query',page:2);
print(results.packages)

Update Notification

This package has a helper method if you want to notify users of your CLI of a newer version. In order to check for update you have to provide currentVersion.

Check Update Printer

This is a helper that automatically prints a notification on console.

import 'package:pub_api_client/pub_api_client.dart';

await checkUpdatePrinter('pkg_name', currentVersion:'1.0.0');

// Will print out the following as an example
# 'Update Available for pkg_name 1.0.0 → 1.0.1';
# 'Changelog: https://pub.dev/packages/pkg_name/changelog';

Custom Update Notification

final latest =  await client.checkLatest('pkg_name', currentVersion:'current_version');
// Returns the packages that match the query
print(latest.needUpdate) // bool if package needs update
print(latest.packageInfo) // Returns information about the package
print(latest.latestVersion) // Returns the latest version of the package.

Please file feature requests and bugs at the issue tracker.