Skip to content

Commit 81baaed

Browse files
committed
add readme and license
1 parent 8838209 commit 81baaed

File tree

2 files changed

+46
-0
lines changed

2 files changed

+46
-0
lines changed

LICENSE

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2023 The ErrgoEngine Authors
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

+25
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
> [!IMPORTANT]
2+
> What you are seeing here is an in-progress implementation of our thesis paper. This is not usable as of the moment and it remains unanswered if this is effective while no testing has been conducted yet as of the moment.
3+
4+
# ErrgoEngine
5+
A contextualized programming error analysis translation engine.
6+
7+
It is a Go package that analyzes the programming error message in order to build a contextualized data which contains the error type, the data extracted from the error message text and the files from the extracted stack trace data. The data is then used to generate an enhanced form of programming error message which contains an explanation and bug fix suggestions which is local to the said error and at the same time the program's codebase.
8+
9+
Our aim here is to be able to assist novice programmers in enhancing their debugging skills by providing more information that will help them fully understand the programming errors presented to them.
10+
11+
## Programming languages supported
12+
ErrgoEngine uses the [tree-sitter](https://github.com/tree-sitter/tree-sitter) parser to extract information from the source code from different programming languages in a unified way. This enables us to support a variety of programming languages as long as there is support for it. At the moment, we only support for **Java** and **Python** but we will be able to support more programming languages, and in return more types of programming errors, in the near future with improved interface for langauge support.
13+
14+
## Dependencies
15+
ErrgoEngine only relies on the third-party [go-tree-sitter](https://github.com/smacker/go-tree-sitter) package for parsing but the rest of the code relies on the Go standard library so it should not be a problem at all when importing this package to your application.
16+
17+
## TODO
18+
- [ ] Implementation of error templates
19+
- [ ] Tests
20+
21+
## Paper
22+
- TODO
23+
24+
## Copyright and license
25+
(c) 2023 by the [ErrgoEngine Authors](https://github.com/nedpals/errgoengine/graphs/contributors). Code released under the [MIT License](https://github.com/nedpals/errgoengine/blob/main/LICENSE).

0 commit comments

Comments
 (0)