REST API for phenopacket-scraper

##Setup:

To get the project's source code, clone the github repository:

$ git clone https://github.com/monarch-initiative/phenopacket-scraper-api.git

Install VirtualEnv using the following:

$ [sudo] pip install virtualenv

Create and activate your virtual environment (with python 3):

$ virtualenv -p python3 venv
$ source venv/bin/activate

Clone the phenopacket-python respository:

$ git clone https://github.com/phenopackets/phenopacket-python.git

Install it in your virtual environment:

$ cd phenopacket-python
$ ../venv/bin/python setup.py install

Add this to the end of ~/.profile or ~/.bash_profile file to add phenopacket-python directory to your python environment variables:

$ export PYTHONPATH=$PYTHONPATH:[path of phenopacket-python directory]

For Example:

$ export PYTHONPATH=$PYTHONPATH:/Users/Gauss/Home/phenopacket-python

Install all the required packages:

$ venv/bin/pip3 install -r requirements.txt

Create your database and the superuser by running this from the phenopacketscraper/ directory of the repository:

$ python manage.py migrate
$ python manage.py createsuperuser

##Usage

To run the server enter the following in the 'phenopacketscraper/' directory of the repository

$ python manage.py runserver

Now you can go to your browser and test the api using:

http://localhost:8000/api/test/

To scrape data from a url you can enter the following in your browser:

http://localhost:8000/api/scrape/?url=[url]

To annotate data from a url you can enter the following in your browser:

http://localhost:8000/api/annotate/?url=[url]

To generate phenopacket of a given webpage you can enter the following in your browser:

http://localhost:8000/api/phenopacket/?url=[url]

Or by using curl in your terminal. For annotation you can enter the following

$ curl -H 'Accept: application/json; indent=4' http://localhost:8000/api/annotate/?url=[url]

For instance you can use http://molecularcasestudies.cshlp.org/content/2/2/a000703.abstract in place of [url] for testing.

To generate phenopackets you can enter the following in your terminal:

$ curl -H 'Accept: application/json; indent=4' http://localhost:8000/api/phenopacket/?url=[url]

To run the test cases, enter the following in the 'phenopacketscraper/' directory of the repository

$ python manage.py test