jsonparse

JSONParse: Ctrl-F pour JSON

JSONParse est une simple bibliothèque d'analyse JSON. Extraire ce qui est nécessaire de la clé: paires de valeurs.

Quoi de neuf

• Python 2.7 Compat. ? ?
• Une nouvelle fonction, Find_value, a été ajoutée. Cette fonction renvoie toutes les touches de la valeur correspondante. ?
• Outil CLI. Analyser les fichiers texte JSON ou stdin via la ligne de commande?

Bibliothèque python

Installer

pip install jsonparse

Start

Voici un exemple rapide de ce que JSONParse est capable de faire.

 from jsonparse import find_key , find_keys , find_key_chain , find_key_value , find_value

data = [{
  "key0" :
    {
      "key1" : "result" ,
      "key2" :
        {
          "key1" : "result1" ,
          "key3" : { "key1" : "result2" }
        }
    }
}]

find_key ( data , 'key1' )
[ 'result2' , 'result1' , 'result' ]

find_key_chain ( data , [ 'key0' , 'key2' , 'key3' , 'key1' ])
[ 'result2' ]

➕ Voir la documentation supplémentaire dans la section API ci-dessous.

Outil CLI

Installer

pip install jsonparse

Start

Résumé des commandes CLI. Pour des informations complètes, jp --help

Remarque, jsonparse et jp sont équivalents.

jp key key1 --file text.json

jp keys key1 key2 key3 --file text.json

jp key-chain my '*' chain --file text.json

jp key-value key1 '"result"' --file text.json

echo '{"key1": {"key2": 5}}' | jp key key2

jp value null --file text.json

jp value 42 --file text.json

jp value '"strValue"' --file text.json

API

• Fonctions JSONParse
  • find_key
  • find_keys
  • find_key_chain
  • find_key_value
  • find_value

Les exemples de l'API utilisant les données de test suivantes.

 data = [
    { "key" : 1 },
    { "key" : 2 },
    { "my" : 
        { "key" : 
            {
                "chain" : "A" ,
                "rope" : 5 ,
                "string" : 1.2 ,
                "cable" : False
            }
        }
    },
    { "your" :
    	{ "key" :
            {
                "chain" : "B" ,
                "rope" : 7 ,
                "string" : 0.7 ,
                "cable" : True
            }
    	}
    }
]

---

Fonctions

 from jsonparse import find_key , find_keys , find_key_chain , find_key_value , find_value

---

find_key

 find_key ( data : dict | list | ordonnédict, clé : str ) -> liste

Renvoie toutes les valeurs de la touche correspondante.

 find_key ( data , 'chain' )
[ 'A' , 'B' ]

find_key ( data , 'key' )
[ 1 , 2 , { 'chain' : 'A' , 'rope' : 5 , 'string' : 1.2 , 'cable' : False }, { 'chain' : 'B' , 'rope' : 7 , 'string' : 0.7 , 'cable' : True }]

---

find_keys

 find_keys ( data : dict | list | ordonnadict, clés : liste, groupe : bool = true ) -> liste

La valeur de retour par défaut est une liste en deux dimensions. [ [], [], ...] .

Pour retourner toutes les valeurs en tant que liste unidimensionnelle, définissez group=False .

L'ordre des clés n'a pas d'importance.

 find_keys ( data , [ 'rope' , 'cable' ])
[[ 5 , False ], [ 7 , True ]]

find_keys ( data , [ 'rope' , 'cable' ], group = False )
[ 5 , False , 7 , True ]

---

find_key_chain

 find_key_chain ( data : dict | list | ordonnédict, clés : liste ) -> liste

La chaîne de clés est une liste ordonnée de clés. La chaîne doit commencer au niveau racine des données imbriquées.

Le tableau générateur * peut être utilisé comme clé pour correspondre à n'importe quel.

 find_key_chain ( data , [ 'my' , 'key' , 'chain' ])
[ 'A' ]

find_key_chain ( data , [ 'key' ])
[ 1 , 2 ]

find_key_chain ( data , [ '*' , 'key' , 'chain' ])
[ 'A' , 'B' ]

find_key_chain ( data , [ '*' , 'key' , '*' ])
[ 'A' , 5 , 1.2 , False , 'B' , 7 , 0.7 , True ]

---

find_key_value

 find_key_value ( données : dict | list | ordonnédict, clé : str, valeur : str | int | float | bool | nul) -> liste

La liste renvoyée contient les dictionnaires qui contiennent la paire de clés spécifiée: valeur.

 find_key_value ( data , 'cable' , False )
[{ 'chain' : 'A' , 'rope' : 5 , 'string' : 1.2 , 'cable' : False }]

find_key_value ( data , 'chain' , 'B' )
[{ 'chain' : 'B' , 'rope' : 7 , 'string' : 0.7 , 'cable' : True }]

---

find_value

 find_value ( data : dict | list | ordonnadict, valeur : str | int | float | bool | nul ) -> liste

Renvoie toutes les clés de la valeur correspondante.

 find_value ( data , 'A' )
[ 'chain' ]

find_value ( data , False )
[ 'cable' ]

Python 2.7 Utilisation

• 2.7 ne garantit pas la commande de dictionnaire. Si la commande est importante, utilisez OrdredDict pour tous les dictionnaires dans les données.

API Web

Documentation

Visitez la documentation de l'API Swagger

Tous les points de terminaison sont des demandes HTTP Post où vous incluez les données JSON consultables dans le corps de la demande.

Brève aperçu des points de terminaison

POST /v1/key/{key}
POST /v1/keys ? key=1 & key=2 & key=3 & key=4...
POST /v1/keychain ? key=1 & key=2 & key=3 & key=4...
POST /v1/keyvalue ? key=a & value=1
POST /v1/value/{value}

Start

Entraînons-vous à l'utilisation du public, gratuit à l'authentification, API Web hébergé dans GCP Cloud Run.

Nous publions les données JSON avec Curl, demandant à rechercher la clé, «key1». Les valeurs de clés trouvées sont renvoyées en JSON.

curl -X POST " https://jsonparse.dev/v1/key/key1 " 
-H ' Content-Type: application/json ' 
-d ' [{"key0":{"key1":"result","key2":{"key1":"result1","key3":{"key1":"result2"}}}}] '

[ " result2 " , " result1 " , " result " ]

Ou (à l'aide de python et de demande de bibliothèque)

 import requests

data = [{
    "key0" :
    {
        "key1" : "result" ,
        "key2" :
        {
            "key1" : "result1" ,
            "key3" : { "key1" : "result2" }
        }
    }
}]

requests . post ( 'https://jsonparse.dev/v1/key/key1' , json = data ). json ()

[ 'result2' , 'result1' , 'result' ]

Auto-hébergé

pip install " jsonparse[webapi] "

gunicorn -b 0.0.0.0:8000 jsonparse.webapi:app

Alternativement, exécutez le conteneur Docker

docker run -d ctomkow/jsonparse