feat: Add flag to allow adding an new anime to the histfile

[0WN463]

Pull Request Template

Type of change

• [ ] Bug fix
• [x] Feature
• [ ] Documentation update

Description

A use case that I frequently have is that I want to add an anime to my histfile so that I can watch it later. This PR adds a flag -a/--add which allows us to simply add the anime without playing the episode.

For these animes, we use unwatched to signify the "ep_no" field in the histfile. When parsing the histfile, we select the first episode in the episode list

This flag only significant in the case of using -c later. Standard operations of ani-cli have no interaction with this flag.

PS: I tried running shfmt, but it is flagging a lot of changes in the latest master

Checklist

• [x] any anime playing

• [x] bumped version

• [ ] next, prev and replay work
• [x] -c history and continue work
• [ ] -d downloads work
• [ ] -s syncplay works
• [ ] -q quality works
• [ ] -v vlc works
• [x] -e select episode works
• [ ] -S select index works
• [ ] -r range selection works
• [ ] --skip ani-skip works
• [ ] --skip-title ani-skip title argument works
• [ ] --no-detach no detach works
• [ ] --dub and regular (sub) mode both work

• [ ] all providers return links (not necessarily on a single anime, use debug mode to confirm)

• [x] -h help info is up to date
• [x] Readme is up to date
• [x] Man page is up to date

Additional Testcases

• The safe bet: One Piece
• Episode 0: Saenai Heroine no Sodatekata ♭
• Unicode: Saenai Heroine no Sodatekata ♭
• Non-whole episodes: Tensei shitara slime datta ken (ep. 24.5, ep. 24.9)

[port19x]

I kinda get it, but I don't think this feature is desirable to a broader audience

[0WN463]

Why not though?

We do have the -D, --delete flag, which only deletes the history, so we do consider user flows which uses the history. The delete flag only makes sense in the history-based flow, so it means we are support this flow.

So I feel that it makes sense to bolster the history-based flow by adding this feature.

[Derisis13]

This feature is not that bad, but the implementation was way too many loc. @port19x would you be against it if it were below 15 lines total?

[port19x]

We most definitely support history based flow, but I believe it's unwise to let ani-cli feature-creep into a local anilist equivalent. We can add it if derisis sees value, especially if we get it down to say +20 loc

[71zenith]

+1 This is a bit too niche of a feature, i doubt anyone would be deep into this workflow.