eris/packaging/make-readme.py

import eris.tools as tools


def main():
    git_tools = [tools.git_diff, tools.git_blame, tools.git_log]
    all_tools = [(["*"], tools.generic_tools() + git_tools)] + tools.TOOLS_FOR_EXTENSIONS
    tool_set = set()
    extension_set = set()
    for extensions, tools_ in all_tools:
        tool_set.update(tools_)
        extension_set.update(extensions)
    print(f"""\
# Eris Codebase Monitor

## Summary

Eris maintains an up to date set of reports for every file in a codebase.

## Installation

#### Debian / Ubuntu / Fedora / Arch / Alpine

[Install](https://docs.astral.sh/uv/getting-started/installation/) uv first if you don't have it.

Use uv to install eris:

```bash
uv tool install --python 3.14 git+https://forgejo.tail556789.ts.net/ahamilton/eris@2026.8.3
```

Then use eris to install all the tools it uses:

```bash
eris --install-all-tools
```

Then to run:

```bash
eris
eris-webserver <project>  # Or a simple web interface.
```

## Tools

File types({len(extension_set)-1}) | Tools({len(tool_set)})
----------:| -----""")
    for extensions, tools_ in all_tools:
        print("%s | %s" % (" ".join("." + extension for extension in extensions),
                           " • ".join(f"[{tool.__name__}]({tool.url})" for tool in tools_)))


if __name__ == "__main__":
    main()