[vpsFree.cz: community-list] HaveAPI v0.4

[Pavel Snajdr]

Jak to souvisi s novou verzi HaveAPI?

/snajpa

-----Original Message-----
From: "Daniel Mičík" <daniel at micik.cz>
Sent: ‎20. ‎1. ‎2016 16:13
To: "vpsFree.cz Community list" <community-list at lists.vpsfree.cz>
Subject: Re: [vpsFree.cz: community-list] HaveAPI v0.4

Tak skript na automatické přepsaní /etc/hosts po restartu na Debianu (a spol.) - nikdo nic?


​Dan








Dne 20. ledna 2016 12:53 Jakub Skokan <jakub.skokan at vpsfree.cz> napsal(a):

Ahoj,

uzavřel jsem další verzi frameworku HaveAPI [1], na němž je postaven
vpsAdmin.

Verze 0.4 přináší:

 - definici verze komunikačního protokolu, aktuálně 1.0,
 - validátory vstupních parametrů,
 - definované hooky [2] součástí referenční dokumentace [3] generované
   s yardoc,
 - styly + prolinkování resources v online dokumentaci API,
 - JSON schema dokumentačního protokolu [4], znázornění v UML [5],
 - lepší hlášení chyb při inicializaci API.

Validátory jsou jako většina věcí v HaveAPI součástí dokumentace [6]
API, takže se parametry mohou validovat na straně klienta ještě před
posláním dat na server. Validátory jsou nyní nezávislé na ActiveRecord.
Při jeho použití se kompatibilní validátory z modelů přenesou i na
validátory vstupních parametrů a jsou součástí dokumentace.

Velkých změn se dočkalo CLI [7] v Ruby:

 - zahozen gem table_print a výstup formátován svépomocí buď do řádků
   (-r, --rows), nebo sloupců (-c, --columns),
 - -o, --output vypíše pouze vybrané parametry,
 - -s, --sort seřadí výstup podle parametru (na straně klienta),
 - -L, --list vypíše seznam výstupních parametrů vybrané akce,
 - -H, --no-header potlačí výpis hlavičky s názvy parametrů,
 - --timestamp, --utc, --local a --date-format na formátování Datetime
   parametrů.

Klient v JavaScriptu je nově k dispozici přes npm [8] (Node.js) a bower [9].

[1] https://github.com/vpsfreecz/haveapi

[2] https://projects.vpsfree.cz/haveapi/ref/HaveAPI/Hooks.html

[3] https://projects.vpsfree.cz/haveapi/ref/file.Hooks.html

[4] https://projects.vpsfree.cz/haveapi/ref/file.JSON-Schema.html

[5]
https://github.com/vpsfreecz/haveapi/blob/master/lib/haveapi/public/doc/protocol.png

[6] https://github.com/vpsfreecz/haveapi/blob/master/doc/protocol.md

[7] https://github.com/vpsfreecz/haveapi-client#cli

[8] https://www.npmjs.com/package/haveapi-client

[9] http://bower.io

Jakub
_______________________________________________
Community-list mailing list
Community-list at lists.vpsfree.cz
http://lists.vpsfree.cz/listinfo/community-list
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.vpsfree.cz/pipermail/community-list/attachments/20160120/1903b441/attachment.html>