CHANGES

= 3.0.3

  * Fix source code for ruby 2.7 compatibility.

= 3.0.1 / 2014-03-14

  * Fixed bad 3.0.0 release.

= 3.0.0 / 2014-03-14

  * Moved Object#grammar to citrus/core_ext.rb. Citrus no longer installs core
    extensions by default. Use "require 'citrus/core_ext.rb'" instead of
    "require 'citrus'" to keep the previous behavior.

  * Removed Match#method_missing, added #capture(name) and #captures(name)

    Match#method_missing is unsafe as illustrated in Github issue #41. In
    particular, it makes composing a grammar with aribitrary gems unsafe (e.g.
    when the latter make core extensions), leads to unexpected results with
    labels match existing Kernel methods (e.g. `p`), and prevents Match from
    getting new methods in a backward compatible way. This commit therefore
    removes it.

    In Citrus 2.x, method_missing allowed rule productions to denote captured
    matches by label name:

        rule pair
          (foo ':' bar) {
            [foo.value, bar.value]
          }
        end

    Also, it allowed invoking String operators on the Match's text:

        rule int
          [0-9]+ { to_i }
        end

    Those two scenarios no longer work out of the box in Citrus 3.0. You must
    use capture(label) for the former, and to_str for the latter:

        rule pair
          (foo ':' bar) {
            [capture(:foo).value, capture(:bar).value]
          }
        end

        rule int
          [0-9]+ { to_str.to_i }
        end

    Match#captures now accepts an optional label name as first argument and
    returns the corresponding array of matches for that label (useful in case
    the label belongs to a repetition).

= 2.5.0 / 2014-03-13

  * Inputs may be generated from many different sources, including Pathname and
    IO objects (thanks blambeau).

  * Matches keep track of their offset in the original source  (thanks
    blambeau).

  * Citrus.load no longer raises Citrus::LoadError for files that can't be found
    or are not readable. Users must rescue Errno::ENOENT instead, for example.

  * Removed a few ruby warnings (thanks tbuehlmann)

= 2.4.1 / 2011-11-04

  * Fixed a bug that prevented rule names from starting with "super".

  * Several minor bug fixes.

= 2.4.0 / 2011-05-11

  * Fixed a bug that prevented parsing nested blocks correctly (issue #21).

  * Added URI example.

  * Moved example grammars inside lib/citrus/grammars and added
    lib/citrus/grammars.rb for easily requiring Citrus example grammars.

= 2.3.7 / 2011-02-20

  * Fixed a bug that prevented forward slashes from being used inside character
    class literals.

  * Added email address example.

= 2.3.6 / 2011-02-19

  * Fixed a bug that prevented memoization from advancing the input's pointer
    properly (thanks joachimm).

  * Several additions to the TextMate bundle (thanks joachimm).

= 2.3.5 / 2011-02-07

  * Fixed a bug that prevented Match objects from being printed properly using
    Kernel#puts (thanks joachimm).

  * Fixed a bug that prevented using rules with names that begin with "end"
    (thanks Mark Wilden).

  * Citrus#require accepts relative file paths, in addition to absolute ones.

  * Simplified/cleaned up some example files.

= 2.3.4 / 2011-01-17

  * Added CHANGES file.

= 2.3.3 / 2011-01-17

  * Added self to Match#captures hash. This means that a Match may retrieve a
    reference to itself by using its own label, proxy name, or index 0 in the
    hash.

  * Match#captures returns an empty array for unknown Symbol keys, coerces
    String keys to Symbols, and returns nil for unknown Numeric keys.

  * Moved Citrus::VERSION to its own file.

  * Citrus::LoadError is raised when Citrus is unable to load a file from the
    file system because it cannot be found or it is not readable.

  * Citrus::SyntaxError is raised when Citrus::File is unable to parse some
    Citrus syntax.

  * Added Citrus.require for requiring .citrus grammar files in a similar way
    to Ruby's Kernel.require. Also, overloaded the require operator in Citrus
    grammar files to failover to Citrus.require when Kernel.require raises a
    LoadError.

  * Improved UTF-8 support.