# cargo-cp-artifact

> Copies compiler artifacts emitted by rustc by parsing Cargo metadata

Latest version **0.1.9** (published 2024-05-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install cargo-cp-artifact
pnpm add cargo-cp-artifact
yarn add cargo-cp-artifact
bun add cargo-cp-artifact
```

Provides the command `cargo-cp-artifact`.

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 0.1.9 |
| Published | 2024-05-10 |
| First published | 2021-02-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 12 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8426 |
| Author | K.J. Valencik |
| Maintainers | dherman, kjv |
| Keywords | cargo, rust, neon |

## Links

- npm: https://www.npmjs.com/package/cargo-cp-artifact
- Repository: https://github.com/neon-bindings/neon
- Homepage: https://github.com/neon-bindings/neon/tree/main/pkgs/cargo-cp-artifact
- Issues: https://github.com/neon-bindings/neon/issues
- npm.io page: https://npm.io/package/cargo-cp-artifact

## Recent versions

- 0.1.9 (latest) — 2024-05-10
- 0.1.8 — 2023-03-08
- 0.1.7 — 2022-11-11
- 0.1.6 — 2021-11-24
- 0.1.5 — 2021-08-25
- 0.1.4 — 2021-03-23
- 0.1.3 — 2021-03-23
- 0.1.2 — 2021-03-12
- 0.1.1 — 2021-02-24
- 0.1.0 — 2021-02-24
- 0.0.2 — 2021-02-16
- 0.0.1 — 2021-02-16

## README

# cargo-cp-artifact

`cargo-cp-artifact` is a small command line utility for parsing cargo metadata output and copying a compiler artifact to a desired location.

## Installation

```sh
npm install -g cargo-cp-artifact
```

## Usage

```
cargo-cp-artifact --artifact artifact-kind crate-name output-file -- wrapped-command
```

`cargo-cp-artifact` accepts a list of crate name and artifact kind to output file mappings and a command to wrap.`cargo-cp-artifact` will read `stdout` of the wrapped command and parse it as [cargo metadata](https://doc.rust-lang.org/cargo/reference/external-tools.html#json-messages). Compiler artifacts that match arguments provided will be copied to the target destination.

When wrapping a `cargo` command, it is necessary to include a `json` format to `--message-format`.

### Arguments

Multiple arguments are allowed to copy multiple build artifacts.

#### `--artifact`

_Alias: `-a`_

Followed by *three* arguments: `artifact-kind crate-name output-file`

#### `--npm`

_Alias: `-n`_

Followed by *two* arguments: `artifact-kind output-file`

The crate name will be read from the `npm_package_name` environment variable. If the package name includes a namespace (`@namespace/package`), the namespace will be removed when matching the crate name (`package`).

### Artifact Kind

Valid artifact kinds are `bin`, `cdylib`, and `dylib`. They may be abbreviated as `b`, `c`, and `d` respectively.

For example, `-ac` is the equivalent of `--artifact cdylib`.

## Examples

### Wrapping cargo

```sh
cargo-cp-artifact -a cdylib my-crate lib/index.node -- cargo build --message-format=json-render-diagnostics
```

### Parsing a file

```sh
cargo-cp-artifact -a cdylib my-crate lib/index.node -- cat build-output.txt
```

### `npm` script

`package.json`
```json
{
    "name": "my-crate",
    "scripts": {
        "build": "cargo-cp-artifact -nc lib/index.node -- cargo build --message-format=json-render-diagnostics"
    }
}
```

```sh
npm run build

# Additional arguments may be passed
npm run build -- --feature=serde
```

## Why does this exist?

At the time of writing, `cargo` does not include a configuration for outputting a library or binary to a specified location. An `--out-dir` option [exists on nightly](https://github.com/rust-lang/cargo/issues/6790), but does not allow specifying the name of the file.

It's surprisingly difficult to reliably find the location of a cargo compiler artifact. It is impacted by many parameters, including:

* Build profile
* Target, default or specified
* Crate name and name transforms

However, `cargo` can emit metadata on `stdout` while continuing to provide human readable diagnostics on `stderr`. The metadata may be parsed to more easily and reliably find the location of compiler artifacts.

`cargo-cp-artifact` chooses to wrap a command as a child process instead of reading `stdin` for two reasons:

1. Removes the need for `-o pipefile` when integrating with build tooling which may need to be platform agnostic.
2. Allows additional arguments to be provided when used in an [`npm` script](https://docs.npmjs.com/cli/v6/using-npm/scripts).

---
_Source: https://npm.io/package/cargo-cp-artifact · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._