/pepys-import

Support library for Pepys maritime data analysis environment

Primary LanguagePythonApache License 2.0Apache-2.0

Code coverage

We're aiming for 100% code coverage on the project, track our progress here: codecov

Online documentation

Learn more here Documentation Status

Code Style

Black is used on the project: Code style: black

It is suggested to install a pre-commit hook in order to apply Black before pushing commits:

pip install pre-commit
pre-commit install

Jupyter demo

Link to working demo of datafile import: Binder

Work in progress

View the project Kanban board here

Setup

To prepare for running ensure these tools and packages are installed:

  • Python 3 - at least Python 3.6.4 or later
  • SQL Alchemy 1.3

For Postgres support and unit tests these packages are also required:

  • geoalchemy2
  • psycopg2
  • nose2 (0.9.1)

Dependencies

Install the python dependencies with: pip install -r requirements.txt

Was: To install packages use pip install <package> or py -3 -m pip install <package> depending on your installation

Unit tests

  • Run the unit test suite with: coverage3 run -m unittest discover -v
  • View the unit test coverage with: coverage report

Command Line Instructions

To run from the command line go to the top level directory of the library in your bash shell or terminal program

Run by specifying the program as a module with -m and leaving off the .py file extension

The exact executable name for invoking python will depend how you have it installed, but most commonly it's just python

For example run the Sqlite example using:
python -m Experiments.DataStore_sqliteExperiment

IntelliJ Instructions

To run from inside IntelliJ open the project
Mark the Store package as source by right clicking on the directory and selecting Mark Directory as -> Source Root

Open any python module you want to run in the main editor window, right click anywhere in the editor and choose the Run or Debug option