1.9 KiB
f1
A link sharing service that consists of a Firefox extension and a web service.
The firefox extension creates an area to show the share UI served from the web service.
The web service handles the OAuth work and sending of messages to different share servers.
Some directory explanations:
- extensions: holds the Firefox extension source.
- web: holds the UI for the web service.
- grinder: a load testing tool.
- tools: deployment tools.
- The rest of the files support the web service.
Installation and Setup
Get the f1 repository:
git clone https://github.com/mozilla/f1.git
cd f1
Setup a virtual environment (optional, recommended):
sudo easy_install virtualenv
virtualenv env
source env/bin/activate
Dependency installation
python setup.py develop
Make a config file as follows::
# **skip this step for now**
# paster make-config f1 config.ini
Tweak the config file as appropriate and then setup the application::
# **skip this step for now**
# paster setup-app config.ini
Running f1
Run the web server. 'reload' is useful for development, the webserver restarts on file changes, otherwise you can leave it off
paster serve --reload development.ini
Then visit: http://127.0.0.1:5000/ for an index of api examples
Setting up a valid Google domain for OpenID+OAuth
You have to have access to a valid domain that google can get to and where you can install an html file.
Visit: https://www.google.com/accounts/ManageDomains
Add your domain, follow the rest of their instructions.
To test: Once that is done, you can bypass normal access to your domain by adding to your /etc/hosts file:
127.0.0.1 your.host.com
Update development.ini and add your key/secret for the google configuration, restart paster.
Then in the web browser, hit f1 with http://your.host.com.