ohm_util 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cf5dda52c9868dfe4a8448a2d250f25aad6c0dda
+  data.tar.gz: 3ccef59a4db068f983537e167f1da6d77237ec79
+SHA512:
+  metadata.gz: 9e13cd84fd246ad8f0a8373d6bebbef3f8e0768a34d54dc86f23dd9617c5598d7446e9659d6ef841d400196efb3a9b4471ff8d5facc4528d6a98e886bb892d48
+  data.tar.gz: 8bfd55f9246fcc6c746da4c6d711e4d3b77147b5736b44f972ba2848e91f0f6fd97111a33797d27d7ea08c33df0cf56601baa095874f2e54faf1844093c49c76

data/.gems

@@ -0,0 +1,4 @@
+nest -v 3.0.0
+redic -v 1.5.0
+cutest -v 1.2.3
+stal -v 0.3.0

data/.gitignore

@@ -0,0 +1,3 @@
+/.yardoc
+/doc
+/.gs

data/CHANGELOG.md

@@ -0,0 +1,408 @@
+## 3.1.1
+
+- Serialize keys as strings when using JSON.
+
+- Reset attributes when calling `load!`.
+
+## 3.1.0
+
+- Use Nest instead of Nido
+
+  A new release of Nest (3.0.0) simplified the interaction
+  with Redis.
+
+- Use Model#hash for equality
+
+  This change just removes some slight redundancy in the code.
+  The external behavior remains unchanged.
+
+## 3.0.3
+
+- Fix bug that gave false positives for unique indices.
+
+  Uniques were indexed for nil values as empty strings. This
+  release fixes that issue.
+
+## 3.0.2
+
+- Fix bug created the wrong keys when indexing floats.
+
+  As reported by @slowernet, if an indexed attribute was assigned a
+  real value with 0 fractional part (eg. 3.0), the `tostring` function
+  in lua truncated the value to an integer. As a result, the index
+  was created with the wrong key (Model:indices:attribute:3, instead
+  of Model:indices:attribute:3.0). The fix is to convert all values
+  to strings before sending them to the Lua script.
+
+## 3.0.1
+
+- Adapt Lua scripts to Redis unstable.
+
+## 3.0.0
+
+- Use JSON instead of msgpack for internal encoding.
+
+  When Ohm started using Lua internally for saving, updating and
+  deleting objects, it used msgpack for serializing. Redis supports
+  both msgpack and JSON, and we picked msgpack because it produces
+  a more compact representation. At some point, the Ruby msgpack
+  library and the internal msgpack support in Redis diverged, and
+  we were forced to lock the dependency to a specific gem version.
+  Recently, some people complained about encoding issues originating
+  from msgpack inside Redis, and once they tried a modified Ohm
+  that uses JSON instead of msgpack, all their issues disappeared.
+  That's why we think it's time for removing msgpack altogether and
+  use JSON instead.
+
+- Move the raise of MissingID to Ohm::Model#key.
+
+  In previous versions, trying to access an instance's `id` would
+  raise a `MissingID` error. The reason why raising that error is
+  convenient is because it allows Ohm to fail as early as possible
+  when you try to use an object that hasn't been saved yet. The
+  error can arise from comparisons, from direct calls to `id`, and
+  also from any call to methods that need `object.key` to return a
+  proper value, as `key` in turn calls the `id` method. But it turns
+  out that many form builders rely on the fact that sending the
+  `id` message to most ORMs results in either a valid ID or `nil`,
+  and here Ohm was the exception. By moving the check from `id` to
+  `key`, we can keep most of the previous behavior and we can return
+  `nil` when sending the `id` message to a new instance, thus making
+  Ohm compatible with most form builders.
+
+- Add `Ohm::Model#increment` and `Ohm::Model#decrement`. These methods
+  are aliases of `incr` and `decr` respectively.
+
+## 2.3.0
+
+- Retry save and delete if scripts were flushed in the server.
+- Depend on Redic ~> 1.5.0 in order to use of `call!` instead of `call`.
+
+## 2.2.1
+
+- Lock msgpack version
+
+## 2.2.0
+
+- Use Stal for set operations
+
+## 2.1.0
+
+- Add `combine` filter
+
+## 2.0.0
+
+- Lists now respond to range.
+
+  Example:
+
+  ```ruby
+  class Comment < Ohm::Model
+  end
+
+  class Post < Ohm::Model
+    list :comments, :Comment
+  end
+
+  c1 = Comment.create
+  c2 = Comment.create
+  c3 = Comment.create
+
+  post = Post.create
+  post.comments.push(c1)
+  post.comments.push(c2)
+  post.comments.push(c3)
+
+  post.comments.range(0, 1) == [c1, c2]
+  # => true
+  ```
+
+- When a record is created, `#id` returns a string instead of an integer.
+  This ensures IDs are strings everywhere:
+
+  Example:
+
+  ```ruby
+
+  # Before
+  Meetup.create(name: "Ruby").id # => 1
+  Meetup.with(:name, "Ruby").id  # => "1"
+
+  # Now
+  Meetup.create(name: "Ruby").id # => "1"
+  Meetup.with(:name, "Ruby").id  # => "1"
+  ```
+
+- If an attribute is set to an empty string, Ohm won't delete it.
+
+  Example:
+
+  ```ruby
+  # Before
+  event = Meetup.create(location: "")
+  Meetup[event.id].location # => nil
+
+  # Now
+  event = Meetup.create(location: "")
+  Meetup[event.id].location # => ""
+  ```
+
+- Include `Ohm::List#ids` in the public API. It returns an array with all
+  the ID's in the list.
+
+  Example:
+
+  ```ruby
+  class Comment < Ohm::Model
+  end
+
+  class Post < Ohm::Model
+    list :comments, :Comment
+  end
+
+  post = Post.create
+  post.comments.push(Comment.create)
+  post.comments.push(Comment.create)
+  post.comments.push(Comment.create)
+
+  post.comments.ids
+  # => ["1", "2", "3"]
+  ```
+
+- Include `Ohm::BasicSet#exists?` in the public API. This makes possible
+  to check if an id is included in a set. Check `Ohm::BasicSet#exists?`
+  documentation for more details.
+
+  Example:
+
+  ```ruby
+  class Post < Ohm::Model
+  end
+
+  class User < Ohm::Model
+    set :posts, :Post
+  end
+
+  user = User.create
+  user.posts.add(post = Post.create)
+
+  user.posts.exists?(post.id)       # => true
+  user.posts.exists?("nonexistent") # => false
+  ```
+
+- Change `Ohm::MultiSet#except` to union keys instead of intersect them
+  when passing an array.
+
+  Example:
+
+  ```ruby
+  class User < Ohm::Model
+    attribute :name
+  end
+
+  john = User.create(name: "John")
+  jane = User.create(name: "Jane")
+
+  res = User.all.except(name: [john.name, jane.name])
+
+  # Before
+  res.size # => 2
+
+  # Now
+  res.size # => 0
+  ```
+
+- Move ID generation to Lua. With this change, it's no longer possible
+  to generate custom ids. All ids are autoincremented.
+
+- Add `Ohm::Model.track` method to allow track of custom keys. This key
+  is removed when the model is deleted.
+
+  Example:
+
+  ```ruby
+  class Foo < Ohm::Model
+    track :notes
+  end
+
+  foo = Foo.create
+
+  Foo.redis.call("SET", foo.key[:notes], "something")
+  Foo.redis.call("GET", "Foo:1:notes")
+  # => "something"
+
+  foo.delete
+  Foo.redis.call("GET", "Foo:1:notes")
+  # => nil
+  ```
+
+- `Ohm::Model#reference` accepts strings as model references.
+
+  Example:
+
+  ```ruby
+  class Bar < Ohm::Model
+    reference :foo, "SomeNamespace::Foo"
+  end
+
+  Bar.create.foo.class # => SomeNamespace::Foo
+  ```
+
+- `Ohm::Model#save` sanitizes attributes before sending them to Lua.
+  This complies with the original spec in Ohm v1 where a `to_s`
+  is done on each value.
+
+  Example:
+
+  ```ruby
+  class Post < Ohm::Model
+    attribute :published
+  end
+
+  post = Post.create(published: true)
+  post = Post[post.id]
+
+  # Before
+  post.published # => "1"
+
+  # Now
+  post.published # => "true"
+  ```
+
+- `Ohm::Model#save` don't save values for attributes set to false.
+
+  Example:
+
+  ```ruby
+  class Post < Ohm::Model
+    attribute :published
+  end
+
+  post = Post.create(published: false)
+  post = Post[post.id]
+
+  # Before
+  post.published # => "0"
+
+  # Now
+  post.published # => nil
+  ```
+
+- `nest` dependency has been removed. Now, Ohm uses [nido][nido]
+  to generate the keys that hold the data.
+
+- `scrivener` dependency has been removed. Ohm no longer supports model
+  validations and favors filter validation on the boundary layer. Check
+  [scrivener][scrivener] project for more information.
+
+- `redis` dependency has been removed. Ohm 2 uses [redic][redic],
+  a lightweight Redis client. Redic uses the `hiredis` gem for the
+  connection and for parsing the replies. Now, it defaults to a
+  Redic connection to "redis://127.0.0.1:6379". To change it, you
+  will need to provide an instance of `Redic` through the `Ohm.redis=`
+  helper.
+
+  Example:
+
+  ```ruby
+  Ohm.redis = Redic.new("redis://:<passwd>@<host>:<port>/<db>")
+  ```
+
+  Check the Redic README for more details.
+
+- `Ohm::Model#transaction` and `Ohm::Transaction` have been removed.
+
+- Move `save` and `delete` operations to Lua scripts.
+
+- Support for Ruby 1.8 has been removed.
+
+[nido]: https://github.com/soveran/nido
+[scrivener]: https://github.com/soveran/scrivener
+[redic]: https://github.com/amakawa/redic
+
+## 1.4.0
+
+- Add `combine` filter
+
+## 1.3.2
+
+- Fetching a batch of objects is now done in batches of 1000 objects at
+  a time. If you are iterating over large collections, this change should
+  provide a significant performance boost both in used memory and total
+  execution time.
+
+- `MutableSet#&lt;&lt;` is now an alias for `#add`.
+
+## 1.3.1
+
+- Improve memory consumption when indexing persisted attributes.
+  No migration is needed and old indices will be cleaned up as you save
+  instances.
+
+## 1.3.0
+
+- Add Model.attributes.
+
+## 1.2.0
+
+- Enumerable fix.
+
+- Merge Ohm::PipelinedFetch into Ohm::Collection.
+
+- Fix Set, MultiSet, and List enumerable behavior.
+
+- Change dependencies to use latest cutest.
+
+## 1.1.0
+
+- Compatible with redis-rb 3.
+
+## 1.0.0
+
+- Fetching a batch of objects is now done through one pipeline, effectively
+  reducing the IO to just 2 operations (one for SMEMBERS / LRANGE, one for
+  the actual HGET of all the individual HASHes.)
+
+- write_remote / read_remote have been replaced with set / get respectively.
+
+- Ohm::Model.unique has been added.
+
+- Ohm::Model::Set has been renamed to Ohm::Set
+
+- Ohm::Model::List has been renamed to Ohm::List
+
+- Ohm::Model::Collection is gone.
+
+- Ohm::Validations is gone. Ohm now uses Scrivener::Validations.
+
+- Ohm::Key is gone. Ohm now uses Nest directly.
+
+- No more concept of volatile keys.
+
+- Ohm::Model::Wrapper is gone.
+
+- Use Symbols for constants instead of relying on Ohm::Model.const_missing.
+
+- `#sort` / `#sort_by` now uses `limit` as it's used in redis-rb, e.g. you
+  have to pass in an array like so: sort(limit: [0, 1]).
+
+- Set / List have been trimmed to contain only the minimum number
+  of necessary methods.
+
+- You can no longer mutate a collection / set as before, e.g. doing
+  User.find(...).add(User[1]) will throw an error.
+
+- The #union operation has been added. You can now chain it with your filters.
+
+- Temporary keys when doing finds are now automatically cleaned up.
+
+- Counters are now stored in their own key instead, i.e. in
+  User:<id>:counters.
+
+- JSON support has to be explicitly required by doing `require
+  "ohm/json"`.
+
+- All save / delete / update operations are now done using
+  transactions (see http://redis.io/topics/transactions).
+
+- All indices are now stored without converting the values to base64.

data/CONTRIBUTING

@@ -0,0 +1,19 @@
+This code tries to solve a particular problem with a very simple
+implementation. We try to keep the code to a minimum while making
+it as clear as possible. The design is very likely finished, and
+if some feature is missing it is possible that it was left out on
+purpose. That said, new usage patterns may arise, and when that
+happens we are ready to adapt if necessary.
+
+A good first step for contributing is to meet us on IRC and discuss
+ideas. We spend a lot of time on #lesscode at freenode, always ready
+to talk about code and simplicity. If connecting to IRC is not an
+option, you can create an issue explaining the proposed change and
+a use case. We pay a lot of attention to use cases, because our
+goal is to keep the code base simple. Usually the result of a
+conversation is the creation of a different tool.
+
+Please don't start the conversation with a pull request. The code
+should come at last, and even though it may help to convey an idea,
+more often than not it draws the attention to a particular
+implementation.

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2009 Michel Martens and Damian Janowski
+
+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.