qubit-rayon-executor 0.4.0

Rayon-backed CPU-bound executor service for Qubit Rust libraries
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

# Code Formatting Guide

## Overview

This project uses **nightly Rust's `rustfmt`** for code formatting to support advanced formatting features, specifically the `imports_layout = "Vertical"` option.

## Why Nightly?

The `imports_layout` configuration option is an **unstable feature** that requires nightly Rust. This allows us to format imports with each item on its own line:

```rust
pub use module::{
    Item1,
    Item2,
    Item3,
};
```

**Official Documentation:**
- [Rustfmt Configuration Documentation](https://rust.googlesource.com/rustfmt/+/105cbf8ed517d9e42ae1dc837bdc97cc3ff28175/Configurations.md)
- [GitHub Tracking Issue #5083](https://github.com/rust-lang/rustfmt/issues/5083)

## How to Format Code

### Option 1: Manual Format Command (Recommended)

```bash
# Install nightly toolchain (if not already installed)
rustup toolchain install nightly --component rustfmt

# Format code using the same configuration as CI
cargo +nightly fmt -- --config-path .rs-ci/rustfmt.toml
```

### Option 2: CI-Style Local Check

```bash
./align-ci.sh
./ci-check.sh
```

`./align-ci.sh` synchronizes the shared CI helper scripts and formatting
configuration, then `./ci-check.sh` runs the same checks used by CI.

## CI/CD Integration

Both the local CI check script (`ci-check.sh`) and CircleCI configuration (`.circleci/config.yml`) have been configured to use nightly Rust:

- **Local checks**: Run `./ci-check.sh` before committing (automatically installs nightly if needed)
- **CircleCI**: Uses `rustlang/rust:nightly` Docker image for all jobs

## Configuration

The formatting configuration is defined in `.rs-ci/rustfmt.toml`:

```toml
# Format imports with vertical layout (each item on its own line within braces)
imports_layout = "Vertical"
```

This is the **only configuration option** needed to achieve our desired formatting style.

## Important Notes

1. **All CI jobs use nightly Rust**: The entire CI pipeline uses nightly Rust toolchain for consistency
2. **Local development**: Can use either stable or nightly; formatting requires nightly
3. **Automatic installation**: The `ci-check.sh` script automatically installs nightly toolchain if needed
4. **Docker image**: CircleCI uses the official `rustlang/rust:nightly` Docker image
5. **No manual intervention**: Developers don't need to manually switch toolchains

## Troubleshooting

### Format check fails in CI

Make sure your code is formatted before committing:

```bash
cargo +nightly fmt -- --config-path .rs-ci/rustfmt.toml
```

### Nightly toolchain issues

Reinstall the nightly toolchain:

```bash
rustup toolchain uninstall nightly
rustup toolchain install nightly --component rustfmt
```

## References

- [Rustfmt Documentation](https://rust-lang.github.io/rustfmt/)
- [Rustup Documentation](https://rust-lang.github.io/rustup/)