ruby-box-updated 1.16.0

data/spec/fixtures/users.json

@@ -0,0 +1,39 @@
+{
+    "total_count": 2,
+    "entries": [
+        {
+            "type": "user",
+            "id": "181216415",
+            "name": "sean rose",
+            "login": "sean+awesome@box.com",
+            "created_at": "2012-05-03T21:39:11-07:00",
+            "modified_at": "2012-08-23T14:57:48-07:00",
+            "language": "en",
+            "space_amount": 5368709120,
+            "space_used": 52947,
+            "max_upload_size": 104857600,
+            "status": "active",
+            "job_title": "",
+            "phone": "5555551374",
+            "address": "10 Cloud Way Los Altos CA",
+            "avatar_url": "https://api.box.com/api/avatar/large/181216415"
+        },
+                {
+            "type": "user",
+            "id": "181216416",
+            "name": "sean rose",
+            "login": "sean+awesomer@box.com",
+            "created_at": "2012-05-03T21:39:11-07:00",
+            "modified_at": "2012-08-23T14:57:48-07:00",
+            "language": "en",
+            "space_amount": 5368709120,
+            "space_used": 52947,
+            "max_upload_size": 104857600,
+            "status": "active",
+            "job_title": "",
+            "phone": "5555551374",
+            "address": "10 Cloud Way Los Altos CA",
+            "avatar_url": "https://api.box.com/api/avatar/large/181216416"
+        }
+    ]
+}

data/spec/folder_spec.rb

