Metadata-Version: 2.1
Name: depoverflow
Version: 0.1.1
Summary: Watches StackOverflow answers and GitHub issues referenced in code for changes
Home-page: https://github.com/remram44/depoverflow
License: MIT
Author: Remi Rampin
Author-email: remi@rampin.org
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: requests (>=2,<3)
Requires-Dist: toml (>=0.10,<0.11)
Project-URL: Repository, https://github.com/remram44/depoverflow
Description-Content-Type: text/markdown

Depoverflow
-----------

This tool checks your source code for references to Stackoverflow answers and GitHub issues and warns you if those change.

Why?
----

There are plenty of tools that will let you know if your package dependencies have changed (`poetry show -o`, `npm outdated`, ...). There are even cloud-based services like Dependabot.

However, if you copy/paste code from Stackoverflow answers or GitHub issues, you will never be notified of updates.

Features
--------

* Find references to Stackoverflow answers and questions in code comments, to alert of edits and/or comments
* Find references to GitHub issues in code comments, to alert of open and close events and/or comments
* Optionally supports specific keywords such as "Works around"
* Saves current status of referenced items in a TOML file (similar to a lockfile), that you can check into version control (or not)

How to use
----------

Install the tool: `pip install depoverflow`

Create a configuration file `depoverflow.toml` with the list of source file patterns you want to read (in [Python glob format](https://docs.python.org/3/library/pathlib.html#pathlib.Path.glob)):

```toml
sources = [
    "src/**.py",
    "tests.py",
    "native/*.c",
]
```

Run the tool: `depoverflow`.

A file `depoverflow.status` will be created, which you can check into version control or not. It is a TOML file containing the current status of the items you reference from your code, so that a warning can be shown the next time they change.

