Stow

Added

- Metadata to the package deployment (information viable on pypi)
- Add `StorageClass` selection and functionality to the `Amazon` manager. This allows stow to put objects into s3 in not just in the 'STANDARD' type.

Changed

- Updated documentation

---

Added

- `SSH` manager implementation and tests, giving stow the ability to communicate and connect with remote machines via the ssh protocol. Information about how to use the new `Manager` can be found in the [documentation](/managers)
- `Manager` and `Artefact` seralisation has been introduced
- `Directory` has method `empty` added to its interface
- `ArtefactNotAvailable` exception added as a new possible situation for `SSH`. Occurs when

Changed

- `Manager` objects not extend a `ManagerInterface` object which can be used by `Artefacts` for syntax highlighting.
- `_get`, `_getBytes`, `_cp`, `_mv`, `_rm` have had their interfaces changed to take the object (that must exist) instead of its manager path.
- Allowed `Manager` implementations to return `Artefact` objects during functions that typically create new objects to avoid subsequent calls to fetch object information already known to the implementation.
- Updated documentation

Fixed

- Issue with `join` not resolving separators correctly when on windows.
- Fixed a hidden issue with `_updateArtefactObjects` - which was possibly not correctly identifying the right artefact to correct

---

Added

- Added `name` and `extension` to the stateless interface of the package

---

Added

- Added all os.path methods to the manager and stateless interface
- Updated and created documentation for the interface
- Expanded test coverage
- Tested system on windows
- Made artefacts compatible with path-like interfaces (made the path-like)

---

Added

- `Manager.sync` added which pushes files in the source directory to the target if and only if they are more recently edited than the artefacts on the remote

Changes
- `Manager.mkdir` has been extended with two defaulted arguments for ignoreExists and overwrite. Ignore exists allows multiple calls to mkdir on the same directory do nothing and not affect contents of the target. OVerwrite allows the multiple calls to take place but for the content to be removed (makes an empty directory)
- Added `__version__` to the init of stow and made setup reference this version

Fixes
- Files created by the local filesystem didn't include their timezone which meant comparison with s3 files not possible. They have been set aware and time is in UTC.

---

Fixed
- stateless join function which was enforcing its own protocol handle. This has been passed to the manager
- s3 manager now correctly handles s3 protocols when joining paths

Added
- tests for the stateless and manager join functions

---