This page in English

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:

json
{ "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 ​

c0de
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 FUNCTION

Aufbauen und starten ​

  1. Baue die Anzeigewand und binde sie an versioncheck / check.
  2. 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
The display wall with the two green lines c0de 0.5.0: up to date and 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. releases hat ein Element pro Schlüssel der Antwort. c0de ist ein gültiger Name, weil er mit einem Buchstaben beginnt. c0de_net wäre es auch, aber das Element heißt net, und TAG(json: "c0de_net") ordnet es dem Schlüssel zu.
  • compare macht 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; compare setzt sie am Ende auf Weiß zurück, damit die nächste Zeile sauber beginnt.
  • Beide müssen aktuell sein. current aus dem ersten CALL und netCurrent aus 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 ​

  1. 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
c0de
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 FUNCTION

number 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.

  1. Lass die Anzeige can't check zeigen, 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 ​