{"id":32283608,"url":"https://github.com/gradr-dev/gradr_lib","last_synced_at":"2026-02-21T08:02:43.649Z","repository":{"id":56831703,"uuid":"448540060","full_name":"gradr-dev/gradr_lib","owner":"gradr-dev","description":" Utilities for converting and detecting climbing grading systems","archived":false,"fork":false,"pushed_at":"2022-07-17T10:11:27.000Z","size":446,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-23T01:26:45.142Z","etag":null,"topics":["bouldering","calculator","climbing","climbing-grades","converter","detect","grades","grading-system","lead","sport-climbing"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gradr-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-16T11:55:36.000Z","updated_at":"2025-04-14T13:41:18.000Z","dependencies_parsed_at":"2022-08-28T21:02:19.501Z","dependency_job_id":null,"html_url":"https://github.com/gradr-dev/gradr_lib","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gradr-dev/gradr_lib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gradr-dev%2Fgradr_lib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gradr-dev%2Fgradr_lib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gradr-dev%2Fgradr_lib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gradr-dev%2Fgradr_lib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gradr-dev","download_url":"https://codeload.github.com/gradr-dev/gradr_lib/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gradr-dev%2Fgradr_lib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29676987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T06:23:40.028Z","status":"ssl_error","status_checked_at":"2026-02-21T06:23:39.222Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bouldering","calculator","climbing","climbing-grades","converter","detect","grades","grading-system","lead","sport-climbing"],"created_at":"2025-10-23T01:20:29.458Z","updated_at":"2026-02-21T08:02:43.643Z","avatar_url":"https://github.com/gradr-dev.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \n  \u003cimg src=\"https://raw.githubusercontent.com/gradr-dev/gradr_lib/main/.github/media/banner.png\" height=\"250\"\u003e\n  \n  Convert climbing grading systems with a really simple interface.\n\n  [![Pub Version](https://img.shields.io/pub/v/gradr_lib?style=flat-square)](https://pub.dev/packages/gradr_lib)\n  \n\u003c/div\u003e\n\n---\n\n\u003e WORK IN PROGRESS, use at your own risk.\n\nHave you ever needed to convert from one grading system to another? and had to implement the calculations by yourself? `gradr_lib` offers utilities for converting climbing grading systems with a really simple interface so you don't have to reinvent the wheel.\n\nThe library was initial going to be developed for the [Gradr App]() I've also created, but thought it might be cool to make it open-source and let the community use it and hopefully help improve it too!\n\n\u003e Gradr does all it can to make sense of the differences and inconsistencies between grading systems, so take note that converting from one grading system to another might not always be acurate. \n\u003e You can take a look at [this]() writup on how gradr handles this. Feel free to offer any advice or help in this regard!\n\n## Features\n* Grading systems\n  * [x] V-Scale\n  * [x] Font\n  * [x] French\n  * [x] YDS\n  * [ ] South africa\n  * [ ] Brazil\n  * [ ] UK\n  * [ ] IRCRA\n  * [ ] UIAA\n  * ...\n* [x] Conversion between grading systems\n* [x] Grading system detector\n\n## Getting started\n\nTo install the package check the install [guide](https://pub.dev/packages/gradr_lib/install)\n\n## Usage\n\n### Convert between Grading Systems\nHere is an example on how to convert from V-Scale to Font scale and viceversa, using GradeCalculator:\n\n```dart\nfinal vToFont = GradeCalculator(\n    systemA: verminGradeSystem,\n    systemB: fontGradeSystem,\n);\n\n// Convert from grading system A (vScale) to system B (fontScale)\nvToFont.atob(\n    vScale.findByName('V3')\n);\n\n// \u003e 6B\n\n// Convert from grading system B (fontScale) to system A (vScale)\nvToFont.btoa(\n    fontScale.findByName('6B')\n);\n// \u003e V3\n```\n\nYou can also convert using the from-to interface, as follows:\n\n```dart\nfontGradeSystem.convert('v3').from(verminGradeSystem); // 6b\nfontGradeSystem.convert('6b').to(verminGradeSystem);   // v3\n```\n\n### Detect Grading System\nGradr also offers a utility to detect grading systems. \n```dart\nfinal detector = GradeSystemDetector(\n    detectors: [\n      VScaleGradeDetector(),\n      FontGradeDetector(),\n      FontGradeDetector(),\n    ],\n);\n\nGradeDetectorResult detectedResult = detector.detect(grade);\n\n// A list of posible grading systems is returnes in the result\ndetectedResult.detectedSystems;\n\n// It also returns a list of \"formalized\" grades (instance of Gradr Grade class).\ndetectedResult.formalizedGrades;\n\n// It also returns the original input\ndetectedResult.originalInput;\n```\n* Note that the GradeSystemDetector allows you to pass in the detectors you need, and/or custom detectors.  \n\n\n\n## Need Gradr for another platform?\n\nYou might be in luck, at gradr we're trying to offer the libraries for most common languages and frameworks. Take a look and see if the one you need is already done. \n* [x] Dart\n* [ ] JavaScript\n  * [ ] React\n  * [ ] Angular\n  * [ ] Ionic\n  * [ ] Vue\n* [ ] Java\n* [ ] PHP\n\n\u003e If your platform or language is missing, feel free to file an issue and we will try to implement it. Or if you feel like it and have the time, you can contact us to help build it, we love that kind of stuff! :heart:\n\n## Additional info\n\nThere are some examples [here](https://github.com/nombrekeff/gradr_lib/tree/main/example) and [here](https://github.com/nombrekeff/gradr_lib/tree/main/test).\n\nIf you encounter any problems or fancy a feature to be added please head over to the GitHub [repository](https://github.com/nombrekeff/gradr_lib/) and [drop an issue](https://github.com/nombrekeff/gradr_lib/issues/new).\n\n## Support the project\n\nI tend to open source anything I can, and love to help people that might need help with the project. \n\nIf you are using this project and are happy with it or just want to encourage me to continue creating stuff, there are few ways you can do so:\n\n- Starring and sharing the project 🚀\n- Reporting bugs 🐛\n- Sending feedback\n- Or even coding :P\n\nThanks! ❤️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgradr-dev%2Fgradr_lib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgradr-dev%2Fgradr_lib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgradr-dev%2Fgradr_lib/lists"}