shrine-url 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d6f4cb4622bcb4d935b7b86b9888ee7c32079053
-  data.tar.gz: 1b0f0d88c06a9da86dfd9031db7da73b33c65f32
+  metadata.gz: 5da2ca4ce8958271c422287cc7b8ee6fe7999526
+  data.tar.gz: 1c9b02222b55b30bb63cb333fd73c4dc4e8951ab
 SHA512:
-  metadata.gz: 9a3ac0a1d66ed189d42e185407e2a97971faeb5b792c91c979b2b03c99a29aaaae08f337b1e04d913a5a0ebcec36b0077afb379bb67e25fbb7d2ddf344b616d2
-  data.tar.gz: 0be5d02f2b146a9dbe9f26bb9aabbcc24b91136bc57e2e359e1c0b3d4be8ff1d24aeeead115321aaa2449ddb1cc281073e014d307d360041f403a028fdc9999c
+  metadata.gz: cfe2bf454cbc951f7f7804a91098d5bb610b165810c4ca2370cf70d52e91519be8d643496b5b0937ca44ab611d9364b4139fc65e6971c149d8589d62a870a01f
+  data.tar.gz: d085d268244090667a609831df75949ff1ea9569f0a2c24104b2ab9a26d0de0e9c7e5db4613d95cb8d613392bbbd1644da6e0fe3e2b9d7995f201b6dc0a029a0

data/README.md

@@ -1,7 +1,7 @@
 # Shrine::Storage::Url
 
-Provides a fake storage which allows you to create a Shrine attachment defined
-only by a custom URL.
+Provides a "storage" which allows you to save uploaded files defined by a
+custom URL.
 
 ## Installation
 
@@ -11,20 +11,45 @@ gem "shrine-url"
 
 ## Usage
 
-The representation of the uploaded file assumes that the ID will be a custom
-URL:
+```rb
+require "shrine/storage/url"
+
+Shrine.storages[:cache] = Shrine::Storage::Url.new
+```
 
 ```rb
-{
+photo = Photo.new
+
+attachment_data = {
   id: "http://example.com/image.jpg",
-  storage: "url",
-  metadata: {}
+  storage: "cache",
+  metadata: {...}
 }
+
+photo.image = attachment_data.to_json
+photo.image #=> #<Shrine::UploadedFile>
+
+photo.image.url      #=> "http://example.com/image.jpg"
+photo.image.download # Downloads from this URL
+photo.image.exists?  # Checks whether a request to this URL returns 200
+photo.image.delete   # No-op
 ```
 
-This is used in [shrine-transloadit] for direct uploads, where a temporary URL
-of the uploaded file is returned, and we want to use that URL for further
-processing, eventually replacing the attachment with permanent files.
+The custom URL can be saved to `id`, and `#url` will simply read that field.
+When this `Shrine::UploadedFile` is uploaded to another storage (e.g. permanent
+storage), if the storage doesn't support upload from URL the file will simply
+be downloaded from the custom URL, just like for any other storage.
+
+## Use cases
+
+This storage can be used with [shrine-transloadit] for direct uploads, where a
+temporary URL of the uploaded file is returned, and we want to use that URL for
+further background processing, eventually replacing the attachment with
+processed files.
+
+It is also used in [shrine-tus-demo], where the files are uploaded to a
+separate endpoint, and then its file URL is attached to a database record and
+promoted to permanent storage.
 
 ## Contributing
 
@@ -37,3 +62,4 @@ $ rake test
 [MIT](/LICENSE.txt)
 
 [shrine-transloadit]: https://github.com/janko-m/shrine-transloadit
+[shrine-tus-demo]: https://github.com/janko-m/shrine-tus-demo

data/lib/shrine/storage/url.rb

@@ -20,7 +20,9 @@ class Shrine
       def exists?(id)
         response = nil
         uri = URI(id)
-        Net::HTTP.start(uri.host, uri.port) { |http| response = http.head(id) }
+        Net::HTTP.start(uri.host, uri.port) do |http|
+          response = http.head(uri.request_uri)
+        end
         response.code.to_i == 200
       end
 

data/shrine-url.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name          = "shrine-url"
-  gem.version       = "0.1.0"
+  gem.version       = "0.1.1"
 
   gem.required_ruby_version = ">= 2.1"
 
@@ -14,7 +14,7 @@ Gem::Specification.new do |gem|
   gem.require_path = "lib"
 
   gem.add_dependency "shrine", ">= 2.0"
-  gem.add_dependency "down", ">= 2.3.3"
+  gem.add_dependency "down", ">= 2.3.7"
 
   gem.add_development_dependency "rake"
   gem.add_development_dependency "minitest"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shrine-url
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Janko Marohnić
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-11 00:00:00.000000000 Z
+date: 2016-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: shrine
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.3
+        version: 2.3.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.3
+        version: 2.3.7
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -103,4 +103,3 @@ specification_version: 4
 summary: Provides a fake storage which allows you to create a Shrine attachment defined
   only by a custom URL.
 test_files: []
-has_rdoc: