update pymongo2django final release Nov 2013

Author: zer0-g

README.rst

@@ -0,0 +1,44 @@
+Installation
+============
+
+To install pymongo2django::
+
+   copy pymongo2django to the django project directory storing the manage.py file
+
+Software Requirement
+====================
+
+The follow software requirement to install pymongo2django app::
+	
+   * Python 2.7.x
+   * Pymongo Driver (latest version preferred)
+   * MongoDB Server (http://www.mongodb.org) only if database is installed
+     locally on your machine otherwise you can access database from the 
+     cloud through MongoDB servers online (http://www.mongolab.com/)
+
+Usage
+=====
+To use pymongo2django with your Django project, just add these lines to your settings.py file::
+
+Add to the 'INSTALLED_APPS' section the pymongo2django app and append it to the end of this section ::
+
+   INSTALLED_APPS = (
+      ...
+      'pymongo2django',
+   )
+
+Update the pymongo2django/settings.py file found inside the pymongo2django directory.
+Update the variables in this file to use database.
+
+For instance, to create a DB instance::
+
+   >>> from pymongo2django import get_DBInstance
+   >>> db = get_DBInstance()
+   
+To find an item in a collection::
+
+   >>> from pymongo2django import get_DBInstance
+   >>> db = get_DBInstance()
+   >>> col = db.tester
+   >>> for row in col.find():
+   >>> 		print row

__init__.py

@@ -0,0 +1,2 @@
+import settings
+from backend import get_DBInstance

backend.py

@@ -0,0 +1,27 @@
+import settings
+from pymongo import MongoClient
+from pymongo.database import DBRef
+
+
+def get_DBInstance():
+
+    connStr = userStr = db = None
+    
+    if settings.user and settings.password:
+        userStr = settings.user + ":" + settings.password + "@"
+        
+    if userStr:
+        connStr = 'mongodb://' + userStr + settings.host
+    else:
+        connStr = 'mongodb://' + settings.host
+
+    if settings.port:
+        connStr += ':' + str(settings.port)
+
+    if settings.name:
+        connStr += '/' + settings.name
+        conn = MongoClient(connStr)
+        db = conn[settings.name]
+
+    return db
+    

settings.py

@@ -0,0 +1,9 @@
+#Stores settings to mongodb server
+
+host=''          #localhost or machine name
+port=None        #port number or leave empty and default to port 27017
+name=''          #database name
+user=''          #user name to database
+password=''       #user password to database
+
+