ترقية argparse من 2.x إلى 3.x

مقارنة الواجهة العامة لـ argparse بين 2.0.1 و3.0.2، محسوبة تلقائيًا من أنواع 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؟

عُلِّم 0 من الصادرات أو الأعضاء حديثًا على أنها موقوفة في argparse 3.0.2.

للوكلاء

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