Metadata-Version: 2.4
Name: project_visualization_tool_GDeLuisi
Version: 0.3.2
Summary: Visualization tool for git-managed projects
Project-URL: Homepage, https://github.com/GDeLuisi/project_visualization_tool
Project-URL: Issues, https://github.com/GDeLuisi/project_visualization_tool/issues
Project-URL: Repository, https://github.com/GDeLuisi/project_visualization_tool
Author-email: De Luisi Gerardo <deluisigerardo@gmail.com>
License-File: LICENSE
Keywords: git,projects,visualization-tool
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: dash
Requires-Dist: dash-ag-grid
Requires-Dist: dash-bootstrap-components
Requires-Dist: pandas
Requires-Dist: repominer-gdeluisi
Requires-Dist: truck-factor-gdeluisi
Requires-Dist: waitress
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Description-Content-Type: text/markdown

# Project viewer
Project viewer is a tool that provides you with many kind of metric visualizations of your git repository.

With Project viewer you can:

- See who worked on different parts of the project
- Get an overview of the file structure
- See where there is the most activity in your project (yet to implement)
- See how your project has looked at different points in time
- Find all SATD placed inside the project's code
- Who worked on different subsystems in the past?

![alt text](docs/samples/pvt_dir.png)

## Get started:

- In your terminal, navigate to a git repository or a folder containing any repository
- Run the command "project-viewer ." (if in a repository base folder, otherwise explicitly submit the base repository folder of your project)
- The application will now open in your default browser.
![alt text](docs/samples/pvt_overview.png)![alt text](docs/samples/pvt_authors.png)
## Note

To use Project viewer, you will need to have the following programs installed:

    Python interpreter version >= 3.10
    git 2.29 or newer

Check your installed versions using **python --version**, **pip --version** and **git --version**.

## What makes Project viewer different?

🔒 Private by design

🏝️ Works offline

🤷 Git provider agnostic - works with any git repository

😊 No tracking, no ads, no cloud, no servers, no subscription