feat(typespec-autorest): add `skip-example-copying` emitter option by Copilot · Pull Request #4190 · Azure/typespec-azure

Copilot · 2026-04-03T05:15:23Z

When enabled, the emitter will not copy example files to the output directory. Instead, it will reference the source example files using relative file paths from the output location. Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/5966f0f4-258b-41b9-9753-b3b16cb262f3 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

markcowl

add a changeset for this feature
Add an additional test that verifies correct example example references and no copying in a versioned spec.

Make sure all tests are passing and all files are correctly formatted and that your branch is up to date with main and has no merge issues

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/774e6722-332b-4c31-acf6-e8363ef4a705 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot · 2026-04-03T05:34:33Z

add a changeset for this feature

Add an additional test that verifies correct example example references and no copying in a versioned spec.
...

Added in 9e3df9b:

Changeset at .chronus/changes/skip-example-copying-2026-04-03-05-20-45.md (changeKind: feature)
New versioned spec test that verifies correct relative $ref paths for both v1 and v2 outputs (../../../examples/v1/getPet.json and ../../../examples/v2/getPet.json) and asserts that no example files are copied to either version's output directory

All 468 tests pass, files are formatted, and branch is up to date with main.

markcowl · 2026-04-03T20:59:23Z

/azp run typespec-azure - PR Tools

azure-pipelines · 2026-04-03T20:59:34Z

Azure Pipelines successfully started running 1 pipeline(s).

azure-sdk · 2026-04-03T21:01:06Z

All changed packages have been documented.

✅ @azure-tools/typespec-autorest

Show changes

`@azure-tools/typespec-autorest` - feature ✏️

Added skip-example-copying emitter option. When enabled, example files are not copied to the output directory and x-ms-examples $ref values point directly to the source example files via relative paths.

pkg-pr-new · 2026-04-03T21:02:00Z

Open in StackBlitz

npm i https://pkg.pr.new/@azure-tools/typespec-autorest@4190

commit: d32fb08

azure-sdk · 2026-04-03T21:09:31Z

You can try these changes here

🛝 Playground	🌐 Website

markcowl · 2026-04-03T21:34:31Z

