Utforska jq: Ett kraftfullt verktyg för att hantera JSON-data

JSON har blivit ett av de mest använda formaten för att överföra data, särskilt inom API:er och moderna databassystem. För att effektivt kunna manipulera och bearbeta JSON-data behöver man rätt verktyg, och jq är ett av de mest kraftfulla och flexibla alternativen som finns tillgängliga. I denna artikel kommer vi att gå igenom vad jq är, hur det används, samt presentera några alternativa verktyg som kan vara värda att överväga.

Vad är jq och vad används det till?

Jq är ett kommandoradsverktyg som används för att bearbeta och filtrera JSON-data. Det används ofta tillsammans med andra kommandon, som cURL, för att hantera data som hämtas från API:er. Till exempel kan du med hjälp av jq och cURL snabbt och enkelt hämta och filtrera information från Digitaloceans API.

Förutom att vara användbart för API-interaktioner, är jq också ett ovärderligt verktyg för att hantera stora JSON-filer. Många moderna databassystem, inklusive MongoDB, PostgreSQL och MySQL, använder JSON som ett sätt att lagra data. Genom att behärska jq får du inte bara bättre kontroll över din data, utan du blir också bättre rustad att förstå och arbeta med dessa databassystem.

Så installerar och använder du jq

Att komma igång med jq är enkelt. För att installera jq på en Linux-maskin, använder du följande kommando:

sudo apt install jq

När jq är installerat kan du använda det för att bearbeta JSON-data. Ett enkelt exempel är att hämta din IP-adress från ipinfo.io och skriva ut den i ett läsbart format:

curl https://ipinfo.io/ | jq '.'

Här används det mest grundläggande jq-filtret, punkt (.), som helt enkelt skriver ut JSON-datan i ett formaterat, läsbart format. Du kan också använda rörsymbolen (|) för att kombinera flera filter. Till exempel kan du filtrera ut enbart IP-adressen från samma JSON-svar:

curl https://ipinfo.io/ | jq '. | .ip'

Skapa en enkel nyhetsläsare med jq

Ett av de mest användbara sätten att använda jq är att skapa en enkel nyhetsläsare för att hämta data från API:er. Många webbplatser, inklusive Github, erbjuder API:er där du kan hämta information om projekt och deras senaste uppdateringar.

För att börja kan du använda cURL för att hämta information från ett Github-repository, till exempel Bitcoin-projektet:

curl https://api.github.com/repos/bitcoin/bitcoin/issues

För att enbart visa den första posten i flödet kan du använda jq så här:

curl https://api.github.com/repos/bitcoin/bitcoin/issues | jq '.[0]'

Detta kommando visar alla fält i den första posten från API:et. Du kan anpassa JSON-utdata genom att använda jq:s filter och skapa ett skräddarsytt JSON-objekt:

curl https://api.github.com/repos/bitcoin/bitcoin/issues | jq '.[0] | { title: .title }'

Vill du visa flera fält, kan du lägga till dessa med ett kommatecken:

curl https://api.github.com/repos/bitcoin/bitcoin/issues | jq '.[0] | {title: .title, url: .html_url, author: .user.login}'

Genom att ta bort indexet ”0” kan du applicera filtret på alla poster i flödet:

curl https://api.github.com/repos/bitcoin/bitcoin/issues | jq '.[] | {title: .title, url: .html_url, author: .user.login}'

För den som vill automatisera detta kan du skapa ett Bash-script som hämtar och visar den senaste informationen från ett specifikt Github-projekt.

Söka och läsa data från en JSON-databas

Jq är inte bara användbart för att hämta data från API:er; det är också ett kraftfullt verktyg för att hantera JSON-filer på din dator. Anta att du har en JSON-databas med följande struktur:

[
    {"id": 1, "name": "Ramces", "balance": 20},
    {"id": 2, "name": "Alice", "balance": 30},
    {"id": 3, "name": "Bob", "balance": 10},
    {"id": 4, "name": "Charlie", "balance": 20},
    {"id": 5, "name": "Maria", "balance": 50}
]

För att läsa den första posten i databasen använder du följande kommando:

jq '.[0]' database.json

Vill du lista alla namn i databasen, kan du använda detta kommando:

jq '.[] | .name' database.json

Jq har också inbyggda funktioner som låter dig filtrera data baserat på olika kriterier, till exempel längden på namnet:

jq '.[] | select((.name|length)>6)' database.json

Bearbeta JSON-databaser med jq

Jq erbjuder även funktioner som gör att du kan behandla JSON-data på ett sätt som påminner om kalkylblad. Till exempel kan du summera alla saldon i databasen:

jq '[.[] | .balance] | add' database.json

Du kan även lägga till villkor i dina filter, som att bara inkludera ett saldo om namnet är ”Alice”:

jq 'if .[1].name == "Alice" then [ .[] | .balance ] | add else "Second name is not Alice" end' database.json

Jq gör det möjligt att både ta bort och lägga till data temporärt eller permanent, vilket är särskilt användbart vid testning och filtrering.

Hantera icke-JSON-data med jq

En av jq:s mindre kända men mycket användbara funktioner är möjligheten att bearbeta data som inte är i JSON-format. Genom att använda ett särskilt ”slurpläge” kan jq konvertera textdata till JSON-arrayer:

echo '1 2' | jq -s .

När data har konverterats kan du använda index för att referera till och manipulera datan. Till exempel kan du addera två tal:

echo '1 2' | jq -s '.[0] + .[1]'

Du kan även skapa ett nytt JSON-objekt från text:

echo '6 "Mallory" 10' | jq -s '{"id": .[0], "name": .[1], "balance": .[2]}'

Om du bara vill ha ut råtext från jq, exempelvis för att använda det i ett skript, kan du använda flaggan -r:

jq -r '.[] | .name' database.json

Alternativa verktyg till jq

Även om jq är mycket populärt, finns det flera alternativa verktyg som kan vara värda att överväga beroende på dina behov.

• jaq: Skrivet i Rust, erbjuder jaq samma funktionalitet som jq men är upp till 30 gånger snabbare. Detta kan vara avgörande när du hanterar stora datamängder. Nackdelen är att jaq inte finns i de vanliga Linux-paketförråden, så du måste installera det manuellt.
• gojq: Ett annat alternativ är gojq, som är skrivet i Go. Det är lätt att installera på många plattformar och ger mer detaljerade felmeddelanden, vilket kan vara till stor hjälp för nybörjare. GoJq kan även hantera YAML-filer, vilket gör det användbart för Docker-användare. Dock saknar det några funktioner som finns i jq.
• fq: Fq är ett kraftfullt verktyg som kan hantera både text- och binärdata, inklusive JSON, YAML och HTML. Det har även en inbyggd hex-läsare, vilket gör det användbart för att analysera filers interna struktur. Fq är dock fortfarande under utveckling, så vissa funktioner kan komma att förändras.

Sammanfattning

Att lära sig jq är en utmärkt investering för alla som arbetar med JSON-data. Oavsett om du hämtar data från API:er, bearbetar stora JSON-filer eller manipulerar data i ett skript, ger jq dig verktygen du behöver för att arbeta effektivt och flexibelt. Genom att även utforska alternativa verktyg som jaq, gojq och fq, kan du hitta den lösning som bäst passar dina specifika behov.

Att behärska jq är bara början på din resa inom programmering och automatisering. Utforska vidare och lär dig hur du kan använda dessa färdigheter för att bygga kraftfulla och effektiva verktyg på din dator.

Kred till

https://www.maketecheasier.com/use-jq-process-json-linux/