@@ -0,0 +1,181 @@
+#encoding: UTF-8
+
+require 'spec_helper'
+require 'helper/account'
+require 'ruby-box'
+require 'webmock/rspec'
+
+describe RubyBox::Folder do
+  before do
+    @session = RubyBox::Session.new
+    @full_folder = JSON.parse('{    "type": "folder",    "id": "11446498",    "sequence_id": "1",    "etag": "1",    "name": "Pictures",    "created_at": "2012-12-12T10:53:43-08:00",    "modified_at": "2012-12-12T11:15:04-08:00",    "description": "Some pictures I took",    "size": 629644,    "path_collection": {        "total_count": 1,        "entries": [            {                "type": "folder",                "id": "0",                "sequence_id": null,                "etag": null,                "name": "All Files"            }        ]    },    "created_by": {        "type": "user",        "id": "17738362",        "name": "sean rose",        "login": "sean@box.com"    },    "modified_by": {        "type": "user",        "id": "17738362",        "name": "sean rose",        "login": "sean@box.com"    },    "owned_by": {        "type": "user",        "id": "17738362",        "name": "sean rose",        "login": "sean@box.com"    },    "shared_link": {        "url": "https://www.box.com/s/vspke7y05sb214wjokpk",        "download_url": "https://www.box.com/shared/static/vspke7y05sb214wjokpk",        "vanity_url": null,        "is_password_enabled": false,        "unshared_at": null,        "download_count": 0,        "preview_count": 0,        "access": "open",        "permissions": {            "can_download": true,            "can_preview": true        }    },    "folder_upload_email": {        "access": "open",        "email": "upload.Picture.k13sdz1@u.box.com"    },    "parent": {        "type": "folder",        "id": "0",        "sequence_id": null,        "etag": null,        "name": "All Files"    },    "item_status": "active",    "item_collection": {        "total_count": 1,        "entries": [            {                "type": "file",                "id": "5000948880",                "sequence_id": "3",                "etag": "3",                "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",                "name": "tigers.jpeg"            }        ],        "offset": 0,        "limit": 100    }}')
+    @mini_folder = JSON.parse('{    "type":"folder",    "id":"301415432",    "sequence_id":"0",    "name":"my first sub-folder"}')
+    @items = [
+      JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047867",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s your folder"        },        {            "type": "file",            "id": "409042867",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        },    { "type": "collaboration", "id": "409042000", "status": "accepted" } ],    "offset": "0",    "limit": "3"}'),
+      JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047868",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s another folder"        },        {            "type": "file",            "id": "409042810",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        },    { "type": "collaboration", "id": "409042001", "status": "accepted" }   ],    "offset": "2",    "limit": "3"}')
+    ]
+  end
+
+  it "#root returns full root folder object" do
+    RubyBox::Session.any_instance.stub(:request).and_return(@full_folder)
+    session = RubyBox::Session.new
+    root = RubyBox::Client.new(session).root_folder
+    root.name.should == 'Pictures'
+  end
+
+  it "returns iso8601 format keys as a time object" do
+    RubyBox::Session.any_instance.stub(:request).and_return(@full_folder)
+    session = RubyBox::Session.new
+    root = RubyBox::Client.new(session).root_folder
+    root.created_at.year.should == 2012
+  end
+
+  describe "#find_by_type" do
+    it "compares name in a case insensitive manner" do
+      items = [
+        JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047867",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s your folder"        },        {            "type": "file",            "id": "409042867",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }    ],    "offset": "0",    "limit": "2"}'),
+        JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047868",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s another folder"        },        {            "type": "file",            "id": "409042810",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }    ],    "offset": "2",    "limit": "2"}')  
+      ]
+
+      RubyBox::Session.any_instance.stub(:request) { items.pop }
+      session = RubyBox::Session.new
+
+      # should return one file.
+      files = RubyBox::Folder.new(session, {'id' => 1}).files('A CHOICE file')
+      files.count.should == 1
+    end
+  end
+
+  describe '#items' do
+    it "should return a folder object for folder items" do
+      item = JSON.parse('{    "id": "0000001", "total_count": 1,    "entries": [        {            "type": "folder",            "id": "409047867",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s your folder"        }   ],    "offset": "0",    "limit": "1"}')
+      RubyBox::Session.any_instance.stub(:request).and_return(item)
+      session = RubyBox::Session.new
+      item = RubyBox::Client.new(session).root_folder.items.first
+      item.kind_of?(RubyBox::Folder).should == true
+    end
+
+    it "should return a file object for file items" do
+      item = JSON.parse('{    "id": "0000001", "total_count": 1,    "entries": [ {            "type": "file",            "id": "409042867",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }   ],    "offset": "0",    "limit": "1"}')
+      RubyBox::Session.any_instance.stub(:request).and_return(item)
+      session = RubyBox::Session.new
+      item = RubyBox::Client.new(session).root_folder.items.first
+      item.kind_of?(RubyBox::File).should == true
+    end
+
+    it "it should return an iterator that lazy loads all entries" do
+      RubyBox::Session.any_instance.stub(:request) { @items.pop }
+      session = RubyBox::Session.new
+      items = RubyBox::Folder.new(session, {'id' => 1}).items(1).to_a
+      items[0].kind_of?(RubyBox::Folder).should == true
+      items[1].kind_of?(RubyBox::File).should == true
+    end
+
+    it "should allow a fields parameter to be set" do
+      RubyBox::Session.any_instance.should_receive(:get).with('https://api.box.com/2.0/folders/1/items?limit=100&offset=0&fields=size').and_return({'entries' => []})
+      session = RubyBox::Session.new
+      RubyBox::Folder.new(session, {'id' => 1}).items(100, 0, [:size]).to_a
+    end
+
+    it "should not have the fields parameter set by default" do
+      RubyBox::Session.any_instance.should_receive(:get).with('https://api.box.com/2.0/folders/1/items?limit=100&offset=0').and_return({'entries' => []})
+      session = RubyBox::Session.new
+      RubyBox::Folder.new(session, {'id' => 1}).items.to_a
+    end
+  end
+
+  describe '#files' do
+    it "should only return items of type file" do
+      RubyBox::Session.any_instance.stub(:request) { @items.pop }
+      session = RubyBox::Session.new
+      files = RubyBox::Folder.new(session, {'id' => 1}).files
+      files.count.should == 1
+      files.first.kind_of?(RubyBox::File).should == true
+    end
+
+    it "should allow you to filter files by name" do
+      items = [
+        JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047867",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s your folder"        },        {            "type": "file",            "id": "409042867",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }    ],    "offset": "0",    "limit": "2"}'),
+        JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047868",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s another folder"        },        {            "type": "file",            "id": "409042810",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }    ],    "offset": "2",    "limit": "2"}')  
+      ]
+
+      RubyBox::Session.any_instance.stub(:request) { items.pop }
+      session = RubyBox::Session.new
+
+      # should return one file.
+      files = RubyBox::Folder.new(session, {'id' => 1}).files('A choice file')
+      files.count.should == 1
+
+      items = [
+        JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047867",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s your folder"        },        {            "type": "file",            "id": "409042867",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }    ],    "offset": "0",    "limit": "2"}'),
+        JSON.parse('{    "total_count": 4,    "entries": [        {            "type": "folder",            "id": "409047868",            "sequence_id": "1",            "etag": "1",            "name": "Here\'s another folder"        },        {            "type": "file",            "id": "409042810",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }    ],    "offset": "2",    "limit": "2"}')  
+      ]
+
+      # should return no files.
+      files = RubyBox::Folder.new(session, {'id' => 1}).files('foobar')
+      files.count.should == 0
+    end
+  end
+
+  describe '#discussions' do
+    it "should return all the discussions surrounding a folder" do
+      item = JSON.parse('{    "id": "0000001", "total_count": 1,    "entries": [ {            "type": "discussion",            "id": "409042867",            "sequence_id": "1",            "etag": "1",            "name": "A choice file"        }   ],    "offset": "0",    "limit": "1"}')
+      RubyBox::Session.any_instance.stub(:request).and_return(item)
+      session = RubyBox::Session.new
+      item = RubyBox::Client.new(session).root_folder.discussions.first
+      item.kind_of?(RubyBox::Discussion).should == true
+    end
+  end
+
+  describe '#folders' do
+    it "should only return items of type folder" do
+      RubyBox::Session.any_instance.stub(:request) { @items.pop }
+      session = RubyBox::Session.new
+      files = RubyBox::Folder.new(session, {'id' => 1}).folders
+      files.count.should == 1
+      files.first.kind_of?(RubyBox::Folder).should == true
+    end
+  end
+
+  context '#copy_to' do
+    let(:source_folder) { RubyBox::Folder.new(@session, {'id' => 1}) }
+    let(:destination) { RubyBox::Folder.new(@session, {'id' => 100}) }
+    let(:last_request) { JSON.parse(@request.body) }
+    let(:last_uri) { @uri.to_s }
+
+    before(:each) do
+      @session.stub(:request).with do |uri, request, _, _|
+        @uri, @request = uri, request
+      end
+    end
+
+    it 'uses itself for the copy uri' do
+      source_folder.copy_to destination
+      last_uri.should match /folders\/#{source_folder.id}\/copy/
+    end
+
+    it 'uses the destination as the parent' do
+      source_folder.copy_to destination
+      last_request['parent']['id'].should eq(destination.id)
+    end
+
+    it 'uses the source as the name by default' do
+      source_folder.copy_to destination
+      last_request.should_not have_key 'name'
+    end
+
+    it 'can provide a new name if desired' do
+      source_folder.copy_to destination, 'renamed-folder'
+      last_request['name'].should eq('renamed-folder')
+    end
+
+    it 'returns the newly created folder' do
+      @session.should_receive(:request).and_return('type' => 'folder', 'id' => '123')
+      copied_folder = source_folder.copy_to(destination)
+
+      copied_folder.should be_a(RubyBox::Folder)
+      copied_folder.id.should eq("123")
+    end
+  end
+
+end

