Installation

• Install poethepoet
• Install from Github
• Start osprey PyWPS service
• Run osprey as Docker container
• Use Ansible to deploy osprey on your System

Poethepoet tasks

Poethepoet is a task runner that integrates smoothly with Poetry, serving as a modern alternative to cd s.

Install poethepoet

$ python3 -m pip install --user pipx
$ python3 -m pipx ensurepath # Ensure directory where pipx stores apps is in your PATH environment variable
$ pipx install poethepoet # Install globally

Usage

Once installed, you can list all available tasks using:

poe --help

This will output a list of predefined tasks from your pyproject.toml. Example:

 # View all tasks
 poe --help
  lock                  Build the lock file for the project
  install               Install Python project dependencies using Poetry
  develop               Install development dependencies using Poetry
  start                 Start the Osprey service in detached mode
  stop                  Stop the Osprey service
  restart               Restart the Osprey service
  status                Show the status of the Osprey service
  dist                  Build a distribution package for the project
  test                  Run fast, offline unit tests
  test-all              Run all tests, including online ones
  lint                  Check code formatting using Black
  prepare-notebooks     Download the output sanitizer config for notebook tests
  test-notebooks        Run all local notebook tests with sanitized output
  test-notebooks-local  Run notebook tests locally using nbval with sanitization
  docs                  Convert notebooks to HTML for documentation

You can run any task with:

poe <task-name>
# Example:
poe test

Install from GitHub

Check out code from the osprey GitHub repo and start the installation:

$ git clone https://github.com/pacificclimate/osprey.git
$ cd osprey

Install requirements:

poe install-apt
poe install-r-pkgs
poe install

For development you can use this command:

poe develop

Start osprey PyWPS service

After successful installation you can start the service using the osprey command-line.

poetry run osprey --help # show help
poe start  # start service with default configuration

# OR

poetry run osprey start --daemon # start service as daemon
loading configuration
forked process id: 42

The deployed WPS service is by default available on:

http://localhost:5000/wps?service=WPS&version=1.0.0&request=GetCapabilities.

NOTE:: Remember the process ID (PID) so you can stop the service with kill PID.

You can find which process uses a given port using the following command (here for port 5000):

$ netstat -nlp | grep :5000

Check the log files for errors:

$ tail -f  pywps.log

You can also use Poe to start and stop the service:

$ poe start
$ poe status
$ tail -f pywps.log
$ poe stop

Run osprey as Docker container

You can also run osprey as a Docker container.

$ docker-compose build
$ docker-compose up

osprey will be available on port 8100.

Use Ansible to deploy osprey on your System

Use the Ansible playbook for PyWPS to deploy osprey on your system.