gravaty 10.0.0 → 11.0.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (100) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG +7 -0
  3. data/Gemfile +5 -1
  4. data/README.md +219 -212
  5. data/Rakefile +9 -3
  6. data/copyright.md +33 -136
  7. data/examples/avatar.rb +70 -43
  8. data/examples/basics.rb +30 -20
  9. data/examples/profile.rb +77 -50
  10. data/examples/xmlrpc.rb +24 -10
  11. data/gravaty.gemspec +46 -25
  12. data/html/CHANGELOG.html +13 -20
  13. data/html/COPYING_md.html +8 -24
  14. data/html/Gemfile.html +7 -21
  15. data/html/Gravaty.html +49 -113
  16. data/html/Gravaty/Gravaty.html +138 -343
  17. data/html/Gravaty/ParsableDuckType.html +14 -33
  18. data/html/Gravaty/Parser.html +27 -66
  19. data/html/Gravaty/Parsers.html +3 -11
  20. data/html/Gravaty/Parsers/Avatar.html +19 -36
  21. data/html/Gravaty/Parsers/Callback.html +21 -37
  22. data/html/Gravaty/Parsers/Default.html +28 -45
  23. data/html/Gravaty/Parsers/Force.html +21 -37
  24. data/html/Gravaty/Parsers/Format.html +22 -42
  25. data/html/Gravaty/Parsers/Pixelsize.html +22 -42
  26. data/html/Gravaty/Parsers/Rating.html +22 -42
  27. data/html/Gravaty/Parsers/Secure.html +19 -36
  28. data/html/Gravaty/Parsers/Type.html +22 -42
  29. data/html/Gravaty/Utils.html +11 -13
  30. data/html/Gravaty/Utils/Downloader.html +3 -11
  31. data/html/Gravaty/Utils/Downloader/Downloader.html +25 -59
  32. data/html/Gravaty/Utils/Raisers.html +24 -55
  33. data/html/Gravaty/Utils/Rfc5322.html +12 -19
  34. data/html/Gravaty/Utils/RpcConnector.html +11 -13
  35. data/html/Gravaty/Utils/RpcConnector/RpcConnector.html +33 -73
  36. data/html/Object.html +728 -57
  37. data/html/README_md.html +105 -100
  38. data/html/Rakefile.html +9 -23
  39. data/html/copyright_md.html +17 -119
  40. data/html/created.rid +48 -55
  41. data/html/css/rdoc.css +1 -1
  42. data/html/index.html +97 -114
  43. data/html/js/navigation.js.gz +0 -0
  44. data/html/js/search_index.js +1 -1
  45. data/html/js/search_index.js.gz +0 -0
  46. data/html/js/searcher.js.gz +0 -0
  47. data/html/table_of_contents.html +219 -651
  48. data/lib/gravaty.rb +22 -15
  49. data/lib/gravaty/application.rb +40 -25
  50. data/lib/gravaty/constants.rb +20 -11
  51. data/lib/gravaty/locales/en.yml +9 -3
  52. data/lib/gravaty/locales/it.yml +9 -3
  53. data/lib/gravaty/locales/ja.yml +7 -4
  54. data/lib/gravaty/parser.rb +16 -10
  55. data/lib/gravaty/parsers/avatar.rb +11 -3
  56. data/lib/gravaty/parsers/callback.rb +13 -4
  57. data/lib/gravaty/parsers/default.rb +24 -16
  58. data/lib/gravaty/parsers/force.rb +12 -2
  59. data/lib/gravaty/parsers/format.rb +11 -2
  60. data/lib/gravaty/parsers/pixelsize.rb +12 -3
  61. data/lib/gravaty/parsers/rating.rb +12 -3
  62. data/lib/gravaty/parsers/secure.rb +11 -2
  63. data/lib/gravaty/parsers/type.rb +11 -2
  64. data/lib/gravaty/utils/downloader.rb +98 -96
  65. data/lib/gravaty/utils/raisers.rb +19 -12
  66. data/lib/gravaty/utils/rfc5322.rb +54 -41
  67. data/lib/gravaty/utils/rpc_connector.rb +19 -11
  68. data/lib/gravaty/version.rb +10 -2
  69. data/test/gravaty/locales/en.yml +29 -0
  70. data/test/gravaty/locales/it.yml +29 -0
  71. data/test/gravaty/locales/ja.yml +27 -0
  72. data/test/gravaty/locales/test_locales.rb +17 -13
  73. data/test/gravaty/parsers/test_avatar.rb +9 -1
  74. data/test/gravaty/parsers/test_callback.rb +12 -4
  75. data/test/gravaty/parsers/test_default.rb +25 -21
  76. data/test/gravaty/parsers/test_force.rb +9 -1
  77. data/test/gravaty/parsers/test_format.rb +18 -11
  78. data/test/gravaty/parsers/test_pixelsize.rb +19 -12
  79. data/test/gravaty/parsers/test_rating.rb +18 -11
  80. data/test/gravaty/parsers/test_secure.rb +9 -1
  81. data/test/gravaty/parsers/test_type.rb +14 -5
  82. data/test/gravaty/test_application.rb +14 -6
  83. data/test/gravaty/test_avatar.rb +94 -59
  84. data/test/gravaty/test_parser.rb +11 -5
  85. data/test/gravaty/test_profile.rb +47 -25
  86. data/test/gravaty/utils/test_downloader.rb +43 -28
  87. data/test/gravaty/utils/test_raisers.rb +42 -26
  88. data/test/gravaty/utils/test_rfc5322.rb +35 -13
  89. data/test/gravaty/utils/test_rpc_connector.rb +83 -39
  90. data/test/test_gravaty.rb +12 -4
  91. data/test/test_helper.rb +15 -9
  92. metadata +54 -40
  93. data/ISSUES.md +0 -62
  94. data/acknowledgements.md +0 -66
  95. data/authors.md +0 -63
  96. data/examples/cacert.pem +0 -3466
  97. data/html/ISSUES_md.html +0 -166
  98. data/html/acknowledgements_md.html +0 -161
  99. data/html/authors_md.html +0 -174
  100. data/html/examples/cacert_pem.html +0 -1078
data/html/README_md.html CHANGED
@@ -4,7 +4,7 @@
4
4
  <head>
5
5
  <meta charset="UTF-8">
6
6
 
7
- <title>README - gravaty 10.0.0</title>
7
+ <title>README - gravaty 11.0.1</title>
8
8
 
9
9
  <script type="text/javascript">
10
10
  var rdoc_rel_prefix = "./";
@@ -21,8 +21,6 @@
21
21
  <link href="./css/rdoc.css" rel="stylesheet">
22
22
 
23
23
 
24
-
25
-
26
24
  <body id="top" role="document" class="file">
27
25
  <nav role="navigation">
28
26
  <div id="project-navigation">
@@ -61,49 +59,32 @@
61
59
 
62
60
  <ul class="link-list" role="directory">
63
61
  <li><a href="#label-Gravaty">Gravaty</a>
64
- <li><a href="#label-Description">Description</a>
65
- <li><a href="#label-Documentation">Documentation</a>
66
- <li><a href="#label-Installing+Gravaty">Installing Gravaty</a>
67
- <li><a href="#label-Supported+Ruby+Versions+and+Implementations">Supported Ruby Versions and Implementations</a>
68
- <li><a href="#label-Support">Support</a>
69
- <li><a href="#label-Contributing">Contributing</a>
70
- <li><a href="#label-License">License</a>
71
- <li><a href="#label-Links">Links</a>
62
+ <li><a href="#label-Table+of+Contents">Table of Contents</a>
63
+ <li><a href="#label-Background">Background</a>
64
+ <li><a href="#label-Install">Install</a>
72
65
  <li><a href="#label-Savannah">Savannah</a>
73
66
  <li><a href="#label-RubyGems">RubyGems</a>
