Begun GridFS documentation
This commit is contained in:
		
							
								
								
									
										26
									
								
								docs/guide/gridfs.rst
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										26
									
								
								docs/guide/gridfs.rst
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,26 @@ | ||||
| ====== | ||||
| GridFS | ||||
| ====== | ||||
| GridFS support comes in the form of the :class:`~mongoengine.FileField` field | ||||
| object. This field acts as a file-like object and provides a couple of | ||||
| different ways of inserting and retrieving data. Metadata such as content-type | ||||
| can also be stored alongside the stored files. In the following example, an | ||||
| document is created to store details about animals, including a photo: | ||||
|  | ||||
|     class Animal(Document): | ||||
|         genus = StringField() | ||||
|         family = StringField() | ||||
|         photo = FileField() | ||||
|  | ||||
|     marmot = Animal('Marmota', 'Sciuridae') | ||||
|  | ||||
|     marmot_photo = open('marmot.jpg')   # Retrieve a photo from disk | ||||
|     marmot.photo = marmot_photo         # Store the photo in the document | ||||
|  | ||||
|     marmot.save() | ||||
|  | ||||
| So adding file data to a document is as easy as adding data to any other  | ||||
|  | ||||
| .. versionadded:: 0.4 | ||||
|  | ||||
|  | ||||
		Reference in New Issue
	
	Block a user