@copilot Please pull the latest from main, ensure there are no merge issues, and ensure that all files are correctly formatting (this PR is currently failing the format check (pnpm format)

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/a5a493be-c2a6-4f3a-afc1-182c25389195 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot · 2026-04-03T21:48:36Z

@copilot Please pull the latest from main, ensure there are no merge issues, and ensure that all files are correctly formatting (this PR is currently failing the format check (pnpm format)

Branch is up to date with main (no merge issues). Fixed the formatting issue in b520b3f — pnpm format had two spots in the test file where prettier wanted to collapse multi-line expressions onto single lines. All 468 tests continue to pass.

markcowl · 2026-04-14T18:40:49Z

@copilot Please update the tsp init feeds for Azure (ARM and data-plane) located in /eng/feeds to use this setting by default, rebuild the feeds and ensure that tests pass. Also update this document: https://azure.github.io/typespec-azure/docs/migrate-swagger/faq/x-ms-examples/ to recommend using the new setting and set the examples directory appropriately (provide a valid example).

Pull the latest from main, ensure no merge issues, only your changes are in the PR, and that all files are formatted correctly and all tests pass.

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/0e356775-70e8-49d6-92a6-ec924dcbba65 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot · 2026-04-14T20:07:57Z

@copilot Please update the tsp init feeds for Azure (ARM and data-plane) located in /eng/feeds to use this setting by default, rebuild the feeds and ensure that tests pass. Also update this document:...

Done in 62c9e93 and 7fc6ab4:

Updated all tspconfig.yaml files in /eng/feeds (ARM, data-plane, ARM standalone, data-plane standalone, ARM canonical) to set skip-example-copying: true by default
Regenerated feed snapshots (__snapshots__/azure-arm, azure-arm_stand_alone, azure-core, azure-core_stand_alone)
Updated the x-ms-examples FAQ doc with a new "Recommended configuration" section showing how to enable skip-example-copying: true, and updated the OAV note to explain workflow when using the new setting
Branch is up to date with main, all 468 tests pass, formatting is clean

… snapshots Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/6bb7e57d-bb20-4569-9e32-5ca3f5245044 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

timotheeguerin · 2026-04-17T16:42:48Z

    emitter-output-dir: "{project-root}"
    output-file: "{emitter-output-dir}/{version-status}/{version}/widget.json"
    arm-types-dir: "{project-root}/../../../../common-types/resource-management"
+    examples-dir: "{project-root}/examples"


this is not correct right? with v2 the examples would be here?

or you thinking that instead we don't copy down to the swagger?

I am thinking we don't copy into the swagger directory.

so they would be at examples/<version>/

But this is assuming that we have logical example checks in ci, if we are forcing them to be at a particular location, then we should conform. It's worth checking.

I think there is 2 issues with that:

Oav will generate I think in the wrong location so you'd still need to copy back

That will cause all refs to be udpated in the seagger when we migrate no?

markcowl

@copilot Pull the latest from main, then fix issues with e2e tests, ensure all tests pass and all fiels are correctly formatted

…ption-skip-example-copying Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

… yet published to npm) Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/4aa2af3a-33fe-420d-854d-94d8c9a8345c Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot · 2026-04-20T20:59:29Z

@copilot Pull the latest from main, then fix issues with e2e tests, ensure all tests pass and all fiels are correctly formatted

Pulled latest from main and fixed the e2e test failures in b8664fb6. The issue was that skip-example-copying was included in the standalone tspconfig files, but since the published npm version of @azure-tools/typespec-autorest doesn't have this option yet, schema validation failed when the standalone templates ran tsp compile. Removed skip-example-copying from the standalone configs while keeping examples-dir (which is already published). All 468 tests pass and formatting is clean.

Copilot AI assigned Copilot and markcowl Apr 3, 2026

Copilot created this pull request from a session on behalf of markcowl April 3, 2026 05:15 View session

microsoft-github-policy-service Bot added emitter:autorest Issues for @azure-tools/typespec-autorest emitter meta:website TypeSpec.io updates labels Apr 3, 2026

markcowl requested changes Apr 3, 2026

View reviewed changes

Copilot started work on behalf of markcowl April 3, 2026 05:20 View session

add changeset and versioned spec test for skip-example-copying

9e3df9b

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/774e6722-332b-4c31-acf6-e8363ef4a705 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot finished work on behalf of markcowl April 3, 2026 05:36

Copilot AI requested a review from markcowl April 3, 2026 05:36

Merge branch 'main' into copilot/add-emitter-option-skip-example-copying

5e0f100

markcowl approved these changes Apr 3, 2026

View reviewed changes

markcowl marked this pull request as ready for review April 3, 2026 20:59

markcowl requested review from bterlson and timotheeguerin as code owners April 3, 2026 20:59

Copilot started work on behalf of markcowl April 3, 2026 21:34 View session

markcowl added the int:azure-specs Run integration tests against azure-rest-api-specs label Apr 3, 2026

fix: apply formatting to test file

b520b3f

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/a5a493be-c2a6-4f3a-afc1-182c25389195 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot finished work on behalf of markcowl April 3, 2026 21:51

Copilot AI requested a review from markcowl April 3, 2026 21:51

Merge branch 'main' into copilot/add-emitter-option-skip-example-copying

48251bb

markcowl approved these changes Apr 14, 2026

View reviewed changes

timotheeguerin reviewed Apr 14, 2026

View reviewed changes

Comment thread .chronus/changes/skip-example-copying-2026-04-03-05-20-45.md

Copilot started work on behalf of markcowl April 14, 2026 18:40 View session

Copilot finished work on behalf of markcowl April 14, 2026 19:53

update init feeds and x-ms-examples docs to use skip-example-copying

62c9e93

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/0e356775-70e8-49d6-92a6-ec924dcbba65 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

microsoft-github-policy-service Bot added the eng label Apr 14, 2026

fix: use consistent examples-dir naming in doc

7fc6ab4

Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/0e356775-70e8-49d6-92a6-ec924dcbba65 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot AI requested a review from markcowl April 14, 2026 20:08

Copilot started work on behalf of markcowl April 14, 2026 20:13 View session

add examples-dir setting to tspconfig.yaml files in feeds and rebuild…

d32fb08

… snapshots Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/6bb7e57d-bb20-4569-9e32-5ca3f5245044 Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot finished work on behalf of markcowl April 14, 2026 21:21

markcowl approved these changes Apr 14, 2026

View reviewed changes

timotheeguerin reviewed Apr 17, 2026

View reviewed changes

markcowl reviewed Apr 20, 2026

View reviewed changes

Copilot started work on behalf of markcowl April 20, 2026 20:47 View session

Copilot AI and others added 2 commits April 20, 2026 20:48

Merge remote-tracking branch 'origin/main' into copilot/add-emitter-o…

3893783

…ption-skip-example-copying Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

fix: remove skip-example-copying from standalone tspconfig files (not…

b8664fb

… yet published to npm) Agent-Logs-Url: https://github.com/Azure/typespec-azure/sessions/4aa2af3a-33fe-420d-854d-94d8c9a8345c Co-authored-by: markcowl <1054056+markcowl@users.noreply.github.com>

Copilot finished work on behalf of markcowl April 20, 2026 21:05

Copilot AI requested a review from markcowl April 20, 2026 21:05

Conversation

Copilot AI commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

markcowl left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Apr 3, 2026

Uh oh!

markcowl commented Apr 3, 2026

Uh oh!

azure-pipelines Bot commented Apr 3, 2026

Uh oh!

azure-sdk commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

@azure-tools/typespec-autorest - feature ✏️

Uh oh!

pkg-pr-new Bot commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

azure-sdk commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

markcowl commented Apr 3, 2026

Uh oh!

Copilot AI commented Apr 3, 2026

Uh oh!

Uh oh!

markcowl commented Apr 14, 2026

Uh oh!

Copilot AI commented Apr 14, 2026

Uh oh!

timotheeguerin Apr 17, 2026

Choose a reason for hiding this comment

Uh oh!

markcowl Apr 20, 2026

Choose a reason for hiding this comment

Uh oh!

markcowl Apr 20, 2026

Choose a reason for hiding this comment

Uh oh!

markcowl Apr 20, 2026

Choose a reason for hiding this comment

Uh oh!

timotheeguerin Apr 20, 2026

Choose a reason for hiding this comment

Uh oh!

markcowl left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Apr 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented Apr 3, 2026 •

edited

Loading

azure-sdk commented Apr 3, 2026 •

edited

Loading

`@azure-tools/typespec-autorest` - feature ✏️

pkg-pr-new Bot commented Apr 3, 2026 •

edited

Loading

azure-sdk commented Apr 3, 2026 •

edited

Loading