{"id":42849291,"url":"https://github.com/pranamphd/digipin-kotlin","last_synced_at":"2026-01-30T12:00:50.246Z","repository":{"id":333457748,"uuid":"1135477405","full_name":"pranamphd/digipin-kotlin","owner":"pranamphd","description":"Kotlin implementation of the DIGIPIN geo-coded addressing system.","archived":false,"fork":false,"pushed_at":"2026-01-28T13:38:47.000Z","size":151,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-29T04:37:03.094Z","etag":null,"topics":["address","algorithm","digipin","gis","india","jar","java","kotlin","library","maven","pincode","zipcode"],"latest_commit_sha":null,"homepage":"https://central.sonatype.com/artifact/phd.pranam/digipin","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/pranamphd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-16T06:40:02.000Z","updated_at":"2026-01-28T15:14:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pranamphd/digipin-kotlin","commit_stats":null,"previous_names":["pranamphd/digipin-kotlin"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pranamphd/digipin-kotlin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranamphd%2Fdigipin-kotlin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranamphd%2Fdigipin-kotlin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranamphd%2Fdigipin-kotlin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranamphd%2Fdigipin-kotlin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pranamphd","download_url":"https://codeload.github.com/pranamphd/digipin-kotlin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranamphd%2Fdigipin-kotlin/sbom","scorecard":{"id":1241968,"data":{"date":"2026-01-19T17:54:03Z","repo":{"name":"github.com/pranamphd/digipin-kotlin","commit":"f176454edfb7be74e629bffcb769c2b54b396f58"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":6.4,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/10 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Token-Permissions","score":9,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'packages' permission set to 'read': .github/workflows/codeql.yml:37","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql.yml:40","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:41","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/kotlin-cd.yml:22","Warn: no topLevel permission defined: .github/workflows/codeql.yml:1","Info: topLevel 'contents' permission set to 'read': .github/workflows/kotlin-cd.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/kotlin-ci.yml:16","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:19"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: gradle/wrapper/gradle-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":9,"reason":"dependency not pinned by hash detected -- score normalized to 9","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:77: update your workflow using https://app.stepsecurity.io/secureworkflow/pranamphd/digipin-kotlin/scorecard.yml/main?enable=pin","Info:  11 out of  12 GitHub-owned GitHubAction dependencies pinned","Info:   1 out of   1 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"SAST","score":9,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 23 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Branch-Protection","score":3,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'main'","Info: 'force pushes' disabled on branch 'main'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'main'","Warn: 'stale review dismissal' is disabled on branch 'main'","Warn: branch 'main' does not require approvers","Warn: codeowners review is not required on branch 'main'","Warn: 'last push approval' is disabled on branch 'main'","Warn: no status checks found to merge onto branch 'main'","Info: PRs are required in order to make changes on branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Contributors","score":0,"reason":"project has 0 contributing companies or organizations -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"CI-Tests","score":7,"reason":"8 out of 11 merged PRs checked by a CI test -- score normalized to 7","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}}]},"last_synced_at":"2026-01-19T22:26:10.870Z","repository_id":333457748,"created_at":"2026-01-19T22:26:10.870Z","updated_at":"2026-01-19T22:26:10.870Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28912213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T11:55:24.701Z","status":"ssl_error","status_checked_at":"2026-01-30T11:54:13.194Z","response_time":66,"last_error":"SSL_read: 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":["address","algorithm","digipin","gis","india","jar","java","kotlin","library","maven","pincode","zipcode"],"created_at":"2026-01-30T12:00:48.473Z","updated_at":"2026-01-30T12:00:50.217Z","avatar_url":"https://github.com/pranamphd.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# digipin-kotlin\n\nDIGIPIN (Digital Postal Index Number) is a national-level, geo-coded addressing grid developed by the **Department of Posts, Ministry of Communications, Government of India**. It provides a deterministic and reversible method to represent geographic locations in India using a **10-character alphanumeric code derived from latitude and longitude**.\n\nThis repository contains a **Kotlin implementation of the DIGIPIN algorithm**, intended to enable consistent and correct adoption across platforms, applications, and systems.\n\n![DIGIPIN Logo](/digipin-social-preview.png)\n\n## What this repository provides\n\n- Deterministic conversion from **latitude / longitude → DIGIPIN**\n- Reversible conversion from **DIGIPIN → geographic coordinates**\n- Comprehensive tests to ensure correctness\n- Implementation aligned with the **final DIGIPIN Technical Specification (March 2025)**\n\n---\n\n## Specification reference\n\nThis project implements the **DIGIPIN (Digital Postal Index Number)** algorithm strictly according to the official technical specification published by the **Department of Posts, Ministry of Communications, Government of India**.\n\nThe authoritative specification is available at:\n[https://www.indiapost.gov.in/digipin](https://www.indiapost.gov.in/digipin)\n\nAll implementations in this repository aim to faithfully reproduce the behavior described in the final DIGIPIN Technical Document (March 2025).\n\n\u003e This repository provides an independent implementation of the DIGIPIN specification and is not an official distribution of the Department of Posts unless explicitly stated otherwise.\n\n---\n\n## Design principles\n\n- **Specification-first**: Implementation strictly follows the DIGIPIN technical specification.\n- **Deterministic**: The same input always produces the same output, regardless of language or platform.\n- **No external dependencies**: Core logic is self-contained.\n\n---\n\n## Usage\n\n\u003e Note: Replace `\u003cversion\u003e` with the latest published version from Maven Central.\n\n### Gradle (Kotlin DSL)\n```kotlin\ndependencies {\n    implementation(\"phd.pranam:digipin:\u003cversion\u003e\")\n}\n```\n\n### Gradle (Groovy DSL)\n```kotlin\ndependencies {\n    implementation(\"phd.pranam:digipin:\u003cversion\u003e\")\n}\n```\n\n### Maven\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ephd.pranam\u003c/groupId\u003e\n  \u003cartifactId\u003edigipin\u003c/artifactId\u003e\n  \u003cversion\u003eVERSION\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n\n### Kotlin\n\n```kotlin\nimport phd.pranam.digipin.DigipinError\nimport phd.pranam.digipin.encode\nimport phd.pranam.digipin.decode\nimport phd.pranam.digipin.Location\n\nfun main() {\n    val location = Location(\n        latitude = 28.622788,\n        longitude = 77.213033\n    )\n\n    try {\n        val digipin = encode(location)\n        val decoded = decode(digipin)\n        println(digipin)\n        println(decoded)\n    } catch (e: DigipinError) {\n        println(\"DIGIPIN error: ${e.message}\")\n    }\n}\n```\n\n### Java\n\n```java\nimport phd.pranam.digipin.DigipinError;\nimport phd.pranam.digipin.Location;\n\nimport static phd.pranam.digipin.DecodeKt.decode;\nimport static phd.pranam.digipin.EncodeKt.encode;\n\npublic class Example {\n    static void main() {\n        Location location = new Location(28.622788, 77.213033);\n\n        try {\n            String digipin = encode(location);\n            Location decoded = decode(digipin);\n\n            System.out.println(digipin);\n            System.out.println(decoded);\n        } catch (DigipinError e) {\n            System.out.println(\"DIGIPIN error: \" + e.getMessage());\n        }\n    }\n}\n```\n\n---\n\n## Status\n\nThis repository is under active development.\nThe library interfaces (function and type signatures) may evolve until the first stable release (`v1.0.0`).\n\n---\n\n## License\n\nThis project is licensed under the **Apache License, Version 2.0**.\nSee the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranamphd%2Fdigipin-kotlin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranamphd%2Fdigipin-kotlin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranamphd%2Fdigipin-kotlin/lists"}