Skip to main content

DRB Http driver

Project description

Http & Https Implementation

This drb-driver-http module implements http and https protocol access with DRB data model.

Http Factory and Http Node

The module implements the factory model defined in DRB in its node resolver. Based on the python entry point mechanism, this module can be dynamically imported into applications.

The entry point group reference is drb.driver.
The implementation name is http.
The factory class is encoded into drb.drivers.http.
The http signature id is b065a5aa-35a3-11ec-8d3d-0242ac130003
The https signature id is c18ef57c-3673-11ec-8d3d-0242ac130003

The HttpNode can be instantiated from an uri. The ParsedPath class provided in drb core module can help to manage these inputs.

Using this module

The project is present in https://www.pypi.org service. it can be freely loaded into projects with the following command line:

pip install drb-driver-http

Access Data

DrbHttpNode manages the http protocol to access remote data. The construction parameter is an url. Both http and https are supported. They allow access the http content en header. The content is accessible with value node class attribute. It shall also be possible to retrieve specific streamed implementation using get_impl methode. The URL HTTP GET response header of the given URL is accessible via attributes of the node.

from drb.drivers.http import DrbHttpNode

node = DrbHttpNode('https://gitlab.com/drb-python/impl/http/-/raw/main/README.md')

print(node.name)
print(node.attributes)
print(node.path)
print(node.value)

HTTP protocol does not allow navigation inside http path so this implementation is not able to provide any children of the same HTTP type.

Authentication

Http node is able to manage Basic authentication based on username and password, as well as OAuth2.0 authentication based on token. It should also support Digest authentication via requests package HTTPDigestAuth implementation.

Basic Auth

To implements Basic authentication connection, the HTTPBasicAuth class from requests package is used.

from requests.auth import HTTPBasicAuth
from drb.drivers.http import DrbHttpNode

auth = HTTPBasicAuth('username', 'password')
node = DrbHttpNode('https://www.gael.fr', auth=auth)

OAuth2.0 connection

A dedicated HTTPOAuth2 class is available to manage OAuth2.0 authentication. It allows token retrieval and refresh when expired.

from drb.drivers.http import DrbHttpNode, HTTPOAuth2

svc_url = 'https://www.gael-systems.com/service'
token_svc = 'https://auth.gael-systems.com/token'
user = 'user'
password = 'pass'
service_id = 'service'
secret = 'secret'

auth = HTTPOAuth2(username=user, password=password, token_url=token_svc,
                  client_id=service_id, client_secret=secret)

node = DrbHttpNode(svc_url, auth=auth)

The renewal event of the token is triggered by computation. Based on the token expiration delay, the implementation computes the period to create or refresh a new token. Thanks to this mechanism, no unnecessary connection is performed by the client for this stage.

Limitations

None

Documentation

The documentation of this implementation can be found here https://drb-python.gitlab.io/impl/http

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

drb_driver_http-1.3.5.tar.gz (34.5 kB view details)

Uploaded Source

Built Distribution

drb_driver_http-1.3.5-py3-none-any.whl (13.2 kB view details)

Uploaded Python 3

File details

Details for the file drb_driver_http-1.3.5.tar.gz.

File metadata

  • Download URL: drb_driver_http-1.3.5.tar.gz
  • Upload date:
  • Size: 34.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/8.0.0 pkginfo/1.11.1 requests/2.27.1 requests-toolbelt/1.0.0 tqdm/4.66.4 CPython/3.8.19

File hashes

Hashes for drb_driver_http-1.3.5.tar.gz
Algorithm Hash digest
SHA256 4d0c3a15390d43d8d99937d53854f1cd073126674a7ac5b28b9974bb364aaa97
MD5 a017245a89e73993f864785894868220
BLAKE2b-256 1af6939061a16b25a24e34340e55069f39c5a9155c4e16c47e30635f2e62cb2d

See more details on using hashes here.

File details

Details for the file drb_driver_http-1.3.5-py3-none-any.whl.

File metadata

  • Download URL: drb_driver_http-1.3.5-py3-none-any.whl
  • Upload date:
  • Size: 13.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/8.0.0 pkginfo/1.11.1 requests/2.27.1 requests-toolbelt/1.0.0 tqdm/4.66.4 CPython/3.8.19

File hashes

Hashes for drb_driver_http-1.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 834f74dba1c0d81e32d22561d3773f88070dd6162dec655558d7bf02c0951f39
MD5 f5b3444b245cd8d7c0881589e4e724c4
BLAKE2b-256 b0ce7cc7f9bb25fcc2ab4696e87b26337648034a136c1da4bdd7dd01d842238f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page