2.5 KiB

Raw Permalink Blame History

SpaceCache

Sinn: Frage Spaces cached ab anstatt yolo-like bei jeder Request alles gleichzeitig anzuhauen.

Wie bedienen?

Mach 'ne GraphQL Request. Ist eigentlich recht simpel, aber du kannst auch GraphiQL nutzen um dir eine Request zu erarbeiten. Wenn du alle Spaces haben willst kannst du zum Beispiel sowas basteln.

{ spaces {
  id
  open
} }

Wenn du aber nur Bock auf einen Space hast, kannst du auch diesen stupiden Oneliner bringen:

{ isOpen(id: "unhb") }

Spaces und Config

So sieht ein Eintrag in der spaces.json aus:

{
  "name": "CCC Aachen",
  "id": "cccaachen",
  "area": "DE-NW",
  "endpoint": "https://status.aachen.ccc.de/api/v0/status/current?public",
  "path": "$.changed.status",
  "expected": "public"
}

id ist eine einfache ID des Spaces. Sollte sich natürlich nicht überschneiden.
name ist eine Art Friendly Name. Kann man benutzen damit es schön aussieht.
area ist ein optionaler Value, der den Standort nach ISO 3166-2:DE beschreibt. Kann benutzt werden, um später nach Region zu filtern.
endpoint beschreibt die URL, die der Server anhauen soll.
path ist ein JSONPath zum Wert, der beschreibt, ob der Space offen ist. Das ist nur nötig, wenn die API vom SpaceAPI Standard abweicht.
expected kann einen Value beschreiben, wenn der Wert sich nicht durch einen Boolean darstellen lässt (also nicht true, "true", 1, usw.). Das sollte auch nur nötig sein, wenn die API vom SpaceAPI Srandard abweicht.

Die config.json ist eigentlich selbsterklärend.

Deployment

Aktuell läuft eine Instanz auf https://spaceapi.ryzetech.live/graphql und wird manuell durch ryze deployt. CD ist für irgendwann geplant.
Wenn du das Bedürfnis hast, den Quatsch selbst zu hosten, mach folgendes:

yarn
yarn prisma migrate dev
yarn run start

Dann bau dir die Config wie du willst. Wenn du Fragen hast, schreib mir gerne auf Matrix: @ryze:matrix.un-hack-bar.de

Warum?

@CyReVolt:matrix.org hat eine Seite gebaut, die die Hackspaces in NRW auf ihren Status abfragt => https://metaspora.org/hackerspaces/.
Mich hat es irgendwie gewurmt, dass jeder Status direkt vom Client abgefragt wird. Daraufhin hab ich ein Backend vorgeschlagen, was die Space Server periodisch anhaut und schaut was Phase ist, die Ergebnisse in einer SQLite DB vermerkt und cached.

CyReVolt so:

ryze so: