15 unstable releases (3 breaking)

0.6.2 Jan 22, 2025
0.6.1 Dec 18, 2024
0.6.0-alpha.5 Nov 16, 2024
0.3.0-alpha.0 Jul 31, 2024
0.2.2 Mar 25, 2024

#102 in FFI

Download history 1897/week @ 2024-12-03 3033/week @ 2024-12-10 3203/week @ 2024-12-17 1840/week @ 2024-12-24 2719/week @ 2024-12-31 3162/week @ 2025-01-07 3784/week @ 2025-01-14 4451/week @ 2025-01-21 3976/week @ 2025-01-28 4078/week @ 2025-02-04 4704/week @ 2025-02-11 4560/week @ 2025-02-18 4302/week @ 2025-02-25 4001/week @ 2025-03-04 5239/week @ 2025-03-11 4033/week @ 2025-03-18

18,477 downloads per month
Used in 3 crates

MIT/Apache

18KB
216 lines

Manganis

The Manganis allows you to submit assets to any build tool that supports collecting assets. It makes it easy to self-host assets that are distributed throughout your libraries. Manganis also handles optimizing, converting, and fetching assets.

If you defined this in a component library:

use manganis::{Asset, asset};
const AVIF_ASSET: Asset = manganis::asset!("/assets/image.png");

AVIF_ASSET will be set to a new file name that will be served by some CLI. That file can be collected by any package that depends on the component library.

use manganis::{ImageFormat, ImageAssetOptions, Asset, asset, ImageSize};
// You can collect arbitrary files. Absolute paths are resolved relative to the package root
const _: Asset = asset!("/assets/script.js");

// You can collect images which will be automatically optimized
pub const PNG_ASSET: Asset =
    asset!("/assets/image.png");
// Resize the image at compile time to make the assets smaller
pub const RESIZED_PNG_ASSET: Asset =
    asset!("/assets/image.png", ImageAssetOptions::new().with_size(ImageSize::Manual { width: 52, height: 52 }));
// Or convert the image at compile time to a web friendly format
pub const AVIF_ASSET: Asset = asset!("/assets/image.png", ImageAssetOptions::new().with_format(ImageFormat::Avif));

Adding Support to Your CLI

To add support for your CLI, you need to integrate with the manganis_cli_support crate. This crate provides utilities to collect assets that integrate with the Manganis macro. It makes it easy to integrate an asset collection and optimization system into a build tool.

Dependencies

~0.4–1MB
~22K SLoC