HTTPS clone URL
Subversion checkout URL
Python implementation of the famous Coco/R LL(k) compiler generator
Fetching latest commit...
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Coco/R (http://ssw.jku.at/coco/) is a compiler generator, which takes an attributed grammar of a source language and generates a scanner and a parser for this language. The scanner works as a deterministic finite automaton. The parser uses recursive descent. LL(1) conflicts can be resolved by a multi-symbol lookahead or by semantic checks. Thus the class of accepted grammars is LL(k) for an arbitrary k. There is version of Coco/R for Python language. This is a fork of CocoPy-1.1.0rc (http://pypi.python.org/pypi/CocoPy/) of Ronald Longo, since it unmaintained. !!!PLEASE NOTE!!! This distribution is a release candidate. Setup and usage information can be found in section 3 of documentation/CocoDoc.htm. CocoDoc.htm contains everything you need to use Coco for Python. This file contains a list of the contents of the distribution and a development roadmap. CONTENTS OF THIS DISTRIBUTION This distribution of Coco includes the following: Coco root directory The application files Coco.py - The main application file Scanner.py - The lexical analizer for attributed grammars Parser.py - The parser for attributed grammars DriverGen.py - Generates the main application ParserGen.py - Generates the parser CodeGenerator.py - Common code generation routines CharClass.py - Implementation of character classes Errors.py - Tracking and reporting errors in the source grammar Trace.py - Routines for generating trace files Core.py - Scanner generator and various support classes. Other setup.py - Python distribution utilities setup script for Coco. setupInfo.py - CocoPy Version information README.txt - this file. /documentation license.txt - The license agreement CocoDoc.htm - The documentation for CocoPy howToBootstrap.txt - Instructions on how to bootstrap Coco (outdated) DataStructurres.pdf- A description of the workings of Coco pimaker.txt - Documentation of pimaker. /examples Various example Attributed Grammars, not all are LL(1). /frames The basic Frame files. These are template files used by the code generation routines. /sources These are the source files needed to bootstrap CocoPy. Coco.atg - The grammar for the Coco language. Coco.frame - Frame file for Coco's main module. Parser.frame - Frame file for Coco's parser module. Scanner.frame - Frame file for Coco's scanner module. /pimaker (Python Interactive Make utility) The Python Interactive Make utility written in Coco as a practical example of Coco usage. pimaker.atg - The grammar for a makepi.how file. pimaker.frame - The frame file for pimaker's main module. pimakerlib.py - Library of routines needed by pimaker. makepi.how - Pimaker's equivalent to a 'makefile' to bootstrap Coco. /testSuite The testbootstrap target in pimaker simply diffs the generated files coco.py, Parser.py and Scanner.py. If there are no differences, the test passes. However, when modifications are made to Coco.py this sort of testing is not sufficient. The suite of tests is in this directory are ported for the C# implementation of Coco/R. They test Coco/R features. To run the test suite open a command shell into the testSuite folder and execute the following: >>> python cocopTester.py ROADMAP - Version numbering is tentative. Release# Goal -------- ------------------------------------------------------ 1.0.10b2. Coco now bootstraps correctly. 1.1.0rc. *** Release Candidate -- Coco now successfully runs the test suite from the C# implementation. 1.1.1rc. Coco now correctly parses the examples and reports all the errors in the example grammars. 1.1.2rc. Code generated from examples now sucessfully loads into python using 'python name.py' 1.1.3rc Code generated from examples now successfully parses input and generates errors when appropriate. 1.2.0. *** Final -- No bugs reported or found for some (as yet undetermined) period of time (e.g. 3 months). 1.2.x. Various bug fix releases 1.3.0. Coco is now updated to equivalence of the latest Java & C# implementations. 2.0.0. *** Enhancements -- Incorporated various enhancements - get rid of all the static code - Improve indentation of generated code (currently much is hardcoded). Should be more flexible to user's preference. As I move Coco towards a final release I also want to continuously update and refine the documentation.