mini_sql 0.2.2-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2fa76e26bf57648741cebb8a9ddbc55dddb48b51b10ac4a5ecf0f8ac7cf58373
+  data.tar.gz: 673660673dbf917c3eaa48c13a73ca2e0fa1fd58972705ef10778b826c09fcd6
+SHA512:
+  metadata.gz: f7de03a4f91d31b466c3b3f7c7fc25b7cdc2b35229bb36e921a8258088fc1035dfd116c29db0cae1e2aa887eb31ae411c19a17ed8d0b2e27e301b80752e88599
+  data.tar.gz: 7bf2cde4021d60268608cfb4b144af908a0993a044af06e43ea1400c6dba34cb9c392b28cdd8cde4758a88bcab2d83f59df46ffbd5e52aad94db76b3d3ed1377

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,21 @@
+language: ruby
+rvm:
+  - 2.5.1
+  - ruby-head
+
+before_install:
+  - gem install bundler
+
+cache: bundler
+sudo: false
+
+addons:
+  postgresql: 9.6
+
+install:
+  - createdb test_mini_sql
+  - bundle install
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head

data/CHANGELOG

@@ -0,0 +1,7 @@
+2019-11-04 - 0.2.2
+
+- Added adapters for JRuby postgres support thanks to @enebo
+
+2019-02-25 - 0.2.1
+
+- Handle `BigDecimal.new` deprecation by using `BigDecimal()` instead

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at sam.saffron@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in mini_sql.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,6 @@
+guard :minitest do
+  watch(%r{^test/(.*)_test\.rb$})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb$})     { |m| "test/#{m[1]}#{m[2]}_test.rb" }
+  watch(%r{^test/test_helper\.rb$})      { 'test' }
+  watch("test/mini_sql/builder_tests.rb") { ['test/mini_sql/postgres/builder_test.rb', 'test/mini_sql/sqlite/builder_test.rb'] }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 TODO: Write your name
+
+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,120 @@
+# MiniSql
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mini_sql'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mini_sql
+
+## Usage
+
+MiniSql is a very simple, safe and fast SQL executor and mapper for PG and Sqlite.
+
+```ruby
+pg_conn = PG.connect(db_name: 'my_db')
+conn = MiniSql::Connection.get(pg_conn)
+
+puts conn.exec('update table set column = 1 where id in (1,2)')
+# returns 2 if 2 rows changed
+
+conn.query("select 1 id, 'bob' name").each do |user|
+  puts user.name # bob
+  puts user.id # 1
+end
+
+p conn.query_single('select 1 union select 2')
+# [1,2]
+
+p conn.query_hash('select 1 as a, 2 as b union select 3, 4')
+# [{"a" => 1, "b"=> 1},{"a" => 3, "b" => 4}
+```
+
+## The query builder
+
+You can use the simple query builder interface to compose queries.
+
+```ruby
+builder = conn.build("select * from topics /*where*/ /*limit*/")
+
+builder.where('created_at > ?', Time.now - 400)
+
+if look_for_something
+  builder.where("title = :title", title: 'something')
+end
+
+builder.limit(20)
+
+builder.query.each do |t|
+  puts t.id
+  puts t.title
+end
+```
+
+The builder allows for `order_by`, `where`, `select`, `set`, `limit`, `join`, `left_join` and `offset`.
+
+## Is it fast?
+
+Yes, it is very fast. See benchmarks in [the bench directory](https://github.com/discourse/mini_sql/tree/master/bench).
+
+As a rule it will outperform similar naive PG code while remaining safe.
+
+```ruby
+pg_conn = PG.connect(db_name: 'my_db')
+
+# this is slower, and less safe
+result = pg_conn.async_exec('select * from table')
+result.each do |r|
+  name = r['name']
+end
+# ideally you want to remember to run r.clear here
+
+# this is faster and safer
+conn = MiniSql::Connection.get(pg_conn)
+r = conn.query('select * from table')
+
+r.each do |row|
+  name = row.name
+end
+```
+
+## Safety
+
+In PG gem version 1.0 and below you should be careful to clear results. If you do not you risk memory bloat.
+See: [Sam's blog post](https://samsaffron.com/archive/2018/06/13/ruby-x27-s-external-malloc-problem).
+
+MiniSql is careful to always clear results as soon as possible.
+
+## Timestamp decoding
+
+MiniSql's default type mapper prefers treating `timestamp without time zone` columns as utc. This is done to ensure widest amount of compatability and is a departure from the default in the PG 1.0 gem. If you wish to amend behavior feel free to pass in a custom type_map.
+
+
+## I want more features!
+
+MiniSql is designed to be very minimal. Even though the query builder and type materializer give you a lot of mileage, it is not intended to be a fully fledged ORM. If you are looking for an ORM I recommend investigating ActiveRecord or Sequel which provide significantly more features.
+
+## Development
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/SamSaffron/mini_sql. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the MiniSql project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/discourse/mini_sql/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,16 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+if RUBY_ENGINE == 'jruby' # Excluding sqlite3 tests
+  test_glob = "test/**/{inline_param_encoder_test.rb,postgres/*_test.rb}"
+else
+  test_glob = "test/**/*_test.rb"
+end
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList[test_glob]
+end
+
+task :default => :test

data/bench/timestamp_perf.rb

@@ -0,0 +1,286 @@
+require 'bundler/inline'
+
+gemfile do
+  source 'https://rubygems.org'
+  gem 'pg', github: 'ged/ruby-pg'
+  gem 'mini_sql', path: '../'
+  gem 'activesupport'
+  gem 'activerecord'
+  gem 'activemodel'
+  gem 'memory_profiler'
+  gem 'benchmark-ips'
+  gem 'sequel', github: 'jeremyevans/sequel'
+  gem 'sequel_pg', github: 'jeremyevans/sequel_pg', require: 'sequel'
+  # gem 'swift-db-postgres', github: 'deepfryed/swift-db-postgres'
+end
+
+require 'sequel'
+require 'active_record'
+require 'memory_profiler'
+require 'benchmark/ips'
+require 'mini_sql'
+
+ActiveRecord::Base.establish_connection(
+  :adapter => "postgresql",
+  :database => "test_db"
+)
+
+Sequel.default_timezone = :utc
+DB = Sequel.postgres('test_db')
+
+pg = ActiveRecord::Base.connection.raw_connection
+
+pg.async_exec <<SQL
+drop table if exists timestamps
+SQL
+
+pg.async_exec <<SQL
+CREATE TABLE timestamps (
+    id int primary key,
+    time1 timestamp without time zone NOT NULL,
+    time2 timestamp without time zone NOT NULL,
+    time3 timestamp without time zone NOT NULL,
+    time4 timestamp without time zone NOT NULL
+)
+SQL
+
+class Timestamp < ActiveRecord::Base
+end
+
+class TimestampSequel< Sequel::Model(:timestamps)
+end
+
+
+Timestamp.transaction do
+  stamps = {
+  }
+  Timestamp.columns.each do |c|
+    stamps[c.name.to_sym] = case c.type
+                           when :integer then 1
+                           when :datetime then Time.now
+                           when :boolean then false
+                           else "HELLO WORLD" * 2
+                           end
+  end
+
+  1000.times do |id|
+    stamps[:id] = id
+    Timestamp.create!(stamps)
+  end
+end
+
+$conn = ActiveRecord::Base.connection.raw_connection
+
+def ar_pluck_times(l=1000)
+  s = +""
+  Timestamp.limit(l).order(:id).pluck(:time1, :time2).each do |time1, time2|
+    s << time1.to_f.to_s
+    s << time2.to_f.to_s
+  end
+  s
+end
+
+def ar_select_times(l=1000)
+  s = +""
+  Timestamp.limit(l).order(:id).select(:time1, :time2).each do |t|
+    s << t.time1.to_f.to_s
+    s << t.time2.to_f.to_s
+  end
+  s
+end
+
+$mini_sql = MiniSql::Connection.new($conn)
+
+def pg_times_params(l=1000)
+  s = +""
+  # use the safe pattern here
+  r = $conn.async_exec_params(-"select time1, time2 from timestamps order by id limit $1", [l])
+  r.type_map = $mini_sql.type_map
+
+  i = 0
+  a = r.values
+  n = a.length
+
+  while i < n
+    s << a[i][0].to_f.to_s
+    s << a[i][1].to_f.to_s
+    i += 1
+  end
+  r.clear
+  s
+end
+
+def pg_times(l=1000)
+  s = +""
+  # use the safe pattern here
+  r = $conn.async_exec("select time1, time2 from timestamps order by id limit #{l}")
+  r.type_map = $mini_sql.type_map
+
+  i = 0
+  a = r.values
+  n = a.length
+
+  while i < n
+    s << a[i][0].to_f.to_s
+    s << a[i][1].to_f.to_s
+    i += 1
+  end
+  r.clear
+  s
+end
+
+def mini_sql_times(l=1000)
+  s = +""
+  $mini_sql.query(-"select time1, time2 from timestamps order by id limit ?", l).each do |t|
+    s << t.time1.to_f.to_s
+    s << t.time2.to_f.to_s
+  end
+  s
+end
+
+def sequel_times(l=1000)
+  s = +""
+  TimestampSequel.limit(l).order(:id).select(:time1, :time2).each do |t|
+    s << t.time1.to_f.to_s
+    s << t.time2.to_f.to_s
+  end
+  s
+end
+
+def sequel_pluck_times(l=1000)
+  s = +""
+  TimestampSequel.limit(l).order(:id).select_map([:time1, :time2]).each do |t|
+    s << t[0].to_f.to_s
+    s << t[1].to_f.to_s
+  end
+  s
+end
+
+def sequel_raw_times(l=1000)
+  s = +""
+  DB[-"select time1, time2 from timestamps order by id limit ?", l].map([:time1, :time2]).each do |time1, time2|
+    s << time1.to_f.to_s
+    s << time2.to_f.to_s
+  end
+  s
+end
+
+# usage is not really recommended but just to compare to pluck lets have it
+def mini_sql_times_single(l=1000)
+  s = +""
+  i = 0
+  r = $mini_sql.query_single(-"select time1, time2 from timestamps order by id limit ?", l)
+  while i < r.length
+    s << r[i].to_f.to_s
+    s << r[i+1].to_f.to_s
+    i += 2
+  end
+  s
+end
+
+# $swift = Swift::DB::Postgres.new(db: "test_db", user: 'sam', password: 'password')
+#
+# def swift_select_times(l=1000)
+#   s = ""
+#   r = $swift.execute("select time1, time2 from timestamps order by id limit $1", l)
+#   r.each do |row|
+#     s << row[:time1].to_f.to_s
+#     s << row[:time2].to_f.to_s
+#   end
+#   s
+# end
+
+
+results = [
+  ar_select_times,
+  ar_pluck_times,
+  pg_times,
+  pg_times_params,
+  mini_sql_times,
+  mini_sql_times_single,
+  sequel_times,
+  sequel_pluck_times,
+  sequel_raw_times,
+  # can not compare correctly as it is returning DateTime not Time
+  # swift_select_times.gsub("+00:00", "Z")
+]
+
+exit(-1) unless results.uniq.length == 1
+
+Benchmark.ips do |r|
+  r.warmup = 10
+  r.time = 5
+
+  r.report("mini_sql query_single times") do |n|
+    while n > 0
+      mini_sql_times_single
+      n -= 1
+    end
+  end
+  r.report("sequel times") do |n|
+    while n > 0
+      sequel_times
+      n -= 1
+    end
+  end
+  r.report("pg times async_exec values") do |n|
+    while n > 0
+      pg_times_params
+      n -= 1
+    end
+  end
+  r.report("pg times async_exec_params values") do |n|
+    while n > 0
+      pg_times
+      n -= 1
+    end
+  end
+  r.report("mini sql times") do |n|
+    while n > 0
+      mini_sql_times
+      n -= 1
+    end
+  end
+  r.report("sequel pluck times") do |n|
+    while n > 0
+      sequel_pluck_times
+      n -= 1
+    end
+  end
+  r.report("sequel raw times") do |n|
+    while n > 0
+      sequel_raw_times
+      n -= 1
+    end
+  end
+  r.report("ar select times") do |n|
+    while n > 0
+      ar_select_times
+      n -= 1
+    end
+  end
+  r.report("ar pluck times") do |n|
+    while n > 0
+      ar_pluck_times
+      n -= 1
+    end
+  end
+  r.compare!
+end
+
+# Linux x64 numbers
+#
+#
+# pg times async_exec values:      441.6 i/s
+# pg times async_exec_params values:      438.5 i/s - same-ish: difference falls within error
+# mini_sql query_single times:      436.3 i/s - same-ish: difference falls within error
+#     sequel raw times:      426.1 i/s - same-ish: difference falls within error
+#       mini sql times:      417.1 i/s - 1.06x  slower
+#   sequel pluck times:      414.0 i/s - 1.07x  slower
+#         sequel times:      378.5 i/s - 1.17x  slower
+#       ar pluck times:       30.8 i/s - 14.35x  slower
+#      ar select times:       22.7 i/s - 19.44x  slower
+#
+
+# NOTE PG version 1.0.0 has a much slower time materializer
+# NOTE 2: on Mac numbers are far closer Time parsing on mac is slow