Code Monkey home page Code Monkey logo

opensensemap-api's Introduction

openSenseMap API

This repository contains the code of the openSenseMap API, which is the HTTP REST API used by https://opensensemap.org running at https://api.opensensemap.org. To get more information about openSenseMap and senseBox visit the before mentioned links or have a look at this video, read the API docs or the openSenseMap chapter in our books. openSenseMap is part of the senseBox project.

Originally, this API has been built as part of the bachelor thesis of @mpfeil at the ifgi (Institute for Geoinformatics, WWU Münster) and is currently maintained by @ubergesundheit.

You'll find that the repostiory uses yarn workspaces to separate the API and the database models for reuse in other projects. While the API is not published on npm, the package @sensebox/opensensemap-api-models is published from packages/models folder.

Configuration

Configuration of both the api and the models is done using mechanisms provided by lorenwest/node-config. You can find an annotated example configuration with all keys in config/config.example.json.

Development

  • Have Node.js v8, yarn, Docker and docker-compose installed
  • Start your development database (docker-compose up -d db)
  • Check out development branch (git checkout development)
  • Run yarn install
  • Create your own branch git checkout -b my-awesome-branch
  • Commit your changes to your branch and push it to your fork
  • Create a pull request against the development branch

See also: CONTRIBUTING

Running Tests

You can run the tests in containers using Docker and docker-compose.

# Run this the first time or every time you change dependencies in package.json
yarn install
yarn test build

yarn test

Services

Libraries

Deployment

Technologies

Organization

Branches

  • master (runs in production)
    • Is used for container build tags
  • development (runs on testing server)
    • Bleeding edge and possibly unstable development version
  • gh-pages

Tags and Versions

Git Tags are used for Docker hub builds (like v1). Version number is increased by one for each new version. Docker images are built automatically by the Docker hub for all tags starting with v

Development container images

Every commit on branch development will be built with the tag development.

Versioned container images

  • Check out master branch
  • Go to root directory
  • Run tests
  • Optional: Build docker image locally
  • Commit everything needed for the container image
  • Run yarn tag-container
  • Run git push origin master

License

MIT - Matthias Pfeil 2015 - now

opensensemap-api's People

Contributors

adorfer avatar chk1 avatar felixerdy avatar gitter-badger avatar janwirwahn avatar mpfeil avatar noerw avatar paulreichmuth avatar robarto avatar snyk-bot avatar ubergesundheit avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.