Ditch makefile in favour of poe tasks in pyproject.toml

[nat-n]

I've been working on a task runner that I think based on the discussion in #129 would be a good fit for this project :)

I also took a stab at #154 to keep things coherent. I'm happy to iterate if there are things we'd prefer to differently.

Poe is a task runner that works well with poetry.

Key features

• easy, succinct, and flexible toml based config
• all tasks are executed via poetry run unless already inside a poetry shell
• for tasks defined as a single command, all additional arguments are passed to that command
• executing the poe tool without args displays help including available tasks
• supports tab completion for zsh

Summary of changes in this PR

1. The new [tool.poe.tasks] section in the pyproject.toml functionally replicates the old make file.

• Everything is implemented as simple cmd tasks that just basically just run the given content as a subprocess, except clean which is defined as a sequence of the two subtasks.
• the two subtasks of clean are prefixed with _ which means they're hidden and not directly runnable, though this is not necessary if we think using them directly would be useful
• removed install task since I believe poetry makes it redundant

2. Update CONTRIBUTING.md for the poetry + poe based workflow
3. I noticed tox is mentioned in CONTRIBUTING.md but not configured, so I added it as a dev dependency and added config for it in pyproject.toml
4. the default version of pip uses pytoml which is deprecated and broken, so to be able to use fuller toml syntax in the pyproject.toml I had to modify the ci script to upgrade pip

Other Features

Note that poe also supports:

• shell tasks which can use posix shell features such as multiple commands, pipes, boolean operators, background jobs, etc (but require a posix shell to be available so won't always work on windows)
• script tasks which reference a python function exactly like poetry scripts

It's also possible to define new tasks using other toml syntax forms like:

• inline tables

  run = { script = "copier.cli:CopierApp.run", help = "run the copier cli"}

• sub-tables

  [tool.poe.tasks.check-all]
  help = "Run all checks"
  sequence = [
    "check",
    "coverage"
  ]

Try it out:

pip install poethepoet
poe test

[yajo]

Thanks!