Updates.

Author: tjprescott

.github/workflows/src/api-md-consistency/api-md-consistency.js

@@ -44,7 +44,7 @@ function formatIssueSection(title, apiFiles) {
     const packageName = path.basename(packageDir);
     lines.push(`- ${packageDir}`);
     lines.push(`  API file: ${apiFile}`);
-    lines.push(`  Regenerate: azpysdk apistub --md --extract-metadata ${packageName}`);
+    lines.push(`  Regenerate: azpysdk apistub --md --extract-metadata ${packageName} --dest-dir ${packageDir}`);
   }
   lines.push("");
   return lines.join("\n");

scripts/api_md_workflow/README.md

@@ -22,7 +22,7 @@ It runs on pull requests for changes under `sdk/**`.
 - Regenerates `api.md` for those packages.
 - Fails if the generated files differ from the committed files.
 - Fails if an affected package does not have a committed `api.md`.
-- Prints the mismatched or missing packages and the `azpysdk apistub --md --extract-metadata` command needed to regenerate each `api.md` file.
+- Prints the mismatched or missing packages and the `azpysdk apistub --md --extract-metadata <package-name> --dest-dir <package-dir>` command needed to regenerate each `api.md` file.
 
 ## Script Layout
 
@@ -49,7 +49,7 @@ Also writes `count=<n>` to `GITHUB_OUTPUT`.
 
 ### `regenerate.js`
 
-Reads package directories from `API_MD_PACKAGES_FILE` and runs `azpysdk apistub --md --extract-metadata <package-name>` for each package.
+Reads package directories from `API_MD_PACKAGES_FILE` and runs `azpysdk apistub --md --extract-metadata <package-name> --dest-dir <package-dir>` for each package.
 
 This script is used by the consistency check.
 
@@ -100,4 +100,4 @@ Common variables include:
 3. `find_affected.js` determines which packages were touched.
 4. `regenerate.js` rebuilds `api.md` for those packages.
 5. `find_mismatches.js` records any `api.md` drift, including missing or untracked `api.md` files.
-6. If drift is found, the workflow fails and prints the affected packages plus the `azpysdk apistub --md --extract-metadata <package-name>` command to regenerate each `api.md` file locally.
+6. If drift is found, the workflow fails and prints the affected packages plus the `azpysdk apistub --md --extract-metadata <package-name> --dest-dir <package-dir>` command to regenerate each `api.md` file locally.

sdk/template/azure-template/sdk/template/azure-template/api.md

@@ -0,0 +1,12 @@
+```py
+namespace azure.template
+
+    def azure.template.template_main() -> bool: ...
+
+
+namespace azure.template.template_code
+
+    def azure.template.template_code.template_main() -> bool: ...
+
+
+```

sdk/template/azure-template/sdk/template/azure-template/api.metadata.yml

@@ -0,0 +1,3 @@
+apiMdSha256: 9b0fa6154e3a859680da1a07f5106508983884de567522c5166fc57bacb9cb00
+parserVersion: 0.3.28
+pythonVersion: 3.12.9