Say hello to Graph Buddy!
Your new best pal to help you understand your Java and Scala code better
With today’s IDEs, we are all forced to browse code written as text in flatly-structured files, with almost no information about the semantic dependencies between particular code units. What if we could take a different look and, instead of seeing just source code in text files, go through colorful graph nodes that instantly and clearly show you the structure of your code extracted from your codebase?
How can Graph Buddy help you?
Graph Buddy aims to speed up your process of reading and learning your source code. The Graph Buddy plugin provides a set of useful features and techniques that will help you easily browse through twisted code dependencies. At the same time, it gives you a better understanding of the code structure in your codebase.
Table of Contents
- Say hello to Graph Buddy!
- Table of Contents
- Supported languages
- How to use Graph Buddy
- Roadmap
- Telemetry
- Privacy policy
- Contact us
Supported languages
Graph Buddy is still under development and currently only supports:
- Java - with dynamic file parsing. Versions up to Java 11 are supported (with some experimental support for versions up to Java 16).
- Scala - via our scalac compiler plugin
Configuration for Java projects
Java is supported out-of-the-box, no extra configuration is necessary. You just need to install our plugin and it will automatically generate graph files for the currently open project on startup. The initial graph generation may take a few minutes for larger projects. If you change something in the code, the plugin will update the graph automatically. However, some changes (like changing the branch, removing multiple files at once) might not be propagated correctly. If you notice that the plugin isn’t working correctly (for example, if some nodes or edges aren’t pointing to the right locations or aren’t present at all), you can consider regenerating the graph files. To do so, please click the Generate Java graph
action from the Graph Buddy
menu.
Configuration for Scala projects
Here, except for installing the plugin in IDE, you need to configure your scala compiler. GraphBuddy has a plugin to it, which will generate graph files during compilation.
For sbt you can use sbt plugin. Just create plugin file project/graphbuddy.sbt
with the content:
addSbtPlugin("org.virtuslab.semanticgraphs" % "sbt-plugin" % "0.2.20")
or add scalac compiler plugin directly:
addCompilerPlugin("org.virtuslab.semanticgraphs" % "scalac-plugin" % "0.2.20" cross CrossVersion.full)
scalacOptions += "-Yrangepos"
Please remember to recompile the project with a new scalac plugin. In sbt:
sbt clean test:compile
Graph Buddy currently supports the following scala versions:
- 2.13.11
- 2.13.10
- 2.13.9
- 2.13.8
- 2.12.18
- 2.12.17
- 2.11.12
Installing a plugin
Make sure you have the following installed:
The plugin is available for:
You can install the plugin directly in your IDE - simply navigate to the store inside your IDE and
search for Graph Buddy
.
How to use Graph Buddy
Graph Buddy plugin adds a unique view into your IDE. You can perform visual operations, both by clicking on your code or on the graph visualization. Doing so will modify the graph structure accordingly, showcasing semantics info about your project.
Opening the Graph Buddy board
IntelliJ
Look for a ‘Graph Buddy’ tab in the bottom right corner and press it.
VSCode
Click the Graph Buddy
icon in the activity bar (left), then press the Open Graph Buddy window
button. It will open the Graph Buddy board; just wait for the reindexing process to finish and start
browsing!
Indexing the graph
The graph will be reindexed automatically during the project startup if there are any graph files in the .semanticgraphs
folder.
To reindex graph manually:
- VSCode - click the desired reindex option in the activity bar (left).
- IntelliJ - search for ‘Graph Buddy’ in the navigation menu and in the dropdown select “Reindex”.
Graph Buddy features
NOTE: The plugin is optimised for working in the default, 2D mode. Some features may not correctly (or even at all) in 3D mode.
Adding nodes to the graph
You can do this in multiple ways. The most intuitive is clicking on the code - then the corresponding node should appear on plugin canvas.
The second way is using options from the context menu in the editor or on canvas. In the editor, there are some options to generate the whole graph for a selected place in the code.
You can check where a given node is called using node context actions Called by & Call hierarchy. You can also find paths between nodes already added to the graph.
Filters, layouts, search
You can filter elements of a particular type using the menu on the top of the Graph Buddy panel. Layouts can help you organize nodes on the canvas. Finally, using search you can highlight elements matching the search phrase on the canvas. You can search by a part of the node name or by node type (i.e. CLASS
).
Saving state
If you want to preserve the current graph state for later use (i.e. to present it to your colleague), you can do this by clicking on the floppy disk icon on the toolbar. There you can save a snapshot of your current work or load a previously saved snapshot. You can find those snapshots in the .graphbuddy
folder.
Graph files regeneration and reindexing
If you are working with a Java project, then under some circumstances (switching branches, applying a code patch, editing or removing multiple files at once) some graph files may become outdated and as a result, the plugin may not work as expected (nodes and edges may be missing from the graph or pointing to incorrect locations in the code). There currently is no automated detection for these cases. When in doubt, you should trigger the Generate graph
action from the Main Menu to make sure you are working with up-to-date graph files.
If you are working with a Scala project, assuming you have configured the compiler plugin correctly, you should manually trigger the Reindex graph
action from the Main Menu. This will load the newly generated graph files to the plugin.
Advanced options
Graph canvas
Graph highlighting | By clicking on nodes or edges, the graph will highlight corresponding nodes and edges |
Graph data styles | Each data object has its own unique styling |
Removing data | By shift-clicking node (or choosing the option in context menu), you remove it from the webview |
Adding data to the graph | By double-clicking on the node you extend the graph by adding data corresponding with clicked node |
Data positioning | By dragging nodes you position them on the canvas |
Info on hover | By hovering over node/edge, a popup appears that contains some additional info about a targeted data object |
Context menu | By right-clicking on canvas, you open up a context menu with options depending on clicked data: node, edge, data kind, or background |
Flash messages | By performing various actions, flash message will display above interface buttons panel |
Navigation bar
Filters | By clicking the buttons in the filtering menu, you toggle visibility of the corresponding node/edge kind |
Layouts | By switching layout in the navigation bar (layers icon), you change the rendering method of the graph (classic, vertical, horizontal) |
Search | You can search for elements on the canvas, e.g. `Class`, `Method` or node name (like `get`). |
Settings | By selecting additional network options, you can adjust graph visibility and the amount of visible information to your liking. You can also switch the view between 2d and 3d. |
Interface buttons
Undo/Redo | Undo or redo action on the graph |
Zoom | Zoom in or out |
Reorganise graph | By clicking the reorganise graph button, you reorganise network nodes positions |
Freeze graph | By clicking the `freeze graph` button, you lock the graph, temporarily disallowing any updates to its data |
Clear graph | By clicking the `clear network data graph` button, you clear all existing graph data |
Graph file manager | By clicking the graph file manager button, you open up a modal that allows you to save the current graph data snapshot or load it, from a file; the default location is /workspace/.graphbuddy |
Keyboard shortcuts
Revert action | By pressing 'ctrl+z' you revert last action (add/update/remove/re-position) |
Redo action | By pressing 'ctrl+shift+z' you redo the last undone action (add/update/remove/re-position) |
Close modal | By pressing 'esc' you close the currently active modal |
Roadmap
Released
- Semantic Graph extraction based on semanticdb and Scala Tree (AST)
- Graph operations available directly via UI
- Improving semantic graph correctness
- Embedding the solution to Intellij and VSCode
- Support for Java
- Automatically refreshing the graph on code change
Planned
- Fixing remaining bugs in Java support
Contact us
We are happy to get constructive feedback that could improve this project! If you want to help/ask
questions, feel free to contact us: [email protected]