Metadata-Version: 2.1
Name: json-feeder
Version: 0.1.1
Summary: A framework for generate JSON feeds
Home-page: https://github.com/sesh/feeder
Author: Brenton Cleeland
License: MIT License
Project-URL: Issues, https://github.com/sesh/feeder/issues
Project-URL: CI, https://github.com/sesh/feeder/actions
Project-URL: Changelog, https://github.com/sesh/feeder/releases
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: thttp

_This framework is **highly experimental** and **very likely** to change significantly_

# feeder

`feeder` is a small Python framework that helps you generate [JSON Feeds][jsonfeed.org].


## Usage

For now, install from Github with:

```
python3 -m pip install json-feeder
```

Create a directory for your new feed, the start the new feed with:

```
feeder startfeed
```

`settings.py`, `feed.py` and `generate.py` files will be created for you.

The following settings can be configured:

- `FEED_FUNCTION` the path to a Python function that will return a list of `FeedItem` objects.
- `FEED_FILENAME` the filename on disk for the feed. If you are using Github Pages then this should be set to `out/feed.json` or similar.
- `FEED_URL` the remote url of the feed. This is used to ensure that duplicates are not added to the file.
- `FEED_TITLE` is the title of your feed.
- `FEED_HOMEPAGE_URL` is the homepage of your feed, this is optional.
- `FEED_ICON` is a url to an icon that feed readers might use for your feed. Very optional.
- `FEED_VERSION` defaults to "1.1" and represents the JSON Feed version.
- `FEED_MAX_ITEMS` limits the number of items to output in the feed. Default is 100.

Once you've updated your `settings.py` and created your `FEED_FUNCTION` you can generate your feed by running:

```
python3 generate.py
```


### Runnings Tests

```
python3 -m unittest discover
```


  [jsonfeed.org]: https://www.jsonfeed.org
