Skip to main content

vinclude

Last release GitHub license pypi version

Visual C/C++ project include graphs, in a simple command line UI, for Linux. Useful for quickly understanding how subfolders depend on each other.

Overview

When launched, vinclude looks for #include directives in the current directory and tries to match them to files in that directory. Then it visualizes which subdirectory includes files from which other subdirectory:

Demo screenshot

This screenshot shows the root directory of https://github.com/KATRIN-Experiment/Kassiopeia/ .

Limitations

vinclude does very simple static code analysis based on command line tools grep and find. If included files have names that occur multiple times in the source, they cannot be matched.

Usage

After installing vinclude via pip install vinclude, it can be run in the current folder by executing vinclude.

On the top folders are shown that are referenced from files in a given other folder. After selecting such a folder pair with the arrow keys, at the bottom a full list of files is shown that match this pair. Tab allows to toggle between folder and file list, the enter key toggles the active list to fullscreen.

Note that you can also run the command in a subfolder of your choice to understand dependencies of source files in subfolders of that subfolder alone.

Metadata

Release files for vinclude 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vinclude 1.1.0
File Size Uploaded
vinclude-1.1.0.tar.gz 42.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vinclude 1.1.0
File Interpreter ABI Platform
vinclude-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 72.4 kB

Release files / vinclude-1.1.0.tar.gz

Download URL vinclude-1.1.0.tar.gz
Size 42.2 kB
Tags Source
SHA-256 checksum
How to use checksums
ee627a57847a17033f81e25342bdf4fb0545bec31ec7bc092c2549e6a5813a77
BLAKE2b-256 checksum
How to use checksums
9f9032e2ea599b111995b8d95f1be2b951337617764fbb68b704e764da4029d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 27, 2025.

Transparency log

Release files / vinclude-1.1.0-py3-none-any.whl

Download URL vinclude-1.1.0-py3-none-any.whl
Size 30.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
385569ff07166f4506ae86e7cc88e3e8ba8696b05a92d7b1a08cede93b9347e7
BLAKE2b-256 checksum
How to use checksums
f436a62d5ef977c9b7ea59c8939bcbca7f6360d0a4b1de77b86d4a016c6fed9a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 27, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page