argparse を 2.x から 3.x へアップグレード

argparse 2.0.1 と 3.0.2 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	0
削除されたエクスポート	1
変更されたシグネチャ	18
削除されたクラス／インターフェースのメンバー	1
変更されたクラス／インターフェースのメンバー	45
新たに非推奨	0
要件の変更（engines、peer 依存関係）	0
新しいエクスポート	24

削除されたエクスポート

import	export	kind	変更前
`argparse`	`SubParser`	class	`class`

変更されたシグネチャ

export	変更前	変更後
`argparse · Action`	`class`	`interface`
`argparse · PARSER`	`string`	`"A..."`
`argparse · OPTIONAL`	`string`	`"?"`
`argparse · SUPPRESS`	`string`	`"==SUPPRESS=="`
`argparse · Namespace`	`class`	`interface`
`argparse · REMAINDER`	`string`	`"..."`
`argparse · ONE_OR_MORE`	`string`	`"+"`
`argparse · ZERO_OR_MORE`	`string`	`"*"`
`argparse · ArgumentError`	`class`	`interface`
`argparse · ArgumentGroup`	`class`	`interface`
`argparse · HelpFormatter`	`class`	`interface`
`argparse · ArgumentParser`	`class`	`interface`
`argparse · ArgumentTypeError`	`class`	`interface`
`argparse · RawTextHelpFormatter`	`class`	`interface`
`argparse · BooleanOptionalAction`	`class`	`interface`
`argparse · ActionConstructorOptions`	`number & { _: "ActionConstructorOptions"; }`	`interface`
`argparse · RawDescriptionHelpFormatter`	`class`	`interface`
`argparse · ArgumentDefaultsHelpFormatter`	`class`	`interface`

削除されたクラス／インターフェースのメンバー

member	import	変更前
`ArgumentGroup.add_argument_group`	`argparse`	`(options?: ArgumentGroupOptions \| undefined): ArgumentGroup`

変更されたクラス／インターフェースのメンバー

member	変更前	変更後
`Action.call`	`(parser: ArgumentParser, namespace: Namespace, values: string \| string[], optionString: string \| null): void`	`(parser: ArgumentParser, namespace: Namespace, values: unknown, option_string?: string \| undefined): void`
`Action.constructor`	`(options: ActionConstructorOptions): Action`
`Namespace.constructor`	`(options: object): Namespace`
`ArgumentError.constructor`	`(argument: Action, message: string): ArgumentError`
`ArgumentGroup.constructor`	`(): ArgumentGroup`
`ArgumentGroup.get_default`	`(dest: string): any`	`(dest: string): unknown`
`ArgumentGroup.add_argument`	`(arg: string, options?: ArgumentOptions \| undefined): void \| (arg1: string, arg2: string, options?: ArgumentOptions \| undefined): void`	`(name: string, ...names: string[]): Action \| (name: string, ...namesAndOptions: [...string[], ArgumentOptions]): Action`
`ArgumentGroup.set_defaults`	`(options?: {} \| undefined): void`	`(options: object): void`
`ArgumentGroup.add_mutually_exclusive_group`	`(options?: { required: boolean; } \| undefined): ArgumentGroup`	`(options?: MutuallyExclusiveGroupOptions \| undefined): MutuallyExclusiveGroup`
`HelpFormatter.constructor`	`(): HelpFormatter`
`ArgumentParser.exit`	`(status: number, message: string): void`	`(status?: number \| undefined, message?: string \| undefined): void`
`ArgumentParser.error`	`(err: string \| Error): void`	`(message: string): void`
`ArgumentParser.parse_args`	`(args?: string[] \| undefined, ns?: object \| Namespace \| undefined): any`	`<T extends object = Namespace>(args?: string[] \| undefined, namespace?: T \| undefined): T`
`ArgumentParser.print_help`	`(): void`	`(file?: Writable \| undefined): void`
`ArgumentParser.constructor`	`(options?: ArgumentParserOptions \| undefined): ArgumentParser`
`ArgumentParser.get_default`	`(dest: string): any`	`(dest: string): unknown`
`ArgumentParser.print_usage`	`(): void`	`(file?: Writable \| undefined): void`
`ArgumentParser.add_argument`	`(arg: string, options?: ArgumentOptions \| undefined): void \| (arg1: string, arg2: string, options?: ArgumentOptions \| undefined): void`	`(name: string, ...names: string[]): Action \| (name: string, ...namesAndOptions: [...string[], ArgumentOptions]): Action`
`ArgumentParser.set_defaults`	`(options?: {} \| undefined): void`	`(options: object): void`
`ArgumentParser.add_subparsers`	`(options?: SubparserOptions \| undefined): SubParser`	`(options?: SubparserOptions \| undefined): SubparsersAction`
`ArgumentParser.parse_known_args`	`(args?: string[] \| undefined, ns?: object \| Namespace \| undefined): any[]`	`<T extends object = Namespace>(args?: string[] \| undefined, namespace?: T \| undefined): [T, string[]]`
`ArgumentParser.add_argument_group`	`(options?: ArgumentGroupOptions \| undefined): ArgumentGroup`	`(options?: ArgumentGroupOptions \| undefined): ArgumentGroup \| (title?: string \| undefined, description?: string \| undefined): ArgumentGroup`
`ArgumentParser.parse_intermixed_args`	`(args?: string[] \| undefined, ns?: object \| Namespace \| undefined): any`	`<T extends object = Namespace>(args?: string[] \| undefined, namespace?: T \| undefined): T`
`ArgumentParser.convert_arg_line_to_args`	`(argLine: string): string[]`	`(arg_line: string): string[]`
`ArgumentParser.parse_known_intermixed_args`	`(args?: string[] \| undefined, ns?: object \| Namespace \| undefined): any[]`	`<T extends object = Namespace>(args?: string[] \| undefined, namespace?: T \| undefined): [T, string[]]`
`ArgumentParser.add_mutually_exclusive_group`	`(options?: { required: boolean; } \| undefined): ArgumentGroup`	`(options?: MutuallyExclusiveGroupOptions \| undefined): MutuallyExclusiveGroup`
`ArgumentOptions.type`	`string \| Function \| undefined`	`ArgumentType \| undefined`
`ArgumentOptions.const`	`any`	`unknown`
`ArgumentOptions.nargs`	`string \| number \| undefined`	`Nargs \| undefined`
`ArgumentOptions.action`	`string \| (new (options: ActionConstructorOptions) => Action) \| undefined`	`string \| ActionClass \| undefined`
`ArgumentOptions.choices`	`string \| string[] \| undefined`	`string \| object \| readonly unknown[] \| undefined`
`ArgumentOptions.default`	`any`	`unknown`
`SubparserOptions.action`	`string \| undefined`	`string \| ActionClass \| undefined`
`SubparserOptions.parser_class`	`(new () => any) \| undefined`	`ArgumentParserClass \| undefined`
`ArgumentTypeError.constructor`	`(message: string): ArgumentTypeError`
`ArgumentGroupOptions.argument_default`	`any`	`unknown`
`RawTextHelpFormatter.constructor`	`(): RawTextHelpFormatter`
`ArgumentParserOptions.formatter_class`	`(new () => HelpFormatter \| ArgumentDefaultsHelpFormatter \| RawDescriptionHelpFormatter \| RawTextHelpFormatter) \| undefined`	`HelpFormatterFactory \| undefined`
`ArgumentParserOptions.argument_default`	`any`	`unknown`
`BooleanOptionalAction.call`	`(parser: ArgumentParser, namespace: Namespace, values: string \| string[], optionString: string \| null): void`	`(parser: ArgumentParser, namespace: Namespace, values: unknown, option_string?: string \| undefined): void`
`BooleanOptionalAction.constructor`	`(options: ActionConstructorOptions): BooleanOptionalAction`
`SubArgumentParserOptions.formatter_class`	`(new () => HelpFormatter \| ArgumentDefaultsHelpFormatter \| RawDescriptionHelpFormatter \| RawTextHelpFormatter) \| undefined`	`HelpFormatterFactory \| undefined`
`SubArgumentParserOptions.argument_default`	`any`	`unknown`
`RawDescriptionHelpFormatter.constructor`	`(): RawDescriptionHelpFormatter`
`ArgumentDefaultsHelpFormatter.constructor`	`(): ArgumentDefaultsHelpFormatter`

