What is this?

Javascript utilities for working with rock climbing grades.

$3

Sport & Traditional climbing
- [x] Yosemite Decimal System
- [x] French
- [x] UIAA
- [x] Ewbanks
- [x] Saxon
- [x] Brazilian

Bouldering
- [x] Vermin (V-scale)
- [x] Fontainebleau

Aid
- [x] A# & C#
- [ ] Aid with mandatory free climbing (5.8 A0, etc)

Ice
- [x] Winter Ice (WI#)
- [x] Alpine Ice (AI#)

$3

Code contributions are most welcome!

$3

Join us on Discord.

---

$3

#### Install the package

Using NPM

``
npm install @openbeta/sandbag
`
Using Yarn
`
yarn add @openbeta/sandbag
`

#### Sample Usage

- Convert Grades to Scores

`javascript
import { French, YosemiteDecimal } from '@openbeta/sandbag'

const score = French.getScore('8a') // Output [ 84, 85 ]

// Support slash grade
const slashGradeScore=French.getScore('7c+/8a') // Output [ 83, 84 ]

// Accept +/- modifier
const plusGrade= YosemiteDecimal.getScore('5.12+') // Output [ 79, 80 ]
`

- Convert Scores to Grades

`javascript
import { Font } from '@openbeta/sandbag'

// Single score provided
Font.getGrade(80) // Output '7c'

// Support a range of scores
Font.getGrade([79,81]) // Output'7b+/7c'

`

- Validate Grading Scales
` javascript
import { VScale , Font }from '@openbeta/sandbag'

console.log('Is 6A a V Scale?',VScale.isType('6A')) // Output false
console.log('Is 6A a Font Scale?',Font.isType('6A')) // Output true

`

- Convert Grades Across Scales

` javascript
import {convertGrade , GradeScales }from '@openbeta/sandbag'

const ydsInFrench=convertGrade('5.11a',GradeScales.YDS,GradeScales.FRENCH) // Output '6b+/6c'

const fontInVScale=convertGrade('6a',GradeScales.FONT,GradeScales.VSCALE) //OutPut 'V3'

// Conversions across different disciplines are not allowed
const sportToBoulder=convertGrade('5.11a',GradeScales.YDS,GradeScales.VSCALE)
// Output: Scale: Yosemite Decimal System doesn't support converting to Scale: V Scale
// ''
`

- Get Gradeband

`javascript
import { Ewbank } from '@openbeta/sandbag'

Ewbank.getGradeBand('10') // Output: 'beginner'
Ewbank.getGradeBand('30') // Output: 'expert'
Ewbank.getGradeBand('6a') // Output: Unexpected grade format: 6a for grade scale Ewbank 'unknown'

`
- Compare Grades

`javascript

import { French, YosemiteDecimal } from '@openbeta/sandbag'

const harder = French.getScore('8a') // Output: [ 84, 85 ]
const easier = YosemiteDecimal.getScore('5.13a') // Output: [ 82, 83 ]

console.log('Is 8a harder than 5.13a?',harder > easier) // Output: true

`

See unit tests for more examples.

$3

`
yarn install
yarn test
`

#### Generating Test Coverage Report

To generate a test coverage report using Jest run the following command in your terminal:

`sh
npx jest --coverage
`

If you're using macOS, you can directly access the coverage report in your browser by opening the following URL:

`
file:///Users//sandbag/coverage/lcov-report/index.html
`

#### How to publish a new release to NPM
Submit a PR with commit message [npm publish]`

$3

- Nathan Musoke
- Viet Nguyen

$3

MIT

Contributors ✨

Thanks goes to these wonderful people (emoji key):

AntoineM 💻 🤔	Kendra Gibbons 💻 🤔	MichaelDimmitt 💻	Clinton Lunn 💻	Darren Lew 💻 🤔	Klaus 💻 🤔	Nathan Musoke 💻 🤔
Talia Aleyna Hortac 💻	Yun Ji 💻 🤔	Josh Zimmerman 💻	John Roberts 💻 🤔	Joey Marino 💻 🤔	Iacami Gevaerd 💻 🤔

This project follows the all-contributors specification. Contributions of any kind welcome!