https://github.com/vschwaberow/adflib
a Rust library to handle ADF files for the Amiga
https://github.com/vschwaberow/adflib
adf amiga disk disk-image first-timers retro
Last synced: 8 days ago
JSON representation
a Rust library to handle ADF files for the Amiga
- Host: GitHub
- URL: https://github.com/vschwaberow/adflib
- Owner: vschwaberow
- License: other
- Created: 2022-09-06T05:48:56.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-19T05:05:40.000Z (about 1 month ago)
- Last Synced: 2025-04-13T08:54:19.225Z (9 days ago)
- Topics: adf, amiga, disk, disk-image, first-timers, retro
- Language: Rust
- Homepage:
- Size: 120 KB
- Stars: 10
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# adflib
A Rust library and command-line tool for managing ADF (Amiga Disk File) files.
## Motivation
While working on cross-development for the Amiga, I needed a way to manage ADF files. Existing libraries weren't written in Rust, which was my preferred language for tool development. Thus, I decided to create a Rust-based library for managing ADF files. The library is still in its early stages and is not yet feature-complete or extensively tested.
## Features
- Read and write ADF files
- Extract disk information (filesystem type, disk name, creation date, etc.)
- List files and directories
- Extract files from ADF images
- Add files to ADF images (planned)
- Create new ADF images (planned)
## Library Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
adflib = ""
```
Basic usage example:
```rust
use adflib::ADF;
use std::io::Result;
fn main() -> Result<()> {
let adf = ADF::from_file("my_disk.adf")?;
println!("ADF file loaded successfully");
Ok(())
}
```
Getting disk information:
```rust
use adflib::ADF;
use std::io::Result;
fn main() -> Result<()> {
let adf = ADF::from_file("my_disk.adf")?;
let disk_info = adf.information?;
println!("ADF file loaded successfully");
Ok(())
}
```
Extract files from ADF image:
```rust
use adflib::ADF;
use std::io::Result;
fn main() -> Result<()> {
let adf = ADF::from_file("my_disk.adf")?;
let extracted_file = adf.extract_file("my_file.txt")?;
Ok(())
}
```
Read the documentation for more details.
## Command-line Tool
The command-line tool provides a simple interface for managing ADF files. It's still in early development and doesn't yet support all features. You will find it under https://github.com/vschwaberow/adflib-cli.
### Installation
```bash
cargo install adflib
```
### Usage
```bash
adflib [OPTIONS]
```
## Development Status
The library is based on the [ADF File Format](http://lclevy.free.fr/adflib/faq.html) specification and draws inspiration from the concepts in Laurent Clevy's [ADF library](https://github.com/lclevy/ADFlib). However, it's a pure Rust implementation without using any C code or the original ADF library. And it's
rewritten from scratch.
The project is still in active development. Contributions, bug reports, and feature requests are welcome!
## License
This project is dual-licensed under MIT and Apache 2.0. See the LICENSE-MIT and LICENSE-APACHE files for details.
## Acknowledgments
* [ADF library](https://github.com/lclevy/ADFlib) by Laurent Clevy et al.
* [ADF File Format](http://lclevy.free.fr/adflib/faq.html) specification
* [Rust](https://www.rust-lang.org/)
## Contribution
Contributions are welcome! If you'd like to contribute, please feel free to submit a pull request or open an issue for discussion. Any help in improving the library, adding features, or enhancing documentation is greatly appreciated.