{"id":22903642,"url":"https://github.com/iseki0/kotlinx-serialization-bencoding","last_synced_at":"2025-07-09T08:02:45.412Z","repository":{"id":171752751,"uuid":"621306217","full_name":"iseki0/kotlinx-serialization-bencoding","owner":"iseki0","description":"A Kotlin serialization codec used to encode/decode bencoding format.","archived":false,"fork":false,"pushed_at":"2025-03-17T14:50:51.000Z","size":431,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-31T17:53:24.336Z","etag":null,"topics":["bencode","kotlin-mpp","kotlin-multiplatform","kotlinx-serialization"],"latest_commit_sha":null,"homepage":"https://iseki0.github.io/kotlinx-serialization-bencoding/","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/iseki0.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":"2023-03-30T11:59:12.000Z","updated_at":"2025-03-16T17:02:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"a8ca92ad-34ed-49b6-9d86-4416c2cb6a33","html_url":"https://github.com/iseki0/kotlinx-serialization-bencoding","commit_stats":null,"previous_names":["iseki0/kotlinx-serialization-bencoding"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iseki0%2Fkotlinx-serialization-bencoding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iseki0%2Fkotlinx-serialization-bencoding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iseki0%2Fkotlinx-serialization-bencoding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iseki0%2Fkotlinx-serialization-bencoding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iseki0","download_url":"https://codeload.github.com/iseki0/kotlinx-serialization-bencoding/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253112071,"owners_count":21856070,"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":["bencode","kotlin-mpp","kotlin-multiplatform","kotlinx-serialization"],"created_at":"2024-12-14T02:38:06.319Z","updated_at":"2025-05-08T17:02:15.417Z","avatar_url":"https://github.com/iseki0.png","language":"Kotlin","readme":"# kotlinx-serialization-bencode\n\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/iseki0/kotlinx-serialization-bencoding/build.yml)\n[![Maven Central Version](https://img.shields.io/maven-central/v/space.iseki.bencoding/kotlinx-serialization-bencoding)](https://central.sonatype.com/artifact/space.iseki.bencoding/kotlinx-serialization-bencoding)\n![License](https://img.shields.io/github/license/iseki0/kotlinx-serialization-bencoding)\n\nA Kotlin serialization codec for bencoding format. (Bittorrent)\n\nReference: [https://www.bittorrent.org/beps/bep_0003.html](https://www.bittorrent.org/beps/bep_0003.html)\n\n## Usage\n\nAdd the dependency to your `build.gradle.kts`\n\n```kotlin\ndependencies {\n  implementation(\"space.iseki.bencoding:kotlinx-serialization-bencoding:0.2.8\")\n}\n```\n\n```kotlin\n@Serialization\ndata class Meta(val announce: String) // The torrent file format\n\nfun foo(input: InputStream) {\n    println(Bencode.decodeFromStream\u003cMeta\u003e(data.inputStream()))\n}\n```\n\n## Bencoding Format\n\nThe following content is copied\nfrom [https://www.bittorrent.org/beps/bep_0003.html](https://www.bittorrent.org/beps/bep_0003.html) for a memo.\n\n- Strings are length-prefixed base ten followed by a colon and the string. For example `4:spam` corresponds to 'spam'.\n- Integers are represented by an 'i' followed by the number in base 10 followed by an 'e'. For example `i3e` corresponds\n  to 3 and `i-3e` corresponds to -3. Integers have no size limitation. `i-0e` is invalid. All encodings with a leading\n  zero,\n  such as `i03e`, are invalid, other than i0e, which of course corresponds to 0.\n- Lists are encoded as an 'l' followed by their elements (also bencoded) followed by an 'e'. For\n  example `l4:spam4:eggse`\n  corresponds to ['spam', 'eggs'].\n- Dictionaries are encoded as a 'd' followed by a list of alternating keys and their corresponding values followed by\n  an 'e'. For example, `d3:cow3:moo4:spam4:eggse` corresponds to {'cow': 'moo', 'spam': 'eggs'} and `d4:spaml1:a1:bee`\n  corresponds to {'spam': ['a', 'b']}. Keys must be strings and appear in sorted order (sorted as raw strings, not\n  alphanumerics).","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiseki0%2Fkotlinx-serialization-bencoding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiseki0%2Fkotlinx-serialization-bencoding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiseki0%2Fkotlinx-serialization-bencoding/lists"}