Laurent Mazuel lmazuel

Pre-requisite

You need to have Python installed
We recommend at least 3.11 to have access to more tool by default (more can be added later)
You may use the "uv" tool as it's convenient, fast and handle Python version and venv creation automatically, but it's optional

Initial setup

Go in the folder of the package you're working on, for instance sdk/contoso/azure-contoso

Overview

azure-mgmt-resources is an interesting package that is consisteting of sub-folders:

But it also has a azure/mgmt/resources/__init__.py file that contains aliases to client, in order to avoid using the subnamespace:

from .managedapplications import ApplicationClient

do-not-import-asyncio

Summary

Rule codename: do-not-import-asyncio Rule number: 666

Description

You should not, because trio

Overview

Given a visibility on a property on an attribute on a model, should this property be serialized to be sent to the server? This explains the algorithm to let SDK decide what to send or not, depending of create, update, etc.

It doesn't adress on purpose the question of SDK design (one model, more model, kwarg only, etc.), this is a page about serialization on the wire

	import "@azure-tools/typespec-azure-core";
	import "@typespec/http";
	import "@typespec/rest";
	import "@typespec/versioning";

	using TypeSpec.Rest;
	using TypeSpec.Http;
	using TypeSpec.Versioning;
	using Azure.Core;
	using Azure.Core.Traits;

	import typing

	import httpx
	import requests
	from httpx import Auth, Request, Response
	from azure.core.credentials import TokenCredential
	from azure.core.pipeline.policies import BearerTokenCredentialPolicy
	from azure.core.pipeline import PipelineRequest, PipelineContext
	from azure.core.pipeline.transport import HttpRequest

	import "@typespec/http";
	import "@typespec/rest";
	import "@typespec/versioning";
	import "@azure-tools/typespec-azure-core";

	using TypeSpec.Http;
	using TypeSpec.Rest;
	using TypeSpec.Versioning;
	using Azure.Core;
	using Azure.Core.Traits;

	from subprocess import check_output, CalledProcessError, DEVNULL
	from pathlib import Path
	from multiprocessing import Pool
	from ci_tools.environment_exclusions import is_check_enabled

	BASE_FOLDER = "/home/lmazuel/git/azure-sdk-for-python/"
	TOX_INI = BASE_FOLDER+"eng/tox/tox.ini"
	SDK_FOLDER = BASE_FOLDER+"sdk"

	def run_next_pylint(folder: str):

	Status code: 201
	Headers:
	'Content-Length': '594',
	'Content-Type': 'application/json'
	'Location': 'https://lmazuelanom.cognitiveservices.azure.com:443/anomalydetector/v1.1/multivariate/models/0c46cef0-c76e-11ed-83a5-8247640b151e'
	'x-envoy-upstream-service-time': '247'
	'apim-request-id': 'b5437cd9-f2f1-401b-b431-0993c096350c'
	'Strict-Transport-Security': 'max-age=31536000; includeSubDomains; preload'
	'x-content-type-options': 'nosniff'
	'x-ms-region': 'East US'

	from typing import TypeVar, Optional, Generic, Protocol

	class Additive(Protocol):
	def __add__(self: 'MyReturnType', other: 'MyReturnType') -> 'MyReturnType': ...

	MyReturnType = TypeVar("MyReturnType", bound=Additive)

	class Foo(Generic[MyReturnType]):

	def __init__(self, input: MyReturnType) -> None:

Laurent Mazuel lmazuel

Pre-requisite

Initial setup

Overview

do-not-import-asyncio

Summary

Description

Overview

Tagging property with visibility