74
- <li><a href="#label-Other+links">Other links</a>
75
- <li><a href="#label-Usage+Examples">Usage Examples</a>
76
- <li><a href="#label-Gravatar+Terms+of+Service">Gravatar Terms of Service</a>
67
+ <li><a href="#label-Usage">Usage</a>
68
+ <li><a href="#label-Maintainers">Maintainers</a>
69
+ <li><a href="#label-Thanks">Thanks</a>
70
+ <li><a href="#label-Contributing">Contributing</a>
71
+ <li><a href="#label-License">License</a>
77
72
  </ul>
78
73
  </div>
79
74
 
80
75
 
81
76
  <div id="project-metadata">
82
- <div id="fileindex-section" class="nav-section">
77
+
78
+ <div id="fileindex-section" class="nav-section">
83
79
  <h3>Pages</h3>
84
80
 
85
81
  <ul class="link-list">
86
-
87
82
  <li><a href="./CHANGELOG.html">CHANGELOG</a>
88
-
89
83
  <li><a href="./COPYING_md.html">COPYING</a>
90
-
91
84
  <li><a href="./Gemfile.html">Gemfile</a>
92
-
93
- <li><a href="./ISSUES_md.html">ISSUES</a>
94
-
95
85
  <li><a href="./README_md.html">README</a>
96
-
97
86
  <li><a href="./Rakefile.html">Rakefile</a>
98
-
99
- <li><a href="./acknowledgements_md.html">acknowledgements</a>
100
-
101
- <li><a href="./authors_md.html">authors</a>
102
-
103
87
  <li><a href="./copyright_md.html">copyright</a>
104
-
105
- <li><a href="./examples/cacert_pem.html">cacert.pem</a>
106
-
107
88
  </ul>
108
89
  </div>
109
90
 
@@ -114,7 +95,7 @@
114
95
  <!--
115
96
  gravaty
116
97
 
117
- Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani
98
+ Copyright © 2013-2021 Marco Bresciani
118
99
 
119
100
  This file is part of gravaty.
120
101
 
@@ -130,78 +111,69 @@ more details.
130
111
 
131
112
  You should have received a copy of the GNU General Public License along
132
113
  with gravaty. If not, see <http://www.gnu.org/licenses/>.
133
- -->
134
- <h1 id="label-Gravaty"><a href="Gravaty.html"><code>Gravaty</code></a><span><a href="#label-Gravaty">&para;</a> <a href="#top">&uarr;</a></span></h1>
135
-
136
- <p><img src="https://img.shields.io/gem/v/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/dt/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/dtv/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/rt/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/rd/gravaty.svg?style=plastic"> <img src="https://img.shields.io/librariesio/dependent-repos/rubygems/gravaty.svg?style=plastic"></p>
137
114
 
138
- <p>Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani</p>
115
+ SPDX-FileCopyrightText: 2013 Marco Bresciani
139
116
 
140
- <p>This file is part of gravaty.</p>
117
+ SPDX-License-Identifier: GFDL-1.3-or-later
118
+ -->
119
+ <h1 id="label-Gravaty"><a href="Gravaty.html"><code>Gravaty</code></a><span><a href="#label-Gravaty">&para;</a> <a href="#top">&uarr;</a></span></h1>
141
120
 
142
- <p>gravaty is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
121
+ <p><img src="https://badgen.net/rubygems/n/gravaty"> <img src="https://badgen.net/rubygems/p/gravaty"> <img src="https://badgen.net/rubygems/v/gravaty"> <img src="https://badgen.net/rubygems/v/gravaty/latest"> <img src="https://badgen.net/rubygems/dt/gravaty"> <img src="https://badgen.net/rubygems/dv/gravaty"></p>
143
122
 
144
- <p>gravaty is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
123
+ <p><img src="https://img.shields.io/gem/rt/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/rd/gravaty.svg?style=plastic"> <img src="https://img.shields.io/librariesio/dependent-repos/rubygems/gravaty.svg?style=plastic"> <img src="https://img.shields.io/gem/u/MarcoBresciani?style=plastic"> <img src="https://img.shields.io/security-headers?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"> <img src="https://img.shields.io/hsts/preload/savannah.nongnu.org?style=plastic"> <img src="https://img.shields.io/mozilla-observatory/grade/savannah.nongnu.org?publish&style=plastic"> <img src="https://img.shields.io/website?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"></p>
145
124
 
146
- <p>You should have received a copy of the GNU General Public License along with gravaty. If not, see <a href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/.</p>
125
+ <p><img src="https://img.shields.io/security-headers?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"> <img src="https://img.shields.io/hsts/preload/savannah.nongnu.org?style=plastic"> <img src="https://img.shields.io/mozilla-observatory/grade/savannah.nongnu.org?publish&style=plastic"> <img src="https://img.shields.io/website?style=plastic&url=https%3A%2F%2Fsavannah.nongnu.org%2Fprojects%2Faamfp"></p>
147
126
 
148
- <h2 id="label-Description">Description<span><a href="#label-Description">&para;</a> <a href="#top">&uarr;</a></span></h2>
127
+ <p><a href="https://github.com/RichardLitt/standard-readme"><img src="https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=plastic"></a> <a href="https://github.com/rubocop-hq/rubocop"><img src="https://img.shields.io/badge/code_style-rubocop-brightgreen.svg"></a> <a href="https://rubystyle.guide"><img src="https://img.shields.io/badge/code_style-community-brightgreen.svg"></a> <a href="https://api.reuse.software/info/git.fsfe.org/reuse/api"><img src="https://api.reuse.software/badge/git.fsfe.org/reuse/api"></a></p>
149
128
 
150
129
  <p>This gem automagically prepares complete URIs for Gravatar, for both avatars and profiles, with all currently supported options, included the XML-RPC API, as of 2019-04-23, starting from a single email address!</p>
151
130
 
152
- <p>It&#39;s my first &#39;real&#39; Ruby gem, hoping it will be useful for someone (let me know if you use it, please!).</p>
153
-
154
- <p>GNU GPLv3 license; source code available through anonymous checkout: <code>hg clone http://hg.savannah.nongnu.org/hgweb/gravaty/</code> or write me and I&#39;ll send it.</p>
131
+ <p>It&#39;s my first Ruby gem, hoping it will be useful for someone (let me know if you use it, please!). GNU GPLv3 license; source code available through anonymous checkout: <code>hg clone http://hg.savannah.nongnu.org/hgweb/gravaty/</code> or write me, and I&#39;ll send it. You can even decide to contribute to this little free software project by registering to Savannah and ask to be part of the <code>gravaty</code> project!</p>
155
132
 
156
- <p>You can even decide to contribute to this little free software project by registering to Savannah and ask to be part of the &#39;gravaty&#39; project!</p>
133
+ <h2 id="label-Table+of+Contents">Table of Contents<span><a href="#label-Table+of+Contents">&para;</a> <a href="#top">&uarr;</a></span></h2>
134
+ <ul><li>
135
+ <p><a href="#background">Background</a></p>
136
+ </li><li>
137
+ <p><a href="#install">Install</a></p>
138
+ </li><li>
139
+ <p><a href="#savannah">Savannah</a></p>
140
+ </li><li>
141
+ <p><a href="#rubygems">RubyGems</a></p>
142
+ </li><li>
143
+ <p><a href="#usage">Usage</a></p>
144
+ </li><li>
145
+ <p><a href="#maintainers">Maintainers</a></p>
146
+ </li><li>
147
+ <p><a href="#thanks">Thanks</a></p>
148
+ </li><li>
149
+ <p><a href="#contributing">Contributing</a></p>
150
+ </li><li>
151
+ <p><a href="#license">License</a></p>
152
+ </li></ul>
157
153
 
158
- <p>With great contributions from: 新部裕, Peter R. Marreck, Jon Maken, Łukasz Niemier.</p>
154
+ <h2 id="label-Background">Background<span><a href="#label-Background">&para;</a> <a href="#top">&uarr;</a></span></h2>
159
155
 
160
- <h2 id="label-Documentation">Documentation<span><a href="#label-Documentation">&para;</a> <a href="#top">&uarr;</a></span></h2>
156
+ <p>This gem automagically prepares complete URIs for Gravatar, for both avatars and profiles, with all currently supported options, included the XML-RPC API, as of 2019-04-23, starting from a single email address!</p>
161
157
 
162
- <p><a href="Gravaty.html"><code>Gravaty</code></a> tries to follow semantic versioning (see <a href="http://semver.org">semver.org</a>/). There may be backward incompatible changes each time minor version number changes, but that any tiny version number change should be bug fixes and internal changes only. Be sure to read the <a href="CHANGELOG.html">CHANGELOG</a> each time we cut a new release and lock your gems accordingly.</p>
158
+ <p>It&#39;s my first Ruby gem, hoping it will be useful for someone (let me know if you use it, please!).</p>
163
159
 
164
- <p>RDoc documentation available in the html folder.</p>
160
+ <p>GNU GPLv3 license; source code available through anonymous checkout: <code>hg clone http://hg.savannah.nongnu.org/hgweb/gravaty/</code> or write me, and I&#39;ll send it.</p>
165
161
 
166
- <h3 id="label-Installing+Gravaty">Installing <a href="Gravaty.html"><code>Gravaty</code></a><span><a href="#label-Installing+Gravaty">&para;</a> <a href="#top">&uarr;</a></span></h3>
162
+ <p>You can even decide to contribute to this little free software project by registering to Savannah and ask to be part of the <code>gravaty</code> project!</p>
167
163
 
168
- <p>RubyGems is the preferred easy install method for <a href="Gravaty.html"><code>Gravaty</code></a>. <a href="Gravaty.html"><code>Gravaty</code></a> is intended to be installed via the <a href="http://rubyforge.org/projects/rubygems/">RubyGems</a> system. To get the latest version, simply enter the following into your command prompt: <code>gem install gravaty</code>.</p>
164
+ <p>With great contributions from: 新部裕, Peter R. Marreck, Jon Maken, Łukasz Niemier.</p>
169
165
 
170
- <p><em>NOTE</em>: for both examples and tests, you may need to set a SSL certificate file. In Microsoft Windows environment, the easiest way is as described by the downloader gist. You have to download the certificates from <a href="http://curl.haxx.se/ca/cacert.pem">curl.haxx.se/ca/cacert.pem</a> (for example) and, for example, put the cacert.pem file in the gravaty home directory. Then <code>set SSL_CERT_FILE=</code>{FULL_PATH}<code>\cacert.pem</code> and finally try to run <code>ruby avatar.rb</code> or <code>ruby profiles.rb</code> from the <code>examples</code> directory; both examples should download two files each! The same environment variable would be needed to run the tests against the XML-RPC API.</p>
166
+ <h2 id="label-Install">Install<span><a href="#label-Install">&para;</a> <a href="#top">&uarr;</a></span></h2>
171
167
 
172
- <h3 id="label-Supported+Ruby+Versions+and+Implementations">Supported Ruby Versions and Implementations<span><a href="#label-Supported+Ruby+Versions+and+Implementations">&para;</a> <a href="#top">&uarr;</a></span></h3>
168
+ <p>RubyGems is the preferred easy install method for <a href="Gravaty.html"><code>Gravaty</code></a>. <a href="Gravaty.html"><code>Gravaty</code></a> should be installed via the <a href="http://rubyforge.org/projects/rubygems/">RubyGems</a> system. To get the latest version, simply enter the following into your command prompt: <code>gem install gravaty</code>.</p>
173
169
 
174
170
  <p>Because <a href="Gravaty.html"><code>Gravaty</code></a> is pure Ruby, it should run pretty much anywhere, including Rubinius, JRuby, MacRuby, etc. Officially the support is for &gt;= 2.7 YARV/KRI.</p>
175
171
 
176
- <h3 id="label-Support">Support<span><a href="#label-Support">&para;</a> <a href="#top">&uarr;</a></span></h3>
177
-
178
- <p>The easiest way to get help with <a href="Gravaty.html"><code>Gravaty</code></a> is to post a message to the mailing list: <code>http://lists.nongnu.org/mailman/listinfo/gravaty-users</code>.</p>
179
-
180
- <p>Feel free to post any question there, developers are responsive and will be happy to help you figure out how to use <a href="Gravaty.html"><code>Gravaty</code></a>, or help you determine whether it&#39;s the right tool for the task you are working on.</p>
181
-
182
- <p>Please make your posts to the list as specific as possible, including code samples and output where relevant. Do not post any information that should not be shared publicly, and be sure to reduce your example code as much as possible so that those who are responding to your question can more easily see what the issue might be.</p>
183
-
184
- <h3 id="label-Contributing">Contributing<span><a href="#label-Contributing">&para;</a> <a href="#top">&uarr;</a></span></h3>
185
-
186
- <p>If you&#39;ve found a bug, want to submit a patch, or have a feature request, please enter a ticket into our bug tracker: <code>https://savannah.nongnu.org/bugs/?func=additem&group=gravaty</code>.</p>
187
-
188
- <p>We strongly encourage bug reports to come with failing tests or at least a reduced example that demonstrates the problem.</p>
189
-
190
- <p>Similarly, patches should include tests, API documentation, and an update to the manual where relevant. Feel free to clone early though and participate in the project, if you just want some feedback or a code review before preparing your code to be merged.</p>
191
-
192
- <p>If you are unsure about whether or not you&#39;ve found a bug, or want to check to see whether we&#39;d be interested in the feature you want to add before you start working on it, feel free to post to our mailing list.</p>
193
-
194
- <h3 id="label-License">License<span><a href="#label-License">&para;</a> <a href="#top">&uarr;</a></span></h3>
195
-
196
- <p><a href="Gravaty.html"><code>Gravaty</code></a> is released under GNU GPL v3 license: if you wish to contribute to <a href="Gravaty.html"><code>Gravaty</code></a>, you will retain your own <a href="copyright_md.html">copyright</a> but must agree to license your code under the same terms as the project itself (or any compatible license according to <a href="http://www.gnu.org/licenses/license-list.en.html#GPLCompatibleLicenses">GPL-Compatible Free Software Licenses</a>).</p>
197
-
198
- <h3 id="label-Links">Links<span><a href="#label-Links">&para;</a> <a href="#top">&uarr;</a></span></h3>
199
-
200
172
  <h4 id="label-Savannah">Savannah<span><a href="#label-Savannah">&para;</a> <a href="#top">&uarr;</a></span></h4>
201
173
  <ul><li>
202
174
  <p>Project page: <a href="https://savannah.nongnu.org/projects/gravaty">savannah.nongnu.org/projects/gravaty</a>/</p>
203
175
  </li><li>
204
- <p>Source code (Mercurial) repository: <a href="http://hg.savannah.gnu.org/hgweb/gravaty">hg.savannah.gnu.org/hgweb/gravaty</a>/</p>
176
+ <p>Source code (Mercurial) repository: <a href="http://hg.savannah.gnu.org/hgweb/gravaty">hg.savannah.gnu.org/hgweb/gravaty</a>/</p>
205
177
  </li><li>
206
178
  <p>Known Bugs: <a href="https://savannah.nongnu.org/bugs/?group=gravaty">savannah.nongnu.org/bugs/?group=gravaty</a></p>
207
179
  </li><li>
@@ -219,42 +191,75 @@ with gravaty. If not, see <http://www.gnu.org/licenses/>.
219
191
  <p>Gem updates Atom Feed: <a href="https://rubygems.org/gems/gravaty/versions.atom">rubygems.org/gems/gravaty/versions.atom</a></p>
220
192
  </li></ul>
221
193
 
