pacer 2.0.14-java → 2.0.15-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 516ac17e78965aa3d2e83cd8abcdd698a6a65df2
-  data.tar.gz: 42d4eec909e091059251f379296f5b4c118f008f
+  metadata.gz: 32dc8612daf75176bf7044acf5326aaadcdbc7bf
+  data.tar.gz: ff810146984c86e20d9d735ce6a06b659df5a144
 SHA512:
-  metadata.gz: 1e2ed8eb71d0e19d61adc9e324b6405c75b0aa710944f4e4fa41e542075673584ec63f618149c93f973325a8bc5b04ff8751b4e19de3fe457a65e61e745e5e1d
-  data.tar.gz: 6c6ecde3e79970241e660108de1bb4bdb8055df7f94a84a152902273ed4f36521e7dd861e98510875b5de4cc95088e691a49f12b04a84f257e3316ecb28d6266
+  metadata.gz: 5fd3033c91b8d587c23153b4c8b04c0da953d286da0273b938c6f3101b9a341bf781efd18bf96ed852ced15de9ba48e466541ffac71ab008be9b10452ff84535
+  data.tar.gz: 6a02115444a5803a9f2e9032aefaa1a7de891bdc0ab879392df2bbf569394497ff4b9f800fe8ffd4caa920964bca25d9baaef6f27438e3a2ba226209092db3b9

data/README.md

@@ -16,13 +16,11 @@ all processing is done in pure Java, so when it comes the usual Ruby
 expressiveness vs. speed problem, you can have your cake and eat it too,
 it's very fast!
 
-## Mailing List
-
-Pacer has a [google group](http://groups.google.com/group/pacer-users?lnk=gcimv)! Join and feel free to ask questions and discuss about Pacer or graphs in general.
-
 ## Documentation
 
-Check out the [wiki](https://github.com/pangloss/pacer/wiki) for detailed explanations of many of Pacer's features. Please contribute to it or open issues against it if there is anything missing that you want to see.
+Check out the [Pacer docs](http://xnlogic.github.io/pacer/) for detailed explanations of many of Pacer's features. 
+
+Feel free to contribute to it, by submitting a pull-request to the `gh-pages` branch of this repo, or by opening issues.
 
 Pacer is also documented with a comprehensive RSpec test suite and with a
 thorough YARD documentation. [Dig in!](http://www.rubydoc.info/github/pangloss/pacer/master)
@@ -34,85 +32,26 @@ If you like, you can also use the documentation locally via
   yard server
 ```
 
-## JRuby 1.7 Required
-
-As of Pacer 1.0.0, [JRuby](http://jruby.org/) 1.7 is required because it is both faster and
-fixes some problems that I previously had to work around in Pacer.
-
-The easiest way (ie. the way I do it) to get the most recent version of
-JRuby is to use [RVM](https://rvm.io/)
-
 ## Installation
 
-The easiest way to get Pacer is `gem install pacer`.
-
-If you want to hack on Pacer, you'll need to have
-[maven](http://maven.apache.org/) installed (I recommend `brew install
-maven`), then use `rake jar` to set up maven's pom.xml file and run the
-maven build script. Then `rake gemfile_devel` to set up a default
-Gemfile that you can customize as needed to include dependencies
-to the various pacer-... graphs you want the test suite to run against.
-
-## Graph Database Support
-
-The Tinkerpop suite supports a number of graph data stores. They are all
-compatible with Pacer, but I have not yet implemented the simple
-adapters Pacer needs to use them yet. Here is the list of what's
-supported so far:
-
-| Graph                                          | Info                                     | Gem Required              | Gem address                                                     |
-|------------------------------------------------|------------------------------------------|---------------------------|-----------------------------------------------------------------|
-| TinkerGraph                                    | In-memory graph db. Included with Pacer. |                           |                                                                 |
-| [OrientDB](http://orientdb.com)                | A powerful and feature rich graph / document hybrid database.           | `gem install --pre pacer-orient` | [pangloss/pacer-orient](https://github.com/pangloss/pacer-orient) |
-| [Neo4J](http://neo4j.org)                      | The industry-leading graph db.           | `gem install pacer-neo4j` | [pangloss/pacer-neo4j](https://github.com/pangloss/pacer-neo4j) |
-| [Dex](http://sparsity-technologies.com)        | A very fast, relatively new graph db.    | `gem install pacer-dex`   | [pangloss/pacer-dex](https://github.com/pangloss/pacer-dex)     |
-| [Titan](http://thinkaurelius.github.io/titan/) | Built on top of a pluggable nosql backend store | `gem install pacer-titan` | [pacer-titan](https://github.com/mrbotch/pacer-titan)           |
-
-
+Install dependencies:
 
-You can run any or all of the above graph databases. Pacer supports
-running them simultaneuosly and even supports having many of any given
-type open at once.
+ * [JRuby 1.7.x](http://jruby.org/)     
+   __Recommended:__ Use [RVM](https://rvm.io/) to install and manage all Ruby (and JRuby) versions on your machine.
+ * [RubyGems](https://rubygems.org/)
 
-### Using Pacer with Neo4j
+Install Pacer:
 
-All you need is the [pacer-neo4j](https://github.com/pangloss/pacer-neo4j) gem.
-
-```ruby
-    require 'pacer-neo4j'
-    graph = Pacer.neo4j("path/to/graph")
 ```
-
-See the gem repository for more details on Neo4j-specific features and functionality.
-
-#### (optional) Interoperation with the neo4j gem
-
-Pacer can work together with other Ruby GraphDB libraries, too. The
-first functioning example is with theo neo4j gem. Hopefully more will
-follow soon as I find out about them or get requests to support them.
-
-To use Pacer together with the neo4j gem, get your Pacer graph instance
-as follows:
-
-```ruby
-    require 'neo4j'
-    require 'pacer-neo4j'
-    # start neo4j via the external gem rather than using pacer-neo4j
-    Neo4j.db.start
-    graph = Pacer.neo4j(Neo4j.db.graph)
+gem install pacer
 ```
 
-After that, you can continue to use the graph as normal with *both*
-gems. Any update that's committed with one gem will be visible
-immediately to the other because they are now both pointing to the same
-Java graphdb instance.
+## Graph Database Support
+
+Pacer can work with any Blueprints-enabled graph, such as Neo4j, OrientDB, TinkerGraph and more.
 
-### A note on safely exiting
+[See the docs](http://pangloss.github.io/pacer/suppoted_graph_databases/) for more details.
 
-Some databases need to be shutdown cleanly when the program exits. You
-can shut a database down anytime by calling `graph.shutdown`, but you
-don't need to worry about it much. Pacer uses Ruby's `at_exit` hook to
-automatically shut down all open databases!
 
 ## Example traversals
 
@@ -135,66 +74,7 @@ or to take it one step further:
     person.recommended_friends
 ```
 
-## Create and populate a graph
-
-To get started, you need to know just a few methods. First, open up a graph (if one doesn't exist it will be automatically created) and add some vertices to it:
-
-```ruby
-    dex = Pacer.dex '/tmp/dex_demo'
-    dex.transaction do
-      pangloss = dex.create_vertex :name => 'pangloss', :type => 'user'
-      okram = dex.create_vertex :name => 'okram', :type => 'user'
-      group = dex.create_vertex :name => 'Tinkerpop', :type => 'group'
-    end
-```
-
-Now, let's see what we've got:
-
-```ruby
-    dex.v
-```
-
-produces:
-
-```ruby
-    #<V[1024]> #<V[1025]> #<V[1026]>
-    Total: 3
-    => #<GraphV>
-```
-
-There are our vertices. Let's look their properties:
-
-```ruby
-    dex.v.properties
-
-    {"name"=>"pangloss", "type"=>"user"} {"name"=>"okram", "type"=>"user"}
-    {"name"=>"Tinkerpop", "type"=>"group"}
-    Total: 3
-    => #<GraphV -> Obj-Map>
-```
-
-Now let's put an edge between them:
-
-```ruby
-    dex.transaction do
-      dex.create_edge okram, pangloss, :inspired
-    end
-    => #<E[2048]:1025-inspired-1024>
-```
-
-That's great for creating an edge but what if I've got lots to create? Try this method instead which can add edges to the cross product of all vertices in one route with all vertices in the other:
-
-```ruby
-    dex.transaction do
-      group.add_edges_to :member, dex.v(:type => 'user')
-    end
-
-    #<E[4097]:1026-member-1024> #<E[4098]:1026-member-1025>
-    Total: 2
-    => #<Obj 2 ids -> lookup>
-```
-
-There is plenty more to see as well! Please dig into the code and the spec suite to find loads of examples and edge cases. And if you think of a case that I've missed, I'll greatly appreciate your contributions!
+You can use the [Quick Start guide](http://pangloss.github.io/pacer/quick_start/) to get a feel for how Pacer queries (aka traversals) work.
 
 ## Design Philosophy
 

data/lib/pacer/filter/range_filter.rb

@@ -53,6 +53,7 @@ module Pacer
         end
         self
       end
+      alias drop offset
 
       def offset=(n)
         offset n

data/lib/pacer/graph/graph_transactions_mixin.rb

@@ -65,6 +65,7 @@ module Pacer
       read_tx_depth = tgi[:read_tx_depth] ||= 0
       tgi[:read_tx_depth] += 1
       # Blueprints auto-starts the transaction
+      reopen_read_transaction
       yield
     ensure
       rtd = tgi[:read_tx_depth] -= 1

data/lib/pacer/version.rb

@@ -1,5 +1,5 @@
 module Pacer
-  VERSION = "2.0.14"
+  VERSION = "2.0.15"
   # Clients may optionally define the following constants in the Pacer namespace:
   # - LOAD_JARS : set to false to manage jar loading in the client. Be sure to load the jars defined in JARFILES.
   # - LOCKJAR_LOCK_OPTS : set some options to be passed to LockJar.lock (ie. :lockfile, :download_artifacts, :local_repo)

data/lib/pacer/wrappers/element_wrapper.rb

@@ -37,30 +37,37 @@ module Pacer::Wrappers
 
       def route_conditions(graph)
         return @route_conditions if defined? @route_conditions
-        @route_conditions = extensions.inject({}) do |h, ext|
-          if ext.respond_to? :route_conditions
-            h.merge! ext.route_conditions(graph)
-          else
-            h
-          end
-        end
-        @route_conditions
+        @route_conditions = extensions.inject({}, &reduce_extensions(graph, :route_conditions))
       end
 
       def lookup(graph)
         return @lookup if defined? @lookup
-        @lookup = extensions.inject({}) do |h, ext|
-          if ext.respond_to? :lookup
-            h.merge! ext.lookup(graph)
+        @lookup = extensions.inject({}, &reduce_extensions(graph, :lookup))
+      end
+
+      protected
+
+      def reduce_extensions(graph, method)
+        proc do |h, ext|
+          if ext.respond_to? method
+            conds = ext.send(method, graph)
+            if conds.is_a? Hash
+              h.merge! conds
+            elsif conds.is_a? Array
+              if h.is_a? Array
+                conds + h
+              else
+                conds + [h]
+              end
+            else
+              h
+            end
           else
             h
           end
         end
-        @lookup
       end
 
-      protected
-
       def build_extension_wrapper(exts, mod_names, superclass)
         sc_name = superclass.to_s.split(/::/).last
         exts = exts.uniq unless exts.is_a? Set

data/pacer.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |s|
   s.files = `git ls-files`.split("\n") + ['lib/pacer-ext.jar']
   s.test_files = `git ls-files -- spec/*`.split("\n")
   s.require_paths = ['lib']
-  s.add_dependency "lock_jar", "~> 0.10.2"
+  s.add_dependency "lock_jar", "~> 0.12.0"
   s.add_development_dependency 'xn_gem_release_tasks'
   s.add_development_dependency "rake-compiler",  "~> 0.9.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pacer
 version: !ruby/object:Gem::Version
-  version: 2.0.14
+  version: 2.0.15
 platform: java
 authors:
 - Darrick Wiebe
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-04-04 00:00:00.000000000 Z
+date: 2015-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lock_jar
@@ -16,12 +16,12 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.10.2
+        version: 0.12.0
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.10.2
+        version: 0.12.0
   prerelease: false
   type: :runtime
 - !ruby/object:Gem::Dependency