The identity of feeds and episodes: a feed by its podcast:guid, or the one that the UUIDv5 scheme of podcast:guid derives from its URL, and an episode by its guid, on both platforms.
The identity of feeds and episodes: a feed by its podcast:guid, or the one that the UUIDv5 scheme of podcast:guid derives from its URL, and an episode by its guid, on both platforms.
(episode-id feed url item)The id of item in the feed at url: [key item-guid], with the key
of feed-key.
The id of `item` in the `feed` at `url`: [key item-guid], with the key of feed-key.
(feed-guid feed url)The identity that feed gives itself at url: its podcast:guid when
that's a UUID, or else the one that the podcast namespace derives from
url.
The identity that `feed` gives itself at `url`: its podcast:guid when that's a UUID, or else the one that the podcast namespace derives from `url`.
(feed-key feed url)The key that a library keeps feed under, as with-key gives it, or
else its feed-guid at url.
The key is settled at the first fetch and stays, while the feed-guid changes with a new podcast:guid, or with the URL of a feed that has none.
The key that a library keeps `feed` under, as with-key gives it, or else its feed-guid at `url`. The key is settled at the first fetch and stays, while the feed-guid changes with a new podcast:guid, or with the URL of a feed that has none.
(format-episode-id [feed-guid item-guid :as id])The episode id as one string, e.g. for a key or a native bridge, or
nil when it isn't a pair of strings. Each part is percent-encoded and
they're joined by a colon, so any guid round-trips, e.g.
917393e3-…:https%3A%2F%2Fexample.com%2Fep%201.
It isn't for the path of a URL, since many servers refuse a slash there even when it's percent-encoded. Name the item there by its short-hash.
The episode `id` as one string, e.g. for a key or a native bridge, or nil when it isn't a pair of strings. Each part is percent-encoded and they're joined by a colon, so any guid round-trips, e.g. 917393e3-…:https%3A%2F%2Fexample.com%2Fep%201. It isn't for the path of a URL, since many servers refuse a slash there even when it's percent-encoded. Name the item there by its short-hash.
(from-url url)The podcast:guid of a feed at url whose author didn't declare one.
The podcast:guid of a feed at `url` whose author didn't declare one.
(guid-name url)The feed url as the podcast namespace seeds a podcast:guid with, which
is without its scheme and trailing slashes.
The feed `url` as the podcast namespace seeds a podcast:guid with, which is without its scheme and trailing slashes.
(guid? s)Whether s looks like a UUID, and so like a podcast:guid.
Whether `s` looks like a UUID, and so like a podcast:guid.
(item-guid item)The identity of item: its guid, or else its enclosure URL, as Apple's
A Podcaster's Guide to RSS has it.
The identity of `item`: its guid, or else its enclosure URL, as Apple's A Podcaster's Guide to RSS has it.
(keyed? feed)Whether feed has the key that a library keeps it under, as with-key
gives it, so that feed-key needs no URL.
Whether `feed` has the key that a library keeps it under, as with-key gives it, so that feed-key needs no URL.
(matching-items items h)The items of items, in order, whose guids have a SHA-1 that starts
with the hex digits h, as short-hash gives them. That's one item, or
more when h is too short to tell them apart.
The items of `items`, in order, whose guids have a SHA-1 that starts with the hex digits `h`, as short-hash gives them. That's one item, or more when `h` is too short to tell them apart.
(normal-url url)The url in lower case without credentials, scheme or trailing
slashes, so that two forms of one feed or media URL are equal.
The `url` in lower case without credentials, scheme or trailing slashes, so that two forms of one feed or media URL are equal.
(parse-episode-id s)The episode id that format-episode-id gives the string s for, or nil
when s is no such string.
The episode id that format-episode-id gives the string `s` for, or nil when `s` is no such string.
The UUID namespace that every podcast:guid is derived in.
The UUID namespace that every podcast:guid is derived in.
(short-hash s)(short-hash s n)The first n hex digits of the SHA-1 of the item guid s, by default
7, e.g. to name an episode of a show in the path of a URL, where the
guid itself may not go.
The first `n` hex digits of the SHA-1 of the item guid `s`, by default 7, e.g. to name an episode of a show in the path of a URL, where the guid itself may not go.
(uuid-v5 ns name)The name-based UUID (RFC 9562, section 5.5) of the string name in the
UUID namespace ns, as a lower-case string.
The name-based UUID (RFC 9562, section 5.5) of the string `name` in the UUID namespace `ns`, as a lower-case string.
(with-key feed k)The feed with k in its metadata as the key that a library keeps it
under, which episode-id takes over what the feed says now.
The `feed` with `k` in its metadata as the key that a library keeps it under, which episode-id takes over what the feed says now.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |