Skip to main content

Woob, Web Outside Of Browsers

Project description

Package Version Last commit Python Version License

Woob (Web Outside of Browsers) is a library which provides a Python standardized API and data models to access websites.

Overview

https://woob.dev/_images/arch.png

There are three main concepts:

  • Capabilities: This is a standardized interface to access a specific kind of website. It provides an unified API and standard datamodels;

  • Modules: A module is dedicated to a specific website. It can implements several capabilities (for example paypal module may implement CapBank to get bank informations, CapTransfer to initiate a transfer, CapProfile to get information about the customer, and CapDocument to get documents);

  • Backends: You can load a module several times, with different configurations. For example, if you have two PayPal accounts, you can create two backends of the same module with different credentials.

The main Woob class let configure new backends and do aggregated calls to every backends loaded with a specific capability.

For example, once backends are loaded, you can call iter_accounts() and you’ll get accounts in the same Account data model for all backends implementing CapBank:

>>> from woob.core import Woob
>>> from woob.capabilities.bank import CapBank
>>> w = Woob()
>>> w.load_backends(CapBank)
{'societegenerale': <Backend 'societegenerale'>,
 'creditmutuel': <Backend 'creditmutuel'>}
>>> accounts = list(w.iter_accounts())
>>> print(accounts)
[<Account id='7418529638527412' label=u'Compte de ch\xe8ques'>,
 <Account id='9876543216549871' label=u'Livret A'>,
 <Account id='123456789123456789123EUR' label=u'C/C Eurocompte Confort M Roger Philibert'>]
>>> accounts[0].balance
Decimal('87.32')

Applications

If you are looking for applications using the woob library, visit woob.tech.

Installation

Read this documentation.

Documentation

More information about how to use woob at woob.dev.

Contributing

If you want to contribute to woob (patch of the core, creating new modules, etc.), read this.

Chat with us

Download files

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

Source Distribution

woob-3.4.tar.gz (343.6 kB view hashes)

Uploaded source

Built Distribution

woob-3.4-py3-none-any.whl (494.9 kB view hashes)

Uploaded py3

Supported by

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