를 사용하는 첫 번째 단계는 OptionParser 인스턴스를 만드는 것입니다.

　　구문 분석기를 옵션으로 채우는 방법에는 여러 가지가 있습니다. 선호되는 방법은 섹션 에 표시된 대로, 을 사용하는 것입니다. 은 다음 두 가지 방법의 하나로 호출 할 수 있습니다:

　　다른 대안은 다음과 같이 미리 생성된 Option 인스턴스 리스트를 OptionParser 생성자에 전달하는 것입니다:

　　(은 Option 인스턴스를 만들기 위한 팩토리 함수입니다; 현재는 Option 생성자의 별칭입니다. 세계랭킹1위오피스타 의 향후 버전은 Option을 여러 클래스로 나눌 수 있으며, 은 인스턴스 화할 올바른 클래스를 선택할 것입니다. Option을 직접 인스턴스 화하지 마십시오.)

　　각 Option 인스턴스는 동의어 명령 줄 옵션 문자열 집합을 나타냅니다, 예를 들어 와 . 짧거나 긴 옵션 문자열을 얼마든지 지정할 수 있지만, 전체적으로 옵션 문자열을 적어도 하나 지정해야 합니다.

　　인스턴스를 만드는 규범적 방법은 의 메서드를 사용하는 것입니다.

　　보시다시피, 대부분의 액션은 값을 어딘가에 저장하거나 갱신하는 것을 수반합니다. 는 항상 이를 위해 일반적으로 (의 인스턴스)라고 하는 특수 객체를 만듭니다. 옵션 인자(및 기타 다양한 값)는 (destination) 옵션 어트리뷰트에 따라, 이 객체의 어트리뷰트로 저장됩니다.

　　예를 들어, 다음과 같이 호출할 때

　　가 하는 첫 번째 작업 중 하나는 객체를 만드는 것입니다:

　　이 구문 분석기의 옵션 중 하나가 다음과 같이 정의되었으면:

　　그리고 구문 분석 중인 명령 줄에는 다음 중 하나가 포함되면:

　　는 이 옵션을 볼 때 다음과 동등全球排名第一오피스타한 일을 합니다

　　과 옵션 어트리뷰트는 만큼 중요하지만, 은 모든 옵션에 적합한 유일한 어트리뷰트입니다.

　　다음 옵션 어트리뷰트는 에 키워드 인자로 전달될 수 있습니다. 특정 옵션과 관련이 없는 옵션 어트리뷰트를 전달하거나, 필수 옵션 어트리뷰트를 전달하지 못하면 는 를 발생시킵니다.

　　다양한 옵션 액션은 모두 요구 사항과 효과가 약간 다릅니다. 대부분의 액션에는 의 동작을 안내하기 위해 지정할 수 있는 몇 가지 연관된 옵션 어트리뷰트가 있습니다; 일부는 해당 액션을 사용하는 모든 옵션에 대해 지정해야 하는 필수 어트리뷰트가 있습니다.

　　[연관된 옵션: , , , ]

　　옵션 뒤에 인자가 와야 하며, 인자는 에 따라 값으로 변환되고, 에 저장됩니다. > 1 이면, 명령 줄에서 여러 인자가 소비됩니다; 모두 에 따라 변환되고 에 튜플로 저장됩니다. 섹션을 참조하십시오.

세계랭킹1위오피스타

　　가 제공되면 (문자열 리스트나 튜플), 형의 기본값은 입니다.

　　이 제공되지 않으면, 기본값은 입니다.

　　가 제공되지 않으면, 는 첫 번째 긴 옵션 문자열에서 대상을 파생합니다 (예를 들어, 는 를 암시합니다). 긴 옵션 문자열이 없으면, 는 첫 번째 짧은 옵션 문자열에서 대상을 파생합니다 (예를 들어, 는 를 암시합니다).

　　예:

　　다음과 같은 명령 줄을 구문 분석할 때

