miasma-local 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ceebf096e1b2813c60f3601a5b54a2ed0e230644
+  data.tar.gz: 1962f4cdef1ec1017613928760beb706333e24d4
+SHA512:
+  metadata.gz: 8d0ed1893acc392ab162b25a9e6976e68f50c7b5d9cf767c8bc18385b5b3ba208e5bf7ce97e3cd652dd660e770c5e614d74fbdb62992c68c2f0365023ddba5de
+  data.tar.gz: abc9904bc3562e61db8400aaeb6336066ff69253887ea45032c1b8c240d7638646ee592e14df8dad61ba7822d562f044ba6d7fdd6a86516cfb52a2d32f9fbded

data/CHANGELOG.md

@@ -0,0 +1,2 @@
+## v0.1.0
+* Initial release

data/LICENSE

@@ -0,0 +1,13 @@
+   Copyright 2014 Chris Roberts
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,6 @@
+# Miasma Local
+
+Local API plugin for the miasma cloud library
+
+## Info
+* Repository: https://github.com/miasma-rb/miasma-local

data/lib/miasma-local.rb

@@ -0,0 +1,2 @@
+require 'miasma'
+require 'miasma-local/version'

data/lib/miasma-local/version.rb

@@ -0,0 +1,4 @@
+module MiasmaLocal
+  # Current library version
+  VERSION = Gem::Version.new('0.1.0')
+end

data/lib/miasma/contrib/local.rb

@@ -0,0 +1,27 @@
+require 'miasma'
+
+module Miasma
+  module Contrib
+
+    # Local API core helper
+    class LocalApiCore
+
+      # Common API methods
+      module ApiCommon
+
+        # Set attributes into model
+        #
+        # @param klass [Class]
+        def self.included(klass)
+          klass.class_eval do
+            attribute :object_store_root, String
+          end
+        end
+
+      end
+
+    end
+  end
+
+  Models::Storage.autoload :Local, 'miasma/contrib/local/storage'
+end

data/lib/miasma/contrib/local/storage.rb

