正在执行的程序的名称）。unix shell还使用了“word”一词。

用于提供额外信息以指导或自定义程序执行的参数。选项有许多不同的语法；传统的Unix语法是一个连字符（“-”）后跟一个字母，例如。 -x 或 -F . 此外，传统的Unix语法允许将多个选项合并到单个参数中，例如

世界上看到的其他一些选项语法包括：

• 连字符后跟几个字母，例如 -pf （这是 not 与合并到单个参数中的多个选项相同）

• 连字符后跟一个完整的单词，例如 -file （这在技术上等同于前面的语法，但它们通常不在同一程序中出现）

• 一个加号，后跟一个字母、几个字母或一个词，例如 +f ， +rgb

• 斜线后跟一个字母、几个字母或一个词的斜线。 /f ， /file

他们永远不会。这是故意的：前三个在任何环境中都是非标准的，最后一个只有在您专门针对虚拟机、MS-DOS和/或Windows时才有意义。

跟在选项后面的参数，与该选项密切相关，并且当该选项是时从参数列表中消耗。用 ，选项参数可以是其选项中的单独参数：

或包含在同一个参数中：

通常，一个给定的选项要么接受一个参数，要么不接受。很多人想要一个“可选的选项参数”特性，这意味着一些选项会接受一个参数，如果他们看到它，也不会接受。这有点争议，因为它会使解析变得模棱两可：如果 -a 接受可选参数并 -b 完全是另一种选择，我们如何解释 -ab ？因为这种模棱两可， 不支持此功能。

参数列表中在分析选项后遗留下来的东西，即在分析选项及其参数后从参数列表中删除。

必须在命令行上提供的一种选项；请注意，“必需选项”一词在英语中是自相矛盾的。 这并不能阻止您实现所需的选项，但也不能为您提供太多帮助。

例如，考虑这个假设的命令行：

和 bar 是位置参数。

选项用于提供额外的信息来优化或自定义程序的执行。如果不清楚的话，选择通常是 可选择的 . 程序应该能够正常运行，没有任何选择。（从UNIX或GNU工具集中选择一个随机程序。它能在没有任何选择的情况下运行并且仍然有意义吗？主要的例外是 find ， tar 和 dd ——所有这些都是突变体怪胎，因为它们的非标准语法和混淆的接口而受到了正确的批评。）

很多人希望他们的程序有“必选的选项”。想想看。如果需要，那么 不可选 ！如果有一条信息是程序成功运行所绝对需要的，那么位置参数就是为了这个。

作为良好命令行界面设计的一个例子，考虑到 cp 实用程序，用于复制文件。尝试在不提供目标和至少一个源的情况下复制文件没有多大意义。因此， cp 如果不带参数运行，则失败。但是，它有一个灵活、有用的语法，根本不需要任何选项：

就这样你可以走得很远。大多数 cp 实现提供了一系列选项来精确调整文件的复制方式：您可以保留模式和修改时间，避免使用符号链接，在删除现有文件之前询问等等，但是这些都不会分散对 cp 将一个文件复制到另一个文件，或将多个文件复制到另一个目录。

位置参数是针对那些程序绝对、积极地需要运行的信息片段的。

一个好的用户界面应该有尽可能少的绝对需求。如果你的程序需要17条不同的信息才能成功运行，那就没什么关系了。 how 你从用户那里得到信息——大多数人在成功运行程序之前都会放弃并离开。无论用户界面是命令行、配置文件还是图形用户界面，这都适用：如果您对用户提出如此多的要求，那么他们中的大多数都会放弃。

简而言之，尽量减少用户绝对需要提供的信息量——尽可能使用合理的默认值。当然，您也希望使您的程序具有相当的灵活性。这就是选择的目的。同样，不管它们是配置文件中的条目、GUI的“首选项”对话框中的小部件还是命令行选项——实现的选项越多，程序的灵活性就越高，实现的过程就越复杂。当然，太多的灵活性也有缺点；太多的选项会压倒用户，使代码更难维护。

