Skip to main content

Client of redundant servers

Project description

Client of redundant servers

Build Status codecov PyPI version

Generic client of redundant servers. A simple framework to make requests of unreliable servers. Throws an exception if no servers are available, otherwise returns a result from the first server that doesn't fail. Supports round-robin, fixed, and random orders of servers.

The intention is that you can use this to glue together things that are otherwise slightly tedious, using your own client classes which inherit from ClientOfRedundantServers.

Installation

pip install client-of-redundant-servers

Usage

Say you have some web servers, all serving the same content, and you want to get a file from any one. You don't care which server responds, but you don't want to have to manually look for failures and try again.

client_of_redundant_servers lets you write things like this:

import requests
import client_of_redundant_servers as cors


class ClientOfRedundantWebServers(cors.ClientOfRedundantServers):
    def __init__(self, url_list: list):
        super().__init__(url_list)

    def _get_file_func(self, url):
        try:
            r =  requests.get(url)
            # Check for errors that didn't raise a requests.exception
            if not r.ok:
                raise cors.CurrentServerFailed
            return r
        except requests.exceptions.RequestException:
            raise cors.CurrentServerFailed

    def get_file(self):
        return self.request(self._get_file_func)


# Only picking on Ubuntu because it is widely mirrored.
urls = ["http://badserver.example.com/badfile",
        "http://www.mirrorservice.org/sites/cdimage.ubuntu.com/cdimage/releases/16.04/release/SHA256SUMS",
        "http://nl.archive.ubuntu.com/ubuntu-cdimages/16.04/release/SHA256SUMS"]

client = ClientOfRedundantWebServers(urls)
try:
    r = client.get_file()
    print(r.text)
    print("*****")
    print("Retrieved from : " + r.url)
except cors.AllAvailableServersFailed:
    print("Error! No servers were available to service the request.")

If you run that, you'll see that the client tries to retrieve the file from badserver, which fails, so it continues to try the next available server.

See the "examples" directory for some examples that might be useful. Currently there's a RADIUS client using pyrad and an Active Directory LDAP client using ldap3.

Project details


Download files

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

Files for client-of-redundant-servers, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size client_of_redundant_servers-0.4-py3-none-any.whl (9.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size client_of_redundant_servers-0.4.tar.gz (6.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page