222
- <h4 id="label-Other+links">Other links<span><a href="#label-Other+links">&para;</a> <a href="#top">&uarr;</a></span></h4>
194
+ <h2 id="label-Usage">Usage<span><a href="#label-Usage">&para;</a> <a href="#top">&uarr;</a></span></h2>
195
+
196
+ <p>See <code>examples</code> folder. To run the examples just run <code>ruby</code>{EXAMPLE_NAME}<code>.rb</code>.</p>
197
+
198
+ <blockquote>
199
+ <p><strong>NOTE</strong>: for both examples and tests, you need to set a SSL certificate file. In Microsoft Windows environment, the easiest way is the one described by the downloader gist I&#39;m using: you can download valid certificates from <a href="http://curl.haxx.se/ca/cacert.pem">curl.haxx.se/ca/cacert.pem</a> and put the downloaded file in the gravaty home directory. Then <code>set SSL_CERT_FILE=</code>{FULL FILE PATH HERE}<code>cacert.pem</code> and finally run <code>ruby avatar.rb</code> or <code>ruby profiles.rb</code> from the <code>examples</code> directory; both examples should download two files each! The same environment variable would be needed to run the tests against the XML-RPC API. Running the examples you&#39;ll see both the example description and correct code usage to perform such action.</p>
200
+ </blockquote>
201
+
202
+ <p>Using this API is pretty simple. First, remember that this API maintains a context, so you can save your preferred configuration of server, dictionary, output formats, … by assigning those value to your object. Get a reference to the <a href="Gravaty.html"><code>Gravaty</code></a> object, through its factory method, with <code>my_gravaty = Gravaty::gravatize your_em@il.address</code> using your email address as parameter. This will save a <a href="Gravaty.html"><code>Gravaty</code></a> instance in your <code>my_gravaty</code> object. At this point the object does contain a default configuration in terms of avatar, profile, …</p>
203
+
204
+ <p>You can take a look at the current status/configuration of your <code>my_gravaty</code> object using the <code>email</code> method <code>my_gravaty.email</code> that shows the email currently in use, or using the <code>digest</code> method <code>my_gravaty.digest</code> that shows the MD5 digest of the downcased email address in use. Also, <code>to_s</code> method is also available to print the current status of the <code>my_gravaty</code> object and each <code>Gravaty</code> is a Comparable object, based on <code>my_gravaty.email</code> data, your email address in small capital letters.</p>
205
+
206
+ <p>The <code>avatar</code> method provides the configuration-specific URI for your avatar: <code>my_gravaty.avatar</code> returns <code>https://secure.avatar.com/avatar/HASH</code> (where <code>HASH</code> is your <code>my_gravaty.digest</code> email address MD5 digest) ● The method allows an Hash, with avatar configuration parameters: type, pixel_size, force, secure, rating, default. (see <a href="https://en.gravatar.com/site/implement/images">en.gravatar.com/site/implement/images</a>/ for details) ● The avatar! method saves the provided configuration for your <a href="Gravaty.html"><code>Gravaty</code></a> object&#39;s to_s output.</p>
207
+
208
+ <p>The profile content feature ● With your <a href="Gravaty.html"><code>Gravaty</code></a> object available, the profile method provides the configuration-specific URI for your ( registered) user: – a_gravaty.profile returns <a href="https://secure.avatar.com/HASH">secure.avatar.com/HASH</a> (where HASH is your a_gravaty.digest email address MD5 digest) ● The method allows an Hash, with profile configuration parameters: format, secure. (see <a href="https://en.gravatar.com/site/implement/profiles">en.gravatar.com/site/implement/profiles</a>/ for details) ● The profile! method saves the provided configuration for your <a href="Gravaty.html"><code>Gravaty</code></a> object&#39;s to_s output.</p>
209
+
210
+ <p>The XML-RPC API content feature ● With your <a href="Gravaty.html"><code>Gravaty</code></a> object available, the xmlrpc method provides a reference to the remote Gravatar XML-RPC AP, for your (registered) user: – a_gravaty.xmlrpc requires the method name (grav.test, by default), your password and possible method parameters (whether needed) via a Hash. ● In order to increase security, the password is not saved inside the <a href="Gravaty.html"><code>Gravaty</code></a> object but has to be provided for each call; (see <a href="https://en.gravatar.com/site/implement/xmlrpc">en.gravatar.com/site/implement/xmlrpc</a>/ for details) ● Communication happens through SSL: certificate might be required (see gravaty <a href="README_md.html">README.md</a> file).</p>
211
+
212
+ <p>Additional features (1/2) ● Since QRCode and JSON are becoming popular formats, qr and json methods (together with qr! and json!) allows to directly retrieve the user&#39;s profile data URI, in QRCode or JSON format, with format-specific parameters. Examples: – a_gravaty.qr pixel_size: 42 – a_gravaty.json! callback: &#39;my_method&#39; ● The qr! and json! methods save the provided configuration for your <a href="Gravaty.html"><code>Gravaty</code></a> object&#39;s to_s output. ● a_gravaty.qr corresponds to a_gravaty.profile format: &#39;qr&#39; while a_gravaty.json corresponds to a_gravaty.profile format: &#39; json&#39; and they both filtered the allowed parameters according to the output type.</p>
213
+
214
+ <p>Additional features (2/2) ● When using the &#39;banged&#39; (!) methods (avatar! or profile!, same for qr! and json!), the built URI is saved inside the <a href="Gravaty.html"><code>Gravaty</code></a> object and is read-only available through to_s. ● The download method, simply specifying a filename as parameter, retrieves whatever resource is indicate by such internal status and saves its content in the specified file. Example: – a_gravaty.qr! – a_gravaty.download &#39;myQr.png&#39; ● The reset method clears the internal status restoring the email address output of to_s.</p>
215
+
216
+ <h2 id="label-Maintainers">Maintainers<span><a href="#label-Maintainers">&para;</a> <a href="#top">&uarr;</a></span></h2>
217
+ <ul><li>
218
+ <p><a href="https://savannah.nongnu.org/users/marcobresciani">Marco Bresciani</a></p>
219
+ </li></ul>
220
+
221
+ <h2 id="label-Thanks">Thanks<span><a href="#label-Thanks">&para;</a> <a href="#top">&uarr;</a></span></h2>
223
222
  <ul><li>
224
- <p>Gravatar: <a href="https://www.gravatar.com">www.gravatar.com</a>.</p>
225
- </li><li>
226
- <p>FSIJ (フリーソフトウェアイニシアティブ, Free Software Initiative of Japan): <a href="http://www.fsij.org">www.fsij.org</a>.</p>
223
+ <p>* Contributor*: <a href="http://www.csse.monash.edu.au/~jwb/index.html">Jim Breen</a></p>
227
224
  </li><li>
228
- <p>“RFC 5322 Email Validation Regex in Ruby Regular Expressions gist by Peter R. Marreck: <a href="https://gist.github.com/pmarreck/4626713">gist.github.com/pmarreck/4626713</a>.</p>
225
+ <p><em>Author</em>: <a href="lumbergh@gmail.com">Peter R. Marreck</a>, <a href="https://gist.github.com/pmarreck/4626713">RFC 5322 Email Validation Regex in Ruby Regular Expressions</a>. About <em>RFC 5322 Email Validation Regex in Ruby Regular Expressions</em>, please note that “This work is released under the BSD 3-Clause License”. This license is GNU GPLv3 compatible according to <a href="http://www.gnu.org/licenses/license-list.en.html#ModifiedBSD">www.gnu.org/licenses/license-list.en.html#ModifiedBSD</a>.</p>
229
226
  </li><li>
