Pyjsgf

--------------------

Added
^^^^^
* Add Expansion.matcher_element property.
* Add Expansion.invalidate_matcher method.
* Add Rule.find_matching_part method. Thanks `embie27`_.
* Add docstrings to undocumented classes and methods.
* Add Sphinx documentation project files in `docs/` and use autodoc for automatic module, class, class member and function documentation.
* Add `CHANGELOG.rst` file and include it in the documentation.

Changed
^^^^^^^
* Make speech string matching scale to large rules/grammars.
* Make jsgf.ext.Dictation expansions match correctly in most circumstances.
* Allow rules to use optional only rule expansions.
* Update docstrings in all Python modules.
* Change internal matching method to implement for subclasses from _matches_internal to _make_matcher_element.

Deprecated
^^^^^^^^^^
* Add deprecation note for the Grammar.compile_grammar method.
* Deprecate the ExpansionError and MatchError classes.

Fixed
^^^^^
* Fix `issue 12`_ and probably some other bugs where speech wouldn't match rules properly.
* Fix __hash__ methods for the Dictation and AlternativeSet classes.

Removed
^^^^^^^
* Remove support for matching ambiguous rule expansion because it is not worth the performance hit.

--------------------

Added
^^^^^
* Add ChildList list subclass for storing rule expansion children and updating parent-child relationships appropriately on list operations.

Changed
^^^^^^^
* Change Literal.text attribute into a property with some validation.

Fixed
^^^^^
* Fix AlternativeSet bug with parser (`issue 9`_). Thanks `embie27`_.

--------------------

Added
^^^^^
* Implement grammar, rule and expansion parsers.
* Add setters for the BaseRef name property and Expansion children property.

Changed
^^^^^^^
* Allow imported rule names to be used by NamedRuleRefs.

Fixed
^^^^^
* Fix NamedRuleRefs for rule expansion functions and the Rule.dependencies property.

--------------------

Added
^^^^^
* Add methods/properties to the Rule and Grammar classes for JSGF tag
support.
* Add rule resolution for NamedRuleRef class.
* Add method and property for checking expansion match values for each repetition.

Fixed
^^^^^
* Fix various bugs with JSGF rule expansions.

--------------------

Added
^^^^^
* Add 'six' as a required package to support Python versions 2.x and 3.x.

Changed
^^^^^^^
* Change add_rule methods of grammar classes to silently fail when adding rules that are already in grammars.

Fixed
^^^^^
* Fix hash implementations and __str__ methods for rule classes.
* Other minor fixes.

--------------------

Added
^^^^^
* Add Expansion.collect_leaves method.

Changed
^^^^^^^
* Reset match data for unmatched branches of expansion trees.
* Change Expansion leaf properties to also return RuleRefs.
* Move some Literal class properties to the Expansion superclass.