aql 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 831cd3ea9ec7a3ae864fa6f3579481602b4f323a
+  data.tar.gz: ddfb790665d03384c0defee6d89f40114feed595
+SHA512:
+  metadata.gz: 61895ff8f2d104ac0d092a0a236d6926be791585f0aec9592dfd70d1b50e6dab80bebd635782f5692171194e77d40ddfb1a103a57569848bb3c43736505e2e89
+  data.tar.gz: c7afee1e4caed51811e269d4af0674e50af5f1eae56772b79fed0eb4d847826f896b2289fc8bf8c7dc1113951fec8170f293a813cae84685ea429676e52a10e6

data/.gitignore

@@ -0,0 +1,4 @@
+/Gemfile.lock
+/tmp
+/.bundle
+/vendor

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,18 @@
+language: ruby
+script: 'bundle exec rake ci'
+rvm:
+  - ree
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - ruby-head
+  - jruby-18mode
+  - jruby-19mode
+  - jruby-head
+  - rbx-18mode
+  - rbx-19mode
+notifications:
+  irc: "irc.freenode.org#datamapper"
+  email:
+    - mbj@seonic.net

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'devtools',    :git => 'https://github.com/datamapper/devtools.git'
+eval File.read('Gemfile.devtools')

data/Gemfile.devtools

@@ -0,0 +1,64 @@
+# encoding: utf-8
+
+group :development do
+  gem 'rake',  '~> 10.0.3'
+  gem 'rspec', '~> 2.13.0'
+  gem 'yard',  '~> 0.8.5'
+end
+
+group :yard do
+  gem 'kramdown', '~> 0.14.2'
+end
+
+group :guard do
+  gem 'guard',         '~> 1.6.2'
+  gem 'guard-bundler', '~> 1.0.0'
+  gem 'guard-rspec',   '~> 2.4.1'
+
+  # file system change event handling
+  gem 'rb-fchange', '~> 0.0.6', :require => false
+  gem 'rb-fsevent', '~> 0.9.3', :require => false
+  gem 'rb-inotify', '~> 0.9.0', :require => false
+
+  gem 'listen', '~> 0.7.3'
+
+  # notification handling
+  gem 'libnotify',               '~> 0.8.0', :require => false
+  gem 'rb-notifu',               '~> 0.0.4', :require => false
+  gem 'terminal-notifier-guard', '~> 1.5.3', :require => false
+end
+
+group :metrics do
+  gem 'flay',            '~> 2.1.0'
+  gem 'flog',            '~> 3.2.2'
+  gem 'reek',            '~> 1.3.1'
+  gem 'metric_fu-roodi', '~> 2.2.1'
+  gem 'yardstick',       '~> 0.9.4'
+
+  platforms :ruby_18, :ruby_19 do
+    # this indirectly depends on ffi which does not build on ruby-head
+    gem 'yard-spellcheck', '~> 0.1.5'
+  end
+
+  platforms :mri_19, :rbx do
+    gem 'mutant', '~> 0.2.20'
+  end
+
+  platforms :mri_19 do
+    gem 'simplecov', '~> 0.7.1'
+  end
+
+  platforms :rbx do
+    gem 'pelusa', '~> 0.2.2'
+  end
+end
+
+group :benchmarks do
+  gem 'rbench', '~> 0.2.3'
+end
+
+platform :jruby do
+  group :jruby do
+    gem 'jruby-openssl', '~> 0.8.2'
+  end
+end

data/Guardfile

