inquery 1.0.1 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2510806e3068638779cf5e1012b37c8ddfd1141e
-  data.tar.gz: 60217fc4f8376d9939ba8851705a94ead50f5b22
+SHA256:
+  metadata.gz: 7ac604691796b01bc6b7021873a6394c3080b7616b8536cc791a77e5a712b6b8
+  data.tar.gz: 4379bf6bd66d8f0320a0f68bd5992c69dbf6945e1fb1a3f010222dabd5cccead
 SHA512:
-  metadata.gz: 77725cde076b84538c4a020b66e1a70a4138f3b3eed00be69f3361c1c11db1bc743794bf2f84300ff392a0c54b5799701a2f80dc2e9c19cbd16bd12e5750248a
-  data.tar.gz: d257e5b56c8649bb77fce41b03b336a5e3506957103df9da7880d5e4d34d36ec63668cc42a6d504dfad5e4d08d16fbc9a50a6302389cc7b2eb65b089f4e25003
+  metadata.gz: c1ea9cb3876faf797b5e63479a24d8f8254d0f7d511f25542e8787c1577dcc1166e569add18a9cedf52a3c4d70edca85094b6972971f1f9cfcfc3215866311eb
+  data.tar.gz: c1c623510562c7c2dc9f41edd90a46df560ae59221a3db9317aa9d0dc5b8955b1f034b43ec14008721d8b8d51effb63d923c30ad53990d7526b8774015edacc5

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Change log
+
+## 1.0.5 (2020-11-24)
+
+- Improve support for schemacop 3.x
+
+## 1.0.5 (2020-11-24)
+
+- Improve support for schemacop 3.x and document it
+
+## 1.0.4 (2020-11-24)
+
+- Add support for schemacop 3.x (but still using 2.x schema version)
+
+## 1.0.3 (2020-05-12)
+
+- Overwrite parameter hash with the casted version if using 
+  casting inside the schemacop `schema` block
+
+## 1.0.2 (2019-10-09)
+
+- Add new mixin `RawSqlUtils`, which provides two methods for
+  `Inquery::Query`:
+
+    - `san`: Sanitizes SQL and performs parameter substitution
+    - `exec_query`: For directly executing SQL queries
+
+## 1.0.1 (2017-05-17)
+
+- Pin `schemacop` version properly
+
+## 1.0.0 (2017-05-16)
+
+- Initial release

data/LICENSE

@@ -1,6 +1,6 @@
-The MIT License (MIT)
+MIT License
 
-Copyright (c) 2016 Sitrox
+Copyright (c) 2020 Sitrox
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -87,6 +87,37 @@ FetchRedCarsAsJson.new(params = {}).call
 Note that it's perfectly fine for some queries to return `nil`, i.e. if they're
 writing queries that don't fetch any results.
 
+### Using raw SQL
+
+In some cases it may make sense to push down all computation to the database and
+only construct an SQL query for this purpose. To facilitate this,
+{Inquery::Query} provides sanitization and query execution methods:
+
+```ruby
+# Note: There are better ways of achieving the same result, this is an example
+# to demonstrate the methods.
+class CheckIfSold < Inquery::Query
+  def call
+    parts = [
+      'SELECT car_id FROM dealership_sales',
+      'SELECT car_id FROM dealership_leasings'
+    ]
+
+    sql = 'SELECT ? IN (' + parts.join(' UNION ') + ')'
+
+    # The 'san' method takes n+1 arguments: The SQL string and n parameters
+    sanitized_sql = san(sql, osparams.car_id)
+
+    # Returns instance of ActiveRecord::Result
+    return exec_query(sanitized_sql)
+  end
+
+  def process(results)
+    results.rows.first.first
+  end
+end
+```
+
 ## Chainable queries
 
 Chainable queries are queries that input and output an Active Record relation.
