Skip to content

Latest commit

 

History

History
42 lines (28 loc) · 1.54 KB

README.md

File metadata and controls

42 lines (28 loc) · 1.54 KB

#Python Beacon

##Contents

##What it is This project contains BDK (beacon development kit) for Python developers. It provides a skeleton of a simple beacon allowing the developers to plug in their own data/functionality. The API makes sure the response produced is compatible with what the Beacon of Beacons can consume.

##System requirements All you need to build this project is Python and Flask web framework. If you're running Linux, OS X or Windows with cygwin support, the following commands should be enough to set up Flask (the process is a bit different with the native version of Python on Windows):

$ cd todo-api
$ virtualenv flask
$ flask/bin/pip install flask

##How to run it Launch beacon.py:

$ chmod a+x beacon.py
$ ./beacon.py

This starts an embedded server. By default, the application will be available at http://127.0.0.1:5000

##How it works In order to implement a beacon, simply override beacon details and query function in beacon.py (marked with TODO in the source code).

The API takes care of the rest and provides the following endpoints when you start your beacon:

http://127.0.0.1:5000/beacon-python/info - information about your beacon
http://127.0.0.1:5000/beacon-python/query - access to query service

Query example:

GET http://127.0.0.1:5000/beacon-python/query?chrom=15&pos=41087870&allele=A&ref=hg19

##Technologies Python, Flask.