Metadata-Version: 2.4
Name: dep-orbits
Version: 0.1.6
Summary: Visualize dependency graphs as solar systems
License-Expression: MIT
Requires-Python: >=3.13
Requires-Dist: packaging
Description-Content-Type: text/markdown

[![PyPI version fury.io](https://badge.fury.io/py/dep-orbits.svg)](https://pypi.python.org/pypi/dep-orbits/)
[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)
# OrBits

https://pypi.org/project/dep-orbits/

OrBits is a tool for visualizing dependency graphs as a solar system.
It works on both Python projects (using pyproject.toml or similar) or
JavaScript projects (using package-lock.json).

## Installation

Install from Pypi:

```bash
pip install dep-orbits
```

Or, using pipx:

```bash
pipx install dep-orbits
```

Or, using uv:


```bash
uv tool install dep-orbits
```

## Usage

Run, in your project's directory:

```bash
orbits
```

Note that you must have all dependencies installed to measure the size of dependencies. For Python,
this means you must have an active virtual environment with all your dependencies. For node, your
`node_modules` must be populated (using e.g. `npm install`).

## Screenshots
For example, using [Home Assistants Core repo](https://github.com/home-assistant/core/), installing the dependencies then running `orbits` results in:

<img width="2560" height="1366" alt="image" src="https://github.com/user-attachments/assets/46336f0f-43e3-468f-b4d8-923979eea786" />

Toggling the background off and clicking on one of the planets/moons results in:

<img width="2560" height="1366" alt="image" src="https://github.com/user-attachments/assets/780f9327-fb47-4236-8412-fa74c76baeb4" />

The same dependency may appear in multiple subtrees as highlighted in red 
<img width="2560" height="1366" alt="image" src="https://github.com/user-attachments/assets/3dc72268-7556-4c08-822d-3642fde8fc35" />

Additionally, you can only highlight based on depth from the original project using toggles in the bottom left corner:
<img width="1638" height="1212" alt="image" src="https://github.com/user-attachments/assets/2c5ac045-4d92-49ca-8a53-2aa6589b0f42" />

