Skip to content

Updater API documentation (v2)

o355 edited this page Mar 5, 2018 · 10 revisions

Welcome to the PyWeather Updater API version 2 documentation.

Purpose

The PyWeather Updater API is designed to be a future-proof, extensive information system that allows for future branches and more information later down the line, all while maintaining compatibility with any API version.

Changelog

  • v2.1.2 - Added depreciated branch information (March 4, 2018)
  • v2.1.1 - Added dirless file size information (February 7, 2018)
  • v2.1 - Added dirless file information (February 6, 2018)
  • v2.0.2 - Added next version release date (February 1, 2018)
  • v2.0.1 - Added md5, sha1, and sha256 sums (January 31, 2018)
  • v2.0 - Initial release

Info

The info section stores information about the API.

apiversion: Shows the API version (type: str, 2.0+)

documentation: Shows the documentation URL for the API. (type: str, 2.0+)

branch

This is the starting section of the different release branches, stable and RC.

stable

This section stores information about the stable release branch of PyWeather.

depreciated: Flags if the branch is depreciated (type: bool, 2.1.2+)

latestbuild: The latest build number (type: int, 2.0+)

latestversion: The latest version in text format (type: str, 2.0+)

latestversiontag: The latest version in Git tag format (type: str, 2.0+)

latesturl: The download URL for the latest version in the stable branch (type: str, 2.0+)

latestdirlessurl: The download URL for the latest dirless version in the stable branch (type: str, 2.1+)

latestfilename: The filename of the .zip for the latest version in the stable branch (type: str, 2.0+)

latestdirlessfilename: The filename of the .zip for the latest dirless version in the stable branch (type: str, 2.1+)

extractdirectory: The directory that the contents of PyWeather are stored in the latest .zip. (type: str, 2.0+)

releasedate: The release date of the latest stable version (type: str, 2.0+)

nextversionreleasedate: The release date of the next stable version (type: str, 2.0.2+)

size: The size of the .zip file of the latest version (type: str, 2.0+)

dirlesssize: The size of the dirless .zip file of the latest version (type: str, 2.1.1+)

releasenotesurl: The URL of the release notes for the latest stable version (type: str, 2.0+)

md5sum: The MD5 sum for the stable .zip (type: str, 2.0.1+)

sha1sum: The SHA-1 sum for the stable .zip (type: str, 2.0.1+)

sha256sum: The SHA-256 sum for the stable .zip (type: str, 2.0.1+)

md5sum-dirless: The MD5 sum for the stable dirless .zip (type: str, 2.1+)

sha1sum-dirless: The SHA1 sum for the stable dirless .zip (type: str, 2.1+)

sha256sum-dirless: The SHA256 sum for the stable dirless .zip (type: str, 2.1+)

rc

This section stores information about the rc release branch of PyWeather.

depreciated: Flags if the branch is depreciated (type: bool, 2.1.2+)

rcrelease: Indicates if the release info stated in ['branch']['rc'] is an rc build (type: boolean, 2.0+)

stablerelease: Indicates if the release info stated in ['branch']['rc'] is a stable build (type: boolean, 2.0+)

latestbuild: The latest build number (type: float, 2.0+)

latestversion: The latest version in text format (type: str, 2.0+)

latestversiontag: The latest version in Git tag format (type: str, 2.0+)

latesturl: The download URL for the latest version in the rc branch (type: str, 2.0+)

latestdirlessurl: The download URL for the latest dirless version in the rc branch (type: str, 2.1+)

latestfilename: The filename of the .zip for the latest version in the rc branch (type: str, 2.0+)

latestdirlessfilename: The filename of the dirless .zip for the latest version in the rc branch (type: str, 2.1+)

extractdirectory: The directory that the contents of PyWeather are stored in the latest .zip. (type: str, 2.0+)

releasedate: The release date of the latest rc version (type: str, 2.0+)

nextversionreleasedate: The release date of the next rc version (type: str, 2.0.2+)

size: The size of the .zip file of the latest version (type: str, 2.0+)

dirlesssize: The size of the dirless .zip file of the latest version (type: str, 2.1.1+)

releasenotesurl: The URL of the release notes for the latest rc version (type: str, 2.0+)

md5sum: The MD5 sum for the rc .zip (type: str, 2.0.1+)

sha1sum: The SHA-1 sum for the rc .zip (type: str, 2.0.1+)

sha256sum: The SHA-256 sum for the rc .zip (type: str, 2.0.1+)

md5sum-dirless: The MD5 sum for the rc dirless .zip (type: str, 2.1+)

sha1sum-dirless: The SHA1 sum for the rc dirless .zip (type: str, 2.1+)

sha256sum-dirless: THe SHA256 sum for the rc dirless .zip (type: str, 2.1+)

Clone this wiki locally