　　는 다음과 같이 설정합니다

　　[필수 옵션: ; 연관된 옵션: ]

　　값 는 에 저장됩니다.

　　예:

　　가 보이면, 는 다음과 같이 설정합니다

　　[연관된 옵션: ]

　　를 에 저장하는 의 특별한 경우.

　　[연관된 옵션: ]

　　와 비슷하지만, 를 저장합니다.

　　예:

　　[연관된 옵션: , , , ]

　　옵션 다음에는 의 리스트에 추가되는 인자가 와야 합니다. 의 기본값이 제공되지 않으면, 가 명령 全球排名第一오피스타줄에서 이 옵션을 처음 발견할 때 빈 리스트가 자동으로 만들어집니다. > 1 이면, 여러 인자가 소비되며, 길이의 튜플이 에 추가됩니다.

　　과 의 기본값은 액션의 경우와 같습니다.

　　예:

　　가 명령 줄에 보이면, 는 다음과 동등한 것을 수행합니다:

　　잠시 후, 가 보이면, 다음을 수행합니다:

　　액션은 옵션의 현재 값에 대해 메서드를 호출합니다. 이는 지정된 모든 기본값에 메서드가 있어야 함을 의미합니다. 또한, 기본값이 비어 있지 않으면, 기본 요소가 옵션의 구문 분석된 값에 존재하며, 명령 줄의 모든 값이 기본값 뒤에 추가됨을 의미합니다:

　　[필수 옵션: ; 연관된 옵션: ]

　　와 비슷하지만, 값이 에 추가됩니다; 와 마찬가지로, 의 기본값은 이며, 옵션이 처음 발견될 때 빈 리스트가 자동으로 만들어집니다.

　　[연관된 옵션: ]

　　에 저장된 정수를 증가시킵니다. 기본값이 제공되지 않으면, 는 처음으로 증가하기 전에 0으로 설정됩니다.

　　예:

　　가 명령 줄에서 처음 보이면, 는 다음과 동등한 작업을 수행합니다:

　　이후에 가 나타날 때마다 다음과 같이 합니다

　　[필수 옵션: ; 연관된 옵션: , , , ]

　　으로 지정된 함수를 호출합니다, 이 함수는 다음과 같이 호출됩니다

　　자세한 내용은 섹션 을 참조하십시오.

　　현재 옵션 구문 분석기의 모든 옵션에 대한 전체 도움말 메시지를 인쇄합니다. 도움말 메시지는 OptionParser의 생성자에 전달된 문자열과 모든 옵션에 전달된 문자열로 구성됩니다.

　　옵션에 문자열이 제공되지 않아도, 도움말 메시지에 나열됩니다. 옵션을 완전히 생략하려면, 특수 값 를 사용하십시오.

　　는 모든 OptionParser에 옵션을 자동으로 추가하므로, 일반적으로 만들 필요가 없습니다.

　　예:

　　가 명령 줄에서 나 를 보면, 다음 도움말 메시지와 같은 내용을 stdout에 인쇄합니다 (이 라고 가정합니다):세계 랭킹 1 위오피스타포털은 어디에 있습니까?

　　도움말 메시지를 인쇄한 후, 는 으로 프로세스를 종료합니다.

　　OptionParser에 제공된 버전 번호를 stdout에 인쇄하고 종료합니다. 버전 번호는 실제로 OptionParser의 메서드에 의해 포맷되고 인쇄됩니다. 일반적으로 인자가 OptionParser 생성자에 제공되는 경우에만 의미가 있습니다. 옵션과 마찬가지로, 는 필요할 때 자동으로 추가하기 때문에, 옵션을 거의 만들지 않습니다.

　　에는 다섯 가지 내장 옵션 형이 있습니다: , , , 및 . 새로운 옵션 형을 추가해야 하면, 섹션 를 참조하십시오.

