Badilisha JSON kuwa TOON

Kusimamia TOON CLI

CLI
TOON

Iwapo umekuwa ukifanya kazi na Miundo Kubwa ya Lugha (LLMs), unajua kuwa JSON ndiyo lugha ya ubadilishanaji wa data. Walakini, unajua pia kuwa JSON ni "gumzo" mbaya. Viunga hivyo vyote, nukuu, na vitufe vinavyorudiwa vinakula dirisha la muktadha wako, kuongeza muda wa kusubiri, na kuongeza gharama za API.

Hapa ndipo TOON (The Object-Oriented Notation) inapoangaza. Wakati maktaba ya TypeScript ni nzuri kwa nambari ya programu, wakati mwingine unahitaji tu kufanya mambo haraka kwenye terminal. Iwe unatatua kidokezo, unatayarisha seti ya data, au una hamu ya kutaka kujua ni kiasi gani cha pesa unachoweza kuokoa kwenye tokeni, @toon-format/toon CLI ndiye rafiki yako mpya.

Katika mwongozo huu, tutaangalia jinsi ya kutumia Kiolesura cha Mstari wa Amri wa TOON ili kujumuisha uboreshaji wa data moja kwa moja kwenye utiririshaji wa ganda lako.

Kuweka Mipangilio

Mojawapo ya mambo bora zaidi kuhusu zana za kisasa za JavaScript ni kwamba mara nyingi huhitaji "kusakinisha" chochote ili kuanza. Ikiwa unataka tu kujaribu TOON kwenye faili moja, unaweza kutumia npx kuendesha jozi moja kwa moja:

npx @toon-format/cli input.json -o output.toon

Hata hivyo, ikiwa unapanga kutumia hii mara kwa mara—na mara tu unapoona akiba ya tokeni, kuna uwezekano utaweza—usakinishaji wa kimataifa ndiyo njia ya kuendelea. Inakupa ufikiaji wa amri fupi ya toon popote kwenye mfumo wako.

npm install -g @toon-format/cli 
#au 
pnpm ongeza -g @toon-format/cli

Mara baada ya kusakinishwa, uko tayari kuanza kupunguza data yako.

Uchawi wa Kugundua Kiotomatiki

TOON CLI imeundwa kuwa smart kuhusu kile unachojaribu kufanya. Huhitaji kuiambia kwa uwazi ili kusimba au kusimbua; inaangalia viendelezi vya faili yako kuamua.

Ukiipa faili .json, inadhania kuwa unataka kuisimba kwa TOON. Ukitoa faili ya .toon, itabadilika kuwa hali ya kusimbua ili kukurejeshea JSON.

# Husimba kiotomatiki kwa TOON 
toon data.json -o compressed.toon 

# Huamua kiotomatiki kwa JSON 
toon compressed.toon -o restored.json

Lakini ambapo CLI inathibitisha thamani yake ni katika "falsafa ya Unix" - zana ndogo zilizounganishwa kwa urahisi. Kwa sababu TOON CLI inasoma kutoka kwa pembejeo ya kawaida (stdin) na huandika hadi pato la kawaida (stdout), unaweza kusambaza data moja kwa moja kupitia hiyo.

# Bomba JSON moja kwa moja kwenye TOON 
cat large-dataset.json | toon > data.toon 

# Echo kitu cha haraka ili kuona jinsi inavyoonekana kwenye TOON 
echo '{"name": "Ada", "role": "admin"}' | toon

Unaposambaza data kupitia stdin, CLI hubadilika kuwa encode modi. Ikiwa unahitaji kusimbua mtiririko wa data ya TOON inayotoka kwa mchakato mwingine, ongeza tu alama ya --decode (au -d).

Kuchambua Akiba ya Tokeni

Kuboresha miundo ya data mara nyingi ni kuhusu kubahatisha michezo. "Nikiondoa nafasi nyeupe, nitahifadhi kiasi gani?" "Itakuwaje nikibadilisha hadi YAML?"

TOON CLI huondoa ubashiri kwa kutumia bendera ya --stats. Wakati wa kusimba, chaguo hili huhesabu hesabu ya tokeni iliyokadiriwa na kukuonyesha akiba mara moja. Hii ni muhimu sana unapopanga bajeti ya simu za LLM za sauti ya juu.

