querylet 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6eae3b4c9cb1beeea8edfbb41bab195ad133ac2c91d6393942f942d075860324
-  data.tar.gz: 6632e474232ac27c6e64cd3d991b65e5331e61e97116280b9b8a9b00c1702a5f
+  metadata.gz: 1ec97dcd15beb09f85b656e57b8ab282ec722955f411afaaef3db77ac3682230
+  data.tar.gz: 1d532fbbc2a5335703348f00d645f48ffe406943a0084ebf8ebf2ac97ba9c3c5
 SHA512:
-  metadata.gz: c33031f332be7c159ce11f3fb4ec86cf8b606125ad3cf51cfd28c4aa7bb3600d2d5188b7bcb91664bc7b00d307cd258784b09fed852e5886cc8cd4e243ea22d6
-  data.tar.gz: 1d5b1e8f732f7dd43dd110c442528a5af5b6d9939593d57bb5a9f5724e2e9d8fab9083265a885f2e57977f6612724babdc3a451aa0c786b0c4f7ab0edca19c30
+  metadata.gz: f48440d625e46181aea476dfe79f3e4f354c2848cb7d6b480f4e093ebc739d1b30a019cf55356bb338db2bab29bc1be54817d4691f528817c4b54a8607a00dd0
+  data.tar.gz: 86552d7a090baf83feb29d94aff63474af7a8f43816027c74e07a05d35f67d3b329ffd9784348b98a6ce87d7c892cf80462755b6b5affedb50e2d29a38745a0d

data/README.md

@@ -1,21 +1,118 @@
-## Querylet
+# Querylet
+
+Querylet is a templating language for SQL
+and is designed to make writing raw SQL much easier.
+
+```sql
+SELECT
+  questions.id,
+  questions.uuid,
+  questions.question_html as question,
+  questions.target_type as kind,
+  {{#object}}
+  SELECT
+    case_study_questions.menu,
+    case_study_questions.questions_pool_size,
+
+    CASE {{str sub_question_type}}
+    WHEN 'MultiChoiceQuestion' THEN
+      {{> object 'questions.multiple_choice' id='{{sub_question_id}}' }} as question
+    WHEN 'MultiSelectQuestion' THEN
+      {{> object 'questions.multiple_select' id='{{sub_question_id}}' }} as question
+    END,
+
+    {{#array}}
+      SELECT
+        que.id,
+        que.uuid,
+        que.target_type as kind,
+        choices.comment,
+        choices.flagged,
+        choices.choice_value as answered,
+        multiple_select_questions.answers_count
+      FROM ts_admin_que.questions que
+      LEFT JOIN public.choices ON choices.question_id = que.id AND choices.attempt_id = {{id}}
+      LEFT JOIN ts_admin_que.multiple_select_questions ON multiple_select_questions.id = que.target_id AND que.target_type = 'MultipleSelectQuestion'
+      WHERE
+        que.id = ANY(case_study_questions.question_ids)
+    {{/array}} as questions
+  {{/object}} as case_study
+FROM ts_admin_que.questions
+LEFT JOIN ts_admin_que.case_study_questions ON case_study_questions.question_id = questions.id
+WHERE
+  questions.id = {{id}}
+```
+
+## Variable Filters
+ 
+### Int (Integer)
+
+Cast variable to integer
+
+```
+{{int my_number}}
+```
+
+### Str (String)
+
+Cast variable to string
 
-#Variables
+```
+{{str my_string}}
+```
 
+### Float
+
+Cast variable to float
+
+```
+{{float my_number}}
+```
+
+### Arr (Array)
+
+Cast to array (not a postgres array)
+
+```
+{{arr my_array}}
+```
+
+### Wild (Wildcard)
+
+Wildcard front and back of string
+
+```
+{{wild my_string}}
+```
+
+### Variables
+
+```
 {{my_variable}}
+```
 
-#Partials
+### Partials
 
-{{>include 'link.to.path' param='{{testing}}'}}
+```
+{{> include 'link.to.path' name='andrew' }}
+{{> include 'link.to.path' name={{my_name}} }}
+{{> include 'link.to.path' name={{str my_name}} }}
+```
+
+### Partial blocks
 
-#Partial blocks
+```
 {{#array}}
 {{/array}}
+```
 
-# If Else
+### If Else
+
+```
 {{#if variable}}
 {{else}}
 {{/end}}
+```
 
 ## Parslet
 
@@ -56,12 +153,10 @@ parser.parse_with_debug(input)
 
 ## Parser
 
-Parslet parsers output deep nested hashes.
-
-To see all the define rules check out `parser_helper.rb`
+To see all the define rules check out `parser_spec.rb`
 
 ```
-rspec spec/parser_helper.rb
+bundle exec rspec spec/parser_spec.rb
 ```
 
 ## Transform

