https://github.com/kayleexx/nexus
https://github.com/kayleexx/nexus
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kayleexx/nexus
- Owner: Kayleexx
- License: mit
- Created: 2025-07-23T16:31:14.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-12T15:37:17.000Z (10 months ago)
- Last Synced: 2025-08-12T17:25:08.882Z (10 months ago)
- Language: Rust
- Size: 20.5 KB
- Stars: 14
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nexus
**Nexus** is a Rust-based CLI tool for analyzing and visualizing code dependencies in source files. It builds a dependency graph from Rust code and supports circular dependency detection.
## Features
- Analyze Rust project structure by parsing `mod` and `use` declarations
- Generate dependency graph in DOT format
- Detect circular dependencies
- Traverse entire source directory
- Modular parser system (currently supports Rust, Javascript, Python and Java)
## Usage
### Build
```bash
cargo build --release
````
### Run
```bash
cargo run -- --path ./src
```
#### Options
| Flag | Description | Default |
| ----------------- | ------------------------------------------- | ------------ |
| `--path, -p` | Path to the source code directory | *(required)* |
| `--output, -o` | Output file path | `output.dot` |
| `--format` | Output format: `dot` or `json` | `dot` |
| `--detect-cycles` | Enable or disable circular dependency check | `true` |
Example:
```bash
cargo run -- --path ./src --output graph.dot --format dot --detect-cycles false
```
## Output
The tool outputs a `.dot` file representing the dependency graph. You can render it using Graphviz:
```bash
dot -Tpng output.dot -o graph.png
```
## Project Structure
```
nexus/
├── src/
│ ├── main.rs # CLI entrypoint
│ ├── graph/ # Graph construction and cycle detection
│ ├── parsers/ # Rust parser module
│ ├── utils/ # File system walking logic
│ └── analyzer/ # Central analyzer logic
```