ķàþî šţàţüš

Šĥöŵ ŵĥéŕé ţĥé þŕöĵéçţ šţàñđš: þéŕ-šçöþé çöṽéŕàĝé àĝàîñšţ ţĥé šĥîþ ĝàţéš àñđ, öñ à çöññéçţéđ þŕöĵéçţ, ţĥé šéŕṽéŕ đéļţà àñđ ţĥé ṽéñüé kapi up ŵöüļđ ŕüñ öñ. Ţĥé šàḿé çöṽéŕàĝé àñđ šĥîþ šţàţéš àþþéàŕ öñ ţĥé þŕöĵéçţ đàšĥƃöàŕđ îñ ţĥé ƃŕöŵšéŕ. kapi status àļŵàýš éẋîţš 0, ƃéçàüšé à ļöçàļé ţĥàţ îš ƃéĥîñđ îš þéñđîñĝ ŵöŕķ.

Üšàĝé

kapi status [flags]

Ŵĥàţ îţ šĥöŵš

Ţĥé çöṽéŕàĝé ĝŕîđ

Öñé ŕöŵ þéŕ šçöþé, à ļöçàļé öŕ à locale/collection þàîŕ, ŵîţĥ ţĥé ñüḿƃéŕ öƒ ƃļöçķš, öñé çöļüḿñ þéŕ ŕüñĝ öƒ ţĥé ţàŕĝéţ ļàđđéŕ (ţĥé šĥàŕé öƒ ƃļöçķš ţĥàţ ĥàṽé ŕéàçĥéđ đŕàƒţîñĝ, ţŕàñšļàţîöñ, ŕéṽîéŵ), à þîþéļîñé ƃàŕ šĥöŵîñĝ đîšţàñçé ţö ţĥé ƃàŕ, àñđ à šĥîþ çöļüḿñ. Ţĥé šĥîþ çöļüḿñ šĥöŵš à ṽéŕđîçţ:

• approved (à þéŕšöñ àþþŕöṽéđ ţĥé çöñţéñţ) öŕ translated (ţŕàñšļàţéđ ŵîţĥ îţš çĥéçķš ĝŕééñ) ŵĥéñ ţĥé šçöþé çļéàŕš îţš ĝàţé;
• blocked: <rung>, ñàḿîñĝ ţĥé ƒîŕšţ üñḿéţ ĝàţé, šö îţ þöîñţš àţ ţĥé ŵöŕķ;
• not gated ŵĥéñ ñö ĝàţé ḿàţçĥéš ţĥé šçöþé.

Üñđéŕ ţĥé ĝŕîđ, ţŵö ļîñéš ŕéþöŕţ ĥöŵ ḿàñý ţŕàñšļàţîöñš çàŕŕý à đéçîšîöñ ḿàđé àĝàîñšţ çöñţéñţ ţĥàţ ĥàš šîñçé çĥàñĝéđ, àñđ ĥöŵ ḿàñý ñöƃöđý ĥàš ĵüđĝéđ ýéţ. À þŕöĵéçţ ţĥàţ ñàḿéš ñö ţàŕĝéţ ļàñĝüàĝé ŕéþöŕţš îţšéļƒ àš ḿöñöļîñĝüàļ.

Ţĥé šéŕṽéŕ šéçţîöñ

Öñ à çöññéçţéđ þŕöĵéçţ (ţĥé ŕéçîþé đéçļàŕéš à bowrain: ƃļöçķ), ţĥé þļüĝîñ àđđš ţĥé šéŕṽéŕ'š šţàñđîñĝ: ţĥé šéŕṽéŕ ÜŔĻ àñđ þŕöĵéçţ, ƃļöçķš þéñđîñĝ þüšĥ àñđ þéñđîñĝ þüļļ àĝàîñšţ ţĥé ţŕéé ţĥé þŕöĵéçţ ļàšţ đéçļàŕéđ (šéé kapi push), ţĥé ļàšţ šýñç ţîḿé, àñý ŕüñ îñ ƒļîĝĥţ, àñđ ţŵö ḿöŕé ļîñéš:

• ţéŕḿš: ŵĥéñ ţĥé ŵöŕķšþàçé'š ĝöṽéŕñéđ ţéŕḿš ŵéŕé ļàšţ šñàþšĥöţţéđ îñţö ţĥé ļöçàļ ţéŕḿš šţöŕé (çöñçéþţ àñđ ŕéļàţîöñ çöüñţš), öŕ never synced ŵĥéñ ñö çöñçéþţ þüļļ ĥàš ŕüñ; ŕéƒŕéšĥ ŵîţĥ kapi pull --concepts.
• ĝöṽéŕñàñçé: ĥöŵ ţĥîš þŕöĵéçţ'š đéçļàŕéđ þöîñţš, çĥàññéļš àñđ ṽöîçé çöḿþàŕé ŵîţĥ ţĥé ŵöŕķšþàçé'š, šö ýöü šéé à đîṽéŕĝéñçé ƃéƒöŕé à þüšĥ ŕéþöŕţš îţ.

Ţĥé ṽéñüé

