Add Python module. Issue #47

[greebie]

This PR replaces the function cell in the notebook with a python module and revises the function to work with the Notebook class.

A few notes:

• If you make changes to the class, the notebook will not recognize the changes until the notebook is restarted. (Ask me about the fun of debugging in this environment.) I assume this will not be a problem once the module is finalized.
• The network graphs currently use very little of the new module (only the gephi filename). I would like some advice on whether we should resolve that here or in a different PR (e.g. when we split the notebooks).
• The module contains a class called Notebook that takes a collection ID, a folder name and **kwargs that sets the various variables. One potential issue is if a config has a var that's not in the class. Could use some advice about whether an error is fine or if we should handle things more gracefully.
• For the most part, this just means that where before we said get_text(), instead we now use nb.get_text().
• The previous set-up used default parameters i.e. fun(x, min_length="2") - now it just uses the MINIMUM_WORD_LENGTH variable, so

  nb.MINIMUM_WORD_LENGTH = 2
  nb.fun(x)

• There is some ambiguity re: style as we have ALL_CAPS in the notebook to handle madlibs, but inside a class this is poor Python style for non-constants. An easy solution is just to use lower() on instantiation for the class, but whatever other advice anyone has is welcome.

[greebie]

Marked this draft for general comments first. Once the approach is okay, I'll mark it ready for review and we can work through some of the details.

[greebie]

I think the latest commit fixes the above review fixes. I also included mention that help(nb.function_name()) will provide instructions. Once I get word from @ianmilligan1 that the approach is okay, I will take this out of draft and work on fine tuning.

[greebie]

Thanks @ianmilligan1 @ruebot what are your thoughts on unit tests here? I can build them, but am not sure if they belong in the auk-notebooks folder.

[ruebot]

Out of scope for now. We'll cross that bridge when we publish it in it's own repo.

[greebie]

Latest commit should be ready to go. Moving this out of draft.