@@ -1,4 +1,4 @@ == 0.0.1 2008-07-10 * 1 major enhancement: - * Initial release + * Initial release \ No newline at end of file History.txt @@ -1,4 +1,4 @@ -Copyright (c) 2008 FIXME full name +Copyright (c) 2008 Bobby Calderwood Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the License.txt @@ -1,25 +0,0 @@ -History.txt -License.txt -Manifest.txt -PostInstall.txt -README.txt -Rakefile -config/hoe.rb -config/requirements.rb -lib/dm-tags.rb -lib/dm_tags/version.rb -script/console -script/destroy -script/generate -script/txt2html -setup.rb -tasks/deployment.rake -tasks/environment.rake -tasks/website.rake -test/test_helper.rb -test/test_dm_tags.rb -website/index.html -website/index.txt -website/javascripts/rounded_corners_lite.inc.js -website/stylesheets/screen.css -website/template.html.erb Manifest.txt @@ -1,32 +1,96 @@ = dm-tags -* FIX (url) - -== DESCRIPTION: - -FIX (describe your package) - -== FEATURES/PROBLEMS: - -* FIX (list of features or problems) - -== SYNOPSIS: - - FIX (code sample of usage) - -== REQUIREMENTS: - -* FIX (list of requirements) - -== INSTALL: - -* FIX (sudo gem install, anything else) - -== LICENSE: +* http://github.com/bobby/dm-tags/ + +== Description + +This package brings tagging to DataMapper. It is inspired by Acts As Taggable On by Michael Bleigh, github's mbleigh. Props to him for the contextual tagging based on Acts As Taggable on Steroids. + +== Features and Problems + +=== Features + +* Contextual tagging using Model.has_tags_on (see below for usage) +* Traditional 'tags-only' tagging using Model.has_tags + +=== Problems + +* None known yet, but this is very alpha software. Sorry if it misbehaves. Please send me a github message if you find a bug. + +== Synopsis + +<pre> + <code> + require 'dm-core' + require 'dm-tags' + + class MyModel + include DataMapper::Resource + property :id, Integer, :serial => true + has_tags_on :tags, :skills + end + + MyModel.auto_migrate! + + # Contextual tagging + MyModel.taggable? #=> true + MyModel.new.taggable? #=> true + + model = MyModel.new + model.tag_list = 'test, me out, please ' + model.tag_list #=> ['me out', 'please', 'test'] # Sanitized and alphabetized + model.save #=> true + model.tags #=> [#<Tag id=1 name="me out">, #<Tag id=2 name="please">, #<Tag id=3 name="test">] + model.tag_list = 'test, again' + model.save #=> true + model.tags #=> [#<Tag id=3 name="test">, #<Tag id=4 name="again">] # Checks for existing tags + Tag.all #=> [#<Tag id=1 name="me out">, #<Tag id=2 name="please">, #<Tag id=3 name="test">, #<Tag id=4 name="again">] + another = MyModel.new + another.tag_list = 'test, all, you, like' + another.save + MyModel.tagged_with('test') #=> [#<TaggedModel id=1>, #<TaggedModel id=2>] + + # Traditional 'tags only' tagging + + class TagsOnly + include DataMapper::Resource + property :id, Integer, :serial => true + has_tags + end + + TagsOnly.auto_migrate! + + TagsOnly.taggable? #=> true + TagsOnly.new.taggable? #=> true + + tags_only = TagsOnly.new + tags_only.tag_list = 'tags, only' + tags_only.tag_list #=> ['only', 'tags'] + tags_only.save #=> true + tags_only.tags #=> [#<Tag id=5 name="only">, #<Tag id=6 name="tags">] + </code> +</pre> + +== Requirements + +* DataMapper (dm-core) +* Merb (For Merb's inflector. This dependency will be removed in future versions.) + +== Installation + +<pre> + <code> + git clone http://github.com/bobby/dm-tags + cd dm-tags + rake install + </code> +</pre> + +== License (The MIT License) -Copyright (c) 2008 FIXME full name +Copyright (c) 2008 Bobby Calderwood Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the README.txt @@ -1,17 +1,17 @@ require 'dm_tags/version' AUTHOR = 'Bobby Calderwood' # can also be an array of Authors -EMAIL = "bobby_calderwood@mac.com" +EMAIL = "bobby_calderwood@me.com" DESCRIPTION = <<-DESC -This is an effort to bring tagging to Merb. It supports DataMapper and ActiveRecord. -It is based on acts-as-taggable-on, and its ancestors. Props to Michael Bleigh for AATO. + DESC GEM_NAME = 'dm-tags' # what ppl will type to install your gem RUBYFORGE_PROJECT = 'dm-tags' # The unix name for your project HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org" DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}" EXTRA_DEPENDENCIES = [ -# ['activesupport', '>= 1.3.1'] + ['dm-core', '>= 0.9.3'], + ['merb-core', '>= 0.9.4'] ] # An array of rubygem dependencies [name, version] @config_file = "~/.rubyforge/user-config.yml" @@ -59,7 +59,7 @@ $hoe = Hoe.new(GEM_NAME, VERS) do |p| p.summary = DESCRIPTION p.url = HOMEPATH p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT - p.test_globs = ["test/**/test_*.rb"] + p.test_globs = ["spec/**/*_spec.rb"] p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store'] #An array of file patterns to delete on clean. # == Optional config/hoe.rb @@ -2,7 +2,7 @@ require 'fileutils' include FileUtils require 'rubygems' -%w[rake hoe newgem rubigen merb-core].each do |req_gem| +%w[rake hoe newgem rubigen spec dm-core merb-core].each do |req_gem| begin require req_gem rescue LoadError config/requirements.rb @@ -24,7 +24,7 @@ describe DataMapper::Tags do class TestModel include DataMapper::Resource property :id, Integer, :serial => true - + has_tags_on(:pets, 'skills', :tags) end TestModel.should be_taggable @@ -38,4 +38,26 @@ describe DataMapper::Tags do a.should respond_to(:tag_list=) end end + + describe ".has_tags" do + it "should create a taggable with 'tags' context regardless of passed arguments" do + class TagsOnly + include DataMapper::Resource + property :id, Integer, :serial => true + has_tags :pets, :skills + end + TagsOnly.should be_taggable + TagsOnly.new.should be_taggable + a = TagsOnly.new + a.should respond_to(:tag_list) + a.should respond_to(:tag_list=) + a.should respond_to(:tags) + a.should_not respond_to(:pet_list) + a.should_not respond_to(:pet_list=) + a.should_not respond_to(:pets) + a.should_not respond_to(:skill_list) + a.should_not respond_to(:skill_list=) + a.should_not respond_to(:skills) + end + end end \ No newline at end of file spec/dm_tags/dm_tags_spec.rb @@ -37,7 +37,7 @@ </div> <%= body %> <p class="coda"> - <a href="FIXME email">FIXME full name</a>, <%= modified.pretty %><br> + <a href="bobby_calderwood@me.com">Bobby Calderwood</a>, <%= modified.pretty %><br> Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a> </p> </div> website/template.html.erb PostInstall.txt e31ddd866d0ee34acd19ee72845515cb4bc365c3 bobby bobby_calderwood@mac.com http://github.com/bobby/dm-tags/commit/d5415153cb7081efe44cbdb5bf621cb67f900fea d5415153cb7081efe44cbdb5bf621cb67f900fea 2008-07-29T15:28:14-07:00 2008-07-29T15:28:14-07:00 Tweaked gem configuration. 3bb5568851656df4fab10b286462c3515ea53eef bobby bobby_calderwood@mac.com