{"id":15401113,"url":"https://github.com/sunfishcode/io-arrays","last_synced_at":"2025-04-15T22:30:45.699Z","repository":{"id":38682817,"uuid":"329477019","full_name":"sunfishcode/io-arrays","owner":"sunfishcode","description":"Random-access I/O","archived":false,"fork":false,"pushed_at":"2024-01-11T06:12:50.000Z","size":111,"stargazers_count":11,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-04T06:07:18.893Z","etag":null,"topics":["library","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sunfishcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-14T01:37:48.000Z","updated_at":"2024-02-09T12:05:32.000Z","dependencies_parsed_at":"2024-10-20T11:17:49.687Z","dependency_job_id":null,"html_url":"https://github.com/sunfishcode/io-arrays","commit_stats":{"total_commits":114,"total_committers":2,"mean_commits":57.0,"dds":0.00877192982456143,"last_synced_commit":"99bf2d57a200b89e1a37eb96d4b548c0646989c0"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunfishcode%2Fio-arrays","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunfishcode%2Fio-arrays/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunfishcode%2Fio-arrays/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunfishcode%2Fio-arrays/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sunfishcode","download_url":"https://codeload.github.com/sunfishcode/io-arrays/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248384061,"owners_count":21094668,"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":["library","rust"],"created_at":"2024-10-01T15:56:31.280Z","updated_at":"2025-04-15T22:30:45.306Z","avatar_url":"https://github.com/sunfishcode.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e\u003ccode\u003eio-arrays\u003c/code\u003e\u003c/h1\u003e\n\n  \u003cp\u003e\n    \u003cstrong\u003eRandom-access I/O\u003c/strong\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/sunfishcode/io-arrays/actions?query=workflow%3ACI\"\u003e\u003cimg src=\"https://github.com/sunfishcode/io-arrays/workflows/CI/badge.svg\" alt=\"Github Actions CI Status\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://crates.io/crates/io-arrays\"\u003e\u003cimg src=\"https://img.shields.io/crates/v/io-arrays.svg\" alt=\"crates.io page\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://docs.rs/io-arrays\"\u003e\u003cimg src=\"https://docs.rs/io-arrays/badge.svg\" alt=\"docs.rs docs\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\nThink of an *I/O array* as a `Vec\u003cu8\u003e` which lives outside the program. You can\nindex into it and copy data in and out. You can append to it or shrink it from\nthe back.\n\nIn I/O terms, an I/O array is an abstraction of a \"file\". It supports doing I/O\nat arbitrary offsets, appending, and truncating. You can read from it in a\nstreaming fashion using [`ReadAt::read_via_stream_at`].\n\nTODO: Writing to an array in a streaming fashion is not yet supported.\n\nThis crate defines [`ReadAt`], [`WriteAt`], and [`EditAt`] traits which define\ninterfaces to random-access or seekable devices, such as normal files, block\ndevices, disk partitions, and memory buffers.\n\nIt also defines [`ArrayReader`], [`ArrayWriter`], and [`ArrayEditor`] types which\nimplement the above traits and and can be constructed from any file-like type.\nOn Posix-ish platforms, with support for WASI in development, these types just\ncontain a single file descriptor (and implement [`AsRawFd`]), plus any\nresources needed to safely hold the file descriptor live. On Windows, they\ncontain a single file handle (and implement [`AsRawHandle`]).\n\nSupport for async-std is temporarily disabled until those crates contain the\nneeded implementations of the I/O safety traits.\n\n[`ReadAt`]: https://docs.rs/io-arrays/latest/io_arrays/trait.ReadAt.html\n[`WriteAt`]: https://docs.rs/io-arrays/latest/io_arrays/trait.WriteAt.html\n[`EditAt`]: https://docs.rs/io-arrays/latest/io_arrays/trait.EditAt.html\n[`ArrayReader`]: https://docs.rs/io-arrays/latest/io_arrays/struct.ArrayReader.html\n[`ArrayWriter`]: https://docs.rs/io-arrays/latest/io_arrays/struct.ArrayWriter.html\n[`ArrayEditor`]: https://docs.rs/io-arrays/latest/io_arrays/struct.ArrayEditor.html\n[`AsRawFd`]: https://doc.rust-lang.org/std/os/unix/io/trait.AsRawFd.html\n[`AsRawHandle`]: https://doc.rust-lang.org/std/os/windows/io/trait.AsRawHandle.html\n[`ReadAt::read_via_stream_at`]: https://docs.rs/io-arrays/latest/io_arrays/trait.ReadAt.html#tymethod.read_via_stream_at\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunfishcode%2Fio-arrays","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsunfishcode%2Fio-arrays","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunfishcode%2Fio-arrays/lists"}