feat: Add CircuitMatcher

[lmondada]

No description provided.

[codecov]

Codecov Report

❌ Patch coverage is 91.40271% with 38 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.01%. Comparing base (dc6cfc6) to head (f47dbae).

Files with missing lines	Patch %	Lines
tket/src/rewrite/matcher/adapter.rs	93.64%	18 Missing and 5 partials ⚠️
tket/src/rewrite/matcher.rs	81.25%	15 Missing ⚠️

Additional details and impacted files

@@                  Coverage Diff                  @@
##           lm/new-subcircuit    #1017      +/-   ##
=====================================================
+ Coverage              79.18%   80.01%   +0.83%     
=====================================================
  Files                     96       98       +2     
  Lines                  11674    12116     +442     
  Branches               11403    11845     +442     
=====================================================
+ Hits                    9244     9695     +451     
+ Misses                  1794     1781      -13     
- Partials                 636      640       +4     

Flag	Coverage Δ
python	78.22% <ø> (ø)
rust	80.05% <91.40%> (+0.85%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[hugrbot]

This PR contains breaking changes to the public Rust API.
Please deprecate the old API instead (if possible), or mark the PR with a ! to indicate a breaking change.

cargo-semver-checks summary

--- failure inherent_method_missing: pub method removed or renamed ---

Description:
A publicly-visible method or associated fn is no longer available under its prior name. It may have been renamed or removed entirely.
      ref: https://doc.rust-lang.org/cargo/reference/semver.html#item-remove
     impl: https://github.com/obi1kenobi/cargo-semver-checks/tree/v0.42.0/src/lints/inherent_method_missing.ron

Failed in:
PatternMatch::subcircuit, previously in file /home/runner/work/tket2/tket2/BASELINE_BRANCH/tket/src/portmatching/matcher.rs:99
PatternMatch::subcircuit, previously in file /home/runner/work/tket2/tket2/BASELINE_BRANCH/tket/src/portmatching/matcher.rs:99
CircuitRewrite::subcircuit, previously in file /home/runner/work/tket2/tket2/BASELINE_BRANCH/tket/src/rewrite.rs:117
Subcircuit::signature, previously in file /home/runner/work/tket2/tket2/BASELINE_BRANCH/tket/src/rewrite.rs:57

--- failure method_parameter_count_changed: pub method parameter count changed ---

Description:
A publicly-visible method now takes a different number of parameters.
      ref: https://doc.rust-lang.org/cargo/reference/semver.html#fn-change-arity
     impl: https://github.com/obi1kenobi/cargo-semver-checks/tree/v0.42.0/src/lints/method_parameter_count_changed.ron

Failed in:
tket::rewrite::Subcircuit::nodes now takes 2 parameters instead of 1, in /home/runner/work/tket2/tket2/PR_BRANCH/tket/src/subcircuit.rs:95
tket::rewrite::Subcircuit::node_count now takes 2 parameters instead of 1, in /home/runner/work/tket2/tket2/PR_BRANCH/tket/src/subcircuit.rs:103

--- failure method_requires_different_generic_type_params: method now requires a different number of generic type parameters ---

Description:
A method now requires a different number of generic type parameters than it used to. Uses of this method that supplied the previous number of generic types will be broken.
      ref: https://doc.rust-lang.org/reference/items/generics.html
     impl: https://github.com/obi1kenobi/cargo-semver-checks/tree/v0.42.0/src/lints/method_requires_different_generic_type_params.ron

Failed in:
tket::rewrite::Subcircuit::try_from_nodes takes 1 generic types instead of 0, in /home/runner/work/tket2/tket2/PR_BRANCH/tket/src/subcircuit.rs:69
tket::rewrite::Subcircuit::nodes takes 1 generic types instead of 0, in /home/runner/work/tket2/tket2/PR_BRANCH/tket/src/subcircuit.rs:95
tket::rewrite::Subcircuit::node_count takes 1 generic types instead of 0, in /home/runner/work/tket2/tket2/PR_BRANCH/tket/src/subcircuit.rs:103

--- failure type_allows_fewer_generic_type_params: type now allows fewer generic type parameters ---

Description:
A type now allows fewer generic type parameters than it used to. Uses of this type that supplied all previously-supported generic types will be broken.
      ref: https://doc.rust-lang.org/cargo/reference/semver.html#trait-new-parameter-no-default
     impl: https://github.com/obi1kenobi/cargo-semver-checks/tree/v0.42.0/src/lints/type_allows_fewer_generic_type_params.ron

Failed in:
Struct Subcircuit allows 1 -> 0 generic types in /home/runner/work/tket2/tket2/PR_BRANCH/tket/src/subcircuit.rs:50