data/lib/querylet/parser.rb

@@ -96,7 +96,7 @@ module Querylet
     rule(:variable) { docurly >> space? >> id.as(:variable) >> space? >> dccurly}
 
     # Can either be a variable or a string:
-    rule(:parameter)   { id.as(:variable) | string }
+    rule(:parameter) {  id.as(:variable) | string }
 
     # used in includes eg. hello='world'
     rule(:parameter_kv) {
@@ -104,7 +104,7 @@ module Querylet
       space? >>
       eq >>
       space? >>
-      string.as(:value) >>
+      (filter | variable | string).as(:value) >>
       space?
     }
 
@@ -147,7 +147,7 @@ module Querylet
     rule(:nocurly)     { match('[^{}]') }
     rule(:eof)         { any.absent? }
 
-    # String contained in Single Qoutes 'content'
+    # String contained in Single Quotes 'content'
     rule(:string)   { match("'") >> match("[^']").repeat(1).as(:string) >> match("'") }
   end
 end

data/lib/querylet/tree.rb

@@ -131,6 +131,8 @@ module Querylet
           else
             raise "expected input for: #{parameter.item} to be String, Integer or Array"
           end
+        else
+          raise "unexpected filter name: #{filter}"
         end
       end
     end

data/lib/querylet/version.rb

@@ -1,4 +1,4 @@
 module Querylet
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end
 

data/spec/parser_spec.rb

@@ -10,10 +10,9 @@ RSpec.describe Querylet::Parser do
     end
 
     it 'string' do 
-      (SELECT COALESCE(row_to_json(object_row),'{}'::json) FROM (
-
       expect(parser.parse_with_debug("(SELECT COALESCE(row_to_json(object_row),'{}'::json) FROM (")).to eq({items:[{content: "(SELECT COALESCE(row_to_json(object_row),'{}'::json) FROM ("}]})
     end
+
     it 'variable' do
       expect(parser.parse('{{worf}}')).to eq({items:[{variable: 'worf'}]})
       expect(parser.parse('{{ worf}}')).to eq({items:[{variable: 'worf'}]})
@@ -52,8 +51,24 @@ RSpec.describe Querylet::Parser do
         partial: 'include',
         path: 'path.to.template',
         parameters: [
-          {key: 'hello', value: {string: 'world'}},
-          {key: 'star', value: {string: 'trek'}}
+          {key: 'hello', value: { string: 'world'}},
+          {key: 'star' , value: { string: 'trek'}}
+        ]
+      }]})
+
+      expect(parser.parse("{{> include 'path.to.template' hello={{world}} }}")).to eq({items:[{
+        partial: 'include',
+        path: 'path.to.template',
+        parameters: [
+          {key: 'hello', value: { variable: 'world'}}
+        ]
+      }]})
+
+      expect(parser.parse("{{> include 'path.to.template' hello={{int world}} }}")).to eq({items:[{
+        partial: 'include',
+        path: 'path.to.template',
+        parameters: [
+          {key: 'hello', value: {filter: 'int', parameter: {variable: 'world'} }}
         ]
       }]})
     end

data/spec/querylet_spec.rb

@@ -58,6 +58,31 @@ SQL
         expect(evaluate(template, {id: 100})).to eq(query)
       end
 
+      it 'include with parameters variable' do
+query = <<-SQL.chomp
+(SELECT
+  users.email
+FROM users
+WHERE
+  users.id = 300) as email
+SQL
+        template = "({{> include 'examples.include_with_params_vars' id={{user_id}} name='andrew' }}) as email"
+        expect(evaluate(template, {user_id: 300})).to eq(query)
+      end
+
+      it 'include with parameters filter' do
+query = <<-SQL.chomp
+(SELECT
+  users.email,
+  'Andrew' as name
+FROM users
+WHERE
+  users.id = 100) as email
+SQL
+        template = "({{> include 'examples.include_with_params_filter' name={{str my_name}} }}) as email"
+        expect(evaluate(template, {my_name: "Andrew", id: 100})).to eq(query)
+      end
+
       it 'object' do
 query = <<-SQL.chomp
 (SELECT COALESCE(row_to_json(object_row),'{}'::json) FROM (

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: querylet
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - ExamPro
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-05 00:00:00.000000000 Z
+date: 2023-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parslet
@@ -74,7 +74,7 @@ homepage: http://exampro.co
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -89,11 +89,11 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key:
+rubygems_version: 3.4.10
+signing_key: 
 specification_version: 4
 summary: Querylet
 test_files:
-- spec/spec_helper.rb
 - spec/parser_spec.rb
 - spec/querylet_spec.rb
+- spec/spec_helper.rb