tagutils 0.0.1 → 0.1.0

data/Manifest.txt

@@ -1,6 +1,8 @@
-History.md
+HISTORY.md
 Manifest.txt
 README.md
 Rakefile
 lib/tagutils.rb
+lib/tagutils/models.rb
+lib/tagutils/schema.rb
 lib/tagutils/version.rb

data/README.md

@@ -11,9 +11,118 @@ tagutils gems - tag utilities (tag, taggings, tag list, etc.)
 
 TBD
 
+
+## Real World Usage
+
+- [worlddb gem](http://rubygems.org/gems/worlddb) - continent, country, region, metro, city, district etc. models
+- [winedb gem](http://rubygems.org/gems/winedb) - wine, winery, winemaker, vineyards, etc. models 
+- [beerdb gem](http://rubygems.org/gems/beerdb) - beer, brand, brewery, etc. models
+
+
 ## Alternatives
 
-TBD
+- [acts_as_taggable_on](https://github.com/mbleigh/acts-as-taggable-on)
+
+~~~
+create_table :tags do |t|
+  t.string  :name
+end
+
+create_table :taggings do |t|
+  t.references :tag
+  t.references :taggable, :polymorphic => true
+  t.references :tagger,   :polymorphic => true
+  t.string     :context,  :limit => 128
+  t.datetime   :created_at
+end
+~~~
+
+(Source: [db/migrate/1_acts_as_taggable_on_migration.rb](https://github.com/mbleigh/acts-as-taggable-on/blob/master/db/migrate/1_acts_as_taggable_on_migration.rb))
+
+
+- [is_taggable](https://github.com/jamesgolick/is_taggable)
+
+~~~
+create_table :tags do |t|
+  t.string :name, :default => ''
+  t.string :kind, :default => ''
+end
+
+create_table :taggings do |t|
+  t.integer :tag_id
+
+  t.string  :taggable_type, :default => ''
+  t.integer :taggable_id
+end
+~~~
+
+(Source: [generators/is_taggable_migration/templates/migration.rb](https://github.com/jamesgolick/is_taggable/blob/master/generators/is_taggable_migration/templates/migration.rb))
+
+- [rocket_tag](https://github.com/bradphelan/rocket_tag)
+
+~~~
+create_table :tags do |t|
+  t.string :name
+end
+
+create_table :taggings do |t|
+  t.references :tag
+  t.references :taggable, :polymorphic => true
+  t.references :tagger,   :polymorphic => true
+  t.string     :context
+  t.datetime   :created_at
+end
+
+create_table :alias_tags, :id => false do |t|
+  t.integer :tag_id
+  t.integer :alias_id
+end
+~~~
+
+(Source: [generators/rocket_tag/migration/templates/active_record/migration.rb](https://github.com/bradphelan/rocket_tag/blob/master/lib/generators/rocket_tag/migration/templates/active_record/migration.rb))
+
+
+- [acts_as_taggable_redux](https://github.com/geemus/acts_as_taggable_redux)
+
+~~~
+create_table :tags do |t|
+  t.column :name,           :string
+  t.column :taggings_count, :integer, :default => 0, :null => false
+end
+ 
+create_table :taggings do |t|
+  t.column :tag_id, :integer
+  t.column :taggable_id, :integer
+  t.column :taggable_type, :string
+  t.column :user_id, :integer
+end 
+~~~
+
+(Source: [generators/acts_as_taggable_tables/templates/migration.rb](https://github.com/geemus/acts_as_taggable_redux/blob/master/generators/acts_as_taggable_tables/templates/migration.rb))
+
+
+- [acts_as_taggable_on_steroids](https://github.com/mattetti/acts_as_taggable_on_steroids)
+
+~~~
+create_table :tags do |t|
+  t.column :name, :string
+end
+    
+create_table :taggings do |t|
+  t.column :tag_id,        :integer
+  t.column :taggable_id,   :integer
+  t.column :taggable_type, :string
+      
+  t.column :created_at,    :datetime
+end
+~~~
+
+(Source: [generators/acts_as_taggable_migration/templates/migration.rb](https://github.com/mattetti/acts_as_taggable_on_steroids/blob/master/generators/acts_as_taggable_migration/templates/migration.rb))
+
+
+- [Ruby Toolbook - Rails Tagging Category](https://www.ruby-toolbox.com/categories/rails_tagging)
+
+
 
 ## License
 

data/Rakefile

@@ -15,7 +15,7 @@ Hoe.spec 'tagutils' do
 
   # switch extension to .markdown for gihub formatting
   self.readme_file  = 'README.md'
-  self.history_file = 'History.md'
+  self.history_file = 'HISTORY.md'
 
   self.extra_deps = [
     ['logutils', '>= 0.5']

data/lib/tagutils.rb

@@ -1,22 +1,55 @@
 
+# 3rd party gems / libs
+
+require 'active_record'   ## todo: add sqlite3? etc.
+require 'logutils'
+
+
+# our own code
 
 require 'tagutils/version'  # let it always go first
 
+require 'tagutils/schema'
+require 'tagutils/models'
+
 
 module TagUtils
 
   def self.banner
-    "tagutils #{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+    "tagutils/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
   end
 
-=begin
   def self.root
     "#{File.expand_path( File.dirname(File.dirname(__FILE__)) )}"
   end
-=end
 
 end  # module TagUtils
 
 
+
+module TagDb
+  def self.create
+    CreateDb.new.up
+    ## WorldDb::Model::Prop.create!( key: 'db.schema.world.version', value: VERSION )
+  end
+
+  # delete ALL records (use with care!)
+  def self.delete!
+    ## fix: use Deleter (see sportdb etc.)
+    puts '*** deleting tag/tagging table records/data...'
+    Model::Tagging.delete_all
+    Model::Tag.delete_all
+  end # method delete!
+
+  def self.tables
+    ## fix: use Stats class (see sportdb etc.)
+    puts "#{Model::Tag.count} tags"
+    puts "#{Model::Tagging.count} taggings"
+  end
+
+end # module TagDb
+
+
+
 puts TagUtils.banner    # say hello
 

data/lib/tagutils/models.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+module TagDb
+  module Model
+
+
+class Tag < ActiveRecord::Base
+
+  ###########################################################################3
+  # alias for name (remove! add depreciated api call) ?? why? why not??
+  def title()       name;              end
+  def title=(value) self.name = value; end
+
+end   # class Tag
+
+
+class Tagging < ActiveRecord::Base
+  # add code here
+end   # class Tagging
+
+
+
+  end # module Model
+
+  ##### add convenience module alias in plural e.g. lets you use include TagDb::Models
+  Models = Model
+
+end # module TagDb

data/lib/tagutils/schema.rb

@@ -0,0 +1,37 @@
+# encoding: utf-8
+
+module TagDb
+
+class CreateDb < ActiveRecord::Migration
+
+  def up
+
+create_table :tags do |t|
+  t.string  :key,   null: false
+  t.string  :slug,  null: false
+  t.string  :name    # todo: make required?  -- note: was title formerly
+  t.integer :grade, null: false, default: 1  # grade/tier e.g. 1/2/3 for now
+  ## todo: add parent or similar for hierachy (for tag stacks/packs)
+  t.timestamps   # todo: use only t.datetime :created_at (do we get ar magic? is updated used/needed??)
+end
+
+add_index :tags, :key,  unique: true
+
+create_table :taggings do |t|
+  t.references :tag,      null: false
+  t.references :taggable, polymorphic: true
+  t.timestamps   # todo: use only t.datetime :created_at (do we get ar magic? is updated used/needed??)
+end
+
+add_index :taggings, :tag_id
+add_index :taggings, [:taggable_id, :taggable_type]
+
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration
+  end
+
+end  # class CreateDb
+
+end # module TagDb

data/lib/tagutils/version.rb

@@ -1,4 +1,5 @@
 
 module TagUtils
-   VERSION = '0.0.1'
+   VERSION = '0.1.0'
 end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tagutils
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-19 00:00:00.000000000 Z
+date: 2014-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logutils
-  requirement: &71336840 !ruby/object:Gem::Requirement
+  requirement: &74247220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0.5'
   type: :runtime
   prerelease: false
-  version_requirements: *71336840
+  version_requirements: *74247220
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &71335620 !ruby/object:Gem::Requirement
+  requirement: &74246900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '3.10'
   type: :development
   prerelease: false
-  version_requirements: *71335620
+  version_requirements: *74246900
 - !ruby/object:Gem::Dependency
   name: hoe
-  requirement: &71335150 !ruby/object:Gem::Requirement
+  requirement: &74246500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,7 +43,7 @@ dependencies:
         version: '3.3'
   type: :development
   prerelease: false
-  version_requirements: *71335150
+  version_requirements: *74246500
 description: tagutils - tag utilities (tag, taggings, tag list, etc.)
 email: webslideshow@googlegroups.com
 executables: []
@@ -51,11 +51,13 @@ extensions: []
 extra_rdoc_files:
 - Manifest.txt
 files:
-- History.md
+- HISTORY.md
 - Manifest.txt
 - README.md
 - Rakefile
 - lib/tagutils.rb
+- lib/tagutils/models.rb
+- lib/tagutils/schema.rb
 - lib/tagutils/version.rb
 homepage: https://github.com/rubylibs/tagutils
 licenses: