From 97a6f6854659e236c9bc6f5f422f853700743e56 Mon Sep 17 00:00:00 2001 From: Claire Duvallet Date: Fri, 8 Sep 2023 17:17:18 -0400 Subject: [PATCH 1/2] Update label and links --- source/tutorials/conda-tutorial.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/source/tutorials/conda-tutorial.rst b/source/tutorials/conda-tutorial.rst index db59f87..339a4f5 100644 --- a/source/tutorials/conda-tutorial.rst +++ b/source/tutorials/conda-tutorial.rst @@ -1,11 +1,11 @@ Publishing your plugin on conda ############################### -Once you've `made your first qiime2 -plugin `__, you'll need to build it into a +Once you've made your first qiime2 +plugin (:doc:`/tutorials/first-plugin-tutorial`), you'll need to build it into a conda package and upload it to anaconda.org so others can easily install it. This tutorial is intended for first-time python developers trying to -put their QIIME 2 plugin into conda. +put their QIIME 2 plugin into conda. (If you are updating a pre-existing plugin, you can also check out the :doc:`/tutorials/updating-plugin` tutorial.) In this tutorial, I'll be drawing on examples from my experience developing the `q2-perc-norm `__ and `q2-dbotu `__ plugins. @@ -25,13 +25,15 @@ Quickstart .. code-block:: bash conda-build recipe/ - -c https://conda.anaconda.org/qiime2/label/r2022.8 + -c https://conda.anaconda.org/qiime2/label/r2023.7 -c https://conda.anaconda.org/conda-forge -c https://conda.anaconda.org/bioconda -c defaults --override-channels --python 3.8 + Make sure to update the label and python versions with your current versions. + 4. Install your package locally. .. code-block:: bash @@ -54,7 +56,7 @@ Documentation Before you start, here is some useful documentation to be aware of. The conda tutorials are short and informative. You should read the -`tutorial using ``skeleton`` `__ +`tutorial using skeleton `__ first, then and then the tutorial on `building a package from scratch `__, regardless of which way you plan to build your package. @@ -231,6 +233,8 @@ To build a qiime2 plugin, the command you have to run is actually: --override-channels --python 3.8 +You can/should update the qiime2 version and your python version, if applicable. + Install your package ~~~~~~~~~~~~~~~~~~~~ From 46eb7a130f57043490fdc73417a9bcd882efdfcc Mon Sep 17 00:00:00 2001 From: Liz Gehret Date: Thu, 16 Nov 2023 13:22:05 -0700 Subject: [PATCH 2/2] maint: updating QIIME 2 & pkg versions for consistency --- source/tutorials/conda-tutorial.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/source/tutorials/conda-tutorial.rst b/source/tutorials/conda-tutorial.rst index 339a4f5..bb63db3 100644 --- a/source/tutorials/conda-tutorial.rst +++ b/source/tutorials/conda-tutorial.rst @@ -226,7 +226,7 @@ To build a qiime2 plugin, the command you have to run is actually: :: conda-build recipe/ - -c https://conda.anaconda.org/qiime2/label/r2022.8 + -c https://conda.anaconda.org/qiime2/label/r2023.7 -c https://conda.anaconda.org/conda-forge -c https://conda.anaconda.org/bioconda -c defaults @@ -257,13 +257,13 @@ Something like: :: - /Users/claire/anaconda/conda-bld/osx-64/q2_perc_norm-1.0-py35_0.tar.bz2 + /Users/claire/anaconda/conda-bld/osx-64/q2_perc_norm-v2-py36_0.tar.bz2 So you can try to install the package directly from this: :: - conda install --offline /Users/claire/anaconda/conda-bld/osx-64/q2_perc_norm-1.0-py35_0.tar.bz2 + conda install --offline /Users/claire/anaconda/conda-bld/osx-64/q2_perc_norm-v2-py36_0.tar.bz2 Ok, looks like that worked! Woooo! @@ -282,8 +282,8 @@ https://dev.qiime2.org/latest/quickstart/) .. code:: bash - wget https://raw.githubusercontent.com/qiime2/environment-files/master/latest/staging/qiime2-latest-py35-osx-conda.yml - conda env create -n qiime2-dev-condatest --file qiime2-latest-py35-osx-conda.yml + wget https://raw.githubusercontent.com/qiime2/environment-files/master/latest/staging/qiime2-latest-py38-osx-conda.yml + conda env create -n qiime2-dev-condatest --file qiime2-latest-py38-osx-conda.yml conda activate qiime2-dev-condatest Then, you can just type in ``qiime`` to your command line and see if (1) @@ -360,7 +360,7 @@ documentation