Beetcamp

Added

- For those who use `beets >= 1.5.0`, singleton tracks are now enriched with similar metadata
to albums (depending on whether they are found of course):

- `album`: **Artist - Track** usually
- `albumartist`
- `albumstatus`
- `albumtype`: `single`
- `catalognum`
- `country`
- `label`
- `medium`, `medium_index`, `medium_total`
- release date: `year`, `month`, `day`

- Album names get cleaned up. The following, if found, are removed:

- Artist name (unless it's a singleton track)
- Label name
- Catalog number
- Strings
- **Various Artists**
- **limited edition**
- **EP** (only if it is preceded by a space)
- If any of the above are preceded/followed by **-** or **|** characters, they are
removed together with spaces around them (if they are found)
- If any of the above (except **EP**) are enclosed in parentheses or square brackets,
they are also removed.

Examples:

Album - Various Artists -> Album
Various Artists - Album -> Album
Album EP -> Album
[Label] Album EP -> Album
Artist - Album EP -> Album
Label | Album -> Album
Album (limited edition) -> Album

- Added _recommended_ installation method in the readme.
- Added tox tests for `beets < 1.5` and `beets > 1.5` for python versions from 3.6 up to
3.9.
- Sped up re-importing bandcamp items by checking whether the URL is already available
before searching.
- Parsing: If track's name includes _bandcamp digital (bonus|only) etc._, **bandcamp** part gets
removed as well.

Changed

- Internal simplifications regarding `beets` version difference handling.

Fixed

- Parsing: country/location name parser now takes into account punctuation such as in
`St. Louis` - it previously ignored full stops.

Added

- Until now, the returned fields have been limited by what's available in
_search-specific_ `TrackInfo` and `AlbumInfo` objects. The marks the first attempt of
adding information to _library_ items that are available at later import stages.

If the `comments` field is empty or contains `Visit <artist-page>`, the plug-in
populates this field with the release description. This can be reverted by including it
in a new `exclude_extra_fields` list option.

Deprecated

- `lyrics` configuration option is now deprecated and will be removed in one of the
upcoming releases (0.8.0 / 0.9.0 - before stable v1 goes out). If lyrics aren't needed,
it should be added to the `exclude_extra_fields` list.

Fixed

- The `albumartist` that would go missing for the `beets 1.5.0` import stage has now safely returned.

Fixed

- For the case when a track or an album is getting imported through the id / URL mode, we now
check whether the provided URL is a Bandcamp link. In some cases parsing foreign URLs
results in decoding errors, so we'd like to catch those URLs early. Thanks arogl for
spotting this.

Fixed

- Bandcamp updated their html format which broke track duration parsing. This is now fixed
and test html files are updated.

- Fixed track name parser which would incorrectly parse a track name like `24 hours`,
ignoring the numbers from the beginning of the string.

- Locations that have non-ASCII characters in their names would not be identified
(something like _Montreal, Québec_) - now the characters are converted and
`pycountry` does understand them.

- Fixed an edge case where an EP would be incorrectly misidentified as an album.

Updated

- Catalog number parser now requires at least two digits to find a good match.

Updated

- Country name overrides for _Russia_ and _The Netherlands_ which deviate from the
official names.
- Track names:
- If _digital_ and _exclusive_ are found in the name, it means it's digital-only.
- Artist / track splitting logic now won't split them on the dash if it doesn't have
spaces on both sides.
* `track_alt` field may now contain numerical values if track names start with them.
Previously, only vinyl format was supported with the `A1` / `B2` notation.

Added

- Previously skipped, not-yet-released albums are now handled appropriately. In such
cases, `albumstatus` gets set to **Promotional**, and the release date will be a future
date instead of past.

Fixed

- Handle a sold-out release where the track listing isn't available, which would otherwise
cause a KeyError.

- Catalog number parser should now forget that cassette types like **C30** or **C90**
could be valid catalog numbers.

Updated

- Brought dev dependencies up-to-date.