Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

server codegen documentation #6265

Closed
wants to merge 115 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
115 commits
Select commit Hold shift + click to select a range
fdb8ae1
server codegen documentation
mario-guerra Mar 4, 2025
df93783
Merge branch 'main' into codegendoc
mario-guerra Mar 21, 2025
3202feb
refresh codegen docs
mario-guerra Apr 2, 2025
2f3fe6a
Scaffolding updates for rc (#6507)
markcowl Mar 21, 2025
a4d7d94
Update dependencies for Python client emitter (#6596)
lmazuel Mar 21, 2025
aa7ee93
Update setuptools for Python client emitter (#6601)
lmazuel Mar 22, 2025
acf7346
[http-client-ts] Fix test script (#6580)
joheredi Mar 22, 2025
44f830a
Update versions for hotfix release (#6604)
markcowl Mar 22, 2025
2646aec
Use latest SCM version in new project scaffolding (#6599)
JoshLove-msft Mar 22, 2025
64e0d0e
Fix issue where rootnamespace is no longer populated by TCGC (#6603)
JoshLove-msft Mar 22, 2025
767da5e
Bump version to get package out of the state where the current versio…
timotheeguerin Mar 22, 2025
680057e
Upgrade dependencies (#6595)
timotheeguerin Mar 22, 2025
706bb16
eng, codeowner, add Anu to to http-client-java (#6482)
weidongxu-microsoft Mar 24, 2025
1c9397b
[python] always respect namespace from TCGC (#5649)
msyyc Mar 24, 2025
01bfbe8
[python] add emitter options and docs (#6537)
iscai-msft Mar 24, 2025
ea5d37d
[http-client-csharp] update emitter options & generate docs (#6541)
jorgerangel-msft Mar 24, 2025
d00e5a8
Fix typo in GitHub link on community page (#6606)
Brijeshthummar02 Mar 24, 2025
d6c5d24
Add plugin abstraction (#6644)
JoshLove-msft Mar 24, 2025
8a0ab85
Safer check if platform is x64 (#6654)
timotheeguerin Mar 24, 2025
99cc470
Merge 0.67.2 hotfix back into main (#6653)
timotheeguerin Mar 24, 2025
63c84e5
Revert "Safer check if platform is x64" (#6657)
timotheeguerin Mar 24, 2025
16d8367
Merge standalone 0.67.3 back in main (#6659)
timotheeguerin Mar 25, 2025
cb7b4f6
[http-specs] release for "0.1.0-alpha.16" (#6617)
msyyc Mar 25, 2025
18358a4
Update wording from "Show OpenAPI3 Documentation" to "Preview API Doc…
RodgeFu Mar 25, 2025
45231bd
[http-client-python] new release for 0.8.2 (#6665)
msyyc Mar 25, 2025
9089aca
[Python] Add test cases for SSE (#6624)
msyyc Mar 25, 2025
f459ad3
Update CODEOWNERS for python (#6671)
msyyc Mar 25, 2025
9975fc9
Fixing Github to GitHub in blog.md (#6677)
allenjzhang Mar 25, 2025
59c2e6d
Sidebar libraries and emitters status (#6589)
timotheeguerin Mar 25, 2025
fef0777
remove type conversion from openapi $extension (#6651)
chrisradek Mar 25, 2025
0e0bca2
Add validation when using default values with uri templates (#6652)
timotheeguerin Mar 25, 2025
ac6af77
Fix typos in `values.md` (#6658)
FionaBronwen Mar 25, 2025
769009a
Fix missing application for doc on multipart parts (#6559)
timotheeguerin Mar 25, 2025
1e8e7f4
Doc bug bash 2 (#6641)
timotheeguerin Mar 25, 2025
80e898e
Fix commenter don't comment or complain on publish pr (#6516)
timotheeguerin Mar 25, 2025
3bea35c
Update to the prettier plugin build (#6678)
timotheeguerin Mar 25, 2025
8dceafc
Update all implicit dependencies in lock file (#6675)
timotheeguerin Mar 25, 2025
98bafa1
Pin spector versions for test packages (#6688)
srnagar Mar 26, 2025
6fb2508
Align the client type shape from TCGC in our emitter (#6179)
ArcturusZhang Mar 26, 2025
2ecadde
http-client-java, support license on file header and POM (#6623)
weidongxu-microsoft Mar 26, 2025
b6257b1
Fix vscode telemetry (#6668)
RodgeFu Mar 26, 2025
69eee45
Renaming ProxyMethodMapper::createCustomHeaderMethod to createNoCusto…
anuchandy Mar 26, 2025
ab01dea
Bump vite from 6.1.0 to 6.2.3 in /packages/http-client-csharp (#6673)
dependabot[bot] Mar 26, 2025
d212c6e
http-client-java, update http-specs and azure-http-specs (#6669)
weidongxu-microsoft Mar 26, 2025
61995ff
Fix mutate `null` in decorator arguments crash (#6697)
timotheeguerin Mar 26, 2025
0ee556f
Remove legacy multipart (#6557)
timotheeguerin Mar 26, 2025
06ce3ad
Migrate bundler to esbuild (#6706)
timotheeguerin Mar 26, 2025
fbda0d7
Remove duplicate Client Java section (#6708)
allenjzhang Mar 26, 2025
c0a86b1
Fix #6634 and issues with some attribute application (#6701)
markcowl Mar 26, 2025
116d812
blog formatting (#6643)
mario-guerra Mar 26, 2025
1731c15
Relax path-parameter-optional condition as now can be optional under …
AlitzelMendez Mar 26, 2025
8137e30
Support license config (#6705)
JoshLove-msft Mar 26, 2025
40ead5b
Bump vite from 6.2.2 to 6.2.3 in /packages/http-client-python (#6702)
dependabot[bot] Mar 27, 2025
eafebb3
[http-client-python] add license support (#6667)
tadelesh Mar 27, 2025
810fe89
http-client-java, sync-stack support for mgmt (#6509)
XiaofeiCao Mar 27, 2025
3118276
Resolve tsp server properly when it's in sub folder or non-first work…
RodgeFu Mar 27, 2025
4c9a09b
Handle paging operations that don't use nextlink or continuation toke…
JoshLove-msft Mar 27, 2025
e174a74
http-client-java, remove use of clientaccessor (#6721)
weidongxu-microsoft Mar 27, 2025
53bd1fb
log logs from stderr as normal one for compile (#6690)
chunyu3 Mar 27, 2025
efc8333
Fix dup issue when using union in multipart HttpPart (#6729)
timotheeguerin Mar 27, 2025
ddfed9e
Revert "Migrate bundler to esbuild" (#6731)
timotheeguerin Mar 27, 2025
39f20fe
Use readonly collection types for return types (#6730)
JoshLove-msft Mar 27, 2025
89954da
[python] fix calls to exec (#6703)
iscai-msft Mar 27, 2025
d4855ac
Spector test for server csharp (#6609)
allenjzhang Mar 27, 2025
715c1d9
Updates to scaffolding script (#6710)
markcowl Mar 27, 2025
5678300
fix: always generate pageable api for list operations (#6738)
jorgerangel-msft Mar 27, 2025
d14cb92
[http-server-csharp] Provide Pattern for user-defined errors (#6600)
AlitzelMendez Mar 28, 2025
7021585
Update singular that should be plural (Developer -> Developers) (#6741)
markcowl Mar 28, 2025
abe9d8a
http-client-java fix async methods in sync-stack (#6726)
XiaofeiCao Mar 28, 2025
3c2b2a5
http-client-java, remove implicit multipart (#6746)
weidongxu-microsoft Mar 28, 2025
ba71ac0
Migrate bundler to esbuild - Take 2 (#6733)
timotheeguerin Mar 28, 2025
2523813
[http] Implement bodyKind: file (#6563)
witemple-msft Mar 28, 2025
773e9e3
Fix playground crash on no target (#6753)
timotheeguerin Mar 28, 2025
041cc0a
Fix nested options (#6711)
timotheeguerin Mar 28, 2025
042edac
Add initial server docs (#6742)
markcowl Mar 28, 2025
e9cbbd6
Fix multipart doc with $ref (#6759)
timotheeguerin Mar 28, 2025
f8a5065
Add test for RequestOptions optionality (#6736)
JoshLove-msft Mar 28, 2025
6533171
Update uses of VSCode to VS Code in official docs (#6760)
AlitzelMendez Mar 28, 2025
cda42a6
Reserve sym and context keyword (#6754)
timotheeguerin Mar 28, 2025
4830ad2
Correct example in hscs doc (#6764)
markcowl Mar 29, 2025
29c45e7
Fix trace formatting on some platforms (#6766)
markcowl Mar 29, 2025
de153d7
[http-server-csharp]: Fix overridden exception properties and default…
markcowl Mar 30, 2025
9907abd
Expose InputClient (#6727)
live1206 Mar 31, 2025
1229b39
[typespec-vscode] Show emitter internal msg in tspconfig (#6197)
mzhongl524 Mar 31, 2025
1afb899
[Python] pass auth flows into credential policy (#6549)
msyyc Mar 31, 2025
9ac5b4f
Remove special handling for content type parameter ordering (#6780)
JoshLove-msft Mar 31, 2025
fc1624f
Update base tsconfig options (#6761)
timotheeguerin Mar 31, 2025
040e9a9
spec: allow named template args in grammar (#6790)
witemple-msft Mar 31, 2025
741868e
updates to openapi dev guide to match current state (#6791)
chrisradek Mar 31, 2025
a94f037
Fix: Playground versions list (#6797)
timotheeguerin Mar 31, 2025
9ebb6be
Fix loading of playground older versions (#6798)
timotheeguerin Mar 31, 2025
51ea4fd
Fix parameter sort for required value-type headers (#6793)
JoshLove-msft Mar 31, 2025
4062700
Fix #6788 support for numeric enums (#6799)
markcowl Mar 31, 2025
eb86353
[Java] Consolidates all operation parameters transformation and inspe…
anuchandy Apr 1, 2025
8590ced
Tsconfig base apply to all CIs (#6800)
timotheeguerin Apr 1, 2025
6555c71
http-client-java, eng, run spotless check before build (#6804)
weidongxu-microsoft Apr 1, 2025
e02abbc
Update VS Code Extension README and website pages for new features (#…
josefree Apr 1, 2025
8fc4788
[http-client-python] upgrade to latest dev version to prepare typespe…
tadelesh Apr 1, 2025
5239c83
Additional keywords (#6794)
timotheeguerin Apr 1, 2025
580e6c0
[hsjs] Ignore unfinished types in `visitAllTypes`. (#6809)
witemple-msft Apr 1, 2025
b1cb4d5
Fix hint warnings (#6807)
timotheeguerin Apr 1, 2025
1b4e0c3
Add breaking change policy to website (#6049)
timotheeguerin Apr 1, 2025
f6df1b3
[hsjs] Fix spector test compile failure type/array (#6810)
witemple-msft Apr 1, 2025
f22daa7
Add sample for unbranded oauth token (#6782)
nisha-bhatia Apr 1, 2025
9114131
Update CODEOWNERS (#6812)
nisha-bhatia Apr 1, 2025
ce62721
[hsjs] Fix spector compile failure special-words (#6813)
witemple-msft Apr 1, 2025
f03f765
Add ef2 docs (#6758)
bterlson Apr 1, 2025
2d3266c
Fix issue with test in ide (#6814)
timotheeguerin Apr 1, 2025
8d728a1
Migrate reference to npm run (#6815)
timotheeguerin Apr 1, 2025
c46322b
Update CODEOWNERS (#6817)
nisha-bhatia Apr 1, 2025
d09c700
Add plugin support (#6757)
JoshLove-msft Apr 2, 2025
a6ed4a8
Fix allow new reserved keyword in augment decorator (#6826)
timotheeguerin Apr 2, 2025
33dae34
Bump packages for 1.0rc (#6829)
timotheeguerin Apr 2, 2025
da54cc3
Fix website not resolving prerelease version correctly for playground…
timotheeguerin Apr 2, 2025
e812d9f
refresh codegen docs
mario-guerra Apr 2, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
7 changes: 0 additions & 7 deletions .chronus/changes/axios-fix-2025-2-18-20-10-32.md

This file was deleted.

8 changes: 0 additions & 8 deletions .chronus/changes/cleanup-spector-mess-2025-2-21-1-45-52-2.md

This file was deleted.

9 changes: 0 additions & 9 deletions .chronus/changes/cleanup-spector-mess-2025-2-21-1-45-52.md

This file was deleted.

This file was deleted.

This file was deleted.

9 changes: 0 additions & 9 deletions .chronus/changes/fix-spector-cleanup-2025-2-21-20-18-11.md

This file was deleted.

7 changes: 0 additions & 7 deletions .chronus/changes/hsj-http-specs-2025-2-19-16-38-9.md

This file was deleted.

This file was deleted.

This file was deleted.

19 changes: 0 additions & 19 deletions .chronus/changes/remove-emitter-framework-2025-2-19-22-24-13.md

This file was deleted.

7 changes: 0 additions & 7 deletions .chronus/changes/remove-old-multipart-2025-2-21-11-20-5.md

This file was deleted.

8 changes: 0 additions & 8 deletions .chronus/changes/remove-winston-2025-2-20-20-48-14.md

This file was deleted.

13 changes: 0 additions & 13 deletions .chronus/changes/replace-typespec-ns-2025-2-20-20-44-35.md

This file was deleted.

This file was deleted.

This file was deleted.

7 changes: 0 additions & 7 deletions .chronus/changes/spector-filter-2025-2-19-14-33-11.md

This file was deleted.

8 changes: 0 additions & 8 deletions .chronus/changes/spector-filter-2025-2-19-21-26-0.md

This file was deleted.

6 changes: 0 additions & 6 deletions .chronus/changes/spector-filter-2025-2-19-21-59-27.md

This file was deleted.

8 changes: 0 additions & 8 deletions .chronus/changes/upgrade-node-python-2025-2-12-6-35-54.md

This file was deleted.

7 changes: 0 additions & 7 deletions .chronus/changes/wanl-fix-nullable-type-2025-2-18-12-10-3.md

This file was deleted.

This file was deleted.

7 changes: 0 additions & 7 deletions .chronus/changes/wording-2025-2-19-16-21-54.md

This file was deleted.

15 changes: 10 additions & 5 deletions .chronus/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -32,24 +32,29 @@ changeKinds:
description: Changes that break existing features

versionPolicies:
- name: typespec
- name: typespec-stable
type: lockstep
step: minor
packages:
- "@typespec/compiler"
- "@typespec/http"
- "@typespec/versioning"
- "@typespec/rest"
- "@typespec/openapi"
- "@typespec/openapi3"
- "@typespec/json-schema"
- "typespec-vscode"

- name: typespec-preview
type: lockstep
step: minor
packages:
- "@typespec/versioning"
- "@typespec/rest"
- "@typespec/protobuf"
- "@typespec/prettier-plugin-typespec"
- "@typespec/eslint-plugin"
- "@typespec/html-program-viewer"
- "@typespec/json-schema"
- "@typespec/internal-build-utils"
- "typespec-vs"
- "typespec-vscode"
- "@typespec/library-linter"
- "@typespec/events"
- "@typespec/sse"
Expand Down
3 changes: 3 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,6 @@ charset = utf-8

[*.cs]
indent_size = 4

[*.java]
indent_size = 4
6 changes: 4 additions & 2 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -7,17 +7,19 @@
######################
# CSharp
######################
/packages/http-client-csharp/ @m-nash @JoshLove-msft @jorgerangel-msft
/packages/http-client-csharp/ @m-nash @JoshLove-msft @jorgerangel-msft @nisha-bhatia
/docs/samples/client/csharp @nisha-bhatia @JoshLove-msft @jorgerangel-msft

######################
# Java
######################
/packages/http-client-java/ @srnagar @weidongxu-microsoft @haolingdong-msft @XiaofeiCao
/packages/http-client-java/ @srnagar @anuchandy @weidongxu-microsoft @haolingdong-msft @XiaofeiCao

######################
# Python
######################
/packages/http-client-python/ @iscai-msft @tadelesh @msyyc @timotheeguerin @lmazuel
/website/src/content/docs/docs/emitters/clients/http-client-python/ @iscai-msft @tadelesh @msyyc @timotheeguerin @lmazuel

######################
# JavaScript
Expand Down
12 changes: 6 additions & 6 deletions .github/workflows/consistency.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,12 @@ jobs:
check-changes:
name: Check Changes
runs-on: ubuntu-latest
if: github.event_name == 'pull_request'
if: |
github.event_name == 'pull_request' &&
!startsWith(github.head_ref, 'publish/') &&
!startsWith(github.head_ref, 'dependabot/') &&
!startsWith(github.head_ref, 'backmerge/') &&
!startsWith(github.head_ref, 'revert-')
steps:
- uses: actions/checkout@v4
with:
Expand Down Expand Up @@ -43,11 +48,6 @@ jobs:

- run: pnpm chronus verify --since ${{ github.event.pull_request.base.ref }}
name: Check changelog
if: |
!startsWith(github.head_ref, 'publish/') &&
!startsWith(github.head_ref, 'dependabot/') &&
!startsWith(github.head_ref, 'backmerge/') &&
!startsWith(github.head_ref, 'revert-')

# Validate spell check
spellcheck:
Expand Down
2 changes: 1 addition & 1 deletion .prettierignore
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ eng/feeds/
grammars/

# auto generated code model files
packages/http-client-csharp/generator/TestProjects/**/tspCodeModel.json
**/tspCodeModel.json

# auto generated api view properties files
packages/http-client-java/generator/http-client-generator-test/src/main/**/*.json
Expand Down
3 changes: 2 additions & 1 deletion .vscode/extensions.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
"esbenp.prettier-vscode",
"streetsidesoftware.code-spell-checker",
"astro-build.astro-vscode",
"vitest.explorer"
"vitest.explorer",
"typespec.typespec-vscode"
]
}
2 changes: 2 additions & 0 deletions cspell.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,9 @@ words:
- Hdvcmxk
- headasbooleanfalse
- headasbooleantrue
- hresult
- hscs
- hsjs
- HSTS
- imple
- Infima
Expand Down
12 changes: 7 additions & 5 deletions docker/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,16 @@
# Build compiler
# --------------------------------
# cspell:ignore tdnf
FROM mcr.microsoft.com/azurelinux/base/nodejs:20.14 AS builder
# mcr doesn't provide any update to date images for nodejs... so we use the devcontainers image for building.
# FROM mcr.microsoft.com/azurelinux/base/nodejs:20.14 AS builder
FROM mcr.microsoft.com/devcontainers/javascript-node:22 AS builder
COPY . /app

# Upgrade all packages per https://eng.ms/docs/more/containers-secure-supply-chain/updating.
RUN tdnf update -y \
&& tdnf install -y \
git \
&& tdnf clean all
# RUN tdnf update -y \
# && tdnf install -y \
# git \
# && tdnf clean all

WORKDIR /app
RUN npm install -g pnpm
Expand Down
4 changes: 4 additions & 0 deletions docs/samples/client/csharp/SampleService/Configuration.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"output-folder": ".",
"package-name": "SampleService"
}
Loading
Loading