Update dev env instructions

[luizirber]

Close #2793

• Add pixi, first mentioned in notes on developer installation, as of aug 2023 #2707 (comment)
• Use tabs in docs to help to point out only one option is needed
• Default recommendation is conda, add dev.yml with dev dependencies

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 86.75%. Comparing base (d516811) to head (7f0b404).

Additional details and impacted files

@@           Coverage Diff           @@
##           latest    #2990   +/-   ##
=======================================
  Coverage   86.75%   86.75%           
=======================================
  Files         137      137           
  Lines       15920    15920           
  Branches     2728     2728           
=======================================
  Hits        13811    13811           
  Misses       1800     1800           
  Partials      309      309           

Flag	Coverage Δ
hypothesis-py	25.40% <ø> (ø)
python	92.37% <ø> (ø)
rust	62.63% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ctb]

I mean I've loved pixi, the little bit I've used it; but do we really want to switch dev instructions over to it?

[ctb]

(I guess I'm not immediately seeing a big reason. But I am happy to be convinced :)

[luizirber]

I mean I've loved pixi, the little bit I've used it; but do we really want to switch dev instructions over to it?

We have the drift on install instructions (as pointed in #2707) because what we document is not quite we run in CI.

I was going for setting up pixi and using the pixi.lock file to also install a conda environment if pixi is not available, but conda-lock and pixi diverged on the lockfile format. Maybe they will converge back, but for now they are incompatible.

It is still fine to have conda instructions and say "look at the [dependencies] section in pixi.toml and run conda create with that", but we start getting into a lot of duplicate dependency definitions... We could have an environment.yml and keep it in sync with pixi.toml too, if that's easier.

(I guess I'm not immediately seeing a big reason. But I am happy to be convinced :)

I like pixi because it is so much easier to install than conda, and doesn't mess with shell env vars. And if you're in a system that has conda installed but doesn't allow extra software installation, you can still conda install -c conda-forge pixi and have it available.

Drawback is that conda is much more stable, pixi has been moving pretty quickly and might be hard to keep up (but we do have CI setup in this PR).

It boils down to which is the easiest one to teach and get started, pixi seems easier because it's one file to download and pixi shell to get started, but conda can be more general-purpose and transfer better to other situations?

All that said, I don't use conda or pixi for sourmash development, so better to someone that does use to chime in 🙃

[luizirber]

How the tabs look like: https://sourmash--2990.org.readthedocs.build/en/2990/developer.html

[ctb]

I love it!