fastfmt 0.1.0__tar.gz

fastfmt-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.12'
+      - run: pip install -e '.[dev]'
+      - run: pytest -q
+
+  build:
+    needs: test
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7
+      - uses: PyO3/maturin-action@v1
+        with:
+          args: --release --out dist
+          manylinux: 2_28
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-${{ matrix.os }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: -o dist
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-sdist
+          path: dist
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [build, sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: softprops/action-gh-release@v3
+        with:
+          files: dist/*
+          generate_release_notes: true
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

fastfmt-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+tags
+target/
+dist/
+build/
+.venv/
+venv/
+.env
+.DS_Store
+.ipynb_checkpoints/
+Cargo.lock

fastfmt-0.1.0/Cargo.lock

@@ -0,0 +1,225 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "cc"
+version = "1.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ad534f4357a5264cce5019c989cf66a4f0dc4e0d1b1d15f8aacec0ff7360273"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "fastfmt"
+version = "0.1.0"
+dependencies = [
+ "tree-sitter",
+ "tree-sitter-rust",
+]
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d45db016d36b838f563236e9193d0ee6ce38f3f68b6c94e914b4929c96bbb890"
+
+[[package]]
+name = "hashbrown"
+version = "0.17.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed5909b6e89a2db4456e54cd5f673791d7eca6732202bbf2a9cc504fe2f9b84a"
+
+[[package]]
+name = "indexmap"
+version = "2.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d466e9454f08e4a911e14806c24e16fba1b4c121d1ea474396f396069cf949d9"
+dependencies = [
+ "equivalent",
+ "hashbrown",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "regex"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f020237b6c8eed93db2e2cb53c00c60a8e1bc73da7d073199a1180401450218d"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+
+[[package]]
+name = "serde"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.151"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c841b55ecdae098c80dcae9cf767f6f8a0c2cdb3416bbef72181df4d0fe73f14"
+dependencies = [
+ "indexmap",
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+
+[[package]]
+name = "streaming-iterator"
+version = "0.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2b2231b7c3057d5e4ad0156fb3dc807d900806020c5ffa3ee6ff2c8c76fb8520"
+
+[[package]]
+name = "syn"
+version = "3.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6275cddf4610d1775e6d1fe9469b2e77d0f39fd98fb7450901b821e0c53649f"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "tree-sitter"
+version = "0.25.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78f873475d258561b06f1c595d93308a7ed124d9977cb26b148c2084a4a3cc87"
+dependencies = [
+ "cc",
+ "regex",
+ "regex-syntax",
+ "serde_json",
+ "streaming-iterator",
+ "tree-sitter-language",
+]
+
+[[package]]
+name = "tree-sitter-language"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "009994f150cc0cd50ff54917d5bc8bffe8cad10ca10d81c34da2ec421ae61782"
+
+[[package]]
+name = "tree-sitter-rust"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "439e577dbe07423ec2582ac62c7531120dbfccfa6e5f92406f93dd271a120e45"
+dependencies = [
+ "cc",
+ "tree-sitter-language",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

fastfmt-0.1.0/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "fastfmt"
+version = "0.1.0"
+edition = "2021"
+license = "Apache-2.0"
+description = "cargo fmt plus fastai-style compaction: keeps simple one-line constructs on one line"
+readme = "README.md"
+
+[[bin]]
+name = "cargo-fastfmt"
+path = "src/main.rs"
+
+[dependencies]
+tree-sitter = "0.25"
+tree-sitter-rust = "0.24"

fastfmt-0.1.0/DEV.md

@@ -0,0 +1,38 @@
+# Development
+
+## Design
+
+Everything lives in `src/main.rs`. `fastfmt()` pipes a file through `rustfmt
+--emit stdout` (width and `use_small_heuristics=Max` passed via `--config`, so
+target crates need no rustfmt.toml), then `compact()` re-joins. Joining is
+syntax-aware via tree-sitter: `join_limit` names the joinable node kinds and
+their item limits, `joined` renders a candidate onto one line (dropping a
+trailing comma, adding no space before `.`-led continuations), and
+`compact_round` applies innermost candidates first, iterating to a fixpoint so
+nested one-liners collapse. Anything containing a comment or a multi-line
+token never joins.
+
+The tuning benchmark is AnswerDotAI/loopmini: run stable `cargo fmt` on its
+`src/`, then `cargo-fastfmt`, and diff against the original. The join caps
+(105, and 80 for two-statement blocks) come from that exercise; the remaining
+diff should be only rustfmt canonicalisations such as import order and
+trailing semicolons.
+
+## Commands
+
+```bash
+maturin develop && pytest -q
+ship-rs-build
+```
+
+## Versioning
+
+The canonical version lives in `Cargo.toml`. `pyproject.toml` gets the Python package version from Cargo via `dynamic = ["version"]`.
+
+## Release
+
+1. Run `maturin develop && pytest -q`.
+2. Confirm the release version in `Cargo.toml` (`[package].version`).
+3. Run `ship-release`.
+
+Fastship commits the changelog, pushes the version tag for GitHub Actions, then bumps and pushes `Cargo.toml`.

fastfmt-0.1.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

fastfmt-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: fastfmt
+Version: 0.1.0
+Classifier: Programming Language :: Rust
+Requires-Dist: fastship>=0.0.11 ; extra == 'dev'
+Requires-Dist: maturin>=1.0,<2.0 ; extra == 'dev'
+Requires-Dist: pytest ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
+Summary: cargo fmt plus fastai-style compaction: keeps simple one-line constructs on one line
+Author-email: Jeremy Howard <github@jhoward.fastmail.fm>
+License: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/AnswerDotAI/fastfmt
+Project-URL: Issues, https://github.com/AnswerDotAI/fastfmt/issues
+Project-URL: Repository, https://github.com/AnswerDotAI/fastfmt
+
+# fastfmt
+
+`cargo fmt`, then put the one-liners back.
+
+Stable rustfmt always breaks small constructs onto multiple lines: a
+single-expression fn body, a statement-position if/else, a short match or
+struct body. The options that would prevent this are nightly-only, and some
+shapes have no option at all. fastfmt runs rustfmt (via stdin, so no config
+file is needed), then re-joins those constructs when they are comment-free,
+small, and within a width cap, giving fastai-style compact Rust from a stable
+toolchain.
+
+## Install
+
+```bash
+pip install fastfmt
+```
+
+The wheel ships a single `cargo-fastfmt` binary and no Python code. With it on
+PATH, cargo picks it up as a subcommand:
+
+```bash
+cargo fastfmt            # format the current directory tree in place
+cargo fastfmt --check    # exit 1 listing files that would change; write nothing
+cargo fastfmt src lib.rs # format specific files or directories
+```
+
+`--width N` sets the rustfmt line cap (default 130). Joined one-liners use
+tighter caps: 105 columns, or 80 for a two-statement block. rustfmt must be on
+PATH (`rustup component add rustfmt`).
+
+## What gets joined
+
+A block joins onto one line only when nothing in it is a comment or spans
+multiple lines itself, and the result fits the cap: fn bodies with one
+statement, if/else and loop bodies with one or two, match/struct/enum bodies
+with up to three arms, variants, or fields, and single-item impl blocks.
+Joins run innermost-first to a fixpoint, so nested one-liners collapse fully.
+Match arms stay expanded, and any block containing a comment or a multi-line
+string is left exactly as rustfmt wrote it.
+

fastfmt-0.1.0/README.md

@@ -0,0 +1,40 @@
+# fastfmt
+
+`cargo fmt`, then put the one-liners back.
+
+Stable rustfmt always breaks small constructs onto multiple lines: a
+single-expression fn body, a statement-position if/else, a short match or
+struct body. The options that would prevent this are nightly-only, and some
+shapes have no option at all. fastfmt runs rustfmt (via stdin, so no config
+file is needed), then re-joins those constructs when they are comment-free,
+small, and within a width cap, giving fastai-style compact Rust from a stable
+toolchain.
+
+## Install
+
+```bash
+pip install fastfmt
+```
+
+The wheel ships a single `cargo-fastfmt` binary and no Python code. With it on
+PATH, cargo picks it up as a subcommand:
+
+```bash
+cargo fastfmt            # format the current directory tree in place
+cargo fastfmt --check    # exit 1 listing files that would change; write nothing
+cargo fastfmt src lib.rs # format specific files or directories
+```
+
+`--width N` sets the rustfmt line cap (default 130). Joined one-liners use
+tighter caps: 105 columns, or 80 for a two-statement block. rustfmt must be on
+PATH (`rustup component add rustfmt`).
+
+## What gets joined
+
+A block joins onto one line only when nothing in it is a comment or spans
+multiple lines itself, and the result fits the cap: fn bodies with one
+statement, if/else and loop bodies with one or two, match/struct/enum bodies
+with up to three arms, variants, or fields, and single-item impl blocks.
+Joins run innermost-first to a fixpoint, so nested one-liners collapse fully.
+Match arms stay expanded, and any block containing a comment or a multi-line
+string is left exactly as rustfmt wrote it.

fastfmt-0.1.0/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-minimal

fastfmt-0.1.0/_layouts/default.html

@@ -0,0 +1,52 @@
+<!DOCTYPE html>
+<html lang="{{ site.lang | default: "en-US" }}">
+  <head>
+    <meta charset="UTF-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+
+{% seo %}
+    <link rel="stylesheet" href="{{ "/assets/css/style.css?v=" | append: site.github.build_revision | relative_url }}">
+    {% include head-custom.html %}
+  </head>
+  <body>
+    <div class="wrapper">
+      <header>
+        <h1><a href="{{ "/" | absolute_url }}">{{ site.title | default: site.github.repository_name }}</a></h1>
+
+        {% if site.logo %}
+          <img src="{{site.logo | relative_url}}" alt="Logo" />
+        {% endif %}
+
+        <p>{{ site.description | default: site.github.project_tagline }}</p>
+
+        {% if site.github.is_project_page %}
+        <p class="view"><a href="{{ site.github.repository_url }}">View the Project on GitHub <small>{{ site.github.repository_nwo }}</small></a></p>
+        {% endif %}
+
+        {% if site.github.is_user_page %}
+        <p class="view"><a href="{{ site.github.owner_url }}">View My GitHub Profile</a></p>
+        {% endif %}
+
+        {% if site.show_downloads %}
+        <ul class="downloads">
+          <li><a href="{{ site.github.zip_url }}">Download <strong>ZIP File</strong></a></li>
+          <li><a href="{{ site.github.tar_url }}">Download <strong>TAR Ball</strong></a></li>
+          <li><a href="{{ site.github.repository_url }}">View On <strong>GitHub</strong></a></li>
+        </ul>
+        {% endif %}
+      </header>
+      <section>
+
+      {{ content }}
+
+      </section>
+      <footer>
+        {% if site.github.is_project_page %}
+        <p>This project is maintained by <a href="{{ site.github.owner_url }}">{{ site.github.owner_name }}</a></p>
+        {% endif %}
+      </footer>
+    </div>
+    <script src="{{ "/assets/js/scale.fix.js" | relative_url }}"></script>
+  </body>
+</html>

fastfmt-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "fastfmt"
+dynamic = ["version"]
+description = "cargo fmt plus fastai-style compaction: keeps simple one-line constructs on one line"
+license = {text = "Apache-2.0"}
+requires-python = ">=3.10"
+readme = "README.md"
+authors = [{name = "Jeremy Howard", email = "github@jhoward.fastmail.fm"}]
+classifiers = ["Programming Language :: Rust"]
+
+[project.optional-dependencies]
+dev = ["fastship>=0.0.11", "maturin>=1.0,<2.0", "pytest"]
+
+[project.urls]
+Homepage = "https://github.com/AnswerDotAI/fastfmt"
+Repository = "https://github.com/AnswerDotAI/fastfmt"
+Issues = "https://github.com/AnswerDotAI/fastfmt/issues"
+
+[tool.maturin]
+bindings = "bin"
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "src/**/*.rs" }, { file = "Cargo.toml" }, { file = "Cargo.lock" }]
+
+[tool.fastship]
+branch = "main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

fastfmt-0.1.0/src/main.rs

@@ -0,0 +1,224 @@
+//! fastfmt: rustfmt, then re-join the short constructs the house style keeps on
+//! one line. rustfmt (stable) always breaks fn bodies, statement if/else, loop
+//! bodies, and short match/struct/enum/impl bodies onto multiple lines; the
+//! compaction pass joins any such block back when it is comment-free, within the
+//! width cap, and small (fn/impl: 1 item, control-flow blocks: 2 statements,
+//! comma-separated bodies: 3 items). Joins run innermost-first to a fixpoint, so
+//! nested one-liners collapse fully.
+use std::io::Write;
+use std::path::{Path, PathBuf};
+use std::process::{Command, Stdio};
+use tree_sitter::{Node, Parser};
+
+const DEFAULT_WIDTH: usize = 150; // when neither --width nor a rustfmt.toml max_width applies
+
+fn parser() -> Parser {
+    let mut p = Parser::new();
+    p.set_language(&tree_sitter_rust::LANGUAGE.into()).unwrap();
+    p
+}
+
+/// Statement/item count limit for a joinable body, or None when `kind` never joins.
+fn join_limit(node: &Node) -> Option<usize> {
+    match node.kind() {
+        "block" if node.parent().is_some_and(|p| p.kind() == "function_item") => Some(1),
+        "block" if node.parent().is_some_and(|p| p.kind() == "match_arm") => None, // arms stay expanded
+        "block" => Some(2),
+        "match_block" | "field_declaration_list" | "enum_variant_list" => Some(3),
+        "declaration_list" => Some(1),
+        _ => None,
+    }
+}
+
+fn has_multiline_leaf(node: Node, src: &str) -> bool {
+    let mut c = node.walk();
+    let mut stack = vec![node];
+    while let Some(n) = stack.pop() {
+        if n.child_count() == 0 && src[n.byte_range()].contains('\n') { return true }
+        if n.kind().contains("comment") { return true }
+        stack.extend(n.children(&mut c));
+    }
+    false
+}
+
+/// True when `block` ends with a return/break/continue statement, whose
+/// rustfmt-added trailing semicolon can drop in the one-line form.
+fn ends_jump(node: &Node) -> bool {
+    if node.kind() != "block" || node.named_child_count() == 0 { return false }
+    let last = node.named_child(node.named_child_count() - 1).unwrap();
+    last.kind() == "expression_statement"
+        && last.child(0).is_some_and(|c| matches!(c.kind(), "return_expression" | "break_expression" | "continue_expression"))
+}
+
+/// `node`'s text joined onto one line, or None when it must stay multi-line:
+/// not a joinable kind, too many items, comment-bearing, or over its width cap.
+fn joined(node: Node, src: &str, width: usize) -> Option<String> {
+    let limit = join_limit(&node)?;
+    let text = &src[node.byte_range()];
+    if !text.contains('\n') { return None }
+    if node.named_child_count() > limit { return None }
+    if has_multiline_leaf(node, src) { return None }
+    let mut out = String::with_capacity(text.len());
+    for (i, line) in text.lines().enumerate() {
+        let line = if i > 0 { line.trim_start() } else { line };
+        // No space before a continuation that rustfmt broke at an operator or delimiter
+        if i > 0 && !line.starts_with(['.', ',', ';', '?', ')', ']']) { out.push(' ') }
+        out.push_str(line);
+    }
+    let out = out.replace(", }", " }");
+    let out = if ends_jump(&node) && out.ends_with("; }") { format!("{} }}", &out[..out.len() - 3]) } else { out };
+    let prefix = src[..node.start_byte()].rfind('\n').map_or(0, |p| node.start_byte() - p - 1);
+    let suffix = src[node.end_byte()..].find('\n').unwrap_or(0);
+    if prefix + out.len() + suffix > width { return None }
+    Some(out)
+}
+
+/// One compaction round: join every innermost joinable block, return the new text.
+fn compact_round(src: &str, width: usize) -> String {
+    let tree = parser().parse(src, None).unwrap();
+    let mut edits: Vec<(std::ops::Range<usize>, String)> = vec![];
+    let mut stack = vec![tree.root_node()];
+    let mut c = tree.root_node().walk();
+    while let Some(n) = stack.pop() {
+        if let Some(j) = joined(n, src, width) {
+            edits.push((n.byte_range(), j));
+            continue; // children are inside the joined text; skip them
+        }
+        stack.extend(n.children(&mut c));
+    }
+    edits.sort_by(|a, b| b.0.start.cmp(&a.0.start));
+    let mut out = src.to_string();
+    for (r, j) in edits { out.replace_range(r, &j) }
+    out
+}
+
+pub fn compact(src: &str, width: usize) -> String {
+    let mut cur = src.to_string();
+    for _ in 0..5 {
+        let next = compact_round(&cur, width);
+        if next == cur { break }
+        cur = next;
+    }
+    cur
+}
+
+/// Format `src` with rustfmt (stdin mode, sharing our width cap), then compact.
+fn fastfmt(src: &str, edition: &str, width: usize) -> Result<String, String> {
+    let mut child = Command::new("rustfmt")
+        .args(["--edition", edition, "--emit", "stdout", "--config", &format!("max_width={width},use_small_heuristics=Max")])
+        .stdin(Stdio::piped()).stdout(Stdio::piped()).stderr(Stdio::piped())
+        .spawn().map_err(|e| format!("failed to run rustfmt: {e}"))?;
+    child.stdin.take().unwrap().write_all(src.as_bytes()).map_err(|e| e.to_string())?;
+    let out = child.wait_with_output().map_err(|e| e.to_string())?;
+    if !out.status.success() { return Err(String::from_utf8_lossy(&out.stderr).into_owned()) }
+    Ok(compact(&String::from_utf8_lossy(&out.stdout), width))
+}
+
+/// The value at `key` in the nearest `file` at or above `path`, e.g. the edition
+/// from Cargo.toml or max_width from rustfmt.toml.
+fn toml_lookup(path: &Path, file: &str, key: &str) -> Option<String> {
+    for dir in path.canonicalize().unwrap_or_else(|_| path.to_path_buf()).ancestors() {
+        if let Ok(t) = std::fs::read_to_string(dir.join(file)) {
+            return t.lines().find(|l| l.trim_start().starts_with(key))
+                .and_then(|l| l.split('=').nth(1))
+                .map(|v| v.trim().trim_matches('"').to_string());
+        }
+    }
+    None
+}
+
+fn edition_for(path: &Path) -> String { toml_lookup(path, "Cargo.toml", "edition").unwrap_or_else(|| "2021".into()) }
+
+/// `--width` beats the nearest rustfmt.toml's max_width, which beats the default.
+fn width_for(path: &Path, flag: Option<usize>) -> usize {
+    flag.or_else(|| toml_lookup(path, "rustfmt.toml", "max_width").and_then(|w| w.parse().ok())).unwrap_or(DEFAULT_WIDTH)
+}
+
+fn rs_files(path: &Path, out: &mut Vec<PathBuf>) {
+    if path.is_file() {
+        if path.extension().is_some_and(|e| e == "rs") { out.push(path.to_path_buf()) }
+        return;
+    }
+    let name = path.file_name().and_then(|n| n.to_str()).unwrap_or("");
+    if name == "target" || name.starts_with('.') && name.len() > 1 { return }
+    if let Ok(rd) = std::fs::read_dir(path) {
+        for e in rd.flatten() { rs_files(&e.path(), out) }
+    }
+}
+
+fn main() {
+    let mut args: Vec<String> = std::env::args().skip(1).collect();
+    if args.first().is_some_and(|a| a == "fastfmt") { args.remove(0); } // invoked as `cargo fastfmt`
+    let check = args.iter().any(|a| a == "--check");
+    let width_flag = args.iter().position(|a| a == "--width")
+        .and_then(|i| args.get(i + 1)).and_then(|w| w.parse().ok());
+    let mut paths: Vec<PathBuf> = vec![];
+    let mut skip = false;
+    for (i, a) in args.iter().enumerate() {
+        if skip { skip = false; continue }
+        match a.as_str() {
+            "--check" => {}
+            "--width" => skip = true,
+            _ if i > 0 && args[i - 1] == "--width" => {}
+            p => paths.push(p.into()),
+        }
+    }
+    if paths.is_empty() { paths.push(".".into()) }
+    let mut files = vec![];
+    for p in &paths { rs_files(p, &mut files) }
+    files.sort();
+    let mut dirty = vec![];
+    for f in &files {
+        let src = match std::fs::read_to_string(f) { Ok(s) => s, Err(e) => { eprintln!("{}: {e}", f.display()); std::process::exit(2) } };
+        match fastfmt(&src, &edition_for(f), width_for(f, width_flag)) {
+            Ok(new) if new != src => {
+                if check { dirty.push(f) } else if let Err(e) = std::fs::write(f, &new) { eprintln!("{}: {e}", f.display()); std::process::exit(2) }
+            }
+            Ok(_) => {}
+            Err(e) => { eprintln!("{}: {e}", f.display()); std::process::exit(2) }
+        }
+    }
+    if check && !dirty.is_empty() {
+        for f in dirty { println!("would reformat {}", f.display()) }
+        std::process::exit(1);
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::compact;
+
+    #[test]
+    fn joins_house_shapes() {
+        let cases = [
+            ("fn f(x: u8) -> u8 {\n    if x > 1 {\n        return 1;\n    }\n    0\n}\n",
+             "fn f(x: u8) -> u8 {\n    if x > 1 { return 1 }\n    0\n}\n"),
+            ("fn time(&self) -> f64 {\n    self.core.time()\n}\n",
+             "fn time(&self) -> f64 { self.core.time() }\n"),
+            ("fn f(c: bool, e: &mut E, h: H) {\n    if c {\n        e.writer = Some(h)\n    } else {\n        e.reader = Some(h)\n    }\n}\n",
+             "fn f(c: bool, e: &mut E, h: H) { if c { e.writer = Some(h) } else { e.reader = Some(h) } }\n"),
+            ("struct FdEntry<H> {\n    reader: Option<H>,\n    writer: Option<H>,\n}\n",
+             "struct FdEntry<H> { reader: Option<H>, writer: Option<H> }\n"),
+            ("enum Rt {\n    Owned(Runtime),\n    Borrowed(Handle),\n}\n",
+             "enum Rt { Owned(Runtime), Borrowed(Handle) }\n"),
+            ("fn drain(&self, q: &mut Q) {\n    while let Some(h) = q.pop_front() {\n        ready.push_back(h)\n    }\n}\n",
+             "fn drain(&self, q: &mut Q) { while let Some(h) = q.pop_front() { ready.push_back(h) } }\n"),
+            ("impl<H> Default for FdEntry<H> {\n    fn default() -> Self {\n        Self { reader: None, writer: None }\n    }\n}\n",
+             "impl<H> Default for FdEntry<H> { fn default() -> Self { Self { reader: None, writer: None } } }\n"),
+            ("fn h(&self) -> Handle {\n    match self {\n        Rt::Owned(r) => r.handle().clone(),\n        Rt::Borrowed(h) => h.clone(),\n    }\n}\n",
+             "fn h(&self) -> Handle { match self { Rt::Owned(r) => r.handle().clone(), Rt::Borrowed(h) => h.clone() } }\n"),
+        ];
+        for (src, want) in cases { assert_eq!(compact(src, 150), want, "src: {src}") }
+    }
+
+    #[test]
+    fn keeps_what_must_stay() {
+        for src in [
+            "fn f() {\n    a();\n    b();\n}\n",                       // two statements in a fn body
+            "fn f() {\n    // why\n    a()\n}\n",                      // comment must survive
+            "fn f() {\n    let s = \"a\nb\";\n}\n",                    // multiline string literal
+        ] { assert_eq!(compact(src, 150), src) }
+        let long = format!("fn f() {{\n    {}()\n}}\n", "x".repeat(160));
+        assert_eq!(compact(&long, 150), long);                    // width cap
+    }
+}

fastfmt-0.1.0/tests/test_cli.py

@@ -0,0 +1,27 @@
+"End-to-end check of the installed binary: rustfmt runs, then compaction joins."
+import subprocess
+
+BROKEN ="""fn time() -> f64 {
+    42.0
+}
+fn pick(c: bool, e: &mut (Option<u8>, Option<u8>)) {
+    if c {
+        e.0 = Some(1)
+    } else {
+        e.1 = Some(2)
+    }
+}
+"""
+
+def test_fastfmt_binary(tmp_path):
+    (tmp_path / 'Cargo.toml').write_text('[package]\nedition = "2021"\n')
+    f = tmp_path / 'main.rs'
+    f.write_text(BROKEN)
+    subprocess.run(['cargo-fastfmt'], cwd=tmp_path, check=True)
+    out = f.read_text()
+    assert 'fn time() -> f64 { 42.0 }' in out
+    assert 'if c { e.0 = Some(1) } else { e.1 = Some(2) }' in out
+    assert subprocess.run(['cargo-fastfmt', '--check'], cwd=tmp_path).returncode == 0
+    f.write_text(BROKEN)
+    r = subprocess.run(['cargo-fastfmt', '--check'], cwd=tmp_path, capture_output=True, text=True)
+    assert r.returncode == 1 and 'main.rs' in r.stdout