cargo add-dynamic

This cargo command allows to wrap dependencies as dylibs.

For why you might want this see Speeding up incremental Rust compilation with dylibs.

Installation

cargo install cargo-add-dynamic

Example

To add a new dependency as a dylib to the current project run for example

cargo add-dynamic polars --features csv-file,lazy,list,describe,rows,fmt,strings,temporal

This will create a sub-package polars-dynamic with the following content.

polars-dynamic/Cargo.toml

[package]
name = "polars-dynamic"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]
polars = { version = "0.23.2", features = ["csv-file", "lazy", "list", "describe", "rows", "fmt", "strings", "temporal"] }

[lib]
crate-type = ["dylib"]

polars-dynamic/src/lib.rs

pub use polars::*;

And it will add polars = { version = "0.1.0", path = "polars-dynamic", package = "polars-dynamic" } to the dependencies of the current package.

Usage

add-dynamic 
Cargo command similar to `cargo add` that will add a dependency <DEP> as a dynamic library (dylib)
crate by creating a new sub-package whose only dependency is the specified <DEP> and whose
crate-type is ["dylib"].

USAGE:
    cargo-add-dynamic [OPTIONS] <DEP>

ARGS:
    <DEP>    

OPTIONS:
    -F, --features <FEATURES>...    Space or comma separated list of features to activate
    -h, --help                      Print help information
        --lib-dir <DIR>             Directory for the new sub-package. Defaults to <DEP>-dynamic
    -n, --name <NAME>               Name of the dynamic library, defaults to <DEP>-dynamic
        --no-default-features       Disable the default features
        --offline                   Run without accessing the network
        --optional                  Mark the dependency as optional. The package name will be
                                    exposed as feature of your crate.
    -p, --package <SPEC>            Package to modify
        --path <PATH>               Filesystem path to local crate to add
        --rename <NAME>             Rename the dependency
                                    Example uses:
                                    - Depending on multiple versions of a crate
                                    - Depend on crates with the same name from different registries
    -v, --verbose                   Additional (debug) logging.

Rust, cargo and QEMU setup for multi-architecture OS development.

rust-osdev-jumpstart Rust, cargo and QEMU setup for multi-architecture OS development. Goal This repo should give you a boost in starting a bare-metal

27 Nov 20, 2022

A cargo plugin for showing a tree-like overview of a crate's modules.

cargo-modules Synopsis A cargo plugin for showing an overview of a crate's modules. Motivation With time, as your Rust projects grow bigger and bigger

445 Jan 3, 2023

A cargo subcommand to fetch the $OUT_DIR environment variable from build scripts

cargo-outdir A cargo subcommand to fetch the $OUT_DIR variable from build scripts. This is extremely useful to inspect the output of automatically gen

2 Sep 29, 2022

probe-run is a custom Cargo runner that transparently runs Rust firmware on an embedded device

probe-run Runs embedded programs just like native ones probe-run is a custom Cargo runner that transparently runs Rust firmware on an embedded device.

483 Jan 7, 2023

An inquiry into nondogmatic software development. An experiment showing double performance of the code running on JVM comparing to equivalent native C code.

java-2-times-faster-than-c An experiment showing double performance of the code running on JVM comparing to equivalent native C code ⚠️ The title of t

49 Aug 14, 2022

Comments

[Question] fail to build serde_json dylib

Thanks for this cool tool!

I tried to build serde_json dylib with serde dylib, but failed. If I change crate-type to rlib for the serde_json-dynamic sub-package, then it works. simple project is here.

Not sure whether rlib works like dylib here or not as expected?

opened by huahouye 7
Cannot execute test.sh
Hi,

Nice work! I'm trying to run test.sh. I get:

$ ./test.sh error: Found argument 'foo' which wasn't expected, or isn't valid in this context USAGE: cargo rm [OPTIONS] For more information try --help

Which version of cargo-rm are you using? I've installed latest with cargo install cargo-rm.

Seems my version doesn't take any args (see stderr) as needed here.
opened by mihaigalos 1

Unable to run with nightly

I'm trying to dynamically link sysexits to my cat implementation using this, but when I run it:

# LD_PRELOAD=target/release-helpful/libsysexits_dynamic.so target/release-helpful/cat /etc/pacman.conf
target/release-helpful/cat: error while loading shared libraries: libstd-08c52b3d112d8849.so: cannot open shared object file: No such file or directory

opened by emmatebibyte 3