This commit is contained in:
Wonhyeong Seo 2022-08-05 22:53:35 +09:00 коммит произвёл GitHub
Родитель 713f341c59
Коммит caab01ff9d
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 8 добавлений и 8 удалений

Просмотреть файл

@ -52,23 +52,23 @@ Azure SDK는 무엇보다 Azure 서비스를 사용하는 개발자의 생산성
### 일반적 가이드라인
클라이언트 라이브러리의 API에 정말 많은 노력을 기울여야해요. 서비스의 첫인상이자 주로 쓰는 상호작용 방법이기 때문입니다.
클라이언트 라이브러리의 API에 정말 많은 노력을 기울여야합니다. 서비스의 첫인상이자 주로 쓰는 상호작용 방법이기 때문입니다.
{% include requirement/MUST id="python-feature-support" %} Azure 서비스가 제공하는 100%의 기능을 모두 클라이언트 라이브러리에서 지원해야합니다. 기능이 빠져있다면 개발자로서 아주 난감할 것이기 때문입니다.
### HTTP 기반이 아닌 서비스
이 안내서는 HTTP 기반 요청/응답 구조를 염두에 두고 작성했지만, 아닌 서비스들에도 많은 부분을 적용하실 수 있습니다. 예로 들면 패키징과 네이밍, 도구와 프로젝트 구조를 비롯한 서비스들이 있어요.
이 안내서는 HTTP 기반 요청/응답 구조를 염두에 두고 작성했지만, 아닌 서비스들에도 많은 부분을 적용하실 수 있습니다. 예로 들면 패키징과 네이밍, 도구와 프로젝트 구조를 비롯한 서비스들이 있습니다.
HTTP/REST 기반이 아닌 서비스들에 대해 더 자세한 문의사항이 있으시다면 [아키텍처 위원회]에 문의해주시길 바랍니다.
### 지원 중인 파이썬 버전
{% include requirement/MUST id="python-general-version-support" %} 파이썬 3.7 이상을 지원하고 있습니다.
{% include requirement/MUST id="python-general-version-support" %} 파이썬 2.7과 파이썬 3.5.3 이상을 지원하고 있습니다.
{% include requirement/SHOULD id="python-general-universal-pkg" %} 버전 별로 패키지를 구성해야만 하는 이유가 없다면, 지원 중인 모든 파이썬 버전에 통용되는 [범용 패키지]를 제공해주시길 바랍니다.
시로 의존관계인 외부 패키지가 모든 버전에 없기 때문에, 버전별로 서로 다른 외부 패키지에 의존해야만 하는 경우가 있습니다.
를들어, 파이썬2와 파이썬3가 다른 외부 패키지에 의존하고, 두 파이썬 버전이 같은 외부 의존 패키지를 사용할 수 없을 때 입니다.
## Azure SDK API 디자인
@ -85,13 +85,13 @@ API를 통해 서비스로 연결할때, 고객은 한개 이상의 _서비스
{% include requirement/MUST id="python-client-sync-async-separate-clients" %} 동기와 비동기 클라이언트를 별도로 제공해주세요. [비동기 지원](#async-support) 절에서 더 자세한 내용을 보실 수 있습니다.
```python
# 좋습니다
# Yes
class CosmosClient(object) ...
# 안됩니다
# No
class CosmosProxy(object) ...
# 안됩니다
# Yes
class CosmosUrl(object) ...
```
@ -99,7 +99,7 @@ class CosmosUrl(object) ...
#### 생성자와 팩토리 메서드
서비스와 연결시키고 상호작용하는데 필요한 최소한의 전달인자만을 클라이언트 인스턴스를 생성할 때 요구해야합니다. 나머지 정보는 모두 선택적인 키워드 전달인자로 보내는 것이 바람직합니다.
서비스와 연결시키고 상호작용하는데 필요한 최소한의 인자만을 클라이언트 인스턴스를 생성할 때 요구해야합니다. 나머지 정보는 모두 선택적인 키워드 전달인자로 보내는 것이 바람직합니다.
##### 클라이언트 구성