230
- <p>“An HTTP/HTTPS/FTP file downloader library/CLI based upon MiniPortile&#39;s HTTP implementation.” gist by Jon Maken: <a href="https://gist.github.com/jonforums/2202048">gist.github.com/jonforums/2202048</a>.</p>
227
+ <p><em>Author</em>: <a href="mailto:jon.forums@gmail.com">Jon Maken</a>, <a href="https://gist.github.com/jonforums/2202048">An HTTP/HTTPS/FTP file downloader library/CLI based upon MiniPortile’s HTTP implementation.</a>. About <em>An HTTP/HTTPS/FTP file downloader library/CLI based upon MiniPortile&#39;s HTTP implementation</em>, please note that “License: 3-clause BSD”. This license is GNU GPLv3 compatible according to <a href="http://www.gnu.org/licenses/license-list.en.html#ModifiedBSD">www.gnu.org/licenses/license-list.en.html#ModifiedBSD</a>.</p>
231
228
  </li></ul>
232
229
 
233
- <h3 id="label-Usage+Examples">Usage Examples<span><a href="#label-Usage+Examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
230
+ <p>FSIJ理事会の理事長、<a href="mailto:gniibe@fsij.org">新部裕</a>さんの日本語の翻訳。 Japanese translation by <a href="mailto:gniibe@fsij.org">Yutaka Niibe</a>, President of Free Software Initiative of Japan.</p>
234
231
 
235
- <p>See <code>examples</code> folder. To run the examples just type go into the <code>examples</code> directory and run <code>ruby</code>{EXAMPLE_NAME}<code>.rb</code>. Running the examples you&#39;ll see both the example description and correct code usage to perform such action. Here below are listed the currently available examples: * The <code>basics.rb</code> example (run <code>ruby basics.rb</code>) shows how to initialize and use a <a href="Gravaty.html"><code>Gravaty</code></a> object through the <code>gravatize</code> factory method; * The <code>avatar.rb</code> example (run <code>ruby avatar.rb</code>) shows how to ask for an avatar image through Gravatar (free) service, with all available options and configurations. It will also show how to download such images; * The <code>profile.rb</code> example (run <code>ruby profile.rb</code>) shows how to ask for profile data through Gravatar (free) service, with all available options and configurations. It will also show how to download such data. * The <code>xmlrpc.rb</code> example (run <code>ruby xmlrpc.rb</code>) shows how to use the XML-RPC API through Gravatar (free) service, with all available options and configurations. This need a valid username and password to work properly.</p>
232
+ <p>Thanks to <a href="https://za.linkedin.com/in/marcheiligers/">Marc Heiligers</a> for the note about Peter R. Marreck&#39;s gist.</p>
236
233
 
237
- <h2 id="label-Gravatar+Terms+of+Service">Gravatar Terms of Service<span><a href="#label-Gravatar+Terms+of+Service">&para;</a> <a href="#top">&uarr;</a></span></h2>
234
+ <p>Thanks to <a href="http://lukasz.niemier.pl/">Łukasz Niemier</a> for his suggestions on possible improvements.</p>
238
235
 
239
- <p><em>Here follows the unmodified 2020-03-12 09:22 CEST version of Gravatar site terms of service, titled “Gravatar Terms of Use”. For the most updated version, please refer to <a href="https://secure.gravatar.com/site/terms-of-service">secure.gravatar.com/site/terms-of-service</a> in order to know how to properly use computer gravatars.</em></p>
236
+ <h2 id="label-Contributing">Contributing<span><a href="#label-Contributing">&para;</a> <a href="#top">&uarr;</a></span></h2>
237
+
238
+ <p><a href="Gravaty.html"><code>Gravaty</code></a> tries to follow semantic versioning (see <a href="http://semver.org">semver.org</a>/). There may be backward incompatible changes each time minor version number changes, but that any tiny version number change should be bug fixes and internal changes only. Be sure to read the <code>CHANGELOG</code> each time we cut a new release and lock your gems accordingly.</p>
239
+
240
+ <p>RDoc documentation available in the <code>html</code> folder.</p>
241
+
242
+ <p>The easiest way to get help with <a href="Gravaty.html"><code>Gravaty</code></a> is to post a message to the mailing list: <code>http://lists.nongnu.org/mailman/listinfo/gravaty-users</code>.</p>
243
+
244
+ <p>Feel free to post any question there, developers are responsive and will be happy to help you figure out how to use <a href="Gravaty.html"><code>Gravaty</code></a>, or help you determine whether it&#39;s the right tool for the task you are working on.</p>
245
+
246
+ <p>Please make your posts to the list as specific as possible, including code samples and output where relevant. Do not post any information that should not be shared publicly, and be sure to reduce your example code as much as possible so that those who are responding to your question can more easily see what the issue might be.</p>
247
+
248
+ <p>If you&#39;ve found a bug, want to submit a patch, or have a feature request, please enter a ticket into our bug tracker: <code>https://savannah.nongnu.org/bugs/?func=additem&group=gravaty</code>.</p>
240
249
 
241
- <p>Gravatar Terms of Use</p>
250
+ <p>We strongly encourage adding bug reports with failing tests or at least a reduced example that demonstrates the problem.</p>
242
251
 
243
- <p>PLEASE READ THESE GRAVATAR TERMS OF USE (“GRAVATAR TERMS”) CAREFULLY BEFORE ACCESSING OR USING ANY PART OF THE SERVICES OR WEBSITE. BY USING THE SERVICES OR WEBSITE IN ANY MANNER, YOU AGREE THAT YOU HAVE READ AND AGREE TO BECOME BOUND BY THE GRAVATAR TERMS. IF THE GRAVATAR TERMS ARE CONSIDERED AN OFFER, ACCEPTANCE IS EXPRESSLY LIMITED TO SUCH TERMS. IF YOU DO NOT UNCONDITIONALLY AGREE TO ALL THE TERMS AND CONDITIONS OF THE GRAVATAR TERMS, YOU HAVE NO RIGHT TO USE ANY PORTION OF THE SERVICES OR WEBSITE.</p>
252
+ <p>Similarly, patches should include tests, API documentation, and an update to the manual where relevant. Feel free to clone early though and participate in the project, if you just want some feedback, or a code review before preparing your code to be merged.</p>
244
253
 
245
- <p>The Gravatar Terms govern the terms and conditions under which you may use the website located at <a href="www.gravatar.com">www.gravatar.com</a> and related services by Automattic, including without limitation, the user accounts, profiles, avatars, technology, and other content and materials offered on or through that website (collectively, “Services”, and each of which shall be deemed a “Website” for purposes of the Terms of Service (defined below)). The Gravatar Terms supplement the Terms of Service located at <a href="http://wordpress.com/tos">wordpress.com/tos</a>/ (the “Terms of Service”), including without limitation, the Responsibilities of Website Visitors, all warranty disclaimers, limitations of liability, and dispute resolution provisions therein, which shall apply to the subject matter of these Gravatar Terms, and which are incorporated herein by this reference. If there is any conflict between the Gravatar Terms and the Terms of Service, the Gravatar Terms will govern. All capitalized terms that are not defined herein have the meaning specified in the Terms of Service.&#39;);</p>
254
+ <p>If you are unsure about whether you&#39;ve found a bug, or want to check to see whether we&#39;d be interested in the feature you want to add before you start working on it, feel free to post to our mailing list.</p>
246
255
 
247
- <p>Automattic may update the Gravatar Terms from time to time. Your continued use of the Services following notification of such updates constitutes your acceptance of those changes.</p>
248
- <ol><li>
249
- <p>User Submissions. The Services may provide you with the ability to create, upload, distribute or post (“Submit(ting)”) data, photographs, avatars, software, graphics, profile and other information to the Services (collectively, the “User Submissions”). By Submitting User Submissions, you acknowledge that you are publishing that User Submission, and that you may be identified publicly by your avatar and other User Submissions (e.g., in connection with your blogs, comments and/or email address) by Automattic, third party Gravatar-enabled websites (as that term in defined below), and others. More specifically, you hereby do and shall grant to Automattic a worldwide, perpetual, irrevocable, royalty-free and fully-paid, transferable (including rights to sublicense) right to perform the Services (e.g., to use, modify, reproduce, distribute, prepare derivative works of, display, perform, and otherwise fully exercise and exploit all intellectual property, publicity, and moral rights with respect to any User Submissions, and to allow others to do so).</p>
250
- </li></ol>
256
+ <h2 id="label-License">License<span><a href="#label-License">&para;</a> <a href="#top">&uarr;</a></span></h2>
251
257
 
252
- <p>By Submitting, you agree to be solely responsible for the User Submissions and release Automattic from any liability related to your use of the Services. You warrant, represent and agree that you will not Submit any User Submissions or otherwise use the Services in a manner that (i) infringes the intellectual property or proprietary rights, or rights of publicity or privacy, of any third party; (ii) violates any law, statute, ordinance or regulation; or (iii) is harmful, threatening, abusive, harassing, tortuous, defamatory, vulgar, obscene, libelous, or otherwise objectionable. You understand that Automattic shall not be responsible or liable for controlling or editing any User Submission, for any errors or omissions in any User Submission, for any damage or loss caused or alleged to be caused by or in connection with the use of or reliance on any User Submission; nor can Automattic ensure prompt removal of inappropriate or unlawful content or guarantee the identity of any other users or websites with whom you may interact in the course of using the Services. 2. Use of the Services by Third Party Websites. Third party websites may enable the use of the Services on their respective websites as expressly authorized by Automattic (e.g., API calls into Gravatar: <a href="http://en.gravatar.com/site/implement">en.gravatar.com/site/implement</a>); provided that they (i) do not copy, store or modify User Submissions; (ii) do not distribute, display, perform, use or otherwise exercise or exploit any User Submission or other user information for any purpose other than as necessary to perform the Services for the applicable user; (iii) have a privacy policy in effect and posted on such website that complies with all applicable laws and regulations and that notifies such user that it will only use personally identifiable information as set forth in (ii) above; and (iv) agree to be bound by and comply with all the terms, conditions, and limitations set forth in the Terms of Service (“Gravatar-enabled website”).</p>
253
- <hr>
258
+ <p>SPDX-FileCopyrightText: 2013 Marco Bresciani</p>
254
259
 
255
- <p>gravaty</p>
260
+ <p>SPDX-License-Identifier: GFDL-1.3-or-later</p>
256
261
 
257
- <p>Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani</p>
262
+ <p>Copyright © 2013-2021 Marco Bresciani</p>
258
263
 
259
264
  <p>This file is part of gravaty.</p>
260
265
 
@@ -270,7 +275,7 @@ with gravaty. If not, see <http://www.gnu.org/licenses/>.
270
275
 
271
276
  <footer id="validator-badges" role="contentinfo">
272
277
  <p><a href="https://validator.w3.org/check/referer">Validate</a>
273
- <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.
278
+ <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.3.0.
274
279
  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
275
280
  </footer>
276
281
 
data/html/Rakefile.html CHANGED
@@ -4,7 +4,7 @@
4
4
  <head>
5
5
  <meta charset="UTF-8">
6
6
 
7
- <title>Rakefile - gravaty 10.0.0</title>
7
+ <title>Rakefile - gravaty 11.0.1</title>
8
8
 
9
9
  <script type="text/javascript">
10
10
  var rdoc_rel_prefix = "./";
@@ -21,8 +21,6 @@
21
21
  <link href="./css/rdoc.css" rel="stylesheet">
22
22
 
23
23
 
24
-
25
-
26
24
  <body id="top" role="document" class="file">
27
25
  <nav role="navigation">
28
26
  <div id="project-navigation">
@@ -58,31 +56,17 @@
58
56
 
59
57
 
60
58
  <div id="project-metadata">
61
- <div id="fileindex-section" class="nav-section">
59
+
60
+ <div id="fileindex-section" class="nav-section">
62
61
  <h3>Pages</h3>
63
62
 
64
63
  <ul class="link-list">
65
-
66
64
  <li><a href="./CHANGELOG.html">CHANGELOG</a>
67
-
68
65
  <li><a href="./COPYING_md.html">COPYING</a>
69
-
70
66
  <li><a href="./Gemfile.html">Gemfile</a>
71
-
72
- <li><a href="./ISSUES_md.html">ISSUES</a>
73
-
74
67
  <li><a href="./README_md.html">README</a>
75
-
76
68
  <li><a href="./Rakefile.html">Rakefile</a>
77
-
78
- <li><a href="./acknowledgements_md.html">acknowledgements</a>
79
-
80
- <li><a href="./authors_md.html">authors</a>
81
-
82
69
  <li><a href="./copyright_md.html">copyright</a>
83
-
84
- <li><a href="./examples/cacert_pem.html">cacert.pem</a>
85
-
86
70
  </ul>
87
71
  </div>
88
72
 
@@ -91,7 +75,9 @@
91
75
 
92
76
  <main role="main" aria-label="Page Rakefile">
93
77
 
94
- <p># gravaty # Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 201, 20209 Marco Bresciani # # This file is part of gravaty. # # gravaty is free software: you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by the # Free Software Foundation, either version 3 of the License, or (at your # option) any later version. # # gravaty is distributed in the hope that it will be useful, but WITHOUT # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License # for more details. # # You should have received a copy of the GNU General Public License # along with gravaty. If not, see &lt;<a href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/&gt;.</p>
78
+ <p># frozen_string_literal: true</p>
79
+
80
+ <p>#– # gravaty # rubocop:disable Style/AsciiComments # © 2013 Marco Bresciani # rubocop:enable Style/AsciiComments # # This file is part of gravaty. # # gravaty is free software: you can redistribute it and/or modify it # under the terms of the GNU General Public License as published by the # Free Software Foundation, either version 3 of the License, or (at your # option) any later version. # # gravaty is distributed in the hope that it will be useful, but WITHOUT # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License # for more details. # # You should have received a copy of the GNU General Public License # along with gravaty. If not, see &lt;<a href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/&gt;. #++</p>
95
81
 
96
82
  <p>require &#39;rake&#39; require &#39;rake/clean&#39; require &#39;rake/testtask&#39; require &#39;rdoc/task&#39; require &#39;rubygems/package_task&#39;</p>
97
83
 
@@ -113,9 +99,9 @@
113
99
  <p>desc “Build the RDoc gem documentation (task &#39;rake rdoc&#39;)” Rake::RDocTask.new do |rdoc|</p>
114
100
 
115
101
  <pre class="ruby"><span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">rdoc_files</span>.<span class="ruby-identifier">add</span> <span class="ruby-identifier">gravaty</span>.<span class="ruby-identifier">files</span>
116
- <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">title</span> = <span class="ruby-identifier">gravaty</span>.<span class="ruby-identifier">name</span> <span class="ruby-operator">+</span> <span class="ruby-string">&#39; &#39;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">gravaty</span>.<span class="ruby-identifier">version</span>.<span class="ruby-identifier">to_s</span>
102
+ <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">title</span> = <span class="ruby-node">&quot;#{gravaty.name} #{gravaty.version}&quot;</span>
117
103
  <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">main</span> = <span class="ruby-string">&#39;README.md&#39;</span>
118
- <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">options</span> <span class="ruby-operator">+=</span> <span class="ruby-node">%w(-e UTF-8 --hyperlink-all --line-numbers)</span>
104
+ <span class="ruby-identifier">rdoc</span>.<span class="ruby-identifier">options</span> <span class="ruby-operator">+=</span> <span class="ruby-node">%w[-e UTF-8 --hyperlink-all --line-numbers]</span>
119
105
  </pre>
120
106
 
121
107
  <p>end</p>
@@ -136,7 +122,7 @@
136
122
 
137
123
  <footer id="validator-badges" role="contentinfo">
138
124
  <p><a href="https://validator.w3.org/check/referer">Validate</a>
139
- <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.
125
+ <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.3.0.
140
126
  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
141
127
  </footer>
142
128
 
@@ -4,7 +4,7 @@
4
4
  <head>
5
5
  <meta charset="UTF-8">
6
6
 
7
- <title>copyright - gravaty 10.0.0</title>
7
+ <title>copyright - gravaty 11.0.1</title>
8
8
 
9
9
  <script type="text/javascript">
10
10
  var rdoc_rel_prefix = "./";
@@ -21,8 +21,6 @@
21
21
  <link href="./css/rdoc.css" rel="stylesheet">
22
22
 
23
23
 
24
-
25
-
26
24
  <body id="top" role="document" class="file">
27
25
  <nav role="navigation">
28
26
  <div id="project-navigation">
@@ -66,47 +64,23 @@
66
64
  <li><a href="#label-Sorce+Code+Pro+Font+-28-26+fonts.css-29">Sorce Code Pro Font (&amp; fonts.css)</a>
67
65
  <li><a href="#label-Lato+Font">Lato Font</a>
68
66
  <li><a href="#label-Silk+Icons">Silk Icons</a>
69
- <li><a href="#label-jquery.js">jquery.js</a>
70
- <li><a href="#label-Sizzle.js">Sizzle.js</a>
71
67
  <li><a href="#label-JsonIndex+generator+-28navigation.js+-26+search.js+-26+search_index.js+-26+searcher.js-29">JsonIndex generator (navigation.js &amp; search.js &amp; search_index.js &amp; searcher.js)</a>
72
- <li><a href="#label-root.crt">root.crt</a>
73
- <li><a href="#label-Root+Distribution+License">Root Distribution License</a>
74
- <li><a href="#label-Terms">Terms</a>
75
- <li><a href="#label-Copyright">Copyright</a>
76
- <li><a href="#label-License">License</a>
77
- <li><a href="#label-Disclaimer">Disclaimer</a>
78
- <li><a href="#label-Statutory+Rights">Statutory Rights</a>
79
- <li><a href="#label-Alternatives">Alternatives</a>
80
68
  </ul>
81
69
  </div>
82
70
 
83
71
 
84
72
  <div id="project-metadata">
85
- <div id="fileindex-section" class="nav-section">
73
+
74
+ <div id="fileindex-section" class="nav-section">
86
75
  <h3>Pages</h3>
87
76
 
88
77
  <ul class="link-list">
89
-
90
78
  <li><a href="./CHANGELOG.html">CHANGELOG</a>
91
-
92
79
  <li><a href="./COPYING_md.html">COPYING</a>
93
-
94
80
  <li><a href="./Gemfile.html">Gemfile</a>
95
-
96
- <li><a href="./ISSUES_md.html">ISSUES</a>
97
-
98
81
  <li><a href="./README_md.html">README</a>
99
-
100
82
  <li><a href="./Rakefile.html">Rakefile</a>
101
-
102
- <li><a href="./acknowledgements_md.html">acknowledgements</a>
103
-
104
- <li><a href="./authors_md.html">authors</a>
105
-
106
83
  <li><a href="./copyright_md.html">copyright</a>
107
-
108
- <li><a href="./examples/cacert_pem.html">cacert.pem</a>
109
-
110
84
  </ul>
111
85
  </div>
112
86
 
@@ -117,7 +91,7 @@
117
91
  <!--
118
92
  gravaty
119
93
 
120
- Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani
94
+ © 2013 Marco Bresciani
121
95
 
122
96
  This file is part of gravaty.
123
97
 
@@ -133,14 +107,18 @@ more details.
133
107
 
134
108
  You should have received a copy of the GNU General Public License along
135
109
  with gravaty. If not, see <http://www.gnu.org/licenses/>.
110
+
111
+ SPDX-FileCopyrightText: 2013 Marco Bresciani
112
+
113
+ SPDX-License-Identifier: FSFAP
136
114
  -->
137
115
  <h1 id="label-Copyright+Notes">Copyright Notes<span><a href="#label-Copyright+Notes">&para;</a> <a href="#top">&uarr;</a></span></h1>
138
116
 
139
- <p>2020-03-09 update.</p>
117
+ <p>2020-11-30 update.</p>
140
118
 
141
119
  <p>gravaty</p>
142
120
 
143
- <p>Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani</p>
121
+ <p 2013 Marco Bresciani</p>
144
122
 
145
123
  <p>This file is part of gravaty.</p>
146
124
 
@@ -150,11 +128,11 @@ with gravaty. If not, see <http://www.gnu.org/licenses/>.
150
128
 
151
129
  <p>You should have received a copy of the GNU General Public License along with gravaty. If not, see <a href="http://www.gnu.org/licenses">www.gnu.org/licenses</a>/.</p>
152
130
 
153
- <p>All project files, except for those listed in whole RDoc section below are released according to the above notice. The contributed code by Peter R. Marreck and Jon Maken are released according to their own licenses, specified inside the source code and checked being compatible with GNU GPLv3 license and the free software philosophy.</p>
131
+ <p>All project files, except for those listed in whole <a href="#rdoc">RDoc</a> section below, are released according to the above notice. The contributed code by Peter R. Marreck and Jon Maken are released according to their own licenses, specified inside the source code and checked being compatible with GNU GPLv3 license and the free software philosophy.</p>
154
132
 
155
133
  <h2 id="label-RDoc">RDoc<span><a href="#label-RDoc">&para;</a> <a href="#top">&uarr;</a></span></h2>
156
134
 
157
- <p>Documents in the html directory are automatically generated by Ruby RDoc tool, with Markdown syntax. Automatically included files have the following licenses:</p>
135
+ <p>Ruby RDoc tool automatically generated documents in the <code>html</code> directory using Markdown syntax. Automatically included files have the following licenses:</p>
158
136
 
159
137
  <h3 id="label-Darkfish+-28darkfish.js+-26+rdoc.css-29">Darkfish (darkfish.js &amp; rdoc.css)<span><a href="#label-Darkfish+-28darkfish.js+-26+rdoc.css-29">&para;</a> <a href="#top">&uarr;</a></span></h3>
160
138
 
@@ -164,16 +142,11 @@ with gravaty. If not, see <http://www.gnu.org/licenses/>.
164
142
 
165
143
  <p>Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:</p>
166
144
 
167
- <pre>Redistributions of source code must retain the above copyright
168
- notice, this list of conditions and the following disclaimer.
145
+ <p>Redistributions of source code must retain the above <a href="copyright_md.html">copyright</a> notice, this list of conditions and the following disclaimer.</p>
169
146
 
170
- Redistributions in binary form must reproduce the above copyright
171
- notice, this list of conditions and the following disclaimer in the
172
- documentation and/or other materials provided with the distribution.
147
+ <p>Redistributions in binary form must reproduce the above <a href="copyright_md.html">copyright</a> notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.</p>
173
148
 
174
- Neither the name of the author/s, nor the names of the project&#39;s
175
- contributors may be used to endorse or promote products derived from
176
- this software without specific prior written permission.</pre>
149
+ <p>Neither the name of the author/s, nor the names of the project&#39;s contributors may be used to endorse or promote products derived from this software without specific prior written permission.</p>
177
150
 
178
151
  <p>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p>
179
152
 
@@ -393,22 +366,10 @@ this software without specific prior written permission.</pre>
393
366
 
394
367
  <p>The icons can also be used under Creative Commons Attribution 3.0 License (Hi Debian folks!) with the following requirements: As an author, I would appreciate a reference to my authorship of the Silk icon set contents within a readme file or equivalent documentation for the software which includes the set or a subset of the icons contained within.</p>
395
368
 
396
- <h3 id="label-jquery.js">jquery.js<span><a href="#label-jquery.js">&para;</a> <a href="#top">&uarr;</a></span></h3>
397
-
398
- <p>jQuery JavaScript Library v1.6.2. See <a href="http://jquery.com">jquery.com</a>/</p>
399
-
400
- <p>Copyright 2011, John Resig Dual licensed under the MIT or GPL Version 2 licenses. <a href="http://jquery.org/license">jquery.org/license</a></p>
401
-
402
- <h4 id="label-Sizzle.js">Sizzle.js<span><a href="#label-Sizzle.js">&para;</a> <a href="#top">&uarr;</a></span></h4>
403
-
404
- <p>Includes Sizzle.js <a href="http://sizzlejs.com">sizzlejs.com</a>/ Copyright 2011, The Dojo Foundation Released under the MIT, BSD, and GPL Licenses.</p>
405
-
406
369
  <h3 id="label-JsonIndex+generator+-28navigation.js+-26+search.js+-26+search_index.js+-26+searcher.js-29">JsonIndex generator (navigation.js &amp; search.js &amp; search_index.js &amp; searcher.js)<span><a href="#label-JsonIndex+generator+-28navigation.js+-26+search.js+-26+search_index.js+-26+searcher.js-29">&para;</a> <a href="#top">&uarr;</a></span></h3>
407
370
 
408
371
  <p>See <a href="http://www.ruby-doc.org/stdlib-2.0/libdoc/rdoc/rdoc/RDoc/Generator/JsonIndex.html">www.ruby-doc.org/stdlib-2.0/libdoc/rdoc/rdoc/RDoc/Generator/JsonIndex.html</a></p>
409
372
 
410
- <p>The JsonIndex generator is designed to complement an HTML generator and produces a JSON search index. This generator is derived from sdoc by Vladimir Kolesnikov and contains verbatim code written by him.</p>
411
-
412
373
  <p>Copyright © 2009 Vladimir Kolesnikov</p>
413
374
 
414
375
  <p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p>
@@ -416,74 +377,11 @@ this software without specific prior written permission.</pre>
416
377
  <p>The above <a href="copyright_md.html">copyright</a> notice and this permission notice shall be included in all copies or substantial portions of the Software.</p>
417
378
 
418
379
  <p>THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
419
-
420
- <h2 id="label-root.crt">root.crt<span><a href="#label-root.crt">&para;</a> <a href="#top">&uarr;</a></span></h2>
421
-
422
- <p>The root.crt root certificate by CAcert.org is release under the Root Distribution License (see <a href="http://www.cacert.org/policy/RootDistributionLicense.php">www.cacert.org/policy/RootDistributionLicense.php</a>).</p>
423
- <ul><li>
424
- <p>Name: RDL <a href="https://svn.cacert.org/CAcert/Policies/ControlledDocumentList.html">COD14</a></p>
425
- </li><li>
426
- <p>Status: DRAFT <a href="https://wiki.cacert.org/PolicyDecisions#p20100710">p20100710</a></p>
427
- </li><li>
428
- <p>Editor: Mark Lipscombe</p>
429
- </li></ul>
430
-
431
- <p>RDL Status - DRAFT</p>
432
-
433
- <h3 id="label-Root+Distribution+License">Root Distribution License<span><a href="#label-Root+Distribution+License">&para;</a> <a href="#top">&uarr;</a></span></h3>
434
-
435
- <h4 id="label-Terms">Terms<span><a href="#label-Terms">&para;</a> <a href="#top">&uarr;</a></span></h4>
436
- <ul><li>
437
- <p>“CAcert Inc” means CAcert Incorporated, a non-profit association incorporated in New South Wales, Australia.</p>
438
- </li><li>
439
- <p>“CAcert Community Agreement” means the agreement entered into by each person wishing to RELY.</p>
440
- </li><li>
441
- <p>“Member” means a natural or legal person who has agreed to the CAcert Community Agreement.</p>
442
- </li><li>
443
- <p>“Certificate” means any certificate or like device to which CAcert Inc&#39;s digital signature has been affixed.</p>
444
- </li><li>
445
- <p>“CAcert Root Certificates” means any certificate issued by CAcert Inc to itself for the purposes of signing further CAcert Roots or for signing certificates of Members.</p>
446
- </li><li>
447
- <p>“RELY” means the human act in taking on a risk or liability on the basis of the claim(s) bound within a certificate issued by CAcert.</p>
448
- </li><li>
449
- <p>“Embedded” means a certificate that is contained within a software application or hardware system, when and only when, that software application or system is distributed in binary form only.</p>
450
- </li></ul>
451
-
452
- <h4 id="label-Copyright">Copyright<span><a href="#label-Copyright">&para;</a> <a href="#top">&uarr;</a></span></h4>
453
-
454
- <p>CAcert Root Certificates are Copyright CAcert Incorporated. All rights reserved.</p>
455
-
456
- <h4 id="label-License">License<span><a href="#label-License">&para;</a> <a href="#top">&uarr;</a></span></h4>
457
-
458
- <p>You may copy and distribute CAcert Root Certificates only in accordance with this license.</p>
459
-
460
- <p>CAcert Inc grants you a free, non-exclusive license to copy and distribute CAcert Root Certificates in any medium, with or without modification, provided that the following conditions are met:</p>
461
- <ul><li>
462
- <p>Redistributions of Embedded CAcert Root Certificates must take reasonable steps to inform the recipient of the disclaimer in section 4 or reproduce this license and <a href="copyright_md.html">copyright</a> notice in full in the documentation provided with the distribution.</p>
463
- </li><li>
464
- <p>Redistributions in all other forms must reproduce this license and <a href="copyright_md.html">copyright</a> notice in full.</p>
465
- </li></ul>
466
-
467
- <h4 id="label-Disclaimer">Disclaimer<span><a href="#label-Disclaimer">&para;</a> <a href="#top">&uarr;</a></span></h4>
468
-
469
- <p>THE CACERT ROOT CERTIFICATES ARE PROVIDED “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED TO THE MAXIMUM EXTENT PERMITTED BY LAW. IN NO EVENT SHALL CACERT INC, ITS MEMBERS, AGENTS, SUBSIDIARIES OR RELATED PARTIES BE LIABLE TO THE LICENSEE OR ANY THIRD PARTY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THESE CERTIFICATES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. IN ANY EVENT, CACERT&#39;S LIABILITY SHALL NOT EXCEED $1,000.00 AUSTRALIAN DOLLARS.</p>
470
-
471
- <p>THIS LICENSE SPECIFICALLY DOES NOT PERMIT YOU TO RELY UPON ANY CERTIFICATES ISSUED BY CACERT INC. IF YOU WISH TO RELY ON CERTIFICATES ISSUED BY CACERT INC, YOU MUST ENTER INTO A SEPARATE AGREEMENT WITH CACERT INC.</p>
472
-
473
- <h4 id="label-Statutory+Rights">Statutory Rights<span><a href="#label-Statutory+Rights">&para;</a> <a href="#top">&uarr;</a></span></h4>
474
-
475
- <p>Nothing in this license affects any statutory rights that cannot be waived or limited by contract. In the event that any provision of this license is held to be invalid or unenforceable, the remaining provisions of this license remain in full force and effect.</p>
476
-
477
- <h3 id="label-Alternatives">Alternatives<span><a href="#label-Alternatives">&para;</a> <a href="#top">&uarr;</a></span></h3>
478
-
479
- <p>If you find the terms of the above Root Distribution License difficult or inadequate for your purposes, you may wish to: * Enter into the CAcert Community Agreement by <a href="https://www.cacert.org/index.php?id=1">registering as a Member</a>. This is free. * Delete CAcert Root Certificates from your software. Your software documentation should give directions and assistance for this.</p>
480
-
481
- <p>These alternatives are outside the above Root Distribution License and do not incorporate.</p>
482
380
  <hr>
483
381
 
484
382
  <p>gravaty</p>
485
383
 
486
- <p>Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Marco Bresciani</p>
384
+ <p 2013 Marco Bresciani</p>
487
385
 
488
386
  <p>This file is part of gravaty.</p>
489
387
 
@@ -499,7 +397,7 @@ this software without specific prior written permission.</pre>
499
397
 
500
398
  <footer id="validator-badges" role="contentinfo">
501
399
  <p><a href="https://validator.w3.org/check/referer">Validate</a>
502
- <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.
400
+ <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.3.0.
503
401
  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
504
402
  </footer>
505
403