Client/server code generation examples

[nmoreaud]

Hello
Thanks for this very nice project.

I'm looking for examples of python/other client/server code generation, could you add some?

---

This tool seems to support python client generation: https://www.npmjs.com/package/@azure-tools/typespec-python?activeTab=readme
However, I was not able to use it:

tsp compile main.tsp --emit @azure-tools/typespec-python
TypeSpec compiler v0.55.0

Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/__init__.py", line 481, in <module>
    ).process()
      ^^^^^^^^^
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/__init__.py", line 368, in process
    serializer.serialize()
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/__init__.py", line 187, in serialize
    self._serialize_namespace_level(
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/__init__.py", line 141, in _serialize_namespace_level
    self._serialize_and_write_package_files(namespace_path=namespace_path)
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/__init__.py", line 263, in _serialize_and_write_package_files
    serializer.serialize_package_file(template_name, **params),
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/general_serializer.py", line 58, in serialize_package_file
    "client_name": self.code_model.clients[0].name,
                   ~~~~~~~~~~~~~~~~~~~~~~~^^^
IndexError: list index out of range
Error: Command failed: python3 /home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/run_cadl.py --output-folder=/home/dev/projects/typespec/typespec_3/tsp-output/@azure-tools/typespec-python --cadl-file=/tmp/cadl-codegen/typespec-python-yaml-mapf734d162-860f-462e-bbbb-9129940d4e5a.yaml --package-version=1.0.0b1 --generate-packaging-files=true --flavor=azure --package-dir=nm --package-name=nm --models-mode=dpg --package-mode=azure-dataplane --emit-cross-language-definition-file=true --from-typespec=true
Emitter "@azure-tools/typespec-python" crashed! This is a bug.
Please file an issue at https://github.com/Azure/autorest.python/issues

Error: Command failed: /usr/bin/node /home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/run-python3.js /home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/run_cadl.py --output-folder=/home/dev/projects/typespec/typespec_3/tsp-output/@azure-tools/typespec-python --cadl-file=/tmp/cadl-codegen/typespec-python-yaml-mapf734d162-860f-462e-bbbb-9129940d4e5a.yaml --package-version=1.0.0b1 --generate-packaging-files=true --flavor=azure --package-dir=nm --package-name=nm --models-mode=dpg --package-mode=azure-dataplane --emit-cross-language-definition-file=true --from-typespec=true
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/__init__.py", line 481, in <module>
    ).process()
      ^^^^^^^^^
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/__init__.py", line 368, in process
    serializer.serialize()
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/__init__.py", line 187, in serialize
    self._serialize_namespace_level(
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/__init__.py", line 141, in _serialize_namespace_level
    self._serialize_and_write_package_files(namespace_path=namespace_path)
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/__init__.py", line 263, in _serialize_and_write_package_files
    serializer.serialize_package_file(template_name, **params),
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/autorest/codegen/serializers/general_serializer.py", line 58, in serialize_package_file
    "client_name": self.code_model.clients[0].name,
                   ~~~~~~~~~~~~~~~~~~~~~~~^^^
IndexError: list index out of range
Error: Command failed: python3 /home/dev/projects/typespec/typespec_3/node_modules/@autorest/python/run_cadl.py --output-folder=/home/dev/projects/typespec/typespec_3/tsp-output/@azure-tools/typespec-python --cadl-file=/tmp/cadl-codegen/typespec-python-yaml-mapf734d162-860f-462e-bbbb-9129940d4e5a.yaml --package-version=1.0.0b1 --generate-packaging-files=true --flavor=azure --package-dir=nm --package-name=nm --models-mode=dpg --package-mode=azure-dataplane --emit-cross-language-definition-file=true --from-typespec=true

    at genericNodeError (node:internal/errors:984:15)
    at wrappedFn (node:internal/errors:538:14)
    at checkExecSyncError (node:child_process:890:11)
    at execFileSync (node:child_process:926:15)
    at Object.$onEmit [as emitFunction] (file:///home/dev/projects/typespec/typespec_3/node_modules/@azure-tools/typespec-python/dist/src/emitter.js:88:9)
    at async runEmitter (file:///home/dev/projects/typespec/typespec_3/node_modules/@typespec/compiler/dist/src/core/program.js:555:13)
    at async compile (file:///home/dev/projects/typespec/typespec_3/node_modules/@typespec/compiler/dist/src/core/program.js:238:9)
    at async compileOnce (file:///home/dev/projects/typespec/typespec_3/node_modules/@typespec/compiler/dist/src/core/cli/actions/compile/compile.js:37:25)
    at async compileAction (file:///home/dev/projects/typespec/typespec_3/node_modules/@typespec/compiler/dist/src/core/cli/actions/compile/compile.js:21:9)

--------------------------------------------------
Library Version                0.23.9
TypeSpec Compiler Version      0.55.0
--------------------------------------------------

There is also a second tool which seems more complex to configure (needs git repositories) : https://github.com/Azure/azure-sdk-tools/tree/main/tools/tsp-client#readme

[timotheeguerin]

tsp-client is a tool to work with the Azure specs repo, shouldn't be anything you need.

This crash looks like a bug in the python emitter https://github.com/Azure/autorest.python I would file an issue there. Note that those client emitters are still in development so we cannot recommend them today for usage outside of Azure just yet.