README

# dependencies

	# database:
	
	mongodb (download from mongodb.org the stable version)
		quickstart: http://www.mongodb.org/display/DOCS/Quickstart+OS+X

	# python stuff:
	
	python 2.6+ (if python 2.5, please install simplejson)
	django 1.2+
	pymongo 1.7+
	
	(can use "easy_install package_name" for easy installation )

	other dependencies are loaded at runtime and can be found in
	~apps and ~libs directories

	above dependencies can be downloaded and safely put in 
	~libs directory

# running django dev server

	# settings.py:
	
	if mongodb has username and password
	update "mongoengine.connect()" in settings.py
	
	# run django as standard:

	Please note that mongodb must be running before django
	type 'mongod' in terminal
	
	cd into riverid folder
	type 'python manage.py runserver'
	
	RiverID then is running at http://127.0.0.1:8000
	
# fishing for fun

	to add initial data:
	go to http://127.0.0.1:8000/feedfish (only if there is no user)
	
	then login with user/user or admin/admin or dev/dev (username/password)
		
	to clear data:
	go to http://127.0.0.1:8000/killoil (need admin access)
	
# testing oauth

	cd into riverid folder
	type 'python oauth_client.py'
	
	just following prompts in the terminal
	
	in oauth_client.py API key and secret are preconfigured based on
	the initial key added in by "feeding fish"
	
	if you want to test with other combinations, please change accordingly
	
# dev notes

	search for #m instances for modificaitons, to-dos and notes
	
# thanks tons to 
	Harry Marr (http://hmarr.com) of MongoEngine and for great base layout
	Jesper Noehr (http://noehr.org/) of Django Piston
	Django Team
	MongoDB Team
	
	Ushahidi, Swift & Google for this opportunity
	
	my eldest youngest sister and my parents