行动告诉 当它在命令行上遇到一个选项时该怎么做。有一组固定的动作硬编码为 ；添加新操作是本节中介绍的高级主题。 . 大多数行动都说明 在某个变量中存储一个值——例如，从命令行中提取一个字符串，并将其存储在 options .

如果不指定选项操作， 默认为 store .

最常见的选项操作是 store 这告诉 要获取下一个参数（或当前参数的其余部分），请确保其类型正确，并将其存储到所选目标。

现在让我们编一个假命令行，然后问 要分析它：

什么时候？ 查看选项字符串 -f ，它消耗下一个参数，

支持的其他一些选项类型 是 int 和 float . 下面是一个需要整数参数的选项：

注意，这个选项没有长的选项字符串，这是完全可以接受的。此外，由于默认值为 store .

让我们分析另一个假命令行。这一次，我们将把选项参数直接塞进选项：因为 -n42 （一个参数）等于 -n 42 （两个参数），代码：

如果不指定类型， 假设 string .结合默认操作是 store 这意味着我们的第一个例子可能要短得多：

如果你不提供目的地， 从选项字符串中找出一个合理的默认值：如果第一个长选项字符串是 --foo-bar ，则默认目标是 foo_bar . 如果没有长选项字符串， 查看第一个短选项字符串：的默认目标 -f 是

还包括内置 complex 类型。第节介绍了添加类型 .

标记选项——当看到特定选项时，将变量设置为“真”或“假”，这是很常见的。 通过两个独立的动作来支持他们，

在这里，我们有两种不同的选择，目的地相同，这完全可以。（这只意味着在设置默认值时必须小心谨慎---见下文。）

什么时候？ 遭遇战 -v 在命令行上，它设置

支持的其他一些操作 是：

将此选项的参数附加到列表

这些在第节中介绍 和截面 .

上述所有示例都涉及到在看到某些命令行选项时设置一些变量（“目的地”）。如果这些选项从未出现，会发生什么？因为我们没有提供任何默认值，所以它们都设置为 None . 这通常很好，但有时你需要更多的控制。 允许为每个目标提供默认值，该值在分析命令行之前分配。

首先，考虑详细/安静的例子。如果我们想要 设置 verbose 到 True 除非 -q 我们可以这样做：

因为默认值应用于 目的地 而不是任何特定的选项，而且这两个选项恰好具有相同的目的地，这完全等效：

同样，默认值 verbose 将 True ：为任何特定目的地提供的最后一个默认值是计数的值。

和以前一样，为给定选项目的地指定的最后一个值是计数的值。为了清晰起见，请尝试使用一种方法或另一种方法来设置默认值，而不是同时使用这两种方法。

自动生成帮助和使用文本的能力对于创建用户友好的命令行界面很有用。你所要做的就是提供一个 每个选项的值，也可以选择整个程序的简短用法消息。这里有一个选项解析器，填充了用户友好的（文档化的）选项：

如果 遇到任何一个 -h 或 --help 在命令行上，或者如果您只是调用 parser.print_help() ，它将以下内容打印到标准输出：

（如果帮助输出由帮助选项触发， 打印帮助文本后退出。）

这里有很多事情需要帮助 生成最佳的帮助消息：

• 脚本定义了自己的用法消息：

  扩展 %prog 在使用字符串中输入当前程序的名称，即

  如果不提供用法字符串， 使用温和但合理的默认值： "Usage: %prog [options]" ，如果脚本不接受任何位置参数，则可以。

• 每个选项都定义了一个帮助字符串，并且不担心换行--- 注意封装行并使帮助输出看起来很好。

• 接受值的选项在其自动生成的帮助消息中指示此事实，例如对于“模式”选项：

  这里，“模式”被称为元变量：它代表用户需要提供给的参数。 -m/--mode . 默认情况下， 将目标变量名转换为大写，并将其用于元变量。有时，这不是你想要的---例如， --filename 选项显式设置

  不过，这不仅仅是节省空间，更重要的是：手动编写的帮助文本使用了元变量 FILE 提示用户半形式语法之间存在联系 -f FILE 以及非正式的语义描述“将输出写入文件”。这是一个简单但有效的方法，可以使您的帮助文本更清晰，对最终用户更有用。