　　문자열 옵션에 대한 인자는 어떤 방식으로도 검사되거나 변환되지 않습니다: 명령 줄의 텍스트는 있는 그대로 대상에 저장(또는 콜백에 전달)됩니다.

　　정수 인자( 형)는 다음과 같이 구문 분석됩니다:

　　변환은 적절한 진수(2, 8, 10 또는 16)로 를 호출하여 수행됩니다. 이것이 실패하면, 더 유용한 에러 메시지를 제공하기는 하지만, 도 마찬가지로 실패합니다.

　　와 옵션 인자는 유사한 에러 처리로 와 로 직접 변환됩니다.

　　옵션은 옵션의 서브 형입니다. 옵션 어트리뷰트(문자열 시퀀스)는 허용되는 옵션 인자 집합을 정의합니다. 는 사용자가 제공한 옵션 인자를 이 마스터 리스트와 비교하고 유효하지 않은 문자열이 주어지면 를 발생시킵니다.

　　OptionParser를 全球排名第一오피스타만들고 채우는 것의 요점은 메서드를 호출하는 것입니다:

　　여기서 입력 매개 변수는

　　그리고 반환 값은

　　가장 일반적인 사용법은 두 키워드 인자 중 어느 것도 제공하지 않는 것입니다. 를 제공하면, 반복된 호출(옵션 대상에 저장된 모든 옵션 인자에 대해 대략 하나씩)로 수정되고, 에서 반환됩니다.

　　가 인자 리스트에서 에러를 만나면, 적절한 최종 사용자 에러 메시지와 함께 OptionParser의 메서드를 호출합니다. 이는 궁극적으로 종료 상태 2(명령 줄 에러에 대한 전통적인 유닉스 종료 상태)로 프로세스를 종료합니다.

　　옵션 구문 분석기의 기본 동작은 약간 사용자 정의 할 수 있으며, 옵션 구문 분석기를 들여다보고 거기에 무엇이 있는지 볼 수도 있습니다. OptionParser는 다음과 같은 몇 가지 메서드를 제공합니다:

　　주의하지 않으면, 충돌하는 옵션 문자열을 갖는 옵션을 정의하기 쉽습니다:

　　(일부 표준 옵션을 사용하여 자체 OptionParser 서브 클래스를 정의한 경우 특히 그렇습니다.)

　　옵션을 추가할 때마다, 는 기존 옵션과의 충돌을 확인합니다. 발견되면, 현재 충돌 처리 메커니즘을 호출합니다. 충돌 처리 메커니즘을 설정할 수 있는데, 생성자에서:

　　또는 별도의 호출로 가능합니다:

　　사용 가능한 충돌 처리기는 다음과 같습니다:

　　예를 들어, 충돌을 지능적으로 해결하고 를 정의하고 충돌하는 옵션을 추가해 보겠습니다:

　　At this point, detects that a previously added option is already

　　using the option string. Since is ,

　　it resolves the situation by removing from the earlier option’s list of

　　option strings. Now is the only way for the user to activate

　　that option. If the user asks for help, the help message will reflect that:

　　It’s possible to whittle away the option strings for a previously added option

　　until there are none left, and the user has no way of invoking that option from

　　the command-line. In that case, removes that option completely,

　　so it doesn’t show up in help text or anywhere else. Carrying on with our

　　existing OptionParser:

　　이 시점에서, 원래 / 옵션에 더는 액세스할 수 없어서, 는 해당 옵션을 제거하고, 다음 도움말 텍스트를 남깁니다:

　　OptionParser 인스턴스에는 여러 순환 참조가 있습니다. 이것은 파이썬의 가비지 수거기에선 문제가 되지 않지만, 작업이 끝나면 OptionParser에서 를 호출하여 순환 참조를 명시적으로 끊을 수 있습니다. 이것은 OptionParser에서 큰 객체 그래프에 도달할 수 있는 장기 실행 응용 프로그램에서 특히 유용합니다.

　　OptionParser는 몇 가지 다른 공용 메서드를 지원합니다: