WARNING: THIS REPOSITORY IS DEPRECATED!
The "F1" project, a way to share links implemented as a Firefox extension, has been converted to (and thus superseded by) Firefox's "Share" feature. The web app portion of this project is now available in the following repositories:
- https://github.com/mozilla/server-share
- https://github.com/mozilla/server-share-core
- https://github.com/mozilla/client-share-web
The browser extension portion of this project has been rolled into Firefox itself.
ACTIVE DEVELOPMENT IS NO LONGER HAPPENING IN THIS REPOSITORY.
Thanks!
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 dependencies:
make build
If you are on OS X and you get errors or it does not work, see the OS X troubleshooting section below.
Start the virtualenv
source bin/activate
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
Troubleshooting OS X installs
If the make build command produced errors or results in not being able to start up the server, use the following steps. It is suggested you re-clone F1 before doing the following steps, so that it starts out with a clean environment.
-
Make sure XCode 3 is installed.
-
Build your own version of Python:
sudo svn co http://svn.plone.org/svn/collective/buildout/python/ sudo chown -R $USER ./python cd python vi buildout.cfg: then remove any references to python 2.4 and 2.5 python bootstrap.py ./bin/buildout cd /usr/local/bin sudo ln -s /opt/python/bin/virtualenv-2.6 virtualenv
-
Now edit your .profile to make sure that if you have MacPorts installed, its PATH and MANPATH variables are last in the list for those environment variables.
I also removed export PYTHONPATH=/Users/aaa/hg/raindrop/server/python:$PYTHONPATH and removed /Library/Frameworks/Python.framework/Versions/Current/bin from the $PATH variable.
- Build C libraries via Homebrew:
Homebrew installs into /usr/local by default, and it is best if you chown the files in there to you:
sudo chown -R $USER /usr/local
If installed things before in these directories, remove these directories: /usr/local/include and /usr/local/lib
ruby -e "$(curl -fsSLk https://gist.github.com/raw/323731/install_homebrew.rb)"
brew install memcached libmemcached
Then try the make build command above and continue from there.
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.