Browse Source

Moved development instructions from README.md to docs

tags/gm/2021-09-23T00Z/github.com--lark-parser-lark/0.6.6
evandrocoan 6 years ago
committed by Erez Shinan
parent
commit
3fb0c48557
3 changed files with 41 additions and 32 deletions
  1. +1
    -32
      README.md
  2. +39
    -0
      docs/how_to_develop.md
  3. +1
    -0
      docs/index.md

+ 1
- 32
README.md View File

@@ -165,38 +165,7 @@ Lark uses the [MIT license](LICENSE).

## Contribute

Lark is currently accepting pull-requests.

There are many ways you can help the project:

* Help solve issues
* Improve the documentation
* Write new grammars for Lark's library
* Write a blog post introducing Lark to your audience
* Port Lark to another language
* Help me with code developemnt

If you're interested in taking one of these on, let me know and I will provide more details and assist you in the process.

## Unit Tests

To run all Unit Tests,
install tox and Python 2.7 up to the latest python version supported (consult the file tox.ini).
Then,
run the command `tox` on the root of this project (where the main setup.py file is on).

If you would like to only run the Unit Tests for Python version 2.7,
you can run the command `tox -e py27`

If you would like to run a single Unit Test,
you do not need to use tox,
you can directly run it with your current python interpreter.
First you need to figure out what is the test full name.
For example:
```python
## test_package.tests_module.test_class_name.test_function_name
python -m unittest tests.test_parser.TestLalrStandard.test_lexer_error_recovering
```
Lark is currently accepting pull-requests. See [How to develop Lark](/docs/how_to_develop.md)

## Donate



+ 39
- 0
docs/how_to_develop.md View File

@@ -0,0 +1,39 @@
# How to develop Lark - Guide

There are many ways you can help the project:

* Help solve issues
* Improve the documentation
* Write new grammars for Lark's library
* Write a blog post introducing Lark to your audience
* Port Lark to another language
* Help me with code developemnt

If you're interested in taking one of these on, let me know and I will provide more details and assist you in the process.


## Unit Tests

To run all Unit Tests,
install tox and Python 2.7 up to the latest python version supported (consult the file tox.ini).
Then,
run the command `tox` on the root of this project (where the main setup.py file is on).

If you would like to only run the Unit Tests for Python version 2.7,
you can run the command `tox -e py27`

If you would like to run a single Unit Test,
you do not need to use tox,
you can directly run it with your current python interpreter.
First you need to figure out what is the test full name.
For example:
```python
## test_package test_class_name.test_function_name
python -m tests TestLalrStandard.test_lexer_error_recovering
```

Equivalent example/way, but unrecommended:
```python
## test_package.tests_module.test_class_name.test_function_name
python -m unittest tests.test_parser.TestLalrStandard.test_lexer_error_recovering
```

+ 1
- 0
docs/index.md View File

@@ -40,6 +40,7 @@ $ pip install lark-parser
* [Program Synthesis is Possible](https://www.cs.cornell.edu/~asampson/blog/minisynth.html) - Creates a DSL for Z3
* Guides
* [How to use Lark](how_to_use.md)
* [How to develop Lark](how_to_develop.md)
* Reference
* [Grammar](grammar.md)
* [Tree Construction](tree_construction.md)


Loading…
Cancel
Save