ast_helper

Version, currently master branch1 version
  • master branchlatestDec 7, 2019

github.com/bcardiff/crystal-ast-helper

Helper tool to debug parser and formatter

26 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  ast_helper:
    github: bcardiff/crystal-ast-helper
    branch: master

master is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
0.31.0
License
MIT
Author
Brian J. Cardiff <bcardiff@gmail.com>
Target
  • ast_helper from src/ast_helper.cr

Dependencies

Runtime Dependencies

  • redomi*github: bcardiff/redomi, branch: master

README

# ast_helper

## Installation

```
$ git checkout https://github.com/bcardiff/crystal-ast-helper.git
$ cd crystal-ast-helper
$ shards
$ crystal src/ast_helper.cr

$ open http://localhost:9090
```

If you want to use with crystal head use:

```
$ path/to/crystal-clone/bin/crystal src/ast_helper.cr
```

## Usage

When opening [http://localhost:9090](http://localhost:9090) you will be able to:

* input source
* view the output according to the formatter
* view the tokens returned by the lexer used for parsing and for formatting
  * view the tokens consumed so far even if the formatter fails
* view the stack trace of each token
* view the AST of the whole program

![](https://user-images.githubusercontent.com/459923/46692683-4d02af80-cbde-11e8-8af4-443432567a99.gif)


## Contributing

1. Fork it (<https://github.com/bcardiff/crystal-ast-helper/fork>)
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request

## Contributors

- [bcardiff](https://github.com/bcardiff) Brian J. Cardiff - creator, maintainer