新たに非推奨

検出されませんでした。

要件の変更（engines、peer 依存関係）

検出されませんでした。

新しいエクスポート (24)

import	export	kind
`argparse`	`Nargs`	type
`argparse`	`FileType`	interface
`argparse`	`Writable`	interface
`argparse`	`ActionClass`	interface
`argparse`	`ArgumentType`	type
`argparse`	`FileTypeResult`	interface
`argparse`	`FileTypeOptions`	interface
`argparse`	`ActionsContainer`	interface
`argparse`	`SubparsersAction`	interface
`argparse`	`ActionConstructor`	interface
`argparse`	`HelpFormatterClass`	interface
`argparse`	`ArgumentParserClass`	interface
`argparse`	`FileTypeConstructor`	interface
`argparse`	`HelpFormatterFactory`	type
`argparse`	`HelpFormatterOptions`	interface
`argparse`	`NamespaceConstructor`	interface
`argparse`	`MutuallyExclusiveGroup`	interface
`argparse`	`ArgumentErrorConstructor`	interface
`argparse`	`HelpFormatterConstructor`	interface
`argparse`	`MetavarTypeHelpFormatter`	interface
`argparse`	`ArgumentParserConstructor`	interface
`argparse`	`ArgumentTypeErrorConstructor`	interface
`argparse`	`MutuallyExclusiveGroupOptions`	interface
`argparse`	`BooleanOptionalActionConstructor`	interface

よくある質問

argparse を 2 から 3 にアップグレードする際の破壊的変更は？

argparse 2.0.1 と 3.0.2 の間で、Vigia は削除されたエクスポートを 1 件、変更されたシグネチャを 18 件、削除または変更されたクラス／インターフェースのメンバーを 46 件検出しました。

argparse 3 で非推奨になったものは？

argparse 3.0.2 では 0 件のエクスポートまたはメンバーが新たに非推奨になりました。

エージェント向け

GET https://vigia.coredls.cloud/v1/packages/npm/argparse/upgrade?from=2.0.1&to=3.0.2