uploadcare-rails 0.5 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/README.md CHANGED
@@ -11,7 +11,9 @@ This is a Rails gem for using the [Uploadcare.com](https://uploadcare.com) servi
11
11
 
12
12
  # Usage
13
13
 
14
- This gem provides ability to attach Uploadcare files to your models. To do that, you need a string field in your model, which is going to hold an Uploadcare file's UUID.
14
+ This gem provides ability to attach Uploadcare files to your models. To do that, you need a string field in your model, which is going to hold an Uploadcare file's CDN URL.
15
+
16
+ ## Configuration
15
17
 
16
18
  The first thing is to configure stuff for Uploadcare. Create a file `config/initializers/uploadcare.rb`:
17
19
 
@@ -25,7 +27,9 @@ end
25
27
 
26
28
  (These are our *demo* keys. You can use them to try things out. Don't forget to change them to your own keys before building anything serious).
27
29
 
28
- Add such an attribute to your model. First, create and run a migration:
30
+ ## Models
31
+
32
+ Add an attribute to your model. First, create and run a migration:
29
33
 
30
34
  rails generate migration AddFileToPost file:string
31
35
  rake db:migrate
@@ -39,6 +43,8 @@ class Post < ActiveRecord::Base
39
43
  end
40
44
  ```
41
45
 
46
+ ## Forms
47
+
42
48
  To display nice widgets for file upload, include the script for desired widget version (here we use 0.8) in your layout.
43
49
 
44
50
  ```erb
@@ -64,12 +70,21 @@ Now we can use the Uploadcare widget in our forms:
64
70
  <%= form.input :file, as: :uploadcare_uploader %>
65
71
  ```
66
72
 
73
+ ## Displaying files
74
+
67
75
  Uploadcare-rails gem takes care of storing files when saving a model, so as soon as you add a field to your form, everything should work, and you'll be able to show an image just like that:
68
76
 
69
77
  ```erb
70
78
  <%= image_tag @post.file.public_url("scale_crop/500x200", "effect/grayscale/") %>
71
79
  ```
72
80
 
81
+ If you need the unique identifier that Uploadcare uses to represent a file,
82
+ it is available like so:
83
+
84
+ ```erb
85
+ UUID: <%= @post.file.uuid %>
86
+ ```
87
+
73
88
  [Other information](https://uploadcare.com/documentation/rest/#file) about the file is accessed through the `api` method that makes a single HTTP request to Uploadcare servers **for each file**. Use cautiously or cache the returned information somewhere.
74
89
 
75
90
  ```erb
@@ -2,9 +2,12 @@ module Uploadcare
2
2
  module Rails
3
3
  class File
4
4
 
5
+ attr_reader :uuid
6
+
5
7
  def initialize(api, cdn_url)
6
8
  @api = api
7
9
  @cdn_url = cdn_url
10
+ @uuid = @api.uuid(cdn_url)
8
11
  end
9
12
 
10
13
  def cdn_url(*operations)
@@ -1,5 +1,5 @@
1
1
  module Uploadcare
2
2
  module Rails
3
- VERSION = "0.5"
3
+ VERSION = "0.5.1"
4
4
  end
5
5
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: uploadcare-rails
3
3
  version: !ruby/object:Gem::Version
4
- version: '0.5'
4
+ version: 0.5.1
5
5
  prerelease:
6
6
  platform: ruby
7
7
  authors:
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2013-04-22 00:00:00.000000000 Z
12
+ date: 2013-04-23 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: rails
@@ -34,7 +34,7 @@ dependencies:
34
34
  requirements:
35
35
  - - '='
36
36
  - !ruby/object:Gem::Version
37
- version: 0.1.2
37
+ version: 0.1.3
38
38
  type: :runtime
39
39
  prerelease: false
40
40
  version_requirements: !ruby/object:Gem::Requirement
@@ -42,7 +42,7 @@ dependencies:
42
42
  requirements:
43
43
  - - '='
44
44
  - !ruby/object:Gem::Version
45
- version: 0.1.2
45
+ version: 0.1.3
46
46
  - !ruby/object:Gem::Dependency
47
47
  name: sqlite3
48
48
  requirement: !ruby/object:Gem::Requirement
@@ -125,7 +125,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
125
125
  version: '0'
126
126
  segments:
127
127
  - 0
128
- hash: 4094460784775535100
128
+ hash: 589296094626255703
129
129
  required_rubygems_version: !ruby/object:Gem::Requirement
130
130
  none: false
131
131
  requirements:
@@ -134,7 +134,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
134
134
  version: '0'
135
135
  segments:
136
136
  - 0
137
- hash: 4094460784775535100
137
+ hash: 589296094626255703
138
138
  requirements: []
139
139
  rubyforge_project:
140
140
  rubygems_version: 1.8.24