Ist mein c0de aktuell?
Eine Anzeige neben deinen Blättern, die dir sagt, ob eine neue Version von c0de oder c0de net erschienen ist. Das Programm fragt c0de.at nach den neuesten Releases und vergleicht sie mit den Versionen, die auf deinem Server installiert sind.
Funktionen: HTTP_GET und FROM_JSON aus c0de/strings sowie die Konstanten C0DE_VERSION und C0DE_NET_VERSION
Was du brauchst
Die Mod c0de net in deinem Spiel, einen Auslöserblock mit Knopf, eine Anzeigewand aus 2 × 1 Anzeigeblöcken und eine nicht initialisierte Variablenkarte.
Die Idee
Jedes Programm kennt die Versionen, auf denen es läuft: Die Konstante C0DE_VERSION enthält die Version von c0de als Text, etwa "0.5.0", und c0de net fügt C0DE_NET_VERSION hinzu, etwa "0.3.0". Sie brauchen kein INCLUDE.
Die neuesten veröffentlichten Versionen stehen im Web. c0de.at liest sie aus den Releases auf GitHub und beantwortet https://c0de.at/api/version mit einem kleinen JSON-Objekt:
{ "c0de": "0.5.0", "c0de_net": "0.3.0" }Das Programm braucht also ein GET, ein FROM_JSON und zwei Vergleiche. Die Anfrage kommt vom Computer des Spielers, der den Knopf drückt, und jeder Spieler kann Anfragen für seinen eigenen Computer abschalten. Die installierten Versionen sind dagegen die des Servers: Die Konstanten sagen, worauf das Blatt läuft.
Das Programm
PROGRAM versioncheck
NOOP
INCLUDE c0de/strings
INCLUDE c0de_net/http
NOOP
STRUCT releases
BEGIN
c0de STRING
net STRING TAG(json: "c0de_net")
END STRUCT
NOOP
FUNCTION compare
PARAMETER name STRING
PARAMETER installed STRING
PARAMETER latest STRING
RESULT current BOOLEAN
BEGIN
ASSIGN current installed = latest ;
IF current ;
BEGIN
CALL COLOR
PARAMETER foreground COLOR_GREEN ;
CALL PRINT
PARAMETER value name ⊕ " " ⊕ installed ⊕ ": up to date" ;
END
ELSE
BEGIN
CALL COLOR
PARAMETER foreground COLOR_RED ;
CALL PRINT
PARAMETER value name ⊕ " " ⊕ installed ⊕ ": " ⊕ latest ⊕ " is out" ;
END IF
CALL COLOR
PARAMETER foreground COLOR_WHITE ;
END FUNCTION
NOOP
FUNCTION check
RESULT current BOOLEAN
BEGIN
VARIABLE api STRUCT c0de_net/http/HTTP_CONNECTION
VARIABLE answer STRING
VARIABLE latest STRUCT releases
VARIABLE netCurrent BOOLEAN
ASSIGN api.use_ssl TRUE ;
ASSIGN api.server "c0de.at" ;
ASSIGN api.timeout 10 ;
CALL c0de_net/http/HTTP_GET
PARAMETER connection api ;
PARAMETER endpoint "/api/version" ;
RESULT result answer
CALL c0de/strings/FROM_JSON
PARAMETER source answer ;
PARAMETER destination latest ;
CALL CLS
CALL compare
PARAMETER name "c0de" ;
PARAMETER installed C0DE_VERSION ;
PARAMETER latest latest.c0de ;
RESULT current current
CALL compare
PARAMETER name "c0de net" ;
PARAMETER installed C0DE_NET_VERSION ;
PARAMETER latest latest.net ;
RESULT current netCurrent
ASSIGN current current AND netCurrent ;
END FUNCTIONAufbauen und starten
- Baue die Anzeigewand und binde sie an
versioncheck/check. - Stelle den Auslöserblock auf
versioncheck/check, leg eine nicht initialisierte Variablenkarte hinein und drück den Knopf.
Ist alles aktuell, zeigt die Wand zwei grüne Zeilen, und das Ergebnis current ist TRUE:
c0de 0.5.0: up to date
c0de net 0.3.0: up to date
Ist eine neue Version erschienen, ist ihre Zeile rot, etwa c0de 0.3.1: 0.4.0 is out, und current ist FALSE.
So funktioniert es
- Die Struktur ist die Antwort.
releaseshat ein Element pro Schlüssel der Antwort.c0deist ein gültiger Name, weil er mit einem Buchstaben beginnt.c0de_netwäre es auch, aber das Element heißtnet, undTAG(json: "c0de_net")ordnet es dem Schlüssel zu. comparemacht die Arbeit zweimal. Es bekommt einen Namen, die installierte und die neueste Version, gibt eine Zeile in Grün oder Rot aus und liefert, ob beide gleich sind.=vergleicht zwei Texte Zeichen für Zeichen.- Farben. COLOR legt die Farbe des folgenden Textes fest;
comparesetzt sie am Ende auf Weiß zurück, damit die nächste Zeile sauber beginnt. - Beide müssen aktuell sein.
currentaus dem ersten CALL undnetCurrentaus dem zweiten werden mit AND verknüpft. - Fragen kostet wenig. c0de.at fragt GitHub höchstens einmal pro Stunde und behält die Antwort dazwischen, also darfst du den Knopf so oft drücken, wie du willst. Ist GitHub nicht erreichbar und sind die Versionen unbekannt, ist die Antwort der Status 503, und der Prozess stürzt mit HTTP_STATUS ab.
Probier es selbst
- Eine Version, die nicht gleich der neuesten ist, ist nicht immer älter: Eine Testversion von c0de kann neuer sein als das neueste Release. Schreib eine Funktion, die sagt, ob eine Version älter ist als eine andere.
Lösung
PROGRAM versionorder
NOOP
INCLUDE c0de/strings
NOOP
FUNCTION number
PARAMETER version STRING
RESULT result FLOAT
BEGIN
VARIABLE rest STRING
VARIABLE piece STRING
VARIABLE dot INTEGER
VARIABLE part FLOAT
ASSIGN rest version ⊕ "." ;
FOR i INTEGER 1 ; 3 ;
BEGIN
CALL c0de/strings/INSTR
PARAMETER text rest ;
PARAMETER search "." ;
RESULT result dot
CALL c0de/strings/MID
PARAMETER text rest ;
PARAMETER start 0 ;
PARAMETER length dot ;
RESULT result piece
CALL c0de/strings/VAL
PARAMETER text piece ;
RESULT value part
ASSIGN result result * 1000 + part ;
CALL c0de/strings/MID
PARAMETER text rest ;
PARAMETER start dot + 1 ;
RESULT result rest
END FOR
END FUNCTION
NOOP
FUNCTION outdated
PARAMETER installed STRING
PARAMETER latest STRING
RESULT result BOOLEAN
BEGIN
VARIABLE mine FLOAT
VARIABLE theirs FLOAT
CALL number
PARAMETER version installed ;
RESULT result mine
CALL number
PARAMETER version latest ;
RESULT result theirs
ASSIGN result mine < theirs ;
END FUNCTIONnumber zerlegt die Version mit INSTR und MID an ihren Punkten, macht aus jedem Teil mit VAL eine Zahl und setzt sie zu einer Zahl zusammen: Aus 0.4.0 wird 4000, aus 0.10.0 wird 10000. Die Texte zu vergleichen, wäre hier falsch: "0.10.0" kommt im Alphabet vor "0.9.0", aber 0.10.0 ist die neuere Version. Um sie in versioncheck zu nutzen, kopiere beide Funktionen über compare und rufe outdated auf, statt mit = zu vergleichen.
- Lass die Anzeige
can't checkzeigen, statt abzustürzen, wenn die Anfrage fehlschlägt.
Lösung
Gib check eine Variable problem vom Typ ERROR und setz sie in die CALL-Zeile: CALL c0de_net/http/HTTP_GET problem. Prüfe gleich danach IF problem.code ≠ 0 ;, gib in seinem Block can't check: mit problem.message aus und beende die Funktion mit RETURN. Ein Spieler ohne c0de net sieht dann can't check: … statt eines Absturzes; siehe Wenn das Netz ausfällt.
Mehr dazu
- HTTP_GET, FROM_JSON und TAG
- Erste Schritte mit
C0DE_NET_VERSIONund die Konstanten jedes Programms - COLOR
- Die Releases von c0de und c0de net