activerecord-bracket 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDEwNjEyYmM3MWI0YTM5ZTQzZjdhMGIzYzFiOGNmNmU1ZDk3NGQ4MA==
+  data.tar.gz: !binary |-
+    ZjM3NzAzNzgwZjc0ZGM1Mzk5OWJhM2VlNzFhZmE1YmM2MjBiZDQwNQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MWUzNWM2YjRiMDRkN2Y4OTBlMzE4ZTI0ZjNhYjM2OWZhYzFhMDRmYjlhNDUy
+    OTcxOTk2NDcwYThjZWRjNTUwNTgyNDNiMDJjNzMxNjZjNjRiMTVmN2YxNDRi
+    ZDkxYTVmZTRmYzAyYmJjNGU3M2U3MGIzOGU0NDY4MDY1YjZhYjM=
+  data.tar.gz: !binary |-
+    NjAzZDcwNDliMGQ2N2E1YTU5ZWE1ZmMxZWFhYjExM2QwNjkyNGJkYzhlZDcy
+    ZDUyYjNlYjM2MGM1YWRlZWE2MWE1ZTQzYTJkMThjODlhMTVjYjBjYWIyNDQy
+    ZGJjMmY0NGI5OWVmZWJiNGI0NTY0Y2JmMmViNjAzNmJkMTFjOTg=

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 @@
+--color
+--format progress

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,4 @@
+Copyright (c) 2013 USAMI Kenta
+
+GPLv3 or NYSLれ。
+

data/README.md

@@ -0,0 +1,71 @@
+# ActiveRecord::Bracket [![Build Status](https://travis-ci.org/zonuexe/ruby-activerecord-bracket.png?branch=develop)](https://travis-ci.org/zonuexe/ruby-activerecord-bracket) [![Code Climate](https://codeclimate.com/github/zonuexe/ruby-activerecord-bracket.png)](https://codeclimate.com/github/zonuexe/ruby-activerecord-bracket) [![Dependency Status](https://gemnasium.com/zonuexe/ruby-activerecord-bracket.png)](https://gemnasium.com/zonuexe/ruby-activerecord-bracket)
+
+Provide bracket-method `[]` to index-like access for ActiveRecord Class. It method is a syntax-sugar of `find_by_slug` (dynamic-finder of ActiveRecord).
+
+## Requirement
+
+ * **Ruby** (1.9+, 2.0)
+ * Ruby on Rails (3.x)
+   * Not yet supported rails 4
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'activerecord-bracket'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install activerecord-bracket
+
+## Introduction
+
+*(Japanese)*
+
+ * **ID** とは *別の* 唯一の識別子を持つテーブルを前提とします (ex. Twitter)
+   * Twitterのアカウントには、作成時に任意で選択する変更可能な **Username** (一般に `@zonu_exe` のようにユーザを識別するために使用される) と、変更不可能でアカウント作成時に自動で付番される(10進整数のみからなる) **ID** が存在します
+ * **slug** とは、文字集合が概ねASCIIからなる、平易なURIとして *期待される* 文字列のことです
+   * この用語はWordPressから輸入しました。実際にはWordPressではASCIIのみといった制限はありませんし、 `ActiveRecord::Bracket` においてもその制限はModelのvalidationのみに依存します
+
+### Setup
+
+*(Japanese)*
+
+ * ActiveRecordを継承したモデルに `slug` 列を用意します (**カラム名の制限は撤廃予定です**)
+   * この列は **uniqueness** であることが望ましいです (必須ではありませんが、 `find_by_slug` の構文糖でしかないことに留意しないと想定外の挙動をするおそれがある)
+
+## Usage
+
+```ruby
+# define system supported language
+Language.create(name: 'Japanese', slug: 'ja')
+Language.create(name: 'English' , slug: 'en')
+
+# get Language instance object
+ja = Language[:ja] #=> #<Language id: 1, name: "Japanese", slug: "ja">
+en = Language[:en] #=> #<Language id: 2, name: "English", slug: "en">
+
+# filter non-supported languages
+ko = Language[:ko] #=> nil
+fr = Language[:fr] #=> nil
+
+# sanitize
+errorkeystr = 'kimiha jitsuni baka dana'
+_ = Language[errorkeystr] #=> nil
+```
+
+*(Japanese)*
+
+ * `Model.[]` の引数は `String`, `Symbol` のどちらでもActiveRecordがよしなに扱ってくれます。たぶん。
+
+## 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,3 @@
+require "bundler/gem_tasks"
+
+task default: 'spec'

data/activerecord-bracket.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'activerecord-bracket/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'activerecord-bracket'
+  spec.version       = ActiveRecord::Bracket::VERSION
+  spec.authors       = ['USAMI Kenta']
+  spec.email         = ['tadsan@zonu.me']
+  spec.description   = %q{Provide bracket-method `[]` for ActiveRecord Class}
+  spec.summary       = %q{}
+  spec.homepage      = 'http://dt.zonu.me'
+  spec.license       = 'GPLv3 or NYSL'
+
+  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_runtime_dependency 'activerecord'
+  spec.add_runtime_dependency 'activesupport'
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+end

data/lib/activerecord-bracket.rb

@@ -0,0 +1,10 @@
+require 'active_support'
+require 'activerecord-bracket/version'
+
+# a Namespece of ActiveRecord
+module ActiveRecord
+  # a Namespace of ActiveRecord::Bracket
+  module Bracket;  end
+end
+
+require 'activerecord-bracket/method'

data/lib/activerecord-bracket/method.rb

@@ -0,0 +1,12 @@
+# Implement of [] method
+module ActiveRecord::Bracket::Method
+  extend ::ActiveSupport::Concern
+
+  # class methods for ActiveRecord
+  module ClassMethods
+    # [] method for ActiveRecord 3.x (using dynamic finder)
+    def [] (key)
+      self.send(:find_by_slug, key)
+    end
+  end
+end

data/lib/activerecord-bracket/version.rb

@@ -0,0 +1,5 @@
+module ActiveRecord
+  module Bracket
+    VERSION = '0.0.1'
+  end
+end

data/spec/activerecord/bracket_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe ActiveRecord::Bracket do
+  context "sample class" do
+    let(:sample_class){
+      # pseudo-activerecord
+      Class.new do
+        include ActiveRecord::Bracket::Method
+        attr_accessor :name, :slug
+        def initialize (arg)
+          @name = arg[:name]
+          @slug = arg[:slug]
+          self.class.instances[@slug.intern] = self
+        end
+        def == (other)
+          [self.name.to_s, self.slug.to_s] == [other.name.to_s, other.slug.to_s]
+        end
+        def self.find_by_slug (key)
+          instances[key.intern]
+        end
+        def self.instances; @@instances ||= {} ; end
+      end
+    }
+    before(:each){ @sample = sample_class.new(name: "Foo", slug: "foo") }
+    it{ expect(sample_class.find_by_slug(:foo)).to eq @sample }
+    it{ expect(sample_class[:foo]).to eq @sample }
+    it{ expect(sample_class[:foo]).to eq sample_class.find_by_slug(:foo) }
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+lib =  File.expand_path('../../lib', __FILE__)
+$:.unshift(lib)
+
+require 'activerecord-bracket'

metadata

@@ -0,0 +1,128 @@
+--- !ruby/object:Gem::Specification
+name: activerecord-bracket
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- USAMI Kenta
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Provide bracket-method `[]` for ActiveRecord Class
+email:
+- tadsan@zonu.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- activerecord-bracket.gemspec
+- lib/activerecord-bracket.rb
+- lib/activerecord-bracket/method.rb
+- lib/activerecord-bracket/version.rb
+- spec/activerecord/bracket_spec.rb
+- spec/spec_helper.rb
+homepage: http://dt.zonu.me
+licenses:
+- GPLv3 or NYSL
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: ''
+test_files:
+- spec/activerecord/bracket_spec.rb
+- spec/spec_helper.rb