where_builder 0.0.1 → 0.0.2

data/.gitignore

@@ -15,3 +15,4 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+.DS_Store

data/README.md

@@ -1,6 +1,8 @@
+
 # WhereBuilder
 
-TODO: Write a gem description
+  use this tool can build a where sentence for sql, it's can ignore a condition when it's para is nil or black string.
+  my purpose is not check nil for every condition, don't repeat so much if else.
 
 ## Installation
 
@@ -27,3 +29,4 @@ TODO: Write usage instructions here
 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/lib/where_builder.rb

@@ -2,38 +2,72 @@
 require "where_builder/version"
 
 module WhereBuilder
+
+=begin
+  use this tool can build a where sentence for sql, it's can ignore a condition when it's para is nil or black string.
+  my purpose is not check nil for every condition, don't repeat so much if else.
+=end
   class WhereBuilder
 
-    def add(cond_str, para)
-      if para == nil || para.to_s.strip.size == 0
+=begin
+  add first condition on 'where ..' or '(..)', you can use AND(..) or OR(..), it's ok, just ugly
+  cond_str:  like 'a.name=?', 'a.id=b.user_id'
+  para:   like 'leo', 123, nil
+  
+  return : fn
+=end
+    def add(cond_str, para=nil)
+      if (para == nil or para.to_s.strip.size == 0) and cond_str.include?('?') 
         return
       end
       #TODO in and not in
       return lambda{return cond_str, para}
     end
 
+=begin
+  add a 'and' condition on 'where ..' or '(..)', 
+  cond_str:  like 'a.name=?', 'a.id=b.user_id' or nil, if it's nil, just append a ' AND ' str, 
+  para:   like 'leo', 123, nil
+
+  return : fn
+=end
     def AND(cond_str=nil, para=nil)
       if cond_str == nil 
         return lambda{return " AND", nil}
       end
-      if para == nil || para.to_s.strip.size == 0
+      if (para == nil or para.to_s.strip.size == 0) and cond_str.include?('?') 
         return
       end
       return lambda{return " AND #{cond_str}", para}
     end
 
+=begin
+  add a 'or' condition on 'where ..' or '(..)', 
+  cond_str:  like 'a.name=?', 'a.id=b.user_id' or nil, if it's nil, just append a ' OR ' str, 
+  para:   like 'leo', 123, nil
+  
+  return : fn
+=end
     def OR(cond_str=nil, para=nil)
       if cond_str == nil 
         return lambda{return " OR", nil}
       end
-      if para == nil || para.to_s.strip.size == 0
+      if (para == nil or para.to_s.strip.size == 0) and cond_str.include?('?') 
         return
       end
       return lambda{return " OR #{cond_str}", para}
     end
 
-    def bracket(*args2)
-      fn = build_fn(*args2)
+=begin
+  if you want add some condition with '()', use this method.
+  use like this : 
+  f = WhereBuilder.new()
+  f.bracket(f.add(...), f.AND(...), f.AND(...))
+  
+  return : fn
+=end
+    def bracket(*args)
+      fn = _build_fn(*args)
       return if fn == nil
       para = fn.call
       if para == nil || para.size == 0
@@ -42,7 +76,10 @@ module WhereBuilder
       return lambda{return " (#{para[0]})", para[1]}
     end
 
-    def build_fn(*args)
+=begin
+  do not use this method if you do't want to fix bug or upgrade this tool.
+=end
+    def _build_fn(*args)
       cond_str = []
       para_list = []
       size = args.size
@@ -83,8 +120,24 @@ module WhereBuilder
       return lambda{return " #{cond_str.join('')}", para_list}
     end
 
+=begin
+  this is the enter for this tool, 
+  use it like this : 
+  f = WhereBuilder.new()
+
+  string, para_list = f.build(
+                          f.add(...), 
+                          f.AND(...), 
+                          f.AND(...), 
+                          f.bracket(
+                            f.add(...), 
+                            f.OR(...))
+                          f.OR(...))
+  
+  return : [string, para_list]
+=end
     def build(*args)
-      fn = build_fn(*args)
+      fn = _build_fn(*args)
       if fn == nil
         return ''
       end

data/lib/where_builder/version.rb

@@ -1,3 +1,3 @@
 module WhereBuilder
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: where_builder
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors: