Badilisha JSON kuwa TOON

TOON Format Cheat Laha

TOON
Zana za Dev

Iwapo umewahi kuhisi kuwa JSON ni ya kitenzi sana (viunga vyote hivyo!) lakini YAML ni "ya kichawi" sana na haitabiriki, unaweza kumpenda TOON. Muundo huu unaleta uwiano wa kipekee kati ya usomaji wa binadamu na kasi ya kuchanganua mashine. Imeundwa kuwa mnene, wazi, na kwa haraka sana kuchanganua.

Iwe unahamisha data au unajaribu tu kurekebisha faili ya usanidi, laha hii ya udanganyifu inashughulikia sintaksia muhimu unayohitaji kujua.

Falsafa: Kelele Chini, Data Zaidi

Jambo la kwanza utagundua ni kwamba TOON inaonekana sana kama YAML, lakini inatenda madhubuti kama JSON. Huondoa viunga vinavyofungua na kufunga ili kupendelea ujongezaji na laini mpya, na kufanya data yako ionekane safi zaidi mara moja.

Vitu na Nesting

Katika JSON, umezoea kufunga kila kitu kwenye viunga vilivyopindapinda. Katika TOON, muundo unaonyeshwa kwa kuingiza.

JSON:

{ 
"mradi": { 
"metadata": { 
"name": "Alpha-Centauri", 
"status": "active" 
}, 
"maadili": [ 
{ 
"phase": "design", 
"kipaumbele": 1 
}, 
{ 
"phase": "majaribio", 
"kipaumbele": 2 
} 
] 
} 
}

TOON:

mradi: 
metadata: 
jina: Alpha-Centauri 
hali: hai 
hatua muhimu[2]{phase,priority}: 
kubuni, 1 
majaribio, 2

Tambua kuwa funguo hazihitaji nukuu isipokuwa ziwe na herufi maalum, na daraja ni dhahiri.

Nguvu ya Safu

Hapa ndipo TOON hutofautiana kutoka kwa miundo mingine. TOON inakuhitaji utangaze urefu wa urefu wa safu katika ufunguo wenyewe. Hili linaweza kuonekana kuwa la kushangaza mwanzoni, lakini huruhusu kichanganuzi kugawa kumbukumbu mapema, na kuifanya iwe haraka sana.

Safu za Awali

Kwa orodha rahisi za mifuatano au nambari, TOON hutumia sintaksia iliyotenganishwa kwa koma.

Sintaksia:

key[urefu]:kipengee1,kipengee2,kipengee3

Ikiwa unayo safu ya mizizi (faili nzima ni orodha tu), inaonekana kama hii:

Safu za Jedwali (Kipengele cha Muuaji)

Hiki ndicho kipengele ambacho kwa kawaida huwashinda watengenezaji. Ikiwa una safu ya vitu ambavyo vyote vinashiriki funguo sawa (kama safu kwenye hifadhidata), TOON hukuruhusu kufafanua schema once kwenye kichwa na kisha uorodheshe tu maadili. Hii huondoa kiasi kikubwa cha upungufu unaopatikana katika JSON.

Sintaksia:

key[safu]{col1,col2}:

JSON:

{ 
"hesabu": [ 
{ 
"sku": "KB-99", 
"kiasi": 50, 
"njia": 4, 
"panga upya": uongo 
}, 
{ 
"sku": "MS-12", 
"wingi": 12, 
"njia": 7, 
"panga upya": kweli 
}, 
{ 
"sku": "MN-44", 
"kiasi": 8, 
"njia": 2, 
"panga upya": kweli 
} 
] 
}

TOON:

orodha[3]{sku,qty,aisle,reorder}: 
KB-99,50,4,uongo 
MS-12,12,7,kweli 
MN-44,8,2,kweli

Mbinu hii ya "CSV-ndani-YAML" hufanya seti kubwa za data kusomeka na kushikana.

Safu Mchanganyiko na Zilizowekwa

