tagliatelle 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: da28c1f8368d09b6c8b46dd8c54cb1c8666a8d71
+  data.tar.gz: 0541d85da93083c004510535afb7398eeae78166
+SHA512:
+  metadata.gz: 728d34d3f74f79058fd5bf4944fe054868aa8fe36b5fbebf7c25f98fdc343b946475af0404df56e9145bd79cf7fb18b7fd0793e28aacddd122586611ec672ae6
+  data.tar.gz: e821b0837c7a068eef2d4ab5550dacd2f0c85ea191c3b22221d92bde833ab9d7132421389922846c8b4cf69aad9bb91507876d6732a8bb718839544979a000c8

data/.gitignore

@@ -0,0 +1,29 @@
+*.rbc
+*.sassc
+.sass-cache
+capybara-*.html
+.rspec
+.rvmrc
+/.bundle
+/vendor/bundle
+/log/*
+/tmp/*
+/db/*.sqlite3
+/public/system/*
+/public/uploads/*
+/coverage/
+/spec/tmp/*
+**.orig
+rerun.txt
+pickle-email-*.html
+.project
+config/initializers/secret_token.rb
+.DS_Store
+*.swp
+test/dummy/db/*.sqlite3
+test/dummy/db/*.sqlite3-journal
+test/dummy/log/*.log
+test/dummy/tmp/
+test/dummy/.sass-cache
+Gemfile.lock
+tags

data/.rubocop.yml

@@ -0,0 +1,17 @@
+AllCops:
+  RunRailsCops: true
+
+Documentation:
+  Enabled: false
+
+Metrics/LineLength:
+  Max: 120
+
+Metrics/ClassLength:
+  Max: 300
+
+Metrics/MethodLength:
+  Max: 25
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Declare your gem's dependencies in tagliatelle.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+group :test do
+  gem "minitest", "~> 5.6"
+  gem "simplecov", "~> 0.9"
+  gem "temping", "~> 3.2"
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2015 Varvet
+
+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,73 @@
+# Tagliatelle
+
+[![Gem Version](http://img.shields.io/gem/v/tagliatelle.svg)](https://rubygems.org/gems/tagliatelle)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "tagliatelle"
+```
+
+And then execute:
+
+```sh
+$ bundle
+```
+
+Generate model classes and migrations:
+
+```sh
+$ rails generate tagliatelle:install
+```
+
+Review the generated migrations then migrate:
+
+```sh
+$ rake db:migrate
+```
+
+## Usage
+
+Tagliatelle expects two classes to be defined:
+
+```ruby
+class Tag < ActiveRecord::Base
+  include Tagliatelle::Tag
+end
+
+class Tagging < ActiveRecord::Base
+  include Tagliatelle::Tagging
+end
+```
+
+You can add or override behavior to these classes as needed.
+
+Then to make an object taggable:
+
+```ruby
+class Article < ActiveRecord::Base
+  include Tagliatelle::Taggable
+end
+```
+
+To tag an object:
+
+```ruby
+article = Article.first
+article.tag_list = "foo, bar"
+article.save
+```
+
+To retrieve the tags of an object:
+
+```ruby
+article = Article.first
+article.tag_list
+```
+
+To query objects based on tags:
+```ruby
+Article.tagged_with(["foo", "bar"])
+```

data/Rakefile

@@ -0,0 +1,34 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Tagliatelle'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task default: :test

data/db/migrate/1_create_tags_and_taggings.rb

@@ -0,0 +1,16 @@
+class CreateTagsAndTaggings < ActiveRecord::Migration
+  def change
+    create_table :tags do |t|
+      t.string :name
+      t.timestamps
+    end
+    add_index :tags, :name, unique: true
+
+    create_table :taggings do |t|
+      t.references :taggable, polymorphic: true, index: true
+      t.references :tag, index: true
+      t.timestamps
+    end
+    add_index :taggings, [:taggable_id, :taggable_type, :tag_id], unique: true
+  end
+end

data/lib/generators/tagliatelle/install_generator.rb

@@ -0,0 +1,29 @@
+module Tagliatelle
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      def create_tag_model
+        create_file "app/models/tag.rb" do
+          <<-END.strip_heredoc
+            class Tag < ActiveRecord::Base
+              include Tagliatelle::Tag
+            end
+          END
+        end
+      end
+
+      def create_tagging_model
+        create_file "app/models/tagging.rb" do
+          <<-END.strip_heredoc
+            class Tagging < ActiveRecord::Base
+              include Tagliatelle::Tagging
+            end
+          END
+        end
+      end
+
+      def copy_migrations
+        system("bundle exec rake tagliatelle:install:migrations")
+      end
+    end
+  end
+end

data/lib/tagliatelle.rb

@@ -0,0 +1,9 @@
+require "tagliatelle/tag"
+require "tagliatelle/taggable"
+require "tagliatelle/tagging"
+
+module Tagliatelle
+  class Engine < ::Rails::Engine
+    engine_name "tagliatelle"
+  end
+end

data/lib/tagliatelle/tag.rb

@@ -0,0 +1,15 @@
+module Tagliatelle
+  module Tag
+    extend ActiveSupport::Concern
+
+    included do
+      has_many :taggings, dependent: :destroy
+
+      validates :name, presence: true
+    end
+
+    def to_s
+      name
+    end
+  end
+end

data/lib/tagliatelle/taggable.rb

@@ -0,0 +1,29 @@
+module Tagliatelle
+  module Taggable
+    extend ActiveSupport::Concern
+
+    included do
+      has_many :taggings, as: :taggable, dependent: :destroy
+      has_many :tags, through: :taggings
+    end
+
+    def tag_list
+      tags.map(&:name).join(", ")
+    end
+
+    def tag_list=(value)
+      self.tags = value.split(",").map(&:strip).uniq.map do |tag|
+        ::Tag.find_or_initialize_by(name: tag)
+      end
+    end
+
+    module ClassMethods
+      def tagged_with(tags)
+        joins(:tags)
+          .where(tags: { name: tags.map(&:to_s) })
+          .preload(:tags)
+          .distinct
+      end
+    end
+  end
+end

data/lib/tagliatelle/tagging.rb

@@ -0,0 +1,12 @@
+module Tagliatelle
+  module Tagging
+    extend ActiveSupport::Concern
+
+    included do
+      belongs_to :taggable, polymorphic: true
+      belongs_to :tag
+
+      validates :tag, uniqueness: { scope: [:taggable_id, :taggable_type] }
+    end
+  end
+end

data/lib/tagliatelle/version.rb

@@ -0,0 +1,3 @@
+module Tagliatelle
+  VERSION = "0.9.0"
+end

data/lib/tasks/tagliatelle_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :tagliatelle do
+#   # Task goes here
+# end

data/tagliatelle.gemspec

@@ -0,0 +1,24 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+# Maintain your gem's version:
+require "tagliatelle/version"
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |spec|
+  spec.name        = "tagliatelle"
+  spec.version     = Tagliatelle::VERSION
+  spec.authors     = ["Jens Ljungblad"]
+  spec.email       = ["jens.ljungblad@gmail.com"]
+  spec.homepage    = "https://github.com/varvet/tagliatelle"
+  spec.summary     = "Simple tagging for Rails 4+"
+  spec.description = "Simple tagging for Rails 4+"
+  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.add_dependency "rails", "~> 4.0"
+
+  spec.add_development_dependency "sqlite3"
+end

data/test/dummy/README.rdoc

@@ -0,0 +1,28 @@
+== README
+
+This README would normally document whatever steps are necessary to get the
+application up and running.
+
+Things you may want to cover:
+
+* Ruby version
+
+* System dependencies
+
+* Configuration
+
+* Database creation
+
+* Database initialization
+
+* How to run the test suite
+
+* Services (job queues, cache servers, search engines, etc.)
+
+* Deployment instructions
+
+* ...
+
+
+Please feel free to use a different markup language if you do not plan to run
+<tt>rake doc:app</tt>.

data/test/dummy/Rakefile

@@ -0,0 +1,6 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+
+Rails.application.load_tasks

data/test/dummy/app/assets/javascripts/application.js

@@ -0,0 +1,13 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require_tree .

data/test/dummy/app/assets/stylesheets/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any styles
+ * defined in the other CSS/SCSS files in this directory. It is generally better to create a new
+ * file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/test/dummy/app/controllers/application_controller.rb

@@ -0,0 +1,5 @@
+class ApplicationController < ActionController::Base
+  # Prevent CSRF attacks by raising an exception.
+  # For APIs, you may want to use :null_session instead.
+  protect_from_forgery with: :exception
+end

data/test/dummy/app/helpers/application_helper.rb

@@ -0,0 +1,2 @@
+module ApplicationHelper
+end