5 unstable releases
new 0.7.2 | Sep 28, 2024 |
---|---|
0.7.1 | Sep 11, 2024 |
0.7.0 | Sep 11, 2024 |
0.6.0 | Sep 6, 2024 |
0.5.0 | Sep 5, 2024 |
#986 in Parser implementations
797 downloads per month
275KB
4K
SLoC
mame-parser
Simplify the management and processing of files containing MAME data
Features • Library Contents • Getting Started • Credits • Contribute • License
mame-parser
is a Rust library designed to simplify the management and processing of files containing MAME (Multiple Arcade Machine Emulator) data. This library provides a comprehensive suite of tools to automate the downloading, decompression, parsing, and exporting of MAME data, making it easier to handle and manipulate this information in various formats.
Features
- File Downloading: Download the latest MAME-related files and store them in a specified location.
- File Decompression: Decompress downloaded files automatically, supporting multiple archive formats such as ZIP and 7z.
- Data Parsing and Management: Parse MAME data files with utilities for reading and processing information in-memory.
- Multi-format Exporting: Export parsed data to various formats, including JSON, CSV, and SQLite.
- Progress Tracking: Monitor the progress of operations.
Library Contents
File Handling
download_file
: Downloads a single MAME data file to a specified location.download_files
: Downloads multiple MAME data files concurrently, providing progress tracking across multiple threads.unpack_file
: Unpacks a single downloaded file from its archive format (e.g., ZIP or 7z) to a specified folder.unpack_files
: Unpacks multiple files concurrently, allowing for efficient decompression with progress tracking.read_file
: Reads a single data file and returns aHashMap
with the information.read_files
: Reads multiple data files concurrently and returns aHashMap
with the information.remove_machines_by_category
: Filters machines based on a specific category, removing all machines that do not match the given category.remove_machines_by_filter
: Applies multiple filters to the machines, such as removing non-game machines, BIOS machines, mechanical machines, device machines, clones, or modified machines.write_files
: Writes machine data to the desired format (SQLite, JSON, or CSV), establishing all necessary relationships and providing progress updates.
Progress Tracking
Tools and types for tracking and managing progress updates during operations.
MAME file readers
Functions for reading and parsing different MAME data file formats.
Getting Started
To get started with mame-parser
, follow these steps:
1. Add the Dependency
Add mame-parser
as a dependency in your Cargo.toml
file:
[dependencies]
mame-parser = "0.7.0"
Make sure to replace "0.7.0"
with the actual version of mame-parser
that you intend to use.
2. Download file example
use mame_parser::file_handling::download_file;
use mame_parser::models::MameDataType;
use mame_parser::progress::{CallbackType, ProgressCallback, ProgressInfo};
use std::error::Error;
use std::path::Path;
fn main() -> Result<(), Box<dyn Error>> {
// Define the workspace directory
let workspace_path = Path::new("playground");
// Define a callback function for progress tracking
let progress_callback: ProgressCallback = Box::new(move |progress_info: ProgressInfo| {
// Update progress using console messages
match progress_info.callback_type {
CallbackType::Progress => {
println!(
"Progress: {}/{}",
progress_info.progress, progress_info.total
);
}
CallbackType::Info => {
println!("Info: {}", progress_info.message);
}
CallbackType::Finish => {
println!("Finished: {}", progress_info.message);
}
CallbackType::Error => {
eprintln!("Error: {}", progress_info.message);
}
}
});
// Download the file
let downloaded_file = download_file(MameDataType::Series, workspace_path, progress_callback);
// Print the result
match downloaded_file {
Ok(downloaded_file) => {
println!(
"Downloaded file: {}",
downloaded_file.as_path().to_str().unwrap()
);
}
Err(e) => {
eprintln!("Error during download: {}", e);
}
}
Ok(())
}
4. Running the Example
To run the example, create a Rust project, add the code above to your main.rs
file, and run:
cargo run
Make sure you have an active internet connection, as the example involves downloading files from the web.
Credits
mame-parser
wouldn't be possible without the invaluable contributions and resources provided by the following individuals and communities:
-
The MAME Community: A special thanks to the entire MAME community for their continuous efforts in preserving arcade history and making it accessible to everyone. Your work is the foundation upon which this project is built.
-
AntoPISA and Progetto-SNAPS: AntoPISA's Progetto-SNAPS project has been an essential resource for MAME artwork and other assets. Thank you for your dedication and hard work in creating and maintaining this incredible resource.
-
Motoschifo and Arcade Database (ADB): Motoschifo's Arcade Database is a comprehensive resource for MAME data, providing detailed information about arcade games and machines.
-
Arcade-History: The team behind Arcade-History has done an amazing job in documenting the history of arcade games.
-
NPlayers Team: The NPlayers project by Arcade Belgium is a fantastic resource for information on multiplayer arcade games.
-
zombiesbyte and XMLTractor: Special thanks to zombiesbyte for XMLTractor project.
Contribute
Contributions are welcome! If you'd like to contribute, please fork the repository, create a new branch, and submit a pull request. Make sure to follow the project's coding guidelines and include tests where applicable.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Dependencies
~36–50MB
~849K SLoC