cargo-container

Wrap vanilla cargo rlibs/packages in generated "containers" for various ends.

Quickstart

• Clone this repository
• Open in VS Code
• Install extensions recommended by workspace
• Hit F5

This will build and run one of the example projects of example/multiplatform in Chrome

Basic Guide

• cargo install cargo-container
• Author a Container.toml workspace instead of a regular Cargo.toml workspace
  • Write a [workspace] like you would in Cargo.toml, with members (and optionally exclude)
  • Define one or more [[build]] sections defining what crates to wrap with what tools
  • Optional: specify more crates to auto-install via [local-install]
• Author the crates to wrap in said boilerplate
• Run cargo container build. This will:
  • Install any bin dependencies specified by [local-install]
  • Run tools to generate Cargo.toml projects
  • Generate a Cargo.toml alongside Container.toml that references the generated dependencies
  • Runs tools to build generated Cargo.toml projects
• Profit!

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.