s33r 0.2 → 0.3

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.
Files changed (71) hide show
  1. data/bin/s3cli.rb +25 -16
  2. data/html/classes/MIME.html +120 -0
  3. data/html/classes/MIME/InvalidContentType.html +119 -0
  4. data/html/classes/MIME/Type.html +1173 -0
  5. data/html/classes/MIME/Types.html +566 -0
  6. data/html/classes/Net.html +108 -0
  7. data/html/classes/Net/HTTPGenericRequest.html +233 -0
  8. data/html/classes/Net/HTTPResponse.html +242 -0
  9. data/html/classes/S33r.html +743 -0
  10. data/html/classes/S33r/BucketListing.html +372 -0
  11. data/html/classes/S33r/Client.html +981 -0
  12. data/html/classes/S33r/NamedBucket.html +620 -0
  13. data/html/classes/S33r/S33rException.html +118 -0
  14. data/html/classes/S33r/S33rException/BucketListingMaxKeysError.html +111 -0
  15. data/html/classes/S33r/S33rException/InvalidBucketListing.html +111 -0
  16. data/html/classes/S33r/S33rException/MalformedBucketName.html +111 -0
  17. data/html/classes/S33r/S33rException/MethodNotAvailable.html +111 -0
  18. data/html/classes/S33r/S33rException/MissingRequiredHeaders.html +111 -0
  19. data/html/classes/S33r/S33rException/MissingResource.html +111 -0
  20. data/html/classes/S33r/S33rException/UnsupportedCannedACL.html +111 -0
  21. data/html/classes/S33r/S33rException/UnsupportedHTTPMethod.html +111 -0
  22. data/html/classes/S33r/S3Object.html +307 -0
  23. data/html/classes/S33r/S3User.html +171 -0
  24. data/html/classes/S33r/Sync.html +151 -0
  25. data/html/classes/XML.html +200 -0
  26. data/html/classes/XML/Document.html +125 -0
  27. data/html/classes/XML/Node.html +124 -0
  28. data/html/created.rid +1 -0
  29. data/html/files/CHANGELOG.html +101 -0
  30. data/html/files/MIT-LICENSE.html +129 -0
  31. data/html/files/README_txt.html +209 -0
  32. data/html/files/lib/s33r/bucket_listing_rb.html +116 -0
  33. data/html/files/lib/s33r/client_rb.html +110 -0
  34. data/html/files/lib/s33r/core_rb.html +113 -0
  35. data/html/files/lib/s33r/libxml_extensions_rb.html +107 -0
  36. data/html/files/lib/s33r/mimetypes_rb.html +120 -0
  37. data/html/files/lib/s33r/named_bucket_rb.html +101 -0
  38. data/html/files/lib/s33r/s33r_exception_rb.html +101 -0
  39. data/html/files/lib/s33r/s33r_http_rb.html +108 -0
  40. data/html/files/lib/s33r/sync_rb.html +101 -0
  41. data/html/files/lib/s33r_rb.html +101 -0
  42. data/html/fr_class_index.html +52 -0
  43. data/html/fr_file_index.html +39 -0
  44. data/html/fr_method_index.html +126 -0
  45. data/html/index.html +24 -0
  46. data/html/rdoc-style.css +208 -0
  47. data/lib/s33r/bucket_listing.rb +69 -60
  48. data/lib/s33r/client.rb +150 -73
  49. data/lib/s33r/core.rb +56 -44
  50. data/lib/s33r/libxml_extensions.rb +10 -5
  51. data/lib/s33r/mimetypes.rb +3 -2
  52. data/lib/s33r/named_bucket.rb +89 -24
  53. data/lib/s33r/{s3_exception.rb → s33r_exception.rb} +2 -2
  54. data/lib/s33r/{net_http_overrides.rb → s33r_http.rb} +29 -21
  55. data/lib/s33r/sync.rb +4 -2
  56. data/test/cases/spec_bucket_listing.rb +10 -13
  57. data/test/cases/spec_client.rb +65 -0
  58. data/test/cases/spec_core.rb +16 -11
  59. data/test/cases/spec_namedbucket.rb +32 -0
  60. data/test/cases/spec_sync.rb +6 -5
  61. data/test/cases/spec_xml.rb +1 -1
  62. data/test/files/client_config.yml +6 -0
  63. data/test/files/namedbucket_config.yml +12 -0
  64. data/test/{s3_test_constants.rb → test_setup.rb} +7 -6
  65. metadata +63 -11
  66. data/LICENSE.txt +0 -22
  67. data/MIT-LICENSE +0 -21
  68. data/README.txt +0 -19
  69. data/bin/config.yml +0 -5
  70. data/test/cases/unit_client.rb +0 -40
  71. data/test/cases/unit_named_bucket.rb +0 -12
data/bin/s3cli.rb CHANGED
@@ -1,7 +1,7 @@
1
1
  # SIMPLE COMMAND LINE S3 CLIENT
2
2
  # You need an Amazon S3 account to use this: get one at http://aws.amazon.com/
3
3
  #
4
- # Create a config. file called based on the config.yml example in this directory;
4
+ # Create a config. file called based on the example in test/files/namedbucket_config.yml;
5
5
  # then change the config_file setting below to set the path to your config. file.
6
6
  # You will be prompted to create a bucket if your setting for bucket in the config.
7
7
  # file is blank.
@@ -16,28 +16,32 @@
16
16
  # to_email: email address to send to (optional)
17
17
 
18
18
  require 'yaml'
19
- require 'rubygems'
20
- require_gem 's33r'
21
19
  require 'net/smtp'
22
20
  require 'time'
23
21
  require 'parsedate'
24
22
 
23
+ require File.join(File.dirname(__FILE__), '../lib/s33r')
24
+
25
25
  filename = ARGV[0]
26
26
  to_email = ARGV[1]
27
27
  # set to the path to your config. file
28
28
  config_file = '/home/ell/.s33r'
29
29
 
30
30
  # load config. file
31
- options = YAML::load_file(config_file)
32
- access_key = options['access_key']
33
- secret_key = options['secret_key']
34
- from_email = options['from_email']
35
- to_email ||= options['to_email']
36
- bucket = options['bucket']
31
+ access_key, secret_key, options, custom = S33r::Client.load_config(config_file)
32
+
33
+ # bucket name to work with
34
+ bucket = options[:default_bucket]
35
+
36
+ puts "Using bucket: #{bucket}"
37
+
38
+ # email addresses
39
+ to_email = custom[:to_email]
40
+ from_email = custom[:from_email]
37
41
 
38
42
  # expires can be a date/time string or 'forever';
39
43
  # if not set, defaults to 15 minutes
40
- expires = options['default_expires']
44
+ expires = options[:default_expires]
41
45
  base_expires = Time.now.to_i
42
46
  if 'forever' == expires
43
47
  # 20 years (same as forever in computer terms)
@@ -54,7 +58,7 @@ end
54
58
  if !bucket
55
59
  require 'readline'
56
60
  bucket = Readline.readline('No bucket found; please enter name for new bucket: ', true)
57
- client = S3::Client.new(access_key, secret_key)
61
+ client = S33r::Client.new(access_key, secret_key)
58
62
  response = client.create_bucket(bucket)
59
63
  if response.ok?
60
64
  puts 'Created new bucket'
@@ -64,6 +68,8 @@ if !bucket
64
68
  end
65
69
  end
66
70
 
71
+ options[:default_bucket] = bucket
72
+
67
73
  # estimate upload time
68
74
  filesize = FileTest.size(filename)
69
75
  filesize_mb = (filesize / (1000*1000)).to_i
@@ -84,9 +90,11 @@ puts str
84
90
  start_time_secs = Time.now.to_i
85
91
 
86
92
  # a client pointing at the specified bucket
