inventory 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0babb6ccf5f1ffb7268ba69e57a9ade4e17c758e
-  data.tar.gz: 0b55936c52037e6a59796e9c85a15d0802fcbe32
+  metadata.gz: 5bc965739dc38638b27371f7eb89907051b26a5f
+  data.tar.gz: 67606e0bfa029a0b162b5f99b27a960826e690ed
 SHA512:
-  metadata.gz: 78108a236b43f9b9d012c3d3be3c7408b502d872f3390f6b4bce552a880563bca58d2d27c70fd8339555b011c437d8c8ad374aa2b43acacbf9dc42d3627f6380
-  data.tar.gz: cfe46f91c44dd8c3d22802ceb318f2ad0c93648235bb7ea48d0f37effb9ec3b3dbb9e5dc390cd5ff66ed4d93fad7d023d6b7e906d8eab400ff13addaba65db7e
+  metadata.gz: d8e3deee905958b3d9ce6ba3d3eaef41e6de87309b05161b90522f935629e89c5fb967d62fe3936b39f85b85e8b89ed986b6f0fe78f535a26b81d14545c0a6a0
+  data.tar.gz: baa8868f061e0b100a4c57d503836326fc24cd7804acff4bbaa76e24e4dfb9d3fb9fa5bde28a22c99e3aa5d61f96a97b06b49a708661a7ebb79631839d6d26ce

data/README

@@ -44,6 +44,18 @@
 
       class Foo
         Version = Foo.new(1, 4, 0){
+          authors{
+            author 'A. U. Thor', 'a.u.thor@example.org'
+          }
+
+          homepage 'http://example.org/'
+
+          licenses{
+            license 'LGPLv3+',
+                    'GNU Lesser General Public License, version 3 or later',
+                    'http://www.gnu.org/licenses/'
+          }
+
           def dependencies
             super + Dependencies.new{
               development 'baz', 1, 3, 0
@@ -69,6 +81,11 @@
     allow the Inventory#to_s method to act as if you’d defined Version as
     ‹'1.4.0'›.
 
+    Next follows information about the authors of the project, the project’s
+    homepage, and the project’s licenses.  Each author has a name and an email
+    address.  The homepage is simply a string URL.  Licenses have an
+    abbreviation, a name, and a URL where the license text can be found.
+
     We then extend the definition of ‹dependencies› by adding another set of
     dependencies to ‹super›.  ‹Super› includes a dependency on the version of
     the inventory project that’s being used with this project, so you’ll never
@@ -131,11 +148,7 @@
 
       load File.expand_path('../lib/foo-1.0/version.rb', __FILE__)
 
-      Inventory::Rake::Tasks.define Foo::Version, :gem => proc{ |_, s|
-        s.author = 'Your Name'
-        s.email = 'you@example.com'
-        s.homepage = 'https://example.com/'
-      }
+      Inventory::Rake::Tasks.define Foo::Version
 
       Inventory::Rake::Tasks.unless_installing_dependencies do
         require 'lookout-rake-3.0'
@@ -143,8 +156,7 @@
       end
 
     It’s ‹Inventory::Rake::Tasks.define› that does the heavy lifting.  It takes
-    our inventory and sets up the tasks mentioned above.  We also do some
-    additional customization of the gem specification.
+    our inventory and sets up the tasks mentioned above.
 
     As we want to be able to use our Rakefile to install our dependencies for
     us, the rest of the Rakefile is inside the conditional
@@ -184,7 +196,7 @@
     If the guide above doesn’t provide you with all the answers you seek, you
     may refer to the API¹ for more answers.
 
-¹ See http://disu.se/software/inventory/api/inventory/
+¹ See http://disu.se/software/inventory/api/Inventory/
 
 § Financing
 

data/Rakefile

@@ -5,11 +5,7 @@ require 'inventory-1.0'
 
 require 'inventory-rake-1.0'
 
-Inventory::Rake::Tasks.define Inventory::Version, :gem => proc{ |_, s|
-  s.author = 'Nikolai Weibull'
-  s.email = 'now@bitwi.se'
-  s.homepage = 'https://github.com/now/inventory'
-}
+Inventory::Rake::Tasks.define Inventory::Version
 
 Inventory::Rake::Tasks.unless_installing_dependencies do
   require 'lookout-rake-3.0'

data/lib/inventory-1.0.rb

@@ -34,6 +34,18 @@
 #
 #       class Foo
 #         Version = Inventory.new(1, 2, 0){
+#           authors{
+#             author 'A. U. Thor', 'a.u.thor@example.org'
+#           }
+#
+#           homepage 'http://example.org/'
+#
+#           licenses{
+#             license 'LGPLv3+',
+#                     'GNU Lesser General Public License, version 3 or later',
+#                     'http://www.gnu.org/licenses/'
+#           }
+#
 #           def dependencies
 #             super + Dependencies.new{
 #               development 'inventory-rake', 1, 3, 0
@@ -100,6 +112,45 @@ class Inventory
     self
   end
 
+  # Sets, when given a block, the authors of the project, otherwise returns
+  # them.  The block will be #instance_exec’d inside a new {Authors} object,
+  # allowing you to {Authors#author add} one or more authors.
+  #
+  # @yield [?]
+  # @return [Authors]
+  # @raise [RuntimeError] If no block has been given and no authors have previously been set
+  def authors
+    @authors = Authors.new(&Proc.new) if block_given?
+    raise 'no authors defined in inventory of %s' % self if not defined? @authors or @authors.count == 0
+    @authors
+  end
+
+  # Sets the project homepage to VALUE, or returns it, if VALUE is nil.
+  #
+  # @param [String] value
+  # @return [String]
+  # @raise [RuntimeError] If VALUE is nil and no homepage has previously been
+  #   set
+  def homepage(value = nil)
+    return @homepage = value if value
+    raise 'no homepage set in inventory of %s' % self if not defined? @homepage
+    @homepage
+  end
+
+  # Sets, when given a block, the licenses of the project, otherwise returns
+  # them.  The block will be #instance_exec’d inside a new {Licenses} object,
+  # allowing you to {Licenses#license add} one or more licenses.
+  #
+  # @yield [?]
+  # @return [Licenses]
+  # @raise [RuntimeError] If no block has been given and no licenses have
+  #   previously been set
+  def licenses
+    @licenses = Licenses.new(&Proc.new) if block_given?
+    raise 'no licenses defined in inventory of %s' % self if not defined? @licenses or @licenses.count == 0
+    @licenses
+  end
+
   # @return [Dependencies] The dependencies of the package
   # @note The default list of dependencies is an {Dependencies#optional
   #   optional} dependency on the inventory package itself.

data/lib/inventory-1.0/author.rb

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+
+# An author of the project stored in the list of {Authors} in the inventory.
+class Inventory::Author
+  # Sets up a new author NAME that can be contacted at EMAIL.
+  #
+  # @param [String] name
+  # @param [String] email
+  def initialize(name, email)
+    @name, @email = name, email
+  end
+
+  # @return [String] The {#name} and {#email} of the author on the “name
+  #   <email>” format
+  def to_s
+    '%s <%s>' % [name, email]
+  end
+
+  # @return [String] The name of the author
+  attr_reader :name
+
+  # @return [String] The email address of the author
+  attr_reader :email
+end

data/lib/inventory-1.0/authors.rb

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+
+# Contains zero or more {Author authors} of the project.  Authors can be {#+
+# added} and {#each enumerated}.  Authors are set up by passing a block to
+# {#initialize} and calling {#author} inside it.
+#
+# @example Creating a List of Authors
+#   Authors.new{
+#     author 'A. U. Thor', 'a.u.thor@example.org'
+#     author 'W. R. Ither', 'w.r.ither@example.org'
+#   }
+class Inventory::Authors
+  include Enumerable
+
+  # Creates a new list of AUTHORS and allows more to be added in the
+  # optionally #instance_exec’d block by calling {#author} inside it.
+  #
+  # @param [Author, …] authors
+  # @yield [?]
+  def initialize(*authors)
+    @authors = authors
+    instance_exec(&Proc.new) if block_given?
+  end
+
+  private
+
+  # Add an {Author} to the list of authors.
+  #
+  # @param (see Inventory::Author#initialize)
+  # @option (see Inventory::Author#initialize)
+  # @return [self]
+  def author(name, email)
+    authors << Inventory::Author.new(name, email)
+    self
+  end
+
+  public
+
+  # @return [Authors] The authors of the receiver and those of OTHER
+  def +(other)
+    self.class.new(*(authors + other.authors))
+  end
+
+  # @overload
+  #   Enumerates the authors.
+  #
+  #   @yieldparam [Author] author
+  # @overload
+  #   @return [Enumerator<Author>] An Enumerator over the authors
+  def each
+    return enum_for(__method__) unless block_given?
+    authors.each do |author|
+      yield author
+    end
+    self
+  end
+
+  protected
+
+  attr_reader :authors
+end

data/lib/inventory-1.0/dependencies.rb

@@ -18,7 +18,7 @@ class Inventory::Dependencies
   # optionally #instance_exec’d block by calling {#development}, {#runtime},
   # and {#optional} inside it.
   #
-  # @param [Array<Dependency>] dependencies
+  # @param [Dependency, …] dependencies
   # @yield [?]
   def initialize(*dependencies)
     @dependencies = dependencies
@@ -32,6 +32,7 @@ class Inventory::Dependencies
   #
   # @param (see Inventory::Dependency#initialize)
   # @option (see Inventory::Dependency#initialize)
+  # @return [self]
   def development(name, major, minor, patch, options = {})
     dependencies << Development.new(name, major, minor, patch, options)
     self
@@ -42,6 +43,7 @@ class Inventory::Dependencies
   #
   # @param (see Inventory::Dependency#initialize)
   # @option (see Inventory::Dependency#initialize)
+  # @return [self]
   def runtime(name, major, minor, patch, options = {})
     dependencies << Runtime.new(name, major, minor, patch, options)
     self
@@ -52,6 +54,7 @@ class Inventory::Dependencies
   #
   # @param (see Inventory::Dependency#initialize)
   # @option (see Inventory::Dependency#initialize)
+  # @return [self]
   def optional(name, major, minor, patch, options = {})
     dependencies << Optional.new(name, major, minor, patch, options)
     self

data/lib/inventory-1.0/license.rb

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+
+# A license used by the project stored in the list of {Licenses} in the
+# inventory.
+class Inventory::License
+  # Sets up a new license NAME, often referred to via ABBREVIATION, than can be
+  # found at URL.
+  #
+  # @param [String] abbreviation
+  # @param [String] name
+  # @param [String] url
+  def initialize(abbreviation, name, url)
+    @abbreviation, @name, @url = abbreviation, name, url
+  end
+
+  # @return [String] The {#abbreviation} of the license
+  def to_s
+    abbreviation.dup
+  end
+
+  # @return [String] The abbreviation of the {#name} of the license
+  attr_reader :abbreviation
+
+  # @return [String] The name of the license
+  attr_reader :name
+
+  # @return [String] The URL at which the license can be found
+  attr_reader :url
+end

data/lib/inventory-1.0/licenses.rb

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+
+# Contains zero or more {License licenses} of the project.  Licenses can be {#+
+# added} and {#each enumerated}.  Licenses are set up by passing a block to
+# {#initialize} and calling {#license} inside it.
+#
+# @example Creating a List of Licenses
+#   Licenses.new{
+#     license 'LGPLv3+',
+#             'GNU Lesser General Public License, version 3 or later',
+#             'http://www.gnu.org/licenses/'
+#     license 'GPLv3+',
+#             'GNU General Public License, version 3 or later',
+#             'http://www.gnu.org/licenses/'
+#   }
+class Inventory::Licenses
+  include Enumerable
+
+  # Creates a new list of LICENSES and allows more to be added in the
+  # optionally #instance_exec’d block by calling {#license} inside it.
+  #
+  # @param [License, …] licenses
+  # @yield [?]
+  def initialize(*licenses)
+    @licenses = licenses
+    instance_exec(&Proc.new) if block_given?
+  end
+
+  private
+
+  # Add a {License} to the list of licenses.
+  #
+  # @param (see Inventory::License#initialize)
+  # @option (see Inventory::License#initialize)
+  # @return [self]
+  def license(abbreviation, name, url)
+    licenses << Inventory::License.new(abbreviation, name, url)
+    self
+  end
+
+  public
+
+  # @return [Licenses] The authors of the receiver and those of OTHER
+  def +(other)
+    self.class.new(*(licenses + other.licenses))
+  end
+
+  # @overload
+  #   Enumerates the licenses.
+  #
+  #   @yieldparam [License] license
+  # @overload
+  #   @return [Enumerator<Author>] An Enumerator over the licenses
+  def each
+    return enum_for(__method__) unless block_given?
+    licenses.each do |license|
+      yield license
+    end
+    self
+  end
+
+  protected
+
+  attr_reader :licenses
+end

data/lib/inventory-1.0/version.rb

@@ -1,23 +1,47 @@
 # -*- coding: utf-8 -*-
 
 class Inventory
-  Version = Inventory.new(1, 4, 0){
+  Version = Inventory.new(1, 5, 0){
+    def authors
+      Authors.new{
+        author 'Nikolai Weibull', 'now@disu.se'
+      }
+    end
+
+    def homepage
+      'http://disu.se/software/inventory'
+    end
+
+    def licenses
+      Licenses.new{
+        license 'LGPLv3+',
+                'GNU Lesser General Public License, version 3 or later',
+                'http://www.gnu.org/licenses/'
+      }
+    end
+
     def dependencies
       Dependencies.new{
-        development 'inventory-rake', 1, 4, 0
+        development 'inventory-rake', 1, 6, 0
+        development 'inventory-rake-tasks-yard', 1, 4, 0
         development 'lookout', 3, 0, 0
         development 'lookout-rake', 3, 0, 0
-        development 'yard', 0, 8, 5
+        development 'yard', 0, 8, 7
+        development 'yard-heuristics', 1, 2, 0
       }
     end
 
     def package_libs
-      %w[dependency.rb
+      %w[author.rb
+         authors.rb
+         dependency.rb
          dependencies.rb
          dependencies/development.rb
          dependencies/optional.rb
          dependencies/runtime.rb
-         extension.rb]
+         extension.rb
+         license.rb
+         licenses.rb]
     end
   }
 end

data/test/unit/inventory-1.0.rb

@@ -16,4 +16,12 @@ Expectations do
   expect 'a-1.0' do
     Inventory.new(1, 0, 0, 'a/lib/a/version.rb').package_require
   end
+
+  expect %w[LGPLv3+] do
+    Inventory::Version.licenses.map(&:to_s)
+  end
+
+  expect ['Nikolai Weibull <now@disu.se>'] do
+    Inventory::Version.authors.map(&:to_s)
+  end
 end

data/test/unit/inventory-1.0/author.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/inventory-1.0/authors.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/inventory-1.0/license.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

data/test/unit/inventory-1.0/licenses.rb

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+
+Expectations do
+end

metadata

@@ -1,17 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: inventory
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Nikolai Weibull
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-30 00:00:00.000000000 Z
+date: 2013-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inventory-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: inventory-rake-tasks-yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -58,61 +72,87 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.8.5
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: yard-heuristics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.8.5
+        version: '1.2'
 description: |2
                                      Inventory
 
-    Inventory keeps track of the contents of your Ruby¹ projects.  Such an
+    Inventory keeps track of the contents of your Ruby┬╣ projects.  Such an
     inventory can be used to load the project, create gem specifications and
-    gems, run unit tests, compile extensions, and verify that the project’s
+    gems, run unit tests, compile extensions, and verify that the projectΓÇÖs
     content is what you think it is.
 
-  ¹ See http://ruby-lang.org/
-
-  § Usage
-
-      Let’s begin by discussing the project structure that Inventory expects you
-      to use.  It’s pretty much exactly the same as the standard Ruby project
-      structure¹:
-
-        ├── README
-        ├── Rakefile
-        ├── lib
-        │   ├── foo-1.0
-        │   │   ├── bar.rb
-        │   │   └── version.rb
-        │   └── foo-1.0.rb
-        └── test
-            └── unit
-                ├── foo-1.0
-                │   ├── bar.rb
-                │   └── version.rb
-                └── foo-1.0.rb
-
-      Here you see a simplified version of a project called “Foo”’s project
+  ┬╣ See http://ruby-lang.org/
+
+  § Usage
+
+      LetΓÇÖs begin by discussing the project structure that Inventory expects you
+      to use.  ItΓÇÖs pretty much exactly the same as the standard Ruby project
+      structure┬╣:
+
+        Γö£ΓöÇΓöÇ README
+        Γö£ΓöÇΓöÇ Rakefile
+        Γö£ΓöÇΓöÇ lib
+        Γöé   Γö£ΓöÇΓöÇ foo-1.0
+        Γöé   Γöé   Γö£ΓöÇΓöÇ bar.rb
+        Γöé   Γöé   ΓööΓöÇΓöÇ version.rb
+        Γöé   ΓööΓöÇΓöÇ foo-1.0.rb
+        ΓööΓöÇΓöÇ test
+            ΓööΓöÇΓöÇ unit
+                Γö£ΓöÇΓöÇ foo-1.0
+                Γöé   Γö£ΓöÇΓöÇ bar.rb
+                Γöé   ΓööΓöÇΓöÇ version.rb
+                ΓööΓöÇΓöÇ foo-1.0.rb
+
+      Here you see a simplified version of a project called ΓÇ£FooΓÇ¥ΓÇÖs project
       structure.  The only real difference from the standard is that the main
-      entry point into the library is named “foo-1.0.rb” instead of “foo.rb” and
-      that the root sub-directory of “lib” is similarly named “foo-1.0” instead
-      of “foo”.  The difference is the inclusion of the API version.  This must
-      be the major version of the project followed by a constant “.0”.  The
+      entry point into the library is named ΓÇ£foo-1.0.rbΓÇ¥ instead of ΓÇ£foo.rbΓÇ¥ and
+      that the root sub-directory of ΓÇ£libΓÇ¥ is similarly named ΓÇ£foo-1.0ΓÇ¥ instead
+      of ΓÇ£fooΓÇ¥.  The difference is the inclusion of the API version.  This must
+      be the major version of the project followed by a constant ΓÇ£.0ΓÇ¥.  The
       reason for this is that it allows concurrent installations of different
       major versions of the project and means that the wrong version will never
       accidentally be loaded with require.
 
-      There’s a bigger difference in the content of the files.
-      ‹Lib/foo-1.0/version.rb› will contain our inventory instead of a String:
+      ThereΓÇÖs a bigger difference in the content of the files.
+      ‹Lib/foo-1.0/version.rb› will contain our inventory instead of a String:
 
         require 'inventory-1.0'
 
         class Foo
           Version = Foo.new(1, 4, 0){
+            authors{
+              author 'A. U. Thor', 'a.u.thor@example.org'
+            }
+
+            homepage 'http://example.org/'
+
+            licenses{
+              license 'LGPLv3+',
+                      'GNU Lesser General Public License, version 3 or later',
+                      'http://www.gnu.org/licenses/'
+            }
+
             def dependencies
               super + Dependencies.new{
                 development 'baz', 1, 3, 0
@@ -127,28 +167,33 @@ description: |2
           }
         end
 
-      We’re introducing quite a few concepts at once, and we’ll look into each in
-      greater detail, but we begin by setting the ‹Version› constant to a new
+      WeΓÇÖre introducing quite a few concepts at once, and weΓÇÖll look into each in
+      greater detail, but we begin by setting the ‹Version› constant to a new
       instance of an Inventory with major, minor, and patch version atoms 1, 4,
       and 0.  Then we add a couple of dependencies and list the library files
       that are included in this project.
 
-      The version numbers shouldn’t come as a surprise.  These track the version
-      of the API that we’re shipping using {semantic versioning}².  They also
-      allow the Inventory#to_s method to act as if you’d defined Version as
-      ‹'1.4.0'›.
+      The version numbers shouldnΓÇÖt come as a surprise.  These track the version
+      of the API that weΓÇÖre shipping using {semantic versioning}┬▓.  They also
+      allow the Inventory#to_s method to act as if youΓÇÖd defined Version as
+      ‹'1.4.0'›.
+
+      Next follows information about the authors of the project, the projectΓÇÖs
+      homepage, and the projectΓÇÖs licenses.  Each author has a name and an email
+      address.  The homepage is simply a string URL.  Licenses have an
+      abbreviation, a name, and a URL where the license text can be found.
 
-      We then extend the definition of ‹dependencies› by adding another set of
-      dependencies to ‹super›.  ‹Super› includes a dependency on the version of
-      the inventory project that’s being used with this project, so you’ll never
+      We then extend the definition of ‹dependencies› by adding another set of
+      dependencies to ‹super›.  ‹Super› includes a dependency on the version of
+      the inventory project thatΓÇÖs being used with this project, so youΓÇÖll never
       have to list that yourself.  The other three dependencies are all of
       different kinds: development, runtime, and optional.  A development
-      dependency is one that’s required while developing the project, for
+      dependency is one thatΓÇÖs required while developing the project, for
       example, a unit-testing framework, a documentation generator, and so on.
       Runtime dependencies are requirements of the project to be able to run,
       both during development and when installed.  Finally, optional dependencies
       are runtime dependencies that may or may not be required during execution.
-      The difference between runtime and optional is that the inventory won’t try
+      The difference between runtime and optional is that the inventory wonΓÇÖt try
       to automatically load an optional dependency, instead leaving that up to
       you to do when and if it becomes necessary.  By that logic, runtime
       dependencies will be automatically loaded, which is a good reason for
@@ -160,38 +205,38 @@ description: |2
 
       As mentioned, runtime dependencies will be automatically loaded and the
       feature they try to load is based on the name of the dependency with a
-      “-X.0” tacked on the end, where ‘X’ is the major version of the dependency.
-      Sometimes, this isn’t correct, in which case the :feature option may be
+      ΓÇ£-X.0ΓÇ¥ tacked on the end, where ΓÇÿXΓÇÖ is the major version of the dependency.
+      Sometimes, this isnΓÇÖt correct, in which case the :feature option may be
       given to specify the name of the feature.
 
       You may also override other parts of a dependency by passing in a block to
-      the dependency, much like we’re doing for inventories.
+      the dependency, much like weΓÇÖre doing for inventories.
 
       The rest of an inventory will list the various files included in the
       project.  This project only consists of one additional file to those that
       an inventory automatically include (Rakefile, README, the main entry point,
       and the version.rb file that defines the inventory itself), namely the
-      library file ‹bar.rb›.  Library files will be loaded automatically when the
-      main entry point file loads the inventory.  Library files that shouldn’t be
-      loaded may be listed under a different heading, namely “additional_libs”.
+      library file ‹bar.rb›.  Library files will be loaded automatically when the
+      main entry point file loads the inventory.  Library files that shouldnΓÇÖt be
+      loaded may be listed under a different heading, namely ΓÇ£additional_libsΓÇ¥.
       Both these sets of files will be used to generate a list of unit test files
       automatically, so each library file will have a corresponding unit test
-      file in the inventory.  We’ll discuss the different headings of an
+      file in the inventory.  WeΓÇÖll discuss the different headings of an
       inventory in more detail later on.
 
-      Now that we’ve written our inventory, let’s set it up so that it’s content
+      Now that weΓÇÖve written our inventory, letΓÇÖs set it up so that itΓÇÖs content
       gets loaded when our main entry point gets loaded.  We add the following
-      piece of code to ‹lib/foo-1.0.rb›:
+      piece of code to ‹lib/foo-1.0.rb›:
 
         module Foo
           load File.expand_path('../foo-1.0/version.rb', __FILE__)
           Version.load
         end
 
-      That’s all there’s to it.
+      ThatΓÇÖs all thereΓÇÖs to it.
 
       The inventory can also be used to great effect from a Rakefile using a
-      separate project called Inventory-Rake³.  Using it’ll give us tasks for
+      separate project called Inventory-Rake┬│.  Using itΓÇÖll give us tasks for
       cleaning up our project, compiling extensions, installing dependencies,
       installing and uninstalling the project itself, and creating and pushing
       distribution files to distribution points.
@@ -200,28 +245,23 @@ description: |2
 
         load File.expand_path('../lib/foo-1.0/version.rb', __FILE__)
 
-        Inventory::Rake::Tasks.define Foo::Version, :gem => proc{ |_, s|
-          s.author = 'Your Name'
-          s.email = 'you@example.com'
-          s.homepage = 'https://example.com/'
-        }
+        Inventory::Rake::Tasks.define Foo::Version
 
         Inventory::Rake::Tasks.unless_installing_dependencies do
           require 'lookout-rake-3.0'
           Lookout::Rake::Tasks::Test.new
         end
 
-      It’s ‹Inventory::Rake::Tasks.define› that does the heavy lifting.  It takes
-      our inventory and sets up the tasks mentioned above.  We also do some
-      additional customization of the gem specification.
+      It’s ‹Inventory::Rake::Tasks.define› that does the heavy lifting.  It takes
+      our inventory and sets up the tasks mentioned above.
 
       As we want to be able to use our Rakefile to install our dependencies for
       us, the rest of the Rakefile is inside the conditional
       #unless_installing_dependencies, which, as the name certainly implies,
       executes its block unless the task being run is the one that installs our
-      dependencies.  This becomes relevant when we set up Travis⁴ integration
+      dependencies.  This becomes relevant when we set up Travis⁴ integration
       next.  The only conditional set-up we do in our Rakefile is creating our
-      test task via Lookout-Rake⁵, which also uses our inventory to find the unit
+      test task via Lookout-Rake⁵, which also uses our inventory to find the unit
       tests to run when executed.
 
       Travis integration is straightforward.  Simply put
@@ -230,9 +270,9 @@ description: |2
           - gem install inventory-rake -v '~> VERSION' --no-rdoc --no-ri
           - rake gem:deps:install
 
-      in the project’s ‹.travis.yml› file, replacing ‹VERSION› with the version
-      of Inventory-Rake that you require.  This’ll make sure that Travis installs
-      all development, runtime, and optional dependencies that you’ve listed in
+      in the project’s ‹.travis.yml› file, replacing ‹VERSION› with the version
+      of Inventory-Rake that you require.  ThisΓÇÖll make sure that Travis installs
+      all development, runtime, and optional dependencies that youΓÇÖve listed in
       your inventory before running any tests.
 
       You might also need to put
@@ -240,22 +280,22 @@ description: |2
         env:
           - RUBYOPT=rubygems
 
-      in your ‹.travis.yml› file, depending on how things are set up.
+      in your ‹.travis.yml› file, depending on how things are set up.
 
-  ¹ Ruby project structure: http://guides.rubygems.org/make-your-own-gem/
-  ² Semantic versioning: http://semver.org/
-  ³ Inventory-Rake: http://disu.se/software/inventory-rake/
-  ⁴ Travis: http://travis-ci.org/
-  ⁵ Lookout-Rake: http://disu.se/software/lookout-rake/
+  ┬╣ Ruby project structure: http://guides.rubygems.org/make-your-own-gem/
+  ┬▓ Semantic versioning: http://semver.org/
+  ┬│ Inventory-Rake: http://disu.se/software/inventory-rake/
+  ⁴ Travis: http://travis-ci.org/
+  ⁵ Lookout-Rake: http://disu.se/software/lookout-rake/
 
-  § API
+  § API
 
-      If the guide above doesn’t provide you with all the answers you seek, you
-      may refer to the API¹ for more answers.
+      If the guide above doesnΓÇÖt provide you with all the answers you seek, you
+      may refer to the API┬╣ for more answers.
 
-  ¹ See http://disu.se/software/inventory/api/inventory/
+  ┬╣ See http://disu.se/software/inventory/api/Inventory/
 
-  § Financing
+  § Financing
 
       Currently, most of my time is spent at my day job and in my rather busy
       private life.  Please motivate me to spend time on this piece of software
@@ -265,46 +305,56 @@ description: |2
       to have other people give me the things that I need to continue living
       under the rules of said society.  So, if you feel that this piece of
       software has helped you out enough to warrant a reward, please PayPal a
-      donation to now@disu.se¹.  Thanks!  Your support won’t go unnoticed!
+      donation to now@disu.se┬╣.  Thanks!  Your support wonΓÇÖt go unnoticed!
 
-  ¹ Send a donation:
+  ┬╣ Send a donation:
     https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=now%40disu%2ese&item_name=Nikolai%20Weibull%20Software%20Services
 
-  § Reporting Bugs
+  § Reporting Bugs
 
-      Please report any bugs that you encounter to the {issue tracker}¹.
+      Please report any bugs that you encounter to the {issue tracker}┬╣.
 
-    ¹ See https://github.com/now/inventory/issues
+    ┬╣ See https://github.com/now/inventory/issues
 
-  § Authors
+  § Authors
 
       Nikolai Weibull wrote the code, the tests, the documentation, and this
       README.
-email: now@bitwi.se
+email:
+- now@disu.se
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/inventory-1.0/author.rb
+- lib/inventory-1.0/authors.rb
 - lib/inventory-1.0/dependency.rb
 - lib/inventory-1.0/dependencies.rb
 - lib/inventory-1.0/dependencies/development.rb
 - lib/inventory-1.0/dependencies/optional.rb
 - lib/inventory-1.0/dependencies/runtime.rb
 - lib/inventory-1.0/extension.rb
+- lib/inventory-1.0/license.rb
+- lib/inventory-1.0/licenses.rb
 - lib/inventory-1.0.rb
 - lib/inventory-1.0/version.rb
+- test/unit/inventory-1.0/author.rb
+- test/unit/inventory-1.0/authors.rb
 - test/unit/inventory-1.0/dependency.rb
 - test/unit/inventory-1.0/dependencies.rb
 - test/unit/inventory-1.0/dependencies/development.rb
 - test/unit/inventory-1.0/dependencies/optional.rb
 - test/unit/inventory-1.0/dependencies/runtime.rb
 - test/unit/inventory-1.0/extension.rb
+- test/unit/inventory-1.0/license.rb
+- test/unit/inventory-1.0/licenses.rb
 - test/unit/inventory-1.0.rb
 - test/unit/inventory-1.0/version.rb
 - README
 - Rakefile
-homepage: https://github.com/now/inventory
-licenses: []
+homepage: http://disu.se/software/inventory
+licenses:
+- LGPLv3+
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -322,8 +372,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.0
+rubygems_version: 2.0.2
 signing_key: 
 specification_version: 4
-summary: Inventory keeps track of the contents of your Ruby¹ projects.
+summary: Inventory keeps track of the contents of your Ruby┬╣ projects.
 test_files: []