hhh

This is a hexadecimal encoder/decoder for files but has a parser for reading descriptions and generating binary files. See the book distributed with the source (in the doc folder) for details.

hhh uses Semantic Versioning.

Have you found a bug? Submit it through the hhh Issues tracker, and be sure to include (1) what happens, (2) what you expect to happen, (3) how to reproduce the bug, and (4) what version of hhh you are using.

Installation

To install hhh locally, use cargo install.

$ cargo install hhh
    Updating crates.io index
  Downloaded hhh v1.0.0
  Downloaded 1 crate (94.1 KB) in 0.91s
  Installing hhh v1.0.0
    Finished release [optimized] target(s) in 16.28s

If you are installing from a local copy of the repository, you can use cargo install --path=., instead.

Online Documentation

For the master branch only:

• The hhh Book
• hhh Rust API

Local Documentation

If you have built the documentation locally, then this link will take you to it.

• Local hhh Book
• Local hhh Rust API

Building

You need to have Rust 2021 edition installed to compile. Compilation should be relatively simple.

$ cargo build

This should build the hhh binary.

You might have a look at etc/build.sh and etc\build.ps1. These is a little scripts (in bash and powershell) that run the "pre-commit" pipeline.

API Documentation

If you want documentation run cargo doc --nodeps.

After generation the API documentation should be available locally starting at target/doc/hhh/index.html.

Security

Please submit sensitive security issues using the "This issue is confidential..." button below the issue description field in the issue tracker.

The code should be checked, periodically, against the known Rust security advisories. This can be done with cargo audit. You can install that with cargo install cargo-audit.

Consider installing Trivy. This is a vulnerability scanner.

Contribute

See CONTRIBUTING for information about contributing to this project.

If you are interested in contributing, see the Roadmap, the TechDebt, and any TODO or BUG comments in the code for some things that still need to be done. Others may be working on them, so be sure to check in with the project.

Copyright

hhh is Copyright (c) 2023 by Stacy Prowell (sprowell+hhh@gmail.com). All rights reserved. See the Copyright and License files for more information.