@@ -253,6 +284,9 @@ class SomeQueryClass < Inquery::Query
 end
 ```
 
+Inquery supports both schemacop specification versions 2 and 3 using the methods
+`schema` / `schema2` for version 2 and method `schema3` for version 3.
+
 ## Rails integration
 
 While it is optional, Inquery has been written from the ground up to be
@@ -288,8 +322,7 @@ There are some key benefits to this approach:
 
 Thanks to Jeroen Weeink for his insights regarding using query classes as scopes
 in his [blog post](http://craftingruby.com/posts/2015/06/29/query-objects-through-scopes.html).
-And special thanks to [SubGit](http://www.subgit.com/) for their great open source licensing.
 
 ## Copyright
 
-Copyright (c) 2017 Sitrox. See `LICENSE` for further details.
+Copyright (c) 2020 Sitrox. See `LICENSE` for further details.

data/RUBY_VERSION

@@ -1 +1 @@
-ruby-2.3.1-p112
+ruby-2.6.2-p47

data/Rakefile

@@ -11,7 +11,7 @@ task :gemspec do
     spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
     spec.require_paths = ['lib']
 
-    spec.add_development_dependency 'bundler', '~> 1.3'
+    spec.add_development_dependency 'bundler'
     spec.add_development_dependency 'rake'
     spec.add_development_dependency 'sqlite3'
     spec.add_development_dependency 'haml'
@@ -21,7 +21,7 @@ task :gemspec do
     spec.add_dependency 'minitest'
     spec.add_dependency 'activesupport'
     spec.add_dependency 'activerecord'
-    spec.add_dependency 'schemacop', '~> 2.0'
+    spec.add_dependency 'schemacop', '>= 2.0'
   end
 
   File.open('inquery.gemspec', 'w') { |f| f.write(gemspec.to_ruby.strip) }

data/VERSION

@@ -1 +1 @@
-1.0.1
+1.0.6

data/doc/Inquery.html

@@ -6,15 +6,15 @@
 <title>
   Module: Inquery
   
-    &mdash; Documentation by YARD 0.9.9
+    &mdash; Documentation by YARD 0.9.25
   
 </title>
 
-  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "Inquery";
   relpath = '';
 </script>
@@ -79,7 +79,7 @@
   <dl>
     <dt>Defined in:</dt>
     <dd>lib/inquery.rb<span class="defines">,<br />
-  lib/inquery/query.rb,<br /> lib/inquery/exceptions.rb,<br /> lib/inquery/query/chainable.rb,<br /> lib/inquery/mixins/schema_validation.rb,<br /> lib/inquery/mixins/relation_validation.rb</span>
+  lib/inquery/query.rb,<br /> lib/inquery/exceptions.rb,<br /> lib/inquery/query/chainable.rb,<br /> lib/inquery/mixins/raw_sql_utils.rb,<br /> lib/inquery/mixins/schema_validation.rb,<br /> lib/inquery/mixins/relation_validation.rb</span>
 </dd>
   </dl>
   
@@ -109,9 +109,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed May 17 12:30:38 2017 by
+  Generated on Wed Nov 25 14:04:11 2020 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.3.1).
+  0.9.25 (ruby-2.6.2).
 </div>
 
     </div>

data/doc/Inquery/Exceptions.html

@@ -6,15 +6,15 @@
 <title>
   Module: Inquery::Exceptions
   
-    &mdash; Documentation by YARD 0.9.9
+    &mdash; Documentation by YARD 0.9.25
   
 </title>
 
-  <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "Inquery::Exceptions";
   relpath = '../';
 </script>
@@ -105,9 +105,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed May 17 12:30:38 2017 by
+  Generated on Wed Nov 25 14:04:12 2020 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.3.1).
+  0.9.25 (ruby-2.6.2).
 </div>
 
     </div>

data/doc/Inquery/Exceptions/Base.html

@@ -6,15 +6,15 @@
 <title>
   Exception: Inquery::Exceptions::Base
   
-    &mdash; Documentation by YARD 0.9.9
+    &mdash; Documentation by YARD 0.9.25
   
 </title>
 
-  <link rel="stylesheet" href="../../css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../../css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="../../css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../../css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "Inquery::Exceptions::Base";
   relpath = '../../';
 </script>
@@ -118,9 +118,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed May 17 12:30:38 2017 by
+  Generated on Wed Nov 25 14:04:12 2020 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.3.1).
+  0.9.25 (ruby-2.6.2).
 </div>
 
     </div>

data/doc/Inquery/Exceptions/InvalidRelation.html

@@ -6,15 +6,15 @@
 <title>
   Exception: Inquery::Exceptions::InvalidRelation
   
-    &mdash; Documentation by YARD 0.9.9
+    &mdash; Documentation by YARD 0.9.25
   
 </title>
 
-  <link rel="stylesheet" href="../../css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../../css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="../../css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../../css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "Inquery::Exceptions::InvalidRelation";
   relpath = '../../';
 </script>
@@ -122,9 +122,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed May 17 12:30:38 2017 by
+  Generated on Wed Nov 25 14:04:12 2020 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.3.1).
+  0.9.25 (ruby-2.6.2).
 </div>
 
     </div>

data/doc/Inquery/Exceptions/UnknownCallSignature.html

@@ -6,15 +6,15 @@
 <title>
   Exception: Inquery::Exceptions::UnknownCallSignature
   
-    &mdash; Documentation by YARD 0.9.9
+    &mdash; Documentation by YARD 0.9.25
   
 </title>
 
-  <link rel="stylesheet" href="../../css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../../css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="../../css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../../css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "Inquery::Exceptions::UnknownCallSignature";
   relpath = '../../';
 </script>
@@ -122,9 +122,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed May 17 12:30:38 2017 by
+  Generated on Wed Nov 25 14:04:12 2020 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.3.1).
+  0.9.25 (ruby-2.6.2).
 </div>
 
     </div>

data/doc/Inquery/Mixins.html

@@ -6,15 +6,15 @@
 <title>
   Module: Inquery::Mixins
   
-    &mdash; Documentation by YARD 0.9.9
+    &mdash; Documentation by YARD 0.9.25
   
 </title>
 
-  <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../css/style.css" type="text/css" />
 
-  <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="../css/common.css" type="text/css" />
 
-<script type="text/javascript" charset="utf-8">
+<script type="text/javascript">
   pathId = "Inquery::Mixins";
   relpath = '../';
 </script>
@@ -78,8 +78,8 @@
   
   <dl>
     <dt>Defined in:</dt>
-    <dd>lib/inquery/mixins/schema_validation.rb<span class="defines">,<br />
-  lib/inquery/mixins/relation_validation.rb</span>
+    <dd>lib/inquery/mixins/raw_sql_utils.rb<span class="defines">,<br />
+  lib/inquery/mixins/schema_validation.rb,<br /> lib/inquery/mixins/relation_validation.rb</span>
 </dd>
   </dl>
   
@@ -89,7 +89,7 @@
 <p class="children">
   
     
-      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Mixins/RelationValidation.html" title="Inquery::Mixins::RelationValidation (module)">RelationValidation</a></span>, <span class='object_link'><a href="Mixins/SchemaValidation.html" title="Inquery::Mixins::SchemaValidation (module)">SchemaValidation</a></span>
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Mixins/RawSqlUtils.html" title="Inquery::Mixins::RawSqlUtils (module)">RawSqlUtils</a></span>, <span class='object_link'><a href="Mixins/RelationValidation.html" title="Inquery::Mixins::RelationValidation (module)">RelationValidation</a></span>, <span class='object_link'><a href="Mixins/SchemaValidation.html" title="Inquery::Mixins::SchemaValidation (module)">SchemaValidation</a></span>
     
   
     
@@ -107,9 +107,9 @@
 </div>
 
       <div id="footer">
-  Generated on Wed May 17 12:30:38 2017 by
+  Generated on Wed Nov 25 14:04:12 2020 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.3.1).
+  0.9.25 (ruby-2.6.2).
 </div>
 
     </div>

data/doc/Inquery/Mixins/RawSqlUtils.html

@@ -0,0 +1,116 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Module: Inquery::Mixins::RawSqlUtils
+  
+    &mdash; Documentation by YARD 0.9.25
+  
+</title>
+
+  <link rel="stylesheet" href="../../css/style.css" type="text/css" />
+
+  <link rel="stylesheet" href="../../css/common.css" type="text/css" />
+
+<script type="text/javascript">
+  pathId = "Inquery::Mixins::RawSqlUtils";
+  relpath = '../../';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="../../js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="../../class_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="../../_index.html">Index (R)</a> &raquo;
+    <span class='title'><span class='object_link'><a href="../../Inquery.html" title="Inquery (module)">Inquery</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Mixins.html" title="Inquery::Mixins (module)">Mixins</a></span></span>
+     &raquo; 
+    <span class="title">RawSqlUtils</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="../../class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><h1>Module: Inquery::Mixins::RawSqlUtils
+  
+  
+  
+</h1>
+<div class="box_info">
+  
+
+  
+  
+  <dl>
+      <dt>Extended by:</dt>
+      <dd>ActiveSupport::Concern</dd>
+  </dl>
+  
+  
+  
+  
+
+  
+  <dl>
+    <dt>Included in:</dt>
+    <dd><span class='object_link'><a href="../Query.html" title="Inquery::Query (class)">Query</a></span></dd>
+  </dl>
+  
+
+  
+  <dl>
+    <dt>Defined in:</dt>
+    <dd>lib/inquery/mixins/raw_sql_utils.rb</dd>
+  </dl>
+  
+</div>
+
+
+
+
+
+
+
+
+
+  
+
+</div>
+
+      <div id="footer">
+  Generated on Wed Nov 25 14:04:12 2020 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.25 (ruby-2.6.2).
+</div>
+
+    </div>
+  </body>
+</html>