gravaty 9.0.0

data/copyright.md

@@ -0,0 +1,468 @@
+<!--
+gravaty
+
+Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  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 <http://www.gnu.org/licenses/>.
+-->
+
+# Copyright Notes
+2014-04-16 update.
+
+gravaty
+
+Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  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 <http://www.gnu.org/licenses/>.
+
+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.
+
+
+## RDoc
+Documents in the html directory are automatically generated by Ruby RDoc
+tool, with Markdown syntax. Automatically included files have the
+following licenses:
+
+### Darkfish (darkfish.js & rdoc.css)
+See <http://www.ruby-doc.org/stdlib-2.0/libdoc/rdoc/rdoc/RDoc/Generator/Darkfish.html>
+
+Copyright © 2007, 2008, Michael Granger. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+    Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+    Neither the name of the author/s, nor the names of the project's
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+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.
+
+Darkfish uses the Silk Icons set by Mark James.
+
+### Sorce Code Pro Font (& fonts.css)
+Copyright 2010, 2012 Adobe Systems Incorporated
+(<http://www.adobe.com/>), with Reserved Font Name "Source". All Rights
+Reserved. Source is a trademark of Adobe Systems Incorporated in the
+United States and/or other countries.
+
+This Font Software is licensed under the SIL Open Font License, Version
+1.1.
+
+This license is copied below, and is also available with a FAQ at:
+<http://scripts.sil.org/OFL>
+
+    /*
+     * -----------------------------------------------------------
+     * SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+     * -----------------------------------------------------------
+     *
+     * PREAMBLE
+     * The goals of the Open Font License (OFL) are to stimulate
+     * worldwide development of collaborative font projects, to support
+     * the font creation efforts of academic and linguistic communities,
+     * and to provide a free and open framework in which fonts may be
+     * shared and improved in partnership with others.
+     *
+     * The OFL allows the licensed fonts to be used, studied, modified
+     * and redistributed freely as long as they are not sold by
+     * themselves. The fonts, including any derivative works, can be
+     * bundled, embedded, redistributed and/or sold with any software
+     * provided that any reserved names are not used by derivative
+     * works. The fonts and derivatives, however, cannot be released
+     * under any other type of license. The requirement for fonts to
+     * remain under this license does not apply to any document created
+     * using the fonts or their derivatives.
+     *
+     * DEFINITIONS
+     * "Font Software" refers to the set of files released by the
+     * Copyright Holder(s) under this license and clearly marked as
+     * such. This may include source files, build scripts and
+     * documentation.
+     *
+     * "Reserved Font Name" refers to any names specified as such after
+     * the copyright statement(s).
+     *
+     * "Original Version" refers to the collection of Font Software
+     * components as distributed by the Copyright Holder(s).
+     *
+     * "Modified Version" refers to any derivative made by adding to,
+     * deleting, or substituting -- in part or in whole -- any of the
+     * components of the Original Version, by changing formats or by
+     * porting the Font Software to a new environment.
+     *
+     * "Author" refers to any designer, engineer, programmer, technical
+     * writer or other person who contributed to the Font Software.
+     *
+     * PERMISSION & CONDITIONS
+     * Permission is hereby granted, free of charge, to any person
+     * obtaining a copy of the Font Software, to use, study, copy,
+     * merge, embed, modify, redistribute, and sell modified and
+     * unmodified copies of the Font Software, subject to the following
+     * conditions:
+     *
+     * 1) Neither the Font Software nor any of its individual
+     * components, in Original or Modified Versions, may be sold by
+     * itself.
+     *
+     * 2) Original or Modified Versions of the Font Software may be
+     * bundled, redistributed and/or sold with any software, provided
+     * that each copy contains the above copyright notice and this
+     * license. These can be included either as stand-alone text files,
+     * human-readable headers or in the appropriate machine-readable
+     * metadata fields within text or binary files as long as those
+     * fields can be easily viewed by the user.
+     *
+     * 3) No Modified Version of the Font Software may use the Reserved
+     * Font Name(s) unless explicit written permission is granted by the
+     * corresponding Copyright Holder. This restriction only applies to
+     * the primary font name as presented to the users.
+     *
+     * 4) The name(s) of the Copyright Holder(s) or the Author(s) of the
+     * Font Software shall not be used to promote, endorse or advertise
+     * any Modified Version, except to acknowledge the contribution(s)
+     * of the Copyright Holder(s) and the Author(s) or with their
+     * explicit written permission.
+     *
+     * 5) The Font Software, modified or unmodified, in part or in
+     * whole, must be distributed entirely under this license, and must
+     * not be distributed under any other license. The requirement for
+     * fonts to remain under this license does not apply to any document
+     * created using the Font Software.
+     *
+     * TERMINATION
+     * This license becomes null and void if any of the above conditions
+     * are not met.
+     *
+     * DISCLAIMER
+     * THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+     * KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY
+     * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
+     * AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER
+     * RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY
+     * CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL,
+     * SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER
+     * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+     * THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+     * DEALINGS IN THE FONT SOFTWARE.
+     */
+
+### Lato Font
+Copyright (c) 2010, Łukasz Dziedzic (<dziedzic@typoland.com>), with
+Reserved Font Name Lato.
+
+This Font Software is licensed under the SIL Open Font License, Version
+1.1.
+
+This license is copied below, and is also available with a FAQ at:
+<http://scripts.sil.org/OFL>
+
+    /*
+     * -----------------------------------------------------------
+     * SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+     * -----------------------------------------------------------
+     *
+     * PREAMBLE
+     * The goals of the Open Font License (OFL) are to stimulate
+     * worldwide development of collaborative font projects, to support
+     * the font creation efforts of academic and linguistic communities,
+     * and to provide a free and open framework in which fonts may be
+     * shared and improved in partnership with others.
+     *
+     * The OFL allows the licensed fonts to be used, studied, modified
+     * and redistributed freely as long as they are not sold by
+     * themselves. The fonts, including any derivative works, can be
+     * bundled, embedded, redistributed and/or sold with any software
+     * provided that any reserved names are not used by derivative
+     * works. The fonts and derivatives, however, cannot be released
+     * under any other type of license. The requirement for fonts to
+     * remain under this license does not apply to any document created
+     * using the fonts or their derivatives.
+     *
+     * DEFINITIONS
+     * "Font Software" refers to the set of files released by the
+     * Copyright Holder(s) under this license and clearly marked as
+     * such. This may include source files, build scripts and
+     * documentation.
+     *
+     * "Reserved Font Name" refers to any names specified as such after
+     * the copyright statement(s).
+     *
+     * "Original Version" refers to the collection of Font Software
+     * components as distributed by the Copyright Holder(s).
+     *
+     * "Modified Version" refers to any derivative made by adding to,
+     * deleting, or substituting -- in part or in whole -- any of the
+     * components of the Original Version, by changing formats or by
+     * porting the Font Software to a new environment.
+     *
+     * "Author" refers to any designer, engineer, programmer, technical
+     * writer or other person who contributed to the Font Software.
+     *
+     * PERMISSION & CONDITIONS
+     * Permission is hereby granted, free of charge, to any person
+     * obtaining a copy of the Font Software, to use, study, copy,
+     * merge, embed, modify, redistribute, and sell modified and
+     * unmodified copies of the Font Software, subject to the following
+     * conditions:
+     *
+     * 1) Neither the Font Software nor any of its individual
+     * components, in Original or Modified Versions, may be sold by
+     * itself.
+     *
+     * 2) Original or Modified Versions of the Font Software may be
+     * bundled, redistributed and/or sold with any software, provided
+     * that each copy contains the above copyright notice and this
+     * license. These can be included either as stand-alone text files,
+     * human-readable headers or in the appropriate machine-readable
+     * metadata fields within text or binary files as long as those
+     * fields can be easily viewed by the user.
+     *
+     * 3) No Modified Version of the Font Software may use the Reserved
+     * Font Name(s) unless explicit written permission is granted by the
+     * corresponding Copyright Holder. This restriction only applies to
+     * the primary font name as presented to the users.
+     *
+     * 4) The name(s) of the Copyright Holder(s) or the Author(s) of the
+     * Font Software shall not be used to promote, endorse or advertise
+     * any Modified Version, except to acknowledge the contribution(s)
+     * of the Copyright Holder(s) and the Author(s) or with their
+     * explicit written permission.
+     *
+     * 5) The Font Software, modified or unmodified, in part or in
+     * whole, must be distributed entirely under this license, and must
+     * not be distributed under any other license. The requirement for
+     * fonts to remain under this license does not apply to any document
+     * created using the Font Software.
+     *
+     * TERMINATION
+     * This license becomes null and void if any of the above conditions
+     * are not met.
+     *
+     * DISCLAIMER
+     * THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+     * KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY
+     * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
+     * AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER
+     * RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY
+     * CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL,
+     * SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER
+     * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+     * THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+     * DEALINGS IN THE FONT SOFTWARE.
+     */
+
+### Silk Icons
+See <http://www.famfamfam.com/lab/icons/silk/>
+
+This work is licensed under a Creative Commons Attribution 2.5 License.
+This means you may use it for any purpose, and make any changes you
+like. All I ask is that you include a link back to this page in your
+credits (although a giant link on every page of your website really
+isn't needed, contact me to discuss specifics).
+
+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.
+
+### jquery.js
+jQuery JavaScript Library v1.6.2. See <http://jquery.com/>
+
+Copyright 2011, John Resig
+Dual licensed under the MIT or GPL Version 2 licenses.
+<http://jquery.org/license>
+
+#### Sizzle.js
+Includes Sizzle.js
+<http://sizzlejs.com/>
+Copyright 2011, The Dojo Foundation
+Released under the MIT, BSD, and GPL Licenses.
+
+### JsonIndex generator (navigation.js & search.js & search_index.js & searcher.js)
+See
+<http://www.ruby-doc.org/stdlib-2.0/libdoc/rdoc/rdoc/RDoc/Generator/JsonIndex.html>
+
+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.
+
+Copyright © 2009 Vladimir Kolesnikov
+
+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:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+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.
+
+## root.crt
+The root.crt root certificate by CAcert.org is release under the Root
+Distribution License (see
+<http://www.cacert.org/policy/RootDistributionLicense.php>).
+
+* Name: RDL
+  [COD14](https://svn.cacert.org/CAcert/Policies/ControlledDocumentList.html)
+* Status: DRAFT
+  [p20100710](https://wiki.cacert.org/PolicyDecisions#p20100710)
+* Editor: Mark Lipscombe
+
+RDL Status - DRAFT
+
+### Root Distribution License
+#### Terms
+* "CAcert Inc" means CAcert Incorporated, a non-profit association
+  incorporated in New South Wales, Australia.
+* "CAcert Community Agreement" means the agreement entered into by each
+  person wishing to RELY.
+* "Member" means a natural or legal person who has agreed to the CAcert
+  Community Agreement.
+* "Certificate" means any certificate or like device to which CAcert
+  Inc's digital signature has been affixed.
+* "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.
+* "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.
+* "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.
+
+#### Copyright
+CAcert Root Certificates are Copyright CAcert Incorporated. All rights
+reserved.
+
+#### License
+You may copy and distribute CAcert Root Certificates only in accordance
+with this license.
+
+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:
+
+* 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 copyright notice in full in the
+  documentation provided with the distribution.
+* Redistributions in all other forms must reproduce this license and
+  copyright notice in full.
+
+#### Disclaimer
+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'S LIABILITY SHALL NOT EXCEED $1,000.00 AUSTRALIAN
+DOLLARS.
+
+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.
+
+#### Statutory Rights
+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.
+
+### Alternatives
+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 [registering as a
+  Member](https://www.cacert.org/index.php?id=1). This is free.
+* Delete CAcert Root Certificates from your software. Your software
+  documentation should give directions and assistance for this.
+
+These alternatives are outside the above Root Distribution License and
+do not incorporate.
+
+------------------------------------------
+
+gravaty
+
+Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  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 <http://www.gnu.org/licenses/>.

data/examples/avatar.rb

@@ -0,0 +1,159 @@
+#--
+# gravaty
+# Copyright © 2013, 2014, 2015, 2016, 2017, 2018, 2019  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 <http://www.gnu.org/licenses/>.
+#++
+
+require_relative '../lib/gravaty'
+
+i = 0
+
+# Creates the Gravaty object with an (example) email
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Creates the Gravaty object with an (example) email."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty = Gravaty::gravatize 'user@example.com'"
+a_gravaty = Gravaty::gravatize 'user@example.com'
+puts
+i += 1
+
+# Prints the secure URL for avatar retrieval, with no frills
+# (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints the secure URL for avatar retrieval, with no frills (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af)."
+puts "------------------------------------------"
+puts 'irb(main):001:0> a_gravaty.avatar'
+puts a_gravaty.avatar
+puts
+i += 1
+
+# Prints the basic URL for avatar retrieval, with no frills
+# (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints the basic URL for avatar retrieval, with no frills (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af)."
+puts "------------------------------------------"
+puts 'irb(main):001:0> a_gravaty.avatar secure: false'
+puts a_gravaty.avatar secure: false
+puts
+i += 1
+
+# Prints the secure URL for avatar retrieval, with specified image file
+# extension
+# (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints the secure URL for avatar retrieval, with specified image file extension (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg)."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty.avatar type: 'JPG'"
+puts a_gravaty.avatar type: 'JPG'
+puts
+i += 1
+
+# Retrieves the latest saved operation (email address, if none saved)
+# (user@example.com)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Retrieves the latest saved operation (email address, if none saved) (user@example.com)."
+puts "------------------------------------------"
+puts 'irb(main):001:0> puts a_gravaty'
+puts a_gravaty
+puts
+i += 1
+
+# Prints and saves the secure URL for avatar and later retrieval, with
+# specified image file extension
+# (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints and saves the secure URL for avatar and later retrieval, with specified image file extension (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg)."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty.avatar! type: 'JPG'"
+puts a_gravaty.avatar! type: 'JPG'
+puts
+i += 1
+
+# Prints the basic URL for avatar retrieval, with specified image file
+# extension
+# (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.gif)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints the basic URL for avatar retrieval, with specified image file extension (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.gif)."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty.avatar type: 'GIF', secure: false"
+puts a_gravaty.avatar type: 'GIF', secure: false
+puts
+i += 1
+
+# Retrieves and prints the latest saved operation
+# (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Retrieves and prints the latest saved operation. (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg)"
+puts "------------------------------------------"
+puts 'irb(main):001:0> puts a_gravaty'
+puts a_gravaty
+puts
+i += 1
+
+# Prints the basic URL for avatar retrieval, with specified image size
+# (in pixels) and specified image file extension
+# (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.png?s=42)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints the basic URL for avatar retrieval, with specified image size (in pixels) and specified image file extension (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.png?s=42)."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty.avatar type: 'png', pixelsize: 42, secure: false"
+puts a_gravaty.avatar type: 'png', pixelsize: 42, secure: false
+puts
+i += 1
+
+# Prints and saves the basic URL for avatar retrieval, with specified
+# image size (in pixels), specified image file extension and type
+# (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.png?s=42&d=monsterid)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints and saves the basic URL for avatar retrieval, with specified image size (in pixels), specified image file extension and type (http://www.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.png?s=42&d=robohash)."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty.avatar! type: 'png', default: 'robohash', pixelsize: 42, secure: false"
+puts a_gravaty.avatar! type: 'png', default: 'robohash', pixelsize: 42, secure: false
+puts
+i += 1
+
+# Downloads the previously saved gravaty configuration with the default
+# name of the file according to saved URI
+# (saves b58996c504c5638798eb6b511e6f49af.png file)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Downloads the previously saved gravaty configuration with the default name of the file according to saved URI. (saves b58996c504c5638798eb6b511e6f49af.png file)"
+puts "------------------------------------------"
+puts 'irb(main):001:0> a_gravaty.download'
+a_gravaty.download
+puts
+i += 1
+
+# Prints and saves the basic URL for avatar retrieval, with specified
+# image default
+# (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg?d=identicon)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Prints and saves the basic URL for avatar retrieval, with specified image default (https://secure.gravatar.com/avatar/b58996c504c5638798eb6b511e6f49af.jpg?d=identicon)."
+puts "------------------------------------------"
+puts "irb(main):001:0> a_gravaty.avatar default: 'identicon', type: 'jpg'"
+puts a_gravaty.avatar! default: 'identicon', type: 'jpg'
+puts
+i += 1
+
+# Downloads the previously saved gravaty configuration with the default
+# name of the file according to saved URI
+# (saves b58996c504c5638798eb6b511e6f49af.jpg file)
+puts "------------------------------------------"
+puts "Avatar: '#{i}'. Downloads the previously saved gravaty configuration with the default name of the file according to saved URI. (saves b58996c504c5638798eb6b511e6f49af.jpg file)"
+puts "------------------------------------------"
+puts 'irb(main):001:0> a_gravaty.download'
+a_gravaty.download
+puts