b_b 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0eb5f13d8db2d94fb62a2e75a51a34a305ab580d
+  data.tar.gz: 24fa3ef4a9ac0bf7b459c6d0797adaa532737800
+SHA512:
+  metadata.gz: e540f2d694a216c2d7315047649c0f2e1a3983c7d7ee681e51f1f4e0ca389781671049b2b7697a8e34776602c53387ec55c3052c1e3e42944bcf86bae62ba627
+  data.tar.gz: cf30f527a0000c84c66121adc488515980febd2e3dfc0b8a8d9d638d3eda0b92636ec56585a2822e0fcfc5afeb4a025497f8d60e2b93b744b99df99d3ffc6655

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.hound.yml

@@ -0,0 +1,3 @@
+ruby:
+  enabled: true
+  config_file: .rubocop.yml

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,13 @@
+inherit_from:
+  - .ruby-style.yml
+
+AllCops:
+  Exclude:
+    - "bin/*"
+    - "vendor/**/*"
+    - Gemfile
+    - Rakefile
+  DisplayCopNames: true
+
+Metrics/LineLength:
+  Enabled: false

data/.ruby-style.yml

@@ -0,0 +1,243 @@
+AllCops:
+  Exclude:
+    - "vendor/**/*"
+    - "db/schema.rb"
+  UseCache: false
+Style/CollectionMethods:
+  Description: Preferred collection methods.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#map-find-select-reduce-size
+  Enabled: true
+  PreferredMethods:
+    collect: map
+    collect!: map!
+    find: detect
+    find_all: select
+    reduce: inject
+Style/DotPosition:
+  Description: Checks the position of the dot in multi-line method calls.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#consistent-multi-line-chains
+  Enabled: true
+  EnforcedStyle: trailing
+  SupportedStyles:
+  - leading
+  - trailing
+Style/FileName:
+  Description: Use snake_case for source file names.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#snake-case-files
+  Enabled: false
+  Exclude: []
+Style/GuardClause:
+  Description: Check for conditionals that can be replaced with guard clauses
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#no-nested-conditionals
+  Enabled: false
+  MinBodyLength: 1
+Style/IfUnlessModifier:
+  Description: Favor modifier if/unless usage when you have a single-line body.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#if-as-a-modifier
+  Enabled: false
+  MaxLineLength: 80
+Style/OptionHash:
+  Description: Don't use option hashes when you can use keyword arguments.
+  Enabled: false
+Style/PercentLiteralDelimiters:
+  Description: Use `%`-literal delimiters consistently
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#percent-literal-braces
+  Enabled: false
+  PreferredDelimiters:
+    "%": "()"
+    "%i": "()"
+    "%q": "()"
+    "%Q": "()"
+    "%r": "{}"
+    "%s": "()"
+    "%w": "()"
+    "%W": "()"
+    "%x": "()"
+Style/PredicateName:
+  Description: Check the names of predicate methods.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#bool-methods-qmark
+  Enabled: true
+  NamePrefix:
+  - is_
+  - has_
+  - have_
+  NamePrefixBlacklist:
+  - is_
+  Exclude:
+  - spec/**/*
+Style/RaiseArgs:
+  Description: Checks the arguments passed to raise/fail.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#exception-class-messages
+  Enabled: false
+  EnforcedStyle: exploded
+  SupportedStyles:
+  - compact
+  - exploded
+Style/SignalException:
+  Description: Checks for proper usage of fail and raise.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#fail-method
+  Enabled: false
+  EnforcedStyle: semantic
+  SupportedStyles:
+  - only_raise
+  - only_fail
+  - semantic
+Style/SingleLineBlockParams:
+  Description: Enforces the names of some block params.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#reduce-blocks
+  Enabled: false
+  Methods:
+  - reduce:
+    - a
+    - e
+  - inject:
+    - a
+    - e
+Style/SingleLineMethods:
+  Description: Avoid single-line methods.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#no-single-line-methods
+  Enabled: false
+  AllowIfMethodIsEmpty: true
+Style/StringLiterals:
+  Description: Checks if uses of quotes match the configured preference.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#consistent-string-literals
+  Enabled: true
+  EnforcedStyle: double_quotes
+  SupportedStyles:
+  - single_quotes
+  - double_quotes
+Style/StringLiteralsInInterpolation:
+  Description: Checks if uses of quotes inside expressions in interpolated strings
+    match the configured preference.
+  Enabled: true
+  EnforcedStyle: single_quotes
+  SupportedStyles:
+  - single_quotes
+  - double_quotes
+Style/TrailingCommaInArguments:
+  Description: 'Checks for trailing comma in argument lists.'
+  StyleGuide: 'https://github.com/bbatsov/ruby-style-guide#no-trailing-array-commas'
+  Enabled: false
+  EnforcedStyleForMultiline: no_comma
+  SupportedStyles:
+  - comma
+  - consistent_comma
+  - no_comma
+Style/TrailingCommaInLiteral:
+  Description: 'Checks for trailing comma in array and hash literals.'
+  StyleGuide: 'https://github.com/bbatsov/ruby-style-guide#no-trailing-array-commas'
+  Enabled: false
+  EnforcedStyleForMultiline: no_comma
+  SupportedStyles:
+  - comma
+  - consistent_comma
+  - no_comma
+Metrics/AbcSize:
+  Description: A calculated magnitude based on number of assignments, branches, and
+    conditions.
+  Enabled: false
+  Max: 15
+Metrics/ClassLength:
+  Description: Avoid classes longer than 100 lines of code.
+  Enabled: false
+  CountComments: false
+  Max: 100
+Metrics/ModuleLength:
+  CountComments: false
+  Max: 100
+  Description: Avoid modules longer than 100 lines of code.
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Description: A complexity metric that is strongly correlated to the number of test
+    cases needed to validate a method.
+  Enabled: false
+  Max: 6
+Metrics/MethodLength:
+  Description: Avoid methods longer than 10 lines of code.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#short-methods
+  Enabled: false
+  CountComments: false
+  Max: 10
+Metrics/ParameterLists:
+  Description: Avoid parameter lists longer than three or four parameters.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#too-many-params
+  Enabled: false
+  Max: 5
+  CountKeywordArgs: true
+Metrics/PerceivedComplexity:
+  Description: A complexity metric geared towards measuring complexity for a human
+    reader.
+  Enabled: false
+  Max: 7
+Lint/AssignmentInCondition:
+  Description: Don't use assignment in conditions.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#safe-assignment-in-condition
+  Enabled: false
+  AllowSafeAssignment: true
+Style/InlineComment:
+  Description: Avoid inline comments.
+  Enabled: false
+Style/AccessorMethodName:
+  Description: Check the naming of accessor methods for get_/set_.
+  Enabled: false
+Style/Alias:
+  Description: Use alias_method instead of alias.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#alias-method
+  Enabled: false
+Style/Documentation:
+  Description: Document classes and non-namespace modules.
+  Enabled: false
+Style/DoubleNegation:
+  Description: Checks for uses of double negation (!!).
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#no-bang-bang
+  Enabled: false
+Style/EachWithObject:
+  Description: Prefer `each_with_object` over `inject` or `reduce`.
+  Enabled: false
+Style/EmptyLiteral:
+  Description: Prefer literals to Array.new/Hash.new/String.new.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#literal-array-hash
+  Enabled: false
+Style/ModuleFunction:
+  Description: Checks for usage of `extend self` in modules.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#module-function
+  Enabled: false
+Style/OneLineConditional:
+  Description: Favor the ternary operator(?:) over if/then/else/end constructs.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#ternary-operator
+  Enabled: false
+Style/PerlBackrefs:
+  Description: Avoid Perl-style regex back references.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#no-perl-regexp-last-matchers
+  Enabled: false
+Style/Send:
+  Description: Prefer `Object#__send__` or `Object#public_send` to `send`, as `send`
+    may overlap with existing methods.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#prefer-public-send
+  Enabled: false
+Style/SpecialGlobalVars:
+  Description: Avoid Perl-style global variables.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#no-cryptic-perlisms
+  Enabled: false
+Style/VariableInterpolation:
+  Description: Don't interpolate global, instance and class variables directly in
+    strings.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#curlies-interpolate
+  Enabled: false
+Style/WhenThen:
+  Description: Use when x then ... for one-line cases.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#one-line-cases
+  Enabled: false
+Lint/EachWithObjectArgument:
+  Description: Check for immutable argument given to each_with_object.
+  Enabled: true
+Lint/HandleExceptions:
+  Description: Don't suppress exception.
+  StyleGuide: https://github.com/bbatsov/ruby-style-guide#dont-hide-exceptions
+  Enabled: false
+Lint/LiteralInCondition:
+  Description: Checks of literals used in conditions.
+  Enabled: false
+Lint/LiteralInInterpolation:
+  Description: Checks for literals used in interpolation.
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,14 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2
+  - 2.3.0
+  - 2.3.1
+before_install:
+  - "gem install bundler -v '~> 1.12'"
+bundler_args: "--jobs=2"
+cache: bundler
+script:
+  - "bundle exec rspec"

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+gemspec
+
+group :development, :test do
+  gem 'pry'
+  gem 'factory_girl'
+  gem 'faker'
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Yoshiyuki Hirano
+
+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,212 @@
+# BB
+
+(b_b) is SQL Query Builder for [Google BigQuery](https://cloud.google.com/bigquery)
+
+[![Build Status](https://travis-ci.org/yhirano55/b_b.svg?branch=master)](https://travis-ci.org/yhirano55/b_b) [![Coverage Status](https://coveralls.io/repos/github/yhirano55/b_b/badge.svg?branch=master)](https://coveralls.io/github/yhirano55/b_b?branch=master) [![codebeat badge](https://codebeat.co/badges/5e694b1a-93b1-4fda-ad6e-3dc0d5afe76b)](https://codebeat.co/projects/github-com-yhirano55-b_b)
+
+## Install
+
+Add the following line to Gemfile:
+
+    gem 'b_b'
+
+and run `bundle` from your shell.
+
+To install the gem manually from your shell, run:
+
+    gem install b_b
+
+## Basic usage
+
+(b_b) can build only **SQL SELECT Statement**.
+
+```rb
+BB.select("word", "corpus", "COUNT(word)").
+   from("publicdata:samples.shakespeare").
+   where(word_cont: "th").
+   group(:word, :corpus).
+   to_sql
+
+# => "SELECT word, corpus, COUNT(word) FROM publicdata:samples.shakespeare WHERE (word CONTAINS 'th') GROUP BY word, corpus"
+```
+
+Query Reference of BigQuery's query syntax and functions is [here](https://cloud.google.com/bigquery/query-reference?hl=en).
+
+## Examples
+
+### SELECT clause
+
+```ruby
+BB.select(:id, :name, :state).to_sql
+# => "SELECT id, name, state"
+
+BB.select("id", "name", "COUNT(*)").to_sql
+# => "SELECT id, name, COUNT(*)"
+```
+
+### FROM clause
+
+```ruby
+BB.from("publicdata:samples.shakespeare").to_sql
+# => "SELECT * FROM publicdata:samples.shakespeare"
+
+BB.from("[applogs.events_20120501]", "[applogs.events_20120502]", "[applogs.events_20120503]").to_sql
+# => "SELECT * FROM [applogs.events_20120501], [applogs.events_20120502], [applogs.events_20120503]"
+
+BB.from("applogs.events_", on: Date.new(2012, 5, 1)).to_sql
+# => "SELECT * FROM applogs.events_20120501"
+
+BB.from("mydata.people", from: Date.new(2014, 3, 25), to: Date.new(2014, 3, 27)).to_sql
+# => "SELECT * FROM TABLE_DATE_RANGE(mydata.people, TIMESTAMP('2014-03-25'), TIMESTAMP('2014-03-27'))"
+
+BB.from(BB.from("publicdata:samples.shakespeare"), as: shakespeare).to_sql
+# => "SELECT * FROM (SELECT * FROM publicdata:samples.shakespeare) AS shakespeare"
+```
+
+### JOIN clause
+
+```ruby
+BB.from(:customers, as: :t1).inner_join(:orders, as: :t2).on("t1.customer_id = t2.customer_id").to_sql
+# => "SELECT * FROM customers AS t1 INNER JOIN orders AS t2 ON t1.customer_id = t2.customer_id"
+
+BB.from(:customers, as: :t1).join_each(BB.select(:id, :name).from(:orders), as: :t2).on("t1.customer_id = t2.customer_id").to_sql
+# => "SELECT * FROM customers AS t1 JOIN EACH (SELECT id, name FROM orders) AS t2 ON t1.customer_id = t2.customer_id"
+```
+
+### WHERE clause
+
+```ruby
+BB.where(id: 1..10, name: "donald", flag: false).to_sql
+# => "WHERE (id BETWEEN 1 AND 10 AND name = 'donald' AND flag IS false)"
+
+BB.where("id = ? OR name CONTAINS ?", 123, "john").to_sql
+# => "WHERE (id = 123 OR name CONTAINS 'john')"
+
+BB.where("id = :id AND name <> :name", id: 123, name: "trump").to_sql
+# => "WHERE (id = 123 AND name <> 'trump')"
+
+BB.where(id_gteq: 123, name_not_cont: "melania").to_sql
+# => "WHERE (id >= 123 AND NOT name CONTAINS 'melania')"
+
+BB.where(id: 123).or.where(id: 456).to_sql
+# => "WHERE (id = 123) OR (id = 456)"
+
+BB.not.where(id: 123).or.not.where(id: 456).to_sql
+# => "WHERE (id <> 123) OR (id <> 456)"
+
+BB.where(id: 123, name: "trump", reduce: :or).to_sql
+# => "WHERE (id = 123 OR name = 'trump')"
+```
+
+### OMIT RECORD IF clause
+
+```ruby
+BB.omit_record_if("COUNT(payload.pages.page_name) <= ?", 80).to_sql
+# => "OMIT RECORD IF (COUNT(payload.pages.page_name) <= 80)"
+```
+
+### GROUP BY clause
+
+```ruby
+BB.group(:age, :gender).to_sql
+# => "GROUP BY age, gender"
+
+BB.group("ROLLUP(year, is_male)").to_sql
+# => "GROUP BY ROLLUP(year, is_male)"
+
+BB.group_each(:age, :gender).to_sql
+# => "GROUP EACH BY age, gender"
+```
+
+### HAVING clause
+
+```ruby
+BB.having(first_cont: "a", ngram_count_lt: 10000).to_sql
+# => "HAVING (first CONTAINS 'a' AND ngram_count < 10000)"
+
+BB.having("first CONTAINS ? AND negram_count < ?", "a", 10000).to_sql
+# => "HAVING (first CONTAINS 'a' AND ngram_count < 10000)"
+
+BB.having("first CONTAINS :first AND negram_count < :negram_count", first: "a", negram_count: 10000).to_sql
+# => "HAVING (first CONTAINS 'a' AND ngram_count < 10000)"
+
+BB.having(first: "a").or.not.having(first: "b").to_sql
+=> "HAVING (first = 'a') OR (first <> 'b')"
+```
+
+### ORDER BY clause
+
+```ruby
+BB.order(:age, :gender).to_sql
+# => "ORDER BY age, gender"
+
+BB.order(age: :desc, gender: :asc).to_sql
+# => "ORDER BY age DESC, gender ASC"
+```
+
+### LIMIT clause
+
+```ruby
+BB.limit(1000).to_sql
+# => "LIMIT 1000"
+
+BB.limit(1000).offset(500).to_sql
+# => "LIMIT 1000 OFFSET 500"
+```
+
+## Support
+
+### JOINS
+
+Support methods:
+
+- cross_join
+- full_outer_join_each
+- inner_join
+- inner_join_each
+- join
+- join_each
+- left_join
+- left_join_each
+- left_outer_join
+- left_outer_join_each
+- right_join
+- right_join_each
+- right_outer_join
+- right_outer_join_each
+
+### Suffix of hash keys
+
+For `omit_record_if`, `where`, `having`:
+
+| suffix | means | alias | opposite | example |
+|:------:|:------|:------|:---------|:--------|
+| cont | contains | `contains`, `like` | `not_cont`, `not_contains`, `not_like` | `BB.where(name_cont: "banana")` |
+| eq | equals | `eql`, `equals` | `not_eq`, `not_eql`, `not_equals` | `BB.where(id_not_eq: 123)` |
+| gt | greater than | *undefined* | `not_gt` | `BB.where(id_not_gt: 123)` |
+| gteq | greater than or equals to | *undefined* | `not_gteq` | `BB.where(id_not_gteq: 123)` |
+| lt | less than | *undefined* | `not_lt` | `BB.where(id_not_lt: 123)` |
+| lteq | less than or equals to | *undefined* | `not_lteq` | `BB.where(id_not_lteq: 123)` |
+
+## Contributing
+
+Here's a quick guide:
+
+1. Fork the repo.
+2. Create a thoughtfully-named branch for your changes (`git checkout -b my-new-feature`).
+3. Install the development dependencies by running `bundle install`.
+4. Begin by running the tests.
+
+        $ bundle exec rspec
+
+5. Implement something.
+6. Add tests for your changes.
+7. Make the tests pass.
+8. Commit your changes (`git commit -am 'Add feature/Fix bug/improve something'`)
+9. Push the branch up to your fork on GitHub
+   (`git push origin my-new-feature`) and from GitHub submit a pull request to
+   b_b's `master` branch.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/b_b.gemspec

@@ -0,0 +1,33 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "b_b/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "b_b"
+  spec.version       = BB::VERSION
+  spec.authors       = ["Yoshiyuki Hirano"]
+  spec.email         = ["yhirano@me.com"]
+
+  spec.required_ruby_version = ">= 2.0.0"
+
+  spec.summary       = "SQL Query Builder in Ruby for Google BigQuery"
+  spec.description   = "SQL Query Builder in Ruby for Google BigQuery"
+  spec.homepage      = "https://github.com/yhirano55/BB"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler",       "~> 1.11"
+  spec.add_development_dependency "rake",          "~> 10.0"
+  spec.add_development_dependency "rspec",         "~> 3.0"
+  spec.add_development_dependency "activesupport", "~> 4.2.0"
+  spec.add_development_dependency "factory_girl",  "~> 4.0"
+  spec.add_development_dependency "faker",         "~> 1.6.0"
+  spec.add_development_dependency "pry",           "~> 0.10.0"
+  spec.add_development_dependency "rubocop",       "~> 0.40.0"
+  spec.add_development_dependency "simplecov",     "~> 0.11.0"
+  spec.add_development_dependency "coveralls",     "~> 0.8.0"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "b_b"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here