toon context.json --stats

Unaweza kuona matokeo yanayoonyesha punguzo la 30% au 40%. Hiyo sio tu nafasi ya diski; hiyo ni 40% chini ya muda wa kusubiri na 40% ya gharama ya chini kwenye tokeni za pembejeo.

Urekebishaji wa Kina: Vikomo na Uumbizaji

Kwa chaguomsingi, TOON hutumia koma kutenganisha vipengee vya safu, sawa na JSON. Walakini, viashiria tofauti vya LLM hufanya kazi tofauti na uakifishaji. Wakati mwingine, herufi ya kichupo au bomba (|) ni bora zaidi ya ishara kuliko koma.

CLI hukuruhusu kubadilisha mipaka kwenye kuruka. Ikiwa unashughulika na data ya jedwali, kubadili kikomo cha kichupo kunaweza kufanya pato lionekane safi na kuchakata kwa ufanisi zaidi.

Kwa orodha ya bidhaa, hii hubadilisha pato kutoka kwa orodha iliyotenganishwa kwa koma hadi muundo safi, uliotenganishwa na vichupo ambao unafanana na lahajedwali, ambayo miundo mingi huchanganua vizuri sana.

# Tumia tabo kwa vitu vya safu 
toon items.json --delimiter "\t" -o items.toon

::: kidokezo Kidokezo cha Pro: Vitenganishi vya vichupo mara nyingi hupunguza hitaji la kuepuka manukuu na vinaweza kusababisha uwekaji tokeni bora wa data ya nambari. Ikiwa unachakata hifadhidata kubwa, jaribu --delimiter "\t" ili kubana kila kukicha ya ufanisi. :::

Muundo wa Kubana kwa Ufungaji Muhimu

Mojawapo ya vipengele vipya zaidi (vilivyoletwa katika bainifu v1.5) vinavyopatikana katika CLI ni Kukunja Ufunguo. Data ya JSON mara nyingi huwekwa kwa kina, na vitufe vya kanga kama data.response.items ambavyo huongeza kina cha muundo bila kuongeza maana.

CLI hukuruhusu "kukunja" funguo hizi zilizowekwa kiota kwenye njia moja iliyo na nukta, kunyoosha safu na kuokoa ishara kwenye ujongezaji na viunga.

toon deep-structure.json --key-folding safe -o flat.toon

Hii inabadilisha vitu vilivyowekwa:

{ "user": { "profile": { "id": 1 } }}

Kwa uwakilishi mfupi wa TOON:

user.profile.id: 1

Iwapo unahitaji kubadilisha hii kuwa JSON kamili baadaye, unaweza kutumia alama ya --panua-paths safe wakati wa kusimbua ili kuunda upya muundo wa kitu cha kina kikamilifu.

kuunganishwa kwenye Pipelines

Nguvu halisi ya TOON CLI huja unapoiunganisha kwa zana zingine kama curl na jq. Unaweza kuleta data kutoka kwa API, kuichuja hadi kwa vitu muhimu, na kuibadilisha kuwa TOON katika mstari mmoja—tayari kubandikwa kwenye kidokezo au kutumwa kwenye sehemu ya mwisho ya makisio.

Katika utendakazi huu, unaleta data, kutoa watumiaji wanaotumika pekee, kuibadilisha kuwa umbizo la TOON lililotenganishwa na bomba, na kupata ripoti ya takwimu kuhusu ni tokeni ngapi umehifadhi.

curl -s https://api.example.com/users \ 
| jq '.data.active_users' \ 
| toon --stats --delimiter "|"

Muhtasari

@toon-format/cli ni zaidi ya kigeuzi faili; ni ukanda wa matumizi kwa enzi ya LLM. Kwa kuhamisha uchakataji wa data hadi kwenye mstari wa amri, unaweza kurudia kasi zaidi, kuibua uboreshaji mara moja, na kuunganisha fomati za ufanisi wa tokeni katika utendakazi wako uliopo wa uhandisi.

Iwe unatayarisha hati za RAG (Retrieval-Augmented Generation) au unajaribu tu kutosheleza blob kubwa ya JSON kwenye dirisha dogo la muktadha, ipe CLI mzunguuko. Bajeti yako ya ishara itakushukuru.