Skip to content

Commit

Permalink
docs: Add conda-forge install instructions and badge to README (#262)
Browse files Browse the repository at this point in the history
* Add conda-forge install instructions to README.
* Add badge for conda-forge distribution to README.
   - c.f. https://anaconda.org/conda-forge/hepdata-lib
   - Use prefix.dev's view as it provides much better user information.
  • Loading branch information
matthewfeickert authored May 10, 2024
1 parent e88fd41 commit f086d85
Showing 1 changed file with 9 additions and 2 deletions.
11 changes: 9 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1217998.svg)](https://doi.org/10.5281/zenodo.1217998)
[![PyPI version](https://badge.fury.io/py/hepdata-lib.svg)](https://badge.fury.io/py/hepdata-lib)
[![conda-forge version](https://img.shields.io/conda/vn/conda-forge/hepdata-lib.svg)](https://prefix.dev/channels/conda-forge/packages/hepdata-lib)
[![Actions Status](https://github.com/HEPData/hepdata_lib/workflows/tests/badge.svg)](https://github.com/HEPData/hepdata_lib/actions)
[![Coverage Status](https://codecov.io/gh/HEPData/hepdata_lib/graph/badge.svg?branch=main)](https://codecov.io/gh/HEPData/hepdata_lib?branch=main)
[![Documentation Status](https://readthedocs.org/projects/hepdata-lib/badge/)](http://hepdata-lib.readthedocs.io/)
Expand All @@ -18,7 +19,13 @@ This code works with Python 3.6, 3.7, 3.8, 3.9, 3.10, 3.11 or 3.12.
It is highly recommended you install `hepdata_lib` into a [virtual environment](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/).

```shell
pip install hepdata_lib
python -m pip install hepdata_lib
```

Alternatively, install from [conda-forge](https://anaconda.org/conda-forge/hepdata-lib) using a `conda` ecosystem package manager:

```console
conda install --channel conda-forge hepdata-lib
```

If you are not sure about your Python environment, please also see below how to use `hepdata_lib` in a Docker or Apptainer container.
Expand Down Expand Up @@ -86,4 +93,4 @@ Make sure that you have `ROOT` in your `$PYTHONPATH` and that the `convert` comm
A ROOT installation is not strictly required if your input data is not in a ROOT format, for example, if
your input data is provided as text files or `scikit-hep/hist` histograms. Most of the `hepdata_lib`
functionality can be used without a ROOT installation, other than the `RootFileReader` and `CFileReader` classes,
and other functions of the `hepdata_lib.root_utils` module.
and other functions of the `hepdata_lib.root_utils` module.

0 comments on commit f086d85

Please sign in to comment.