CLI command
probierz store release
Whether the App Store sells the version a product released.
Invocation#
probierz store release <APP>Required inputs and options#
<APP>is the product, asprobierz apps listnames it. Its manifest names its App Store page (inventory: {appStore: https://apps.apple.com/<country>/app/<name>/id<number>}) and its checkout holds the release file the release pipeline reads,.wisent-release.json, whoseversion_source(kindregex, apathand apatternwith aversiongroup) finds the released version in that file.inventory.appStoreDescriptionandinventory.appStoreReleaseNotes, each optional, name files of the product's repository holding the description its App Store page should show and the notes of the released version.
Output and state effects#
Reads the released version from the release file, asks Apple's lookup for the version on sale as store show does, compares them part by part between dots (1.10 after 1.9) and writes JSON: appId, link, released (version, file), store (version, released, releaseNotes, description, screenshots, the count of screenshots the page shows), verdict: current when they are the same, behind when the store sells an older version (the release is in review, was rejected or never submitted), ahead when it sells a newer one (the checkout is not at the released revision), and listing, null when the manifest keeps neither text: description and releaseNotes, each kept one as {verdict, file}, verdict being same when the page shows the file's text (line endings and the whitespace around it aside) and differs otherwise. Nothing is written.
Exact refusals#
versions-differ(exit 1):behindorahead, naming both versions, after the comparison is printed.listing-differsandnotes-differ(exit 1): the versions agree but the page shows another description, or other notes for the version on sale, than the file holds, naming the file, after the comparison is printed.store-undeclared(exit 1): the manifest names noinventory.appStore;release-unread(exit 1): the release file or the file it names cannot be read, is not JSON, has noversion_sourceof kindregexwith a path and a pattern, or the pattern does not compile or finds noversion;description-unreadandnotes-unread(exit 1):inventory.appStoreDescriptionorinventory.appStoreReleaseNotesis no path or its file cannot be read. Nothing is asked of any store.- The refusals of
store showfor the page, andlookup-unanswered(exit 69) when Apple states no version on sale. - Real test: tests/store/release.rs.
Declared refusals#
What probierz refusals list declares for this command at revision d2cd6156e8b8dc6204dab7b46ec0b34b2bb03cea (probierz 0.1.7 (revision unknown, not built from a git checkout)): each cause's id, the operation declaring it, its exit status and code, and its remedy.
workspace-unset(probierz.manifest.discover, exit 1, config): finding the repositories that hold product manifests: this instance names no workspace, so there is no directory of repositories to look in. runprobierz config set workspace <directory holding one checkout per repository>.workspace-unreadable(probierz.manifest.discover, exit 1, config): listing {workspace}: the operating system would not list it: {error}. give this user read permission on {workspace}, or set another workspace withprobierz config set workspace.listing-failed(probierz.manifest.discover, exit 1, config): asking the git of {repository} which manifests it tracks: {cause}. make {repository} a git repository this user can read.untracked(probierz.manifest.discover, exit 1, config): reading the manifests of {repository}: {file} is not tracked by the repository's git, so no other host and no review sees it. rungit -C {repository} add {relative}and commit it, or remove the file.duplicate(probierz.manifest.discover, exit 1, config): finding the manifest of {app}: two repositories declare {app}: {first} and {second}. keep the manifest of {app} in the product's own repository and remove the other.not-found(probierz.manifest.discover, exit 1, config): finding the manifest of {app}: no repository under {workspace} has .probierz/{app}.yaml. add .probierz/{app}.yaml to the product's repository (probierz project adoptorprobierz author manifestwrite it), or name an appprobierz apps listlists.file-name-invalid(probierz.manifest.discover, exit 1, config): finding the manifests of {repository}: {file} names app "{app}", which is not an id: letters, digits, '.', '_' and '-', starting with a letter or digit. rename it .probierz/<appId>.yaml with the id it declares, withgit mv.repository-name-invalid(probierz.manifest.discover, exit 1, config): finding repository "{name}" in the workspace: a manifest names a checkout directly under the workspace, and "{name}" would name another place. name the checkout by its directory name under the workspace in repositories[].repository.app-id-invalid(probierz.manifest.load, exit 2, refused): naming an app: "{app}" is not an id: letters, digits, '.', '_' and '-', starting with a letter or digit. name an appprobierz apps listlists.manifest-unreadable(probierz.manifest.load, exit 1, config): reading {file}: {error}. write {file} as YAML the reader accepts (its line and column are named), then load it again.manifest-invalid(probierz.manifest.load, exit 1, config): judging {file}: {problem}. fix the declaration in {file};probierz app checknames every problem it has with the world once it loads.manifest-id-mismatch(probierz.manifest.load, exit 1, config): loading the manifest of {app}: {file} is named for {app} and declares appId {declared}. declareappId: {app}in {file}, or rename the file for the app it declares withgit mv.link-invalid(probierz.store, exit 2, refused): reading the store link {link}: it is no https link to an app's page on the App Store (anid<number>under apps.apple.com) or on Google Play (play.google.com/store/apps/details withid=<package>). give the app's page as the store shares it: https://apps.apple.com/<country>/app/<name>/id<number> or https://play.google.com/store/apps/details?id=<package>.app-unknown(probierz.store, exit 1, not_found): finding the app {link} names: the App Store's {country} storefront holds no app id{id}: it was removed, or it is sold only in other countries. open the link in a browser to see whether the app is still sold; an app sold elsewhere is found through a link carrying that country's code, like https://apps.apple.com/pl/app/<name>/id{id}.lookup-unanswered(probierz.store, exit 69, infra_down): asking Apple's lookup {address} for the app: {problem}. check that this machine reaches itunes.apple.com over HTTPS (a proxy in HTTPS_PROXY is used when set), then ask again; an answer that is not Apple's record is said as it came.page-unreachable(probierz.store, exit 69, infra_down): reading the store page {page}: it could not be reached or read: {error}. check that this machine reaches the store over HTTPS (a proxy in HTTPS_PROXY is used when set), then ask again.page-unread(probierz.store, exit 1, not_found): reading the links of the store page {page}: {problem}. open the page in a browser: an app the store no longer sells answers an error, and a page whose links are there but unread is a change of the store's page that this command must follow.reviews-unpublished(probierz.store, exit 1, refused): reading the reviews of {package} on Google Play: Google publishes no reviews feed a program may read; its reviews are read only through the Google Play Developer API with the developer's own account. read them in the Play Console of the app's developer, or give the app's App Store link when it is sold there too.reviews-unanswered(probierz.store, exit 69, infra_down): reading Apple's reviews feed {address}: {problem}. check that this machine reaches itunes.apple.com over HTTPS (a proxy in HTTPS_PROXY is used when set), then ask again; an answer that is not the feed is said as it came.store-undeclared(probierz.store, exit 1, config): reading where {app} is sold: its manifest names no App Store page (inventory.appStore). write the app's page into the manifest:inventory: {appStore: https://apps.apple.com/<country>/app/<name>/id<number>}.release-unread(probierz.store, exit 1, config): reading the version {app} released from {file}: {problem}. give the product's checkout a .wisent-release.json whose version_source (kind regex, a path and a pattern with aversiongroup) finds the version in that file, as the release pipeline reads it.versions-differ(probierz.store, exit 1, refused): holding {app}'s App Store page to the version it released: the store sells {store} and the release file states {released}: the store is {verdict}. behind: submit the released version, or see why App Review has not approved it; ahead: bring the checkout to the revision that was released.description-unread(probierz.store, exit 1, config): reading the App Store description {app} keeps in {file}: {problem}. keep the description the App Store page should show in a file of the product's repository and name its path in the manifest:inventory: {appStoreDescription: <path>}.listing-differs(probierz.store, exit 1, refused): holding {app}'s App Store page to the description it keeps: the store shows another description than {file} holds. submit the description in the file with the next version, or bring the file to what the store shows if the store is right.notes-unread(probierz.store, exit 1, config): reading the App Store release notes {app} keeps in {file}: {problem}. keep the notes of the released version in a file of the product's repository and name its path in the manifest:inventory: {appStoreReleaseNotes: <path>}.notes-differ(probierz.store, exit 1, refused): holding {app}'s App Store page to the release notes it keeps: the store shows other notes for the version on sale than {file} holds. submit the notes in the file with the version, or bring the file to the notes the store shows if the store is right.
Source snapshot#
Generated from the Rust binaries at revision 99a74945a3598a8d73b6c6cbe5aae4f283becea3 of Probierz's private source repository.
Combined help SHA-256: 77529678a61237f774b59e76df0d1907cb749ef5da56d2ed913b040793b7d30b; binary SHA-256: be9e0eaff0e6ea50403a0c6f6d467697a4eac676f9523b8dc13a596d2b5526c5.