Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/javaparser/javaparser
Java 1-21 Parser and Abstract Syntax Tree for Java with advanced analysis functionalities.
https://github.com/javaparser/javaparser
abstract-syntax-tree ast code-analysis code-generation code-generator java javadoc javaparser javasymbolsolver parser syntax-tree
Last synced: about 1 month ago
JSON representation
Java 1-21 Parser and Abstract Syntax Tree for Java with advanced analysis functionalities.
- Host: GitHub
- URL: https://github.com/javaparser/javaparser
- Owner: javaparser
- License: other
- Created: 2011-10-30T14:03:44.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2024-10-26T15:11:54.000Z (about 2 months ago)
- Last Synced: 2024-10-29T11:13:40.279Z (about 1 month ago)
- Topics: abstract-syntax-tree, ast, code-analysis, code-generation, code-generator, java, javadoc, javaparser, javasymbolsolver, parser, syntax-tree
- Language: Java
- Homepage: https://javaparser.org
- Size: 43 MB
- Stars: 5,422
- Watchers: 143
- Forks: 1,152
- Open Issues: 449
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - JavaParser - Parse, modify and generate Java code. (Projects / Development)
- awesome-starred-test - javaparser/javaparser - Java 1-21 Parser and Abstract Syntax Tree for Java with advanced analysis functionalities. (Java)
- awesome-java-zh - JavaParser - 解析,修改和生成Java代码。 (项目 / 发展)
- awesome-java - JavaParser - Parse, modify and generate Java code. (Projects / Development)
- awesome-hacking-lists - javaparser/javaparser - Java 1-21 Parser and Abstract Syntax Tree for Java with advanced analysis functionalities. (Java)
- my-awesome - javaparser/javaparser - syntax-tree,ast,code-analysis,code-generation,code-generator,java,javadoc,javaparser,javasymbolsolver,parser,syntax-tree pushed_at:2024-12 star:5.5k fork:1.2k Java 1-21 Parser and Abstract Syntax Tree for Java with advanced analysis functionalities. (Java)
README
# JavaParser
[![Maven Central](https://img.shields.io/maven-central/v/com.github.javaparser/javaparser-core.svg)](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.github.javaparser%22%20AND%20a%3A%22javaparser-core%22)
[![Build Status](https://github.com/javaparser/javaparser/actions/workflows/maven_tests.yml/badge.svg?branch=master)](https://github.com/javaparser/javaparser/actions/workflows/maven_tests.yml)
[![Coverage Status](https://codecov.io/gh/javaparser/javaparser/branch/master/graphs/badge.svg?branch=master)](https://app.codecov.io/gh/javaparser/javaparser?branch=master)
[![Join the chat at https://gitter.im/javaparser/javaparser](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/javaparser/javaparser?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![License LGPL-3/Apache-2.0](https://img.shields.io/badge/license-LGPL--3%2FApache--2.0-blue.svg)](LICENSE)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.2667378.svg)](https://doi.org/10.5281/zenodo.2667378)This project contains a set of libraries implementing a Java 1.0 - Java 21 Parser with advanced analysis functionalities.
Our main site is at [JavaParser.org](http://javaparser.org)
## Sponsors
Support this project by becoming a sponsor! [Become a sponsor](https://opencollective.com/javaparser). Your donation will help the project live and grow successfully.
Javaparser uses [OpenCollective](https://opencollective.com/javaparser) to gather money.
**Thank you to our sponsors!**
## Setup
The project binaries are available in Maven Central.
We strongly advise users to adopt Maven, Gradle or another build system for their projects.
If you are not familiar with them we suggest taking a look at the maven quickstart projects
([javaparser-maven-sample](https://github.com/javaparser/javaparser-maven-sample),
[javasymbolsolver-maven-sample](https://github.com/javaparser/javasymbolsolver-maven-sample)).Just add the following to your maven configuration or tailor to your own dependency management system.
[Please refer to the Migration Guide when upgrading from 2.5.1 to 3.0.0+](https://github.com/javaparser/javaparser/wiki/Migration-Guide)
**Maven**:
```xml
com.github.javaparser
javaparser-symbol-solver-core
3.26.2```
**Gradle**:
```
implementation 'com.github.javaparser:javaparser-symbol-solver-core:3.26.2'
```Since Version 3.5.10, the JavaParser project includes the JavaSymbolSolver.
While JavaParser generates an Abstract Syntax Tree, JavaSymbolSolver analyzes that AST and is able to find
the relation between an element and its declaration (e.g. for a variable name it could be a parameter of a method, providing information about its type, position in the AST, ect).Using the dependency above will add both JavaParser and JavaSymbolSolver to your project. If you only need the core functionality of parsing Java source code in order to traverse and manipulate the generated AST, you can reduce your projects boilerplate by only including JavaParser to your project:
**Maven**:
```xml
com.github.javaparser
javaparser-core
3.26.2```
**Gradle**:
```
implementation 'com.github.javaparser:javaparser-core:3.26.2'
```Since version 3.6.17 the AST can be serialized to JSON.
There is a separate module for this:**Maven**:
```xml
com.github.javaparser
javaparser-core-serialization
3.26.2```
**Gradle**:
```
implementation 'com.github.javaparser:javaparser-core-serialization:3.26.2'
```## How To Compile Sources
If you checked out the project's source code from GitHub, you can build the project with maven using:
```
./mvnw clean install
```If you want to generate the packaged jar files from the source files, you run the following maven command:
```
./mvnw package
```**NOTE** the jar files for the two modules can be found in:
- `javaparser/javaparser-core/target/javaparser-core-\.jar`
- `javaparser-symbol-solver-core/target/javaparser-symbol-solver-core-\.jar`If you checkout the sources and want to view the project in an IDE, it is best to first generate some of the source files;
otherwise you will get many compilation complaints in the IDE. (`./mvnw clean install` already does this for you.)```
./mvnw javacc:javacc
```If you modify the code of the AST nodes, specifically if you add or remove fields or node classes,
the code generators will update a lot of code for you.
The `run_metamodel_generator.sh` script will rebuild the metamodel,
which is used by the code generators which are run by `run_core_generators.sh`
Make sure that `javaparser-core` at least compiles before you run these.**Note**: for Eclipse IDE follow the steps described in the wiki: https://github.com/javaparser/javaparser/wiki/Eclipse-Project-Setup-Guide
## More information
#### [JavaParser.org](https://javaparser.org) is the main information site or see the wiki page https://github.com/javaparser/javaparser/wiki.
## License
JavaParser is available either under the terms of the LGPL License or the Apache License. You as the user are entitled to choose the terms under which adopt JavaParser.
For details about the LGPL License please refer to [LICENSE.LGPL](https://github.com/javaparser/javaparser/blob/master/LICENSE.LGPL).
For details about the Apache License please refer to [LICENSE.APACHE](https://github.com/javaparser/javaparser/blob/master/LICENSE.APACHE).