fluent-query 0.9.0

data/lib/fluent-query/query.rb

@@ -0,0 +1,118 @@
+# encoding: utf-8
+require "fluent-query/queries/abstract"
+require "fluent-query/queries/compiled"
+require "fluent-query/queries/prepared"
+require "fluent-query/token"
+require "fluent-query/tokens/raw"
+
+module FluentQuery
+        
+     ##
+     # Represents single query.
+     #
+     
+     class Query < FluentQuery::Queries::Abstract
+
+        ##
+        # Tokens stack.
+        #
+
+        @stack
+        attr_reader :stack
+
+        ##
+        # Initializes query.
+        #
+
+        public
+        def initialize(connection)
+            super(connection)
+            @stack = [ ]
+        end
+        
+        ##
+        # Catches missing methods calls. Converts them to tokens.
+        #
+
+        public
+        def method_missing(sym, *args, &block)
+            
+            self.push_token(sym, args)
+            driver = @connection.driver
+            conditionally = driver.execute_conditionally(self, sym, *args, &block)
+
+            if not conditionally.nil?
+                result = conditionally
+            else
+                result = self
+            end
+            
+            return result
+        end
+
+        ##
+        # Pushes new token according to specified arguments to the stack.
+        #
+        
+        public
+        def push_token(name, arguments)
+            @stack << FluentQuery::Token::new(name, arguments)
+        end
+
+        ##
+        # Pushes raw token to the query, so free unassociated query string.
+        #
+
+        public
+        def query(*args)
+            @stack << FluentQuery::Tokens::Raw::new(args)
+            return self
+        end
+
+        ##
+        # Returns type of the query, so name of the first token
+        # in the stack.
+        #
+
+        public
+        def type
+            self.stack.first.name.to_sym
+        end
+
+        ##
+        # Builds the query.
+        #
+
+        public
+        def build
+            @connection.driver.build_query(self)
+        end
+        
+        alias :"build!" :build
+
+        ##
+        # Compiles query.
+        # Returns compiled query object.
+        #
+        
+        public
+        def compile
+            FluentQuery::Queries::Compiled::new(@connection, self)
+        end
+        
+        alias :"compile!" :compile
+
+        ##
+        # Prepares query.
+        # Returns prepared query object.
+        #
+        
+        public
+        def prepare
+            FluentQuery::Queries::Prepared::new(@connection, self)
+        end
+        
+        alias :"prepare!" :prepare
+
+    end
+end

data/lib/fluent-query/result.rb

@@ -0,0 +1,153 @@
+# encoding: utf-8
+require "fluent-query/exception"
+
+module FluentQuery
+                
+     ##
+     # Represents result wrapper.
+     #
+     
+     class Result
+
+        ##
+        # Holds driver result.
+        #
+
+        @_result
+        
+        ##
+        # Initializes result.
+        # 
+
+        public
+        def initialize(result)
+            @_result = result
+        end
+
+        ##
+        # Finishes the result set.
+        # (Cleanups.)
+        #
+
+        public
+        def finish!
+            @_result.free!
+        end
+
+        ##
+        # Returns all selected rows.
+        #
+
+        public
+        def all
+            @_result.all
+        end
+
+        ##
+        # Returns one row.
+        #
+
+        public
+        def one
+            @_result.one
+        end
+
+        ##
+        # Returns first value of first row.
+        #
+
+        public
+        def single
+            @_result.single
+        end
+
+        ##
+        # Returns data in complex associative level.
+        # Only two levels are currently supported.
+        #
+
+        public
+        def assoc(*specification, &block)
+        
+            if block.nil?
+                block = Proc::new { |v| v }
+            end
+            
+            specification.map! { |i| i.to_s }
+            length = specification.length
+            result = { }
+
+            ##
+            
+            if length == 0
+                raise FluentQuery::Exception::new("Specification must content at least one field name.")
+            elsif length == 1
+                key = specification.first
+                
+                self.each do |item|
+                    result[item[key]] = block.call(item)
+                end
+            else
+                key_1, key_2 = specification
+                
+                self.each do |item|
+                    target_1 = item[key_1]
+                    target_2 = item[key_2]
+
+                    if not result[target_1]
+                        result[target_1] = { }
+                    end
+                    
+                    result[target_1][target_2] = block.call(item)
+                end
+            end
+            
+            return result
+        end
+
+        ##
+        # Handles iterating.
+        #
+
+        public
+        def each(&block)
+            @_result.each &block
+            self.free!
+        end
+
+        ##
+        # Repeats the query leaded to the result.
+        #
+
+        public
+        def repeat!
+            @_result.repeat!
+        end
+
+        ##
+        # Returns rows count.
+        #
+
+        public
+        def count
+            @_result.count
+        end
+        
+        ##
+        # Frees result resources.
+        #
+
+        public
+        def free!
+            @_result.free!
+        end
+        
+        ##
+        # Finishes the result set.
+        # (Cleanups.)
+        #
+
+        alias :"finish!" :"free!"
+        
+     end
+ end

