Skip to content

objeto utilizado para conectar distintos componentes de backend y frontend. con el objetivo de poder controlar de mejor manera los distintos escenarios que podrían ocurrir con la comunicación de estos.

License

Notifications You must be signed in to change notification settings

jhonnattan123/python-module-connector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

python-module-connector

object used to connect different backend and frontend components. with the aim of being able to better control the different scenarios that could occur with the communication of these.

structure

Attribute Type Default Description
success boolean False tells us if the process that the component is in charge of is completed successfully or not
message string module_connector a message is left here depending on the conclusion of the component. for example: created_user, existing_name, id_no_found
response list / dict [] All the content that should come from the component is sent here, it can be a list, an element as such, but never a string, boolean or integer value, for reasons of scalability
code integer 500 HTTP code

Simple example

although the component is called a module connector. The most recommended is to define a variable with the name of output when creating a new connector, since it is more readable. it is also recommended to define it as let so that it never deceives us with other classes, functions or services

# include library
from module_connector import Moduleconnector

# create default output from module connector
output = Moduleconnector()

# your code
arrClientList = [
    { "id":1, "name": "diana" },
    { "id":2, "name": "jorge" }
];

# use method ok and add object
output.ok(arrClientList)

# print output
print(output.__dict__)

#--------------------------
# result
# {
#     'success' : True,
#     'message' : 'ok',
#     'code' : 200,
#     'response' : [
#         { 'id':1, 'name': 'diana' },
#         { 'id':2, 'name': 'jorge' }
#     ]
# }

using http-based methods it is possible to shorten the previous sentence making it smaller and more readable

also can define another message:

# create default output from module connector
output = Moduleconnector( "another_default_message" )

# or
output.ok("hello_world")

Faileds methods

in this case using the badRequest() for send a success false response with code 400.

# for output with response and message (the order of the variables does not matter)
output.badRequest( arrClientList, "array_clients_list" )

#--------------------------
# result
# {
#     'success' : False,
#     'message' : 'array_clients_list',
#     'code' : 400,
#     'response' : [
#         { 'id':1, 'name': 'diana' },
#         { 'id':2, 'name': 'jorge' }
#     ]
# }

also if you don't have an object to add to your output you can just write the message (this also applies to successful responses)

# for output with message only
output.badRequest( "empty_response" )

#--------------------------
# result
# {
#     'success' : False,
#     'message' : 'empty_response',
#     'code' : 400,
#     'response' : []
# }

Methods

it is recommended that all requests with code 2XX are always true and that 3XX, 4XX and 5XX are always false

Method Name Success Code
.ok() true 200
.created() true 201
.accepted() true 202
.nonAuthoritative() true 203
.noContent() true 204
.badRequest() false 400
.unauthorized() false 401
.forbidden() false 403
.notFound() false 404
.conflict() false 409

About

objeto utilizado para conectar distintos componentes de backend y frontend. con el objetivo de poder controlar de mejor manera los distintos escenarios que podrían ocurrir con la comunicación de estos.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages