https://github.com/ilias-ant/pyclimb

A library to easily convert climbing route grades between different grading systems.
https://github.com/ilias-ant/pyclimb

climbing converter pip

Last synced: 4 months ago
JSON representation

A library to easily convert climbing route grades between different grading systems.

• Host: GitHub
• URL: https://github.com/ilias-ant/pyclimb
• Owner: ilias-ant
• License: mit
• Created: 2022-01-23T18:16:38.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2022-12-24T12:35:54.000Z (about 2 years ago)
• Last Synced: 2024-04-25T22:22:23.067Z (9 months ago)
• Topics: climbing, converter, pip
• Language: Python
• Homepage: https://pypi.org/project/pyclimb
• Size: 44.9 KB
• Stars: 5
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: .github/SECURITY.md

Awesome Lists containing this project

README

        
# pyclimb

[![PyPI](https://img.shields.io/pypi/v/pyclimb?color=blue&label=PyPI&logo=PyPI&logoColor=white)](https://pypi.org/project/pyclimb/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pyclimb?logo=python&logoColor=white)](https://www.python.org/) [![codecov](https://codecov.io/gh/ilias-ant/pyclimb/branch/main/graph/badge.svg?token=2H0VB8I8IH)](https://codecov.io/gh/ilias-ant/pyclimb) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/ilias-ant/pyclimb/ci.yml?branch=main)](https://github.com/ilias-ant/pyclimb/actions/workflows/ci.yml) 

[![PyPI - Wheel](https://img.shields.io/pypi/wheel/pyclimb?color=orange)](https://www.python.org/dev/peps/pep-0427/)

A library to easily convert climbing route grades between different grading systems.

In rock climbing, mountaineering, and other climbing disciplines, climbers give a grade to a climbing route or boulder problem, intended to describe concisely the difficulty and danger of climbing it. Different types of climbing (such as sport climbing, bouldering or ice climbing) each have their own grading systems, and many nationalities developed their own, distinctive grading systems.

## Install

The recommended installation is via `pip`:

```bash

pip install pyclimb

```

## Usage

```python

import pyclimb

pyclimb.convert(grade='6a+', grade_system='French', to='YDS')

// '5.10b'

pyclimb.convert(grade='9c', grade_system='French', to='YDS')

// '5.15d'

pyclimb.convert(grade='5.12a', grade_system='YDS', to='French')

// '7a+'

```

## Note

This is a package under active development. Currently, only the following conversions are being supported:

- [sport climbing] conversion between French grading system and the YDS ([Yosemite Decimal System](https://en.wikipedia.org/wiki/Yosemite_Decimal_System)).

Other conversions and different types of climbing will be included soon. These changes may drastically change the user-facing API, so do consult the semantic versioning of this package before upgrading to a newer version.

## How to contribute

If you wish to contribute, [this](CONTRIBUTING.md) is a great place to start!

## License

Distributed under the [MIT License](LICENSE).