• 具有默认值的选项可以包括 %default 在帮助字符串中--- 将替换为 选项的默认值。如果选项没有默认值（或默认值为 None ） %default 扩展到

类似于简短用法字符串， 还可以打印程序的版本字符串。必须提供字符串作为

解析器的选项。如果在命令行中遇到此选项，它将扩展

以下两种方法可用于打印和获取 version 字符串：

打印当前程序的版本消息 (self.version 到 file （默认标准输出）。和…一样 ，任何发生 %prog 在里面 self.version 替换为当前程序的名称。什么都不做

等同于 但返回版本字符串而不是打印它。

有两大类错误 必须担心：程序员错误和用户错误。程序员错误通常是对 例如，无效的选项字符串、未知的选项属性、缺少的选项属性等。这些都以通常的方式处理：引发异常（或者

处理用户错误更为重要，因为无论您的代码多么稳定，都保证会发生错误。 可以自动检测某些用户错误，例如错误的选项参数（传递 -n 4x 在哪里？ -n 接受整数参数），缺少参数 (-n 在命令行的末尾，其中 -n 接受任何类型的参数）。另外，你也可以调用

在任何一种情况下， 以同样的方式处理错误：它将程序的使用消息和错误消息打印到标准错误，并以错误状态2退出。

考虑上面的第一个示例，其中用户通过 4x 对于接受整数的选项：

或者，如果用户根本没有传递值：

-生成的错误消息始终要注意提到错误中涉及的选项；在调用

如果 的默认错误处理行为不适合您的需要，您需要将OptionParser子类化并重写其

这里是什么 -基于脚本通常如下所示：

使用的第一步 是创建一个OptionParser实例。

OptionParser构造函数没有必需的参数，但有许多可选关键字参数。您应该始终将它们作为关键字参数传递，即不要依赖于参数声明的顺序。

当程序运行不正确或有帮助选项时要打印的使用率摘要。什么时候？ 打印使用字符串，它将展开

用于填充分析器的选项对象列表。中的选项 option_list 在中的任何选项之后添加 standard_option_list （可由OptionParser子类设置的类属性），但在任何版本或帮助选项之前。弃用；使用 在创建解析器之后。

向中的分析器添加选项时使用的类 .

当用户提供版本选项时要打印的版本字符串。如果您为 version ， 自动添加带有单个选项字符串的版本选项 --version . 子串

指定将具有冲突选项字符串的选项添加到分析器时要执行的操作；请参见第节 .

一段文字，简要概述你的程序。 重新格式化此段落以适应当前的终端宽度，并在用户请求帮助时打印它（在 usage ，但在选项列表之前）。

如果是真的， 将添加一个帮助选项（带有选项字符串 -h

在选项“帮助”之后要打印的帮助文本段落。

有几种方法可以用选项填充解析器。首选的方法是 ，如第节所示 . add_option() 可以通过以下两种方式之一调用：

• 将位置参数和关键字参数的任何组合传递给 make_option() （即，到选项构造函数），它将为您创建选项实例

另一种选择是将预先构造的选项实例列表传递给OptionParser构造函数，如：

(make_option() 是用于创建选项实例的factory函数；当前它是选项构造函数的别名。未来版本的 可以将选项分为几个类，并且 make_option() 将选择要实例化的正确类。不要直接实例化选项。）

每个选项实例表示一组同义的命令行选项字符串，例如 -f 和 --file . 可以指定任意数量的短选项字符串或长选项字符串，但必须至少指定一个整体选项字符串。

要定义仅包含短选项字符串的选项，请执行以下操作：

定义一个只有长选项字符串的选项：

关键字参数定义新选项对象的属性。最重要的选项属性是 它在很大程度上决定了哪些其他属性是相关的或必需的。如果传递不相关的选项属性，或未能传递所需的属性，

选择权 行动 决定什么 在命令行上遇到此选项时执行。标准选项操作硬编码为 是：

存储此选项的参数（默认）

将此选项的参数附加到列表

打印使用信息，包括所有选项及其文档

（如果不提供操作，则默认为 "store" . 对于此操作，您还可以提供 和 选项属性；请参见 ）

如您所见，大多数操作都涉及在某处存储或更新值。 总是为此创建一个特殊的对象，通常称为

第一件事之一 是创建 options 对象：

如果此分析器中的某个选项定义为：：

正在分析的命令行包括以下任何一项：

然后 在看到此选项时，将执行以下等效操作：

这个 和 选项属性几乎和 ，但是 是唯一有意义的 all 选项。

以下选项属性可以作为关键字参数传递给 . 如果传递的选项属性与特定选项无关，或者未能传递所需的选项属性， 引发

决定 在命令行中看到此选项时的行为；可用选项将被记录。 .

此选项所需的参数类型（例如， "string" 或 "int" ）；记录可用选项类型 .

(默认值：从选项字符串派生）

如果选项的操作意味着在某个地方写入或修改值，这将告诉您 在哪里写： 命名的属性 options 对象 在分析命令行时生成。

如果在命令行上看不到该选项，则用于该选项目标的值。也见 .

有多少类型的参数 应该在看到此选项时使用。如果＞1， 将值的元组存储到 .

对于存储常量值的操作，为要存储的常量值。

对于类型的选项 "choice" ，用户可以选择的字符串列表。

对于具有操作的选项 "callback" ，当看到此选项时可调用。见节 有关传递给可调用文件的参数的详细信息。

要传递给的其他位置参数和关键字参数 callback 在四个标准回调参数之后。

列出用户提供后的所有可用选项时，此选项的帮助文本打印 选项（如 --help ）如果未提供帮助文本，则将列出不带帮助文本的选项。要隐藏此选项，请使用特殊值 optparse.SUPPRESS_HELP .

(默认值：从选项字符串派生）

代表打印帮助文本时要使用的选项参数。见节 举个例子。

各种选项操作的要求和效果都略有不同。大多数操作都有几个相关的选项属性，您可以指定这些属性作为指导。 的行为；一些属性是必需的，您必须为使用该操作的任何选项指定这些属性。

• 选项后面必须跟一个参数，该参数根据 并存储在 . 如果 >1，将从命令行使用多个参数；所有参数将根据 并存储到 作为元组。见 部分。

  如果 提供（字符串列表或元组），类型默认为 "choice" .

  如果 未提供， 从第一个长选项字符串（例如， --foo-bar 暗示 foo_bar ）如果没有长选项字符串， 从第一个短选项字符串（例如， -f

• 选项后面必须跟一个参数，该参数将附加到中的列表 . 如果没有默认值 如果提供，则在以下情况下自动创建空列表： 首先在命令行上遇到这个选项。如果 >1，使用多个参数，并使用一个长度为的元组

  如果 -t3 在命令行上看到， 等同于：

  如果过一会儿， --tracks=4 是的，它确实：

  这个 append 行动要求 append 方法的当前值。这意味着指定的任何默认值必须具有 append 方法。它还意味着，如果默认值为非空，则默认元素将出现在选项的分析值中，并且命令行中的任何值都将附加在这些默认值之后：：

• 类似于 "store_const" 但价值 被追加到 一样 "append" ， 默认为 None 第一次遇到该选项时，将自动创建一个空列表。

• 递增存储的整数 . 如果没有提供默认值， 在第一次递增之前设置为零。

  第一次 -v 在命令行中看到， 等同于：

  每次随后发生的 -v 结果：

• 调用由指定的函数 ，称为：

• 打印当前选项分析器中所有选项的完整帮助消息。帮助消息是根据 usage 传递给OptionParser的构造函数和 传递给每个选项的字符串。

  如果没有 为选项提供了字符串，它仍将列在帮助消息中。要完全忽略某个选项，请使用特殊值

  自动添加 所有选项分析器的选项，因此通常不需要创建选项分析器。

  如果 看到要么 -h 或

有五种内置选项类型： "string" ，

不会以任何方式检查或转换字符串选项的参数：命令行上的文本按原样存储在目标中（或传递到回调）。

整数参数（类型 "int" ）分析如下：

• 如果数字以开头 0x ，它被解析为十六进制数

• 如果数字以开头 0 ，它被解析为一个八进制数

• 如果数字以开头 0b ，它被解析为二进制数

• 否则，该数字将被解析为十进制数字。

转换是通过调用 适当的底座（2、8、10或16）。如果失败了，也会失败 ，尽管有一条更有用的错误消息。

"float" 和 "complex" 选项参数直接转换为 和 ，具有类似的错误处理。

选项属性（字符串序列）定义允许的选项参数集。 optparse.check_choice() 将用户提供的选项参数与此主列表进行比较并引发 OptionValueError 如果给定的字符串无效。

一个 optparse.Values 存储选项参数的对象（默认值：的新实例 Values ）--如果给定一个现有对象，选项默认值将不会在其上初始化。

处理完所有选项后剩余的位置参数

最常见的用法是不提供关键字参数。如果你提供 values ，它将被修改为重复 调用（存储到选项目标的每个选项参数大约一个）并由返回

如果 parse_args() 在参数列表中遇到任何错误，它调用OptionParser的 error() 方法，并显示相应的最终用户错误消息。这最终会以2的退出状态（对于命令行错误，传统的Unix退出状态）终止进程。

选项解析器的默认行为可以稍微定制，您还可以绕过选项解析器查看其中的内容。OptionParser提供了几种方法来帮助您：

将分析设置为在第一个非选项上停止。例如，如果 -a 和 -b 都是不带参数的简单选项， 通常接受以下语法：

要禁用此功能，请致电 . 这将恢复传统的Unix语法，其中选项解析使用第一个非选项参数停止。

如果您有一个命令处理器运行另一个命令，该命令有自己的选项，并且您希望确保这些选项不会混淆，请使用该命令。例如，每个命令可能有一组不同的选项。

将parsing设置为不在第一个非选项上停止，允许在开关之间插入命令参数。这是默认行为。

返回带有选项字符串的选项实例 opt_str 或 None 如果没有选项具有该选项字符串。

如果 有一个对应于的选项 opt_str ，该选项将被删除。如果该选项提供了任何其他选项字符串，则所有这些选项字符串都将无效。如果 opt_str 不出现在属于此的任何选项中 提出 .

如果不小心，很容易定义选项字符串冲突的选项：

（如果您已经用一些标准选项定义了自己的OptionParser子类，则情况尤其如此。）

检查是否与现有选项冲突。如果找到任何冲突，它将调用当前的冲突处理机制。您可以在构造函数中设置冲突处理机制：：

可用的冲突处理程序包括：

智能解决选项冲突（见下文）

作为一个例子，让我们定义一个 智能解决冲突并向其添加冲突选项：

在这一点上， 检测到以前添加的选项已在使用 -n 选项字符串。自从 是用户激活该选项的唯一方法。如果用户请求帮助，帮助消息将反映出：

可以将以前添加的选项的选项字符串削短，直到没有剩余的选项，并且用户无法从命令行调用该选项。在那种情况下， 完全删除该选项，因此它不会显示在帮助文本或其他任何地方。继续使用现有的OptionParser:：

此时，原版 -n/--dry-run 选项不再可访问，因此 删除它，保留此帮助文本：

OptionParser实例有几个循环引用。这对Python的垃圾收集器来说应该不是问题，但是您可能希望通过调用 destroy() 一旦完成，就可以在OptionParser上执行。这在长期运行的应用程序中特别有用，在这些应用程序中，可以从OptionParser访问大型对象图。

根据上面描述的规则为 usage 构造函数关键字参数。经过 None 设置默认使用字符串；使用 optparse.SUPPRESS_USAGE 禁止使用消息。

打印当前程序的使用信息 (self.usage 到 file （默认标准输出）。字符串的任何出现 %prog 在里面 self.usage 替换为当前程序的名称。什么都不做

等同于 但返回使用字符串而不是打印它。

同时为多个选项目标设置默认值。使用 是设置选项默认值的首选方法，因为多个选项可以共享同一目标。例如，如果多个“模式”选项都设置了相同的目标，其中任何一个都可以设置默认值，最后一个选项将获胜：

为了避免这种混淆，请使用 ：：

和往常一样，定义回调选项的最简单方法是使用 方法。除了 ，必须指定的唯一选项属性是 callback ，要调用的函数：

callback 是函数（或其他可调用对象），因此必须已定义 my_callback() 创建此回调选项时。在这个简单的例子中， 甚至不知道 -c 接受任何参数，这通常意味着期权不接受任何参数——仅仅存在于 -c 它只需要知道命令行上的内容。不过，在某些情况下，您可能希望回调使用任意数量的命令行参数。这就是写回拨变得棘手的地方；本节稍后将介绍它。

始终将四个特定参数传递给回调，如果通过 和 . 因此，最小回调函数签名为：

回调的四个参数如下所述。

定义回调选项时，还可以提供其他几个选项属性：

有它通常的意思：和 "store" 或 "append" 行动，它指示 使用一个参数并将其转换为 . 但是，不是将转换后的值存储在任何位置， 将其传递给回调函数。

也有它通常的含义：如果它被提供并且大于1， 意志消费 参数，每个参数都必须转换为 .然后它将一个转换值的元组传递给回调。

传递给回调的额外位置参数的元组

要传递给回调的额外关键字参数字典

是否在触发回调的命令行上看到选项字符串。（如果使用了缩写的长选项， opt_str 将是完整的规范选项字符串，例如，如果用户 --foo 在命令行上作为 --foobar 然后

此选项的参数是否显示在命令行上。 只有在 已设置；类型 value 将是选项类型所隐含的类型。如果 因为这个选项是 None （不需要参数），然后 value 将

是OptionParser实例驱动了整个过程，主要是因为您可以通过它的实例属性访问其他一些有趣的数据：

剩余参数的当前列表，即已使用但既不是选项参数也不是选项参数的参数。请随意修改 parser.largs ，例如通过向其添加更多参数。（此列表将变为 args ，的第二个返回值 parse_args() ）

剩余参数的当前列表，即 opt_str 和 value （如果适用）删除，并且只有后面的参数仍然存在。请随意修改 parser.rargs 例如，通过使用更多的参数。

默认情况下存储选项值的对象（optparse.option values的实例）。这使得回调使用与其他回调相同的机制 用于存储选项值；您不需要在全局或闭包中乱转。您还可以访问或修改命令行上已遇到的任何选项的值。

是通过提供任意关键字参数的字典 .

回调函数应引发 OptionValueError 如果选项或其参数有任何问题。 捕获此消息并终止程序，打印您提供给stderr的错误消息。您的信息应该清晰、简洁、准确，并指出错误的选项。否则，用户很难找出他们做错了什么。

下面是一个不带参数的回调选项示例，它只记录看到该选项的情况：

回调示例2：检查选项顺序

下面是一个更有趣的例子：记录下 -a 有人看见了，但如果后面有爆炸 -b 在命令行中。：：

回调示例3：检查选项顺序（通用）

如果要对几个类似选项重复使用此回调（设置标志，但如果 -b 已经看到了），它需要做一些工作：错误消息和它设置的标志必须被通用化。：：

回调示例4：检查任意条件

当然，您可以在其中放置任何条件——您不局限于检查已经定义的选项的值。例如，如果你有在满月时不应该被召唤的选择，你所要做的就是：

当您定义接受固定数量参数的回调选项时，事情会变得稍微有趣一些。指定回调选项接受参数与定义 "store" 或 "append" 选项：如果定义 ，则该选项接受一个必须可转换为该类型的参数；如果进一步定义

下面是一个模拟标准的例子 "store" 行动：

注意 注意使用3个参数，并将它们转换为整数；您所要做的就是存储它们。（或其他；显然，对于这个示例，您不需要回调。）

当你想要一个选择接受一个可变数量的参数时，事情就会变得复杂起来。对于这种情况，您必须编写一个回调，作为 不提供任何内置功能。您必须处理传统的UNIX命令行解析的某些复杂问题， 通常为您处理。特别是，回调应该实现传统的裸机规则

• 任何一个 -- 或 - 可以是选项参数

• 光秃秃的 -- （如果不是某个选项的参数）：停止命令行处理并放弃 --

• 光秃秃的 - （如果不是某个选项的参数）：停止命令行处理，但保留 - （附加到 parser.largs ）

如果你想要一个参数数目可变的选项，有几个微妙的，棘手的问题需要担心。您选择的具体实现将基于您愿意为应用程序作出的权衡（这就是为什么 不直接支持这类事情）。

不过，这里是对带有变量参数的选项的回调的一个戳：

要添加新类型，需要定义自己的子类 的 Option 类。这个类有几个属性定义 类型： 和 .

类型名的元组；在子类中，只需定义一个新的元组 这是建立在标准的基础上的。

将类型名映射到类型检查函数的字典。类型检查函数具有以下签名：

是命令行中必须检查并转换为所需类型的字符串。 check_mytype() 应返回假设类型的对象 mytype . 类型检查函数返回的值将出现在由返回的OptionValues实例中。

你的类型检查功能应该提高 OptionValueError 如果遇到任何问题。 OptionValueError 接受单个字符串参数，该参数按原样传递给 的 error() 方法，该方法依次为程序名和字符串 "error:" 并在终止进程之前将所有内容打印到stderr。

下面是一个愚蠢的示例，演示如何添加 "complex" 在命令行上解析python样式复数的选项类型。（这比以前更愚蠢，因为 1.3增加了对复数的内置支持，但没关系。）

您需要先定义类型检查器，因为稍后会提到它（在 选项子类的类属性）：：

（如果我们没有 属于 ，我们最终会修改 属性 的选项类。这就是 Python ，除了礼貌和常识，没有什么能阻止你这么做。）

就这样！现在，您可以像编写其他脚本一样编写使用新选项类型的脚本。

或者，您可以构建自己的选项列表并将其传递给OptionParser；如果不使用 add_option() 通过上面的方法，您不需要告诉OptionParser要使用哪个选项类：：

增加新的行动是有点难，因为你必须理解 对操作有几个分类：

导致 将值存储到当前optionvalues实例的属性；这些选项需要 要提供给选项构造函数的属性。

从命令行中获取值并期望其为特定类型的操作；或者更确切地说，是可以转换为特定类型的字符串。这些选项需要 属性设置为选项构造函数。

添加操作时，需要将其分类，方法是至少在以下选项的类属性中列出（所有都是字符串列表）：

所有操作都必须列在操作中。

此处还列出了“存储”操作。

此处还列出了“类型化”操作。

此处还列出了始终采用类型（即其选项始终采用值）的操作。唯一的效果是 指定默认类型， "string" ，到没有显式类型的选项，其操作列在 .

为了实际实现新操作，必须重写选项的 take_action() 方法并添加一个可识别您的操作的事例。

例如，让我们添加一个 "extend" 行动。这与标准相似 "append" 操作，但不是从命令行中获取单个值并将其附加到现有列表中， "extend" 将在一个逗号分隔的字符串中获取多个值，并用这些值扩展现有列表。也就是说，如果 --names 是一个 "extend" 类型的选项 "string" ，命令行：

我们再次定义了选项的子类：

• "extend" 两者都期望在命令行上有一个值，并将该值存储在某个位置，因此它会同时进入 和 .

• "extend" ， "append" 和 "count" ，所有这些变量都将数据累积到一个变量中，并期望该变量是某种类型（前两个变量的列表，后一个变量的整数）。使用 ensure_value() 意味着使用您的操作的脚本不必担心为有问题的选项目的地设置默认值；它们只需将默认值保留为 None 和 ensure_value() 在需要的时候会处理好的。