From 15ee9530ed803184c6a2fe5c859fd17581146f2a Mon Sep 17 00:00:00 2001
From: Kyle Banker <kylebanker@gmail.com>
Date: Tue, 23 Feb 2010 16:19:45 -0500
Subject: [PATCH] deprecate GridFS::GridStore and GridFS::Chunk

---
 lib/mongo/gridfs/chunk.rb      |  1 +
 lib/mongo/gridfs/grid_store.rb | 15 +++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/lib/mongo/gridfs/chunk.rb b/lib/mongo/gridfs/chunk.rb
index 585ce3e..208764d 100644
--- a/lib/mongo/gridfs/chunk.rb
+++ b/lib/mongo/gridfs/chunk.rb
@@ -21,6 +21,7 @@ require 'mongo/util/ordered_hash'
 module GridFS
 
   # A chunk stores a portion of GridStore data.
+  # @deprecated
   class Chunk
 
     DEFAULT_CHUNK_SIZE = 1024 * 256
diff --git a/lib/mongo/gridfs/grid_store.rb b/lib/mongo/gridfs/grid_store.rb
index 662bf2a..dbe3af7 100644
--- a/lib/mongo/gridfs/grid_store.rb
+++ b/lib/mongo/gridfs/grid_store.rb
@@ -48,6 +48,7 @@ module GridFS
   #  end
   #
   # @core gridfs
+  # @deprecated
   class GridStore
     include Enumerable
 
@@ -55,6 +56,8 @@ module GridFS
 
     DEFAULT_CONTENT_TYPE = 'text/plain'
 
+    DEPRECATION_WARNING = "GridFS::GridStore is deprecated. Use either Grid or GridFileSystem."
+
     attr_accessor :filename
 
     # Array of strings; may be +nil+
@@ -94,7 +97,9 @@ module GridFS
     # @param [String] root_collection the name of the gridfs root collection.
     #
     # @return [Boolean]
+    # @deprecated
     def self.exist?(db, name, root_collection=GridStore.default_root_collection)
+      warn DEPRECATION_WARNING
       db.collection("#{root_collection}.files").find({'filename' => name}).next_document != nil
     end
 
@@ -110,6 +115,7 @@ module GridFS
     #
     # @see GridStore#initialize.
     # @see The various GridStore class methods, e.g., GridStore.open, GridStore.read etc.
+    # @deprecated
     def self.open(db, name, mode, options={})
       gs = self.new(db, name, mode, options)
       result = nil
@@ -130,6 +136,7 @@ module GridFS
     #   beginning of the file to start reading.
     #
     # @return [String] the file data
+    # @deprecated
     def self.read(db, name, length=nil, offset=nil)
       GridStore.open(db, name, 'r') do |gs|
         gs.seek(offset) if offset
@@ -144,7 +151,9 @@ module GridFS
     # @param [String] root_collection the name of the root collection.
     #
     # @return [Array]
+    # @deprecated
     def self.list(db, root_collection=GridStore.default_root_collection)
+      warn DEPRECATION_WARNING
       db.collection("#{root_collection}.files").find().map do |f|
         f['filename']
       end
@@ -158,6 +167,7 @@ module GridFS
     # @param [String, Reg] separator
     #
     # @return [Array]
+    # @deprecated
     def self.readlines(db, name, separator=$/)
       GridStore.open(db, name, 'r') do |gs|
         gs.readlines(separator)
@@ -170,6 +180,7 @@ module GridFS
     # @param [Array<String>] names the filenames to remove
     #
     # @return [True]
+    # @deprecated
     def self.unlink(db, *names)
       names.each do |name|
         gs = GridStore.new(db, name)
@@ -189,7 +200,9 @@ module GridFS
     # @param [String] src the name of the source file.
     # @param [String] dest the name of the destination file.
     # @param [String] root_collection the name of the default root collection.
+    # @deprecated
     def self.mv(db, src, dest, root_collection=GridStore.default_root_collection)
+      warn DEPRECATION_WARNING
       db.collection("#{root_collection}.files").update({ :filename => src }, { '$set' => { :filename => dest } })
     end
 
@@ -210,7 +223,9 @@ module GridFS
     #
     # @option options [String] :content_type ('text/plain') Set the content type stored as the
     #   file's metadata. See also GridStore#content_type=.
+    # @deprecated
     def initialize(db, name, mode='r', options={})
+      warn DEPRECATION_WARNING
       @db, @filename, @mode = db, name, mode
       @root = options[:root] || GridStore.default_root_collection