Add interface to nwm_client_new for Azure Blob Storage

[jarq6c]

Adds a concrete interface for accessing NWM files on Azure Blob Storage.

Additions

AzureFileCatalog class for discovering files on Azure Blob Storage. Inherits from NWMFileCatalog.

Removals

• None

Changes

• Added example to README.md.

Testing

1. Added basic tests commensurate with other concrete implementations of NWMFileCatalog.

Notes

• None

Todos

• None

Checklist

• PR has an informative and human-readable title
• PR is well outlined and documented. See #12 for an example
• Changes are limited to a single goal (no scope creep)
• Code can be automatically merged (no conflicts)
• Code follows project standards (see CONTRIBUTING.md)
• Passes all existing automated tests
• Any change in functionality is tested
• New functions are documented (with a description, list of inputs, and expected output) using numpy docstring formatting
• Placeholder code is flagged / future todos are captured in comments
• Reviewers requested with the Reviewers tool ➡️

[jarq6c]

Closes #235

[christophertubbs]

My only 'complaint' is the name of the package nwm_client_new, but that's out of scope for this. Everything is well documented and the code is easy to read. If I were to be ruthless, I'd say that line 80 in AzureFileCatalog.py might read better as:

    return [
        os.path.join(self.server, url)
        for url in list(blobs)
        if must_contain in url
    ]

instead of

    return [self.server+b for b in list(blobs) if must_contain in b]

That's only if I try my hardest to be picky.

A+

[jarq6c]

Thanks @christophertubbs !

[jarq6c]

Passes all tests. Heeded advice for more explicit URL handling, but used our own handling from _restclient.

[jarq6c]

Deployed: https://pypi.org/project/hydrotools.nwm-client-new/7.3.0/