APIView for Rust

.gitignore

@@ -517,4 +517,5 @@ tools/apiview/emitters/typespec-apiview/temp/
 
 # Issue Labeler Deploy
 tools/issue-labeler/src/IssueLabeler/Properties/*Zip Deploy.json
-tools/issue-labeler/src/IssueLabeler/Properties/ServiceDependencies/
+tools/issue-labeler/src/IssueLabeler/Properties/ServiceDependencies/
+tools/apiview/parsers/js-api-parser/

tools/apiview/parsers/rust-api-parser/.gitignore

@@ -0,0 +1,4 @@
+inputs
+node_modules
+outputs
+expected-outputs

tools/apiview/parsers/rust-api-parser/.prettierrc.json

@@ -0,0 +1,9 @@
+{
+  "arrowParens": "always",
+  "bracketSpacing": true,
+  "endOfLine": "lf",
+  "printWidth": 100,
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2
+}

tools/apiview/parsers/rust-api-parser/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 1.0.0-beta.1
+
+Marks the 1.0.0-beta.1 release of rust-api-parser.

tools/apiview/parsers/rust-api-parser/README.md

@@ -0,0 +1,24 @@
+## Rust SDK APIView Exporter
+This TypeScript project reads a cleaned Rustdoc JSON file from the azure-sdk-for-rust repository and generates a new Rust API view capturing the exported API surface. This project organizes the API elements into modules, functions, and other Rust constructs. and preserves the parent-child hierarchy.
+
+### Features
+- Reads a Rustdoc JSON file (docs.rust.json).
+- Extracts the exported API surface.
+- Filters items to include only those with public visibility.
+- Preserves the parent-child hierarchy.
+- Writes the exported API surface to a JSON file based on the expected APIView JSON schema.
+
+### Prerequisites
+- Node.js and npm installed. You can install Node.js from nodejs.org.
+
+## Usage
+- `npm install`
+- `npm run-script build`
+
+### Run the project:
+- `node ./dist/main.js {input_file_path} {output_file_path}`
+    - Example: `node ./dist/main.js /workspaces/azure-sdk-tools/tools/apiview/parsers/rust-api-parser/inputs/azure_core.rust.json /workspaces/azure-sdk-tools/tools/apiview/parsers/rust-api-parser/outputs/azure_core.json`
+    - Or if you have the package installed, you can run `rust-genapi <input_file_path> <output_file_path>`.
+
+### License
+This project is licensed under the MIT License. See the LICENSE file for details.

tools/apiview/parsers/rust-api-parser/ci.yml

@@ -0,0 +1,113 @@
+# NOTE: Please refer to https://aka.ms/azsdk/engsys/ci-yaml before editing this file.
+trigger:
+  branches:
+    include:
+      - main
+      - feature/*
+      - release/*
+      - hotfix/*
+  paths:
+    include:
+      - tools/apiview/parsers/rust-api-parser
+
+pr:
+  branches:
+    include:
+      - main
+      - feature/*
+      - release/*
+      - hotfix/*
+  paths:
+    include:
+      - tools/apiview/parsers/rust-api-parser
+
+extends:
+  template: /eng/pipelines/templates/stages/1es-redirect.yml
+  parameters:
+    stages:
+      - stage: 'Build'
+        variables:
+          - template: /eng/pipelines/templates/variables/image.yml
+          - name: NodeVersion
+            value: '18.x'
+          - name: ArtifactName
+            value: 'apiview'
+          - name: RustGeneratorDirectory
+            value: 'tools/apiview/parsers/rust-api-parser'
+        jobs:
+          - job: 'Build'
+
+            pool:
+              name: $(LINUXNEXTPOOL)
+              image: $(LINUXNEXTVMIMAGE)
+              os: linux
+
+            steps:
+              - task: NodeTool@0
+                inputs:
+                  versionSpec: '$(NodeVersion)'
+                displayName: 'Use NodeJS $(NodeVersion)'
+
+              - script: |
+                  npm install -g [email protected]
+                displayName: "Install npm 8.16.0"
+
+              - script: |
+                  npm install
+                workingDirectory: $(RustGeneratorDirectory)
+                displayName: "Install npm packages Rust generator"
+
+              - script: |
+                  npm run-script build
+                workingDirectory: $(RustGeneratorDirectory)
+                displayName: "Build Rust generator"
+
+              - pwsh: |
+                  npm pack $(RustGeneratorDirectory)
+                  Copy-Item ./*.tgz $(Build.ArtifactStagingDirectory)
+                displayName: "Pack Rust generator"
+
+              - task: 1ES.PublishPipelineArtifact@1
+                inputs:
+                  targetPath: '$(Build.ArtifactStagingDirectory)'
+                  artifactName: $(ArtifactName)
+
+      - ${{if and(eq(variables['Build.Reason'], 'Manual'), eq(variables['System.TeamProject'], 'internal'))}}:
+        - stage: 'Release'
+          dependsOn: Build
+          condition: Succeeded()
+          variables:
+            - template: /eng/pipelines/templates/variables/image.yml
+            - name: ArtifactName
+              value: 'apiview'
+            - name: FeedRegistry
+              value: 'https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-rust/npm/registry/'
+          jobs:
+          - job: PublishPackage
+            displayName: 'Publish rust-genapi package to devops feed'
+            pool:
+              name: $(LINUXNEXTPOOL)
+              image: $(LINUXNEXTVMIMAGE)
+              os: linux
+            steps:
+            - checkout: none
+            - download: current
+
+            - pwsh: |
+                $detectedPackageName=Get-ChildItem $(Pipeline.Workspace)/$(ArtifactName)/*.tgz
+                Write-Host "Detected package name: $detectedPackageName"
+                $registry="$(FeedRegistry)"
+                $regAuth=$registry.replace("https:","")
+                $npmReg = $regAuth.replace("registry/","");
+                $env:NPM_TOKEN="$(azure-sdk-devops-npm-token)"
+                Write-Host "Publishing to $($regAuth)"
+                npm config set $regAuth`:username=azure-sdk
+                npm config set $regAuth`:_password=`$`{NPM_TOKEN`}
+                npm config set $regAuth`:email=not_set
+                npm config set $npmReg`:username=azure-sdk
+                npm config set $npmReg`:_password=`$`{NPM_TOKEN`}
+                npm config set $npmReg`:email=not_set
+                Write-Host "Publishing package"
+                Write-Host "npm publish $detectedPackageName --registry=$registry --always-auth=true"
+                npm publish $detectedPackageName --registry=$registry --always-auth=true
+              displayName: Publish package

tools/apiview/parsers/rust-api-parser/eslint.config.mjs

@@ -0,0 +1,10 @@
+// @ts-check
+
+import eslint from "@eslint/js";
+import tsEslint from "typescript-eslint";
+
+export default tsEslint.config(
+  { ignores: ["bin", "dist"] },
+  eslint.configs.recommended,
+  ...tsEslint.configs.recommended,
+);