Javascript utilities for working with rock climbing grades.
Sport & Traditional climbing
Bouldering
Aid
Ice
Code contributions are most welcome!
Join us on Discord.
Using NPM
npm install @openbeta/sandbag
Using Yarn
yarn add @openbeta/sandbag
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 ]
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'
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
// ''
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'
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.
yarn install
yarn test
To generate a test coverage report using Jest run the following command in your terminal:
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/<userName>/sandbag/coverage/lcov-report/index.html
Submit a PR with commit message [npm publish]
MIT
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!