gqla 0.3.2

A module used to generate querry statements and perform data fetching via GraphQL

GQLA - GraphQL Assistant

GQLA provides an easy way to fetch data from GraphQL api on server side.

Navigation:

• Intro
• Usage
• Installation
• Structure

Intro

GQLA is published under MIT license and doesn't provide any warranty. It is single person developed package.
No roadmap No warranty No consistency No active and fast responces to dev
This project IS (almost) following SOLID yet

Usage

WARNING : watch carefull about your recursion depth; nodes and edges also counted as recursion level;

Example of basic usage bellow:

# Create a list of ignored fields (recommended values)
ignore = ['pageInfo', 'deprecationReason', 'isDeprecated', 'cursor']  
# Create a GQLA class instance with provided settings
helper = GQLA('graphql-service', url='localhost', port=8086, ignore=ignore, usefolder=True)  # noqa
# Request introspection (saved to "gqla/graphql-service" folder)
await helper.introspection()
# Request query with argument useSomeArgs='false' and specify that we use folder to save result
result = await helper.query_one('cerviceTestData', to_file=True, useSomeArgs='false')
# Print result (can still gather result as json named _cerviceTestData from "gqla/graphql-service" folder)
print(result)

Installation

Requirements:

• aiohttp
• r/w access if using folder to save infrastucture
• python >= 3.5

Structure

Classes

• GQLModel - Model class containing GraphQL service data
• GQLStorage - Storage class to contain and parse GraphQL data types
• GQQStorage - Queries storage class
• GQQuery - Queries class
• Executor - Executor class
• GQLA - main class

Parameters:

• _subpid - number of subtask running; No actual usage besides logging
• _model - model of GraphQL service; Conains full accessible service structure; DO NOT TOUCH
• _ignore - list of statements to ignore during querries generation
• name - name used to define service; required to create folders if usefolder is set
• url - url of GraphQL service
• port - port of GraphQL service
• usefolder - directive to use folder to store data such as service model, querries and returned data
• recursive_depth - recursion depth limitation;

Methods

Notice that async meant to execute in execution loop;

• set_ignore - set _ignore field of main class;
• query_one - method to generate and execute querries;async
• introspection - method to gather information about service;async