diametric 0.0.1

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.jbundler
+.rspec
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+bin/
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+vendor/
+doc

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in diametric.gemspec
+gemspec
+
+# Development-only dependencies
+gem 'rake'
+gem 'pry'
+gem 'rspec'
+
+platform :mri do
+  gem 'yard'
+  gem 'redcarpet'
+end

data/Guardfile

@@ -0,0 +1,8 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/Jarfile

@@ -0,0 +1,6 @@
+repository 'http://clojars.org/repo/'
+repository 'https://repository.jboss.org/nexus/content/groups/public/'
+
+group :default, :runtime do
+  jar "com.datomic:datomic-free:0.8.3563"
+end

data/Jarfile.lock

@@ -0,0 +1,126 @@
+---
+version: 0.7.2
+groups:
+  default:
+    dependencies:
+    - com.amazonaws:aws-java-sdk:jar:1.3.0
+    - com.datomic:datomic-free:jar:0.8.3563
+    - com.google.code.findbugs:jsr305:jar:1.3.9
+    - com.google.guava:guava:jar:12.0.1
+    - com.h2database:h2:jar:1.3.165
+    - com.jamesmurty.utils:java-xmlbuilder:jar:0.4
+    - commons-codec:commons-codec:jar:1.3
+    - commons-httpclient:commons-httpclient:jar:3.1
+    - net.java.dev.jets3t:jets3t:jar:0.8.1
+    - org.apache.httpcomponents:httpclient:jar:4.2-alpha1
+    - org.apache.httpcomponents:httpcore:jar:4.2-alpha2
+    - org.apache.lucene:lucene-core:jar:3.3.0
+    - org.apache.tomcat:tomcat-jdbc:jar:7.0.27
+    - org.apache.tomcat:tomcat-juli:jar:7.0.27
+    - org.clojure:clojure:jar:1.4.0
+    - org.clojure:data.json:jar:0.1.2
+    - org.codehaus.jackson:jackson-core-asl:jar:1.8.0
+    - org.codehaus.janino:commons-compiler-jdk:jar:2.6.1
+    - org.codehaus.janino:commons-compiler:jar:2.6.1
+    - org.hornetq:hornetq-core:jar:2.2.2.Final
+    - org.jboss.netty:netty:jar:3.2.4.Final
+    - org.slf4j:jcl-over-slf4j:jar:1.6.4
+    - org.slf4j:jul-to-slf4j:jar:1.6.4
+    - org.slf4j:log4j-over-slf4j:jar:1.6.4
+    - org.slf4j:slf4j-api:jar:1.6.4
+    - org.slf4j:slf4j-nop:jar:1.6.4
+    - postgresql:postgresql:jar:9.1-901.jdbc4
+    - spy:spymemcached:jar:2.8.1
+    artifacts:
+    - jar:com.datomic:datomic-free:jar:0.8.3563:
+        transitive:
+          com.h2database:h2:jar:1.3.165: {}
+          org.apache.lucene:lucene-core:jar:3.3.0: {}
+          postgresql:postgresql:jar:9.1-901.jdbc4: {}
+          spy:spymemcached:jar:2.8.1: {}
+          org.clojure:clojure:jar:1.4.0: {}
+          org.slf4j:jul-to-slf4j:jar:1.6.4:
+            org.slf4j:slf4j-api:jar:1.6.4: {}
+          com.google.guava:guava:jar:12.0.1:
+            com.google.code.findbugs:jsr305:jar:1.3.9: {}
+          org.clojure:data.json:jar:0.1.2: {}
+          org.slf4j:slf4j-nop:jar:1.6.4: {}
+          org.jboss.netty:netty:jar:3.2.4.Final: {}
+          org.codehaus.janino:commons-compiler-jdk:jar:2.6.1:
+            org.codehaus.janino:commons-compiler:jar:2.6.1: {}
+          org.apache.tomcat:tomcat-jdbc:jar:7.0.27:
+            org.apache.tomcat:tomcat-juli:jar:7.0.27: {}
+          org.hornetq:hornetq-core:jar:2.2.2.Final: {}
+          org.slf4j:jcl-over-slf4j:jar:1.6.4: {}
+          org.codehaus.jackson:jackson-core-asl:jar:1.8.0: {}
+          net.java.dev.jets3t:jets3t:jar:0.8.1:
+            com.jamesmurty.utils:java-xmlbuilder:jar:0.4: {}
+            commons-httpclient:commons-httpclient:jar:3.1: {}
+            commons-codec:commons-codec:jar:1.3: {}
+          org.slf4j:log4j-over-slf4j:jar:1.6.4: {}
+          com.amazonaws:aws-java-sdk:jar:1.3.0: {}
+          org.apache.httpcomponents:httpclient:jar:4.2-alpha1:
+            org.apache.httpcomponents:httpcore:jar:4.2-alpha2: {}
+  runtime:
+    dependencies:
+    - com.amazonaws:aws-java-sdk:jar:1.3.0
+    - com.datomic:datomic-free:jar:0.8.3563
+    - com.google.code.findbugs:jsr305:jar:1.3.9
+    - com.google.guava:guava:jar:12.0.1
+    - com.h2database:h2:jar:1.3.165
+    - com.jamesmurty.utils:java-xmlbuilder:jar:0.4
+    - commons-codec:commons-codec:jar:1.3
+    - commons-httpclient:commons-httpclient:jar:3.1
+    - net.java.dev.jets3t:jets3t:jar:0.8.1
+    - org.apache.httpcomponents:httpclient:jar:4.2-alpha1
+    - org.apache.httpcomponents:httpcore:jar:4.2-alpha2
+    - org.apache.lucene:lucene-core:jar:3.3.0
+    - org.apache.tomcat:tomcat-jdbc:jar:7.0.27
+    - org.apache.tomcat:tomcat-juli:jar:7.0.27
+    - org.clojure:clojure:jar:1.4.0
+    - org.clojure:data.json:jar:0.1.2
+    - org.codehaus.jackson:jackson-core-asl:jar:1.8.0
+    - org.codehaus.janino:commons-compiler-jdk:jar:2.6.1
+    - org.codehaus.janino:commons-compiler:jar:2.6.1
+    - org.hornetq:hornetq-core:jar:2.2.2.Final
+    - org.jboss.netty:netty:jar:3.2.4.Final
+    - org.slf4j:jcl-over-slf4j:jar:1.6.4
+    - org.slf4j:jul-to-slf4j:jar:1.6.4
+    - org.slf4j:log4j-over-slf4j:jar:1.6.4
+    - org.slf4j:slf4j-api:jar:1.6.4
+    - org.slf4j:slf4j-nop:jar:1.6.4
+    - postgresql:postgresql:jar:9.1-901.jdbc4
+    - spy:spymemcached:jar:2.8.1
+    artifacts:
+    - jar:com.datomic:datomic-free:jar:0.8.3563:
+        transitive:
+          com.h2database:h2:jar:1.3.165: {}
+          org.apache.lucene:lucene-core:jar:3.3.0: {}
+          postgresql:postgresql:jar:9.1-901.jdbc4: {}
+          spy:spymemcached:jar:2.8.1: {}
+          org.clojure:clojure:jar:1.4.0: {}
+          org.slf4j:jul-to-slf4j:jar:1.6.4:
+            org.slf4j:slf4j-api:jar:1.6.4: {}
+          com.google.guava:guava:jar:12.0.1:
+            com.google.code.findbugs:jsr305:jar:1.3.9: {}
+          org.clojure:data.json:jar:0.1.2: {}
+          org.slf4j:slf4j-nop:jar:1.6.4: {}
+          org.jboss.netty:netty:jar:3.2.4.Final: {}
+          org.codehaus.janino:commons-compiler-jdk:jar:2.6.1:
+            org.codehaus.janino:commons-compiler:jar:2.6.1: {}
+          org.apache.tomcat:tomcat-jdbc:jar:7.0.27:
+            org.apache.tomcat:tomcat-juli:jar:7.0.27: {}
+          org.hornetq:hornetq-core:jar:2.2.2.Final: {}
+          org.slf4j:jcl-over-slf4j:jar:1.6.4: {}
+          org.codehaus.jackson:jackson-core-asl:jar:1.8.0: {}
+          net.java.dev.jets3t:jets3t:jar:0.8.1:
+            com.jamesmurty.utils:java-xmlbuilder:jar:0.4: {}
+            commons-httpclient:commons-httpclient:jar:3.1: {}
+            commons-codec:commons-codec:jar:1.3: {}
+          org.slf4j:log4j-over-slf4j:jar:1.6.4: {}
+          com.amazonaws:aws-java-sdk:jar:1.3.0: {}
+          org.apache.httpcomponents:httpclient:jar:4.2-alpha1:
+            org.apache.httpcomponents:httpcore:jar:4.2-alpha2: {}
+remote_repositories:
+- http://clojars.org/repo/
+- https://repository.jboss.org/nexus/content/groups/public/

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Clinton N. Dreisbach
+
+MIT License
+
+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,215 @@
+# Diametric
+
+Diametric is a library for building schemas, queries, and transactions
+for [Datomic][] from Ruby objects. It is also used to map Ruby objects
+as entities into a Datomic database.
+
+## Entity API
+
+The `Entity` module is interesting, in that it is primarily made of
+pure functions that take their receiver (an instance of the class they
+are included in) and return data that you can use in Datomic. This
+makes it not an ORM-like thing at all, but instead a Ruby-ish data
+builder for Datomic. And yet, a `Diametric::Entity` is fully
+`ActiveModel` compliant! You can use them anywhere you would use an
+`ActiveRecord` model or another `ActiveModel`-compliant instance.
+
+They do not include all `ActiveModel` modules by default, only the
+ones needed to establish compliance. You may want to include others
+yourself, such as `Validations` or `Callbacks`.
+
+```ruby
+require 'diametric'
+
+class Person
+  include Diametric::Entity
+
+  attribute :name, String, :index => true
+  attribute :email, String, :cardinality => :many
+  attribute :birthday, DateTime
+  attribute :iq, Integer
+  attribute :website, URI
+end
+
+Person.schema
+# Datomic transaction:
+# [{:db/id #db/id[:db.part/db]
+#   :db/ident :person/name
+#   :db/valueType :db.type/string
+#   :db/cardinality :db.cardinality/one
+#   :db/index true
+#   :db.install/_attribute :db.part/db}
+#  {:db/id #db/id[:db.part/db]
+#   :db/ident :person/email
+#   :db/valueType :db.type/string
+#   :db/cardinality :db.cardinality/many
+#   :db.install/_attribute :db.part/db}
+#  {:db/id #db/id[:db.part/db]
+#   :db/ident :person/birthday
+#   :db/valueType :db.type/instant
+#   :db/cardinality :db.cardinality/one
+#   :db.install/_attribute :db.part/db}
+#  {:db/id #db/id[:db.part/db]
+#   :db/ident :person/iq
+#   :db/valueType :db.type/long
+#   :db/cardinality :db.cardinality/one
+#   :db.install/_attribute :db.part/db}
+#  {:db/id #db/id[:db.part/db]
+#   :db/ident :person/website
+#   :db/valueType :db.type/uri
+#   :db/cardinality :db.cardinality/one
+#   :db.install/_attribute :db.part/db}]
+
+Person.attributes
+# [:dbid, :name, :email, :birthday, :iq, :website]
+
+person = Person.new(Hash[*(Person.attributes.zip(results_from_query).flatten)])
+# or
+person = Person.from_query(results_from_query)
+
+person.iq = 180
+person.tx_data(:iq)
+# Datomic transaction:
+# [{:db/id person.dbid
+#   :person/iq 180}]
+
+person = Person.new(:name => "Peanut")
+person.tx_data
+# Datomic transaction:
+# [{:db/id #db/id[:db.part/user]
+#   :person/name "Peanut"}]
+```
+
+## Query API
+
+The query API is used for generating Datomic queries, whether to send via an external client or via the persistence API. The two methods used to generate a query are `.where` and `.filter`, both of which are chainable. 
+
+To get query data and args for a query, call `.data` on a `Query`.
+
+If you are using a persistence API, you can ask `Query` to get the results of a Datomic query. `Diametric::Query` is an `Enumerable`. To get the results of a query, use `Enumerable` methods such as `.each` or `.first`. `Query` also provides a `.all` method to run the query and get the results.
+
+```ruby
+query = Datomic::Query.new(Person).where(:name => "Clinton Dreisbach")
+query.data
+# Datomic query:
+# [:find ?e ?name ?email ?birthday ?iq ?website
+#  :from $ ?name
+#  :where [?e :person/name ?name]
+#         [?e :person/email ?email]
+#         [?e :person/birthday ?birthday]
+#         [?e :person/iq ?iq]
+#         [?e :person/website ?website]]
+# Args:
+#   ["Clinton Dreisbach"]
+#
+# Returns as an array, [query, args].
+
+query = Datomic::Query.new(Person).where(:name => "Clinton Dreisbach").filter(:>, :iq, 150)
+query.data
+# Datomic query:
+# [:find ?e ?name ?email ?birthday ?iq ?website
+#  :from $ ?name
+#  :where [?e :person/name ?name]
+#         [?e :person/email ?email]
+#         [?e :person/birthday ?birthday]
+#         [?e :person/iq ?iq]
+#         [?e :person/website ?website]
+#         [> ?iq 150]
+# Args:
+#   ["Clinton Dreisbach"]
+#
+# Returns as an array, [query, args].
+```
+
+## Persistence API
+
+The persistence API comes in two flavors: REST- and peer-based. For the most part, they have the same API.
+
+### Peer
+
+With `Diametric::Persistence::Peer`, you can create objects that know how to store themselves to Datomic through a Datomic peer.
+
+To use `Diametric::Persistence::Peer`, you will need to use JRuby and require `diametric/persistence/peer`. When you install the `diametric` gem with JRuby, all `.jar` files needed to run Datomic will be downloaded. 
+
+```ruby
+require 'diametric'
+require 'diametric/persistence/peer'
+
+# database URI
+# will create database if it does not already exist
+Diametric::Persistence::Peer.connect('datomic:mem://animals')
+```
+
+### REST
+
+With `Diametric::Persistence::REST`, you can create objects that know how to store themselves to Datomic through the Datomic REST API. This is your only option unless you are using JRuby.
+
+```ruby
+require 'diametric'
+require 'diametric/persistence/rest'
+
+# database url, database alias, database name
+# will create database if it does not already exist
+Diametric::Persistence::REST.connect('http://localhost:9000', 'test', 'animals')
+```
+
+### Using persisted models
+
+```ruby
+class Goat
+  include Diametric::Entity
+  include Diametric::Persistence::REST # if using REST API
+  include Diametric::Persistence::Peer # if using JRuby and not using REST
+  
+  attribute :name, String, :index => true
+  attribute :age, Integer
+end
+
+goat = Goat.new(:name => 'Beans', :age => 2)
+goat.dbid # => nil
+goat.name # => "Beans"
+goat.persisted? # => false
+goat.new? # => true
+
+goat.save
+goat.dbid # => new id autogenerated
+goat.name # => "Beans"
+goat.persisted? # => true
+goat.new? # => false
+
+goats = Goat.where(:name => "Beans")
+#=> [Goat(id: 1, age: 2, name: "Beans")]
+
+goat = Goat.first(:name => "Beans")
+#=> Goat(id: 1, age: 2, name: "Beans")
+
+goats = Goat.filter(:<, :age, 3)
+#=> [Goat(id: 1, age: 2, name: "Beans")]
+
+goats = Goat.filter(:>, :age, 3)
+#=> []
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'diametric'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install diametric
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+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
+
+[Datomic]: http://www.datomic.com

data/Rakefile

@@ -0,0 +1,17 @@
+begin
+  require "bundler/gem_tasks"
+rescue LoadError
+end
+
+task :default => :prepare
+
+task :prepare do
+  if defined?(RUBY_ENGINE) && RUBY_ENGINE == 'jruby'
+    require 'lock_jar'
+
+    # get jarfile relative the gem dir
+    lockfile = File.expand_path("../Jarfile.lock", __FILE__)
+
+    LockJar.install(lockfile)
+  end
+end

data/TODO.org

@@ -0,0 +1,12 @@
+* Entity API
+** Add default values to attributes
+** People probably want validations by default: include ActiveModel::Validations
+
+* Persistence API
+** Handle Java exceptions in the Peer persistence library
+** Handle exceptions from the REST client in the REST persistence library
+** Refactor so that Diametric::Persistence is the primary module and the connection determines different behavior
+*** Yoko requests: .connect should take an argument :rest or :peer, #peer? and #rest? methods should be on the connection object
+
+* History API
+** Make it