Add tests and documentation.

[weaverba137]

This PR:

• Fixes add more desi.json documentation desihub/desiBackup#3
  • All items explicitly requested are tested for. The existing manifest file has been extended to include not only the files backed up, but the total size as well (of the files, which will be close to, but not exactly equal t the size of a tar file).
• Fixes add etc/desi.json validation tools desihub/desiBackup#4
  • Regular expressions and idioms are documented.
  • Additional examples.

Note that the documentation part isn't actually done yet. I just needed a PR number to refer to.

[coveralls]

Coverage increased (+0.6%) to 41.612% when pulling d1482dc on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-4.8%) to 36.226% when pulling 2a3a747 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-4.8%) to 36.226% when pulling 2a3a747 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-4.8%) to 36.226% when pulling 2a3a747 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-5.07%) to 35.985% when pulling c8be3dc on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-0.1%) to 40.951% when pulling 71cf771 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-0.4%) to 40.653% when pulling fc39275 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-0.4%) to 40.653% when pulling ef18d78 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-0.4%) to 40.653% when pulling ef18d78 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage decreased (-0.4%) to 40.653% when pulling ef18d78 on tests-and-docs into 7852e65 on master.

[weaverba137]

@sbailey, could you take a look at this, in particular the new documentation, the files configuration.rst and using.rst?

[weaverba137]

PS, I'm still working on some unit tests, but the documentation should be ready to go.

[coveralls]

Coverage increased (+2.2%) to 43.297% when pulling 03d819d on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage increased (+2.2%) to 43.297% when pulling d978f62 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage increased (+5.3%) to 46.377% when pulling 3c0a184 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage increased (+5.3%) to 46.377% when pulling 1c0b636 on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage increased (+5.3%) to 46.377% when pulling 509383f on tests-and-docs into 7852e65 on master.

[coveralls]

Coverage increased (+9.7%) to 50.725% when pulling 9c9c31f on tests-and-docs into 7852e65 on master.

[weaverba137]

I'm satisfied with the current state of the unit tests, so this can be merged after the documentation is reviewed.

[coveralls]

Coverage increased (+9.7%) to 50.725% when pulling 911e70e on tests-and-docs into 7852e65 on master.

[sbailey]

Thank you. This is good, especially the configuration documentation and the explained idioms. Go ahead and merge when ready.