{"id":17560149,"url":"https://github.com/vd2org/basen","last_synced_at":"2025-04-24T05:43:05.128Z","repository":{"id":48880451,"uuid":"178192875","full_name":"vd2org/basen","owner":"vd2org","description":"Custom encoder that encodes any binary data to given alphabet.","archived":false,"fork":false,"pushed_at":"2024-02-26T22:43:16.000Z","size":140,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-24T05:42:58.764Z","etag":null,"topics":["base","base-encoder","base128","base16","base32","base64","basen","generator"],"latest_commit_sha":null,"homepage":"","language":"Python","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/vd2org.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}},"created_at":"2019-03-28T11:49:55.000Z","updated_at":"2025-03-13T12:41:08.000Z","dependencies_parsed_at":"2022-09-16T03:50:16.726Z","dependency_job_id":null,"html_url":"https://github.com/vd2org/basen","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vd2org%2Fbasen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vd2org%2Fbasen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vd2org%2Fbasen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vd2org%2Fbasen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vd2org","download_url":"https://codeload.github.com/vd2org/basen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250573298,"owners_count":21452342,"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":["base","base-encoder","base128","base16","base32","base64","basen","generator"],"created_at":"2024-10-21T11:23:53.397Z","updated_at":"2025-04-24T05:43:05.110Z","avatar_url":"https://github.com/vd2org.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BaseN\n\nCustom encoder that encodes any binary data to given alphabet.\n\n### Requirements\n\nPython 3.8 and above. No additional dependencies.\n\n### Installation\n\n`pip install basen-encoder`\n\n## Usage\n\n### Numbers\n\nEncode a number to the string and back\n\n```python\nimport string\n\nimport basen\n\nALPHABET = string.ascii_letters + string.digits\n\nfor i in range(1000, 2000, 9):\n    encoded = basen.int2base(i, ALPHABET)\n    decoded = basen.base2int(encoded, ALPHABET)\n\n    print(i, encoded, decoded)\n```\n#### Output:\n\n```text\n1000 qi 1000\n1009 qr 1009\n1018 qA 1018\n1027 qJ 1027\n...\n```\n\n### Huge numbers\n\nEven huge numbers can be encoded as well.\n\n```python\nimport string\n\nimport basen\n\nALPHABET = string.ascii_letters + string.digits\n\nNUM = 10**100\n\nencoded = basen.int2base(i, ALPHABET)\ndecoded = basen.base2int(encoded, ALPHABET)\n\nprint(NUM)\nprint(encoded)\nprint(decoded)\n```\n\n#### Output:\n\n```text\n10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\nAm851IcwtXApqVErDmkjfH9ikry1v4YsyaP4zUrrmM8H8j83wfxbV02K\n10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000\n```\n\n### Encode a binary\n\nEncode a binary data to printable text like base64 but with an arbitrary alphabet.\n\n```python\nimport string\n\nimport basen\n\nALPHABET = string.ascii_letters\nDATA = \"Some binary data...\"\n\nencoder = basen.BaseN(string.ascii_letters, 3)\nencoded = encoder.encode(DATA)\ndecoded = encoder.decode(encoded)\n\nprint(DATA)\nprint(encoded)\nprint(decoded)\n```\n\n#### Output:\n\n```text\nSome binary data...\naMUkfaVgYAaXhpLbbsxuaUOUCaTprkavVgx==\nbytearray(b'Some binary data...')\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvd2org%2Fbasen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvd2org%2Fbasen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvd2org%2Fbasen/lists"}