Usage: kaboom [-f ] [-n]  []
Manage an on-disk Atom feed's entries.
Options:
-f, --file        path to Atom feed
-n, --no-op       do not write anything to disk, but still show what would
change
--help            display usage information
Commands:
add               Add entries to the feed. If content is supplied, its
source is assumed to be the same URI as id.
meta              Manage the metadata of the Atom feed, for example the
authors or the title. Arguments provided here will set or
modify the metadata. After any modifications (with no flags,
no modifications will be made), the new state of the feed's
metadata will be dumped to standard output (by default in a
human-friendly format, but JSON is planned later).
prune             Remove entries from the Atom feed, and by default send the
deleted entries to a reject file for backup/archival
purposes.
version           Display version info and exit.

Usage: kaboom add   [-s 
] [-c ] [-T ] [-L ] [-a ] [-A ] [-d ] [-D ]
Add entries to the feed. If content is supplied, its source is assumed to be the same URI as id.
Positional Arguments:
id                the URI of the entry
title             the title of the entry
Options:
-s, --summary     a short summary of the entry
-c, --content     the full content of the entry
-T, --content-type
the content type of content; must be "text", "html",
"xhtml", or a MIME type. ignored if content is not
provided.
-L, --content-language
the language of content, often a code like en-us. ignored
if content is not provided
-a, --author-names
name(s) of authors associated with this entry. can be
specified multiple times, must have the same number of names
and emails.
-A, --author-emails
email address(es) of authors associated with this entry. can
be specified multiple times, must have the same number of
names and emails.
-d, --published-at
the date and time, in RFC3339 format, when the entry was
published
-D, --updated-at  the date, in RFC3339 format, when the entry was most
recently updated
--help            display usage information

Usage: kaboom meta [-t ] [-u ] [-r ] [-R] [-i ] [-I] [-l ] [-L] [-s ] [-S] [-G]
Manage the metadata of the Atom feed, for example the authors or the title. Arguments provided here will set or modify the metadata. After any modifications (with no flags, no modifications will be made), the new state of the feed's metadata will be dumped to standard output (by default in a human-friendly format, but JSON is planned later).
Options:
-t, --title       a human-readable title for the feed (this must be set the
first time kaboom meta is called on a new file)
-u, --uri         a unique and permanent URI for this feed, often the URL at
which it is accessed (this must be set the first time
kaboom meta is called on a new file)
-r, --rel-link    a web page URL related to the feed, can be provided multiple
times. suffixes in the format of [rel=XXX], [type=XXX],
[title=XXX], and [lang=XXX] are all supported, for example:
https://www.meteo.gc.ca/
rss/marine/06100_f.xml[rel=alternate][lang=fr-ca][type=application/
atom+xml][title=Détroit de Haro - Météo maritime -
Environnement Canada]
-R, --remove-links
ensure that no links (except rel=self) are set in this
feed's metadata. if rel_link are still provided, this flag
will instead clear all existing links, and add those links
as the only links in the metadata.
-i, --icon        an optional URL pointing to a small image providing visual
identification for the feed (think like a favicon)
-I, --remove-icon ensure that the icon field is not set in this feed's
metadata. ignored if icon is still provided.
-l, --logo        an optional URL pointing to a larger image providing visual
identification for the feed (this is distinct from icon
above!)
-L, --remove-logo ensure that the logo field is not set in this feed's
metadata. ignored if logo is still provided.
-s, --subtitle    an optional string to provide a human-readable description
or subtitle for the feed
-S, --remove-subtitle
ensure that the subtitle field is not set in this feed's
metadata. ignored if subtitle is still provided.
-G, --no-generator
do not insert the generator block into the metadata output
(which discloses within the feed that kaboom was used to
generate it)
--help            display usage information

Usage: kaboom prune  [-R ] [-r ] [-s ] [-d ]
Remove entries from the Atom feed, and by default send the deleted entries to a reject file for backup/archival purposes.
Positional Arguments:
count             number of entries to keep in the feed, as sorted by
strategy, described below
Options:
-R, --no-reject   skip sending pruned entries to the reject_file, described
below
-r, --reject-file path to an Atom file (which will be created if it does not
yet exist, sharing all metadata from the original feed) to
store pruned entries for backup/archival purposes. by
default, this will be  with any .xml extension
removed, and then ".rej.xml" added
-s, --strategy    strategy used in pruning entries from the feed: published,
for date of publication, updated, for date of most recent
update, or since- date, which preserves only those articles
authored since since-date, described below
-d, --since       a date and time, in RFC3339 format, used only with the
since-date strategy, described above
--help            display usage information