Client for Nasjonal Turbase REST API
Project description
# turbasen.py
Python client for Nasjonal Turbase
## Usage
```python
In [1]: from turbasen import Sted, Omrade
In [2]: Sted.get('52407fb375049e561500004e')
Out[2]: Sted: 52407fb375049e561500004e (Tjørnbrotbu)
In [3]: for sted in list(Sted.lookup())[:3]:
print(sted)
Sted: 52407fb375049e5615000356 (Lahpoluoppal)
Sted: 52407fb375049e561500027d (Øvre Grue)
Sted: 52407fb375049e5615000385 (Rotneros)
In [4]: for omrade in list(Omrade.lookup())[:3]:
print(omrade)
Område: 52408144e7926dcf15000004 (Sørlandet)
Område: 52408144e7926dcf1500002b (Østlandet)
Område: 52408144e7926dcf1500000e (Vestlandet)
```
## Configuration
Call `turbasen.configure` to change settings. For example:
```python
import turbasen
turbasen.configure(
LIMIT=50,
CACHE=my_cache,
)
```
[The available settings](https://github.com/Turbasen/turbasen.py/blob/master/turbasen/settings.py) are:
* `ENDPOINT_URL`: The URL to the Nasjonal Turbase API endpoint
* `LIMIT`: Results per page when fetching multiple objects. Currently allows up to 50; [see the docs](http://www.nasjonalturbase.no/) for updates.
* `CACHE`: If specified, the library will itself perform what it deems to be reasonable caching of lookups and objects. Expects a cache engine implementing a small subset of [the Django cache API](https://docs.djangoproject.com/en/dev/topics/cache/#the-low-level-cache-api), specifically its `get` and `set` methods.
* `API_KEY`: Currently an API key is required for access, however there are plans to drop the key requirement. [See the website](http://www.nasjonalturbase.no/) for updates. The API key can also be specified as an exported environment variable called `TURBASEN_API_KEY`.
[See the source file for default values](https://github.com/Turbasen/turbasen.py/blob/master/turbasen/settings.py).
Python client for Nasjonal Turbase
## Usage
```python
In [1]: from turbasen import Sted, Omrade
In [2]: Sted.get('52407fb375049e561500004e')
Out[2]: Sted: 52407fb375049e561500004e (Tjørnbrotbu)
In [3]: for sted in list(Sted.lookup())[:3]:
print(sted)
Sted: 52407fb375049e5615000356 (Lahpoluoppal)
Sted: 52407fb375049e561500027d (Øvre Grue)
Sted: 52407fb375049e5615000385 (Rotneros)
In [4]: for omrade in list(Omrade.lookup())[:3]:
print(omrade)
Område: 52408144e7926dcf15000004 (Sørlandet)
Område: 52408144e7926dcf1500002b (Østlandet)
Område: 52408144e7926dcf1500000e (Vestlandet)
```
## Configuration
Call `turbasen.configure` to change settings. For example:
```python
import turbasen
turbasen.configure(
LIMIT=50,
CACHE=my_cache,
)
```
[The available settings](https://github.com/Turbasen/turbasen.py/blob/master/turbasen/settings.py) are:
* `ENDPOINT_URL`: The URL to the Nasjonal Turbase API endpoint
* `LIMIT`: Results per page when fetching multiple objects. Currently allows up to 50; [see the docs](http://www.nasjonalturbase.no/) for updates.
* `CACHE`: If specified, the library will itself perform what it deems to be reasonable caching of lookups and objects. Expects a cache engine implementing a small subset of [the Django cache API](https://docs.djangoproject.com/en/dev/topics/cache/#the-low-level-cache-api), specifically its `get` and `set` methods.
* `API_KEY`: Currently an API key is required for access, however there are plans to drop the key requirement. [See the website](http://www.nasjonalturbase.no/) for updates. The API key can also be specified as an exported environment variable called `TURBASEN_API_KEY`.
[See the source file for default values](https://github.com/Turbasen/turbasen.py/blob/master/turbasen/settings.py).
Project details
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
turbasen-1.0.1.tar.gz
(5.0 kB
view hashes)
Built Distributions
turbasen-1.0.1-py3.4.egg
(11.1 kB
view hashes)
Close
Hashes for turbasen-1.0.1.linux-x86_64.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6d1226bc372679641b3f71adfa51d4eeb4875582b00291f219674c9991315b8f |
|
MD5 | 87290c65bfea43df6e953912ac6eeaca |
|
BLAKE2b-256 | 88e1cd985bde025535b07cbec2d40db8aa62ced4cc922e2bd28178e130faf69f |