{"id":23372761,"url":"https://github.com/kdroidfilter/hebrewnumeralslibrary","last_synced_at":"2025-04-10T17:41:50.190Z","repository":{"id":256266812,"uuid":"854676682","full_name":"kdroidFilter/HebrewNumeralsLibrary","owner":"kdroidFilter","description":"This library provides a set of Kotlin functions for working with Hebrew numerals (Gematria) and Talmudic page references (Daf Gemara). It's designed to be easy to use and integrate into your projects, offering convenient extensions for String and Int types.","archived":false,"fork":false,"pushed_at":"2025-03-21T11:31:35.000Z","size":137,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-21T12:31:30.752Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://kdroidfilter.github.io/HebrewNumeralsLibrary/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kdroidFilter.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-09T15:33:30.000Z","updated_at":"2025-03-21T11:31:31.000Z","dependencies_parsed_at":"2024-09-09T23:28:49.907Z","dependency_job_id":"b136add4-fe64-43d3-841a-723bdc5c76e2","html_url":"https://github.com/kdroidFilter/HebrewNumeralsLibrary","commit_stats":null,"previous_names":["kdroidfilter/hebrewnumeralslibrary"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdroidFilter%2FHebrewNumeralsLibrary","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdroidFilter%2FHebrewNumeralsLibrary/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdroidFilter%2FHebrewNumeralsLibrary/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdroidFilter%2FHebrewNumeralsLibrary/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdroidFilter","download_url":"https://codeload.github.com/kdroidFilter/HebrewNumeralsLibrary/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248262192,"owners_count":21074261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-12-21T16:49:30.188Z","updated_at":"2025-04-10T17:41:50.184Z","avatar_url":"https://github.com/kdroidFilter.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📚 Hebrew Numerals Library\n\nThis library provides a set of Kotlin functions for working with Hebrew numerals (Gematria) and Talmudic page references (Daf Gemara). It's designed to be easy to use and integrate into your projects, offering convenient extensions for String and Int types.\n\n## ✨ Features\n\n- Convert Hebrew strings to their numerical Gematria value\n- Convert integers to Hebrew numeral representations (Gematria)\n- Convert Daf Gemara (Talmudic page) numbers to their string representations\n- Multiplatform support: can be used on JVM, JS, and Native platforms\n- Exportable as both a native library and a JavaScript library\n- **Available on Maven Central**\n\n## 📥 Importing the Library\n\nYou can import the library directly from Maven Central.\n\n### 🛠️ Gradle\n\nAdd the following to your `build.gradle.kts`:\n\n```kotlin\nrepositories {\n    mavenCentral()\n}\n\ndependencies {\n    implementation(\"io.github.kdroidfilter:hebrewnumerals:0.2.4\")\n}\n```\n\n## 🚀 Usage\n\n### 🔢 Converting Hebrew String to Gematria\n\n```kotlin\nval hebrewYear = \"תשפִד\"\nval gematriaValue = hebrewYear.toGematria()\nprintln(gematriaValue) // Outputs: 784\n```\n\n### 📜 Converting Integer to Daf Gemara\n\n```kotlin\nval dafNumber = 5\nval dafGemara = dafNumber.toDafGemara()\nprintln(dafGemara) // Outputs: \"ד.\"\n\nval dafNumber2 = 6\nval dafGemara2 = dafNumber2.toDafGemara()\nprintln(dafGemara2) // Outputs: \"ד:\"\n```\n\n### 🔠 Converting Integer to Hebrew Numeral\n\n```kotlin\nval year = 5784\nval hebrewYear = year.toHebrewNumeral()\nprintln(hebrewYear) // Outputs: \"ה'תשפ\"ד\"\n\n// Without Geresh symbols\nval hebrewYearNoSymbols = year.toHebrewNumeral(includeGeresh = false)\nprintln(hebrewYearNoSymbols) // Outputs: \"התשפד\"\n```\n\n### 🔤 Converting Integer to English Daf Gemara\n\n```kotlin\nval dafNumber = 5\nval englishDaf = dafNumber.toEnglishDafGemara()\nprintln(englishDaf) // Outputs: \"4a\"\n\nval dafNumber2 = 6\nval englishDaf2 = dafNumber2.toEnglishDafGemara()\nprintln(englishDaf2) // Outputs: \"4b\"\n```\n\n## 🌐 Multiplatform Support\n\nThis library is built with Kotlin Multiplatform, allowing it to be used across different platforms:\n\n- JVM: For use in Java and Android applications\n- JS: For use in web applications and Node.js environments\n- Native: For use in iOS, desktop, and other native applications\n\n## 📖 API Reference\n\n### `String.toGematria(): Int`\n\nConverts a Hebrew string to its corresponding numerical value (Gematria).\n\n### `Int.toDafGemara(): String`\n\nConverts an integer representing a Daf Gemara (Talmudic page) to its corresponding string representation.\n\n### `Int.toHebrewNumeral(includeGeresh: Boolean = true): String`\n\nConverts an integer to its corresponding Hebrew numeral representation (Gematria).\n\n### `Int.toEnglishDafGemara(): String`\n\nConverts an integer representing a Daf Gemara to its English representation with \"a\" (Aleph) and \"b\" (Bet).\n\n## 🛠️ Exporting as Native or JS Library\n\nThe library can be easily exported for use in various environments:\n\n- As a native library: Can be compiled and used in C, Objective-C, and Swift projects\n- As a JavaScript library: Can be used directly in web applications or Node.js projects\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdroidfilter%2Fhebrewnumeralslibrary","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdroidfilter%2Fhebrewnumeralslibrary","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdroidfilter%2Fhebrewnumeralslibrary/lists"}