Ŵĥéŕé kapi up ŵöüļđ ŕüñ ţĥé ļööþ, server öŕ local, ŵîţĥ ţĥé ŕéçîþé'š bowrain.converge þöļîçý, àñđ à ñöţé ŵĥéñ ţĥé ṽéñüé îš đéĝŕàđéđ (à šéŕṽéŕ îš đéçļàŕéđ ƃüţ ţĥé ƃöŵŕàîñ þļüĝîñ îš ḿîššîñĝ).

Öþţîöñš

Ƒļàĝ	Đéšçŕîþţîöñ
--locale	Ļîḿîţ ţĥé ĝŕîđ ţö à šîñĝļé ţàŕĝéţ ļöçàļé
--source-lang	Šöüŕçé ļàñĝüàĝé (öṽéŕŕîđéš ţĥé þŕöĵéçţ'š source_language)
--review	Ļîšţ ţĥé ƃļöçķš àŵàîţîñĝ ŕéṽîéŵ îñ éṽéŕý ļàñĝüàĝé, ţĥé šöüŕçé ļàñĝüàĝé àḿöñĝ ţĥéḿ, îñšţéàđ öƒ ţĥé ĝŕîđ; àþþŕöṽé à ţŕàñšļàţéđ öñé ŵîţĥ kapi apply
--lang <tag>	Ŵîţĥ --review, ļîšţ öñļý ţĥéšé ļàñĝüàĝéš (ŕéþéàţàƃļé, öŕ çöḿḿà-šéþàŕàţéđ)
--ship	Éḿîţ ţĥé ḿîñîḿàļ ship.json ḿàñîƒéšţ (ļöçàļé → šĥîþþàƃļé, šţàţé, àñđ àñý đîḿéñšîöñ ţĥàţ ĝöṽéŕñš ñöţĥîñĝ ţĥéŕé) îñšţéàđ öƒ ţĥé ĝŕîđ: ţĥé šĥàþé à ļàñĝüàĝé þîçķéŕ çöñšüḿéš ţö ĥîđé ļöçàļéš ţĥàţ àŕé ñöţ šĥîþþàƃļé àñđ ƃàđĝé ţĥöšé šĥîþþéđ öñ ḿàçĥîñé ŕéṽîéŵ
--emit <path>	Ŵîţĥ --ship, ŵŕîţé ţĥé ḿàñîƒéšţ ţö ţĥîš þàţĥ îñšţéàđ öƒ šţđöüţ
--json	Öüţþüţ ţĥé šţŕüçţüŕéđ ŕéšüļţ àš ĴŠÖÑ

kapi status --ship --emit ship.json àţ ƃüîļđ ţîḿé ŵŕîţéš ţĥé šàḿé ḿàñîƒéšţ ţĥé šéŕṽéŕ þüƃļîšĥéš àţ GET /api/v1/projects/:id/ship.json, šö à šîţé ƃüîļţ ƒŕöḿ à çĥéçķöüţ àñđ à šîţé ŕéàđîñĝ ţĥé šéŕṽéŕ àĝŕéé. Šéé Šĥîþ šţàţéš.

Éẋàḿþļéš

# The coverage grid, the server delta and the venue
kapi status

# One locale
kapi status --locale fr

# The review worklist, and one language of it
kapi status --review
kapi status --review --lang fr

# The ship manifest for a language picker, written at build time
kapi status --ship --emit public/ship.json

# Machine-readable
kapi status --json

Éẋîţ çöđéš

• 0: šţàţüš đîšþļàýéđ (ƃéĥîñđ îš þéñđîñĝ ŵöŕķ, ñöţ àñ éŕŕöŕ)
• 1: éŕŕöŕ (þŕöĵéçţ ñöţ ƒöüñđ, àñđ šö öñ)

Ŕéļàţéđ çöḿḿàñđš

• kapi diff: ţĥé çĥàñĝéđ ƃļöçķš, þéŕ ƒîļé
• kapi pull: ƒéţçĥ ţĥé šéŕṽéŕ'š çĥàñĝéš
• kapi push: šéñđ ļöçàļ çĥàñĝéš, àñđ ţĥé ţŕéé ţĥé đéļţà îš ḿéàšüŕéđ àĝàîñšţ
• kapi up: çàţçĥ ţĥé þŕöĵéçţ üþ
• kapi check --ship: ţĥé ĝàţé ţĥàţ ƒàîļš à ƃüîļđ

Ŵĥéñ ţö üšé

Ŕüñ kapi status ţö:

• Çĥéçķ ƃéƒöŕé þüšĥ ţö šéé ŵĥàţ ŵîļļ ƃé üþļöàđéđ
• Çĥéçķ àƒţéŕ þüļļ ţö šéé ŵĥàţ çĥàñĝéđ
• Šéé ŵĥàţ îš šĥîþþàƃļé ƃéƒöŕé à ŕéļéàšé, àñđ ŵĥàţ ƃļöçķš ţĥé ŕéšţ
• Ţŕöüƃļéšĥööţ šýñç îššüéš öŕ üñéẋþéçţéđ šţàţé