WIP: Setup poetry in pyproject.toml

[weiji14]

Description of proposed changes

Initializing poetry to see if it can speed up the install step in our Continuous Integration.

conda works in serial and can be a bit slow, while poetry can install things in parallel. The idea here is to use conda only for non-Python packages (i.e. GMT and make), and poetry for Python dependencies (e.g. numpy, pandas, etc).

Notes:

• Use poetry install --no-dev to get only the minimum required dependencies for PyGMT
• Use poetry install to get both minimum and development dependencies (e.g. pytest, black, codecov, etc)
• Use poetry install --no-dev --extras docs to install minimum and dependencies for building docs (e.g. sphinx, etc)
• Use poetry install --extras docs to get all of the above

Addresses #584, may help with #690

Reminders

• Run make format and make check to make sure the code follows the style guide.
• Add tests for new features or tests that would have caught the bug that you're fixing.
• Add new public functions/methods/classes to doc/api/index.rst.
• Write detailed docstrings for all functions/methods.
• If adding new functionality, add an example to docstrings or tutorials.

Slash Commands

You can write slash commands (/command) in the first line of a comment to perform
specific operations. Supported slash commands are:

• /format: automatically format and lint the code
• /test-gmt-dev: run full tests on the latest GMT development version

[seisman]

Just in case you don't notice it: poetry doesn't work well with setuptools_scm, so the version is v0.3.1, not v0.3.1.dev100+xxxxx.

[weiji14]

Just in case you don't notice it: poetry doesn't work well with setuptools_scm, so the version is v0.3.1, not v0.3.1.dev100+xxxxx.

Yeah I realize that this hardcoding is bad. There's https://github.com/mtkennerly/poetry-dynamic-versioning but doesn't look like a very official solution.

To be honest, this PR isn't intended to replace setup.py just yet. Just wanted to see if mixing conda and poetry might shave a few minutes off the CI test time.

[weiji14]

We've got #1033 so this PR probably isn't needed anymore, but I'll keep this open for a while as it'll be nice to cherry-pick the poetry stuff in pyproject.toml from this PR into somewhere else to solve #690 or something else :)

[weiji14]

Closing this PR. May reopen it in the future if there's any interest in using poetry 🙂