xquery 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b1e4c4058ba8d6f621da2a420773cd6b6578c899
-  data.tar.gz: 617512ed3fa56d31783c79e6c1dd87cf990a64be
+  metadata.gz: c136c8a16f768441bc0e2dc4e26e84a2376454da
+  data.tar.gz: d43cc44d95877c754849b0dac45c29866ee37191
 SHA512:
-  metadata.gz: 1fac614b682fe0b4673aafa5c9acd189ad4fa2a90da997244c427cf728fa62a24c781fb49b6bfca8666e9a2061bbb216ea8abc00a9b2593f707ccb0f675c5408
-  data.tar.gz: 0fee5220b9fb5111e27a75979af3b7d40028f636ec31176a0bbca5bf8858ba1dc10af3edfe052a68be898a0f6c9ca05778bd1a8d58b712666ca41adf2120bee3
+  metadata.gz: 1032c489a451dc1f3f32371a7bbc1ddcd095eb2534103c5e1b02fcd8a8f3c5109c6054687c1c8ff87fe089bd34b3727a0fdf7bd89148d301cfd71dea2e859a4b
+  data.tar.gz: 8a0b8a61c0aeb65377c671573cea95cf1b5b2c4f123ab044114d4bf69746fb2669250e5051be5d989de23362df1276c90e0bc4b0c6903c5d41f053fccd069323

data/lib/xquery/abstract.rb

@@ -4,11 +4,11 @@ require 'xquery/query_proxy'
 require 'xquery/errors'
 
 module XQuery
-  # abstract superclass, should be inherited, not used
+  # Abstract superclass, should be inherited, not used
   class Abstract
     class_attribute :query_superclass
 
-    # yields instance inside block. I suggest to name it `q`
+    # Yields instance inside block. I suggest to name it `q`
     # @param args [Array(Object)] array of arguments would be passed to
     # @param block [#to_proc] block to witch instance would be yielded
     def self.with(*args, &block)
@@ -17,10 +17,6 @@ module XQuery
       instance.query
     end
 
-    class << self
-      alias_method :execute, :with
-    end
-
     # Defines `method`, `__method` and `q.method`.
     # Both of wich changes query to query.method
     # @param name [#to_sym] name of method on query
@@ -30,13 +26,13 @@ module XQuery
       alias_on_q(as, true)
     end
 
-    # same as wrap_method, but hanldes multiply methods
+    # Aame as wrap_method, but hanldes multiply methods
     # @param methods [Array(#to_sym)] names of methods defined
     def self.wrap_methods(*methods)
       methods.each(&method(:wrap_method))
     end
 
-    # Aliases method to __method and q.method
+    # Aliases method to `#__method` and `q.method`
     # @param name [#to_sym] name of method
     # @param return_self [Boolean] should defined method return self or result
     def self.alias_on_q(name, return_self = false)
@@ -68,7 +64,27 @@ module XQuery
       @query_proxy = self.class.query_proxy.new(self)
     end
 
-    # yields query inside block
+    # Yields iteself inside block. I suggest to name it `q`
+    # @param block [#to_proc] block to whitch instance would be yielded
+    # @return [Object] query
+    def with(&block)
+      block.call(self)
+      query
+    end
+
+    # Executes specified method, returns query.
+    # Feel free to redefine this method in case it's only public api method
+    # in your class
+    # @param method [#to_sym] any instance public method name
+    # @param args [Array(Object)] method call params
+    # @param block [#to_proc] block would be sent to method
+    # @return [Object] query
+    def execute(method, *args, &block)
+      public_send(method, *args, &block)
+      query
+    end
+
+    # Yields query inside block
     # @param block [#to_proc]
     # @return [XQuery::Abstract] self
     def apply(&block)
@@ -78,14 +94,14 @@ module XQuery
 
     private
 
-    # @private_api
-    # updates query by calling method on it and storing the result
+    # Private Api!
+    # Updates query by calling method on it and storing the result
     # @return [XQuery::Abstract] self
     def _update_query(method, *args, &block)
       apply { |x| x.public_send(method, *args, &block) }
     end
 
-    # added constraints check
+    # Added constraints check
     # @raise XQuery::QuerySuperclassChanged
     def query=(x)
       unless x.is_a?(query_superclass)

data/lib/xquery/version.rb

@@ -1,4 +1,4 @@
 module XQuery
   # defines XQuery version
-  VERSION = '0.1.3'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xquery
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - jelf
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-12-11 00:00:00.000000000 Z
+date: 2015-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
 description: |
   # XQuery
   XQuery is designed to replace boring method call chains and allow to easier