Skip to content

Commit

Permalink
Merge pull request #1777 from ssurbhi560/add-more-info-about-grayskull
Browse files Browse the repository at this point in the history
Add more information about Grayskull in the docs
  • Loading branch information
beckermr authored Jun 23, 2022
2 parents 0e32b37 + f9515ac commit 6253160
Showing 1 changed file with 21 additions and 6 deletions.
27 changes: 21 additions & 6 deletions src/maintainer/adding_pkgs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,28 @@ Generating the recipe

There are, currently, three ways to generate a recipe:

#. If it is an R package from `CRAN <https://cran.r-project.org/>`_, kindly
1. If it is an R package from `CRAN <https://cran.r-project.org/>`_, kindly
start by using the `conda-forge helper script for R recipes <https://github.com/bgruening/conda_r_skeleton_helper>`_ instead.
Then if necessary, you can make manual edits to the recipe.
#. If it is a python package, you can generate the recipe as a starting point with ``grayskull``.
Use ``conda install -c conda-forge grayskull`` to install ``grayskull``, followed by ``grayskull pypi your_package_name`` to generate the recipe. Note that you do *not* necessarily have to use ``grayskull``, and the
recipes produced by ``grayskull`` might need to be reviewed and edited. Read more about ``grayskull`` and how to use it `here <https://github.com/conda-incubator/grayskull#introduction>`__.
#. If it's none of the above, generate a recipe with the help of `the example recipe <https://github.com/conda-forge/staged-recipes/tree/master/recipes/example>`_ in the `staged-recipes repository <https://github.com/conda-forge/staged-recipes>`_ and modify it as necessary.

2. If it is a python package, you can generate the recipe as a starting point with ``grayskull``.

.. note::

`Grayskull <https://github.com/conda-incubator/grayskull>`_ is an automatic conda recipe generator. The goal of this project is to generate concise recipes
for conda-forge and eventually replace conda skeleton. Presently, Grayskull can generate recipes for Python packages available on PyPI and also those not published on PyPI and only available as GitHub repositories.

Installation and usage of ``grayskull``:

- Create a new environment using : ``conda create --name MY_ENV``. Replace ``MY_ENV`` with the environment name.
- Activate this new environment : ``conda activate MY_ENV``.
- Run ``conda install -c conda-forge grayskull`` to install ``grayskull``.
- Followed by ``grayskull pypi --strict-conda-forge YOUR_PACKAGE_NAME`` to generate the recipe. Replace ``YOUR_PACKAGE_NAME`` with the package name.

You do *not* necessarily have to use ``grayskull``, and the recipes produced by ``grayskull`` might need to be reviewed and edited.
Read more about ``grayskull`` and how to use it `here <https://github.com/conda-incubator/grayskull#introduction>`__.

3. If it's none of the above, generate a recipe with the help of `the example recipe <https://github.com/conda-forge/staged-recipes/tree/master/recipes/example>`_ in the `staged-recipes repository <https://github.com/conda-forge/staged-recipes>`_ and modify it as necessary.

Your final recipe should have no comments (unless they're actually relevant to the recipe, and not generic instruction comments), and follow the order in the example.

Expand Down Expand Up @@ -146,7 +161,7 @@ Maintainer role
The maintainer's job is to:

- Keep the feedstock updated by merging eventual maintenance :term:`PR`\ s from conda-forge's bots.
- Keep the feedstock on par with new releases of the source package by
- Keep the feedstock on par with new releases of the source package by:

- Bumping the version number and checksum.
- Making sure that the feedstock's requirements stay accurate.
Expand Down

0 comments on commit 6253160

Please sign in to comment.