@@ -0,0 +1,252 @@
+require 'miasma'
+require 'fileutils'
+require 'tempfile'
+
+module Miasma
+  module Models
+    class Storage
+      class Local < Storage
+
+        include Contrib::LocalApiCore::ApiCommon
+
+        # Create new instance
+        #
+        # @param args [Hash]
+        # @return [self]
+        def initialize(args={})
+          super
+          unless(::File.directory?(object_store_root))
+            FileUtils.mkdir_p(object_store_root)
+          end
+        end
+
+        # Save bucket
+        #
+        # @param bucket [Models::Storage::Bucket]
+        # @return [Models::Storage::Bucket]
+        def bucket_save(bucket)
+          unless(bucket.persisted?)
+            FileUtils.mkdir_p(full_path(bucket))
+            bucket.id = bucket.name
+            bucket.valid_state
+          end
+          bucket
+        end
+
+        # Destroy bucket
+        #
+        # @param bucket [Models::Storage::Bucket]
+        # @return [TrueClass, FalseClass]
+        def bucket_destroy(bucket)
+          if(bucket.persisted?)
+            FileUtils.rmdir(full_path(bucket))
+            true
+          else
+            false
+          end
+        end
+
+        # Reload the bucket
+        #
+        # @param bucket [Models::Storage::Bucket]
+        # @return [Models::Storage::Bucket]
+        def bucket_reload(bucket)
+          if(bucket.persisted?)
+            unless(::File.directory?(full_path(bucket)))
+              bucket.data.clear
+              bucket.dirty.clear
+            else
+              bucket.valid_state
+            end
+          end
+          bucket
+        end
+
+        # Return all buckets
+        #
+        # @return [Array<Models::Storage::Bucket>]
+        def bucket_all
+          Dir.new(object_store_root).map do |item|
+            if(::File.directory?(item) && !item.start_with?('.'))
+              Bucket.new(
+                self,
+                :id => ::File.basename(uri_unescape(item)),
+                :name => ::File.basename(uri_unescape(item))
+              ).valid_state
+            end
+          end.compact
+        end
+
+        # Return filtered files
+        #
+        # @param args [Hash] filter options
+        # @return [Array<Models::Storage::File>]
+        def file_filter(bucket, args)
+          Dir.glob(::File.join(full_path(bucket), uri_escape(args[:prefix]), '*')).map do |item|
+            if(::File.file?(item) && !item.start_with?('.'))
+              item_name = item.sub("#{full_path(bucket)}/", '')
+              item_name = uri_unescape(item_name)
+              File.new(
+                bucket,
+                :id => ::File.join(bucket.name, item_name),
+                :name => item_name,
+                :updated => File.mtime(item),
+                :size => File.size(item)
+              ).valid_state
+            end
+          end.compact
+        end
+
+        # Return all files within bucket
+        #
+        # @param bucket [Bucket]
+        # @return [Array<File>]
+        # @todo pagination auto-follow
+        def file_all(bucket)
+          Dir.glob(::File.join(full_path(bucket), '*')).map do |item|
+            if(::File.file?(item) && !item.start_with?('.'))
+              item_name = item.sub("#{full_path(bucket)}/", '')
+              item_name = uri_unescape(item_name)
+              File.new(
+                bucket,
+                :id => ::File.join(bucket.name, item_name),
+                :name => item_name,
+                :updated => File.mtime(item),
+                :size => File.size(item)
+              ).valid_state
+            end
+          end.compact
+        end
+
+        # Save file
+        #
+        # @param file [Models::Storage::File]
+        # @return [Models::Storage::File]
+        def file_save(file)
+          if(file.dirty?)
+            file.load_data(file.attributes)
+            if(file.attributes[:body].is_a?(IO))
+              file.body.rewind
+              tmp_file = Tempfile.new('miasma')
+              while(content = file.body.read(Storage::READ_BODY_CHUNK_SIZE))
+                tmp_file.write content
+              end
+              tmp_file.close
+              FileUtils.mv(tmp_file.path, full_path(file))
+            end
+            file.id = ::File.join(file.bucket.name, file.name)
+            file.reload
+          end
+          file
+        end
+
+        # Destroy file
+        #
+        # @param file [Models::Storage::File]
+        # @return [TrueClass, FalseClass]
+        def file_destroy(file)
+          if(file.persisted?)
+            FileUtils.rm(full_path(file))
+            true
+          else
+            false
+          end
+        end
+
+        # Reload the file
+        #
+        # @param file [Models::Storage::File]
+        # @return [Models::Storage::File]
+        def file_reload(file)
+          if(file.persisted?)
+            new_info = Smash.new.tap do |data|
+              data[:updated] = File.mtime(full_path(file))
+              data[:size] = File.size(file_path(file))
+              data[:etag] = Digest::MD5.hexdigest(content)
+              data[:content_type] = MIME::Types.of(full_path(file))
+            end
+            file.load_data(file.attributes.deep_merge(new_info))
+            file.valid_state
+          end
+          file
+        end
+
+        # Create publicly accessible URL
+        #
+        # @param timeout_secs [Integer] seconds available
+        # @return [String] URL
+        # @todo where is this in swift?
+        def file_url(file, timeout_secs)
+          if(file.persisted?)
+            raise NotImplementedError
+          else
+            raise Error::ModelPersistError.new "#{file} has not been saved!"
+          end
+        end
+
+        # Fetch the contents of the file
+        #
+        # @param file [Models::Storage::File]
+        # @return [IO, HTTP::Response::Body]
+        def file_body(file)
+          if(file.persisted?)
+            tmp_file = Tempfile.new('miasma')
+            tmp_file.delete
+            FileUtils.cp(full_path(file), tmp_file.path)
+            tmp_file.open
+            tmp_file
+          else
+            StringIO.new('')
+          end
+        end
+
+        # @return [String] escaped bucket name
+        def bucket_path(bucket)
+          ::File.join(object_store_root, uri_escape(bucket.name))
+        end
+
+        # @return [String] escaped file path
+        def file_path(file)
+          file.name.split('/').map do |part|
+            uri_escape(part)
+          end.join('/')
+        end
+
+        # Provide full path for object
+        #
+        # @param file_or_bucket [File, Bucket]
+        # @return [String]
+        def full_path(file_or_bucket)
+          path = ''
+          if(file_or_bucket.respond_to?(:bucket))
+            path << '/' << bucket_path(file_or_bucket.bucket)
+          end
+          path << '/' << file_path(file_or_bucket)
+          path
+        end
+
+        # URL string escape
+        #
+        # @param string [String] string to escape
+        # @return [String] escaped string
+        # @todo move this to common module
+        def uri_escape(string)
+          string.to_s.gsub(/([^a-zA-Z0-9_.\-~])/) do
+            '%' << $1.unpack('H2' * $1.bytesize).join('%').upcase
+          end
+        end
+
+        # Un-escape URL escaped string
+        #
+        # @param string [String]
+        # @return [String]
+        def uri_unescape(string)
+          string.to_s.gsub(/%([^%]{2})/) do
+            [$1].pack('H2')
+          end
+        end
+
+      end
+    end
+  end
+end

data/miasma-local.gemspec

@@ -0,0 +1,16 @@
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__)) + '/lib/'
+require 'miasma-local/version'
+Gem::Specification.new do |s|
+  s.name = 'miasma-local'
+  s.version = MiasmaLocal::VERSION.version
+  s.summary = 'Smoggy local API'
+  s.author = 'Chris Roberts'
+  s.email = 'code@chrisroberts.org'
+  s.homepage = 'https://github.com/miasma-rb/miasma-local'
+  s.description = 'Smoggy local API'
+  s.license = 'Apache 2.0'
+  s.require_path = 'lib'
+  s.add_dependency 'miasma'
+  s.add_dependency 'mime-types'
+  s.files = Dir['lib/**/*'] + %w(miasma-local.gemspec README.md CHANGELOG.md LICENSE)
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: miasma-local
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chris Roberts
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-01-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: miasma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Smoggy local API
+email: code@chrisroberts.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/miasma-local.rb
+- lib/miasma-local/version.rb
+- lib/miasma/contrib/local.rb
+- lib/miasma/contrib/local/storage.rb
+- miasma-local.gemspec
+homepage: https://github.com/miasma-rb/miasma-local
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Smoggy local API
+test_files: []
+has_rdoc: