tagutils 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e34415c99adfedcb4bd078a328b52a7c9f418931
-  data.tar.gz: ba4d539d363122e793a0b8fac7609025520623cc
+  metadata.gz: c710e607cd4a57a3a1562e5b18c3b32ebc6039a5
+  data.tar.gz: d91d3322c08f33d66544fe43a8ace843a18f6d82
 SHA512:
-  metadata.gz: c2ae676b1df654904a593519c0bfbb1874ebaaebf299977809b7c6ff007baef78be882d7ae00ffa1e1a662427b002131d7bc50c517f3a5946a5a1c5e7ffdef53
-  data.tar.gz: f262dc809c38d893e7020be236bbfa5c9cbcceac3f49a38d6fc746862f43f268ba69739d578b84c1ec84cd9dec892ae5ba63026e2c18e05abdcad2d071be86fa
+  metadata.gz: 232f56d3800b84452ea1165a84d98339c209a103737cbc2f485f5fd360680da19abdbcaadfaab38e4b48869c7f12b366eb0cc5e6c8e26718adbf84dfa524bbae
+  data.tar.gz: 01b660a5c2e57b2c35e936ccf89cfbd862eca993877d7c035ddedec71d5d3436867bb7c0cade9396df6d51227f5f1adb6fe1cc11978b1c6761f8b65af1cbc514

data/Manifest.txt

@@ -1,24 +1,24 @@
-HISTORY.md
-Manifest.txt
-README.md
-Rakefile
-lib/tagutils.rb
-lib/tagutils/categories.rb
-lib/tagutils/categories/active_record.rb
-lib/tagutils/categories/models/categorization.rb
-lib/tagutils/categories/models/category.rb
-lib/tagutils/categories/models/category_comp.rb
-lib/tagutils/categories/schema.rb
-lib/tagutils/tags.rb
-lib/tagutils/tags/active_record.rb
-lib/tagutils/tags/models/tag.rb
-lib/tagutils/tags/models/tag_comp.rb
-lib/tagutils/tags/models/tagging.rb
-lib/tagutils/tags/patterns.rb
-lib/tagutils/tags/readers/tag.rb
-lib/tagutils/tags/schema.rb
-lib/tagutils/version.rb
-test/helper.rb
-test/tags.1.yml
-test/test_models.rb
-test/test_tag_reader.rb
+HISTORY.md
+Manifest.txt
+README.md
+Rakefile
+lib/tagutils.rb
+lib/tagutils/categories.rb
+lib/tagutils/categories/active_record.rb
+lib/tagutils/categories/models/categorization.rb
+lib/tagutils/categories/models/category.rb
+lib/tagutils/categories/models/category_comp.rb
+lib/tagutils/categories/schema.rb
+lib/tagutils/tags.rb
+lib/tagutils/tags/active_record.rb
+lib/tagutils/tags/models/tag.rb
+lib/tagutils/tags/models/tag_comp.rb
+lib/tagutils/tags/models/tagging.rb
+lib/tagutils/tags/patterns.rb
+lib/tagutils/tags/readers/tag.rb
+lib/tagutils/tags/schema.rb
+lib/tagutils/version.rb
+test/helper.rb
+test/tags.1.yml
+test/test_models.rb
+test/test_tag_reader.rb

data/README.md

@@ -16,20 +16,20 @@ Use `TagDb.create` to build the `tags` and `taggings` tables
 and `CategoryDb.create` to build the `categories` and `categorizations` tables.
 Example:
 
-~~~
+```
 # ...
 TagDb.create
 # ...
 CategoryDb.create
 # ...
-~~~
+```
 
 
 ### Models
 
 Add the associations yourself with the standard `has_many` class macro:
 
-~~~
+```
 class Movie < ActiveRecord::Base
   # ...
   has_many :taggings, class_name: 'TagDb::Model::Tagging', :as      => :taggable
@@ -39,11 +39,11 @@ class Movie < ActiveRecord::Base
   has_many :categories,      class_name: 'CategoryDb::Model::Category',        :through => :categorizations
   # ...
 end
-~~~
+```
 
 or use the built-in class macro shortcuts:
 
-~~~
+```
 class Movie < ActiveRecord::Base
   # ...
   has_many_tags
@@ -51,27 +51,27 @@ class Movie < ActiveRecord::Base
   has_many_categories
   # ...
 end
-~~~
+```
 
 The `has_many_tags` also adds the following methods:
 
-~~~
+```
 Movie.with_tag( 'doc' )
 # e.g. scope :with_tag, ->(tag_key){ joins(:tags).where('tags.key' => tag_key) }
-~~~
+```
 
 The `has_many_categories` also adds the following methods:
 
-~~~
+```
 Movie.with_category( 'doc' )
 # e.g. scope :with_category, ->(category_key){ joins(:categories).where('categories.key' => category_key) }
-~~~
+```
 
 ### Reader
 
 The `TagReader` lets you read plain text fixtures (data sets). Example:
 
-~~~
+```
 tags.1.yml:
 -----------
 
@@ -83,194 +83,23 @@ football: fifa, uefa, afc, ofc, caf, csf, concacaf
 # national regions
 
 brasil: s|South, se|Southeast, co|Centerwest, ne|Northeast, n|North
-~~~
+```
 
 To read the tags use:
 
-~~~
+```
 TagReader.new( <include_path>).read( `tags.1` )
-~~~
+```
 
 
 
 ## 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 
+- [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
-
-
-### Tags
-
-- [gutentag](https://github.com/pat/gutentag)
-
-~~~
-create_table :taggings do |t|
-  t.integer    :tag_id,        null: false
-  t.integer    :taggable_id,   null: false
-  t.string     :taggable_type, null: false
-  t.timestamps
-end
-
-create_table :tags do |t|
-  t.string      :name,           null: false
-  t.integer     :taggings_count, null: false, default: 0
-  t.timestamps
-end
-~~~
-
-
-- [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.string  :name
-  t.integer :taggings_count,  null: false, default: 0
-end
- 
-create_table :taggings do |t|
-  t.integer :tag_id
-  t.integer :taggable_id
-  t.string  :taggable_type
-  t.integer :user_id
-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.string :name
-end
-
-create_table :taggings do |t|
-  t.integer  :tag_id
-  t.integer  :taggable_id
-  t.string   :taggable_type
-
-  t.datetime :created_at
-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)
-
-
-### Categories
-
-- [categoryz3](https://github.com/tscolari/categoryz3)
-
-~~~
-create_table :categoryz3_categories do |t|
-  t.string     :name
-  t.references :parent
-  t.integer    :items_count,       default: 0
-  t.integer    :child_items_count, default: 0
-  t.integer    :childrens_count,   default: 0
-  t.timestamps
-end
-
-create_table :categoryz3_items do |t|
-  t.references :category,      null: false
-  t.references :categorizable, null: false, polymorphic: true
-  t.timestamps
-end
-
-create_table :categoryz3_child_items do |t|
-  t.references :category,      null: false
-  t.references :categorizable, null: false, polymorphic: true
-  t.references :master_item,   null: false
-  t.timestamps
-end
-~~~
-
-- [categorizable](https://github.com/boof/categorizable)
-
-~~~
-create_table :categories do |t|
-  t.string     :name, null: false
-  t.timestamps
-end
-
-create_table :categorizations do |t|
-  t.references :category,      null: false
-  t.references :categorizable, null: false, :polymorphic: true
-  t.timestamps
-end
-~~~
-
-- [acts_as_category](https://github.com/wuwx/acts_as_category)
-
-
 ## License
 
 The `tagutils` scripts are dedicated to the public domain.

data/Rakefile

@@ -11,7 +11,7 @@ Hoe.spec 'tagutils' do
   self.urls    = ['https://github.com/rubylibs/tagutils']
 
   self.author  = 'Gerald Bauer'
-  self.email   = 'openmundi@googlegroups.com'
+  self.email   = 'ruby-talk@ruby-lang.org'
 
   # switch extension to .markdown for gihub formatting
   self.readme_file  = 'README.md'
@@ -19,15 +19,15 @@ Hoe.spec 'tagutils' do
 
   self.extra_deps = [
     ['activerecord' ],
-    ['props', '>=1.1.2'],
+    ['props', '>=1.2.0'],
     ['logutils', '>= 0.6.1'],
-    ['textutils', '>=0.10.0']
+    ['textutils', '>=1.4.0']   ## fix - do NOT depend on textutils - why? why not?
   ]
 
   self.licenses = ['Public Domain']
 
   self.spec_extras = {
-   required_ruby_version: '>= 1.9.2'
+   required_ruby_version: '>= 2.3'
   }
 
 

data/lib/tagutils/categories/schema.rb

@@ -19,8 +19,8 @@ end
 add_index :categories, :key, unique: true
 
 create_table :categorizations do |t|
-  t.references :category,      null: false
-  t.references :categorizable, null: false, polymorphic: true
+  t.references :category,      null: false, index: false                     ## Note: do NOT auto-add index
+  t.references :categorizable, null: false, index: false, polymorphic: true  ## Note: do NOT auto-add index
 
   # todo: use only t.datetime :created_at (do we get ar magic? is updated used/needed??)
   t.timestamps

data/lib/tagutils/tags/schema.rb

@@ -11,26 +11,28 @@ 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
+  t.integer :grade, null: false, default: 1  # grade/tier e.g. 1/2/3 for now - rename to rank why? why not??
 
-  # parent used for hierachy (e.g. lets you use tag stacks/packs etc.)
-  t.references :parent
+
+  # parent used for hierarchy (e.g. lets you use tag stacks/packs etc.)
+  t.references :parent     ## foreign_key: true -- check/todo: add foreign_key, add index: false - why? why not?
 
   # todo: use only t.datetime :created_at (do we get ar magic? is updated used/needed??)
   t.timestamps
 end
 
+
 add_index :tags, :key,  unique: true
 
 create_table :taggings do |t|
-  t.references :tag,      null: false
-  t.references :taggable, null: false, polymorphic: true
+  t.references :tag,      null: false, index: false                     ## Note: do NOT auto-add index
+  t.references :taggable, null: false, index: false, polymorphic: true  ## Note: do NOT auto-add index
 
   # todo: use only t.datetime :created_at (do we get ar magic? is updated used/needed??)
   t.timestamps
 end
 
-add_index :taggings, :tag_id
+add_index :taggings, :tag_id  ## note: add index "by hand" in AR5.0 gets auto-added (use index: false!!!)
 add_index :taggings, [:taggable_id, :taggable_type]
 add_index :taggings, [:taggable_id, :taggable_type, :tag_id], unique: true
 

data/lib/tagutils/version.rb

@@ -1,5 +1,4 @@
 
 module TagUtils
-   VERSION = '0.3.0'
+   VERSION = '1.0.0'
 end
-

data/test/helper.rb

@@ -10,8 +10,8 @@ require 'minitest/autorun'
 
 require 'tagutils'
 
-require 'logutils/activerecord'   # NB: explict require required for LogDb (not automatic) 
-require 'props/activerecord'      # NB: explict require required for ConfDb (not automatic) 
+require 'logutils/activerecord'   # NB: explict require required for LogDb (not automatic)
+require 'props/activerecord'      # NB: explict require required for ConfDb (not automatic)
 
 
 
@@ -28,18 +28,20 @@ class Movie < ActiveRecord::Base
 end
 
 
-class CreateMovieDb < ActiveRecord::Migration
+class CreateMovieDb
 
   def up
-    create_table :movies do |t|
-      t.string  :key,   null: false
-      t.string  :name,  null: false
-      t.timestamps
-    end
+    ActiveRecord::Schema.define do
+      create_table :movies do |t|
+         t.string  :key,   null: false
+         t.string  :name,  null: false
+         t.timestamps
+      end
+    end # Schema.define
   end # method up
 
-  def down
-    raise ActiveRecord::IrreversibleMigration
+  def self.create
+     self.new.up   ## CreateMovieDb.new.up
   end
 
 end  # class CreateMovieDb
@@ -70,7 +72,8 @@ def setup_in_memory_db
 
   TagDb.create
   CategoryDb.create
-  CreateMovieDb.new.up
+
+  CreateMovieDb.create
 end
 
 

data/test/test_tag_reader.rb

@@ -18,7 +18,7 @@ class TestTagReader < MiniTest::Test
     puts "[TestTagReader.test_read] path: #{path}"
 
     reader = TagDb::TagReader.from_file( path )
-    reader.read()
+    reader.read
   end
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tagutils
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-04 00:00:00.000000000 Z
+date: 2017-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.2
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.2
+        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: logutils
   requirement: !ruby/object:Gem::Requirement
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 1.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 1.4.0
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -86,16 +86,16 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: '3.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.13'
+        version: '3.16'
 description: tagutils - tag utilities (tag, taggings, tag list, etc.)
-email: openmundi@googlegroups.com
+email: ruby-talk@ruby-lang.org
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -103,7 +103,6 @@ extra_rdoc_files:
 - Manifest.txt
 - README.md
 files:
-- ".gemtest"
 - HISTORY.md
 - Manifest.txt
 - README.md
@@ -142,7 +141,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -150,10 +149,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.2
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: tagutils - tag utilities (tag, taggings, tag list, etc.)
-test_files:
-- test/test_models.rb
-- test/test_tag_reader.rb
+test_files: []