Wakati mwingine data sio sawa. Ikiwa safu yako ina aina tofauti za data (nambari zilizochanganywa na vitu), au ikiwa ina vipengee changamano vilivyowekwa, TOON inarudi kwenye sintaksia ya mtindo wa vidokezo kwa kutumia vistari.

Unaweza hata kuwa na safu ndani ya safu. Kumbuka jinsi safu ya ndani pia inavyotangaza urefu wake:

Kunukuu: Wakati wa Kuitumia

Mojawapo ya mambo mazuri kuhusu TOON ni kwamba huhitaji nukuu mara chache. Unaweza kuandika Hujambo 世界 👋 bila kuifunga kwa "". Hata hivyo, kwa sababu TOON inajaribu kukisia aina (namba, booleans), kuna sheria mahususi za wakati lazima utumie manukuu.

Orodha ya "Lazima-Kunukuu".

Lazima ufunge kamba yako kwa nukuu mbili "" ikiwa:

  1. Inaonekana kama nambari au boolean: Ikiwa unataka mfuatano "123" au "kweli", nukuu. Vinginevyo, zinakuwa nambari 123 na boolean kweli.
  1. Ina viambatanisho: Ikiwa mfuatano wako una koma , (au chochote kikomo chako kinachotumika), inukuu.
  1. Ina kingo za nafasi nyeupe: Nafasi zinazoongoza au zinazofuata zinahitaji manukuu.
  1. Ina herufi maalum: Herufi kama :, ", \, [, ], {, }.
  1. Ni tupu: Mfuatano tupu unawakilishwa kama "".

Mifano:

Mifuatano ya Escape

Weka rahisi. TOON inatambua tu mifuatano mitano ya kutoroka ndani ya mifuatano. Kitu kingine chochote ni batili.

  • \\ (Kurudi nyuma)
  • \" (Nukuu mbili)
  • \n (Mstari mpya)
  • \r (Kurudi kwa gari)
  • \t (Kichupo)

Vichwa vya Kina na Vikomo

Je, ikiwa data yako imejaa koma? Hutaki kunukuu kila sehemu moja. TOON hukuruhusu kubadilisha kikomo kwenye kichwa cha safu.

Unaweza kutumia Tab au Bomba (|) kwa kuiweka ndani ya mabano au viunga.

Mfano wa Kikomo cha Bomba:

Kwa kuongeza | katika kichwa, kichanganuzi kinajua kutafuta mabomba badala ya koma, huku kikiweka sintaksia yako safi.

Kukunja Muhimu

Ikiwa una kiota kirefu lakini njia moja tu ya data, huhitaji kujongeza mara tano. Unaweza kutumia nukuu za nukta (Kukunja Ufunguo) ili kubana muundo wako.

Kuzaa kwa Kawaida:

mtumiaji: 
wasifu: 
mipangilio: 
arifa: 
barua pepe: kweli 
sms: uongo

Imekunjwa (Kisafishaji):

user.profile.settings.notifications: 
barua pepe: kweli 
sms: uongo

Marejeleo ya Aina ya Haraka

Ramani za TOON moja kwa moja kwa aina za JSON, lakini hushughulikia kesi za makali mahususi za JavaScript kwa uzuri ili kuhakikisha utoaji halali.

  • Nambari: Imehifadhiwa kama desimali za kisheria. 1.0 inakuwa 1.
  • Infinity / NaN: Hizi huwa null (kwa kuwa JSON haiziauni).
  • Tarehe: Imegeuzwa kuwa mifuatano ya ISO iliyonukuliwa.
  • Haijafafanuliwa/Vitendaji: Imegeuzwa kuwa null.
  • Vitu Tupu: Imewakilishwa kama kitu (matokeo tupu).
  • Safu Tupu: Inawakilishwa kama ufunguo[0]:.

TOON ni umbizo linalotuza usahihi. Huenda ikachukua muda kuzoea kuhesabu vitu vyako vya mkusanyiko, lakini malipo katika usomaji na saizi ya faili yanafaa kujitahidi. Furahia kuweka msimbo!