Aiida-pseudo

This release comes with the addition of the first version of the [online documentation](https://aiida-pseudo.readthedocs.io/en/latest/).
It is now also possible to construct a new pseudopotential data node from a filepath on disk instead of a bytestream.

Features
- CLI: add support for units to `family show` [[97]](https://github.com/aiidateam/aiida-pseudo/pull/97)
- `PseudoPotentialData`: allow `str` or `Path` for `source` argument [[98]](https://github.com/aiidateam/aiida-pseudo/pull/98)

Improvements
- `RecommendedCutoffMixin`: improve error messages [[86]](https://github.com/aiidateam/aiida-pseudo/pull/86)
- Docs: add first version of documentation [[88]](https://github.com/aiidateam/aiida-pseudo/pull/88)

This release contains two changes that would be breaking, but the `CutoffsFamily` was only intended for testing purposes and the command line option flag changes are unlikely to break code.
Therefore this is released as a patch version such that plugins do not have to update their version requirements which are often limited to a particular minor version.

Features
- CLI: allow folder on disk for `aiida-pseudo install family` and add the `-P/--pseudo-type` option to define the pseudopotential data plugin to be used [[80]](https://github.com/aiidateam/aiida-pseudo/pull/80)

Changes
- Rename `CutoffsFamily` to `CutoffsPseudoPotentialFamily` [[82]](https://github.com/aiidateam/aiida-pseudo/pull/82)
- CLI: change the `-F/--archive-format` to `-f/--archive-format` and `-T/--family-type` to `-F/--family-type` [[80]](https://github.com/aiidateam/aiida-pseudo/pull/80)

The biggest change in this release is the addition of explicit units for the recommended cutoffs of pseudopotential families that support it.
Before, the cutoffs always had to be specified in electronvolt, but now it is possible to define cutoffs in a variety of energy units.
To facilitate that a single family can specify multiple sets of cutoffs at different "stringencies", with optionally different units, the interface of `RecommendedCutoffMixin.set_cutoffs` had to be changed.
Instead of taking a dictionary with the cutoffs for all stringencies in one go, it now takes the dictionary of cutoffs for a single stringency.
Pseudopotential families that were installed with `aiida-pseudo>=0.4.0` should continue to function properly.

Features
- `RecommendedCutoffMixin`: store the unit of cutoffs in extras [[57]](https://github.com/aiidateam/aiida-pseudo/pull/57)
- Add the `VpsData` plugin [[44]](https://github.com/aiidateam/aiida-pseudo/pull/44)
- CLI: add recommended cutoffs to `aiida-pseudo show` [[52]](https://github.com/aiidateam/aiida-pseudo/pull/52)
- CLI: add the `aiida-pseudo family cutoffs set` command [[55]](https://github.com/aiidateam/aiida-pseudo/pull/55)[[#67]](https://github.com/aiidateam/aiida-pseudo/pull/67)[[#71]](https://github.com/aiidateam/aiida-pseudo/pull/71)
- CLI: add `--download-only` option to automatic family install commands [[65]](https://github.com/aiidateam/aiida-pseudo/pull/65)
- Docs: add troubleshooting section to the `README.md` [[60]](https://github.com/aiidateam/aiida-pseudo/pull/60)

Fixes
- `PseudoDojoFamily`: skip repo files with unsupported extension [[48]](https://github.com/aiidateam/aiida-pseudo/pull/48)

Changes
- CLI: move `aiida-pseudo show` to `aiida-pseudo family show` [[58]](https://github.com/aiidateam/aiida-pseudo/pull/58)
- `RecommendedCutoffMixin`: set only one stringency with `set_cutoffs` [72]](https://github.com/aiidateam/aiida-pseudo/pull/72)

Refactoring
- CLI: refactor download code from automated install commands [[69]](https://github.com/aiidateam/aiida-pseudo/pull/69)

Changes
- PseudoDojo: remove support for `v0.3` and enable fixed `v0.4` families [[39]](https://github.com/aiidateam/aiida-pseudo/pull/39)
- PseudoDojo: enable PAW based families and lower dual factors [[42]](https://github.com/aiidateam/aiida-pseudo/pull/42)

This release significantly changes the design of the plugin with respect to how families are subclassed for different pseudopotential formats.
Before, for each pseudopotential format, one would have to create a specific subclass of a family for it to be able to store pseudopotentials of the type.
This quickly becomes untractable as more _real_ different family types are added, such as the SSSP and Pseudo Dojo.
Instead, each family class can now support any number of pseudopotential types.
However, each instance of a family will only ever host a single type of pseudopotential and not multiple.

Features
- Add support for the Pseudo Dojo pseudopotential families [[26]](https://github.com/aiidateam/aiida-pseudo/pull/26)
- Add support for the JTH XML format through the `JthXmlData` data plugin [[37]](https://github.com/aiidateam/aiida-pseudo/pull/37)
- `PseudoPotentialData`: add the `get_or_create` classmethod [[33]](https://github.com/aiidateam/aiida-pseudo/pull/33)
- `PseudoPotentialData`: add the `get_entry_point_name` classmethod [[30]](https://github.com/aiidateam/aiida-pseudo/pull/30)
- `PseudoPotentialFamily`: allow support of multiple pseudo formats [[31]](https://github.com/aiidateam/aiida-pseudo/pull/31)
- Update the `README.md` with simple instructions and design explanation [[34]](https://github.com/aiidateam/aiida-pseudo/pull/34)

Changes
- `RecommendedCutoffMixin`: require electronvolts for cutoffs [[35]](https://github.com/aiidateam/aiida-pseudo/pull/35)
- `PseudoPotentialFamily`: add the `pseudo_type` extra [[31]](https://github.com/aiidateam/aiida-pseudo/pull/31)
- Remove pseudo potential family plugins for specific file formats [[31]](https://github.com/aiidateam/aiida-pseudo/pull/31)

Fixes
- `PseudoPotentialFamily`: override `remove_nodes` and `clear` [[29]](https://github.com/aiidateam/aiida-pseudo/pull/29)

Features
- Add support for Python 3.9 [[21]](https://github.com/aiidateam/aiida-pseudo/pull/21)
- `RecommendedCutoffMixin`: add concept of stringency levels [[20]](https://github.com/aiidateam/aiida-pseudo/pull/20)
- `UpfData`: automatically parse the Z valence from the file [[24]](https://github.com/aiidateam/aiida-pseudo/pull/24)

Fixes
- `PseudoPotentialFamily.get_pseudos`: maintain structure kind names [[20]](https://github.com/aiidateam/aiida-pseudo/pull/20)