ķàþî àþþļý
kapi apply [flags] [CHANGESET]▒ Àþþļý à çĥàñĝé šéţ, ţĥé ŵŕîţé šîƃļîñĝ öƒ 'ķàþî îñšþéçţ'. À çĥàñĝé šéţ îš ķàþî.çĥàñĝé/ṽ1: öñé ĴŠÖÑ öƃĵéçţ ŵîţĥ îţš öþéŕàţîöñš üñđéŕ "öþš", ĴŠÖÑĻ ŵîţĥ ţĥé éñṽéļöþé ƒîéļđš öñ ţĥé ƒîŕšţ ļîñé àñđ öñé öþéŕàţîöñ þéŕ ļîñé, öŕ à ĴŠÖÑ àŕŕàý öƒ öþéŕàţîöñš. Îţ îš ŕéàđ ƒŕöḿ ÇĤÀÑĜÉŠÉŢ öŕ, ŵîţĥ ñö àŕĝüḿéñţ öŕ "-", ƒŕöḿ šţàñđàŕđ îñþüţ. 'ķàþî àþþļý --šçĥéḿà' þŕîñţš îţš ĴŠÖÑ Šçĥéḿà, àñđ 'ķàþî àþþļý --šçĥéḿà ÖÞ' ţĥé šçĥéḿà öƒ öþéŕàţîöñ ÖÞ àļöñé (šéţ_çöñţéñţ, ŕéþļàçé_ţéẋţ, šéţ_àţţŕîƃüţé, àñđ šö öñ).
Éàçĥ çöñţéñţ öþéŕàţîöñ ñàḿéš ŵĥàţ îţ çĥàñĝéš îñ "àţ" ({"doc", "block", "edition"}, ţĥé "ŕéƒ" ķàþî îñšþéçţ þŕîñţš ƒöŕ à ƃļöçķ) àñđ ţĥé ŕéṽîšîöñ îţ ŕéàđ îñ "îƒ_ḿàţçĥ" (ţĥé ƃļöçķ'š "ŕéṽ"). šéţ_çöñţéñţ ĝîṽéš àñ éđîţîöñ ñéŵ çöñţéñţ, îñ ţĥé þļàçéĥöļđéŕ ţéẋţ à ŕéàđ šĥöŵš öŕ àš ŕüñš, àñđ ŵîţĥ "îƒ_ḿàţçĥ": "àƃšéñţ" çŕéàţéš àñ éđîţîöñ. ŕéþļàçé_ţéẋţ çĥàñĝéš ţéẋţ îñšîđé àñ éđîţîöñ ƃý ƒîñđ, ƃý çöđé-þöîñţ öƒƒšéţš öŕ ƃý ŕüñ þöšîţîöñš, àñđ ķééþš ţĥé îñļîñé çöđéš àñđ þļüŕàļš àŕöüñđ îţ. Öƒƒšéţš àñđ ŕüñ þöšîţîöñš ñàḿé ţĥé éđîţîöñ àš îţ ŵàš ŕéàđ, éṽéñ àƒţéŕ àñ éàŕļîéŕ öþéŕàţîöñ öƒ ţĥé çĥàñĝé šéţ çĥàñĝéđ îţ; à ƒîñđ ḿàţçĥéš ţĥé ţéẋţ àš ţĥé éàŕļîéŕ öþéŕàţîöñš ļéƒţ îţ. À çĥàñĝé šéţ ŵîţĥ ñö öþéŕàţîöñ çĥàñĝéš ñöţĥîñĝ. Àñ öþéŕàţîöñ ŵĥöšé éđîţîöñ ḿöṽéđ šîñçé îţ ŵàš ŕéàđ îš ŕéƒüšéđ àš šţàļé ŵîţĥ ţĥé çüŕŕéñţ çöñţéñţ. Àñ éđîţ ţĥàţ ŵöüļđ đŕöþ, îñṽéñţ öŕ üñƃàļàñçé àñ îñļîñé çöđé, öŕ ƒļàţţéñ à þļüŕàļ öŕ šéļéçţ, îš ŕéƒüšéđ àš ĝüàŕđ. Ŵĥéñ àñý öþéŕàţîöñ îš ŕéƒüšéđ, ñöţĥîñĝ îñ ţĥé çĥàñĝé šéţ îš ŵŕîţţéñ. Àñ öþéŕàţîöñ öñ ţĥé ţŕàñšļàţîöñ à ƃîļîñĝüàļ ƒîļé (ẊĻÎƑƑ, ÞÖ) ĥöļđš ñàḿéš îţš ļàñĝüàĝé àš ţĥé éđîţîöñ, àñđ à ÞÖ çàţàļöĝ îš ŕéàđ îñ ţĥé öñé ļàñĝüàĝé ţĥé çĥàñĝé šéţ ñàḿéš.
đéçîđé ŕéçöŕđš à ŕéṽîéŵ đéçîšîöñ öñ ţĥé ŕéṽîšîöñ à þéŕšöñ ŕéàđ. ţéŕḿ, ḿéḿöŕý àñđ ŕéçîþé ŵŕîţé à ţéŕḿ, à çöñţéñţ-ḿéḿöŕý þàîŕ öŕ à ŕéçîþé ƒîéļđ îñţö ţĥé þŕöĵéçţ, àƒţéŕ ţĥé çöñţéñţ ţĥéý ŕéƒéŕ ţö. ķàþî àþþļý ŕéçöŕđš éṽéŕý çĥàñĝé àš ţĥé þéŕšöñ öŕ àĝéñţ ţĥé éñṽîŕöñḿéñţ ñàḿéš (šéé 'ķàþî ĥéļþ ĝŕöŵîñĝ-çöñţéẋţ'). Ţĥàţ ĥöļđš ƒöŕ à çĥàñĝé šéţ à ŕüñ þŕîñţéđ ŵîţĥ --þŕîñţ-öþš ţöö: ţĥé "öŕîĝîñ" îţš öþéŕàţîöñš šţàţé (ţĥé ţööļ ţĥàţ þŕöđüçéđ à ţŕàñšļàţîöñ) îš ñöţ ķéþţ, àñđ ķàþî àþþļý šàýš šö îñ öñé ļîñé. À đéçîšîöñ öţĥéŕ ţĥàñ àđṽîšé, à ţéŕḿ, à çöñţéñţ-ḿéḿöŕý þàîŕ àñđ à ŕéçîþé ƒîéļđ àŕé à þéŕšöñ'š: ŕüñ ƒŕöḿ àñ àĝéñţ'š šĥéļļ ţĥéý àŕé ŕéƒüšéđ.
À çöđé çöḿḿéñţ îš à ƃļöçķ öƒ îţš šöüŕçé ƒîļé, ķéýéđ àš 'ķàþî çĥéçķ' àñđ 'ķàþî îñšþéçţ' ŕéþöŕţ îţ (ƒüñç/Þàŕšé), îñ Ĝö àñđ îñ ţĥé ļàñĝüàĝéš à çöḿḿéñţ þļüĝîñ ŕéàđš. šéţ_çöñţéñţ ŕéŵŕîţéš îţ ŵîţĥ îţš ñéŵ þŕöšé îñ "ţéẋţ", ŵîţĥöüţ çöḿḿéñţ ḿàŕķéŕš, àñđ "îƒ_ḿàţçĥ" îš ţĥé çöḿḿéñţ'š "ŕéṽ" ƒŕöḿ ķàþî îñšþéçţ. Éṽéŕý ƃýţé öüţšîđé ţĥé çöḿḿéñţ šţàýš àš îţ îš, ţĥé ŕéšüļţ ḿüšţ þàŕšé, àñđ ţĥé ļàñĝüàĝé'š ƒöŕḿàţţéŕ ḿüšţ àĝŕéé; ŵĥàţ ŵàš ŵŕîţţéñ îš çĥéçķéđ àĝàîñ àñđ îţš ƒîñđîñĝš àŕé ŕéþöŕţéđ, àñđ à ƒàîļîñĝ öñé éẋîţš 3 üñļéšš --ĝàţé ŕéþöŕţ îš ĝîṽéñ. Ŕüññîñĝ ţĥàţ ƒöŕḿàţţéŕ ŕüñš çöđé ţĥé þŕöĵéçţ çöñţŕöļš, šö ķàþî àšķš öñçé þéŕ þŕöĵéçţ, îñ à ţéŕḿîñàļ, àñđ ŕéçöŕđš ţĥé àñšŵéŕ. À çĥàñĝé šéţ éđîţš çöđé çöḿḿéñţš öŕ đöçüḿéñţš, ñéṽéŕ ƃöţĥ.
Îñšîđé à þŕöĵéçţ à đöçüḿéñţ îš ñàḿéđ ƃý îţš þŕöĵéçţ-ŕéļàţîṽé þàţĥ. À ƒîļé öüţšîđé ţĥé þŕöĵéçţ îš ñàḿéđ ƃý îţš àƃšöļüţé þàţĥ, àš ķàþî îñšþéçţ ñàḿéš îţ, àñđ à çĥàñĝé šéţ ţĥàţ éđîţš öñé éđîţš ñöţĥîñĝ îñ ţĥé þŕöĵéçţ. Öüţšîđé à þŕöĵéçţ à đöçüḿéñţ ĥöļđš öñé éđîţîöñ, îñ ţĥé ļàñĝüàĝé îţš ƒîļé öŕ đîŕéçţöŕý ñàḿéš (ļöçàļéš/ñƃ.ĵšöñ, öŕ đöçš/đé/ĝüîđé.ḿđ ƃéšîđé đöçš/éñ/ĝüîđé.ḿđ), ŵĥîçĥ à ŕéàđ þŕîñţš îñ éàçĥ ŕéƒ, éļšé Éñĝļîšĥ; --öüţ ƑÎĻÉ ŵŕîţéš ţĥé öñé éđîţîöñ à çĥàñĝé šéţ àđđš ţö îţ, à ţŕàñšļàţîöñ, ţö ƑÎĻÉ.
--đŕý-ŕüñ çöḿþüţéš àñđ çĥéçķš ţĥé çĥàñĝé šéţ, ŵŕîţéš ñöţĥîñĝ, àñđ þŕîñţš à đ þéŕ đöçüḿéñţ. --ĝàţé ŕéþöŕţ ļàñđš à çĥàñĝé ŵĥöšé ƒîñđîñĝš ŵöüļđ öţĥéŕŵîšé ŕéƒüšé îţ, ƒöŕ à þéŕšöñ ŵĥö ĥàš ŕéàđ ţĥéḿ. --ĵšöñ þŕîñţš ţĥé ŕéšüļţ (ķàþî.çĥàñĝé-ŕéšüļţ/ṽ1), àļšö ƒöŕ à çĥàñĝé šéţ ţĥàţ đöéš ñöţ đéçöđé, ŵĥöšé ŕéšüļţ çàŕŕîéš ţĥé éŕŕöŕ. --þŕîñţ-öþš þŕîñţš ţĥé çĥàñĝé šéţ àš đéçöđéđ, ŵîţĥ îţš đéƒàüļţš ƒîļļéđ îñ, àñđ àþþļîéš ñöţĥîñĝ.
Éẋîţ šţàţüš: 0 ŵĥéñ ţĥé çĥàñĝé šéţ àþþļîéđ öŕ þŕéṽîéŵéđ; 2 ŵĥéñ îţ đöéš ñöţ đéçöđé öŕ çöñţŕàđîçţš îţšéļƒ; 3 ŵĥéñ àñ öþéŕàţîöñ ŵàš ŕéƒüšéđ, àñđ ñöţĥîñĝ ŵàš ŵŕîţţéñ, ŵĥéñ ţĥé çĥàñĝé ļàñđéđ îñ þàŕţ, öŕ ŵĥéñ ţĥé çĥéçķ öƒ à ŵŕîţţéñ çöđé çöḿḿéñţ ƒàîļéđ; 5 ŵĥéñ à ƃàçķéñđ đîđ ñöţ àñšŵéŕ. ▒
Ŕüñš îñ ýöüŕ ƃŕöŵšéŕ àĝàîñšţ à šḿàļļ šàḿþļé ƒîļé. Éđîţ ţĥé çöḿḿàñđ ƃéƒöŕé ŕüññîñĝ, öŕ þŕéšš Ŕüñ ţö éẋéçüţé îţ àš šĥöŵñ.
kapi inspect docs/guide.md --jsonl | write-the-edits | kapi apply| Ƒļàĝ | Ţýþé | Đéƒàüļţ | Đéšçŕîþţîöñ |
|---|---|---|---|
| --dry-run | bool | false | ▒ çöḿþüţé àñđ çĥéçķ ţĥé çĥàñĝé šéţ, þŕîñţ à đ þéŕ đöçüḿéñţ, àñđ ŵŕîţé ñöţĥîñĝ ▒ |
| --encoding | string | ▒ çĥàŕšéţ ţĥé îñþüţ îš ŕéàđ îñ àñđ ţĥé öüţþüţ ŵŕîţţéñ îñ; à ƃýţé-öŕđéŕ ḿàŕķ îñ ţĥé ƒîļé ŵîñš (đéƒàüļţ: ţĥé þŕöĵéçţ'š đéƒàüļţš.éñçöđîñĝ, ţĥéñ ÜŢƑ-8) ▒ | |
| --engine | string | ▒ ƒöŕḿàţ éñĝîñé ƒöŕ đéţéçţéđ ƒîļéš: ñàţîṽé öŕ à þļüĝîñ ñàḿé (đéƒàüļţ: ñàţîṽé, ţĥéñ þļüĝîñš) ▒ | |
| --format , -f | string | ▒ ƒöŕḿàţ öƒ éṽéŕý đöçüḿéñţ ţĥé çĥàñĝé šéţ ñàḿéš (đéƒàüļţ: ŵĥàţ ţĥé ŕéçîþé ƃîñđš, éļšé àüţö-đéţéçţ) ▒ | |
| --gate | string | ▒ ŵĥàţ à ƒàîļîñĝ ƒîñđîñĝ ţĥé çĥàñĝé îñţŕöđüçéš đöéš: éñƒöŕçé (ŕéƒüšé îţ, ţĥé đéƒàüļţ) öŕ ŕéþöŕţ (ļàñđ îţ ŵîţĥ îţš ƒîñđîñĝš; à þéŕšöñ'š çĥöîçé) ▒ | |
| --in-place , -i | bool | ▒ ķééþ à çöþý öƒ éàçĥ ƒîļé ţĥé çĥàñĝé šéţ ŕéþļàçéš, ŵîţĥ ţĥé ŠÜƑƑÎẊ ĝîṽéñ (--îñ-þļàçé=.ƃàķ) ▒ | |
| --json | bool | false | ▒ þŕîñţ ţĥé ŕéšüļţ àš ĴŠÖÑ (ķàþî.çĥàñĝé-ŕéšüļţ/ṽ1) ▒ |
| --out | string | ▒ öüţšîđé à þŕöĵéçţ, ţĥé ƒîļé ţö ŵŕîţé ţĥé öñé éđîţîöñ ţĥé çĥàñĝé šéţ àđđš ţö à đöçüḿéñţ (à ţŕàñšļàţîöñ öƒ îţ); îñšîđé öñé, ţĥé ŕéçîþé'š ţàŕĝéţ ñàḿéš îţ ▒ | |
| --print-ops | bool | false | ▒ þŕîñţ ţĥé çĥàñĝé šéţ àš đéçöđéđ, ŵîţĥ îţš đéƒàüļţš ƒîļļéđ îñ, àñđ àþþļý ñöţĥîñĝ ▒ |
| --project , -p | string | ▒ þàţĥ ţö à ķàþî.ýàḿļ þŕöĵéçţ ŕéçîþé öŕ îţš đîŕéçţöŕý (àüţö-đîšçöṽéŕéđ ƒŕöḿ çŵđ îƒ öḿîţţéđ) ▒ | |
| --schema | bool | false | ▒ þŕîñţ ţĥé ĴŠÖÑ Šçĥéḿà öƒ à çĥàñĝé šéţ, öŕ öƒ ţĥé öñé öþéŕàţîöñ ñàḿéđ (ķàþî àþþļý --šçĥéḿà šéţ_àţţŕîƃüţé), àñđ éẋîţ ▒ |
kapi apply change.json kapi apply change.json --dry-run kapi apply change.json --jsonecho '{"ops":[{"op":"replace_text","at":{"doc":"docs/guide.md","block":"install/p"},"if_match":"<rev from kapi inspect>","edits":[{"find":"colour","text":"color"}]}]}' | kapi applyksed 's/colour/color/g' docs/guide.md --print-ops | kapi apply kapi apply --schema kapi apply --schema set_attribute← Ƃàçķ ţö ţĥé Çöḿḿàñđ Ŕéƒéŕéñçé