v1.3.0 Rata Mutata

No, this is not a Hakuna Matata mashup song featuring Ratatouille.

It's the answer to a problem I've had recently as I've been re-reading my 4- and 5-stars from the past: some of them aren't as great this time around, in which case I edit to 3 stars. But I still want to know that these poor demoted books used to be the bees' knees to me, so I've been recording the rating change in a note on each item.

I've been following a consistent format for these notes in order to make them easily findable, e.g. Downgraded rating from 4 to 3. So I figured it would make sense to parse them into the data.

So now rating_change is in the parsed output, along with a date if you want to date your rating changes. (By default, they are dated to the most recent end or start date of the item.)

And so my reading page has a new "demoted list" at the very bottom!

Along with that, previous ratings can be used as a filter in stats queries. Want to know which genres you've changed the most from a 4 or a 5? Run reading "<path to your reading.csv>" "count by genre previous-rating>=4". I thought about adding another filter for specifying rating changes up or down, but decided it was unnecessary because all of my rating changes are downward, except for a single one… which I later reversed 🙃

v1.2.0 Ludic

Fun is here! In an effort to disconnect from the crazy world of tech, I've started spending time with books that are games (RPGs and gamebooks), so I've added support for the "game" format, using the dice emoji: 🎲.

Also, TODO is now an alias of the planned date syntax (??).

See the changelog on the few bugs that have been fixed since 1.1.0 in patch versions, for which I don't create releases on GitHub.

v1.1.0 Uniplexed

The reading command no longer opens an interactive CLI environment for running stats queries. Instead, a single query is passed as a CLI argument. ANSI colors are also avoided except for error messages.

These changes, along with bugfixes to the CLI output, make the reading command more usable and a bit closer to the Unix philosophy.

v1.0.0 "Abiding"

With only a few bug fixes and minor additions over the past two years, it's time for the 1.0 release! See the changelog for details.

v0.9.0 "Tattarrattat stats, tattarrattat"

The statistics CLI is here! As well as the Reading::stats method, which provides data that can fill out lovely charts such as those on the new Reading Stats page on my personal site.

To read all about the statistics capabilities, see the relevant section in the README.

I now consider the Reading gem to be feature-complete, so I expect the 1.0 release will just involve bug fixes and cleanup.

v0.8.0 "Reified"

The parsed output is now a bit more convenient, with the addition of the Item wrapper and Filter for filtering the output.

The motivation here was to reduce the amount of janky code in my site for transforming item hashes into data ready for display on my site's "Reading" page. With these added conveniences, my sites' load_reading_list.rb has been reduced from 300 lines down to 94 lines ;🎉 Not only is it shorter, but it's also more robust because Item and Filter are covered by tests.

For next steps, I still have my eye on a v0.9.0 that adds a statistics CLI as in my old project Readstats, but for now I'll take a long break while I work on other things: improving my aforementioned site, chipping away at my Learn Ruby list, and (last but definitely not least) becoming a parent in a couple months 👶

v0.7.0 "Omnicolumnar"

Parsing of the History column has arrived! This means all the columns are now parsed.

What is the History column, you ask? Read all about it in the CSV Format Guide.

Also, the parsing API has improved. See the "Usage" section of the README.

The next pre-release will make the parsed output more convenient. Then I might do another pre-release to add a reading statistics CLI, as in my former project Readstat (from which the Reading gem was originally extracted).

v0.6.0 "Ahistorical"

Getting closer to 1.0! The only major feature that is missing is parsing of the History column, described in the docs.

I might do one more pre-release after that to make the output more convenient. For example, there's currently no easy way to sum up your reading amounts to find out how much you've read, because amounts are either Integers (for pages) or Strings (in "hh:mm" for time) which can't be added. So I could make a Length class that can represent either pages or time, and can be added together with any other Length. Anyway, I'll redo my site and update my CLI reading statistics app Readstat, which both use the Reading gem, and along the way I'll notice ways of making the output more convenient.