Skip to content

Latest commit

聽

History

History
executable file
路
65 lines (43 loc) 路 1.91 KB

CONTRIBUTING.md

File metadata and controls

executable file
路
65 lines (43 loc) 路 1.91 KB
Raw

Contributing

Development Setup

To get started hacking on mitmproxy_rs, please install mitmproxy as described in the main mitmproxy repository and install the latest Rust release. Make sure that you have mitmproxy's virtualenv activated and run the following:

pip install maturin
git clone https://github.com/mitmproxy/mitmproxy_rs.git

cd mitmproxy_rs/mitmproxy-rs
maturin develop

mitmproxy now uses your locally-compiled version of mitmproxy_rs. After applying any changes to the Rust code, re-run maturin develop and restart mitmproxy for changes to apply.

Testing

If you've followed the procedure above, you can run the basic test suite as follows:

cargo test --workspace

Please ensure that all patches are accompanied by matching changes in the test suite.

Code Style

The format for Rust code is enforced by cargo fmt.
Pull requests will be automatically fixed by CI.

Introspecting the tokio runtime

The asynchronous runtime can be introspected using tokio-console if the crate was built with the tracing feature:

tokio-console http://localhost:6669

There should be no task that is busy when the program is idle, i.e. there should be no busy waiting.

Release Process

If you are the current maintainer of mitmproxy_rs, you can perform the following steps to ship a release:

  1. Make sure that...
    • you are on the main branch with a clean working tree.
    • cargo test is passing without errors.
  2. Bump the version in Cargo.toml.
  3. Run cargo update --workspace to update the lockfile with the new version.
  4. Update CHANGELOG.md.
  5. Commit the changes and tag them.
    • Convention: Tag name is simply the version number, e.g. 1.0.1.
  6. Manually confirm the CI deploy step on GitHub.