Queried WebClient

Letting the client do the work.

This component makes working with requests a little easier in introducing a somewhat async workflow by taking a request on  one after another with an extensive API. 
It makes life a little easier by autoparsing requests and responses to JSON.

  • Server : The base domain all requests will be appended to.
  • Header: A TableDAT representing a Header that will be appended to every request where first col is the key, second col is the value.
  • Timeout: How long to wait in seconds before closing the connection and executing the next request.
  • Processing : A Toogle showing if the client is currently processing a request.

  • Processing : Bool. Shows if the webclient is currently fetching data.
  • Exceptions: A list of Exceptions.
  • Request: The class-definition of the Request
  • Response: The class-definition of the Response
  • Cookie: The class-definition for a cookie.

  • Multipart : ClassDefinition for multipart-formdata.

multiPart = op("queriedWebclient").Multipart()
multiPart.AddField( "Key", "Value")
multiPart.AddFile( "Key", pathlib.Path( filepath ) )
content, header = multiPart.Parse()
op("queriedWebclient").Post( "endpoint", header = header, data = content)

  • Get( endpoint:str , params:dict = {}, header:dict = {}, cookies:list<Cookie> = [], callback:func<request, response, client_comp> = default_callback )
    Query a get request. Except endpoint everything else is optional.
  • Post/Put/Delete/Search( endpoint, params:dict = {} , header:dict = {}, cookies:list<Cookie> = [], data:any = None, callback:func<request, response, client_comp> = default_callback)
    Creates a Post/Put/Delete request. If the data is delivered as a dictionary, it will be converted to JSON and the apllicationtype Json will be applied to the header.
  • QueryRequest( request_object ) 
    Attaches a Request-Object and attaches it to the query. If no object is in the query it will start the request. Above functions are wrappers around this.
  • Request_Class( server:str, method:str, uri:str = "/", query:dict = {}, header:dict = {}, cookies:list<Cookie> = [], data:any = None, callback:func<lambda request, response, client_comp> = default_callback )
    Created a request-object that can be used in QueryRequest.
  • Cookie( cookie_str:str)
    Can be used to forge cookies, but you actually should just use the ones you already got in the response!

Class Members
class Request:
	method : str
	uri    : str
	header : dict
	query  : dict
	data   : any
	cookies : list

class Response:
    statuscode      : int
    statusreason    : str
    header          : dict
    cookies         : list
    data            : any
    raw_data        : any

class Cookie:
    key         : str
    value       : str 
    settings    : dict

For get one page of catbreeds from catfact.ninja and print it out call:

							params = {"limit" : 1},
							callback = lambda request, response, server: debug(response))

  • onResponse(request, response, client_comp): Passes the request and the response on a good response.
  • onError(request, response, client_comp ): On error. Passes the request, response, an exception and the module with exceptions.
  • onQueryEmpty(): Gets called when the last request in the current query resolved.
  • onTimeout( request ): No response from the server during the timeout.

The onError-callbacks passes an exception-object that can be rissen and excepted to handle specific errors.

		raise error_exception( response["body"] )
	except exceptions.NotFound:
		#What happens when the endpoint cannot be found?

WebClientError : A general-purpose error.
UserError : The issues lies withing the request
ServerError : The issue comes from the server.

 400 : BadRequest,
 401 : Unauthorized,
 403 : Forbidden,
 404 : NotFound,
 405 : MethodNotAllowed,
 410 : Gone,
 500 : InternalServerError,
 501 : NotImplemented,
 502 : BadGateway,
 503 : ServiceUnavailable,
 504 : GatewayTimeout

Downloads: 1122

Created at: 6.8.2021

Uploaded: 5.9.2023
Fixed handling of nonfunctional responses (which are now vlid responses...)
Added logging.