data/lib/fluent-query/token.rb

@@ -0,0 +1,73 @@
+# encoding: utf-8
+
+module FluentQuery
+                
+     ##
+     # Represents general query token.
+     #
+     
+     class Token
+
+        ##
+        # Name of the token.
+        #
+        
+        @_name
+
+        ##
+        # Alias of the token.
+        #
+        
+        @_alias
+
+        ##
+        # Arguments for the token.
+        #
+        
+        @arguments
+        attr_reader :arguments
+        
+        ##
+        # Initializes token.
+        #
+
+        public
+        def initialize(name, arguments)
+            @_name = name
+            @arguments = arguments
+        end
+
+        ##
+        # Returns token name.
+        #
+
+        public
+        def name
+            if @_alias
+                return @_alias
+            else
+                return @_name
+            end
+        end
+        
+        ##
+        # Returns original token name.
+        #
+
+        public
+        def original_name
+            @_name
+        end
+
+        ##
+        # Sets alias for token.
+        #
+
+        public
+        def alias=(_alias)
+            @_alias = _alias
+        end
+        
+     end
+     
+end

data/lib/fluent-query/tokens/raw.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+require "fluent-query/token"
+
+module FluentQuery
+    module Tokens
+    
+         ##
+         # Represents query raw token.
+         #
+         
+         class Raw < FluentQuery::Token
+         
+            ##
+            # Initializes token.
+            #
+
+            public
+            def initialize(arguments)
+                super(:" ", arguments)
+            end
+            
+         end
+         
+     end
+ end
+

metadata

@@ -0,0 +1,136 @@
+--- !ruby/object:Gem::Specification 
+name: fluent-query
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.9.0
+platform: ruby
+authors: 
+- "Martin Koz\xC3\xA1k"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-14 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hash-utils
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.18.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: abstract
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.0.13
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+description: 
+email: martinkozak@martinkozak.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- fluent-query.gemspec
+- lib/fluent-query.rb
+- lib/fluent-query/compiler.rb
+- lib/fluent-query/compilers/result.rb
+- lib/fluent-query/connection.rb
+- lib/fluent-query/data.rb
+- lib/fluent-query/driver.rb
+- lib/fluent-query/drivers/exception.rb
+- lib/fluent-query/drivers/result.rb
+- lib/fluent-query/exception.rb
+- lib/fluent-query/queries/abstract.rb
+- lib/fluent-query/queries/compiled.rb
+- lib/fluent-query/queries/prepared.rb
+- lib/fluent-query/queries/processor.rb
+- lib/fluent-query/query.rb
+- lib/fluent-query/result.rb
+- lib/fluent-query/token.rb
+- lib/fluent-query/tokens/raw.rb
+homepage: http://github.com/martinkozak/fluent-query
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 4267616257212336465
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: Cool way how to write SQL queries and general way how to convert series of method calls to string query in an universal and system independent manner. This gem contains base libraries only. SQL implementation is available standalone.
+test_files: []
+