UltKit

YAML JSON bihurgailua

Bihurtu YAML konfigurazioak, OpenAPI zehaztapenak eta CI fitxategiak edozein analizatzailek, APIk edo eskema-baliozkotzailek irakur dezakeen JSON. Igo .yaml edo .yml fitxategiak eta deskargatu JSON koskatua.

Datu-bihurtzailea

edo jaregin CSV, TSV, TXT … fitxategiak hemen ·

Gehienez 95 MB fitxategiko· 20 fitxategi arte· 30 minutu geroago ezabatzen da

Irteera

Fitxategiak gure zerbitzarietan prozesatzen dira eta 30 minutu geroago ezabatzen dira.

Tresna hau nola erabili

  1. 1

    Igo YAML fitxategiak

    Gehitu .yaml edo .yml fitxategiak, aldi berean 20 arte eta bakoitza 95 MB-ra arte. Mantendu jatorrizko izenak; JSON fitxategiek izen bera izango dute, luzapen berriarekin.

  2. 2

    Aukeratu koskatua edo trinkoa

    Formatu irakurgarria aktibatuta dago, eta JSONa koskatzen du irakurtzeko eta kodea berrikusteko. Desaktibatu ezazu Ezarpen aurreratuak atalean, lerro bakarreko fitxategia nahi baduzu eskaera baten gorputzean itsasteko.

  3. 3

    Bihurtu eta erabili

    Sakatu Bihurtu JSON formatura, deskargatu eta eman fitxategia behar zuen APIari, balidatzaileari edo script-ari.

Zergatik bihurtzen dute garatzaileek YAML JSON

YAML pertsonentzat idatzita dago: giltzen ordez koskak, iruzkinak, eta kate gehienen inguruan komatxorik ez. Horregatik da Kubernetes manifestuen, GitHub Actions workflow-en, Docker Compose fitxategien eta taldeek eskuz editatzen dituzten OpenAPI espezifikazioen formatua. JSON programentzat idatzita dago. Lengoaia guztiek dute JSON parserra liburutegi estandarrean, nabigatzaileek natiboki aztertzen dute, eta HTTP API gehienek ez dute besterik onartzen.

Beraz, bihurketa mugan gertatzen da. Plataforma-ingeniari batek manifestu bat jq-ra bideratzen du, JSON bakarrik irakurtzen duelako. Backend garatzaile batek OpenAPI espezifikazio bat bidaltzen dio JSON nahi duen kode-sortzaile bati. Test-egile batek YAMLn idatzitako fixture datuak JavaScript test-multzo batean kargatzen ditu. Kasu guztietan YAMLa egiazko iturria da eta JSONa build artefaktua. Konfigurazioen ordez feed edo esportazio direktorio oso baterako, XML JSON bihurtu tresnak markatze-formatu zaharragoa modu berean kudeatzen du.

Nola hazi ziren YAML eta JSON elkarrekin

Clark Evansek YAML proposatu zuen lehen aldiz
2001
YAML 1.2k JSON YAMLren azpimultzo bihurtu zuen
2009
RFC 8259, JSONren egungo estandarra
2017
YAML 1.2.2 berrikuspena argitaratu zen
2021

Zer gertatzen zaie YAMLen soilik dauden ezaugarriei JSONean

Ainguraren (&defaults) eta bere aliasen (*defaults) bidez YAMLek bloke bat berrerabil dezake. JSONak ez du erreferentziarik, beraz alias bakoitza ainguratutako blokearen kopia osoarekin ordezkatzen da.

  • JSONa YAMLa baino nabarmen luzeagoa izan daiteke
  • Merge gakoak (<<: *defaults) modu berean zabaltzen dira
YAML konfigurazio txiki bat JSON formatu irakurgarrian
{
  "service": "billing",
  "replicas": 3,
  "ports": [8080, 9090],
  "env": {
    "LOG_LEVEL": "info",
    "REGION": "NO"
  }
}

YAML eta JSON formatuei buruzko datuak

YAML

YAML

YAML ("YAML Ain't Markup Language") 2001ean kaleratutako datu-formatu gizalegezkoa da. Parentesien ordez koska-sarrera erabiltzen du, iruzkinak onartzen ditu eta JSONen superset bat da. Asko erabiltzen da Docker Compose, Kubernetes, GitHub Actions eta aplikazio askotako konfigurazioan. Zuriuneetan oinarritzen denez, tarte bakar bat gaizki jarrita ere hauts daiteke, eta balio batzuk, "no" edo datak adibidez, ustekabean interpretatu daitezke.

Konpresioa
–
Gardentasuna
–
Animazioa
–
Sorrera urtea
2001 · Clark Evans, Ingy döt Net, Oren Ben-Kiki
YAML bihurtzailea

JSON

JavaScript Object Notation

JSON datu egituratuetarako testu-formatu arina da, Douglas Crockfordek 2000ko hasieran herrikoitua eta RFC 8259 eta ECMA-404 gisa estandarizatua. Objektuak, array-ak, kateak, zenbakiak, boolearrak eta null sintaxi sinple eta irakurgarriarekin adierazten ditu. Web API-etarako, konfigurazio-fitxategietarako eta ia programazio-lengoaia guztietako aplikazioen arteko datu-trukerako formatu lehenetsia da. Ez ditu iruzkinik, datarik ez eskemarik txertatuta, eta egitura sakoneko fitxategi handiak zailak dira ikusle gabe irakurtzeko.

Konpresioa
–
Gardentasuna
–
Animazioa
–
Sorrera urtea
2001 · Douglas Crockford
JSON bihurtzailea

YAMLtik JSONera bihurtzen da pertsonentzat idatzitako konfigurazio edo espezifikazio batek makina bat elikatu behar duenean: API eskaera bat, eskema-balidatzaile bat edo YAML parserrik gabeko tresna bat.

YAML JSON bihurgailuari buruzko ohiko galderak

Zergatik bihurtu YAML JSON, datu berak gordetzen badituzte?

Tresna askok bietako bat bakarrik irakurtzen dutelako. JSON irakurgailuak programazio-lengoaia eta nabigatzaile guztietan datoz, eta YAMLk liburutegi gehigarri bat behar du. REST APIen eskaeren gorputzek, JSON Schema balidatzaileek, jq-k eta package.json edo nabigatzaile-luzapen baten manifest.json bezalako fitxategiek JSON espero dute.

Zer gertatzen da nire YAML iruzkinekin?

Kendu egiten dira. RFC 8259 arauak ez dio JSONi iruzkin-sintaxirik ematen, beraz # zeinuaz hasten diren lerroek ez dute nora joan. Mantendu YAML fitxategia iturri dokumentatu gisa, eta tratatu JSONa nahi duzunean birsor dezakezun kopia sortu gisa.

Zergatik bihurtu dira NO edo off false?

YAML 1.1 jarraitzen duten parserrek yes, no, on eta off boolear gisa irakurtzen dituzte, beraz Norvegiaren NO herrialde-kodea false bihur daiteke. YAML 1.2k booleanoak true eta false-ra mugatzen ditu, baina tresna guztiek ez dute jarraitzen. Jarri komatxoak balio horiei YAMLean, adibidez "NO", eta kate gisa geratuko dira JSONean.

YAMLez idatzitako CloudFormation txantiloi bat bihur dezaket?

AWS CloudFormationek bi formatuak onartzen ditu, baina !Ref eta !GetAtt bezalako etiketa laburrak YAMLen soilik daude. JSON txantiloietan funtzio oso gisa idazten dira: {"Ref": "MyBucket"} edo {"Fn::GetAtt": [...]}. Berridatzi etiketa laburrak forma luzean bihurtu aurretik, JSON txantiloiak baliozkoa izaten jarrai dezan.

Nola egin alderantzizko bihurketa?

Erabili JSON YAML bihurtu. Hori da ohiko norabidea API erantzun bat edo sortutako fitxategi bat biltegi bateko konfigurazio-fitxategi irakurgarri bihurtu behar denean.