fog-local 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7aa87f144c0161b011bf8b98de92dc71384bd116
+  data.tar.gz: 2c12c547029f47e8f05b4e142c436da8baa557f9
+SHA512:
+  metadata.gz: 5191d18d28bfaff0193029a1d098f1481369e0fedd2a8e103770d5c341070383887d4858a8c36b7218bd8f060f372dbf680745d96ca157522a049c28dc4591af
+  data.tar.gz: 4396615bc48dac3976ffbcd26a85588868e7cb0d982befcbcc602f7707cd85e11e476faa772c45b440e31d07407f88e79a1fb91d917faff256364540cc098283

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+tests/.fog

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+sudo: false
+script: bundle exec rake test
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.5
+  - 2.2.0
+  - jruby-19mode

data/CONTRIBUTING.md

@@ -0,0 +1,18 @@
+## Getting Involved
+
+New contributors are always welcome, when it doubt please ask questions. We strive to be an open and welcoming community. Please be nice to one another.
+
+### Coding
+
+* Pick a task:
+  * Offer feedback on open [pull requests](https://github.com/fog/fog/pulls).
+  * Review open [issues](https://github.com/fog/fog/issues) for things to help on.
+  * [Create an issue](https://github.com/fog/fog/issues/new) to start a discussion on additions or features.
+* Fork the project, add your changes and tests to cover them in a topic branch.
+* Commit your changes and rebase against `fog/fog` to ensure everything is up to date.
+* [Submit a pull request](https://github.com/fog/fog/compare/).
+
+### Non-Coding
+
+* Offer feedback on open [issues](https://github.com/fog/fog/issues).
+* Organize or volunteer at events.

data/CONTRIBUTORS.md

@@ -0,0 +1,18 @@
+* geemus <geemus@gmail.com>
+* Lance Ivy <lance@cainlevy.net>
+* Paul Thornthwaite <tokengeek@gmail.com>
+* Benjamin Manns <benmanns@gmail.com>
+* Sjoerd Andringa <sjoerd.andringa@me.com>
+* Juris Galang <jurisgalang@gmail.com>
+* Paul Thornthwaite <paul@brightbox.co.uk>
+* Jamie Paton <jamiep@activestate.com>
+* Thomas Wright <tfwright@gmail.com>
+* Wesley Beary <me@geemus.com>
+* Karl Freeman <karlfreeman@gmail.com>
+* Andy Lindeman <andy@andylindeman.com>
+* Athir Nuaimi <anuaimi@devfoundry.com>
+* Brian D. Burns <iosctr@gmail.com>
+* Jade Tucker <jadeatucker@gmail.com>
+* James Herdman <james.herdman@me.com>
+* Adam Tanner <adam@adamtanner.org>
+* Mark Yen <marky@activestate.com>

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fog-local.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 [CONTRIBUTORS.md](https://github.com/fog/fog/blob/master/CONTRIBUTORS.md)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+# Fog::Local
+
+![Gem Version](https://badge.fury.io/rb/fog-local.svg)
+[![Build Status](https://travis-ci.org/fog/fog-local.svg?branch=master)](https://travis-ci.org/fog/fog-local)
+[![Dependency Status](https://gemnasium.com/fog/fog-local.svg)](https://gemnasium.com/fog/fog-local)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'fog-local'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install fog-local
+
+## Usage
+
+Initialise a `Fog::Storage` object using local provider
+
+```ruby
+
+storage = Fog::Storage.new({
+  :local_root => '~/fog',
+  :provider   => 'Local'
+})
+
+```
+
+This can then be used like any other [Fog storage](http://fog.io/storage/).
+
+```ruby
+directory = storage.directories.create(:key => 'data')
+directory.files.create(:body => 'Hello World!', :key  => 'hello_world.txt')
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/fog/fog-local/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+
+task :default => :test
+
+mock = ENV['FOG_MOCK'] || 'true'
+task :test do
+  sh("export FOG_MOCK=#{mock} && bundle exec shindont")
+end

data/fog-local.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fog/local/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fog-local"
+  spec.version       = Fog::Local::VERSION
+  spec.authors       = ["Wesley Beary", "Ville Lautanala"]
+  spec.email         = ["geemus@gmail.com", "lautis@gmail.com"]
+
+  spec.summary       = %q{Module for the 'fog' gem to support local filesystem storage.}
+  spec.description   = %q{This library can be used as a module for `fog` or as standalone provider
+                       to use local filesystem storage.}
+  spec.homepage      = "https://github.com/fog/fog-local"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'shindo',  '~> 0.3'
+
+  spec.add_dependency 'fog-core',  '~> 1.27'
+end

data/lib/fog-local.rb

@@ -0,0 +1 @@
+require 'fog/local'

data/lib/fog/bin/local.rb

@@ -0,0 +1,29 @@
+class Local < Fog::Bin
+  class << self
+    def class_for(key)
+      case key
+      when :storage
+        Fog::Storage::Local
+      else
+        raise ArgumentError, "Unsupported #{self} service: #{key}"
+      end
+    end
+
+    def [](service)
+      @@connections ||= Hash.new do |hash, key|
+        hash[key] = case key
+        when :storage
+          Fog::Logger.warning("Local[:storage] is not recommended, use Storage[:local] for portability")
+          Fog::Storage.new(:provider => 'Local')
+        else
+          raise ArgumentError, "Unrecognized service: #{key.inspect}"
+        end
+      end
+      @@connections[service]
+    end
+
+    def services
+      Fog::Local.services
+    end
+  end
+end

data/lib/fog/local.rb

@@ -0,0 +1 @@
+require 'fog/local/storage'

data/lib/fog/local/core.rb

@@ -0,0 +1,9 @@
+require 'fog/core'
+
+module Fog
+  module Local
+    extend Fog::Provider
+
+    service(:storage, 'Storage')
+  end
+end

data/lib/fog/local/models/storage/directories.rb

@@ -0,0 +1,33 @@
+require 'fog/core/collection'
+require 'fog/local/models/storage/directory'
+
+module Fog
+  module Storage
+    class Local
+      class Directories < Fog::Collection
+        model Fog::Storage::Local::Directory
+
+        def all
+          data = if ::File.directory?(service.local_root)
+            Dir.entries(service.local_root).select do |entry|
+              entry[0...1] != '.' && ::File.directory?(service.path_to(entry))
+            end.map do |entry|
+              {:key => entry}
+            end
+          else
+            []
+          end
+          load(data)
+        end
+
+        def get(key, options = {})
+          if ::File.directory?(service.path_to(key))
+            new(:key => key)
+          else
+            nil
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fog/local/models/storage/directory.rb

@@ -0,0 +1,53 @@
+require 'fog/core/model'
+require 'fog/local/models/storage/files'
+
+module Fog
+  module Storage
+    class Local
+      class Directory < Fog::Model
+        identity  :key
+
+        def destroy
+          requires :key
+
+          if ::File.directory?(path)
+            Dir.rmdir(path)
+            true
+          else
+            false
+          end
+        end
+
+        def files
+          @files ||= begin
+            Fog::Storage::Local::Files.new(
+              :directory    => self,
+              :service   => service
+            )
+          end
+        end
+
+        def public=(new_public)
+          new_public
+        end
+
+        def public_url
+          nil
+        end
+
+        def save
+          requires :key
+
+          FileUtils.mkpath(path)
+          true
+        end
+
+        private
+
+        def path
+          service.path_to(key)
+        end
+      end
+    end
+  end
+end

data/lib/fog/local/models/storage/file.rb

@@ -0,0 +1,132 @@
+require 'fileutils'
+require 'fog/core/model'
+
+module Fog
+  module Storage
+    class Local
+      class File < Fog::Model
+        identity  :key,             :aliases => 'Key'
+
+        attribute :content_length,  :aliases => 'Content-Length', :type => :integer
+        # attribute :content_type,    :aliases => 'Content-Type'
+        attribute :last_modified,   :aliases => 'Last-Modified'
+
+        require 'uri'
+
+        def body
+          attributes[:body] ||= if last_modified
+            collection.get(identity).body
+          else
+            ''
+          end
+        end
+
+        def body=(new_body)
+          attributes[:body] = new_body
+        end
+
+        def content_type
+          @content_type ||= begin
+            unless (mime_types = ::MIME::Types.of(key)).empty?
+              mime_types.first.content_type
+            end
+          end
+        end
+
+        def directory
+          @directory
+        end
+
+        def copy(target_directory_key, target_file_key, options={})
+          requires :directory, :key
+          service.copy_object(directory.key, key, target_directory_key, target_file_key)
+          target_directory = service.directories.new(:key => target_directory_key)
+          target_directory.files.get(target_file_key)
+        end
+
+        def destroy
+          requires :directory, :key
+          ::File.delete(path) if ::File.exist?(path)
+          dirs = path.split(::File::SEPARATOR)[0...-1]
+          dirs.length.times do |index|
+            dir_path = dirs[0..-index].join(::File::SEPARATOR)
+            if dir_path.empty? # path starts with ::File::SEPARATOR
+              next
+            end
+            # don't delete the containing directory or higher
+            if dir_path == service.path_to(directory.key)
+              break
+            end
+            pwd = Dir.pwd
+            if ::File.exist?(dir_path) && ::File.directory?(dir_path)
+              Dir.chdir(dir_path)
+              if Dir.glob('*').empty?
+                Dir.rmdir(dir_path)
+              end
+              Dir.chdir(pwd)
+            end
+          end
+          true
+        end
+
+        def public=(new_public)
+          new_public
+        end
+
+        def public_url
+          requires :directory, :key
+
+          if service.endpoint
+            escaped_directory = URI.escape(directory.key)
+            escaped_key = URI.escape(key)
+
+            ::File.join(service.endpoint, escaped_directory, escaped_key)
+          else
+            nil
+          end
+        end
+
+        def save(options = {})
+          requires :body, :directory, :key
+          dirs = path.split(::File::SEPARATOR)[0...-1]
+          dirs.length.times do |index|
+            dir_path = dirs[0..index].join(::File::SEPARATOR)
+            if dir_path.empty? # path starts with ::File::SEPARATOR
+              next
+            end
+            # create directory if it doesn't already exist
+            begin
+              Dir.mkdir(dir_path)
+            rescue Errno::EEXIST
+              raise unless ::File.directory?(dir_path)
+            end
+          end
+          file = ::File.new(path, 'wb')
+          if body.is_a?(String)
+            file.write(body)
+          elsif body.kind_of? ::File and ::File.exist?(body.path)
+            FileUtils.cp(body.path, path)
+          else
+            file.write(body.read)
+          end
+          file.close
+          merge_attributes(
+            :content_length => Fog::Storage.get_body_size(body),
+            :last_modified  => ::File.mtime(path)
+          )
+          true
+        end
+
+        private
+
+        def directory=(new_directory)
+          @directory = new_directory
+        end
+
+        def path
+          service.path_to(::File.join(directory.key, key))
+        end
+      end
+    end
+  end
+end