Project status: The development of a proof-of-concept implementation is done. We are currently focussing our attention on other projects.
The api-editor is a tool to improve the API of a Python library in a semi-automated manner. Several improvements are suggested automatically and the user can add further improvements manually in a user-friendly GUI. These improvements are implemented automatically by the tool as wrappers that provide the desired API while internally using the existing Python library.
The automation described above relies on structured information about the existing Python library. This information can be computed automatically by the library-analyzer.
You can find the full documentation here.
- Install OpenJDK 17.
- Download the file
API-Editor (<version>)from the latest release (listed under "Assets"). - Run the program:
java -jar api-editor-<version>.jar
- Open localhost:4280 in your browser.
- In the window that opens, enter your username in the bottom right field.
- Download the contents of the
datafolder of this project. Alternatively, compute the required data for another Python API using the library-analyzer. - Open
File > Import > API Dataand upload the API data that you stored locally. - Open
File > Import > Usagesand upload the usage data that you stored locally. - Open
File > Import > Annotationsand upload the annotation data that you stored locally (from the repository or your own prior usages of the tool).
Now you are ready to explore the API and review existing annotations.
- Install OpenJDK 17.
- Install Node.js 18.x.
- Build everything:
./gradlew build
- Run the backend server:
./gradlew :backend:run
- Run the development server (keep the backend server running):
cd gui npm run dev - Open localhost:5173 in your browser.
We welcome contributions from everyone. As a starting point, check the following resources:
If you need further help, please use our discussion forum.