A client for the NAIS API from FThe Norwegian Coastal Administration
Project description
Orion-NAIS
Table of Contents
About The Project
Orion-NAIS is a client to work with the NAIS API. It helps with authentication and provides a simple interface to work with the API.
When working with the API you need to have a valid token. The token is valid for a set period of time. The client will automatically refresh the token when it expires.
Why the name Orion?
The NAIS Api is provided through BarentsWatch. BarentsWatch is a Norwegian information portal that provides overview of activity and knowledge in coastal and sea areas. The Norwegian movie "Orion's Belt" from 1985 is an action movie set in the Barents region. About three men, a bulldozer, a Russian helicopter and a ship. Thus the name Orion.
Installation
Requires Python 3.10 or later.
pip install orion-nais
or using pipenv:
pipenv install orion-nais
or using poetry:
poetry add orion-nais
Usage
There are a heap of functions for you to use. Enjoy.
Local development
Requirements
- pyenv - manage python versions
- poetry - manage python dependencies
To install on mac you can use homebrew:
brew upgrade
brew install pyenv
You can either install poetry with homebrew or the way described in the documentation
Makefile commands
make lint
- lint the code in the src folder with black, isort and flake8. Mypy will check for correct typing.
make format
- format the code in the src folder with black and isort.
Structure
.
├── .bumpversion.cfg
├── .editorconfig
├── .flake8
├── .gitignore
├── Makefile
├── README.md
├── orion
│ ├── client.py
│ ├── mmsi.py
│ ├── types
│ │ └── ais.py
│ ├── urls.py
│ ├── utils
│ │ └── get_data.py
│ └── vessel_codes.py
├── poetry.lock
├── pyproject.toml
└── tests
├── make_mock_data.py
├── mocks
└── test_orion.py
.bumpversion.cfg
- Configuration file for bumpversion.
.editorconfig
- Configuration file for editorconfig.
.flake8
- Configuration file for flake8.
.gitignore
- Configuration file for git.
pyproject.toml
- Configuration file for poetry. Mypy and isort is configured here.
poetry.lock
- Lock file for poetry.
Makefile
- Makefile for the project. Here you can find commands for linting and formatting.
README.md
- This file.
orion
- The source code for the package.
client.py
- The client class.
mmsi.py
- A dataclass for handling MMSI numbers and MID-codes (jurisdiction).
types
- A folder for types.
ais.py
- A class for handling AIS messages.
urls.py
- A file with urls for the API.
utils
- A folder for utility functions.
get_data.py
- A function for getting data from other sources. Not used by the Orion client. Contains code for getting data from the Norwegian Petroleum Directorate.
vessel_codes.py
- A dataclass for looking up vessel codes.
tests
- Tests for the package.
Usage
To install the package in your project run
poetry add orion-nais
Contributing
Do you have write permissions to the repo? Then you can clone this project to a folder on your computer.
git clone https://github.com/BergensTidende/orion-nais.git
If not do the following:
- Create a personal fork of the project on Github.
- Clone the fork on your local machine. Your remote repo on Github is called
origin
. - Add the original repository as a remote called
upstream
. - If you created your fork a while ago be sure to pull upstream changes into your local repository.
This will clone the repo into pakkenellik
.
Create a branch for your changes
git checkout -b name-of-branch
Make your changes, rememeber to commit. And always write your commit messages in the present tense. Your commit message should describe what the commit, when applied, does to the code – not what you did to the code.
If you're working on a clone push the branch to github and make PR.
If your're working a fork:
- Squash your commits into a single commit with git's interactive rebase. Create a new branch if necessary.
- Push your branch to your fork on Github, the remote
origin
. - From your fork open a pull request in the correct branch. Target the project's
develop
branch if there is one, else go formaster
! - …
- If the maintainer requests further changes just push them to your branch. The PR will be updated automatically.
- Once the pull request is approved and merged you can pull the changes from
upstream
to your local repo and delete your extra branch(es).
Contact
Bord4 - bord4@bt.no
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
Built Distribution
Hashes for orion_nais-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 98455aa3b7823b0bab8cc00182256047d035dff6cdd3f85c1891e5811b64d544 |
|
MD5 | baa6021f6641ab03ec61ed6bf214dc65 |
|
BLAKE2b-256 | 66d01b416c3915d5f8a53a1d17766d4b337aeec3efc6be834c17d0d4e0fd5238 |