py*: add Korean translation (#14559)

pages.ko/common/py-spy.md

@@ -0,0 +1,20 @@
+# py-spy
+
+> Python 프로그램용 샘플링 프로파일러.
+> 더 많은 정보: <https://github.com/benfred/py-spy>.
+
+- 실행 중인 프로세스에서 가장 많은 실행 시간을 차지하는 함수의 실시간 보기 표시:
+
+`py-spy top --pid {{pid}}`
+
+- 프로그램을 시작하고 가장 많은 실행 시간을 차지하는 함수의 실시간 보기 표시:
+
+`py-spy top -- python {{경로/대상/파일.py}}`
+
+- 함수 호출 실행 시간의 SVG 플레임 그래프 생성:
+
+`py-spy record -o {{경로/대상/프로필.svg}} --pid {{pid}}`
+
+- 실행 중인 프로세스의 호출 스택 덤프:
+
+`py-spy dump --pid {{pid}}`

pages.ko/common/pyats-shell.md

@@ -0,0 +1,16 @@
+# pyats shell
+
+> 프로토타입 제작 시간을 절약하기 위해 미리 로드된 pyATS 대화형 Python 셸을 시작합니다.
+> 더 많은 정보: <https://pubhub.devnetcloud.com/media/genie-docs/docs/cli/genie_shell.html>.
+
+- 정의된 테스트베드 파일과 함께 pyATS 셸 열기:
+
+`pyats shell --testbed-file {{경로/대상/테스트베드.yaml}}`
+
+- 정의된 Pickle 파일과 함께 pyATS 셸 열기:
+
+`pyats shell --pickle-file {{경로/대상/피클.file}}`
+
+- IPython 비활성화 상태로 pyATS 열기:
+
+`pyats shell --no-ipython`

pages.ko/common/pyats-version.md

@@ -0,0 +1,20 @@
+# pyats version
+
+> pyATS 설치 버전 보기 및 업그레이드.
+> 더 많은 정보: <https://developer.cisco.com/pyats/>.
+
+- 모든 패키지의 버전 표시:
+
+`pyats version check`
+
+- 오래된 패키지 표시:
+
+`pyats version check --outdated`
+
+- 패키지를 최신 버전으로 업데이트:
+
+`pyats version update`
+
+- 특정 버전으로 패키지 업데이트 또는 다운그레이드:
+
+`pyats version update {{버전}}`

pages.ko/common/pyats.md

@@ -0,0 +1,20 @@
+# pyATS
+
+> Cisco Systems의 벤더에 구애받지 않는 테스트 자동화 프레임워크로, 네트워크 및 시스템 테스트에 사용됩니다.
+> 더 많은 정보: <https://developer.cisco.com/pyats/>.
+
+- `pyATS` 하위 명령 실행:
+
+`pyats {{하위_명령}}`
+
+- 도움말 표시:
+
+`pyats --help`
+
+- 특정 하위 명령에 대한 도움말 표시:
+
+`pyats {{하위_명령}} --help`
+
+- 버전 표시:
+
+`pyats version check`

pages.ko/common/pycodestyle.md

@@ -0,0 +1,24 @@
+# pycodestyle
+
+> Python 코드를 PEP 8 스타일 규칙에 맞게 검사.
+> 더 많은 정보: <https://pycodestyle.readthedocs.io>.
+
+- 단일 파일의 스타일 검사:
+
+`pycodestyle {{파일.py}}`
+
+- 여러 파일의 스타일 검사:
+
+`pycodestyle {{파일1.py 파일2.py ...}}`
+
+- 오류의 첫 번째 발생만 표시:
+
+`pycodestyle --first {{파일.py}}`
+
+- 각 오류에 대한 소스 코드 표시:
+
+`pycodestyle --show-source {{파일.py}}`
+
+- 각 오류에 대한 특정 PEP 8 텍스트 표시:
+
+`pycodestyle --show-pep8 {{파일.py}}`

pages.ko/common/pydoc.md

@@ -0,0 +1,16 @@
+# pydoc
+
+> 오프라인 Python 문서 보기.
+> 더 많은 정보: <https://docs.python.org/3/library/pydoc.html>.
+
+- 주제(파이썬 키워드, 주제, 함수, 모듈, 패키지 등)에 대한 문서 출력:
+
+`pydoc {{주제}}`
+
+- 임의의 사용되지 않은 포트에서 HTTP 서버를 시작하고 [브라우저]를 열어 문서를 보기:
+
+`pydoc -b`
+
+- 도움말 표시:
+
+`pydoc`

pages.ko/common/pydocstyle.md

@@ -0,0 +1,32 @@
+# pydocstyle
+
+> Python 스크립트가 Python 도크스트링 규칙을 준수하는지 정적 검사합니다.
+> 더 많은 정보: <https://www.pydocstyle.org/en/latest/>.
+
+- Python 스크립트 또는 특정 디렉터리의 모든 Python 스크립트 분석:
+
+`pydocstyle {{파일.py|경로/대상/폴더}}`
+
+- 각 오류에 대한 설명 표시:
+
+`pydocstyle {{-e|--explain}} {{파일.py|경로/대상/폴더}}`
+
+- 디버그 정보 표시:
+
+`pydocstyle {{-d|--debug}} {{파일.py|경로/대상/폴더}}`
+
+- 총 오류 수 표시:
+
+`pydocstyle --count {{파일.py|경로/대상/폴더}}`
+
+- 특정 구성 파일 사용:
+
+`pydocstyle --config {{경로/대상/구성_파일}} {{파일.py|경로/대상/폴더}}`
+
+- 하나 이상의 오류 무시:
+
+`pydocstyle --ignore {{D101,D2,D107,...}} {{파일.py|경로/대상/폴더}}`
+
+- 특정 규약의 오류 검사:
+
+`pydocstyle --convention {{pep257|numpy|google}} {{파일.py|경로/대상/폴더}}`

pages.ko/common/pyenv-virtualenv.md

@@ -0,0 +1,20 @@
+# pyenv virtualenv
+
+> 설치된 Python 배포판을 기반으로 가상 환경을 생성합니다.
+> 더 많은 정보: <https://github.com/pyenv/pyenv-virtualenv>.
+
+- 새로운 Python 3.6.6 가상 환경 생성:
+
+`pyenv virtualenv {{3.6.6}} {{가상환경_이름}}`
+
+- 모든 기존 가상 환경 나열:
+
+`pyenv virtualenvs`
+
+- 가상 환경 활성화:
+
+`pyenv activate {{가상환경_이름}}`
+
+- 가상 환경 비활성화:
+
+`pyenv deactivate`

pages.ko/common/pyenv.md

@@ -0,0 +1,33 @@
+# pyenv
+
+> 여러 버전의 Python 사이를 쉽게 전환.
+> 같이 보기: `asdf`.
+> 더 많은 정보: <https://github.com/pyenv/pyenv>.
+
+- 사용 가능한 모든 명령 나열:
+
+`pyenv commands`
+
+- `${PYENV_ROOT}/versions` 디렉토리 아래의 모든 Python 버전 나열:
+
+`pyenv versions`
+
+- 업스트림에서 설치할 수 있는 모든 Python 버전 나열:
+
+`pyenv install --list`
+
+- `${PYENV_ROOT}/versions` 디렉토리에 특정 Python 버전 설치:
+
+`pyenv install {{2.7.10}}`
+
+- `${PYENV_ROOT}/versions` 디렉토리에서 특정 Python 버전 제거:
+
+`pyenv uninstall {{2.7.10}}`
+
+- 현재 컴퓨터에서 전역으로 사용할 Python 버전 설정:
+
+`pyenv global {{2.7.10}}`
+
+- 현재 디렉토리와 하위 디렉토리에서 사용할 Python 버전 설정:
+
+`pyenv local {{2.7.10}}`

pages.ko/common/pyflakes.md

@@ -0,0 +1,20 @@
+# pyflakes
+
+> Python 소스 코드 파일에서 오류를 검사.
+> 더 많은 정보: <https://pypi.org/project/pyflakes>.
+
+- 단일 Python 파일 검사:
+
+`pyflakes check {{경로/대상/파일.py}}`
+
+- 특정 폴더 내 Python 파일 검사:
+
+`pyflakes checkPath {{경로/대상/폴더}}`
+
+- 폴더 내의 Python 파일을 재귀적으로 검사:
+
+`pyflakes checkRecursive {{경로/대상/폴더}}`
+
+- 여러 폴더에서 발견된 모든 Python 파일 검사:
+
+`pyflakes iterSourceCode {{경로/대상/폴더_1}} {{경로/대상/폴더_2}}`

pages.ko/common/pygmentize.md

@@ -0,0 +1,28 @@
+# pygmentize
+
+> Python 기반의 문법 하이라이터.
+> 더 많은 정보: <https://pygments.org/docs/cmdline/>.
+
+- 파일의 문법을 하이라이트하여 `stdout`에 출력 (파일 확장자로 언어 추론):
+
+`pygmentize {{파일.py}}`
+
+- 문법 하이라이트를 위한 언어를 명시적으로 설정:
+
+`pygmentize -l {{자바스크립트}} {{입력_파일}}`
+
+- 사용 가능한 렉서(입력 언어 처리기) 목록 표시:
+
+`pygmentize -L lexers`
+
+- 출력 파일을 HTML 형식으로 저장:
+
+`pygmentize -f html -o {{출력_파일.html}} {{입력_파일.py}}`
+
+- 사용 가능한 출력 형식 목록 표시:
+
+`pygmentize -L formatters`
+
+- 추가 포매터 옵션을 사용하여 HTML 파일 출력 (전체 페이지, 줄 번호 포함):
+
+`pygmentize -f html -O "full,linenos=True" -o {{출력_파일.html}} {{입력_파일}}`

pages.ko/common/pyinfra.md

@@ -0,0 +1,20 @@
+# pyinfra
+
+> 대규모 인프라를 자동화.
+> 더 많은 정보: <https://docs.pyinfra.com>.
+
+- SSH를 통해 명령 실행:
+
+`pyinfra {{대상_IP_주소}} exec -- {{명령어_및_인수}}`
+
+- 대상 목록에 있는 서버에 배포 파일의 내용을 실행:
+
+`pyinfra {{경로/대상/목록.py}} {{경로/배포.py}}`
+
+- 로컬에서 명령 실행:
+
+`pyinfra @local {{경로/배포.py}}`
+
+- Docker를 통해 명령 실행:
+
+`pyinfra @docker/{{컨테이너}} {{경로/배포.py}}`

pages.ko/common/pylint.md

@@ -0,0 +1,24 @@
+# pylint
+
+> Python 코드 린터.
+> 더 많은 정보: <https://pylint.pycqa.org/en/latest/>.
+
+- 파일 내 린트 오류 표시:
+
+`pylint {{경로/대상/파일.py}}`
+
+- 패키지 또는 모듈 린트 (import 가능해야 하며, `.py` 접미사 없이):
+
+`pylint {{패키지_또는_모듈}}`
+
+- 디렉토리 경로에서 패키지 린트 (`__init__.py` 파일이 포함되어 있어야 함):
+
+`pylint {{경로/대상/폴더}}`
+
+- 파일을 린트하고 구성 파일 사용 (보통 `pylintrc`로 명명됨):
+
+`pylint --rcfile {{경로/대상/pylintrc}} {{경로/대상/파일.py}}`
+
+- 파일을 린트하고 특정 오류 코드를 비활성화:
+
+`pylint --disable {{C,W,no-error,design}} {{경로/대상/파일}}`

pages.ko/common/pypy.md

@@ -0,0 +1,32 @@
+# pypy
+
+> 빠르고 호환성 있는 Python 언어의 대체 구현체.
+> 더 많은 정보: <https://doc.pypy.org>.
+
+- REPL(대화형 셸) 시작:
+
+`pypy`
+
+- 주어진 Python 파일에서 스크립트 실행:
+
+`pypy {{경로/대상/파일.py}}`
+
+- 대화형 셸의 일부로 스크립트 실행:
+
+`pypy -i {{경로/대상/파일.py}}`
+
+- Python 표현식 실행:
+
+`pypy -c "{{표현식}}"`
+
+- 라이브러리 모듈을 스크립트로 실행 (옵션 목록 종료):
+
+`pypy -m {{모듈}} {{인수}}`
+
+- pip를 사용하여 패키지 설치:
+
+`pypy -m pip install {{패키지}}`
+
+- Python 스크립트를 대화형으로 디버깅:
+
+`pypy -m pdb {{경로/대상/파일.py}}`

pages.ko/common/pystun3.md

@@ -0,0 +1,16 @@
+# pystun3
+
+> Python으로 작성된 고전적인 STUN 클라이언트.
+> 더 많은 정보: <https://github.com/talkiq/pystun3>.
+
+- STUN 요청 수행:
+
+`pystun3`
+
+- STUN 서버를 지정하여 STUN 요청 수행:
+
+`pystun3 --stun-host {{stun.1und1.de}}`
+
+- 소스 포트를 지정하여 STUN 요청 수행:
+
+`pystun3 --source-port {{7932}}`

pages.ko/common/pytest.md

@@ -0,0 +1,28 @@
+# pytest
+
+> Python 테스트 실행.
+> 더 많은 정보: <https://docs.pytest.org/>.
+
+- 특정 파일에서 테스트 실행:
+
+`pytest {{경로/대상/테스트_파일1.py 경로/대상/테스트_파일2.py ...}}`
+
+- 특정 [k]eyword 표현식과 일치하는 테스트 실행:
+
+`pytest -k {{표현식}}`
+
+- 테스트가 실패하거나 오류가 발생하면 즉시 종료:
+
+`pytest --exitfirst`
+
+- 마커와 일치하거나 제외하는 테스트 실행:
+
+`pytest -m {{마커_이름1 and not 마커_이름2}}`
+
+- 마지막 실패 테스트부터 계속해서 테스트 실패까지 실행:
+
+`pytest --stepwise`
+
+- 출력을 캡처하지 않고 테스트 실행:
+
+`pytest --capture=no`

pages.ko/common/python.md

@@ -0,0 +1,36 @@
+# python
+
+> Python 언어 인터프리터.
+> 더 많은 정보: <https://www.python.org>.
+
+- REPL(대화형 셸) 시작:
+
+`python`
+
+- 특정 Python 파일 실행:
+
+`python {{경로/대상/파일.py}}`
+
+- 특정 Python 파일 실행 후 REPL 시작:
+
+`python -i {{경로/대상/파일.py}}`
+
+- Python 표현식 실행:
+
+`python -c "{{표현식}}"`
+
+- 지정된 라이브러리 모듈의 스크립트 실행:
+
+`python -m {{모듈}} {{인자들}}`
+
+- `pip`를 사용하여 패키지 설치:
+
+`python -m pip install {{패키지}}`
+
+- Python 스크립트 대화형 디버깅:
+
+`python -m pdb {{경로/대상/파일.py}}`
+
+- 현재 디렉터리에서 포트 8000으로 내장 HTTP 서버 시작:
+
+`python -m http.server`