{"id":17861504,"url":"https://github.com/Buried-In-Code/Kraken","last_synced_at":"2025-10-02T21:31:17.166Z","repository":{"id":259110979,"uuid":"856869685","full_name":"Buried-In-Code/Kalibak","owner":"Buried-In-Code","description":"A Java/Kotlin wrapper for the Metron API.","archived":false,"fork":false,"pushed_at":"2024-10-21T20:06:26.000Z","size":97,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-22T14:10:34.800Z","etag":null,"topics":["kotlin-jvm","metron-api"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/Buried-In-Code.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-13T11:11:57.000Z","updated_at":"2024-10-21T20:06:29.000Z","dependencies_parsed_at":"2024-10-22T20:37:24.209Z","dependency_job_id":null,"html_url":"https://github.com/Buried-In-Code/Kalibak","commit_stats":null,"previous_names":["buried-in-code/kalibak"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FKalibak","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FKalibak/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FKalibak/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FKalibak/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Buried-In-Code","download_url":"https://codeload.github.com/Buried-In-Code/Kalibak/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235044000,"owners_count":18927009,"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":["kotlin-jvm","metron-api"],"created_at":"2024-10-28T08:45:54.633Z","updated_at":"2025-10-02T21:31:17.160Z","avatar_url":"https://github.com/Buried-In-Code.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kraken\n\n![Java Version](https://img.shields.io/badge/Temurin-21-green?style=flat-square\u0026logo=eclipse-adoptium)\n![Kotlin Version](https://img.shields.io/badge/Kotlin-2.2.0-green?style=flat-square\u0026logo=kotlin)\n![Status](https://img.shields.io/badge/Status-Beta-yellowgreen?style=flat-square)\n\n[![Gradle](https://img.shields.io/badge/Gradle-8.14.3-informational?style=flat-square\u0026logo=gradle)](https://github.com/gradle/gradle)\n[![Spotless](https://img.shields.io/badge/Spotless-7.1.0-informational?style=flat-square)](https://github.com/diffplug/spotless)\n\n[![Github - Version](https://img.shields.io/github/v/tag/Buried-In-Code/Kraken?logo=Github\u0026label=Version\u0026style=flat-square)](https://github.com/Buried-In-Code/Kraken/tags)\n[![Github - License](https://img.shields.io/github/license/Buried-In-Code/Kraken?logo=Github\u0026label=License\u0026style=flat-square)](https://opensource.org/licenses/MIT)\n[![Github - Contributors](https://img.shields.io/github/contributors/Buried-In-Code/Kraken?logo=Github\u0026label=Contributors\u0026style=flat-square)](https://github.com/Buried-In-Code/Kraken/graphs/contributors)\n\n[![Github Action - Testing](https://img.shields.io/github/actions/workflow/status/Buried-In-Code/Kraken/testing.yaml?branch=main\u0026logo=githubactions\u0026label=Testing\u0026style=flat-square)](https://github.com/Buried-In-Code/Kraken/actions/workflows/testing.yaml)\n[![Github Action - Documentation](https://img.shields.io/github/actions/workflow/status/Buried-In-Code/Kraken/docs.yaml?branch=main\u0026logo=githubactions\u0026label=Documentation\u0026style=flat-square)](https://github.com/Buried-In-Code/Kraken/actions/workflows/docs.yaml)\n\nA Java/Kotlin wrapper for the [Metron](https://metron.cloud) API.\n\n## Installation\n\nTo get started with Kraken, add the [JitPack](https://jitpack.io) repository to your `build.gradle.kts`.\n\n```kts\nrepositories {\n    maven(\"https://jitpack.io\")\n}\n```\n\nThen, add Kraken as a dependency.\n\n```kts\ndependencies {\n    implementation(\"com.github.Buried-In-Code:Kraken:0.4.0\")\n}\n```\n\n### Example Usage\n\n```kt\nimport github.buriedincode.kraken.Metron\nimport github.buriedincode.kraken.SQLiteCache\nimport github.buriedincode.kraken.AuthenticationException\nimport github.buriedincode.kraken.RateLimitException\nimport github.buriedincode.kraken.ServiceException\n\nfun main() {\n    try {\n        val session = Metron(username=\"Username\", password=\"Password\", cache=SQLiteCache())\n\n        // Get all Marvel comics for the week of 2021-06-07\n        val thisWeek = session.listIssues(params = mapOf(\n            \"store_date_range_after\" to \"2021-06-07\", \n            \"store_date_range_before\" to \"2021-06-13\", \n            \"publisher_name\" to \"marvel\"\n        ))\n        // Print the results\n        thisWeek.forEach {\n            println(\"${it.id} ${it.name}\")\n        }\n\n        // Retrieve the detail for an individual issue\n        val asm68 = session.getIssue(id = 31660)\n        // Print the issue Description\n        println(asm68.description)\n\n  } catch (ae: AuthenticationException) {\n      println(\"Invalid Metron Username/Password.\")\n  } catch(re: RatelimitException) {\n      println(\"Rate limit exceeded. Please try again later.\")\n  } catch (se: ServiceException) {\n      println(\"Unsuccessful request: ${se.message}\")\n  }\n}\n```\n\n## Documentation\n\n- [Kraken](https://buried-in-code.github.io/Kraken)\n- [Metron API](https://metron.cloud/docs/)\n\n## Bugs/Requests\n\nPlease use the [GitHub issue tracker](https://github.com/Buried-In-Code/Kraken/issues) to submit bugs or request features.\n\n## Socials\n\n[![Social - Fosstodon](https://img.shields.io/badge/%40BuriedInCode-teal?label=Fosstodon\u0026logo=mastodon\u0026style=for-the-badge)](https://fosstodon.org/@BuriedInCode)\\\n[![Social - Matrix](https://img.shields.io/badge/%23The--Dev--Environment-teal?label=Matrix\u0026logo=matrix\u0026style=for-the-badge)](https://matrix.to/#/#The-Dev-Environment:matrix.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBuried-In-Code%2FKraken","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBuried-In-Code%2FKraken","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBuried-In-Code%2FKraken/lists"}