republisher/demo/README.md

# Demo

This directory shows the runtime-config setup with a dedicated config file.

## Local Run

From the repo root:

```shell
uv run repub --config demo/repub.toml
```

Because `out_dir` in [`demo/repub.toml`](/home/abel/src/guardianproject/anynews/republisher-redux/demo/repub.toml) is relative, output is written under `demo/out/`.

## Files

- `repub.toml`: example runtime config with feed definitions, slugs, and Scrapy overrides
- `fixtures/local-feed.rss`: simple local RSS fixture for `file://` feed testing

## Local File Feed

`repub` already accepts absolute `file://` feed URIs. To point it at the demo fixture, generate an absolute URI like this from the repo root:

```shell
python3 -c 'from pathlib import Path; print(Path("demo/fixtures/local-feed.rss").resolve().as_uri())'
```

Then use that value in a config entry:

```toml
[[feeds]]
name = "Local Demo"
slug = "local-demo"
url = "file:///absolute/path/to/demo/fixtures/local-feed.rss"
```

## Pygea Import

`repub` can also load additional `[[feeds]]` entries from a separate TOML file,
such as `pygea`'s generated `manifest.toml`:

```toml
feed_config_files = ["/absolute/path/to/pygea/feed/manifest.toml"]
```