kapi apply

$ kapi apply [flags] [CHANGESET]

Bruk et typet endrings-sett: skrive-motstykket til 'kapi inspect'. Hver post er én gjennomgått endring: en innholdsredigering, en ressursredigering (term, content-memory-par, voice-regel, oppskriftsfelt) eller et gjennomgangsresultat (kind:"review"). Innholdsredigeringer landes via den samme byte-trofaste rundturen motorens skrivere bruker (struktur og inline-kode bevares), driftsikret av content_hash; ressursredigeringer skrives til sitt committede kildeartefakt og den eksisterende importen kompilerer dem inn i cachen; et gjennomgangsresultat registreres som enhets-tilstand i prosjektlageret.

Et content memory-par (kind:"memory") er gjenbruk for fremtidige oversettelser. Det fremmer ikke en enhet til gjennomgått. For å godkjenne en oversatt enhet, bruk en kind:"review"-post adressert med fil/id/språkkode (slik 'kapi status --review' viser det), med status "reviewed" (standard) eller "signed-off"; beslutningen registreres i prosjektets beslutningslogg og er bundet til oversettelsens innholds-hash, slik at en senere redigering fører enheten tilbake under gjennomgått. Registreringen er varig med én gang, og 'kapi context snapshot' skriver loggen ut som filer.

En kommentarredigering (kind:"comment") skriver om én kodekommentar, adressert med filen og id-en 'kapi check' rapporterer for den, som func/Parse, i Go og i språkene et kommentar-tillegg leser (TypeScript, TSX og JavaScript blant dem). Teksten er kommentarens prosa uten kommentarmarkører. Den bærer comment_sha256 som 'kapi check --json' rapporterer for kommentaren, eller prosaen som lest i current_text, og en kommentar som har endret seg siden, avvises. Alle bytes utenfor kommentaren forblir som de er, resultatet må parses, og språkets formaterer må godkjenne det. Å kjøre den formatereren kjører kode prosjektet kontrollerer, så kapi spør én gang per prosjekt, i en terminal, og registrerer svaret. Et direktiv, en generert fils kommentar og tekst som fjerner eller legger til en kodeblokk eller referanse, avvises med en begrunnelse og skriver ingenting. Hver skrevet fil kontrolleres igjen over det som endret seg, og funnene rapporteres ved siden av redigeringen.

Endrings-settet er JSONL (én post per linje), lest fra CHANGESET eller, uten argument eller "-", fra standard inn. Innholdsposter navngir sin egen fil, så apply skriver disse filene på plass; --diff forhåndsviser innholds- og kommentarendringer og skriver ingenting. Ingen AI-leverandør kreves.

Commandapply

Groupwork

Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

$ kapi inspect docs/guide.md --jsonl | write-the-edits | kapi apply

Flags

Flag	Type	Default	Description
--dry-run	bool	false	compute and check the change set, print a diff per document, and write nothing
--encoding	string		inn-/utkoding
--engine	string		format engine for detected files: native or a plugin name (default: native, then plugins)
--format , -f	string		inn-/utdataformat for innholdsfiler (standard: automatisk gjenkjenning)
--gate	string		what a failing finding the change introduces does: enforce (refuse it, the default) or report (land it with its findings; a person's choice)
--in-place , -i	bool		behold en sikkerhetskopi av redigerte innholdsfiler med --in-place=.bak
--json	bool	false	skriv ut brukerapporten som JSON
--out	string		outside a project, the file to write the one edition the change set adds to a document (a translation of it); inside one, the recipe's target names it
--print-ops	bool	false	print the change set as decoded, with its defaults filled in, and apply nothing
--project , -p	string		sti til en kapi.yaml-prosjektoppskrift eller dens katalog (oppdages automatisk fra gjeldende katalog hvis utelatt)
--schema	bool	false	print the JSON Schema of a change set, or of the one operation named (kapi apply --schema set_attribute), and exit

More examples

$ kapi apply change.json

$ kapi apply change.json --dry-run

$ kapi apply change.json --json

echo '{"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

← Back to the Command Reference