@@ -0,0 +1,18 @@
+# encoding: utf-8
+
+guard :bundler do
+  watch('Gemfile')
+end
+
+guard :rspec, :all_on_start => false, :all_after_pass => false do
+  # run all specs if the spec_helper or supporting files files are modified
+  watch('spec/spec_helper.rb')                      { 'spec/unit' }
+  watch(%r{\Aspec/(?:lib|support|shared)/.+\.rb\z}) { 'spec/unit' }
+
+  # run unit specs if associated lib code is modified
+  watch(%r{\Alib/(.+)\.rb\z})                                         { |m| Dir["spec/unit/#{m[1]}"] }
+  watch("lib/#{File.basename(File.expand_path('../', __FILE__))}.rb") { 'spec/unit'                       }
+
+  # run a spec if it is modified
+  watch(%r{\Aspec/(?:unit|integration)/.+_spec\.rb\z})
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Markus Schirp
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,86 @@
+AQL
+===
+
+[![Build Status](https://secure.travis-ci.org/mbj/aql.png?branch=master)](http://travis-ci.org/mbj/aql)
+[![Dependency Status](https://gemnasium.com/mbj/aql.png)](https://gemnasium.com/mbj/aql)
+[![Code Climate](https://codeclimate.com/github/mbj/aql.png)](https://codeclimate.com/github/mbj/aql)
+
+Generator for the ArangoDB Query Language [AQL](http://www.arangodb.org/manuals/current/Aql.html) in Ruby. It is used as a backend for [axiom-arango-adapter](https://github.com/mbj/axiom-arango-adapter).
+
+Using AQL
+---------
+
+There is currently no stable public API.
+
+Installation
+------------
+
+There is currently no gem release. Use git source in your Gemfile:
+
+```ruby
+gem 'aql', :git => 'https://github.com/mbj/aql'
+```
+
+Or use ```:github => 'mbj/aql'``` if you prefer unencrypted protocols.
+
+Examples
+--------
+
+This gem does not have a public API. Please do not use it as a way to generate AQL statements by hand - this gem is not intended for this purpose. Instead write a library that uses this gem to generate AQL. Just to make it easier for you to get into the code, here is an example on how to generate a simple AQL statement:
+
+```ruby
+require 'aql'
+
+include AQL
+
+person    = Node::Name.new('person')
+firstname = Node::Name.new('firstname')
+lastname  = Node::Name.new('lastname')
+
+person_firstname = Node::Attribute.new(person, firstname)
+
+node = Node::Operation::For.new(
+  person, 
+  Node::Name.new('people'),
+  Node::Block.new(
+    [
+      Node::Operation::Unary::Filter.new(
+        Node::Operator::Binary::Equality.new(person_firstname, Node::Literal::Primitive::String.new('Markus'))
+      ),
+      Node::Operation::Unary::Return.new(
+        Node::Literal::Primitive::Composed::Document.new([
+          Node::Literal::Composed::Document::Attribute.new(
+            person_firstname,
+            Node::Attribute.new(person, Node::Name.new('lastname'))
+          )
+        ])
+      )
+    ]
+  )
+)
+
+puts node.aql
+#=> "FOR `person` IN `people` FILTER (`person`.`firstname` == "Markus") RETURN {`person`.`firstname`: `person`.`lastname`}"
+```
+
+Credits
+-------
+
+* [Markus Schirp (mbj)](https://github.com/mbj) Author
+* [triAGENS](https://github.com/triAGENS) For sponsoring this work!
+
+Contributing
+-------------
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with Rakefile or version
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+License
+-------
+
+This gem is published under the MIT license. See LICENSE file.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'devtools'
+Devtools.init_rake_tasks

data/TODO

@@ -0,0 +1 @@
+* Limit numeric emitter to values that fit into IEEE 754 64bit

data/aql.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name     = 'aql'
+  s.version  = '0.0.1'
+
+  s.authors  = ['Markus Schirp']
+  s.email    = 'mbj@seonic.net'
+  s.summary  = 'The ArangoDB AQL AST. Intended for query generation.'
+  s.homepage = 'http://github.com/mbj/aql'
+  s.license  = 'MIT'
+
+  s.files            = `git ls-files`.split("\n")
+  s.test_files       = `git ls-files -- {spec,features}/*`.split("\n")
+  s.require_paths    = %w(lib)
+  s.extra_rdoc_files = %w(README.md)
+
+  s.add_dependency('backports',     [ '~> 3.0', '>= 3.0.3' ])
+  s.add_dependency('adamantium',    '~> 0.0.7')
+  s.add_dependency('equalizer',     '~> 0.0.5')
+  s.add_dependency('abstract_type', '~> 0.0.5')
+  s.add_dependency('concord',       '~> 0.0.3')
+end

data/config/flay.yml

@@ -0,0 +1,3 @@
+---
+threshold: 11
+total_score: 103

data/config/flog.yml

@@ -0,0 +1,2 @@
+---
+threshold: 9.8

data/config/mutant.yml

@@ -0,0 +1,3 @@
+---
+name: aql
+namespace: AQL

data/config/roodi.yml

@@ -0,0 +1,18 @@
+---
+AbcMetricMethodCheck:            { score: 11.0 }
+AssignmentInConditionalCheck:    { }
+CaseMissingElseCheck:            { }
+ClassLineCountCheck:             { line_count: 293 }
+ClassNameCheck:                  { pattern: !ruby/regexp '/\A(?:[A-Z]+|Or|In|[A-Z][a-z](?:[A-Z]?[a-z])+)\z/' }
+ClassVariableCheck:              { }
+CyclomaticComplexityBlockCheck:  { complexity: 2 }
+CyclomaticComplexityMethodCheck: { complexity: 4 }
+EmptyRescueBodyCheck:            { }
+ForLoopCheck:                    { }
+# TODO: decrease line_count to 5 to 10
+MethodLineCountCheck:            { line_count: 14 }
+MethodNameCheck:                 { pattern: !ruby/regexp '/\A(?:[a-z\d](?:_?[a-z\d])+[?!=]?|\[\]=?|==|<=>|[+*&|-])\z/' }
+ModuleLineCountCheck:            { line_count: 295 }
+ModuleNameCheck:                 { pattern: !ruby/regexp '/\A(?:[A-Z]+|[A-Z][a-z](?:[A-Z]?[a-z])+)\z/' }
+# TODO: decrease parameter_count to 2 or less
+ParameterNumberCheck:            { parameter_count: 3 }

data/config/site.reek

@@ -0,0 +1,100 @@
+---
+UnusedParameters:
+  exclude: 
+  - AQL::Node#emit
+UncommunicativeParameterName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+LargeClass:
+  max_methods: 10
+  exclude: []
+  enabled: true
+  max_instance_variables: 2
+UncommunicativeMethodName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^[a-z]$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+LongParameterList:
+  max_params: 2
+  exclude: 
+  - AQL::Buffer#wrap_delimited # 3 params
+  - AQL::Buffer#binary         # 3 params
+  enabled: true
+  overrides: {}
+FeatureEnvy:
+  exclude: 
+  - AQL::Node::Block#emit         # Definitive a false positive
+  - AQL::Node::Call#for_argument? # Definitive a false positive
+  enabled: true
+ClassVariable:
+  exclude: []
+  enabled: true
+BooleanParameter:
+  exclude: []
+  enabled: true
+IrresponsibleModule:
+  exclude: []
+  enabled: true
+UncommunicativeModuleName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+NestedIterators:
+  ignore_iterators: []
+  exclude: []
+  enabled: true
+  max_allowed_nesting: 1
+LongMethod:
+  max_statements: 5
+  exclude: 
+  - AQL::Buffer#binary # 6 statements
+  - AQL::Node::Operation::For#emit # 6 statements
+  enabled: true
+Duplication:
+  allow_calls: []
+  exclude: []
+  enabled: true
+  max_calls: 1
+UtilityFunction:
+  max_helper_calls: 1
+  exclude: []
+  enabled: true
+Attribute:
+  exclude: []
+  enabled: false
+UncommunicativeVariableName:
+  accept: []
+  exclude: []
+  enabled: true
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+SimulatedPolymorphism:
+  exclude: []
+  enabled: true
+  max_ifs: 1
+DataClump:
+  exclude: []
+  enabled: true
+  max_copies: 1
+  min_clump_size: 3
+ControlCouple:
+  exclude: []
+  enabled: true
+LongYieldList:
+  max_params: 1
+  exclude: []
+  enabled: true

data/config/yardstick.yml

@@ -0,0 +1,2 @@
+---
+threshold: 100

data/examples/aql.rb

@@ -0,0 +1,31 @@
+require 'aql'
+
+include AQL
+
+person    = Node::Name.new('person')
+firstname = Node::Name.new('firstname')
+lastname  = Node::Name.new('lastname')
+
+person_firstname = Node::Attribute.new(person, firstname)
+
+node = Node::Operation::For.new(
+  person, 
+  Node::Name.new('people'),
+  Node::Block.new(
+    [
+      Node::Operation::Unary::Filter.new(
+        Node::Operator::Binary::Equality.new(person_firstname, Node::Literal::Primitive::String.new('Markus'))
+      ),
+      Node::Operation::Unary::Return.new(
+        Node::Literal::Primitive::Composed::Document.new([
+          Node::Literal::Composed::Document::Attribute.new(
+            person_firstname,
+            Node::Attribute.new(person, Node::Name.new('lastname'))
+          )
+        ])
+      )
+    ]
+  )
+)
+
+puts node.aql

data/lib/aql.rb

@@ -0,0 +1,62 @@
+require 'backports'
+require 'abstract_type'
+require 'adamantium'
+require 'concord'
+
+# Library namespace
+module AQL
+
+  # Return AQL node for literal
+  #
+  # @param [Object] value
+  #
+  # @return [AQL::Node::Literal]
+  #
+  # @api private
+  #
+  def self.literal_node(value)
+    AQL::Node::Literal.build(value)
+  end
+
+  # Return AQL name node
+  #
+  # @param [#to_s] name
+  #
+  # @return [AQL::Node::Name]
+  #
+  # @api private
+  #
+  def self.name_node(name)
+    AQL::Node::Name.new(name.to_s)
+  end
+
+end
+
+require 'aql/buffer'
+require 'aql/node'
+require 'aql/constants'
+require 'aql/node/name'
+require 'aql/node/call'
+require 'aql/node/null'
+require 'aql/node/block'
+require 'aql/node/attribute'
+require 'aql/node/literal'
+require 'aql/node/literal/singleton'
+require 'aql/node/literal/primitive'
+require 'aql/node/literal/primitive/string'
+require 'aql/node/literal/primitive/number'
+require 'aql/node/literal/composed'
+require 'aql/node/literal/composed/document'
+require 'aql/node/literal/composed/list'
+require 'aql/node/operator'
+require 'aql/node/operator/assignment'
+require 'aql/node/operator/binary'
+require 'aql/node/operator/unary'
+require 'aql/node/operator/ternary'
+require 'aql/node/operator/nary'
+require 'aql/node/operation'
+require 'aql/node/operation/unary'
+require 'aql/node/operation/nary'
+require 'aql/node/operation/binary'
+require 'aql/node/operation/limit'
+require 'aql/node/operation/for'