machine_tag 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in machine_tag.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Douglas Thrift
+
+MIT License
+
+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.

data/README.md

@@ -0,0 +1,89 @@
+# MachineTag
+
+[![Gem Version](https://badge.fury.io/rb/machine_tag.png)](http://badge.fury.io/rb/machine_tag)
+[![Build Status](https://travis-ci.org/douglaswth/machine_tag.png?branch=master)](https://travis-ci.org/douglaswth/machine_tag)
+[![Dependency Status](https://gemnasium.com/douglaswth/machine_tag.png)](https://gemnasium.com/douglaswth/machine_tag)
+
+MachineTag is a Ruby library for using machine tags like those used on [Flickr] and [RightScale].
+
+[Flickr]: http://www.flickr.com/help/tags/#613430
+[RightScale]: http://support.rightscale.com/12-Guides/RightScale_101/06-Advanced_Concepts/Tagging
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'machine_tag'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install machine_tag
+
+## Usage
+
+MachineTag provides two classes for dealing with machine tags and tags in general: `MachineTag::Tag`
+and `MachineTag::Set`:
+
+### MachineTag::Tag
+
+The MachineTag::Tag class represents a tag which can either be a machine tag or a plain tag. It 
+inherits from [String] so it can be used in the same ways.
+
+[String]: http://ruby-doc.org/core-1.9.3/String.html
+
+```ruby
+plain_tag = MachineTag::Tag.new('geotagged')
+
+plain_tag == 'geotagged'    # => true
+plain_tag.machine_tag?      # => false
+
+machine_tag = MachineTag::Tag.new('geo:lat=34.4348067')
+
+machine_tag == 'geo:lat=34.4348067'     # => true
+machine_tag.machine_tag?                # => true
+machine_tag.namespace                   # => "geo"
+machine_tag.predicate                   # => "lat"
+machine_tag.namespace_and_predicate     # => "geo:lat"
+machine_tag.value.to_f                  # => 34.4348067
+
+machine_tag = MachineTag::Tag.machine_tag('geo', 'lon', -119.8016962)
+
+machine_tag == 'geo:lon=-119.8016962'   # => true
+machine_tag.machine_tag?                # => true
+```
+
+### MachineTag::Set
+
+The `MachineTag::Set` class represents a set of tags and provides a way of looking them up by
+namespace or by namespace and predicate. It inherits from the [Set] so it can be used in the same
+ways. If `String` objects are passed into it they will automatically be converted to
+`MachineTag::Tag` objects.
+
+[Set]: http://ruby-doc.org/stdlib-1.9.3/libdoc/set/rdoc/Set.html
+
+```ruby
+tags = MachineTag::Set['geotagged', 'geo:lat=34.4348067', 'geo:lon=-119.8016962']
+
+tags.include?('geotagged')  # => true
+tags.plain_tags             # => #<Set: {"geotagged"}>
+tags.machine_tags           # => #<Set: {"geo:lat=34.4348067", "geo:lon=-119.8016962"}>
+tags['geo']                 # => #<Set: {"geo:lat=34.4348067", "geo:lon=-119.8016962"}>
+tags['geo:lat']             # => #<Set: {"geo:lat=34.4348067"}>
+tags['geo', 'lon']          # => #<Set: {"geo:lon=-119.8016962"}>
+```
+
+More information can be found in the [documentation].
+
+[documentation]: http://rubydoc.info/gems/machine_tag/frame
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "yard"
+
+RSpec::Core::RakeTask.new(:spec)
+YARD::Rake::YardocTask.new
+
+task :default => :spec

data/lib/machine_tag.rb

@@ -0,0 +1,26 @@
+# Copyright (c) 2013 Douglas Thrift
+#
+# MIT License
+#
+# 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.
+
+require "machine_tag/version"
+require "machine_tag/tag"
+require "machine_tag/set"

data/lib/machine_tag/set.rb

@@ -0,0 +1,113 @@
+# Copyright (c) 2013 Douglas Thrift
+#
+# MIT License
+#
+# 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.
+
+require 'set'
+
+module MachineTag
+  # Set of tags which can be machine tags.
+  #
+  class Set < ::Set
+    # The tags in the set which are not machine tags
+    #
+    # @return [::Set<Tag>] the tags in the set which are not machine tags
+    #
+    attr_reader :plain_tags
+
+    # The tags in the set which are machine tags
+    #
+    # @return [::Set<Tag>] the tags in the set which are machine tags
+    #
+    attr_reader :machine_tags
+
+    # Creates a set of tags which can be machine tags. If String objects are passed in they will be
+    # converted to {Tag}.
+    #
+    # @param enum [Enumerable<Tag, String>, nil] the enumerable object of tags
+    # @param block [Proc] the optional block to preprocess elements before inserting them
+    #
+    def initialize(enum = nil, &block)
+      @plain_tags = ::Set.new
+      @machine_tags = ::Set.new
+      @tags_by_namespace = {}
+      @tags_by_namespace_and_predicate = {}
+      super
+    end
+
+    # Adds a tag to the set of tags. If a String object is passed in it will be converted to {Tag}.
+    #
+    # @param tag [Tag, String] the tag or string to add
+    #
+    # @return [Set] the tag set
+    #
+    def add(tag)
+      tag = Tag.new(tag) unless tag.is_a? Tag
+      super(tag)
+
+      if tag.machine_tag?
+        @machine_tags << tag
+        @tags_by_namespace[tag.namespace] ||= ::Set.new
+        @tags_by_namespace[tag.namespace] << tag
+        @tags_by_namespace_and_predicate[tag.namespace_and_predicate] ||= ::Set.new
+        @tags_by_namespace_and_predicate[tag.namespace_and_predicate] << tag
+      else
+        @plain_tags << tag
+      end
+
+      self
+    end
+    alias_method :<<, :add
+
+    # Retrieves machine tags in the Set with a matching namespace or namespace and predicate.
+    #
+    # @example
+    #   tags = MachineTag::Set['a:b=x', 'a:b=y', 'a:c=z']
+    #   tags['a']       # => #<Set: {"a:b=x", "a:b=y", "a:c=z"}>
+    #   tags['a', 'b']  # => #<Set: {"a:b=x", "a:b=y"}>
+    #   tags['a:c']     # => #<Set: {"a:c=z"}>
+    #
+    # @param namespace_or_namespace_and_predicate [String] the namespace to retrieve or the namespace
+    #   and predicate to retreive combined in a string separated by +':'+
+    # @param predicate [String, nil] the predicate to retreive
+    #
+    # @return [::Set<Tag>] the machines tags that have the given namespace or namespace and predicate
+    #
+    def [](namespace_or_namespace_and_predicate, predicate = nil)
+      if namespace_or_namespace_and_predicate =~ /^#{PREFIX}$/
+        namespace = namespace_or_namespace_and_predicate
+
+        unless predicate
+          @tags_by_namespace[namespace]
+        else
+          raise ArgumentError, "Invalid machine tag predicate: #{predicate.inspect}" unless predicate =~ /^#{PREFIX}$/
+          @tags_by_namespace_and_predicate["#{namespace}:#{predicate}"]
+        end
+      elsif namespace_or_namespace_and_predicate =~ /^#{NAMESPACE_AND_PREDICATE}$/
+        namespace_and_predicate = namespace_or_namespace_and_predicate
+        raise ArgumentError, "Separate predicate passed with namespace and predicate: #{namespace_and_predicate.inspect}, #{predicate.inspect}" if predicate
+        @tags_by_namespace_and_predicate[namespace_and_predicate]
+      else
+        raise ArgumentError, "Invalid machine tag namespace and/or predicate: #{namespace_or_namespace_and_predicate.inspect}, #{predicate.inspect}"
+      end
+    end
+  end
+end

data/lib/machine_tag/tag.rb

@@ -0,0 +1,112 @@
+# Copyright (c) 2013 Douglas Thrift
+#
+# MIT License
+#
+# 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.
+
+module MachineTag
+  # The regular expression for matching the individual namespace and predicate portions of a machine tag
+  #
+  # @return [Regexp] the regular expression for matching the individual namespace and predicate
+  #   portions of a machine tag
+  #
+  PREFIX = /[a-z][a-z0-9_]*/i
+
+  # The regular expression for matching the namespace and predicate portion of a machine tag
+  #
+  # @return [Regexp] the regular expression for matching the namespace and predicate portion of a machine tag
+  #
+  NAMESPACE_AND_PREDICATE = /(?<namespace>#{PREFIX}):(?<predicate>#{PREFIX})/
+
+  # The regular expression for matching a machine tag
+  #
+  # @return [Regexp] the regular expression for matching a machine tag
+  #
+  MACHINE_TAG = /^(?<namespace_and_predicate>#{NAMESPACE_AND_PREDICATE})=(?<value>.*)$/
+
+  # A tag which can be a machine tag.
+  #
+  class Tag < String
+    # The namespace portion of the machine tag, +nil+ if the tag is not a machine tag
+    #
+    # @return [String, nil] the namespace portion of the machine tag, +nil+ if the tag is not a machine tag
+    #
+    attr_reader :namespace
+
+    # The predicate portion of the machine tag, +nil+ if the tag is not a machine tag
+    #
+    # @return [String, nil] the predicate portion of the machine tag, +nil+ if the tag is not a machine tag
+    #
+    attr_reader :predicate
+
+    # The namespace and predicate portion of the machine tag, +nil+ if the tag is not a machine tag
+    #
+    # @return [String, nil] the namespace and predicate portion of the machine tag, +nil+ if the tag
+    #   is not a machine tag
+    #
+    attr_reader :namespace_and_predicate
+
+    # The value portion of the machine tag, +nil+ if the tag is not a machine tag
+    #
+    # @return [String, nil] the value portion of the machine tag is not a machine tag
+    #
+    attr_reader :value
+
+    # Creates a tag object which can be a machine tag.
+    #
+    # @param str [String] the tag string
+    #
+    def initialize(str)
+      super
+      if match = self.match(MACHINE_TAG)
+        @namespace_and_predicate = match[:namespace_and_predicate]
+        @namespace = match[:namespace]
+        @predicate = match[:predicate]
+        @value = match[:value]
+        @value = $1 if @value =~ /^"(.*)"$/
+      end
+    end
+
+    # Creates a machine tag from a given namespace, predicate, and value.
+    #
+    # @param namespace [String] the namespace
+    # @param predicate [String] the predicate
+    # @param value [String, #to_s] the value
+    #
+    # @return [Tag] the machine tag
+    #
+    # @raise [ArgumentError] if the +namespace+ or +predicate+ are not in the correct format
+    #
+    def self.machine_tag(namespace, predicate, value)
+      raise ArgumentError, "Invalid machine tag namespace: #{namespace.inspect}" unless namespace =~ /^#{PREFIX}$/
+      raise ArgumentError, "Invalid machine tag predicate: #{predicate.inspect}" unless predicate =~ /^#{PREFIX}$/
+
+      new("#{namespace}:#{predicate}=#{value}")
+    end
+
+    # Returns whether this tag is a machine tag or not.
+    #
+    # @return [Boolean] +true+ if this tag is a machine tag, otherwise +false+
+    #
+    def machine_tag?
+      !!namespace
+    end
+  end
+end

data/lib/machine_tag/version.rb

@@ -0,0 +1,30 @@
+# Copyright (c) 2013 Douglas Thrift
+#
+# MIT License
+#
+# 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.
+
+# Library for using Machine Tags.
+#
+module MachineTag
+  # The version of this library.
+  #
+  VERSION = "1.0.0"
+end

data/machine_tag.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'machine_tag/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "machine_tag"
+  spec.version       = MachineTag::VERSION
+  spec.authors       = ["Douglas Thrift"]
+  spec.email         = ["douglas@douglasthrift.net"]
+  spec.description   = %q{A Ruby library for using machine tags like those used on Flickr and RightScale}
+  spec.summary       = %q{Library for using machine tags}
+  spec.homepage      = "https://github.com/douglaswth/machine_tag"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rdoc"
+  spec.add_development_dependency "redcarpet"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "yard", "~> 0.8.7.2"
+end

data/spec/machine_tag_set_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+
+describe MachineTag::Set do
+  it 'should create sets with plain tags' do
+    tags = MachineTag::Set['a', 'b', 'c']
+    tags.should eq Set['a', 'b', 'c']
+    tags.plain_tags.should eq Set['a', 'b', 'c']
+    tags.machine_tags.should be_empty
+  end
+
+  it 'should create sets with machine tags' do
+    tags = MachineTag::Set['a:b=x', 'a:b=y', 'a:c=z', 'd:e=f']
+    tags.should eq Set['a:b=x', 'a:b=y', 'a:c=z', 'd:e=f']
+    tags.plain_tags.should be_empty
+    tags.machine_tags.should eq Set['a:b=x', 'a:b=y', 'a:c=z', 'd:e=f']
+    tags['a'].should eq Set['a:b=x', 'a:b=y', 'a:c=z']
+    tags['a:b'].should eq Set['a:b=x', 'a:b=y']
+    tags['a', 'c'].should eq Set['a:c=z']
+  end
+
+  it 'should create sets with mixed plain and machine tags' do
+    tags = MachineTag::Set['a:b=x', 'a:b=y', 'a:c=z', 'd', 'e', 'f']
+    tags.should eq Set['a:b=x', 'a:b=y', 'a:c=z', 'd', 'e', 'f']
+    tags.plain_tags.should eq Set['d', 'e', 'f']
+    tags.machine_tags.should eq Set['a:b=x', 'a:b=y', 'a:c=z']
+    tags['a'].should eq Set['a:b=x', 'a:b=y', 'a:c=z']
+    tags['a:b'].should eq Set['a:b=x', 'a:b=y']
+    tags['a', 'c'].should eq Set['a:c=z']
+  end
+
+  describe '#add' do
+    let(:tags) { MachineTag::Set.new }
+
+    it 'should add strings' do
+      tags << 'a'
+      tags.first.should be_an_instance_of(MachineTag::Tag)
+    end
+
+    it 'should add tags' do
+      tag = MachineTag::Tag.new('a')
+      tags << tag
+      tags.first.should be(tag)
+    end
+  end
+
+  describe '#[]' do
+    let(:tags) { MachineTag::Set.new }
+
+    it 'should not retrieve with an invalid predicate' do
+      expect do
+        tags['a', '!']
+      end.to raise_error(ArgumentError, 'Invalid machine tag predicate: "!"')
+    end
+
+    it 'should not retrieve with a combined namespace and predicate and a predicate' do
+      expect do
+        tags['a:b', 'c']
+      end.to raise_error(ArgumentError, 'Separate predicate passed with namespace and predicate: "a:b", "c"')
+    end
+
+    it 'should not retreive with an invalid namespace and/or predicate' do
+      expect do
+        tags['!']
+      end.to raise_error(ArgumentError, 'Invalid machine tag namespace and/or predicate: "!", nil')
+
+      expect do
+        tags['a:!']
+      end.to raise_error(ArgumentError, 'Invalid machine tag namespace and/or predicate: "a:!", nil')
+    end
+  end
+end

data/spec/machine_tag_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe MachineTag do
+  it 'should have a version number' do
+    MachineTag::VERSION.should_not be_nil
+  end
+end

data/spec/machine_tag_tag_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe MachineTag::Tag do
+  it 'should create plain tags' do
+    tag = MachineTag::Tag.new('a')
+    tag.should eq 'a'
+    tag.namespace.should be_nil
+    tag.predicate.should be_nil
+    tag.namespace_and_predicate.should be_nil
+    tag.value.should be_nil
+    tag.machine_tag?.should be_false
+  end
+
+  it 'should create machine tags' do
+    tag = MachineTag::Tag.new('a:b=c')
+    tag.should eq 'a:b=c'
+    tag.namespace.should eq 'a'
+    tag.predicate.should eq 'b'
+    tag.namespace_and_predicate.should eq 'a:b'
+    tag.value.should eq 'c'
+    tag.machine_tag?.should be_true
+  end
+
+  it 'should handle a machine tag with a quoted value' do
+    tag = MachineTag::Tag.new('a:b="c d"')
+    tag.should eq 'a:b="c d"'
+    tag.namespace.should eq 'a'
+    tag.predicate.should eq 'b'
+    tag.namespace_and_predicate.should eq 'a:b'
+    tag.value.should eq 'c d'
+    tag.machine_tag?.should be_true
+  end
+
+  describe '::machine_tag' do
+    it 'should create machine tags' do
+      tag = MachineTag::Tag.machine_tag('a', 'b', 'c')
+      tag.should eq 'a:b=c'
+      tag.namespace.should eq 'a'
+      tag.predicate.should eq 'b'
+      tag.namespace_and_predicate.should eq 'a:b'
+      tag.value.should eq 'c'
+      tag.machine_tag?.should be_true
+    end
+
+    it 'should not create machine tags with invalid namespaces' do
+      expect do
+        MachineTag::Tag.machine_tag('!', 'b', 'c')
+      end.to raise_error(ArgumentError, 'Invalid machine tag namespace: "!"')
+    end
+
+    it 'should not create machine tags with invalid predicates' do
+      expect do
+        MachineTag::Tag.machine_tag('a', '!', 'c')
+      end.to raise_error(ArgumentError, 'Invalid machine tag predicate: "!"')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'machine_tag'

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: machine_tag
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Douglas Thrift
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7.2
+description: A Ruby library for using machine tags like those used on Flickr and RightScale
+email:
+- douglas@douglasthrift.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/machine_tag.rb
+- lib/machine_tag/set.rb
+- lib/machine_tag/tag.rb
+- lib/machine_tag/version.rb
+- machine_tag.gemspec
+- spec/machine_tag_set_spec.rb
+- spec/machine_tag_spec.rb
+- spec/machine_tag_tag_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/douglaswth/machine_tag
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Library for using machine tags
+test_files:
+- spec/machine_tag_set_spec.rb
+- spec/machine_tag_spec.rb
+- spec/machine_tag_tag_spec.rb
+- spec/spec_helper.rb
+has_rdoc: