1# CHANGELOG
2
3## v34 - 2026-04-11
4
5Improve the URL-handling in `chives.fetch`; in particular improve the case where you call `fetch_url(url, params)` with a URL that already has some query parameters or a fragment.
6
7## v33 - 2026-04-10
8
9Remove the `fetch_image` function from `chives.fetch`; either use `fetch_url` or `download_image`.
10
11## v32 - 2026-04-01
12
13Add a `download_image` function to `chives.fetch`.
14
15## v31 - 2026-03-31
16
17Remove the `hyperlink` dependency.
18
19## v30 - 2026-03-30
20
21Add a `chives.fetch` package which has some helper functions for making HTTP requests using the standard library.
22
23## v29 - 2026-03-29
24
25Add a `chives.text` package which exports a `smartify()` function for applying SmartyPants-style formatting to a string -- adding curly quotes and smart dashes.
26
27## v28 - 2026-03-28
28
29Remove the httpx dependency in `chives.urls`.
30
31## v27 - 2026-02-28
32
33Don't reuse the browser fixture between tests.
34
35## v26 - 2026-02-28
36
37Extract the `browser` fixture as a standalone fixture rather than binding it to a class, so it can be reused across multiple test suites.
38
39## v25 - 2026-02-28
40
41Change the type of `StaticSiteTestSuite.pages_to_check` from `set` to `list` to ensure consistent ordering of parametrised tests.
42
43Fix a bug when testing URLs with query parameters.
44
45## v24 - 2026-02-28
46
47In `StaticSiteTestSuite`, add testing with [Playwright](https://playwright.dev) that checks static websites render correctly.
48
49**Breaking change:** the site root must now be specified as a classmethod `get_site_root()` rather than a `site_root` fixture.
50
51## v23 - 2026-02-20
52
53Change the format of `VideoEntity.subtitles` to be a list of `SubtitlesEntity`, so a single video can have multiple subtitles.
54
55## v22 - 2026-01-11
56
57Remove the `start_radio` parameter in `clean_youtube_url()`.
58
59## v21 - 2025-12-22
60
61Add a method `dates.now()` to return the current time in the timestamp used by all my static sites.
62
63## v20 - 2025-12-10
64
65Use concurrency in `test_no_videos_are_av1`, which can make it faster for
66larger media collections.
67
68## v19 - 2025-12-09
69
70Allow passing both `width` and `height` as part of `ThumbnailConfig`, to constrain a thumbnail to a bounding box.
71
72## v18 - 2025-12-08
73
74Expose `get_tint_colour()` as a public function from `chives.media`.
75
76## v17 - 2025-12-07
77
78Account for [EXIF orientation](https://alexwlchan.net/til/2024/photos-can-have-orientation-in-exif/) when getting the width/height of image entities.
79
80## v16 - 2025-12-06
81
82Don't require defining `list_tags_in_metadata()` in projects that don't use tags.
83
84## v15 - 2025-12-06
85
86Fix a bunch of lints from ruff; remove an unused dependency.
87
88## v14 - 2025-12-06
89
90Improve the error message on failed assertions in `StaticSiteTestSuite`.
91
92## v13 - 2025-12-06
93
94Mark a couple more folders/files as ignored in `StaticSiteTestSuite`.
95
96## v12 - 2025-12-06
97
98Add checks for fuzzy tag matching to `StaticSiteTestSuite`.
99
100## v11 - 2025-12-06
101
102Add a new class `StaticSiteTestSuite` which runs my standard set of tests for a static site, e.g. checking every file is saved, checking timestamps use the correct format.
103
104## v10 - 2025-12-05
105
106Add a new `is_url_safe()` function for checking if a path can be safely used in a URL.
107
108## v9 - 2025-12-05
109
110This adds three models to `chives.media`: `ImageEntity`, `VideoEntity`, and `ImageEntity`.
111These have all the information I need to show an image/video in a web page.
112
113It also includes functions `create_image_entity` and `create_video_entity` which construct instances of these models.
114
115## v8 - 2025-12-04
116
117Add the `is_mastodon_host()` function.
118
119## v7 - 2025-12-03
120
121Add the `parse_tumblr_post_url()` function.
122
123## v6 - 2025-12-03
124
125Add the `parse_mastodon_post_url()` function.
126
127## v5 - 2025-12-01
128
129When calling `reformat_date()`, ensure all dates are converted to UTC.
130
131## v4 - 2025-11-29
132
133Rename `chives.timestamps` to `chives.dates`.
134
135## v3 - 2025-11-29
136
137Add the `clean_youtube_url()` function and `urls` extra.
138Rearrange the package structure slightly, to allow optional dependencies.
139
140## v2 - 2025-11-28
141
142Add the `is_av1_video()` function for [detecting AV1-encoded videos](https://alexwlchan.net/2025/detecting-av1-videos/).
143
144## v1 - 2025-11-28
145
146Initial release. Included functions:
147
148* `date_matches_any_format`
149* `date_matches_format`
150* `find_all_dates`
151* `reformat_date`