Holi Geo Service

The backend for everything geo-related.

• Holi Geo Service
  • Getting started
    • Setup
    • Code style
    • Dependencies
    • Compiling (optional)
    • Testing
    • Tasks
    • VS Code extension
  • Geoapify API
  • Local execution
  • Continuous Integration and Deployment
    • Skipping parts of CI
      • noenv Branches
  • Runtime / Deployment
    • Configuration

Getting started

Setup

Install deno in version 1.36.1.

as well as Velociraptor.

Code style

Linting:

vr lint

Formatting:

vr fmt

Configuration for typescript, linter or formatter can be added in deno.json.

See the deno manual for more tools.

Dependencies

All dependencies should be added in app/deps.ts (similiar as you would do in a Node.js package.json) for caching and integrity checks. After adding a dependency run

vr updateDeps

to update the deno.lock file (similiar to Node.js package.lock including hashes).

To just install and cache dependencies locally or force a reload of dependencies, run:

vr install

Compiling (optional)

Deno will compile all TypeScript code to JavaScript and cache the resulting files. This will happen automatically when you run the code, but you can also trigger this manually by running:

vr cache

Testing

Tests can be executed with

vr test

(Test filenames should end on a _test prefix).

To get information about test coverage use

vr coverage

For more information, e.g. on how to create different coverage formats, see the documentation

Tasks

We use Velociraptor to execute scripts that are defined beneath velociraptor > scripts in deno.json (similiar to scripts defined in Node.js package.json).

You can run

vr

to get a list of all available tasks.

VS Code extension

There is an official VS Code extension for Deno: vscode-deno.

It should already be enabled for the workspace, for more information check the documentation.

JetBrains also offers a plugin for WebStorm and other JetBrains IDEs.

Geoapify API

The server uses Geoapify Geocoding API to create autocomplete predictions for country, region, or city names. In order to be able to use the Geoapify Geocoding API, requests are equipped with an API key that is used by the Geoapify API to match the project and for billing purposes. Within the deployment, two keys are in usage (managed by terraform):

1. geoapify-api-key-development
2. geoapify-api-key-production

Local execution

To watch for file changes during development, run

vr dev

To execute the application without watching for file changes run

vr start

or run

vr docker

to execute the application in a local docker container.

Afterwards you can access the graphql playground here:

http://localhost:8003/graphql

Continuous Integration and Deployment

Skipping parts of CI

Sometimes, changes don't need to be verified by the full pipeline, e.g. changes in linting or documentation.

noenv Branches

When you prefix your branch name with noenv/ (e.g. noenv/my-readme-update) the pipeline only lints & builds, but does not publish, deploy or run e2e test. This saves quite some time. Obviously, many things go untested so only use this if "you know what you're doing".

Runtime / Deployment

Configuration