This file will be packaged with your application, when using play dist.
=======
##Goals This backend is a proxy for feeding data from several sources for Xebia Mobile application. It's written with Play! framework 2.0 in Scala.
It collects informations from :
- Github
- Eventbrite
- Xebia french blog
Then it caches the responses and provides information for the Xebia Mobile application throught REST APIs.
It also aims at publishing notifications for registered users for Apple and Android devices.
##Install me This software needs :
gem install sass
Check and download the last version of 2.0 Play Framework version here
Think about installing the Play! Plugin for your favorite IDE.
The cache system uses Redis. You can download the source from the Redis website.
HINT: On MacOS, think about installing XCode and Command line tools in order to compile Redis with make command
Create a file in ~/.redis/redis.conf with the following content requirepass Password123
Then you can launch the Redis server with
src/redis-server ~/.redis/redis.conf
On MacOS, you can download the Postgres quick App from here.
Simply launch the application to get an up and running database. Create a database named
xebia-mobile-backend
##APIs key ids This application feeds data from several public providers thanks to their REST APIs. The more often, you need keys to sign your requests and you are limited in a small number of queries per day.
In order to get a fully working version of this backend, you need your own keys.
Go to the Eventbrite website for developper and suscribe to EventBrite to get your own key. Then, set an environment variable with it
export API_EVENTBRITE_APP_KEY = xxxx
In the same manner, go to Dev Twitter website and sign in with your twitter account. Declare your new app. Register a token for your account then, get the key XXX and set and environment variable for it :
export API_TWITTER_APP_KEY = XXX
export API_TWITTER_APP_SECRET = XXX
REST APIs will be powered by Swagger Swagger provides a set of annotations to be placed in the REST controllers. The framework has its own controller that generates JSON description your the application REST APIs. To get this controller, you need to clone Swagger from the Github repo. Then publish in local the modules swagger-play2-utils
git clone https://github.com/wordnik/swagger-core.git
cd modules/swagger-play2-utils
play publish-local
Start the server, then go to the URL /api. You can parse the content of your API and try it from live!
Run the application in dev mode:
play debug -Djava.util.logging.config.file=logging.properties run
Add this env variables to your profile:
export GMAIL_XEBIA_MOBILE_BACKEND_USER="<user>@xebia.fr"
export GMAIL_XEBIA_MOBILE_BACKEND_PASSWORD="<some_two_step_generated_revokable_password>"