Metadata-Version: 2.4
Name: colddigger
Version: 0.3.0
Summary: List tracked files not touched by other git branches
Project-URL: Repository, https://github.com/soxofaan/colddigger
Author-email: Stefaan Lippens <soxofaan@gmail.com>
License-Expression: MIT
License-File: LICENSE.txt
Keywords: git
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown


# colddigger

Simple Python based utility to identify "cold" files in a git repository:
tracked files in your main (or other) branch
that are not touched in other local or remote branches.

Intended use case: identify files that are safe to manipulate heavily
(e.g. automated code style cleanup)
without risk on merge conflicts with other branches or pull requests.


## Install and usage

This package is [available on PyPI](https://pypi.org/project/colddigger/)
and can be installed using classic pip (`pip install colddigger`),
which makes the utility available in your (virtual) environment
as a command line tool `colddigger`.

However, if you just need this utility for a one-off run,
and you have [`uv`](https://docs.astral.sh/uv) in your tool belt,
you can avoid installation worries and run it directly with
[`uvx`](https://docs.astral.sh/uv/concepts/tools/#the-uv-tool-interface):

```bash
uvx colddigger --help
```
