Beddelaha YAML / JSON / TOML

Fahanka Qaababka Xogta ee YAML, JSON iyo TOML

Xogta habaysan waxay aasaas u tahay isgaarsiinta API-yada, qaabaynta barnaamijyada, iyo maamulka hababka CI/CD. Saddexda qaab ee ugu caansan ee loo isticmaalo ujeedooyinkan waa YAML, JSON, iyo TOML. Mid kasta oo ka mid ah qaababkan wuxuu leeyahay ujeeddo gaar ah iyo qaab dhismeed u gaar ah oo saameeya sida xogta loo akhriyo loona kaydiyo:

• JSON (JavaScript Object Notation): Waxaa si ballaaran loo isticmaalaa isgaarsiinta API-yada iyo gudbinta xogta ee u dhaxaysa nidaamyada kala duwan. Waa qaab aad u adag oo adeegsada qaansooyin iyo calaamado gaar ah si uu u qeexo walxaha iyo liisaska.
• YAML (YAML Ain't Markup Language): Waxaa inta badan loo isticmaalaa faylasha qaabaynta barnaamijyada iyo nidaamyada dhismaha otomaatiga ah (CI/CD). Waxay aad ugu tiirsan tahay fogaanta (indentation) si ay u muujiso kala sarreynta xogta, taas oo ka dhigaysa mid aad u fudud in bini'aadamku akhriyo.
• TOML (Tom's Obvious, Minimal Language): Waxaa loogu talagalay inuu noqdo qaab qaabayntu ku fududahay oo si cad loo akhriyi karo, isagoo adeegsanaya qaybo iyo furayaal si toos ah u qeexan.

Beddelidda xogta ee u dhaxaysa qaababkan waxay muhiim u tahay horumariyayaasha maamula qaabaynta barnaamijyada ee isbeddelaya, injineerada u guuraya nidaamyo cusub, iyo qof kasta oo u baahan inuu si degdeg ah u falanqeeyo ama u koobiyeeyo xogta isagoo isticmaalaya aaladaha gacanta.

Sida uu u Shaqeeyo Beddelaha Xogta

Aaladdan waxay kuu oggolaanaysaa inaad si toos ah ugu beddesho xogta habaysan qaababka YAML, JSON, iyo TOML. Habka beddelka wuxuu u dhacaa si fudud: waxaad ku dhejisaa xogtaada qaybta gelinta, waxaad doorataa qaabka gelinta iyo qaabka wax soo saarka ee aad rabto, aaladduna waxay soo saartaa xogta la beddelay.

Inta lagu guda jiro beddelka, waxaad sidoo kale hagaajin kartaa fogaanta (indentation) ee wax soo saarka adoo dooranaya 2 ama 4 meelood oo bannaan (spaces) marka aad u beddelaysid qaababka JSON iyo YAML.

Saamaynta Beddelka ee Faallooyinka iyo Fogaanta

Marka xogta laga beddelayo qaab loo beddelayo qaab kale, waxaa muhiim ah in la ogaado in faallooyinka iyo fogaantii asalka ahayd ee ku jiray xogta gelinta aan la xajin doonin. Aaladdu waxay u akhridaa xogta sidii walxo cayiman, ka dibna waxay dib u qortaa dukumenti cusub oo nadiif ah oo raacaya xeerarka qaabka cusub ee la doortay.

Xaddidaadda Xididka Sare ee TOML

Mid ka mid ah xeerarka ugu muhiimsan ee qaabka TOML waa inuu u baahan yahay miis heerka sare ah (top-level table). Tani waxay ka dhigan tahay in qoraal gooni ah, lambar, ama array aan loo qori karin sidii dukumenti TOML oo sax ah. Haddii xogtaada gelinta ay tahay mid fudud oo aan lahayn qaab dhismeedka shay heerka sare ah, looma beddeli karo TOML.

Xogta Gelinta iyo Wax Soo Saarka

Aaladdu waxay bixisaa interface cad oo muujinaya faahfaahinta xogtaada. Marka aad geliso xogta, waxaad arki kartaa macluumaad ku saabsan:

Xeerarka Isticmaalka iyo Farriimaha Ciladaha

Si loo hubiyo in beddelku u dhaco si sax ah, aaladdu waxay leedahay xeerar dhowr ah iyo farriimo ciladeed oo caawiya xallinta dhibaatooyinka marka ay xogtu khaldan tahay:

• Xog madhan: Haddii aad isku daydo inaad beddesho adigoo aan wax xog ah gelin, aaladdu waxay muujinaysaa "Ku dheji xoogaa xog ah marka hore."
• Qaabab isku mid ah: Haddii qaabka gelinta iyo wax soo saarku isku mid yihiin, waxaad arki doontaa "Dooro laba qaab oo kala duwan."
• Xaddidnaanta cabbirka: Xogta gelintu waa inay ka yaraataa 2,000,000 oo xarfood. Haddii aad xadkaas dhaafto, waxaa soo baxaya "Xogtaas aad ayay ugu weyn tahay aaladdan. Fadlan ka dhig wax ka yar {max} xarfood."
• Ciladaha kala dhigdhigga:
  • Haddii JSON uu khaldan yahay: "JSON-kan waa la waayay in la kala dhigdhigo."
  • Haddii YAML uu khaldan yahay: "YAML-kan waa la waayay in la kala dhigdhigo."
  • Haddii TOML uu khaldan yahay: "TOML-kan waa la waayay in la kala dhigdhigo."
• Ciladda TOML: Haddii xogta loo beddelayo TOML ay weydo shay heerka sare ah, waxaa soo baxaya "Xogtan looma qori karo sidii TOML sax ah."
• Waqtiga ka dhammaaday: Haddii beddelku qaato waqti aad u dheer, aaladdu waxay ku siinaysaa farriinta "Beddelidani waxay qaadanaysaa waqti aad u dheer. Isku day xog ka yar."
• Cilado kale: Haddii beddelku u guuldarraysto sababo kale, waxaad arki doontaa "Waa la waayay beddelidda xogtan."

Marka aad si guul leh u beddesho xogta, aaladdu waxay muujinaysaa "Waxaa loo beddelay {from} una beddelay {to}. Cabirka soo baxa: {size}."

Ilaalinta Xogta iyo Gaar ahaanshaha

Markaad isticmaalayso aaladdan, YAML-kaaga, JSON-kaaga iyo TOML-kaaga waxaa lagu beddelaa biraawsarkaaga dhexdiisa. Waxba looma soo geliyo BroBroGo. Tani waxay ka dhigan tahay in xogtaadu ay ku jirto kombiyuutarkaaga ama qalabkaaga dhexdiisa inta lagu guda jiro habka beddelka.

---

Su'alaha Badanaa La Is Weydiiyo (FAQ)

Waa maxay beddelka qaababka ee la taageero?

Waxaad u beddeli kartaa inta u dhaxaysa YAML, JSON iyo TOML dhinac kasta. Dooro qaababka gelinta iyo wax soo saarka ee kore ka hor intaadan beddelin.

Maxay qiimayaasha qaarkood u noqon waayeen TOML?

Faylasha TOML waxay u baahan yihiin miis heerka sare ah. Qoraal gooni ah, lambar ama array ayaa weli noqon kara JSON ama YAML, laakiin looma qori karo sidii dukumenti TOML oo sax ah.

Miyaa faallooyinka la xajiyaa?

Maya. Beddeluhu wuxuu akhriyaa qiimayaasha xogta wuxuuna qoraa dukumenti cusub oo nadiif ah, markaa faallooyinka iyo fogaantii asalka ahayd dib looma soo celiyo.