Library to access Tryton server as a client
Project description
A library to access Tryton’s models like a client.
Example of usage
>>> from proteus import config, Model, Wizard, Report
Configuration
Configuration to connect to a sqlite memory database using trytond as module.
>>> config = config.set_trytond('sqlite:///:memory:')
There is also the config.set_xmlrpc method which can be used to connect using a URL, and the config.set_xmlrpc_session method (when used as a context manager) which connects for a session.
Activating a module
Find the module, call the activate button and run the upgrade wizard.
>>> Module = Model.get('ir.module')
>>> party_module, = Module.find([('name', '=', 'party')])
>>> party_module.click('activate')
>>> Wizard('ir.module.activate_upgrade').execute('upgrade')
Creating a party
First instanciate a new Party:
>>> Party = Model.get('party.party')
>>> party = Party()
>>> party.id < 0
True
Fill the fields:
>>> party.name = 'ham'
Save the instance into the server:
>>> party.save() >>> party.name 'ham' >>> party.id > 0 True
Setting the language of the party
The language on party is a Many2One relation field. So it requires to get a Model instance as value.
>>> Lang = Model.get('ir.lang')
>>> en, = Lang.find([('code', '=', 'en')])
>>> party.lang = en
>>> party.save()
>>> party.lang.code
'en'
Creating an address for the party
Addresses are store on party with a One2Many field. So the new address just needs to be appended to the list addresses.
>>> address = party.addresses.new(postal_code='42')
>>> party.save()
>>> party.addresses #doctest: +ELLIPSIS
[proteus.Model.get('party.address')(...)]
Adding category to the party
Categories are linked to party with a Many2Many field.
So first create a category
>>> Category = Model.get('party.category')
>>> category = Category()
>>> category.name = 'spam'
>>> category.save()
Append it to categories of the party
>>> party.categories.append(category)
>>> party.save()
>>> party.categories #doctest: +ELLIPSIS
[proteus.Model.get('party.category')(...)]
Print party label
There is a label report on Party.
>>> label = Report('party.label')
The report is executed with a list of records and some extra data.
>>> type_, data, print_, name = label.execute([party], {})
Sorting addresses and register order
Addresses are ordered by sequence which means they can be stored following a specific order. The set_sequence method stores the current order.
>>> address = party.addresses.new(postal_code='69') >>> party.save() >>> address = party.addresses.new(postal_code='23') >>> party.save()
Now changing the order.
>>> reversed_addresses = list(reversed(party.addresses)) >>> while party.addresses: ... _ = party.addresses.pop() >>> party.addresses.extend(reversed_addresses) >>> party.addresses.set_sequence() >>> party.save() >>> party.addresses == reversed_addresses True
Setting context
Make French translatable:
>>> Language = Model.get('ir.lang')
>>> french, = Language.find([('code', '=', 'fr')])
>>> french.translatable = True
>>> french.save()
Create a category in English:
>>> Category = Model.get('party.category')
>>> with config.set_context(language='en'):
... category = Category(name="Category")
... category.save()
Translate in French:
>>> with config.set_context(language='fr'): ... category_fr = Category(category.id) ... category_fr.name = "Categorie" ... category_fr.save()
Read in English:
>>> category.reload() >>> category.name 'Category'
Read in French:
>>> category_fr.reload() >>> category_fr.name 'Categorie'
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file proteus-6.2.1.tar.gz.
File metadata
- Download URL: proteus-6.2.1.tar.gz
- Upload date:
- Size: 42.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.0 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 13a419f930b23456a37a7384df4ade4b646477d6d0ac5d4e275fe24d96271757 |
|
| MD5 | 8e984f554cc61d31cb781a996d66e9d5 |
|
| BLAKE2b-256 | bf73fc97191dab8e0e52bb84f3423dc8ca45e97bf8fa89336cafd8bbce360d06 |
Provenance
File details
Details for the file proteus-6.2.1-py3-none-any.whl.
File metadata
- Download URL: proteus-6.2.1-py3-none-any.whl
- Upload date:
- Size: 39.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.0 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b2cf10b39080f32fd3ddf4beac6a5e098398c6e7b304e85cef06626946df9796 |
|
| MD5 | ce2c119996a3b6bf740571ae4adfe9fa |
|
| BLAKE2b-256 | c0ecea6d2ef8d604ce594dbf6572448f542e4df22cf64b3ab2f79b8efea2ffe8 |