87
- S3::NamedBucket.new(access_key, secret_key, bucket) do |c|
88
- response = c.put_file(filename, filename)
89
- url = c.s3_authenticated_url(filename, expires)
93
+ S33r::NamedBucket.new(access_key, secret_key, options) do |c|
94
+
95
+ response = c.put_file(filename)
96
+
97
+ url = c.authenticated_url(filename, expires)
90
98
 
91
99
  time_taken_secs = Time.now.to_i - start_time_secs
92
100
  puts "Aah, it appears to have taken %d seconds" % time_taken_secs
@@ -110,6 +118,7 @@ S3::NamedBucket.new(access_key, secret_key, bucket) do |c|
110
118
  end
111
119
  end
112
120
  else
113
- puts 'File transfer failed'
121
+ puts "File transfer failed with response code #{response.code}"
114
122
  end
115
- end
123
+
124
+ end
data/html/classes/MIME.html ADDED
@@ -0,0 +1,120 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Module: MIME</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td><strong>Module</strong></td>
53
+ <td class="class-name-in-header">MIME</td>
54
+ </tr>
55
+ <tr class="top-aligned-row">
56
+ <td><strong>In:</strong></td>
57
+ <td>
58
+ <a href="../files/lib/s33r/mimetypes_rb.html">
59
+ lib/s33r/mimetypes.rb
60
+ </a>
61
+ <br />
62
+ </td>
63
+ </tr>
64
+
65
+ </table>
66
+ </div>
67
+ <!-- banner header -->
68
+
69
+ <div id="bodyContent">
70
+
71
+
72
+
73
+ <div id="contextContent">
74
+
75
+ <div id="description">
76
+ <p>
77
+ The namespace for <a href="MIME.html">MIME</a> applications, tools, and
78
+ libraries.
79
+ </p>
80
+
81
+ </div>
82
+
83
+
84
+ </div>
85
+
86
+
87
+ </div>
88
+
89
+
90
+ <!-- if includes -->
91
+
92
+ <div id="section">
93
+
94
+ <div id="class-list">
95
+ <h3 class="section-bar">Classes and Modules</h3>
96
+
97
+ Class <a href="MIME/InvalidContentType.html" class="link">MIME::InvalidContentType</a><br />
98
+ Class <a href="MIME/Type.html" class="link">MIME::Type</a><br />
99
+ Class <a href="MIME/Types.html" class="link">MIME::Types</a><br />
100
+
101
+ </div>
102
+
103
+
104
+
105
+
106
+
107
+
108
+
109
+ <!-- if method_list -->
110
+
111
+
112
+ </div>
113
+
114
+
115
+ <div id="validator-badges">
116
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
117
+ </div>
118
+
119
+ </body>
120
+ </html>
data/html/classes/MIME/InvalidContentType.html ADDED
@@ -0,0 +1,119 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Class: MIME::InvalidContentType</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td><strong>Class</strong></td>
53
+ <td class="class-name-in-header">MIME::InvalidContentType</td>
54
+ </tr>
55
+ <tr class="top-aligned-row">
56
+ <td><strong>In:</strong></td>
57
+ <td>
58
+ <a href="../../files/lib/s33r/mimetypes_rb.html">
59
+ lib/s33r/mimetypes.rb
60
+ </a>
61
+ <br />
62
+ </td>
63
+ </tr>
64
+
65
+ <tr class="top-aligned-row">
66
+ <td><strong>Parent:</strong></td>
67
+ <td>
68
+ RuntimeError
69
+ </td>
70
+ </tr>
71
+ </table>
72
+ </div>
73
+ <!-- banner header -->
74
+
75
+ <div id="bodyContent">
76
+
77
+
78
+
79
+ <div id="contextContent">
80
+
81
+ <div id="description">
82
+ <p>
83
+ Reflects a <a href="../MIME.html">MIME</a> Content-<a
84
+ href="Type.html">Type</a> which is in invalid format (e.g., it isn&#8217;t
85
+ in the form of type/subtype).
86
+ </p>
87
+
88
+ </div>
89
+
90
+
91
+ </div>
92
+
93
+
94
+ </div>
95
+
96
+
97
+ <!-- if includes -->
98
+
99
+ <div id="section">
100
+
101
+
102
+
103
+
104
+
105
+
106
+
107
+
108
+ <!-- if method_list -->
109
+
110
+
111
+ </div>
112
+
113
+
114
+ <div id="validator-badges">
115
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
116
+ </div>
117
+
118
+ </body>
119
+ </html>
data/html/classes/MIME/Type.html ADDED
@@ -0,0 +1,1173 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Class: MIME::Type</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td><strong>Class</strong></td>
53
+ <td class="class-name-in-header">MIME::Type</td>
54
+ </tr>
55
+ <tr class="top-aligned-row">
56
+ <td><strong>In:</strong></td>
57
+ <td>
58
+ <a href="../../files/lib/s33r/mimetypes_rb.html">
59
+ lib/s33r/mimetypes.rb
60
+ </a>
61
+ <br />
62
+ </td>
63
+ </tr>
64
+
65
+ <tr class="top-aligned-row">
66
+ <td><strong>Parent:</strong></td>
67
+ <td>
68
+ Object
69
+ </td>
70
+ </tr>
71
+ </table>
72
+ </div>
73
+ <!-- banner header -->
74
+
75
+ <div id="bodyContent">
76
+
77
+
78
+
79
+ <div id="contextContent">
80
+
81
+ <div id="description">
82
+ <p>
83
+ The definition of one <a href="../MIME.html">MIME</a> content-type.
84
+ </p>
85
+ <h2>Usage</h2>
86
+ <pre>
87
+ require 'mime/types'
88
+
89
+ plaintext = MIME::Types['text/plain']
90
+ print plaintext.media_type # =&gt; 'text'
91
+ print plaintext.sub_type # =&gt; 'plain'
92
+
93
+ puts plaintext.extensions.join(&quot; &quot;) # =&gt; 'asc txt c cc h hh cpp'
94
+
95
+ puts plaintext.encoding # =&gt; 8bit
96
+ puts plaintext.binary? # =&gt; false
97
+ puts plaintext.ascii? # =&gt; true
98
+ puts plaintext == 'text/plain' # =&gt; true
99
+ puts MIME::Type.simplified('x-appl/x-zip') # =&gt; 'appl/zip'
100
+ </pre>
101
+
102
+ </div>
103
+
104
+
105
+ </div>
106
+
107
+ <div id="method-list">
108
+ <h3 class="section-bar">Methods</h3>
109
+
110
+ <div class="name-list">
111
+ <a href="#M000031">ascii?</a>&nbsp;&nbsp;
112
+ <a href="#M000030">binary?</a>&nbsp;&nbsp;
113
+ <a href="#M000035">complete?</a>&nbsp;&nbsp;
114
+ <a href="#M000019">default_encoding</a>&nbsp;&nbsp;
115
+ <a href="#M000022">docs=</a>&nbsp;&nbsp;
116
+ <a href="#M000025">from_array</a>&nbsp;&nbsp;
117
+ <a href="#M000026">from_hash</a>&nbsp;&nbsp;
118
+ <a href="#M000027">from_mime_type</a>&nbsp;&nbsp;
119
+ <a href="#M000018">like?</a>&nbsp;&nbsp;
120
+ <a href="#M000028">new</a>&nbsp;&nbsp;
121
+ <a href="#M000021">obsolete?</a>&nbsp;&nbsp;
122
+ <a href="#M000034">platform?</a>&nbsp;&nbsp;
123
+ <a href="#M000029">registered?</a>&nbsp;&nbsp;
124
+ <a href="#M000032">signature?</a>&nbsp;&nbsp;
125
+ <a href="#M000024">simplified</a>&nbsp;&nbsp;
126
+ <a href="#M000033">system?</a>&nbsp;&nbsp;
127
+ <a href="#M000038">to_a</a>&nbsp;&nbsp;
128
+ <a href="#M000039">to_hash</a>&nbsp;&nbsp;
129
+ <a href="#M000036">to_s</a>&nbsp;&nbsp;
130
+ <a href="#M000037">to_str</a>&nbsp;&nbsp;
131
+ <a href="#M000023">urls</a>&nbsp;&nbsp;
132
+ <a href="#M000020">use_instead</a>&nbsp;&nbsp;
133
+ </div>
134
+ </div>
135
+
136
+ </div>
137
+
138
+
139
+ <!-- if includes -->
140
+ <div id="includes">
141
+ <h3 class="section-bar">Included Modules</h3>
142
+
143
+ <div id="includes-list">
144
+ <span class="include-name">Comparable</span>
145
+ </div>
146
+ </div>
147
+
148
+ <div id="section">
149
+
150
+
151
+ <div id="constants-list">
152
+ <h3 class="section-bar">Constants</h3>
153
+
154
+ <div class="name-list">
155
+ <table summary="Constants">
156
+ <tr class="top-aligned-row context-row">
157
+ <td class="context-item-name">VERSION</td>
158
+ <td>=</td>
159
+ <td class="context-item-value">'1.15'</td>
160
+ </tr>
161
+ <tr class="top-aligned-row context-row">
162
+ <td class="context-item-name">IANA_URL</td>
163
+ <td>=</td>
164
+ <td class="context-item-value">&quot;http://www.iana.org/assignments/media-types/%s/%s&quot;</td>
165
+ </tr>
166
+ <tr class="top-aligned-row context-row">
167
+ <td class="context-item-name">RFC_URL</td>
168
+ <td>=</td>
169
+ <td class="context-item-value">&quot;http://rfc-editor.org/rfc/rfc%s.txt&quot;</td>
170
+ </tr>
171
+ <tr class="top-aligned-row context-row">
172
+ <td class="context-item-name">DRAFT_URL</td>
173
+ <td>=</td>
174
+ <td class="context-item-value">&quot;http://datatracker.ietf.org/public/idindex.cgi?command=id_details&amp;filename=%s&quot;</td>
175
+ </tr>
176
+ <tr class="top-aligned-row context-row">
177
+ <td class="context-item-name">LTSW_URL</td>
178
+ <td>=</td>
179
+ <td class="context-item-value">&quot;http://www.ltsw.se/knbase/internet/%s.htp&quot;</td>
180
+ </tr>
181
+ <tr class="top-aligned-row context-row">
182
+ <td class="context-item-name">CONTACT_URL</td>
183
+ <td>=</td>
184
+ <td class="context-item-value">&quot;http://www.iana.org/assignments/contact-people.htm#%s&quot;</td>
185
+ </tr>
186
+ </table>
187
+ </div>
188
+ </div>
189
+
190
+
191
+
192
+ <div id="attribute-list">
193
+ <h3 class="section-bar">Attributes</h3>
194
+
195
+ <div class="name-list">
196
+ <table>
197
+ <tr class="top-aligned-row context-row">
198
+ <td class="context-item-name">content_type</td>
199
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
200
+ <td class="context-item-desc">
201
+ Returns the whole <a href="../MIME.html">MIME</a> content-type string.
202
+
203
+ <pre>
204
+ text/plain =&gt; text/plain
205
+ x-chemical/x-pdb =&gt; x-chemical/x-pdb
206
+ </pre>
207
+ </td>
208
+ </tr>
209
+ <tr class="top-aligned-row context-row">
210
+ <td class="context-item-name">default_encoding</td>
211
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
212
+ <td class="context-item-desc">
213
+ Returns the default encoding for the <a href="Type.html">MIME::Type</a>
214
+ based on the media type.
215
+
216
+ </td>
217
+ </tr>
218
+ <tr class="top-aligned-row context-row">
219
+ <td class="context-item-name">docs</td>
220
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
221
+ <td class="context-item-desc">
222
+ The documentation for this <a href="Type.html">MIME::Type</a>.
223
+ Documentation about media types will be found on a media type definition as
224
+ a comment. Documentation will be found through docs.
225
+
226
+ </td>
227
+ </tr>
228
+ <tr class="top-aligned-row context-row">
229
+ <td class="context-item-name">encoding</td>
230
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
231
+ <td class="context-item-desc">
232
+ The encoding (7bit, 8bit, quoted-printable, or base64) required to
233
+ transport the data of this content type safely across a network, which
234
+ roughly corresponds to Content-Transfer-Encoding. A value of <tt>nil</tt>
235
+ or <tt>:default</tt> will reset the encoding to the <a
236
+ href="Type.html#M000019">default_encoding</a> for the <a
237
+ href="Type.html">MIME::Type</a>. Raises ArgumentError if the encoding
238
+ provided is invalid.
239
+
240
+ <p>
241
+ If the encoding is not provided on construction, this will be either
242
+ &#8216;quoted-printable&#8217; (for text/* media types) and
243
+ &#8216;base64&#8217; for eveything else.
244
+ </p>
245
+ </td>
246
+ </tr>
247
+ <tr class="top-aligned-row context-row">
248
+ <td class="context-item-name">extensions</td>
249
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
250
+ <td class="context-item-desc">
251
+ The list of extensions which are known to be used for this <a
252
+ href="Type.html">MIME::Type</a>. Non-array values will be coerced into an
253
+ array with <a href="Type.html#M000038">to_a</a>. Array values will be
254
+ flattened and <tt>nil</tt> values removed.
255
+
256
+ </td>
257
+ </tr>
258
+ <tr class="top-aligned-row context-row">
259
+ <td class="context-item-name">media_type</td>
260
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
261
+ <td class="context-item-desc">
262
+ Returns the media type of the simplified <a href="../MIME.html">MIME</a>
263
+ type.
264
+
265
+ <pre>
266
+ text/plain =&gt; text
267
+ x-chemical/x-pdb =&gt; chemical
268
+ </pre>
269
+ </td>
270
+ </tr>
271
+ <tr class="top-aligned-row context-row">
272
+ <td class="context-item-name">obsolete</td>
273
+ <td class="context-item-value">&nbsp;[W]&nbsp;</td>
274
+ <td class="context-item-desc">
275
+ Sets the obsolescence indicator for this media type.
276
+
277
+ </td>
278
+ </tr>
279
+ <tr class="top-aligned-row context-row">
280
+ <td class="context-item-name">raw_media_type</td>
281
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
282
+ <td class="context-item-desc">
283
+ Returns the media type of the unmodified <a href="../MIME.html">MIME</a>
284
+ type.
285
+
286
+ <pre>
287
+ text/plain =&gt; text
288
+ x-chemical/x-pdb =&gt; x-chemical
289
+ </pre>
290
+ </td>
291
+ </tr>
292
+ <tr class="top-aligned-row context-row">
293
+ <td class="context-item-name">raw_sub_type</td>
294
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
295
+ <td class="context-item-desc">
296
+ Returns the media type of the unmodified <a href="../MIME.html">MIME</a>
297
+ type.
298
+
299
+ <pre>
300
+ text/plain =&gt; plain
301
+ x-chemical/x-pdb =&gt; x-pdb
302
+ </pre>
303
+ </td>
304
+ </tr>
305
+ <tr class="top-aligned-row context-row">
306
+ <td class="context-item-name">simplified</td>
307
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
308
+ <td class="context-item-desc">
309
+ The <a href="../MIME.html">MIME</a> types main- and sub-label can both
310
+ start with <tt>x-</tt>, which indicates that it is a non-registered name.
311
+ Of course, after registration this flag can disappear, adds to the
312
+ confusing proliferation of <a href="../MIME.html">MIME</a> types. The
313
+ simplified string has the <tt>x-</tt> removed and are translated to
314
+ lowercase.
315
+
316
+ <pre>
317
+ text/plain =&gt; text/plain
318
+ x-chemical/x-pdb =&gt; chemical/pdb
319
+ </pre>
320
+ </td>
321
+ </tr>
322
+ <tr class="top-aligned-row context-row">
323
+ <td class="context-item-name">sub_type</td>
324
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
325
+ <td class="context-item-desc">
326
+ Returns the sub-type of the simplified <a href="../MIME.html">MIME</a>
327
+ type.
328
+
329
+ <pre>
330
+ text/plain =&gt; plain
331
+ x-chemical/x-pdb =&gt; pdb
332
+ </pre>
333
+ </td>
334
+ </tr>
335
+ <tr class="top-aligned-row context-row">
336
+ <td class="context-item-name">system</td>
337
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
338
+ <td class="context-item-desc">
339
+ The regexp for the operating system that this <a
340
+ href="Type.html">MIME::Type</a> is specific to.
341
+
342
+ </td>
343
+ </tr>
344
+ <tr class="top-aligned-row context-row">
345
+ <td class="context-item-name">url</td>
346
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
347
+ <td class="context-item-desc">
348
+ The encoded URL list for this <a href="Type.html">MIME::Type</a>. See <a
349
+ href="Type.html#M000023">urls</a> for
350
+
351
+ </td>
352
+ </tr>
353
+ <tr class="top-aligned-row context-row">
354
+ <td class="context-item-name">use_instead</td>
355
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
356
+ <td class="context-item-desc">
357
+ Returns the media type or types that should be used instead of this media
358
+ type, if it is obsolete. If there is no replacement media type, or it is
359
+ not obsolete, <tt>nil</tt> will be returned.
360
+
361
+ </td>
362
+ </tr>
363
+ </table>
364
+ </div>
365
+ </div>
366
+
367
+
368
+
369
+ <!-- if method_list -->
370
+ <div id="methods">
371
+ <h3 class="section-bar">Public Class methods</h3>
372
+
373
+ <div id="method-M000025" class="method-detail">
374
+ <a name="M000025"></a>
375
+
376
+ <div class="method-heading">
377
+ <a href="#M000025" class="method-signature">
378
+ <span class="method-name">from_array</span><span class="method-args">(*args) {|m if block_given?| ...}</span>
379
+ </a>
380
+ </div>
381
+
382
+ <div class="method-description">
383
+ <p>
384
+ Creates a <a href="Type.html">MIME::Type</a> from an array in the form of:
385
+ </p>
386
+ <pre>
387
+ [type-name, [extensions], encoding, system]
388
+ </pre>
389
+ <p>
390
+ <tt>extensions</tt>, <tt>encoding</tt>, and <tt>system</tt> are optional.
391
+ </p>
392
+ <pre>
393
+ MIME::Type.from_array(&quot;application/x-ruby&quot;, ['rb'], '8bit')
394
+ MIME::Type.from_array([&quot;application/x-ruby&quot;, ['rb'], '8bit'])
395
+ </pre>
396
+ <p>
397
+ These are equivalent to:
398
+ </p>
399
+ <pre>
400
+ MIME::Type.new('application/x-ruby') do |t|
401
+ t.extensions = %w(rb)
402
+ t.encoding = '8bit'
403
+ end
404
+ </pre>
405
+ <p><a class="source-toggle" href="#"
406
+ onclick="toggleCode('M000025-source');return false;">[Source]</a></p>
407
+ <div class="method-source-code" id="M000025-source">
408
+ <pre>
409
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 276</span>
410
+ 276: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">from_array</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-comment cmt">#:yields MIME::Type.new:</span>
411
+ 277: <span class="ruby-comment cmt"># Dereferences the array one level, if necessary.</span>
412
+ 278: <span class="ruby-identifier">args</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Array</span>)
413
+ 279:
414
+ 280: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span>.<span class="ruby-identifier">between?</span>(<span class="ruby-value">1</span>, <span class="ruby-value">8</span>)
415
+ 281: <span class="ruby-identifier">m</span> = <span class="ruby-constant">MIME</span><span class="ruby-operator">::</span><span class="ruby-constant">Type</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
416
+ 282: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">extensions</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
417
+ 283: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">encoding</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">2</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">2</span>
418
+ 284: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">system</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">3</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">3</span>
419
+ 285: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">obsolete</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">4</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">4</span>
420
+ 286: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">docs</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">5</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">5</span>
421
+ 287: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">url</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">6</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">6</span>
422
+ 288: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">registered</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">7</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">7</span>
423
+ 289: <span class="ruby-keyword kw">end</span>
424
+ 290: <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">m</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
425
+ 291: <span class="ruby-keyword kw">else</span>
426
+ 292: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Array provided must contain between one and eight elements.&quot;</span>
427
+ 293: <span class="ruby-keyword kw">end</span>
428
+ 294: <span class="ruby-identifier">m</span>
429
+ 295: <span class="ruby-keyword kw">end</span>
430
+ </pre>
431
+ </div>
432
+ </div>
433
+ </div>
434
+
435
+ <div id="method-M000026" class="method-detail">
436
+ <a name="M000026"></a>
437
+
438
+ <div class="method-heading">
439
+ <a href="#M000026" class="method-signature">
440
+ <span class="method-name">from_hash</span><span class="method-args">(hash) {|m if block_given?| ...}</span>
441
+ </a>
442
+ </div>
443
+
444
+ <div class="method-description">
445
+ <p>
446
+ Creates a <a href="Type.html">MIME::Type</a> from a hash. Keys are
447
+ case-insensitive, dashes may be replaced with underscores, and the internal
448
+ Symbol of the lowercase-underscore version can be used as well. That is,
449
+ Content-<a href="Type.html">Type</a> can be provided as content-type,
450
+ Content_Type, content_type, or :content_type.
451
+ </p>
452
+ <p>
453
+ Known keys are <tt>Content-<a href="Type.html">Type</a></tt>,
454
+ <tt>Content-Transfer-Encoding</tt>, <tt>Extensions</tt>, and
455
+ <tt>System</tt>.
456
+ </p>
457
+ <pre>
458
+ MIME::Type.from_hash('Content-Type' =&gt; 'text/x-yaml',
459
+ 'Content-Transfer-Encoding' =&gt; '8bit',
460
+ 'System' =&gt; 'linux',
461
+ 'Extensions' =&gt; ['yaml', 'yml'])
462
+ </pre>
463
+ <p>
464
+ This is equivalent to:
465
+ </p>
466
+ <pre>
467
+ MIME::Type.new('text/x-yaml') do |t|
468
+ t.encoding = '8bit'
469
+ t.system = 'linux'
470
+ t.extensions = ['yaml', 'yml']
471
+ end
472
+ </pre>
473
+ <p><a class="source-toggle" href="#"
474
+ onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
475
+ <div class="method-source-code" id="M000026-source">
476
+ <pre>
477
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 319</span>
478
+ 319: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">from_hash</span>(<span class="ruby-identifier">hash</span>) <span class="ruby-comment cmt">#:yields MIME::Type.new:</span>
479
+ 320: <span class="ruby-identifier">type</span> = {}
480
+ 321: <span class="ruby-identifier">hash</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
481
+ 322: <span class="ruby-identifier">type</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">tr</span>(<span class="ruby-value str">'-A-Z'</span>, <span class="ruby-value str">'_a-z'</span>).<span class="ruby-identifier">to_sym</span>] = <span class="ruby-identifier">v</span>
482
+ 323: <span class="ruby-keyword kw">end</span>
483
+ 324:
484
+ 325: <span class="ruby-identifier">m</span> = <span class="ruby-constant">MIME</span><span class="ruby-operator">::</span><span class="ruby-constant">Type</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">type</span>[<span class="ruby-identifier">:content_type</span>]) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
485
+ 326: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">extensions</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:extensions</span>]
486
+ 327: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">encoding</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:content_transfer_encoding</span>]
487
+ 328: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">system</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:system</span>]
488
+ 329: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">obsolete</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:obsolete</span>]
489
+ 330: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">docs</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:docs</span>]
490
+ 331: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">url</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:url</span>]
491
+ 332: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">registered</span> = <span class="ruby-identifier">type</span>[<span class="ruby-identifier">:registered</span>]
492
+ 333: <span class="ruby-keyword kw">end</span>
493
+ 334:
494
+ 335: <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">m</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
495
+ 336: <span class="ruby-identifier">m</span>
496
+ 337: <span class="ruby-keyword kw">end</span>
497
+ </pre>
498
+ </div>
499
+ </div>
500
+ </div>
501
+
502
+ <div id="method-M000027" class="method-detail">
503
+ <a name="M000027"></a>
504
+
505
+ <div class="method-heading">
506
+ <a href="#M000027" class="method-signature">
507
+ <span class="method-name">from_mime_type</span><span class="method-args">(mime_type) {|m if block_given?| ...}</span>
508
+ </a>
509
+ </div>
510
+
511
+ <div class="method-description">
512
+ <p>
513
+ Essentially a copy constructor.
514
+ </p>
515
+ <pre>
516
+ MIME::Type.from_mime_type(plaintext)
517
+ </pre>
518
+ <p>
519
+ is equivalent to:
520
+ </p>
521
+ <pre>
522
+ MIME::Type.new(plaintext.content_type.dup) do |t|
523
+ t.extensions = plaintext.extensions.dup
524
+ t.system = plaintext.system.dup
525
+ t.encoding = plaintext.encoding.dup
526
+ end
527
+ </pre>
528
+ <p><a class="source-toggle" href="#"
529
+ onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
530
+ <div class="method-source-code" id="M000027-source">
531
+ <pre>
532
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 350</span>
533
+ 350: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">from_mime_type</span>(<span class="ruby-identifier">mime_type</span>) <span class="ruby-comment cmt">#:yields the new MIME::Type:</span>
534
+ 351: <span class="ruby-identifier">m</span> = <span class="ruby-constant">MIME</span><span class="ruby-operator">::</span><span class="ruby-constant">Type</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">mime_type</span>.<span class="ruby-identifier">content_type</span>.<span class="ruby-identifier">dup</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
535
+ 352: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">extensions</span> = <span class="ruby-identifier">mime_type</span>.<span class="ruby-identifier">extensions</span>.<span class="ruby-identifier">dup</span>
536
+ 353: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">system</span> = <span class="ruby-identifier">mime_type</span>.<span class="ruby-identifier">system</span>.<span class="ruby-identifier">dup</span>
537
+ 354: <span class="ruby-identifier">t</span>.<span class="ruby-identifier">encoding</span> = <span class="ruby-identifier">mime_type</span>.<span class="ruby-identifier">encoding</span>.<span class="ruby-identifier">dup</span>
538
+ 355: <span class="ruby-keyword kw">end</span>
539
+ 356:
540
+ 357: <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">m</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
541
+ 358: <span class="ruby-keyword kw">end</span>
542
+ </pre>
543
+ </div>
544
+ </div>
545
+ </div>
546
+
547
+ <div id="method-M000028" class="method-detail">
548
+ <a name="M000028"></a>
549
+
550
+ <div class="method-heading">
551
+ <a href="#M000028" class="method-signature">
552
+ <span class="method-name">new</span><span class="method-args">(content_type) {|self if block_given?| ...}</span>
553
+ </a>
554
+ </div>
555
+
556
+ <div class="method-description">
557
+ <p>
558
+ Builds a <a href="Type.html">MIME::Type</a> object from the provided <a
559
+ href="../MIME.html">MIME</a> Content <a href="Type.html">Type</a> value
560
+ (e.g., &#8216;text/plain&#8217; or &#8216;applicaton/x-eruby&#8217;). The
561
+ constructed object is yielded to an optional block for additional
562
+ configuration, such as associating extensions and encoding information.
563
+ </p>
564
+ <p><a class="source-toggle" href="#"
565
+ onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
566
+ <div class="method-source-code" id="M000028-source">
567
+ <pre>
568
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 365</span>
569
+ 365: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">content_type</span>) <span class="ruby-comment cmt">#:yields self:</span>
570
+ 366: <span class="ruby-identifier">matchdata</span> = <span class="ruby-constant">MEDIA_TYPE_RE</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">content_type</span>)
571
+ 367:
572
+ 368: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">nil?</span>
573
+ 369: <span class="ruby-identifier">raise</span> <span class="ruby-constant">InvalidContentType</span>, <span class="ruby-node">&quot;Invalid Content-Type provided ('#{content_type}')&quot;</span>
574
+ 370: <span class="ruby-keyword kw">end</span>
575
+ 371:
576
+ 372: <span class="ruby-ivar">@content_type</span> = <span class="ruby-identifier">content_type</span>
577
+ 373: <span class="ruby-ivar">@raw_media_type</span> = <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">0</span>]
578
+ 374: <span class="ruby-ivar">@raw_sub_type</span> = <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">1</span>]
579
+ 375:
580
+ 376: <span class="ruby-ivar">@simplified</span> = <span class="ruby-constant">MIME</span><span class="ruby-operator">::</span><span class="ruby-constant">Type</span>.<span class="ruby-identifier">simplified</span>(<span class="ruby-ivar">@content_type</span>)
581
+ 377: <span class="ruby-identifier">matchdata</span> = <span class="ruby-constant">MEDIA_TYPE_RE</span>.<span class="ruby-identifier">match</span>(<span class="ruby-ivar">@simplified</span>)
582
+ 378: <span class="ruby-ivar">@media_type</span> = <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">0</span>]
583
+ 379: <span class="ruby-ivar">@sub_type</span> = <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">1</span>]
584
+ 380:
585
+ 381: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">extensions</span> = <span class="ruby-keyword kw">nil</span>
586
+ 382: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">encoding</span> = <span class="ruby-identifier">:default</span>
587
+ 383: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">system</span> = <span class="ruby-keyword kw">nil</span>
588
+ 384: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">registered</span> = <span class="ruby-keyword kw">true</span>
589
+ 385:
590
+ 386: <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
591
+ 387: <span class="ruby-keyword kw">end</span>
592
+ </pre>
593
+ </div>
594
+ </div>
595
+ </div>
596
+
597
+ <div id="method-M000024" class="method-detail">
598
+ <a name="M000024"></a>
599
+
600
+ <div class="method-heading">
601
+ <a href="#M000024" class="method-signature">
602
+ <span class="method-name">simplified</span><span class="method-args">(content_type)</span>
603
+ </a>
604
+ </div>
605
+
606
+ <div class="method-description">
607
+ <p>
608
+ The <a href="../MIME.html">MIME</a> types main- and sub-label can both
609
+ start with <tt>x-</tt>, which indicates that it is a non-registered name.
610
+ Of course, after registration this flag can disappear, adds to the
611
+ confusing proliferation of <a href="../MIME.html">MIME</a> types. The
612
+ simplified string has the <tt>x-</tt> removed and are translated to
613
+ lowercase.
614
+ </p>
615
+ <p><a class="source-toggle" href="#"
616
+ onclick="toggleCode('M000024-source');return false;">[Source]</a></p>
617
+ <div class="method-source-code" id="M000024-source">
618
+ <pre>
619
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 249</span>
620
+ 249: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">simplified</span>(<span class="ruby-identifier">content_type</span>)
621
+ 250: <span class="ruby-identifier">matchdata</span> = <span class="ruby-constant">MEDIA_TYPE_RE</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">content_type</span>)
622
+ 251:
623
+ 252: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">nil?</span>
624
+ 253: <span class="ruby-identifier">simplified</span> = <span class="ruby-keyword kw">nil</span>
625
+ 254: <span class="ruby-keyword kw">else</span>
626
+ 255: <span class="ruby-identifier">media_type</span> = <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-constant">UNREG_RE</span>, <span class="ruby-value str">''</span>)
627
+ 256: <span class="ruby-identifier">subtype</span> = <span class="ruby-identifier">matchdata</span>.<span class="ruby-identifier">captures</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-constant">UNREG_RE</span>, <span class="ruby-value str">''</span>)
628
+ 257: <span class="ruby-identifier">simplified</span> = <span class="ruby-node">&quot;#{media_type}/#{subtype}&quot;</span>
629
+ 258: <span class="ruby-keyword kw">end</span>
630
+ 259: <span class="ruby-identifier">simplified</span>
631
+ 260: <span class="ruby-keyword kw">end</span>
632
+ </pre>
633
+ </div>
634
+ </div>
635
+ </div>
636
+
637
+ <h3 class="section-bar">Public Instance methods</h3>
638
+
639
+ <div id="method-M000031" class="method-detail">
640
+ <a name="M000031"></a>
641
+
642
+ <div class="method-heading">
643
+ <a href="#M000031" class="method-signature">
644
+ <span class="method-name">ascii?</span><span class="method-args">()</span>
645
+ </a>
646
+ </div>
647
+
648
+ <div class="method-description">
649
+ <p>
650
+ <a href="../MIME.html">MIME</a> types can be specified to be sent across a
651
+ network in particular formats. This method returns <tt>false</tt> when the
652
+ <a href="../MIME.html">MIME</a> type encoding is set to <tt>base64</tt>.
653
+ </p>
654
+ <p><a class="source-toggle" href="#"
655
+ onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
656
+ <div class="method-source-code" id="M000031-source">
657
+ <pre>
658
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 413</span>
659
+ 413: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ascii?</span>
660
+ 414: <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">binary?</span>
661
+ 415: <span class="ruby-keyword kw">end</span>
662
+ </pre>
663
+ </div>
664
+ </div>
665
+ </div>
666
+
667
+ <div id="method-M000030" class="method-detail">
668
+ <a name="M000030"></a>
669
+
670
+ <div class="method-heading">
671
+ <a href="#M000030" class="method-signature">
672
+ <span class="method-name">binary?</span><span class="method-args">()</span>
673
+ </a>
674
+ </div>
675
+
676
+ <div class="method-description">
677
+ <p>
678
+ <a href="../MIME.html">MIME</a> types can be specified to be sent across a
679
+ network in particular formats. This method returns <tt>true</tt> when the
680
+ <a href="../MIME.html">MIME</a> type encoding is set to <tt>base64</tt>.
681
+ </p>
682
+ <p><a class="source-toggle" href="#"
683
+ onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
684
+ <div class="method-source-code" id="M000030-source">
685
+ <pre>
686
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 406</span>
687
+ 406: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">binary?</span>
688
+ 407: <span class="ruby-ivar">@encoding</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'base64'</span>
689
+ 408: <span class="ruby-keyword kw">end</span>
690
+ </pre>
691
+ </div>
692
+ </div>
693
+ </div>
694
+
695
+ <div id="method-M000035" class="method-detail">
696
+ <a name="M000035"></a>
697
+
698
+ <div class="method-heading">
699
+ <a href="#M000035" class="method-signature">
700
+ <span class="method-name">complete?</span><span class="method-args">()</span>
701
+ </a>
702
+ </div>
703
+
704
+ <div class="method-description">
705
+ <p>
706
+ Returns <tt>true</tt> if the <a href="Type.html">MIME::Type</a> specifies
707
+ an extension list, indicating that it is a complete <a
708
+ href="Type.html">MIME::Type</a>.
709
+ </p>
710
+ <p><a class="source-toggle" href="#"
711
+ onclick="toggleCode('M000035-source');return false;">[Source]</a></p>
712
+ <div class="method-source-code" id="M000035-source">
713
+ <pre>
714
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 436</span>
715
+ 436: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">complete?</span>
716
+ 437: <span class="ruby-keyword kw">not</span> <span class="ruby-ivar">@extensions</span>.<span class="ruby-identifier">empty?</span>
717
+ 438: <span class="ruby-keyword kw">end</span>
718
+ </pre>
719
+ </div>
720
+ </div>
721
+ </div>
722
+
723
+ <div id="method-M000019" class="method-detail">
724
+ <a name="M000019"></a>
725
+
726
+ <div class="method-heading">
727
+ <a href="#M000019" class="method-signature">
728
+ <span class="method-name">default_encoding</span><span class="method-args">()</span>
729
+ </a>
730
+ </div>
731
+
732
+ <div class="method-description">
733
+ <p><a class="source-toggle" href="#"
734
+ onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
735
+ <div class="method-source-code" id="M000019-source">
736
+ <pre>
737
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 165</span>
738
+ 165: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">default_encoding</span>
739
+ 166: (<span class="ruby-ivar">@media_type</span> <span class="ruby-operator">==</span> <span class="ruby-value str">'text'</span>) <span class="ruby-operator">?</span> <span class="ruby-value str">'quoted-printable'</span> <span class="ruby-operator">:</span> <span class="ruby-value str">'base64'</span>
740
+ 167: <span class="ruby-keyword kw">end</span>
741
+ </pre>
742
+ </div>
743
+ </div>
744
+ </div>
745
+
746
+ <div id="method-M000022" class="method-detail">
747
+ <a name="M000022"></a>
748
+
749
+ <div class="method-heading">
750
+ <a href="#M000022" class="method-signature">
751
+ <span class="method-name">docs=</span><span class="method-args">(d)</span>
752
+ </a>
753
+ </div>
754
+
755
+ <div class="method-description">
756
+ <p><a class="source-toggle" href="#"
757
+ onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
758
+ <div class="method-source-code" id="M000022-source">
759
+ <pre>
760
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 191</span>
761
+ 191: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">docs=</span>(<span class="ruby-identifier">d</span>)
762
+ 192: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">d</span>
763
+ 193: <span class="ruby-identifier">a</span> = <span class="ruby-identifier">d</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-node">%r{use-instead:#{MEDIA_TYPE_RE}}</span>)
764
+ 194:
765
+ 195: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">empty?</span>
766
+ 196: <span class="ruby-ivar">@use_instead</span> = <span class="ruby-keyword kw">nil</span>
767
+ 197: <span class="ruby-keyword kw">else</span>
768
+ 198: <span class="ruby-ivar">@use_instead</span> = <span class="ruby-identifier">a</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">el</span><span class="ruby-operator">|</span> <span class="ruby-node">&quot;#{el[0]}/#{el[1]}&quot;</span> }
769
+ 199: <span class="ruby-keyword kw">end</span>
770
+ 200: <span class="ruby-keyword kw">end</span>
771
+ 201: <span class="ruby-keyword kw">end</span>
772
+ </pre>
773
+ </div>
774
+ </div>
775
+ </div>
776
+
777
+ <div id="method-M000018" class="method-detail">
778
+ <a name="M000018"></a>
779
+
780
+ <div class="method-heading">
781
+ <a href="#M000018" class="method-signature">
782
+ <span class="method-name">like?</span><span class="method-args">(other)</span>
783
+ </a>
784
+ </div>
785
+
786
+ <div class="method-description">
787
+ <p>
788
+ Returns <tt>true</tt> if the simplified type matches the current
789
+ </p>
790
+ <p><a class="source-toggle" href="#"
791
+ onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
792
+ <div class="method-source-code" id="M000018-source">
793
+ <pre>
794
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 58</span>
795
+ 58: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">like?</span>(<span class="ruby-identifier">other</span>)
796
+ 59: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:simplified</span>)
797
+ 60: <span class="ruby-ivar">@simplified</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">other</span>.<span class="ruby-identifier">simplified</span>
798
+ 61: <span class="ruby-keyword kw">else</span>
799
+ 62: <span class="ruby-ivar">@simplified</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Type</span>.<span class="ruby-identifier">simplified</span>(<span class="ruby-identifier">other</span>)
800
+ 63: <span class="ruby-keyword kw">end</span>
801
+ 64: <span class="ruby-keyword kw">end</span>
802
+ </pre>
803
+ </div>
804
+ </div>
805
+ </div>
806
+
807
+ <div id="method-M000021" class="method-detail">
808
+ <a name="M000021"></a>
809
+
810
+ <div class="method-heading">
811
+ <a href="#M000021" class="method-signature">
812
+ <span class="method-name">obsolete?</span><span class="method-args">()</span>
813
+ </a>
814
+ </div>
815
+
816
+ <div class="method-description">
817
+ <p>
818
+ Returns <tt>true</tt> if the media type is obsolete.
819
+ </p>
820
+ <p><a class="source-toggle" href="#"
821
+ onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
822
+ <div class="method-source-code" id="M000021-source">
823
+ <pre>
824
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 180</span>
825
+ 180: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">obsolete?</span>
826
+ 181: <span class="ruby-ivar">@obsolete</span> <span class="ruby-operator">?</span> <span class="ruby-keyword kw">true</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">false</span>
827
+ 182: <span class="ruby-keyword kw">end</span>
828
+ </pre>
829
+ </div>
830
+ </div>
831
+ </div>
832
+
833
+ <div id="method-M000034" class="method-detail">
834
+ <a name="M000034"></a>
835
+
836
+ <div class="method-heading">
837
+ <a href="#M000034" class="method-signature">
838
+ <span class="method-name">platform?</span><span class="method-args">()</span>
839
+ </a>
840
+ </div>
841
+
842
+ <div class="method-description">
843
+ <p>
844
+ Returns <tt>true</tt> if the <a href="Type.html">MIME::Type</a> is specific
845
+ to the current operating system as represented by RUBY_PLATFORM.
846
+ </p>
847
+ <p><a class="source-toggle" href="#"
848
+ onclick="toggleCode('M000034-source');return false;">[Source]</a></p>
849
+ <div class="method-source-code" id="M000034-source">
850
+ <pre>
851
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 430</span>
852
+ 430: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">platform?</span>
853
+ 431: <span class="ruby-identifier">system?</span> <span class="ruby-keyword kw">and</span> (<span class="ruby-constant">RUBY_PLATFORM</span> <span class="ruby-operator">=~</span> <span class="ruby-ivar">@system</span>)
854
+ 432: <span class="ruby-keyword kw">end</span>
855
+ </pre>
856
+ </div>
857
+ </div>
858
+ </div>
859
+
860
+ <div id="method-M000029" class="method-detail">
861
+ <a name="M000029"></a>
862
+
863
+ <div class="method-heading">
864
+ <a href="#M000029" class="method-signature">
865
+ <span class="method-name">registered?</span><span class="method-args">()</span>
866
+ </a>
867
+ </div>
868
+
869
+ <div class="method-description">
870
+ <p>
871
+ <a href="../MIME.html">MIME</a> content-types which are not regestered by
872
+ IANA nor defined in RFCs are required to start with <tt>x-</tt>. This
873
+ counts as well for a new media type as well as a new sub-type of an
874
+ existing media type. If either the media-type or the content-type begins
875
+ with <tt>x-</tt>, this method will return <tt>false</tt>.
876
+ </p>
877
+ <p><a class="source-toggle" href="#"
878
+ onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
879
+ <div class="method-source-code" id="M000029-source">
880
+ <pre>
881
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 394</span>
882
+ 394: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">registered?</span>
883
+ 395: <span class="ruby-keyword kw">if</span> (<span class="ruby-ivar">@raw_media_type</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">UNREG_RE</span>) <span class="ruby-operator">||</span> (<span class="ruby-ivar">@raw_sub_type</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">UNREG_RE</span>)
884
+ 396: <span class="ruby-keyword kw">false</span>
885
+ 397: <span class="ruby-keyword kw">else</span>
886
+ 398: <span class="ruby-ivar">@registered</span>
887
+ 399: <span class="ruby-keyword kw">end</span>
888
+ 400: <span class="ruby-keyword kw">end</span>
889
+ </pre>
890
+ </div>
891
+ </div>
892
+ </div>
893
+
894
+ <div id="method-M000032" class="method-detail">
895
+ <a name="M000032"></a>
896
+
897
+ <div class="method-heading">
898
+ <a href="#M000032" class="method-signature">
899
+ <span class="method-name">signature?</span><span class="method-args">()</span>
900
+ </a>
901
+ </div>
902
+
903
+ <div class="method-description">
904
+ <p>
905
+ Returns <tt>true</tt> when the simplified <a href="../MIME.html">MIME</a>
906
+ type is in the list of known digital signatures.
907
+ </p>
908
+ <p><a class="source-toggle" href="#"
909
+ onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
910
+ <div class="method-source-code" id="M000032-source">
911
+ <pre>
912
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 419</span>
913
+ 419: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">signature?</span>
914
+ 420: <span class="ruby-constant">SIGNATURES</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-ivar">@simplified</span>.<span class="ruby-identifier">downcase</span>)
915
+ 421: <span class="ruby-keyword kw">end</span>
916
+ </pre>
917
+ </div>
918
+ </div>
919
+ </div>
920
+
921
+ <div id="method-M000033" class="method-detail">
922
+ <a name="M000033"></a>
923
+
924
+ <div class="method-heading">
925
+ <a href="#M000033" class="method-signature">
926
+ <span class="method-name">system?</span><span class="method-args">()</span>
927
+ </a>
928
+ </div>
929
+
930
+ <div class="method-description">
931
+ <p>
932
+ Returns <tt>true</tt> if the <a href="Type.html">MIME::Type</a> is specific
933
+ to an operating system.
934
+ </p>
935
+ <p><a class="source-toggle" href="#"
936
+ onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
937
+ <div class="method-source-code" id="M000033-source">
938
+ <pre>
939
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 424</span>
940
+ 424: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">system?</span>
941
+ 425: <span class="ruby-keyword kw">not</span> <span class="ruby-ivar">@system</span>.<span class="ruby-identifier">nil?</span>
942
+ 426: <span class="ruby-keyword kw">end</span>
943
+ </pre>
944
+ </div>
945
+ </div>
946
+ </div>
947
+
948
+ <div id="method-M000038" class="method-detail">
949
+ <a name="M000038"></a>
950
+
951
+ <div class="method-heading">
952
+ <a href="#M000038" class="method-signature">
953
+ <span class="method-name">to_a</span><span class="method-args">()</span>
954
+ </a>
955
+ </div>
956
+
957
+ <div class="method-description">
958
+ <p>
959
+ Returns the <a href="../MIME.html">MIME</a> type as an array suitable for
960
+ use with <a href="Type.html#M000025">MIME::Type.from_array</a>.
961
+ </p>
962
+ <p><a class="source-toggle" href="#"
963
+ onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
964
+ <div class="method-source-code" id="M000038-source">
965
+ <pre>
966
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 452</span>
967
+ 452: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_a</span>
968
+ 453: [ <span class="ruby-ivar">@content_type</span>, <span class="ruby-ivar">@extensions</span>, <span class="ruby-ivar">@encoding</span>, <span class="ruby-ivar">@system</span>, <span class="ruby-ivar">@obsolete</span>, <span class="ruby-ivar">@docs</span>,
969
+ 454: <span class="ruby-ivar">@url</span>, <span class="ruby-identifier">registered?</span> ]
970
+ 455: <span class="ruby-keyword kw">end</span>
971
+ </pre>
972
+ </div>
973
+ </div>
974
+ </div>
975
+
976
+ <div id="method-M000039" class="method-detail">
977
+ <a name="M000039"></a>
978
+
979
+ <div class="method-heading">
980
+ <a href="#M000039" class="method-signature">
981
+ <span class="method-name">to_hash</span><span class="method-args">()</span>
982
+ </a>
983
+ </div>
984
+
985
+ <div class="method-description">
986
+ <p>
987
+ Returns the <a href="../MIME.html">MIME</a> type as an array suitable for
988
+ use with <a href="Type.html#M000026">MIME::Type.from_hash</a>.
989
+ </p>
990
+ <p><a class="source-toggle" href="#"
991
+ onclick="toggleCode('M000039-source');return false;">[Source]</a></p>
992
+ <div class="method-source-code" id="M000039-source">
993
+ <pre>
994
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 459</span>
995
+ 459: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_hash</span>
996
+ 460: { <span class="ruby-value str">'Content-Type'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@content_type</span>,
997
+ 461: <span class="ruby-value str">'Content-Transfer-Encoding'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@encoding</span>,
998
+ 462: <span class="ruby-value str">'Extensions'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@extensions</span>,
999
+ 463: <span class="ruby-value str">'System'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@system</span>,
1000
+ 464: <span class="ruby-value str">'Obsolete'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@obsolete</span>,
1001
+ 465: <span class="ruby-value str">'Docs'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@docs</span>,
1002
+ 466: <span class="ruby-value str">'URL'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@url</span>,
1003
+ 467: <span class="ruby-value str">'Registered'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">registered?</span>,
1004
+ 468: }
1005
+ 469: <span class="ruby-keyword kw">end</span>
1006
+ </pre>
1007
+ </div>
1008
+ </div>
1009
+ </div>
1010
+
1011
+ <div id="method-M000036" class="method-detail">
1012
+ <a name="M000036"></a>
1013
+
1014
+ <div class="method-heading">
1015
+ <a href="#M000036" class="method-signature">
1016
+ <span class="method-name">to_s</span><span class="method-args">()</span>
1017
+ </a>
1018
+ </div>
1019
+
1020
+ <div class="method-description">
1021
+ <p>
1022
+ Returns the <a href="../MIME.html">MIME</a> type as a string.
1023
+ </p>
1024
+ <p><a class="source-toggle" href="#"
1025
+ onclick="toggleCode('M000036-source');return false;">[Source]</a></p>
1026
+ <div class="method-source-code" id="M000036-source">
1027
+ <pre>
1028
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 441</span>
1029
+ 441: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
1030
+ 442: <span class="ruby-ivar">@content_type</span>
1031
+ 443: <span class="ruby-keyword kw">end</span>
1032
+ </pre>
1033
+ </div>
1034
+ </div>
1035
+ </div>
1036
+
1037
+ <div id="method-M000037" class="method-detail">
1038
+ <a name="M000037"></a>
1039
+
1040
+ <div class="method-heading">
1041
+ <a href="#M000037" class="method-signature">
1042
+ <span class="method-name">to_str</span><span class="method-args">()</span>
1043
+ </a>
1044
+ </div>
1045
+
1046
+ <div class="method-description">
1047
+ <p>
1048
+ Returns the <a href="../MIME.html">MIME</a> type as a string for implicit
1049
+ conversions.
1050
+ </p>
1051
+ <p><a class="source-toggle" href="#"
1052
+ onclick="toggleCode('M000037-source');return false;">[Source]</a></p>
1053
+ <div class="method-source-code" id="M000037-source">
1054
+ <pre>
1055
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 446</span>
1056
+ 446: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_str</span>
1057
+ 447: <span class="ruby-ivar">@content_type</span>
1058
+ 448: <span class="ruby-keyword kw">end</span>
1059
+ </pre>
1060
+ </div>
1061
+ </div>
1062
+ </div>
1063
+
1064
+ <div id="method-M000023" class="method-detail">
1065
+ <a name="M000023"></a>
1066
+
1067
+ <div class="method-heading">
1068
+ <a href="#M000023" class="method-signature">
1069
+ <span class="method-name">urls</span><span class="method-args">()</span>
1070
+ </a>
1071
+ </div>
1072
+
1073
+ <div class="method-description">
1074
+ <p>
1075
+ The decoded URL list for this <a href="Type.html">MIME::Type</a>. The
1076
+ special URL value IANA will be translated into:
1077
+ </p>
1078
+ <pre>
1079
+ http://www.iana.org/assignments/media-types/&lt;mediatype&gt;/&lt;subtype&gt;
1080
+ </pre>
1081
+ <p>
1082
+ The special URL value RFC### will be translated into:
1083
+ </p>
1084
+ <pre>
1085
+ http://www.rfc-editor.org/rfc/rfc###.txt
1086
+ </pre>
1087
+ <p>
1088
+ The special URL value DRAFT:name will be translated into:
1089
+ </p>
1090
+ <pre>
1091
+ https://datatracker.ietf.org/public/idindex.cgi?
1092
+ command=id_detail&amp;filename=&lt;name&gt;
1093
+ </pre>
1094
+ <p>
1095
+ The special URL value LTSW will be translated into:
1096
+ </p>
1097
+ <pre>
1098
+ http://www.ltsw.se/knbase/internet/&lt;mediatype&gt;.htp
1099
+ </pre>
1100
+ <p>
1101
+ The special URL value [token] will be translated into:
1102
+ </p>
1103
+ <pre>
1104
+ http://www.iana.org/assignments/contact-people.htm#&lt;token&gt;
1105
+ </pre>
1106
+ <p>
1107
+ These values will be accessible through url, which always returns an array.
1108
+ </p>
1109
+ <p><a class="source-toggle" href="#"
1110
+ onclick="toggleCode('M000023-source');return false;">[Source]</a></p>
1111
+ <div class="method-source-code" id="M000023-source">
1112
+ <pre>
1113
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 224</span>
1114
+ 224: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">urls</span>
1115
+ 225: <span class="ruby-ivar">@url</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">el</span><span class="ruby-operator">|</span>
1116
+ 226: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">el</span>
1117
+ 227: <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">%r{^IANA$}</span>
1118
+ 228: <span class="ruby-constant">IANA_URL</span> <span class="ruby-operator">%</span> [ <span class="ruby-ivar">@media_type</span>, <span class="ruby-ivar">@sub_type</span> ]
1119
+ 229: <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">%r{^RFC(\d+)$}</span>
1120
+ 230: <span class="ruby-constant">RFC_URL</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">$1</span>
1121
+ 231: <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">%r{^DRAFT:(.+)$}</span>
1122
+ 232: <span class="ruby-constant">DRAFT_URL</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">$1</span>
1123
+ 233: <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">%r{^LTSW$}</span>
1124
+ 234: <span class="ruby-constant">LTSW_URL</span> <span class="ruby-operator">%</span> <span class="ruby-ivar">@media_type</span>
1125
+ 235: <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">%r{^\[([^\]]+)\]}</span>
1126
+ 236: <span class="ruby-constant">CONTACT_URL</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">$1</span>
1127
+ 237: <span class="ruby-keyword kw">else</span>
1128
+ 238: <span class="ruby-identifier">el</span>
1129
+ 239: <span class="ruby-keyword kw">end</span>
1130
+ 240: }
1131
+ 241: <span class="ruby-keyword kw">end</span>
1132
+ </pre>
1133
+ </div>
1134
+ </div>
1135
+ </div>
1136
+
1137
+ <div id="method-M000020" class="method-detail">
1138
+ <a name="M000020"></a>
1139
+
1140
+ <div class="method-heading">
1141
+ <a href="#M000020" class="method-signature">
1142
+ <span class="method-name">use_instead</span><span class="method-args">()</span>
1143
+ </a>
1144
+ </div>
1145
+
1146
+ <div class="method-description">
1147
+ <p><a class="source-toggle" href="#"
1148
+ onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
1149
+ <div class="method-source-code" id="M000020-source">
1150
+ <pre>
1151
+ <span class="ruby-comment cmt"># File lib/s33r/mimetypes.rb, line 174</span>
1152
+ 174: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">use_instead</span>
1153
+ 175: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@obsolete</span>
1154
+ 176: <span class="ruby-ivar">@use_instead</span>
1155
+ 177: <span class="ruby-keyword kw">end</span>
1156
+ </pre>
1157
+ </div>
1158
+ </div>
1159
+ </div>
1160
+
1161
+
1162
+ </div>
1163
+
1164
+
1165
+ </div>
1166
+
1167
+
1168
+ <div id="validator-badges">
1169
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
1170
+ </div>
1171
+
1172
+ </body>
1173
+ </html>