Publish wasm API to npm

.github/workflows/ci.yaml

@@ -111,7 +111,7 @@ jobs:
       - name: "Clippy"
         run: cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
       - name: "Clippy (wasm)"
-        run: cargo clippy -p ruff_wasm --target wasm32-unknown-unknown --all-features --locked -- -D warnings
+        run: cargo clippy -p ruff-api --target wasm32-unknown-unknown --all-features --locked -- -D warnings
 
   cargo-test-linux:
     name: "cargo test (linux)"

.github/workflows/publish-wasm.yml

@@ -0,0 +1,42 @@
+# Build and publish ruff-api for wasm.
+#
+# Assumed to run as a subworkflow of .github/workflows/release.yml; specifically, as a publish
+# job within `cargo-dist`.
+name: "Build and publish wasm"
+
+on:
+  workflow_call:
+    inputs:
+      plan:
+        required: true
+        type: string
+
+env:
+  CARGO_INCREMENTAL: 0
+  CARGO_NET_RETRY: 10
+  CARGO_TERM_COLOR: always
+  RUSTUP_MAX_RETRIES: 10
+
+jobs:
+  ruff_wasm:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: "Install Rust toolchain"
+        run: rustup target add wasm32-unknown-unknown
+      - uses: jetli/wasm-pack-action@v0.4.0
+      - uses: jetli/wasm-bindgen-action@v0.2.0
+      - name: "Run wasm-pack build"
+        run: wasm-pack build --target web --scope astral-sh crates/ruff_wasm
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          registry-url: "https://registry.npmjs.org"
+      - run: cp LICENSE crates/ruff_wasm/pkg # wasm-pack does not put the LICENSE file in the pkg
+      - name: "Publish"
+        run: npm publish --provenance --access public crates/ruff_wasm/pkg
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/release.yml

@@ -214,16 +214,31 @@ jobs:
       "id-token": "write"
       "packages": "write"
 
+  custom-publish-wasm:
+    needs:
+      - plan
+      - host
+    if: ${{ !fromJson(needs.plan.outputs.val).announcement_is_prerelease || fromJson(needs.plan.outputs.val).publish_prereleases }}
+    uses: ./.github/workflows/publish-wasm.yml
+    with:
+      plan: ${{ needs.plan.outputs.val }}
+    secrets: inherit
+    # publish jobs get escalated permissions
+    permissions:
+      "id-token": "write"
+      "packages": "write"
+
   # Create a GitHub Release while uploading all files to it
   announce:
     needs:
       - plan
       - host
       - custom-publish-pypi
+      - custom-publish-wasm
     # use "always() && ..." to allow us to wait for all publish jobs while
     # still allowing individual publish jobs to skip themselves (for prereleases).
     # "host" however must run to completion, no skipping allowed!
-    if: ${{ always() && needs.host.result == 'success' && (needs.custom-publish-pypi.result == 'skipped' || needs.custom-publish-pypi.result == 'success') }}
+    if: ${{ always() && needs.host.result == 'success' && (needs.custom-publish-pypi.result == 'skipped' || needs.custom-publish-pypi.result == 'success') && (needs.custom-publish-wasm.result == 'skipped' || needs.custom-publish-wasm.result == 'success') }}
     runs-on: "ubuntu-20.04"
     env:
       GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Cargo.toml

@@ -272,7 +272,7 @@ build-local-artifacts = false
 # Local artifacts jobs to run in CI
 local-artifacts-jobs = ["./build-binaries", "./build-docker"]
 # Publish jobs to run in CI
-publish-jobs = ["./publish-pypi"]
+publish-jobs = ["./publish-pypi", "./publish-wasm"]
 # Announcement jobs to run in CI
 post-announce-jobs = ["./notify-dependents", "./publish-docs", "./publish-playground"]
 # Custom permissions for GitHub Jobs

crates/ruff_wasm/Cargo.toml

 ] 
 version_files = [ 
   "README.md", 
   "docs/integrations.md", 
   "crates/ruff/Cargo.toml", 
   "crates/ruff_linter/Cargo.toml", 
   "scripts/benchmarks/pyproject.toml", 
 ] 
@@ -1,6 +1,6 @@
 [package]
-name = "ruff_wasm"
-version = "0.0.0"
+name = "ruff-api"
+version = "0.5.1"
 publish = false
 authors = { workspace = true }
 edition = { workspace = true }

crates/ruff_wasm/README.md

@@ -0,0 +1,41 @@
+# Ruff API
+
+[**Docs**](https://docs.astral.sh/ruff/) | [**Playground**](https://play.ruff.rs/)
+
+An extremely fast Python linter and code formatter, written in Rust.
+
+This is a WASM version of the Ruff API which can be used to lint/format Python in a browser environment.
+
+## Usage
+
+```ts
+import init, { Workspace, type Diagnostic } from '@astral-sh/ruff-api';
+
+const exampleDocument = `print('hello'); print("world")`
+
+await init(); // Initializes WASM module
+
+// These are default settings just to illustrate configuring Ruff
+// Settings info: https://docs.astral.sh/ruff/settings
+const workspace = new Workspace({
+  'line-length': 88,
+  'indent-width': 4,
+  format: {
+    'indent-style': 'space',
+    'quote-style': 'double',
+  },
+  lint: {
+    select: [
+      'E4',
+      'E7',
+      'E9',
+      'F'
+    ],
+  },
+});
+
+// Will contain 1 diagnostic code for E702: Multiple statements on one line
+const diagnostics: Diagnostic[] = workspace.check(exampleDocument);
+
+const formatted = workspace.format(exampleDocument);
+```

crates/ruff_wasm/tests/api.rs

@@ -2,9 +2,9 @@
 
 use wasm_bindgen_test::wasm_bindgen_test;
 
+use ruff_api::{ExpandedMessage, Workspace};
 use ruff_linter::registry::Rule;
 use ruff_source_file::{OneIndexed, SourceLocation};
-use ruff_wasm::{ExpandedMessage, Workspace};
 
 macro_rules! check {
     ($source:expr, $config:expr, $expected:expr) => {{

playground/src/Editor/Editor.tsx

@@ -7,7 +7,7 @@ import {
 } from "react";
 import { Panel, PanelGroup } from "react-resizable-panels";
 import { DEFAULT_PYTHON_SOURCE } from "../constants";
-import init, { Diagnostic, Workspace } from "../pkg/ruff_wasm";
+import init, { Diagnostic, Workspace } from "../pkg/ruff_api";
 import { ErrorMessage } from "./ErrorMessage";
 import Header from "./Header";
 import PrimarySideBar from "./PrimarySideBar";

pyproject.toml

@@ -108,5 +108,6 @@ version_files = [
   "docs/integrations.md",
   "crates/ruff/Cargo.toml",
   "crates/ruff_linter/Cargo.toml",
+  "crates/ruff_wasm/Cargo.toml",
   "scripts/benchmarks/pyproject.toml",
 ]