data/spec/helper/account.example

@@ -0,0 +1,3 @@
+---
+api_key: "YOUR_API_TOKEN"
+auth_token: "YOUR_AUTH_TOKEN"

data/spec/helper/account.rb

@@ -0,0 +1,8 @@
+require 'yaml'
+
+ACCOUNT = {}
+begin
+  ACCOUNT = YAML.load_file(File.dirname(__FILE__) + '/account.yml')
+rescue
+  p "create an account.yml file with your credentials to run integration tests."
+end

data/spec/integration_spec.rb

@@ -0,0 +1,387 @@
+#encoding: UTF-8
+
+require 'spec_helper'
+require 'helper/account'
+require 'ruby-box'
+require 'webmock/rspec'
+
+describe RubyBox, :skip => true do
+  before do
+
+    WebMock.allow_net_connect!
+    
+    @session = RubyBox::Session.new({
+      api_key: ACCOUNT['api_key'],
+      auth_token: ACCOUNT['auth_token']
+    })
+
+    @client = RubyBox::Client.new(@session)
+
+    # Create a file with a UTF-8 name for testing.
+    # This is not checked in, as UTF-8 causes issues with
+    # Windows (lame).
+    f = File.new('./spec/fixtures/遠志教授.jpg', 'w')
+    f.puts('Hello World!')
+    f.close()
+  end
+
+  after do
+    File.delete('./spec/fixtures/遠志教授.jpg')
+  end
+
+  it "raises an AuthError if not client auth fails" do
+    session = RubyBox::Session.new({
+      api_key: 'bad-key',
+      auth_token: 'bad-token'
+    })
+
+    @bad_client = RubyBox::Client.new(session)
+
+    lambda {@bad_client.root_folder}.should raise_error( RubyBox::AuthError )
+  end
+  
+  it "raises a RequestError if a badly formed request detected by the server" do
+    stub_request(:get, "https://api.box.com/2.0/folders/0").to_return(:status => 401, :body => '{"type": "error", "status": 401, "message": "baddd req"}', :headers => {})
+    lambda {@client.root_folder}.should raise_error( RubyBox::AuthError )
+
+    # make sure status and body is
+    # set on error object.
+    begin
+      @client.root_folder
+    rescue Exception => e
+      e.body.should == '{"type": "error", "status": 401, "message": "baddd req"}'
+      e.status.should == 401
+    end
+  end
+
+  it "raises a ServerError if the server raises a 500 error" do
+    stub_request(:get, "https://api.box.com/2.0/folders/0").to_return(:status => 503, :body => '{"type": "error", "status": 503, "message": "We messed up! - Box.com"}', :headers => {})
+    lambda {@client.root_folder}.should raise_error( RubyBox::ServerError )
+    
+    # make sure status and body is
+    # set on error object.
+    begin
+      @client.root_folder
+    rescue Exception => e
+      e.body.should == '{"type": "error", "status": 503, "message": "We messed up! - Box.com"}'
+      e.status.should == 503
+    end
+
+  end
+
+  describe RubyBox::Folder do
+    describe '#root_folder' do
+      it "#items returns a lits of items in the root folder" do
+        items = @client.root_folder.items.to_a
+        items.count.should == 6
+        items.any? do |item|
+          item.type == "folder" && 
+          item.id   == "318810303" &&
+          item.name == "ruby-box_gem_testing"
+        end.should == true
+      end
+      
+      it "returns list of items in the folder id passed in" do
+        folder = RubyBox::Folder.new(@session, {'id' => '318810303'})
+        items = folder.items.to_a
+        items.count.should == 2
+        items.any? do |item|
+          item.type == "file" && 
+          item.id   == "2550686921" &&
+          item.name == "2513582219_03fb9b67db_b.jpg"
+        end.should == true
+      end
+    end
+    
+    describe '#file' do
+      it "finds the id of a file" do
+        folder = RubyBox::Folder.new(@session, {'id' => '318810303'})
+        file = folder.files( '2513582219_03fb9b67db_b.jpg' ).first
+        file.id.should == "2550686921"
+      end      
+    end
+
+    describe '#files' do
+      it "allows additional fields to be requested in file listing" do
+        folder = RubyBox::Folder.new(@session, {'id' => '318810303'})
+        file = folder.files({fields: [:name, :size]}).first
+        file.id.should == "2550686921"
+        file.name.should == "2513582219_03fb9b67db_b.jpg"
+        file.size.should == 593978
+      end
+    end
+    
+    describe '#create' do
+      it "creates a folder" do
+        folder = @client.folder('/ruby-box_gem_testing')
+        subfolder = folder.create_subfolder( 'new_folder_created' )
+        subfolder.id.should_not == nil
+
+        subfolder.delete
+      end
+
+      it "creates a folder with special chars in the name" do
+        folder = @client.folder('/ruby-box_gem_testing')
+        subfolder = folder.create_subfolder( '!@#$%^&$$()' )
+        subfolder.id.should_not == nil
+
+        subfolder.delete
+      end
+    end
+
+  end
+
+  describe RubyBox::Client do
+
+    describe RubyBox::Client do
+      describe '#item' do
+        it "item method can lookup generic items, e.g., files or folders" do
+          file = @client.item( '/ruby-box_gem_testing/cool stuff/кузнецкий_105_а_№2.test' )
+          file.size.should == 14
+          file.name.should == 'кузнецкий_105_а_№2.test'
+
+          folder = @client.item( 'ruby-box_gem_testing' )
+          folder.name.should == 'ruby-box_gem_testing'
+        end
+      end
+    end
+
+    context 'uploading files' do
+      it "should update an existing file" do
+        utf8_file_name = '遠志教授.jpg'
+        fdata = File.open( 'spec/fixtures/' + utf8_file_name, 'rb' )
+        response = @client.upload_data('/ruby-box_gem_testing/cool stuff/遠志教授.jpg', fdata)
+        fdata = File.open( 'spec/fixtures/' + utf8_file_name, 'rb' )
+        
+        file = @client.upload_data('/ruby-box_gem_testing/cool stuff/遠志教授.jpg', fdata)
+        file.name.should == '遠志教授.jpg'
+        file.delete
+      end
+
+      it 'should raise an exception if files collide and overwrite is false' do
+        fdata = File.open( 'spec/fixtures/遠志教授.jpg', 'rb' )
+        file = @client.upload_data('/ruby-box_gem_testing/cool stuff/遠志教授.jpg', fdata)
+        fdata = File.open( 'spec/fixtures/遠志教授.jpg', 'rb' )
+        
+        expect{ @client.upload_data('/ruby-box_gem_testing/cool stuff/遠志教授.jpg', fdata, false) }.to raise_error(RubyBox::ItemNameInUse)
+        file.delete
+      end
+      
+      it "should upload a new file" do
+        utf8_file_name = '遠志教授.jpg'
+        file = @client.upload_file('spec/fixtures/' + utf8_file_name, '/ruby-box_gem_testing/cool stuff/')
+        file.name.should == '遠志教授.jpg'
+        file.delete        
+      end
+
+      it "should allow a file to be uploaded by a folder id" do
+        utf8_file_name = '遠志教授.jpg'
+        folder = @client.folder('/ruby-box_gem_testing/cool stuff/')
+        file = @client.upload_file_by_folder_id('spec/fixtures/' + utf8_file_name, folder.id)
+        file.name.should == '遠志教授.jpg'
+        file.delete        
+      end
+    end
+  
+    describe '#create_folder' do
+      it "creates a path that doesnt exist" do
+        folder = @client.create_folder('/ruby-box_gem_testing/cool stuff/екузц/path1/path2')
+        folder.id.should_not == nil
+        folder.delete if folder
+      end
+    end
+
+    describe '#folder_by_id' do
+      it "allows a folder to be retrieved by its id" do
+        folder = @client.folder('/ruby-box_gem_testing')
+        folder_by_id = @client.folder_by_id(folder.id)
+        folder_by_id.name.should == folder.name
+      end
+    end
+
+    describe '#delete folder' do
+      it "should be able to recursively delete the contents of a folder" do
+        folder = @client.create_folder('/ruby-box_gem_testing/delete_test')
+        @client.create_folder('/ruby-box_gem_testing/delete_test/subfolder')
+        folder.delete(recursive: 'true')
+      end
+    end
+
+    context 'retrieving a file' do
+      it "returns meta information for a file" do
+        file = @client.file( '/ruby-box_gem_testing/cool stuff/кузнецкий_105_а_№2.test' )
+        file.size.should == 14
+      end
+
+      it "a file can be retrieved by its id" do
+        file = @client.file( '/ruby-box_gem_testing/cool stuff/кузнецкий_105_а_№2.test' )
+        file_by_id = @client.file_by_id( file.id )
+        file_by_id.size.should == 14
+      end
+    end
+    
+    describe '#stream' do
+      it "should download file contents" do
+        stream = @client.stream( '/ruby-box_gem_testing/cool stuff/кузнецкий_105_а_№2.test' )
+        stream.read.should eq "Test more data"        
+      end
+
+      it "should execute content_length_proc lambda with filesize" do
+        stream = @client.stream(
+          '/ruby-box_gem_testing/cool stuff/кузнецкий_105_а_№2.test',
+          :content_length_proc => lambda {|filesize|
+            filesize.should == 14
+          }
+        )
+        stream.read.should eq "Test more data"                
+      end
+    end
+
+    describe '#download' do
+      it "finds the id of a file" do
+        data = @client.download( '/ruby-box_gem_testing/cool stuff/кузнецкий_105_а_№2.test' )
+        data.should eq "Test more data"
+      end
+      
+      it "returns nil for a nonexistent file" do
+        data = @client.download( '/ruby-box_gem_testing/doesntexist' )
+        data.should eq nil
+      end   
+    end
+
+    describe '#collaborations' do
+      it 'should be able to create and list collaborations on a folder' do
+        folder = @client.create_folder('/ruby-box_gem_testing/collaboration_folder')
+        folder.create_collaboration('bencoe@gmail.com')
+        folder.create_collaboration('ben@attachments.me', 'editor')
+        collaborations = folder.collaborations.to_a
+
+        collaborations[0].role.should == 'viewer'
+        collaborations[1].role.should == 'editor'
+        collaborations.count.should == 2
+
+        folder.delete if folder
+      end
+    end
+
+    describe '#shared_link' do
+      it 'should allow a share link to be created for a folder' do
+        folder = @client.create_folder('/ruby-box_gem_testing/shared_folder').create_shared_link
+
+        # share link was successfully created.
+        folder.shared_link.url.should match /https?:\/\/[\S]+/
+        folder.shared_link.is_a?(RubyBox::SharedLink).should == true
+
+        # share link can be disabled.
+        folder.disable_shared_link
+        folder.shared_link.should == nil
+
+        folder.delete if folder
+      end
+
+      it 'should allow a share link to be created for a file' do
+        utf8_file_name = '遠志教授.jpg'
+        file = @client.upload_file('spec/fixtures/' + utf8_file_name, '/ruby-box_gem_testing/cool stuff/').create_shared_link
+
+        # share link was successfully created.
+        file.shared_link.url.should match /https?:\/\/[\S]+/
+        
+        # share link can be disabled.
+        file.disable_shared_link
+        file.shared_link.should == nil
+
+        file.delete        
+      end
+    end
+
+    describe "#create_comment" do
+      it "allows a comment to be created on a file" do
+        file = @client.upload_file('spec/fixtures/遠志教授.jpg', '/ruby-box_gem_testing/cool stuff/')
+        file.create_comment('Hello world!')
+        file.comments.first.message.should == 'Hello world!'
+        file.delete
+      end
+    end
+
+    describe "#copy_to" do
+      it "it copies a file to a folder when a folder id is passed in" do
+        file = @client.upload_file('spec/fixtures/遠志教授.jpg', '/ruby-box_gem_testing/')
+        folder = @client.folder('/ruby-box_gem_testing/cool stuff/')
+        
+        file.copy_to(folder.id)
+
+        copied_file = @client.file('/ruby-box_gem_testing/cool stuff/遠志教授.jpg')
+
+        copied_file.name.should == file.name
+        copied_file.size.should == file.size
+
+        file.delete
+        copied_file.delete
+      end
+
+      it "it copies a file to a folder when a folder is passed in" do
+        file = @client.upload_file('spec/fixtures/遠志教授.jpg', '/ruby-box_gem_testing/')
+        folder = @client.folder('/ruby-box_gem_testing/cool stuff/')
+        
+        file.copy_to(folder)
+
+        copied_file = @client.file('/ruby-box_gem_testing/cool stuff/遠志教授.jpg')
+
+        copied_file.name.should == file.name
+        copied_file.size.should == file.size
+
+        file.delete
+        copied_file.delete
+      end
+
+      it "allows file to be renamed when copied" do
+        file = @client.upload_file('spec/fixtures/遠志教授.jpg', '/ruby-box_gem_testing/')
+        folder = @client.folder('/ruby-box_gem_testing/cool stuff/')
+        
+        file.copy_to(folder, 'banana.jpg')
+
+        copied_file = @client.file('/ruby-box_gem_testing/cool stuff/banana.jpg')
+
+        copied_file.name.should == 'banana.jpg'
+        copied_file.size.should == file.size
+
+        file.delete
+        copied_file.delete
+      end
+    end
+
+    describe "#move_to" do
+      it "it moves a file to a folder, the original no longer exists" do
+        file = @client.upload_file('spec/fixtures/遠志教授.jpg', '/ruby-box_gem_testing/')
+        folder = @client.folder('/ruby-box_gem_testing/cool stuff/')
+
+        file.move_to(folder.id)
+        original_file = @client.file('/ruby-box_gem_testing/遠志教授.jpg')
+        original_file.should == nil # the original should no longer exist.
+
+        moved_file = @client.file('/ruby-box_gem_testing/cool stuff/遠志教授.jpg')
+        moved_file.name.should == file.name # the file should exist in the new location.
+        moved_file.size.should == file.size
+
+        moved_file.delete
+      end
+
+      it "allows file to be renamed when moved" do
+        file = @client.upload_file('spec/fixtures/遠志教授.jpg', '/ruby-box_gem_testing/')
+        folder = @client.folder('/ruby-box_gem_testing/cool stuff/')
+
+        file.move_to(folder, 'banana.jpg')
+        original_file = @client.file('/ruby-box_gem_testing/遠志教授.jpg')
+        original_file.should == nil # the original should no longer exist.
+
+        moved_file = @client.file('/ruby-box_gem_testing/cool stuff/banana.jpg')
+        moved_file.name.should == 'banana.jpg' # the file should exist in the new location.
+        moved_file.size.should == file.size
+
+        moved_file.delete
+      end
+
+    end
+
+  end
+end