ampex 1.2.1 → 2.0.0

data/README.markdown

@@ -1,4 +1,4 @@
-The Ampex (`&X`) library provides a Metavariable X that can be used in conjunction with the unary ampersand to create anonymous blocks in a slightly more readable way than the default. It was inspired by the clever `Symbol#to_proc` method which handles the most common case very elegantly, and discussion with Sam Stokes who created an earlier version.
+The Ampex (`&X`) library provides a Metavariable X that can be used in conjunction with the unary ampersand to create anonymous blocks in a slightly more readable way than the default. It was inspired by the clever `Symbol#to_proc` method which handles the most common case very elegantly, and discussion with Sam Stokes about creating lazy enumerators in ruby.
 
 Usage
 -----
@@ -29,9 +29,6 @@ As everything in Ruby is a method call, you can create readable expressions with
     ["a", "b", "c"].map &(X * 2)
       # => ["aa", "bb", "cc"]
 
-    [{}].each &X[1] = 2
-      # => [{1 => 2}]
-
 You can use this in any place a block is expected, for example to create a lambda:
 
     normalizer = lambda &X.to_s.downcase
@@ -67,15 +64,10 @@ Secondly, other arguments or operands will only be evaluated once, and not every
     [1, 2].map{ |x| x + (i += 1) }
       # => [2, 4]
 
-Bugs
-----
-
-In normal usage there are no known bugs. That said, if you accidentally miss the `&` from in front of the `X`, in an expression that ends in an assignment (e.g. `X.formatter = :inspect`); then the `#to_proc` method of the object assigned will respond with the expression generated by that `X` the next time you call it from anywhere else in the same thread.
-
 Epilogue
 --------
 
-`&X` has been tested on MRI ruby 1.8.6, 1.8.7 and 1.9.2 and jruby 1.5.3. It is thread-safe.
+`&X` has been tested on MRI ruby 1.8.6, 1.8.7, 1.9.2, 1.9.3, jruby, and rubinius.
 
 For bug-fixes or enhancements, please contact the author: Conrad Irwin <conrad.irwin@gmail.com>
 
@@ -83,7 +75,18 @@ For an up-to-date version, try <https://github.com/rapportive-oss/ampex>
 
 This library is copyrighted under the MIT license, see LICENSE.MIT for details.
 
+
+Backwards compatibility breakages
+---------------------------------
+
+Between version 1.2.1 and version 2.0.0, the support for assignment operations was removed from
+ampex. These had a very non-obvious implementation, and it was impossible to support
+assigning of falsey values; and did not work on rubinius.
+
 See also
 --------
 
+* <https://cirw.in/blog/ampex> — a blog post that describes the ideas.
 * <https://github.com/danielribeiro/RubyUnderscore> — which uses an underscore in place of `&X` and works by rewriting the syntax tree.
+* <https://gist.github.com/1224361> — a patch for Rubinius that enables the underscore in a similar way.
+* <http://blog.railsware.com/2012/03/13/ruby-2-0-enumerablelazy/> — The upcoming lazy enumerable support for Ruby 2.0.

data/lib/ampex.rb

@@ -14,10 +14,6 @@ else
 end
 
 class Metavariable < superclass
-  # Take a local copy of these as constant lookup is destroyed by BasicObject.
-  Metavariable = self
-  Thread = ::Thread
-
   # When you pass an argument with & in ruby, you're actually calling #to_proc
   # on the object. So it's Symbol#to_proc that makes the &:to_s trick work,
   # and Metavariable#to_proc that makes &X work.
@@ -39,9 +35,8 @@ class Metavariable < superclass
   # }
   #
   def method_missing(name, *args, &block)
-    mv = Metavariable.new { |x| @to_proc.call(x).__send__(name, *args, &block) }
-    Metavariable.temporarily_monkeypatch(args.last, :to_proc) { mv.to_proc } if name.to_s =~ /[^!=<>]=$/
-    mv
+    raise ::NotImplementedError, "(&X = 'foo') is unsupported in ampex > 2.0.0" if name.to_s =~ /[^!=<>]=$/
+    ::Metavariable.new { |x| @to_proc.call(x).__send__(name, *args, &block) }
   end
 
   # BlankSlate and BasicObject have different sets of methods that you don't want.
@@ -49,79 +44,6 @@ class Metavariable < superclass
   instance_methods.each do |method|
     undef_method method unless %w(method_missing to_proc __send__ __id__).include? method.to_s
   end
-
-  private
-
-  # In order to support assignment via &X (expressions of the form &X['one'] = 2),
-  # we need to add 2.to_proc (because assignment in ruby always returns the operand)
-  #
-  # Luckily, we only need to do this for a very short time.
-  #
-  # When given an expression such as:
-  #
-  #  ary.map(&X[args(a)] = :two)
-  #
-  # the order of execution is:
-  #  args(a)
-  #  X[_] = :two    \_ need to patch here
-  #  :two.to_proc  _/  and  un-patch here
-  #  ary.map &_
-  #
-  # We go to some lengths to ensure that, providing the & and the X are adjacent,
-  # it's not possible to get different behaviour in the rest of the program; despite
-  # the temporary mutation of potentially global state.
-  #
-  # We can't really do anything if the & has been split from the X, consider:
-  #
-  #   assigner = (X[0] = :to_i)
-  #   assigner == :to_i
-  #     # => true
-  #   [1,2,3].map(&:to_i)
-  #     # => NoMethodError: undefined method `[]=' for 1:Fixnum
-  #
-  # Just strongly encourage use of:
-  #   assigner = lambda &X = :to_i
-  #   assigner == :to_i
-  #     # => false
-  #   [1,2,3].map(&:to_i)
-  #     # => [1,2,3]
-  #
-  def self.temporarily_monkeypatch(instance, method_name, &block)
-
-    Thread.exclusive do
-      @monkey_patch_count = @monkey_patch_count ? @monkey_patch_count + 1 : 0
-      stashed_method_name = :"#{method_name}_without_metavariable_#{@monkey_patch_count}"
-      thread = Thread.current
-
-      # Try to get a handle on the object's singleton class, but fall back to using
-      # its actual class where that is not possible (i.e. for numbers and symbols)
-      klass = (class << instance; self; end) rescue instance.class
-      klass.class_eval do
-
-        alias_method(stashed_method_name, method_name) rescue nil
-        define_method(method_name) do
-
-          todo = block
-
-          Thread.exclusive do
-            if self.equal?(instance) && thread.equal?(Thread.current)
-
-              klass.class_eval do
-                undef_method(method_name)
-                alias_method(method_name, stashed_method_name) rescue nil
-                undef_method(stashed_method_name) rescue nil
-              end
-
-            else
-              todo = method(stashed_method_name)
-            end
-          end
-
-          todo.call
-        end
-      end
-    end
-  end
 end
 
 X = Metavariable.new

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ampex
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 15
   prerelease: 
   segments: 
-  - 1
   - 2
-  - 1
-  version: 1.2.1
+  - 0
+  - 0
+  version: 2.0.0
 platform: ruby
 authors: 
 - Conrad Irwin
@@ -15,8 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-23 00:00:00 -07:00
-default_executable: 
+date: 2012-05-20 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: blankslate
@@ -44,7 +43,6 @@ files:
 - lib/ampex.rb
 - README.markdown
 - LICENSE.MIT
-has_rdoc: true
 homepage: http://github.com/rapportive-oss/ampex
 licenses: []
 
@@ -74,7 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.8.21
 signing_key: 
 specification_version: 3
 summary: Provides a meta-variable X which can be used to create procs more prettily