<h1 align="center">ax-io</h1>
<p align="center">`std::io` for `no_std` environment</p>
<div align="center">
[](https://crates.io/crates/ax-io)
[](https://docs.rs/ax-io)
[](https://www.rust-lang.org/)
[](./LICENSE)
</div>
# Introduction
`ax-io` provides `std::io` for `no_std` environment. It is maintained as part of the TGOSKits component set and is intended for Rust projects that integrate with ArceOS, AxVisor, or related low-level systems software.
> ax-io was derived from https://github.com/arceos-org/axio
## Quick Start
### Installation
Add this crate to your `Cargo.toml`:
```toml
[dependencies]
ax-io = "0.5.0"
```
### Run Check and Test
```bash
# Enter the crate directory
cd components/axio
# Format code
cargo fmt --all
# Run clippy
cargo clippy --all-targets --all-features
# Run tests
cargo test --all-features
# Build documentation
cargo doc --no-deps
```
## Integration
### Example
```rust
use ax_io as _;
fn main() {
// Integrate `ax-io` into your project here.
}
```
### Documentation
Generate and view API documentation:
```bash
cargo doc --no-deps --open
```
Online documentation: [docs.rs/ax-io](https://docs.rs/ax-io)
# Contributing
1. Fork the repository and create a branch
2. Run local format and checks
3. Run local tests relevant to this crate
4. Submit a PR and ensure CI passes
# License
Licensed under the Apache License, Version 2.0. See [LICENSE](./LICENSE) for details.