diff --git a/.tx/config b/.tx/config index b5b6c17058..ff76935344 100644 --- a/.tx/config +++ b/.tx/config @@ -1,7 +1,7 @@ [main] host = https://www.transifex.com -[o:python-doc:p:python-newest:r:about] +[o:python-doc:p:python-314:r:about] file_filter = about.po source_file = gettext/about.pot type = PO @@ -10,7 +10,7 @@ resource_name = about replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:bugs] +[o:python-doc:p:python-314:r:bugs] file_filter = bugs.po source_file = gettext/bugs.pot type = PO @@ -19,7 +19,70 @@ resource_name = bugs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--abstract] +[o:python-doc:p:python-314:r:builtins--constants] +file_filter = builtins/constants.po +source_file = gettext/builtins/constants.pot +type = PO +minimum_perc = 0 +resource_name = builtins--constants +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:builtins--exceptions] +file_filter = builtins/exceptions.po +source_file = gettext/builtins/exceptions.pot +type = PO +minimum_perc = 0 +resource_name = builtins--exceptions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:builtins--functions] +file_filter = builtins/functions.po +source_file = gettext/builtins/functions.pot +type = PO +minimum_perc = 0 +resource_name = builtins--functions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:builtins--index] +file_filter = builtins/index.po +source_file = gettext/builtins/index.pot +type = PO +minimum_perc = 0 +resource_name = builtins--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:builtins--stdtypes] +file_filter = builtins/stdtypes.po +source_file = gettext/builtins/stdtypes.pot +type = PO +minimum_perc = 0 +resource_name = builtins--stdtypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:builtins--threadsafety] +file_filter = builtins/threadsafety.po +source_file = gettext/builtins/threadsafety.pot +type = PO +minimum_perc = 0 +resource_name = builtins--threadsafety +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:builtins--time-complexity] +file_filter = builtins/time-complexity.po +source_file = gettext/builtins/time-complexity.pot +type = PO +minimum_perc = 0 +resource_name = builtins--time-complexity +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:c-api--abstract] file_filter = c-api/abstract.po source_file = gettext/c-api/abstract.pot type = PO @@ -28,7 +91,7 @@ resource_name = c-api--abstract replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--allocation] +[o:python-doc:p:python-314:r:c-api--allocation] file_filter = c-api/allocation.po source_file = gettext/c-api/allocation.pot type = PO @@ -37,7 +100,7 @@ resource_name = c-api--allocation replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--apiabiversion] +[o:python-doc:p:python-314:r:c-api--apiabiversion] file_filter = c-api/apiabiversion.po source_file = gettext/c-api/apiabiversion.pot type = PO @@ -46,7 +109,7 @@ resource_name = c-api--apiabiversion replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--arg] +[o:python-doc:p:python-314:r:c-api--arg] file_filter = c-api/arg.po source_file = gettext/c-api/arg.pot type = PO @@ -55,7 +118,7 @@ resource_name = c-api--arg replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--bool] +[o:python-doc:p:python-314:r:c-api--bool] file_filter = c-api/bool.po source_file = gettext/c-api/bool.pot type = PO @@ -64,7 +127,7 @@ resource_name = c-api--bool replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--buffer] +[o:python-doc:p:python-314:r:c-api--buffer] file_filter = c-api/buffer.po source_file = gettext/c-api/buffer.pot type = PO @@ -73,7 +136,7 @@ resource_name = c-api--buffer replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--bytearray] +[o:python-doc:p:python-314:r:c-api--bytearray] file_filter = c-api/bytearray.po source_file = gettext/c-api/bytearray.pot type = PO @@ -82,7 +145,7 @@ resource_name = c-api--bytearray replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--bytes] +[o:python-doc:p:python-314:r:c-api--bytes] file_filter = c-api/bytes.po source_file = gettext/c-api/bytes.pot type = PO @@ -91,7 +154,7 @@ resource_name = c-api--bytes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--call] +[o:python-doc:p:python-314:r:c-api--call] file_filter = c-api/call.po source_file = gettext/c-api/call.pot type = PO @@ -100,7 +163,7 @@ resource_name = c-api--call replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--capsule] +[o:python-doc:p:python-314:r:c-api--capsule] file_filter = c-api/capsule.po source_file = gettext/c-api/capsule.pot type = PO @@ -109,7 +172,7 @@ resource_name = c-api--capsule replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--cell] +[o:python-doc:p:python-314:r:c-api--cell] file_filter = c-api/cell.po source_file = gettext/c-api/cell.pot type = PO @@ -118,7 +181,7 @@ resource_name = c-api--cell replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--code] +[o:python-doc:p:python-314:r:c-api--code] file_filter = c-api/code.po source_file = gettext/c-api/code.pot type = PO @@ -127,7 +190,7 @@ resource_name = c-api--code replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--codec] +[o:python-doc:p:python-314:r:c-api--codec] file_filter = c-api/codec.po source_file = gettext/c-api/codec.pot type = PO @@ -136,7 +199,7 @@ resource_name = c-api--codec replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--complex] +[o:python-doc:p:python-314:r:c-api--complex] file_filter = c-api/complex.po source_file = gettext/c-api/complex.pot type = PO @@ -145,7 +208,7 @@ resource_name = c-api--complex replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--concrete] +[o:python-doc:p:python-314:r:c-api--concrete] file_filter = c-api/concrete.po source_file = gettext/c-api/concrete.pot type = PO @@ -154,7 +217,7 @@ resource_name = c-api--concrete replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--contextvars] +[o:python-doc:p:python-314:r:c-api--contextvars] file_filter = c-api/contextvars.po source_file = gettext/c-api/contextvars.pot type = PO @@ -163,7 +226,7 @@ resource_name = c-api--contextvars replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--conversion] +[o:python-doc:p:python-314:r:c-api--conversion] file_filter = c-api/conversion.po source_file = gettext/c-api/conversion.pot type = PO @@ -172,7 +235,7 @@ resource_name = c-api--conversion replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--coro] +[o:python-doc:p:python-314:r:c-api--coro] file_filter = c-api/coro.po source_file = gettext/c-api/coro.pot type = PO @@ -181,7 +244,7 @@ resource_name = c-api--coro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--curses] +[o:python-doc:p:python-314:r:c-api--curses] file_filter = c-api/curses.po source_file = gettext/c-api/curses.pot type = PO @@ -190,7 +253,7 @@ resource_name = c-api--curses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--datetime] +[o:python-doc:p:python-314:r:c-api--datetime] file_filter = c-api/datetime.po source_file = gettext/c-api/datetime.pot type = PO @@ -199,7 +262,7 @@ resource_name = c-api--datetime replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--descriptor] +[o:python-doc:p:python-314:r:c-api--descriptor] file_filter = c-api/descriptor.po source_file = gettext/c-api/descriptor.pot type = PO @@ -208,7 +271,7 @@ resource_name = c-api--descriptor replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--dict] +[o:python-doc:p:python-314:r:c-api--dict] file_filter = c-api/dict.po source_file = gettext/c-api/dict.pot type = PO @@ -217,7 +280,7 @@ resource_name = c-api--dict replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--exceptions] +[o:python-doc:p:python-314:r:c-api--exceptions] file_filter = c-api/exceptions.po source_file = gettext/c-api/exceptions.pot type = PO @@ -226,7 +289,7 @@ resource_name = c-api--exceptions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--extension-modules] +[o:python-doc:p:python-314:r:c-api--extension-modules] file_filter = c-api/extension-modules.po source_file = gettext/c-api/extension-modules.pot type = PO @@ -235,7 +298,7 @@ resource_name = c-api--extension-modules replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--file] +[o:python-doc:p:python-314:r:c-api--file] file_filter = c-api/file.po source_file = gettext/c-api/file.pot type = PO @@ -244,7 +307,7 @@ resource_name = c-api--file replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--float] +[o:python-doc:p:python-314:r:c-api--float] file_filter = c-api/float.po source_file = gettext/c-api/float.pot type = PO @@ -253,7 +316,7 @@ resource_name = c-api--float replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--frame] +[o:python-doc:p:python-314:r:c-api--frame] file_filter = c-api/frame.po source_file = gettext/c-api/frame.pot type = PO @@ -262,7 +325,7 @@ resource_name = c-api--frame replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--function] +[o:python-doc:p:python-314:r:c-api--function] file_filter = c-api/function.po source_file = gettext/c-api/function.pot type = PO @@ -271,7 +334,7 @@ resource_name = c-api--function replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--gcsupport] +[o:python-doc:p:python-314:r:c-api--gcsupport] file_filter = c-api/gcsupport.po source_file = gettext/c-api/gcsupport.pot type = PO @@ -280,7 +343,7 @@ resource_name = c-api--gcsupport replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--gen] +[o:python-doc:p:python-314:r:c-api--gen] file_filter = c-api/gen.po source_file = gettext/c-api/gen.pot type = PO @@ -289,7 +352,7 @@ resource_name = c-api--gen replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--hash] +[o:python-doc:p:python-314:r:c-api--hash] file_filter = c-api/hash.po source_file = gettext/c-api/hash.pot type = PO @@ -298,7 +361,7 @@ resource_name = c-api--hash replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--import] +[o:python-doc:p:python-314:r:c-api--import] file_filter = c-api/import.po source_file = gettext/c-api/import.pot type = PO @@ -307,7 +370,7 @@ resource_name = c-api--import replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--index] +[o:python-doc:p:python-314:r:c-api--index] file_filter = c-api/index.po source_file = gettext/c-api/index.pot type = PO @@ -316,7 +379,7 @@ resource_name = c-api--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--init] +[o:python-doc:p:python-314:r:c-api--init] file_filter = c-api/init.po source_file = gettext/c-api/init.pot type = PO @@ -325,7 +388,7 @@ resource_name = c-api--init replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--init_config] +[o:python-doc:p:python-314:r:c-api--init_config] file_filter = c-api/init_config.po source_file = gettext/c-api/init_config.pot type = PO @@ -334,7 +397,7 @@ resource_name = c-api--init_config replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--interp-lifecycle] +[o:python-doc:p:python-314:r:c-api--interp-lifecycle] file_filter = c-api/interp-lifecycle.po source_file = gettext/c-api/interp-lifecycle.pot type = PO @@ -343,7 +406,7 @@ resource_name = c-api--interp-lifecycle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--intro] +[o:python-doc:p:python-314:r:c-api--intro] file_filter = c-api/intro.po source_file = gettext/c-api/intro.pot type = PO @@ -352,7 +415,7 @@ resource_name = c-api--intro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--iter] +[o:python-doc:p:python-314:r:c-api--iter] file_filter = c-api/iter.po source_file = gettext/c-api/iter.pot type = PO @@ -361,7 +424,7 @@ resource_name = c-api--iter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--iterator] +[o:python-doc:p:python-314:r:c-api--iterator] file_filter = c-api/iterator.po source_file = gettext/c-api/iterator.pot type = PO @@ -370,7 +433,7 @@ resource_name = c-api--iterator replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--lifecycle] +[o:python-doc:p:python-314:r:c-api--lifecycle] file_filter = c-api/lifecycle.po source_file = gettext/c-api/lifecycle.pot type = PO @@ -379,7 +442,7 @@ resource_name = c-api--lifecycle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--list] +[o:python-doc:p:python-314:r:c-api--list] file_filter = c-api/list.po source_file = gettext/c-api/list.pot type = PO @@ -388,7 +451,7 @@ resource_name = c-api--list replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--long] +[o:python-doc:p:python-314:r:c-api--long] file_filter = c-api/long.po source_file = gettext/c-api/long.pot type = PO @@ -397,7 +460,7 @@ resource_name = c-api--long replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--mapping] +[o:python-doc:p:python-314:r:c-api--mapping] file_filter = c-api/mapping.po source_file = gettext/c-api/mapping.pot type = PO @@ -406,7 +469,7 @@ resource_name = c-api--mapping replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--marshal] +[o:python-doc:p:python-314:r:c-api--marshal] file_filter = c-api/marshal.po source_file = gettext/c-api/marshal.pot type = PO @@ -415,7 +478,7 @@ resource_name = c-api--marshal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--memory] +[o:python-doc:p:python-314:r:c-api--memory] file_filter = c-api/memory.po source_file = gettext/c-api/memory.pot type = PO @@ -424,7 +487,7 @@ resource_name = c-api--memory replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--memoryview] +[o:python-doc:p:python-314:r:c-api--memoryview] file_filter = c-api/memoryview.po source_file = gettext/c-api/memoryview.pot type = PO @@ -433,7 +496,7 @@ resource_name = c-api--memoryview replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--method] +[o:python-doc:p:python-314:r:c-api--method] file_filter = c-api/method.po source_file = gettext/c-api/method.pot type = PO @@ -442,7 +505,7 @@ resource_name = c-api--method replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--module] +[o:python-doc:p:python-314:r:c-api--module] file_filter = c-api/module.po source_file = gettext/c-api/module.pot type = PO @@ -451,7 +514,7 @@ resource_name = c-api--module replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--monitoring] +[o:python-doc:p:python-314:r:c-api--monitoring] file_filter = c-api/monitoring.po source_file = gettext/c-api/monitoring.pot type = PO @@ -460,7 +523,7 @@ resource_name = c-api--monitoring replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--none] +[o:python-doc:p:python-314:r:c-api--none] file_filter = c-api/none.po source_file = gettext/c-api/none.pot type = PO @@ -469,7 +532,7 @@ resource_name = c-api--none replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--number] +[o:python-doc:p:python-314:r:c-api--number] file_filter = c-api/number.po source_file = gettext/c-api/number.pot type = PO @@ -478,7 +541,7 @@ resource_name = c-api--number replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--object] +[o:python-doc:p:python-314:r:c-api--object] file_filter = c-api/object.po source_file = gettext/c-api/object.pot type = PO @@ -487,7 +550,7 @@ resource_name = c-api--object replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--objimpl] +[o:python-doc:p:python-314:r:c-api--objimpl] file_filter = c-api/objimpl.po source_file = gettext/c-api/objimpl.pot type = PO @@ -496,7 +559,7 @@ resource_name = c-api--objimpl replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--perfmaps] +[o:python-doc:p:python-314:r:c-api--perfmaps] file_filter = c-api/perfmaps.po source_file = gettext/c-api/perfmaps.pot type = PO @@ -505,7 +568,7 @@ resource_name = c-api--perfmaps replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--picklebuffer] +[o:python-doc:p:python-314:r:c-api--picklebuffer] file_filter = c-api/picklebuffer.po source_file = gettext/c-api/picklebuffer.pot type = PO @@ -514,7 +577,7 @@ resource_name = c-api--picklebuffer replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--profiling] +[o:python-doc:p:python-314:r:c-api--profiling] file_filter = c-api/profiling.po source_file = gettext/c-api/profiling.pot type = PO @@ -523,7 +586,16 @@ resource_name = c-api--profiling replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--refcounting] +[o:python-doc:p:python-314:r:c-api--pyexpat] +file_filter = c-api/pyexpat.po +source_file = gettext/c-api/pyexpat.pot +type = PO +minimum_perc = 0 +resource_name = c-api--pyexpat +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:c-api--refcounting] file_filter = c-api/refcounting.po source_file = gettext/c-api/refcounting.pot type = PO @@ -532,7 +604,7 @@ resource_name = c-api--refcounting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--reflection] +[o:python-doc:p:python-314:r:c-api--reflection] file_filter = c-api/reflection.po source_file = gettext/c-api/reflection.pot type = PO @@ -541,7 +613,7 @@ resource_name = c-api--reflection replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--sequence] +[o:python-doc:p:python-314:r:c-api--sequence] file_filter = c-api/sequence.po source_file = gettext/c-api/sequence.pot type = PO @@ -550,7 +622,7 @@ resource_name = c-api--sequence replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--set] +[o:python-doc:p:python-314:r:c-api--set] file_filter = c-api/set.po source_file = gettext/c-api/set.pot type = PO @@ -559,7 +631,7 @@ resource_name = c-api--set replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--slice] +[o:python-doc:p:python-314:r:c-api--slice] file_filter = c-api/slice.po source_file = gettext/c-api/slice.pot type = PO @@ -568,7 +640,7 @@ resource_name = c-api--slice replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--stable] +[o:python-doc:p:python-314:r:c-api--stable] file_filter = c-api/stable.po source_file = gettext/c-api/stable.pot type = PO @@ -577,7 +649,7 @@ resource_name = c-api--stable replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--structures] +[o:python-doc:p:python-314:r:c-api--structures] file_filter = c-api/structures.po source_file = gettext/c-api/structures.pot type = PO @@ -586,7 +658,7 @@ resource_name = c-api--structures replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--subinterpreters] +[o:python-doc:p:python-314:r:c-api--subinterpreters] file_filter = c-api/subinterpreters.po source_file = gettext/c-api/subinterpreters.pot type = PO @@ -595,7 +667,7 @@ resource_name = c-api--subinterpreters replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--synchronization] +[o:python-doc:p:python-314:r:c-api--synchronization] file_filter = c-api/synchronization.po source_file = gettext/c-api/synchronization.pot type = PO @@ -604,7 +676,7 @@ resource_name = c-api--synchronization replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--sys] +[o:python-doc:p:python-314:r:c-api--sys] file_filter = c-api/sys.po source_file = gettext/c-api/sys.pot type = PO @@ -613,7 +685,7 @@ resource_name = c-api--sys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--threads] +[o:python-doc:p:python-314:r:c-api--threads] file_filter = c-api/threads.po source_file = gettext/c-api/threads.pot type = PO @@ -622,7 +694,7 @@ resource_name = c-api--threads replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--time] +[o:python-doc:p:python-314:r:c-api--time] file_filter = c-api/time.po source_file = gettext/c-api/time.pot type = PO @@ -631,7 +703,7 @@ resource_name = c-api--time replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--tls] +[o:python-doc:p:python-314:r:c-api--tls] file_filter = c-api/tls.po source_file = gettext/c-api/tls.pot type = PO @@ -640,7 +712,7 @@ resource_name = c-api--tls replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--tuple] +[o:python-doc:p:python-314:r:c-api--tuple] file_filter = c-api/tuple.po source_file = gettext/c-api/tuple.pot type = PO @@ -649,7 +721,7 @@ resource_name = c-api--tuple replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--type] +[o:python-doc:p:python-314:r:c-api--type] file_filter = c-api/type.po source_file = gettext/c-api/type.pot type = PO @@ -658,7 +730,7 @@ resource_name = c-api--type replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--typehints] +[o:python-doc:p:python-314:r:c-api--typehints] file_filter = c-api/typehints.po source_file = gettext/c-api/typehints.pot type = PO @@ -667,7 +739,7 @@ resource_name = c-api--typehints replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--typeobj] +[o:python-doc:p:python-314:r:c-api--typeobj] file_filter = c-api/typeobj.po source_file = gettext/c-api/typeobj.pot type = PO @@ -676,7 +748,7 @@ resource_name = c-api--typeobj replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--unicode] +[o:python-doc:p:python-314:r:c-api--unicode] file_filter = c-api/unicode.po source_file = gettext/c-api/unicode.pot type = PO @@ -685,7 +757,7 @@ resource_name = c-api--unicode replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--utilities] +[o:python-doc:p:python-314:r:c-api--utilities] file_filter = c-api/utilities.po source_file = gettext/c-api/utilities.pot type = PO @@ -694,7 +766,7 @@ resource_name = c-api--utilities replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--veryhigh] +[o:python-doc:p:python-314:r:c-api--veryhigh] file_filter = c-api/veryhigh.po source_file = gettext/c-api/veryhigh.pot type = PO @@ -703,7 +775,7 @@ resource_name = c-api--veryhigh replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--weakref] +[o:python-doc:p:python-314:r:c-api--weakref] file_filter = c-api/weakref.po source_file = gettext/c-api/weakref.pot type = PO @@ -712,7 +784,7 @@ resource_name = c-api--weakref replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:contents] +[o:python-doc:p:python-314:r:contents] file_filter = contents.po source_file = gettext/contents.pot type = PO @@ -721,7 +793,7 @@ resource_name = contents replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:copyright] +[o:python-doc:p:python-314:r:copyright] file_filter = copyright.po source_file = gettext/copyright.pot type = PO @@ -730,7 +802,7 @@ resource_name = copyright replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-3_14] +[o:python-doc:p:python-314:r:deprecations--c-api-pending-removal-in-3_14] file_filter = deprecations/c-api-pending-removal-in-3.14.po source_file = gettext/deprecations/c-api-pending-removal-in-3.14.pot type = PO @@ -739,7 +811,7 @@ resource_name = deprecations--c-api-pending-removal-in-3_14 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-3_15] +[o:python-doc:p:python-314:r:deprecations--c-api-pending-removal-in-3_15] file_filter = deprecations/c-api-pending-removal-in-3.15.po source_file = gettext/deprecations/c-api-pending-removal-in-3.15.pot type = PO @@ -748,7 +820,7 @@ resource_name = deprecations--c-api-pending-removal-in-3_15 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-3_16] +[o:python-doc:p:python-314:r:deprecations--c-api-pending-removal-in-3_16] file_filter = deprecations/c-api-pending-removal-in-3.16.po source_file = gettext/deprecations/c-api-pending-removal-in-3.16.pot type = PO @@ -757,7 +829,7 @@ resource_name = deprecations--c-api-pending-removal-in-3_16 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-3_18] +[o:python-doc:p:python-314:r:deprecations--c-api-pending-removal-in-3_18] file_filter = deprecations/c-api-pending-removal-in-3.18.po source_file = gettext/deprecations/c-api-pending-removal-in-3.18.pot type = PO @@ -766,7 +838,7 @@ resource_name = deprecations--c-api-pending-removal-in-3_18 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-future] +[o:python-doc:p:python-314:r:deprecations--c-api-pending-removal-in-future] file_filter = deprecations/c-api-pending-removal-in-future.po source_file = gettext/deprecations/c-api-pending-removal-in-future.pot type = PO @@ -775,7 +847,7 @@ resource_name = deprecations--c-api-pending-removal-in-future replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--index] +[o:python-doc:p:python-314:r:deprecations--index] file_filter = deprecations/index.po source_file = gettext/deprecations/index.pot type = PO @@ -784,7 +856,7 @@ resource_name = deprecations--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_13] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_13] file_filter = deprecations/pending-removal-in-3.13.po source_file = gettext/deprecations/pending-removal-in-3.13.pot type = PO @@ -793,7 +865,7 @@ resource_name = deprecations--pending-removal-in-3_13 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_14] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_14] file_filter = deprecations/pending-removal-in-3.14.po source_file = gettext/deprecations/pending-removal-in-3.14.pot type = PO @@ -802,7 +874,7 @@ resource_name = deprecations--pending-removal-in-3_14 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_15] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_15] file_filter = deprecations/pending-removal-in-3.15.po source_file = gettext/deprecations/pending-removal-in-3.15.pot type = PO @@ -811,7 +883,7 @@ resource_name = deprecations--pending-removal-in-3_15 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_16] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_16] file_filter = deprecations/pending-removal-in-3.16.po source_file = gettext/deprecations/pending-removal-in-3.16.pot type = PO @@ -820,7 +892,7 @@ resource_name = deprecations--pending-removal-in-3_16 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_17] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_17] file_filter = deprecations/pending-removal-in-3.17.po source_file = gettext/deprecations/pending-removal-in-3.17.pot type = PO @@ -829,7 +901,7 @@ resource_name = deprecations--pending-removal-in-3_17 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_18] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_18] file_filter = deprecations/pending-removal-in-3.18.po source_file = gettext/deprecations/pending-removal-in-3.18.pot type = PO @@ -838,7 +910,7 @@ resource_name = deprecations--pending-removal-in-3_18 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_19] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-3_19] file_filter = deprecations/pending-removal-in-3.19.po source_file = gettext/deprecations/pending-removal-in-3.19.pot type = PO @@ -847,7 +919,7 @@ resource_name = deprecations--pending-removal-in-3_19 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-future] +[o:python-doc:p:python-314:r:deprecations--pending-removal-in-future] file_filter = deprecations/pending-removal-in-future.po source_file = gettext/deprecations/pending-removal-in-future.pot type = PO @@ -856,7 +928,7 @@ resource_name = deprecations--pending-removal-in-future replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:distributing--index] +[o:python-doc:p:python-314:r:distributing--index] file_filter = distributing/index.po source_file = gettext/distributing/index.pot type = PO @@ -865,7 +937,7 @@ resource_name = distributing--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--building] +[o:python-doc:p:python-314:r:extending--building] file_filter = extending/building.po source_file = gettext/extending/building.pot type = PO @@ -874,7 +946,7 @@ resource_name = extending--building replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--embedding] +[o:python-doc:p:python-314:r:extending--embedding] file_filter = extending/embedding.po source_file = gettext/extending/embedding.pot type = PO @@ -883,7 +955,7 @@ resource_name = extending--embedding replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--extending] +[o:python-doc:p:python-314:r:extending--extending] file_filter = extending/extending.po source_file = gettext/extending/extending.pot type = PO @@ -892,7 +964,7 @@ resource_name = extending--extending replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--index] +[o:python-doc:p:python-314:r:extending--index] file_filter = extending/index.po source_file = gettext/extending/index.pot type = PO @@ -901,7 +973,7 @@ resource_name = extending--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--newtypes] +[o:python-doc:p:python-314:r:extending--newtypes] file_filter = extending/newtypes.po source_file = gettext/extending/newtypes.pot type = PO @@ -910,7 +982,7 @@ resource_name = extending--newtypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--newtypes_tutorial] +[o:python-doc:p:python-314:r:extending--newtypes_tutorial] file_filter = extending/newtypes_tutorial.po source_file = gettext/extending/newtypes_tutorial.pot type = PO @@ -919,7 +991,7 @@ resource_name = extending--newtypes_tutorial replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--windows] +[o:python-doc:p:python-314:r:extending--windows] file_filter = extending/windows.po source_file = gettext/extending/windows.pot type = PO @@ -928,7 +1000,7 @@ resource_name = extending--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--design] +[o:python-doc:p:python-314:r:faq--design] file_filter = faq/design.po source_file = gettext/faq/design.pot type = PO @@ -937,7 +1009,7 @@ resource_name = faq--design replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--extending] +[o:python-doc:p:python-314:r:faq--extending] file_filter = faq/extending.po source_file = gettext/faq/extending.pot type = PO @@ -946,7 +1018,7 @@ resource_name = faq--extending replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--general] +[o:python-doc:p:python-314:r:faq--general] file_filter = faq/general.po source_file = gettext/faq/general.pot type = PO @@ -955,7 +1027,7 @@ resource_name = faq--general replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--gui] +[o:python-doc:p:python-314:r:faq--gui] file_filter = faq/gui.po source_file = gettext/faq/gui.pot type = PO @@ -964,7 +1036,7 @@ resource_name = faq--gui replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--index] +[o:python-doc:p:python-314:r:faq--index] file_filter = faq/index.po source_file = gettext/faq/index.pot type = PO @@ -973,7 +1045,7 @@ resource_name = faq--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--installed] +[o:python-doc:p:python-314:r:faq--installed] file_filter = faq/installed.po source_file = gettext/faq/installed.pot type = PO @@ -982,7 +1054,7 @@ resource_name = faq--installed replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--library] +[o:python-doc:p:python-314:r:faq--library] file_filter = faq/library.po source_file = gettext/faq/library.pot type = PO @@ -991,7 +1063,7 @@ resource_name = faq--library replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--programming] +[o:python-doc:p:python-314:r:faq--programming] file_filter = faq/programming.po source_file = gettext/faq/programming.pot type = PO @@ -1000,7 +1072,7 @@ resource_name = faq--programming replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--windows] +[o:python-doc:p:python-314:r:faq--windows] file_filter = faq/windows.po source_file = gettext/faq/windows.pot type = PO @@ -1009,7 +1081,7 @@ resource_name = faq--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:glossary_] +[o:python-doc:p:python-314:r:glossary_] file_filter = glossary.po source_file = gettext/glossary.pot type = PO @@ -1018,7 +1090,7 @@ resource_name = glossary_ replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--a-conceptual-overview-of-asyncio] +[o:python-doc:p:python-314:r:howto--a-conceptual-overview-of-asyncio] file_filter = howto/a-conceptual-overview-of-asyncio.po source_file = gettext/howto/a-conceptual-overview-of-asyncio.pot type = PO @@ -1027,7 +1099,7 @@ resource_name = howto--a-conceptual-overview-of-asyncio replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--annotations] +[o:python-doc:p:python-314:r:howto--annotations] file_filter = howto/annotations.po source_file = gettext/howto/annotations.pot type = PO @@ -1036,7 +1108,7 @@ resource_name = howto--annotations replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--argparse] +[o:python-doc:p:python-314:r:howto--argparse] file_filter = howto/argparse.po source_file = gettext/howto/argparse.pot type = PO @@ -1045,7 +1117,7 @@ resource_name = howto--argparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--argparse-optparse] +[o:python-doc:p:python-314:r:howto--argparse-optparse] file_filter = howto/argparse-optparse.po source_file = gettext/howto/argparse-optparse.pot type = PO @@ -1054,7 +1126,7 @@ resource_name = howto--argparse-optparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--clinic] +[o:python-doc:p:python-314:r:howto--clinic] file_filter = howto/clinic.po source_file = gettext/howto/clinic.pot type = PO @@ -1063,7 +1135,7 @@ resource_name = howto--clinic replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--cporting] +[o:python-doc:p:python-314:r:howto--cporting] file_filter = howto/cporting.po source_file = gettext/howto/cporting.pot type = PO @@ -1072,7 +1144,7 @@ resource_name = howto--cporting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--curses] +[o:python-doc:p:python-314:r:howto--curses] file_filter = howto/curses.po source_file = gettext/howto/curses.pot type = PO @@ -1081,7 +1153,7 @@ resource_name = howto--curses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--descriptor] +[o:python-doc:p:python-314:r:howto--descriptor] file_filter = howto/descriptor.po source_file = gettext/howto/descriptor.pot type = PO @@ -1090,7 +1162,7 @@ resource_name = howto--descriptor replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--enum] +[o:python-doc:p:python-314:r:howto--enum] file_filter = howto/enum.po source_file = gettext/howto/enum.pot type = PO @@ -1099,7 +1171,7 @@ resource_name = howto--enum replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--free-threading-extensions] +[o:python-doc:p:python-314:r:howto--free-threading-extensions] file_filter = howto/free-threading-extensions.po source_file = gettext/howto/free-threading-extensions.pot type = PO @@ -1108,7 +1180,7 @@ resource_name = howto--free-threading-extensions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--free-threading-python] +[o:python-doc:p:python-314:r:howto--free-threading-python] file_filter = howto/free-threading-python.po source_file = gettext/howto/free-threading-python.pot type = PO @@ -1117,7 +1189,7 @@ resource_name = howto--free-threading-python replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--functional] +[o:python-doc:p:python-314:r:howto--functional] file_filter = howto/functional.po source_file = gettext/howto/functional.pot type = PO @@ -1126,7 +1198,7 @@ resource_name = howto--functional replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--gdb_helpers] +[o:python-doc:p:python-314:r:howto--gdb_helpers] file_filter = howto/gdb_helpers.po source_file = gettext/howto/gdb_helpers.pot type = PO @@ -1135,7 +1207,7 @@ resource_name = howto--gdb_helpers replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--index] +[o:python-doc:p:python-314:r:howto--index] file_filter = howto/index.po source_file = gettext/howto/index.pot type = PO @@ -1144,7 +1216,7 @@ resource_name = howto--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--instrumentation] +[o:python-doc:p:python-314:r:howto--instrumentation] file_filter = howto/instrumentation.po source_file = gettext/howto/instrumentation.pot type = PO @@ -1153,7 +1225,7 @@ resource_name = howto--instrumentation replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--ipaddress] +[o:python-doc:p:python-314:r:howto--ipaddress] file_filter = howto/ipaddress.po source_file = gettext/howto/ipaddress.pot type = PO @@ -1162,7 +1234,7 @@ resource_name = howto--ipaddress replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--isolating-extensions] +[o:python-doc:p:python-314:r:howto--isolating-extensions] file_filter = howto/isolating-extensions.po source_file = gettext/howto/isolating-extensions.pot type = PO @@ -1171,7 +1243,7 @@ resource_name = howto--isolating-extensions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--logging] +[o:python-doc:p:python-314:r:howto--logging] file_filter = howto/logging.po source_file = gettext/howto/logging.pot type = PO @@ -1180,7 +1252,7 @@ resource_name = howto--logging replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--logging-cookbook] +[o:python-doc:p:python-314:r:howto--logging-cookbook] file_filter = howto/logging-cookbook.po source_file = gettext/howto/logging-cookbook.pot type = PO @@ -1189,7 +1261,7 @@ resource_name = howto--logging-cookbook replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--mro] +[o:python-doc:p:python-314:r:howto--mro] file_filter = howto/mro.po source_file = gettext/howto/mro.pot type = PO @@ -1198,7 +1270,7 @@ resource_name = howto--mro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--perf_profiling] +[o:python-doc:p:python-314:r:howto--perf_profiling] file_filter = howto/perf_profiling.po source_file = gettext/howto/perf_profiling.pot type = PO @@ -1207,7 +1279,7 @@ resource_name = howto--perf_profiling replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--pyporting] +[o:python-doc:p:python-314:r:howto--pyporting] file_filter = howto/pyporting.po source_file = gettext/howto/pyporting.pot type = PO @@ -1216,7 +1288,7 @@ resource_name = howto--pyporting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--regex] +[o:python-doc:p:python-314:r:howto--regex] file_filter = howto/regex.po source_file = gettext/howto/regex.pot type = PO @@ -1225,7 +1297,7 @@ resource_name = howto--regex replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--remote_debugging] +[o:python-doc:p:python-314:r:howto--remote_debugging] file_filter = howto/remote_debugging.po source_file = gettext/howto/remote_debugging.pot type = PO @@ -1234,7 +1306,7 @@ resource_name = howto--remote_debugging replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--sockets] +[o:python-doc:p:python-314:r:howto--sockets] file_filter = howto/sockets.po source_file = gettext/howto/sockets.pot type = PO @@ -1243,7 +1315,7 @@ resource_name = howto--sockets replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--sorting] +[o:python-doc:p:python-314:r:howto--sorting] file_filter = howto/sorting.po source_file = gettext/howto/sorting.pot type = PO @@ -1252,7 +1324,7 @@ resource_name = howto--sorting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--timerfd] +[o:python-doc:p:python-314:r:howto--timerfd] file_filter = howto/timerfd.po source_file = gettext/howto/timerfd.pot type = PO @@ -1261,7 +1333,7 @@ resource_name = howto--timerfd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--unicode] +[o:python-doc:p:python-314:r:howto--unicode] file_filter = howto/unicode.po source_file = gettext/howto/unicode.pot type = PO @@ -1270,7 +1342,7 @@ resource_name = howto--unicode replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--urllib2] +[o:python-doc:p:python-314:r:howto--urllib2] file_filter = howto/urllib2.po source_file = gettext/howto/urllib2.pot type = PO @@ -1279,7 +1351,7 @@ resource_name = howto--urllib2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:improve-page] +[o:python-doc:p:python-314:r:improve-page] file_filter = improve-page.po source_file = gettext/improve-page.pot type = PO @@ -1288,7 +1360,7 @@ resource_name = improve-page replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:improve-page-nojs] +[o:python-doc:p:python-314:r:improve-page-nojs] file_filter = improve-page-nojs.po source_file = gettext/improve-page-nojs.pot type = PO @@ -1297,7 +1369,7 @@ resource_name = improve-page-nojs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:installing--index] +[o:python-doc:p:python-314:r:installing--index] file_filter = installing/index.po source_file = gettext/installing/index.pot type = PO @@ -1306,7 +1378,7 @@ resource_name = installing--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--__future__] +[o:python-doc:p:python-314:r:library--__future__] file_filter = library/__future__.po source_file = gettext/library/__future__.pot type = PO @@ -1315,7 +1387,7 @@ resource_name = library--__future__ replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--__main__] +[o:python-doc:p:python-314:r:library--__main__] file_filter = library/__main__.po source_file = gettext/library/__main__.pot type = PO @@ -1324,7 +1396,7 @@ resource_name = library--__main__ replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--_thread] +[o:python-doc:p:python-314:r:library--_thread] file_filter = library/_thread.po source_file = gettext/library/_thread.pot type = PO @@ -1333,7 +1405,7 @@ resource_name = library--_thread replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--abc] +[o:python-doc:p:python-314:r:library--abc] file_filter = library/abc.po source_file = gettext/library/abc.pot type = PO @@ -1342,7 +1414,7 @@ resource_name = library--abc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--aifc] +[o:python-doc:p:python-314:r:library--aifc] file_filter = library/aifc.po source_file = gettext/library/aifc.pot type = PO @@ -1351,7 +1423,7 @@ resource_name = library--aifc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--allos] +[o:python-doc:p:python-314:r:library--allos] file_filter = library/allos.po source_file = gettext/library/allos.pot type = PO @@ -1360,7 +1432,7 @@ resource_name = library--allos replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--annotationlib] +[o:python-doc:p:python-314:r:library--annotationlib] file_filter = library/annotationlib.po source_file = gettext/library/annotationlib.pot type = PO @@ -1369,7 +1441,7 @@ resource_name = library--annotationlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--archiving] +[o:python-doc:p:python-314:r:library--archiving] file_filter = library/archiving.po source_file = gettext/library/archiving.pot type = PO @@ -1378,7 +1450,7 @@ resource_name = library--archiving replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--argparse] +[o:python-doc:p:python-314:r:library--argparse] file_filter = library/argparse.po source_file = gettext/library/argparse.pot type = PO @@ -1387,7 +1459,7 @@ resource_name = library--argparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--array] +[o:python-doc:p:python-314:r:library--array] file_filter = library/array.po source_file = gettext/library/array.pot type = PO @@ -1396,7 +1468,7 @@ resource_name = library--array replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ast] +[o:python-doc:p:python-314:r:library--ast] file_filter = library/ast.po source_file = gettext/library/ast.pot type = PO @@ -1405,7 +1477,7 @@ resource_name = library--ast replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asynchat] +[o:python-doc:p:python-314:r:library--asynchat] file_filter = library/asynchat.po source_file = gettext/library/asynchat.pot type = PO @@ -1414,7 +1486,7 @@ resource_name = library--asynchat replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio] +[o:python-doc:p:python-314:r:library--asyncio] file_filter = library/asyncio.po source_file = gettext/library/asyncio.pot type = PO @@ -1423,7 +1495,7 @@ resource_name = library--asyncio replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-api-index] +[o:python-doc:p:python-314:r:library--asyncio-api-index] file_filter = library/asyncio-api-index.po source_file = gettext/library/asyncio-api-index.pot type = PO @@ -1432,7 +1504,7 @@ resource_name = library--asyncio-api-index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-dev] +[o:python-doc:p:python-314:r:library--asyncio-dev] file_filter = library/asyncio-dev.po source_file = gettext/library/asyncio-dev.pot type = PO @@ -1441,7 +1513,7 @@ resource_name = library--asyncio-dev replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-eventloop] +[o:python-doc:p:python-314:r:library--asyncio-eventloop] file_filter = library/asyncio-eventloop.po source_file = gettext/library/asyncio-eventloop.pot type = PO @@ -1450,7 +1522,7 @@ resource_name = library--asyncio-eventloop replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-exceptions] +[o:python-doc:p:python-314:r:library--asyncio-exceptions] file_filter = library/asyncio-exceptions.po source_file = gettext/library/asyncio-exceptions.pot type = PO @@ -1459,7 +1531,7 @@ resource_name = library--asyncio-exceptions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-extending] +[o:python-doc:p:python-314:r:library--asyncio-extending] file_filter = library/asyncio-extending.po source_file = gettext/library/asyncio-extending.pot type = PO @@ -1468,7 +1540,7 @@ resource_name = library--asyncio-extending replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-future] +[o:python-doc:p:python-314:r:library--asyncio-future] file_filter = library/asyncio-future.po source_file = gettext/library/asyncio-future.pot type = PO @@ -1477,7 +1549,7 @@ resource_name = library--asyncio-future replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-graph] +[o:python-doc:p:python-314:r:library--asyncio-graph] file_filter = library/asyncio-graph.po source_file = gettext/library/asyncio-graph.pot type = PO @@ -1486,7 +1558,7 @@ resource_name = library--asyncio-graph replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-llapi-index] +[o:python-doc:p:python-314:r:library--asyncio-llapi-index] file_filter = library/asyncio-llapi-index.po source_file = gettext/library/asyncio-llapi-index.pot type = PO @@ -1495,7 +1567,7 @@ resource_name = library--asyncio-llapi-index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-platforms] +[o:python-doc:p:python-314:r:library--asyncio-platforms] file_filter = library/asyncio-platforms.po source_file = gettext/library/asyncio-platforms.pot type = PO @@ -1504,7 +1576,7 @@ resource_name = library--asyncio-platforms replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-policy] +[o:python-doc:p:python-314:r:library--asyncio-policy] file_filter = library/asyncio-policy.po source_file = gettext/library/asyncio-policy.pot type = PO @@ -1513,7 +1585,7 @@ resource_name = library--asyncio-policy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-protocol] +[o:python-doc:p:python-314:r:library--asyncio-protocol] file_filter = library/asyncio-protocol.po source_file = gettext/library/asyncio-protocol.pot type = PO @@ -1522,7 +1594,7 @@ resource_name = library--asyncio-protocol replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-queue] +[o:python-doc:p:python-314:r:library--asyncio-queue] file_filter = library/asyncio-queue.po source_file = gettext/library/asyncio-queue.pot type = PO @@ -1531,7 +1603,7 @@ resource_name = library--asyncio-queue replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-runner] +[o:python-doc:p:python-314:r:library--asyncio-runner] file_filter = library/asyncio-runner.po source_file = gettext/library/asyncio-runner.pot type = PO @@ -1540,7 +1612,7 @@ resource_name = library--asyncio-runner replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-stream] +[o:python-doc:p:python-314:r:library--asyncio-stream] file_filter = library/asyncio-stream.po source_file = gettext/library/asyncio-stream.pot type = PO @@ -1549,7 +1621,7 @@ resource_name = library--asyncio-stream replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-subprocess] +[o:python-doc:p:python-314:r:library--asyncio-subprocess] file_filter = library/asyncio-subprocess.po source_file = gettext/library/asyncio-subprocess.pot type = PO @@ -1558,7 +1630,7 @@ resource_name = library--asyncio-subprocess replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-sync] +[o:python-doc:p:python-314:r:library--asyncio-sync] file_filter = library/asyncio-sync.po source_file = gettext/library/asyncio-sync.pot type = PO @@ -1567,7 +1639,7 @@ resource_name = library--asyncio-sync replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-task] +[o:python-doc:p:python-314:r:library--asyncio-task] file_filter = library/asyncio-task.po source_file = gettext/library/asyncio-task.pot type = PO @@ -1576,7 +1648,25 @@ resource_name = library--asyncio-task replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncore] +[o:python-doc:p:python-314:r:library--asyncio-threading] +file_filter = library/asyncio-threading.po +source_file = gettext/library/asyncio-threading.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-threading +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:library--asyncio-tools] +file_filter = library/asyncio-tools.po +source_file = gettext/library/asyncio-tools.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-tools +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-314:r:library--asyncore] file_filter = library/asyncore.po source_file = gettext/library/asyncore.pot type = PO @@ -1585,7 +1675,7 @@ resource_name = library--asyncore replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--atexit] +[o:python-doc:p:python-314:r:library--atexit] file_filter = library/atexit.po source_file = gettext/library/atexit.pot type = PO @@ -1594,7 +1684,7 @@ resource_name = library--atexit replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--audioop] +[o:python-doc:p:python-314:r:library--audioop] file_filter = library/audioop.po source_file = gettext/library/audioop.pot type = PO @@ -1603,7 +1693,7 @@ resource_name = library--audioop replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--audit_events] +[o:python-doc:p:python-314:r:library--audit_events] file_filter = library/audit_events.po source_file = gettext/library/audit_events.pot type = PO @@ -1612,7 +1702,7 @@ resource_name = library--audit_events replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--base64] +[o:python-doc:p:python-314:r:library--base64] file_filter = library/base64.po source_file = gettext/library/base64.pot type = PO @@ -1621,7 +1711,7 @@ resource_name = library--base64 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--bdb] +[o:python-doc:p:python-314:r:library--bdb] file_filter = library/bdb.po source_file = gettext/library/bdb.pot type = PO @@ -1630,7 +1720,7 @@ resource_name = library--bdb replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--binary] +[o:python-doc:p:python-314:r:library--binary] file_filter = library/binary.po source_file = gettext/library/binary.pot type = PO @@ -1639,7 +1729,7 @@ resource_name = library--binary replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--binascii] +[o:python-doc:p:python-314:r:library--binascii] file_filter = library/binascii.po source_file = gettext/library/binascii.pot type = PO @@ -1648,7 +1738,7 @@ resource_name = library--binascii replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--bisect] +[o:python-doc:p:python-314:r:library--bisect] file_filter = library/bisect.po source_file = gettext/library/bisect.pot type = PO @@ -1657,7 +1747,7 @@ resource_name = library--bisect replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--builtins] +[o:python-doc:p:python-314:r:library--builtins] file_filter = library/builtins.po source_file = gettext/library/builtins.pot type = PO @@ -1666,7 +1756,7 @@ resource_name = library--builtins replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--bz2] +[o:python-doc:p:python-314:r:library--bz2] file_filter = library/bz2.po source_file = gettext/library/bz2.pot type = PO @@ -1675,7 +1765,7 @@ resource_name = library--bz2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--calendar] +[o:python-doc:p:python-314:r:library--calendar] file_filter = library/calendar.po source_file = gettext/library/calendar.pot type = PO @@ -1684,7 +1774,7 @@ resource_name = library--calendar replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cgi] +[o:python-doc:p:python-314:r:library--cgi] file_filter = library/cgi.po source_file = gettext/library/cgi.pot type = PO @@ -1693,7 +1783,7 @@ resource_name = library--cgi replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cgitb] +[o:python-doc:p:python-314:r:library--cgitb] file_filter = library/cgitb.po source_file = gettext/library/cgitb.pot type = PO @@ -1702,7 +1792,7 @@ resource_name = library--cgitb replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--chunk] +[o:python-doc:p:python-314:r:library--chunk] file_filter = library/chunk.po source_file = gettext/library/chunk.pot type = PO @@ -1711,7 +1801,7 @@ resource_name = library--chunk replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmath] +[o:python-doc:p:python-314:r:library--cmath] file_filter = library/cmath.po source_file = gettext/library/cmath.pot type = PO @@ -1720,7 +1810,7 @@ resource_name = library--cmath replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmd] +[o:python-doc:p:python-314:r:library--cmd] file_filter = library/cmd.po source_file = gettext/library/cmd.pot type = PO @@ -1729,7 +1819,7 @@ resource_name = library--cmd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmdline] +[o:python-doc:p:python-314:r:library--cmdline] file_filter = library/cmdline.po source_file = gettext/library/cmdline.pot type = PO @@ -1738,7 +1828,7 @@ resource_name = library--cmdline replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmdlinelibs] +[o:python-doc:p:python-314:r:library--cmdlinelibs] file_filter = library/cmdlinelibs.po source_file = gettext/library/cmdlinelibs.pot type = PO @@ -1747,7 +1837,7 @@ resource_name = library--cmdlinelibs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--code] +[o:python-doc:p:python-314:r:library--code] file_filter = library/code.po source_file = gettext/library/code.pot type = PO @@ -1756,7 +1846,7 @@ resource_name = library--code replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--codecs] +[o:python-doc:p:python-314:r:library--codecs] file_filter = library/codecs.po source_file = gettext/library/codecs.pot type = PO @@ -1765,7 +1855,7 @@ resource_name = library--codecs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--codeop] +[o:python-doc:p:python-314:r:library--codeop] file_filter = library/codeop.po source_file = gettext/library/codeop.pot type = PO @@ -1774,7 +1864,7 @@ resource_name = library--codeop replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--collections] +[o:python-doc:p:python-314:r:library--collections] file_filter = library/collections.po source_file = gettext/library/collections.pot type = PO @@ -1783,7 +1873,7 @@ resource_name = library--collections replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--collections_abc] +[o:python-doc:p:python-314:r:library--collections_abc] file_filter = library/collections.abc.po source_file = gettext/library/collections.abc.pot type = PO @@ -1792,7 +1882,7 @@ resource_name = library--collections_abc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--colorsys] +[o:python-doc:p:python-314:r:library--colorsys] file_filter = library/colorsys.po source_file = gettext/library/colorsys.pot type = PO @@ -1801,7 +1891,7 @@ resource_name = library--colorsys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--compileall] +[o:python-doc:p:python-314:r:library--compileall] file_filter = library/compileall.po source_file = gettext/library/compileall.pot type = PO @@ -1810,7 +1900,7 @@ resource_name = library--compileall replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--compression] +[o:python-doc:p:python-314:r:library--compression] file_filter = library/compression.po source_file = gettext/library/compression.pot type = PO @@ -1819,7 +1909,7 @@ resource_name = library--compression replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--compression_zstd] +[o:python-doc:p:python-314:r:library--compression_zstd] file_filter = library/compression.zstd.po source_file = gettext/library/compression.zstd.pot type = PO @@ -1828,7 +1918,7 @@ resource_name = library--compression_zstd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrency] +[o:python-doc:p:python-314:r:library--concurrency] file_filter = library/concurrency.po source_file = gettext/library/concurrency.pot type = PO @@ -1837,7 +1927,7 @@ resource_name = library--concurrency replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrent] +[o:python-doc:p:python-314:r:library--concurrent] file_filter = library/concurrent.po source_file = gettext/library/concurrent.pot type = PO @@ -1846,7 +1936,7 @@ resource_name = library--concurrent replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrent_futures] +[o:python-doc:p:python-314:r:library--concurrent_futures] file_filter = library/concurrent.futures.po source_file = gettext/library/concurrent.futures.pot type = PO @@ -1855,7 +1945,7 @@ resource_name = library--concurrent_futures replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrent_interpreters] +[o:python-doc:p:python-314:r:library--concurrent_interpreters] file_filter = library/concurrent.interpreters.po source_file = gettext/library/concurrent.interpreters.pot type = PO @@ -1864,7 +1954,7 @@ resource_name = library--concurrent_interpreters replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--configparser] +[o:python-doc:p:python-314:r:library--configparser] file_filter = library/configparser.po source_file = gettext/library/configparser.pot type = PO @@ -1873,16 +1963,7 @@ resource_name = library--configparser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--constants] -file_filter = library/constants.po -source_file = gettext/library/constants.pot -type = PO -minimum_perc = 0 -resource_name = library--constants -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--contextlib] +[o:python-doc:p:python-314:r:library--contextlib] file_filter = library/contextlib.po source_file = gettext/library/contextlib.pot type = PO @@ -1891,7 +1972,7 @@ resource_name = library--contextlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--contextvars] +[o:python-doc:p:python-314:r:library--contextvars] file_filter = library/contextvars.po source_file = gettext/library/contextvars.pot type = PO @@ -1900,7 +1981,7 @@ resource_name = library--contextvars replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--copy] +[o:python-doc:p:python-314:r:library--copy] file_filter = library/copy.po source_file = gettext/library/copy.pot type = PO @@ -1909,7 +1990,7 @@ resource_name = library--copy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--copyreg] +[o:python-doc:p:python-314:r:library--copyreg] file_filter = library/copyreg.po source_file = gettext/library/copyreg.pot type = PO @@ -1918,7 +1999,7 @@ resource_name = library--copyreg replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--crypt] +[o:python-doc:p:python-314:r:library--crypt] file_filter = library/crypt.po source_file = gettext/library/crypt.pot type = PO @@ -1927,7 +2008,7 @@ resource_name = library--crypt replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--crypto] +[o:python-doc:p:python-314:r:library--crypto] file_filter = library/crypto.po source_file = gettext/library/crypto.pot type = PO @@ -1936,7 +2017,7 @@ resource_name = library--crypto replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--csv] +[o:python-doc:p:python-314:r:library--csv] file_filter = library/csv.po source_file = gettext/library/csv.pot type = PO @@ -1945,7 +2026,7 @@ resource_name = library--csv replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ctypes] +[o:python-doc:p:python-314:r:library--ctypes] file_filter = library/ctypes.po source_file = gettext/library/ctypes.pot type = PO @@ -1954,7 +2035,7 @@ resource_name = library--ctypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--curses] +[o:python-doc:p:python-314:r:library--curses] file_filter = library/curses.po source_file = gettext/library/curses.pot type = PO @@ -1963,7 +2044,7 @@ resource_name = library--curses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--curses_ascii] +[o:python-doc:p:python-314:r:library--curses_ascii] file_filter = library/curses.ascii.po source_file = gettext/library/curses.ascii.pot type = PO @@ -1972,7 +2053,7 @@ resource_name = library--curses_ascii replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--curses_panel] +[o:python-doc:p:python-314:r:library--curses_panel] file_filter = library/curses.panel.po source_file = gettext/library/curses.panel.pot type = PO @@ -1981,7 +2062,7 @@ resource_name = library--curses_panel replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--custominterp] +[o:python-doc:p:python-314:r:library--custominterp] file_filter = library/custominterp.po source_file = gettext/library/custominterp.pot type = PO @@ -1990,7 +2071,7 @@ resource_name = library--custominterp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dataclasses] +[o:python-doc:p:python-314:r:library--dataclasses] file_filter = library/dataclasses.po source_file = gettext/library/dataclasses.pot type = PO @@ -1999,7 +2080,7 @@ resource_name = library--dataclasses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--datatypes] +[o:python-doc:p:python-314:r:library--datatypes] file_filter = library/datatypes.po source_file = gettext/library/datatypes.pot type = PO @@ -2008,7 +2089,7 @@ resource_name = library--datatypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--datetime] +[o:python-doc:p:python-314:r:library--datetime] file_filter = library/datetime.po source_file = gettext/library/datetime.pot type = PO @@ -2017,7 +2098,7 @@ resource_name = library--datetime replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dbm] +[o:python-doc:p:python-314:r:library--dbm] file_filter = library/dbm.po source_file = gettext/library/dbm.pot type = PO @@ -2026,7 +2107,7 @@ resource_name = library--dbm replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--debug] +[o:python-doc:p:python-314:r:library--debug] file_filter = library/debug.po source_file = gettext/library/debug.pot type = PO @@ -2035,7 +2116,7 @@ resource_name = library--debug replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--decimal] +[o:python-doc:p:python-314:r:library--decimal] file_filter = library/decimal.po source_file = gettext/library/decimal.pot type = PO @@ -2044,7 +2125,7 @@ resource_name = library--decimal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--development] +[o:python-doc:p:python-314:r:library--development] file_filter = library/development.po source_file = gettext/library/development.pot type = PO @@ -2053,7 +2134,7 @@ resource_name = library--development replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--devmode] +[o:python-doc:p:python-314:r:library--devmode] file_filter = library/devmode.po source_file = gettext/library/devmode.pot type = PO @@ -2062,7 +2143,7 @@ resource_name = library--devmode replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dialog] +[o:python-doc:p:python-314:r:library--dialog] file_filter = library/dialog.po source_file = gettext/library/dialog.pot type = PO @@ -2071,7 +2152,7 @@ resource_name = library--dialog replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--difflib] +[o:python-doc:p:python-314:r:library--difflib] file_filter = library/difflib.po source_file = gettext/library/difflib.pot type = PO @@ -2080,7 +2161,7 @@ resource_name = library--difflib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dis] +[o:python-doc:p:python-314:r:library--dis] file_filter = library/dis.po source_file = gettext/library/dis.pot type = PO @@ -2089,7 +2170,7 @@ resource_name = library--dis replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--distribution] +[o:python-doc:p:python-314:r:library--distribution] file_filter = library/distribution.po source_file = gettext/library/distribution.pot type = PO @@ -2098,7 +2179,7 @@ resource_name = library--distribution replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--distutils] +[o:python-doc:p:python-314:r:library--distutils] file_filter = library/distutils.po source_file = gettext/library/distutils.pot type = PO @@ -2107,7 +2188,7 @@ resource_name = library--distutils replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--doctest] +[o:python-doc:p:python-314:r:library--doctest] file_filter = library/doctest.po source_file = gettext/library/doctest.pot type = PO @@ -2116,7 +2197,7 @@ resource_name = library--doctest replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email] +[o:python-doc:p:python-314:r:library--email] file_filter = library/email.po source_file = gettext/library/email.pot type = PO @@ -2125,7 +2206,7 @@ resource_name = library--email replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_charset] +[o:python-doc:p:python-314:r:library--email_charset] file_filter = library/email.charset.po source_file = gettext/library/email.charset.pot type = PO @@ -2134,7 +2215,7 @@ resource_name = library--email_charset replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_compat32-message] +[o:python-doc:p:python-314:r:library--email_compat32-message] file_filter = library/email.compat32-message.po source_file = gettext/library/email.compat32-message.pot type = PO @@ -2143,7 +2224,7 @@ resource_name = library--email_compat32-message replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_contentmanager] +[o:python-doc:p:python-314:r:library--email_contentmanager] file_filter = library/email.contentmanager.po source_file = gettext/library/email.contentmanager.pot type = PO @@ -2152,7 +2233,7 @@ resource_name = library--email_contentmanager replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_encoders] +[o:python-doc:p:python-314:r:library--email_encoders] file_filter = library/email.encoders.po source_file = gettext/library/email.encoders.pot type = PO @@ -2161,7 +2242,7 @@ resource_name = library--email_encoders replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_errors] +[o:python-doc:p:python-314:r:library--email_errors] file_filter = library/email.errors.po source_file = gettext/library/email.errors.pot type = PO @@ -2170,7 +2251,7 @@ resource_name = library--email_errors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_examples] +[o:python-doc:p:python-314:r:library--email_examples] file_filter = library/email.examples.po source_file = gettext/library/email.examples.pot type = PO @@ -2179,7 +2260,7 @@ resource_name = library--email_examples replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_generator] +[o:python-doc:p:python-314:r:library--email_generator] file_filter = library/email.generator.po source_file = gettext/library/email.generator.pot type = PO @@ -2188,7 +2269,7 @@ resource_name = library--email_generator replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_header] +[o:python-doc:p:python-314:r:library--email_header] file_filter = library/email.header.po source_file = gettext/library/email.header.pot type = PO @@ -2197,7 +2278,7 @@ resource_name = library--email_header replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_headerregistry] +[o:python-doc:p:python-314:r:library--email_headerregistry] file_filter = library/email.headerregistry.po source_file = gettext/library/email.headerregistry.pot type = PO @@ -2206,7 +2287,7 @@ resource_name = library--email_headerregistry replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_iterators] +[o:python-doc:p:python-314:r:library--email_iterators] file_filter = library/email.iterators.po source_file = gettext/library/email.iterators.pot type = PO @@ -2215,7 +2296,7 @@ resource_name = library--email_iterators replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_message] +[o:python-doc:p:python-314:r:library--email_message] file_filter = library/email.message.po source_file = gettext/library/email.message.pot type = PO @@ -2224,7 +2305,7 @@ resource_name = library--email_message replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_mime] +[o:python-doc:p:python-314:r:library--email_mime] file_filter = library/email.mime.po source_file = gettext/library/email.mime.pot type = PO @@ -2233,7 +2314,7 @@ resource_name = library--email_mime replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_parser] +[o:python-doc:p:python-314:r:library--email_parser] file_filter = library/email.parser.po source_file = gettext/library/email.parser.pot type = PO @@ -2242,7 +2323,7 @@ resource_name = library--email_parser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_policy] +[o:python-doc:p:python-314:r:library--email_policy] file_filter = library/email.policy.po source_file = gettext/library/email.policy.pot type = PO @@ -2251,7 +2332,7 @@ resource_name = library--email_policy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_utils] +[o:python-doc:p:python-314:r:library--email_utils] file_filter = library/email.utils.po source_file = gettext/library/email.utils.pot type = PO @@ -2260,7 +2341,7 @@ resource_name = library--email_utils replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ensurepip] +[o:python-doc:p:python-314:r:library--ensurepip] file_filter = library/ensurepip.po source_file = gettext/library/ensurepip.pot type = PO @@ -2269,7 +2350,7 @@ resource_name = library--ensurepip replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--enum] +[o:python-doc:p:python-314:r:library--enum] file_filter = library/enum.po source_file = gettext/library/enum.pot type = PO @@ -2278,7 +2359,7 @@ resource_name = library--enum replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--errno] +[o:python-doc:p:python-314:r:library--errno] file_filter = library/errno.po source_file = gettext/library/errno.pot type = PO @@ -2287,16 +2368,7 @@ resource_name = library--errno replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--exceptions] -file_filter = library/exceptions.po -source_file = gettext/library/exceptions.pot -type = PO -minimum_perc = 0 -resource_name = library--exceptions -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--faulthandler] +[o:python-doc:p:python-314:r:library--faulthandler] file_filter = library/faulthandler.po source_file = gettext/library/faulthandler.pot type = PO @@ -2305,7 +2377,7 @@ resource_name = library--faulthandler replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fcntl] +[o:python-doc:p:python-314:r:library--fcntl] file_filter = library/fcntl.po source_file = gettext/library/fcntl.pot type = PO @@ -2314,7 +2386,7 @@ resource_name = library--fcntl replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--filecmp] +[o:python-doc:p:python-314:r:library--filecmp] file_filter = library/filecmp.po source_file = gettext/library/filecmp.pot type = PO @@ -2323,7 +2395,7 @@ resource_name = library--filecmp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fileformats] +[o:python-doc:p:python-314:r:library--fileformats] file_filter = library/fileformats.po source_file = gettext/library/fileformats.pot type = PO @@ -2332,7 +2404,7 @@ resource_name = library--fileformats replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fileinput] +[o:python-doc:p:python-314:r:library--fileinput] file_filter = library/fileinput.po source_file = gettext/library/fileinput.pot type = PO @@ -2341,7 +2413,7 @@ resource_name = library--fileinput replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--filesys] +[o:python-doc:p:python-314:r:library--filesys] file_filter = library/filesys.po source_file = gettext/library/filesys.pot type = PO @@ -2350,7 +2422,7 @@ resource_name = library--filesys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fnmatch] +[o:python-doc:p:python-314:r:library--fnmatch] file_filter = library/fnmatch.po source_file = gettext/library/fnmatch.pot type = PO @@ -2359,7 +2431,7 @@ resource_name = library--fnmatch replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fractions] +[o:python-doc:p:python-314:r:library--fractions] file_filter = library/fractions.po source_file = gettext/library/fractions.pot type = PO @@ -2368,7 +2440,7 @@ resource_name = library--fractions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--frameworks] +[o:python-doc:p:python-314:r:library--frameworks] file_filter = library/frameworks.po source_file = gettext/library/frameworks.pot type = PO @@ -2377,7 +2449,7 @@ resource_name = library--frameworks replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ftplib] +[o:python-doc:p:python-314:r:library--ftplib] file_filter = library/ftplib.po source_file = gettext/library/ftplib.pot type = PO @@ -2386,7 +2458,7 @@ resource_name = library--ftplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--functional] +[o:python-doc:p:python-314:r:library--functional] file_filter = library/functional.po source_file = gettext/library/functional.pot type = PO @@ -2395,16 +2467,7 @@ resource_name = library--functional replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--functions] -file_filter = library/functions.po -source_file = gettext/library/functions.pot -type = PO -minimum_perc = 0 -resource_name = library--functions -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--functools] +[o:python-doc:p:python-314:r:library--functools] file_filter = library/functools.po source_file = gettext/library/functools.pot type = PO @@ -2413,7 +2476,7 @@ resource_name = library--functools replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--gc] +[o:python-doc:p:python-314:r:library--gc] file_filter = library/gc.po source_file = gettext/library/gc.pot type = PO @@ -2422,7 +2485,7 @@ resource_name = library--gc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--getopt] +[o:python-doc:p:python-314:r:library--getopt] file_filter = library/getopt.po source_file = gettext/library/getopt.pot type = PO @@ -2431,7 +2494,7 @@ resource_name = library--getopt replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--getpass] +[o:python-doc:p:python-314:r:library--getpass] file_filter = library/getpass.po source_file = gettext/library/getpass.pot type = PO @@ -2440,7 +2503,7 @@ resource_name = library--getpass replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--gettext] +[o:python-doc:p:python-314:r:library--gettext] file_filter = library/gettext.po source_file = gettext/library/gettext.pot type = PO @@ -2449,7 +2512,7 @@ resource_name = library--gettext replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--glob] +[o:python-doc:p:python-314:r:library--glob] file_filter = library/glob.po source_file = gettext/library/glob.pot type = PO @@ -2458,7 +2521,7 @@ resource_name = library--glob replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--graphlib] +[o:python-doc:p:python-314:r:library--graphlib] file_filter = library/graphlib.po source_file = gettext/library/graphlib.pot type = PO @@ -2467,7 +2530,7 @@ resource_name = library--graphlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--grp] +[o:python-doc:p:python-314:r:library--grp] file_filter = library/grp.po source_file = gettext/library/grp.pot type = PO @@ -2476,7 +2539,7 @@ resource_name = library--grp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--gzip] +[o:python-doc:p:python-314:r:library--gzip] file_filter = library/gzip.po source_file = gettext/library/gzip.pot type = PO @@ -2485,7 +2548,7 @@ resource_name = library--gzip replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--hashlib] +[o:python-doc:p:python-314:r:library--hashlib] file_filter = library/hashlib.po source_file = gettext/library/hashlib.pot type = PO @@ -2494,7 +2557,7 @@ resource_name = library--hashlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--heapq] +[o:python-doc:p:python-314:r:library--heapq] file_filter = library/heapq.po source_file = gettext/library/heapq.pot type = PO @@ -2503,7 +2566,7 @@ resource_name = library--heapq replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--hmac] +[o:python-doc:p:python-314:r:library--hmac] file_filter = library/hmac.po source_file = gettext/library/hmac.pot type = PO @@ -2512,7 +2575,7 @@ resource_name = library--hmac replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--html] +[o:python-doc:p:python-314:r:library--html] file_filter = library/html.po source_file = gettext/library/html.pot type = PO @@ -2521,7 +2584,7 @@ resource_name = library--html replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--html_entities] +[o:python-doc:p:python-314:r:library--html_entities] file_filter = library/html.entities.po source_file = gettext/library/html.entities.pot type = PO @@ -2530,7 +2593,7 @@ resource_name = library--html_entities replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--html_parser] +[o:python-doc:p:python-314:r:library--html_parser] file_filter = library/html.parser.po source_file = gettext/library/html.parser.pot type = PO @@ -2539,7 +2602,7 @@ resource_name = library--html_parser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http] +[o:python-doc:p:python-314:r:library--http] file_filter = library/http.po source_file = gettext/library/http.pot type = PO @@ -2548,7 +2611,7 @@ resource_name = library--http replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_client] +[o:python-doc:p:python-314:r:library--http_client] file_filter = library/http.client.po source_file = gettext/library/http.client.pot type = PO @@ -2557,7 +2620,7 @@ resource_name = library--http_client replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_cookiejar] +[o:python-doc:p:python-314:r:library--http_cookiejar] file_filter = library/http.cookiejar.po source_file = gettext/library/http.cookiejar.pot type = PO @@ -2566,7 +2629,7 @@ resource_name = library--http_cookiejar replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_cookies] +[o:python-doc:p:python-314:r:library--http_cookies] file_filter = library/http.cookies.po source_file = gettext/library/http.cookies.pot type = PO @@ -2575,7 +2638,7 @@ resource_name = library--http_cookies replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_server] +[o:python-doc:p:python-314:r:library--http_server] file_filter = library/http.server.po source_file = gettext/library/http.server.pot type = PO @@ -2584,7 +2647,7 @@ resource_name = library--http_server replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--i18n] +[o:python-doc:p:python-314:r:library--i18n] file_filter = library/i18n.po source_file = gettext/library/i18n.pot type = PO @@ -2593,7 +2656,7 @@ resource_name = library--i18n replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--idle] +[o:python-doc:p:python-314:r:library--idle] file_filter = library/idle.po source_file = gettext/library/idle.pot type = PO @@ -2602,7 +2665,7 @@ resource_name = library--idle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--imaplib] +[o:python-doc:p:python-314:r:library--imaplib] file_filter = library/imaplib.po source_file = gettext/library/imaplib.pot type = PO @@ -2611,7 +2674,7 @@ resource_name = library--imaplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--imghdr] +[o:python-doc:p:python-314:r:library--imghdr] file_filter = library/imghdr.po source_file = gettext/library/imghdr.pot type = PO @@ -2620,7 +2683,7 @@ resource_name = library--imghdr replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--imp] +[o:python-doc:p:python-314:r:library--imp] file_filter = library/imp.po source_file = gettext/library/imp.pot type = PO @@ -2629,7 +2692,7 @@ resource_name = library--imp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib] +[o:python-doc:p:python-314:r:library--importlib] file_filter = library/importlib.po source_file = gettext/library/importlib.pot type = PO @@ -2638,7 +2701,7 @@ resource_name = library--importlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib_metadata] +[o:python-doc:p:python-314:r:library--importlib_metadata] file_filter = library/importlib.metadata.po source_file = gettext/library/importlib.metadata.pot type = PO @@ -2647,7 +2710,7 @@ resource_name = library--importlib_metadata replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib_resources] +[o:python-doc:p:python-314:r:library--importlib_resources] file_filter = library/importlib.resources.po source_file = gettext/library/importlib.resources.pot type = PO @@ -2656,7 +2719,7 @@ resource_name = library--importlib_resources replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib_resources_abc] +[o:python-doc:p:python-314:r:library--importlib_resources_abc] file_filter = library/importlib.resources.abc.po source_file = gettext/library/importlib.resources.abc.pot type = PO @@ -2665,7 +2728,7 @@ resource_name = library--importlib_resources_abc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--index] +[o:python-doc:p:python-314:r:library--index] file_filter = library/index.po source_file = gettext/library/index.pot type = PO @@ -2674,7 +2737,7 @@ resource_name = library--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--inspect] +[o:python-doc:p:python-314:r:library--inspect] file_filter = library/inspect.po source_file = gettext/library/inspect.pot type = PO @@ -2683,7 +2746,7 @@ resource_name = library--inspect replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--internet] +[o:python-doc:p:python-314:r:library--internet] file_filter = library/internet.po source_file = gettext/library/internet.pot type = PO @@ -2692,7 +2755,7 @@ resource_name = library--internet replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--intro] +[o:python-doc:p:python-314:r:library--intro] file_filter = library/intro.po source_file = gettext/library/intro.pot type = PO @@ -2701,7 +2764,7 @@ resource_name = library--intro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--io] +[o:python-doc:p:python-314:r:library--io] file_filter = library/io.po source_file = gettext/library/io.pot type = PO @@ -2710,7 +2773,7 @@ resource_name = library--io replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ipaddress] +[o:python-doc:p:python-314:r:library--ipaddress] file_filter = library/ipaddress.po source_file = gettext/library/ipaddress.pot type = PO @@ -2719,7 +2782,7 @@ resource_name = library--ipaddress replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ipc] +[o:python-doc:p:python-314:r:library--ipc] file_filter = library/ipc.po source_file = gettext/library/ipc.pot type = PO @@ -2728,7 +2791,7 @@ resource_name = library--ipc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--itertools] +[o:python-doc:p:python-314:r:library--itertools] file_filter = library/itertools.po source_file = gettext/library/itertools.pot type = PO @@ -2737,7 +2800,7 @@ resource_name = library--itertools replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--json] +[o:python-doc:p:python-314:r:library--json] file_filter = library/json.po source_file = gettext/library/json.pot type = PO @@ -2746,7 +2809,7 @@ resource_name = library--json replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--keyword] +[o:python-doc:p:python-314:r:library--keyword] file_filter = library/keyword.po source_file = gettext/library/keyword.pot type = PO @@ -2755,7 +2818,7 @@ resource_name = library--keyword replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--language] +[o:python-doc:p:python-314:r:library--language] file_filter = library/language.po source_file = gettext/library/language.pot type = PO @@ -2764,7 +2827,7 @@ resource_name = library--language replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--linecache] +[o:python-doc:p:python-314:r:library--linecache] file_filter = library/linecache.po source_file = gettext/library/linecache.pot type = PO @@ -2773,7 +2836,7 @@ resource_name = library--linecache replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--locale] +[o:python-doc:p:python-314:r:library--locale] file_filter = library/locale.po source_file = gettext/library/locale.pot type = PO @@ -2782,7 +2845,7 @@ resource_name = library--locale replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--logging] +[o:python-doc:p:python-314:r:library--logging] file_filter = library/logging.po source_file = gettext/library/logging.pot type = PO @@ -2791,7 +2854,7 @@ resource_name = library--logging replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--logging_config] +[o:python-doc:p:python-314:r:library--logging_config] file_filter = library/logging.config.po source_file = gettext/library/logging.config.pot type = PO @@ -2800,7 +2863,7 @@ resource_name = library--logging_config replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--logging_handlers] +[o:python-doc:p:python-314:r:library--logging_handlers] file_filter = library/logging.handlers.po source_file = gettext/library/logging.handlers.pot type = PO @@ -2809,7 +2872,7 @@ resource_name = library--logging_handlers replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--lzma] +[o:python-doc:p:python-314:r:library--lzma] file_filter = library/lzma.po source_file = gettext/library/lzma.pot type = PO @@ -2818,7 +2881,7 @@ resource_name = library--lzma replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mailbox] +[o:python-doc:p:python-314:r:library--mailbox] file_filter = library/mailbox.po source_file = gettext/library/mailbox.pot type = PO @@ -2827,7 +2890,7 @@ resource_name = library--mailbox replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mailcap] +[o:python-doc:p:python-314:r:library--mailcap] file_filter = library/mailcap.po source_file = gettext/library/mailcap.pot type = PO @@ -2836,7 +2899,7 @@ resource_name = library--mailcap replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--markup] +[o:python-doc:p:python-314:r:library--markup] file_filter = library/markup.po source_file = gettext/library/markup.pot type = PO @@ -2845,7 +2908,7 @@ resource_name = library--markup replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--marshal] +[o:python-doc:p:python-314:r:library--marshal] file_filter = library/marshal.po source_file = gettext/library/marshal.pot type = PO @@ -2854,7 +2917,7 @@ resource_name = library--marshal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--math] +[o:python-doc:p:python-314:r:library--math] file_filter = library/math.po source_file = gettext/library/math.pot type = PO @@ -2863,7 +2926,7 @@ resource_name = library--math replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mimetypes] +[o:python-doc:p:python-314:r:library--mimetypes] file_filter = library/mimetypes.po source_file = gettext/library/mimetypes.pot type = PO @@ -2872,7 +2935,7 @@ resource_name = library--mimetypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mm] +[o:python-doc:p:python-314:r:library--mm] file_filter = library/mm.po source_file = gettext/library/mm.pot type = PO @@ -2881,7 +2944,7 @@ resource_name = library--mm replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mmap] +[o:python-doc:p:python-314:r:library--mmap] file_filter = library/mmap.po source_file = gettext/library/mmap.pot type = PO @@ -2890,7 +2953,7 @@ resource_name = library--mmap replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--modulefinder] +[o:python-doc:p:python-314:r:library--modulefinder] file_filter = library/modulefinder.po source_file = gettext/library/modulefinder.pot type = PO @@ -2899,7 +2962,7 @@ resource_name = library--modulefinder replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--modules] +[o:python-doc:p:python-314:r:library--modules] file_filter = library/modules.po source_file = gettext/library/modules.pot type = PO @@ -2908,7 +2971,7 @@ resource_name = library--modules replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--msilib] +[o:python-doc:p:python-314:r:library--msilib] file_filter = library/msilib.po source_file = gettext/library/msilib.pot type = PO @@ -2917,7 +2980,7 @@ resource_name = library--msilib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--msvcrt] +[o:python-doc:p:python-314:r:library--msvcrt] file_filter = library/msvcrt.po source_file = gettext/library/msvcrt.pot type = PO @@ -2926,7 +2989,7 @@ resource_name = library--msvcrt replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--multiprocessing] +[o:python-doc:p:python-314:r:library--multiprocessing] file_filter = library/multiprocessing.po source_file = gettext/library/multiprocessing.pot type = PO @@ -2935,7 +2998,7 @@ resource_name = library--multiprocessing replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--multiprocessing_shared_memory] +[o:python-doc:p:python-314:r:library--multiprocessing_shared_memory] file_filter = library/multiprocessing.shared_memory.po source_file = gettext/library/multiprocessing.shared_memory.pot type = PO @@ -2944,7 +3007,7 @@ resource_name = library--multiprocessing_shared_memory replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--netdata] +[o:python-doc:p:python-314:r:library--netdata] file_filter = library/netdata.po source_file = gettext/library/netdata.pot type = PO @@ -2953,7 +3016,7 @@ resource_name = library--netdata replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--netrc] +[o:python-doc:p:python-314:r:library--netrc] file_filter = library/netrc.po source_file = gettext/library/netrc.pot type = PO @@ -2962,7 +3025,7 @@ resource_name = library--netrc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--nis] +[o:python-doc:p:python-314:r:library--nis] file_filter = library/nis.po source_file = gettext/library/nis.pot type = PO @@ -2971,7 +3034,7 @@ resource_name = library--nis replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--nntplib] +[o:python-doc:p:python-314:r:library--nntplib] file_filter = library/nntplib.po source_file = gettext/library/nntplib.pot type = PO @@ -2980,7 +3043,7 @@ resource_name = library--nntplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--numbers] +[o:python-doc:p:python-314:r:library--numbers] file_filter = library/numbers.po source_file = gettext/library/numbers.pot type = PO @@ -2989,7 +3052,7 @@ resource_name = library--numbers replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--numeric] +[o:python-doc:p:python-314:r:library--numeric] file_filter = library/numeric.po source_file = gettext/library/numeric.pot type = PO @@ -2998,7 +3061,7 @@ resource_name = library--numeric replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--operator] +[o:python-doc:p:python-314:r:library--operator] file_filter = library/operator.po source_file = gettext/library/operator.pot type = PO @@ -3007,7 +3070,7 @@ resource_name = library--operator replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--optparse] +[o:python-doc:p:python-314:r:library--optparse] file_filter = library/optparse.po source_file = gettext/library/optparse.pot type = PO @@ -3016,7 +3079,7 @@ resource_name = library--optparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--os] +[o:python-doc:p:python-314:r:library--os] file_filter = library/os.po source_file = gettext/library/os.pot type = PO @@ -3025,7 +3088,7 @@ resource_name = library--os replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--os_path] +[o:python-doc:p:python-314:r:library--os_path] file_filter = library/os.path.po source_file = gettext/library/os.path.pot type = PO @@ -3034,7 +3097,7 @@ resource_name = library--os_path replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ossaudiodev] +[o:python-doc:p:python-314:r:library--ossaudiodev] file_filter = library/ossaudiodev.po source_file = gettext/library/ossaudiodev.pot type = PO @@ -3043,7 +3106,7 @@ resource_name = library--ossaudiodev replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pathlib] +[o:python-doc:p:python-314:r:library--pathlib] file_filter = library/pathlib.po source_file = gettext/library/pathlib.pot type = PO @@ -3052,7 +3115,7 @@ resource_name = library--pathlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pdb] +[o:python-doc:p:python-314:r:library--pdb] file_filter = library/pdb.po source_file = gettext/library/pdb.pot type = PO @@ -3061,7 +3124,7 @@ resource_name = library--pdb replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--persistence] +[o:python-doc:p:python-314:r:library--persistence] file_filter = library/persistence.po source_file = gettext/library/persistence.pot type = PO @@ -3070,7 +3133,7 @@ resource_name = library--persistence replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pickle] +[o:python-doc:p:python-314:r:library--pickle] file_filter = library/pickle.po source_file = gettext/library/pickle.pot type = PO @@ -3079,7 +3142,7 @@ resource_name = library--pickle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pickletools] +[o:python-doc:p:python-314:r:library--pickletools] file_filter = library/pickletools.po source_file = gettext/library/pickletools.pot type = PO @@ -3088,7 +3151,7 @@ resource_name = library--pickletools replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pipes] +[o:python-doc:p:python-314:r:library--pipes] file_filter = library/pipes.po source_file = gettext/library/pipes.pot type = PO @@ -3097,7 +3160,7 @@ resource_name = library--pipes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pkgutil] +[o:python-doc:p:python-314:r:library--pkgutil] file_filter = library/pkgutil.po source_file = gettext/library/pkgutil.pot type = PO @@ -3106,7 +3169,7 @@ resource_name = library--pkgutil replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--platform] +[o:python-doc:p:python-314:r:library--platform] file_filter = library/platform.po source_file = gettext/library/platform.pot type = PO @@ -3115,7 +3178,7 @@ resource_name = library--platform replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--plistlib] +[o:python-doc:p:python-314:r:library--plistlib] file_filter = library/plistlib.po source_file = gettext/library/plistlib.pot type = PO @@ -3124,7 +3187,7 @@ resource_name = library--plistlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--poplib] +[o:python-doc:p:python-314:r:library--poplib] file_filter = library/poplib.po source_file = gettext/library/poplib.pot type = PO @@ -3133,7 +3196,7 @@ resource_name = library--poplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--posix] +[o:python-doc:p:python-314:r:library--posix] file_filter = library/posix.po source_file = gettext/library/posix.pot type = PO @@ -3142,7 +3205,7 @@ resource_name = library--posix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pprint] +[o:python-doc:p:python-314:r:library--pprint] file_filter = library/pprint.po source_file = gettext/library/pprint.pot type = PO @@ -3151,7 +3214,7 @@ resource_name = library--pprint replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--profile] +[o:python-doc:p:python-314:r:library--profile] file_filter = library/profile.po source_file = gettext/library/profile.pot type = PO @@ -3160,7 +3223,7 @@ resource_name = library--profile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pty] +[o:python-doc:p:python-314:r:library--pty] file_filter = library/pty.po source_file = gettext/library/pty.pot type = PO @@ -3169,7 +3232,7 @@ resource_name = library--pty replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pwd] +[o:python-doc:p:python-314:r:library--pwd] file_filter = library/pwd.po source_file = gettext/library/pwd.pot type = PO @@ -3178,7 +3241,7 @@ resource_name = library--pwd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--py_compile] +[o:python-doc:p:python-314:r:library--py_compile] file_filter = library/py_compile.po source_file = gettext/library/py_compile.pot type = PO @@ -3187,7 +3250,7 @@ resource_name = library--py_compile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pyclbr] +[o:python-doc:p:python-314:r:library--pyclbr] file_filter = library/pyclbr.po source_file = gettext/library/pyclbr.pot type = PO @@ -3196,7 +3259,7 @@ resource_name = library--pyclbr replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pydoc] +[o:python-doc:p:python-314:r:library--pydoc] file_filter = library/pydoc.po source_file = gettext/library/pydoc.pot type = PO @@ -3205,7 +3268,7 @@ resource_name = library--pydoc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pyexpat] +[o:python-doc:p:python-314:r:library--pyexpat] file_filter = library/pyexpat.po source_file = gettext/library/pyexpat.pot type = PO @@ -3214,7 +3277,7 @@ resource_name = library--pyexpat replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--python] +[o:python-doc:p:python-314:r:library--python] file_filter = library/python.po source_file = gettext/library/python.pot type = PO @@ -3223,7 +3286,7 @@ resource_name = library--python replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--queue] +[o:python-doc:p:python-314:r:library--queue] file_filter = library/queue.po source_file = gettext/library/queue.pot type = PO @@ -3232,7 +3295,7 @@ resource_name = library--queue replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--quopri] +[o:python-doc:p:python-314:r:library--quopri] file_filter = library/quopri.po source_file = gettext/library/quopri.pot type = PO @@ -3241,7 +3304,7 @@ resource_name = library--quopri replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--random] +[o:python-doc:p:python-314:r:library--random] file_filter = library/random.po source_file = gettext/library/random.pot type = PO @@ -3250,7 +3313,7 @@ resource_name = library--random replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--re] +[o:python-doc:p:python-314:r:library--re] file_filter = library/re.po source_file = gettext/library/re.pot type = PO @@ -3259,7 +3322,7 @@ resource_name = library--re replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--readline] +[o:python-doc:p:python-314:r:library--readline] file_filter = library/readline.po source_file = gettext/library/readline.pot type = PO @@ -3268,7 +3331,7 @@ resource_name = library--readline replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--removed] +[o:python-doc:p:python-314:r:library--removed] file_filter = library/removed.po source_file = gettext/library/removed.pot type = PO @@ -3277,7 +3340,7 @@ resource_name = library--removed replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--reprlib] +[o:python-doc:p:python-314:r:library--reprlib] file_filter = library/reprlib.po source_file = gettext/library/reprlib.pot type = PO @@ -3286,7 +3349,7 @@ resource_name = library--reprlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--resource] +[o:python-doc:p:python-314:r:library--resource] file_filter = library/resource.po source_file = gettext/library/resource.pot type = PO @@ -3295,7 +3358,7 @@ resource_name = library--resource replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--rlcompleter] +[o:python-doc:p:python-314:r:library--rlcompleter] file_filter = library/rlcompleter.po source_file = gettext/library/rlcompleter.pot type = PO @@ -3304,7 +3367,7 @@ resource_name = library--rlcompleter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--runpy] +[o:python-doc:p:python-314:r:library--runpy] file_filter = library/runpy.po source_file = gettext/library/runpy.pot type = PO @@ -3313,7 +3376,7 @@ resource_name = library--runpy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sched] +[o:python-doc:p:python-314:r:library--sched] file_filter = library/sched.po source_file = gettext/library/sched.pot type = PO @@ -3322,7 +3385,7 @@ resource_name = library--sched replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--secrets] +[o:python-doc:p:python-314:r:library--secrets] file_filter = library/secrets.po source_file = gettext/library/secrets.pot type = PO @@ -3331,7 +3394,7 @@ resource_name = library--secrets replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--security_warnings] +[o:python-doc:p:python-314:r:library--security_warnings] file_filter = library/security_warnings.po source_file = gettext/library/security_warnings.pot type = PO @@ -3340,7 +3403,7 @@ resource_name = library--security_warnings replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--select] +[o:python-doc:p:python-314:r:library--select] file_filter = library/select.po source_file = gettext/library/select.pot type = PO @@ -3349,7 +3412,7 @@ resource_name = library--select replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--selectors] +[o:python-doc:p:python-314:r:library--selectors] file_filter = library/selectors.po source_file = gettext/library/selectors.pot type = PO @@ -3358,7 +3421,7 @@ resource_name = library--selectors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--shelve] +[o:python-doc:p:python-314:r:library--shelve] file_filter = library/shelve.po source_file = gettext/library/shelve.pot type = PO @@ -3367,7 +3430,7 @@ resource_name = library--shelve replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--shlex] +[o:python-doc:p:python-314:r:library--shlex] file_filter = library/shlex.po source_file = gettext/library/shlex.pot type = PO @@ -3376,7 +3439,7 @@ resource_name = library--shlex replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--shutil] +[o:python-doc:p:python-314:r:library--shutil] file_filter = library/shutil.po source_file = gettext/library/shutil.pot type = PO @@ -3385,7 +3448,7 @@ resource_name = library--shutil replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--signal] +[o:python-doc:p:python-314:r:library--signal] file_filter = library/signal.po source_file = gettext/library/signal.pot type = PO @@ -3394,7 +3457,7 @@ resource_name = library--signal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--site] +[o:python-doc:p:python-314:r:library--site] file_filter = library/site.po source_file = gettext/library/site.pot type = PO @@ -3403,7 +3466,7 @@ resource_name = library--site replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--smtpd] +[o:python-doc:p:python-314:r:library--smtpd] file_filter = library/smtpd.po source_file = gettext/library/smtpd.pot type = PO @@ -3412,7 +3475,7 @@ resource_name = library--smtpd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--smtplib] +[o:python-doc:p:python-314:r:library--smtplib] file_filter = library/smtplib.po source_file = gettext/library/smtplib.pot type = PO @@ -3421,7 +3484,7 @@ resource_name = library--smtplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sndhdr] +[o:python-doc:p:python-314:r:library--sndhdr] file_filter = library/sndhdr.po source_file = gettext/library/sndhdr.pot type = PO @@ -3430,7 +3493,7 @@ resource_name = library--sndhdr replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--socket] +[o:python-doc:p:python-314:r:library--socket] file_filter = library/socket.po source_file = gettext/library/socket.pot type = PO @@ -3439,7 +3502,7 @@ resource_name = library--socket replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--socketserver] +[o:python-doc:p:python-314:r:library--socketserver] file_filter = library/socketserver.po source_file = gettext/library/socketserver.pot type = PO @@ -3448,7 +3511,7 @@ resource_name = library--socketserver replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--spwd] +[o:python-doc:p:python-314:r:library--spwd] file_filter = library/spwd.po source_file = gettext/library/spwd.pot type = PO @@ -3457,7 +3520,7 @@ resource_name = library--spwd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sqlite3] +[o:python-doc:p:python-314:r:library--sqlite3] file_filter = library/sqlite3.po source_file = gettext/library/sqlite3.pot type = PO @@ -3466,7 +3529,7 @@ resource_name = library--sqlite3 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ssl] +[o:python-doc:p:python-314:r:library--ssl] file_filter = library/ssl.po source_file = gettext/library/ssl.pot type = PO @@ -3475,7 +3538,7 @@ resource_name = library--ssl replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stat] +[o:python-doc:p:python-314:r:library--stat] file_filter = library/stat.po source_file = gettext/library/stat.pot type = PO @@ -3484,7 +3547,7 @@ resource_name = library--stat replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--statistics] +[o:python-doc:p:python-314:r:library--statistics] file_filter = library/statistics.po source_file = gettext/library/statistics.pot type = PO @@ -3493,16 +3556,7 @@ resource_name = library--statistics replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stdtypes] -file_filter = library/stdtypes.po -source_file = gettext/library/stdtypes.pot -type = PO -minimum_perc = 0 -resource_name = library--stdtypes -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--string] +[o:python-doc:p:python-314:r:library--string] file_filter = library/string.po source_file = gettext/library/string.pot type = PO @@ -3511,7 +3565,7 @@ resource_name = library--string replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--string_templatelib] +[o:python-doc:p:python-314:r:library--string_templatelib] file_filter = library/string.templatelib.po source_file = gettext/library/string.templatelib.pot type = PO @@ -3520,7 +3574,7 @@ resource_name = library--string_templatelib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stringprep] +[o:python-doc:p:python-314:r:library--stringprep] file_filter = library/stringprep.po source_file = gettext/library/stringprep.pot type = PO @@ -3529,7 +3583,7 @@ resource_name = library--stringprep replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--struct] +[o:python-doc:p:python-314:r:library--struct] file_filter = library/struct.po source_file = gettext/library/struct.pot type = PO @@ -3538,7 +3592,7 @@ resource_name = library--struct replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--subprocess] +[o:python-doc:p:python-314:r:library--subprocess] file_filter = library/subprocess.po source_file = gettext/library/subprocess.pot type = PO @@ -3547,7 +3601,7 @@ resource_name = library--subprocess replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sunau] +[o:python-doc:p:python-314:r:library--sunau] file_filter = library/sunau.po source_file = gettext/library/sunau.pot type = PO @@ -3556,7 +3610,7 @@ resource_name = library--sunau replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--superseded] +[o:python-doc:p:python-314:r:library--superseded] file_filter = library/superseded.po source_file = gettext/library/superseded.pot type = PO @@ -3565,7 +3619,7 @@ resource_name = library--superseded replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--symtable] +[o:python-doc:p:python-314:r:library--symtable] file_filter = library/symtable.po source_file = gettext/library/symtable.pot type = PO @@ -3574,7 +3628,7 @@ resource_name = library--symtable replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sys] +[o:python-doc:p:python-314:r:library--sys] file_filter = library/sys.po source_file = gettext/library/sys.pot type = PO @@ -3583,7 +3637,7 @@ resource_name = library--sys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sys_monitoring] +[o:python-doc:p:python-314:r:library--sys_monitoring] file_filter = library/sys.monitoring.po source_file = gettext/library/sys.monitoring.pot type = PO @@ -3592,7 +3646,7 @@ resource_name = library--sys_monitoring replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sys_path_init] +[o:python-doc:p:python-314:r:library--sys_path_init] file_filter = library/sys_path_init.po source_file = gettext/library/sys_path_init.pot type = PO @@ -3601,7 +3655,7 @@ resource_name = library--sys_path_init replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sysconfig] +[o:python-doc:p:python-314:r:library--sysconfig] file_filter = library/sysconfig.po source_file = gettext/library/sysconfig.pot type = PO @@ -3610,7 +3664,7 @@ resource_name = library--sysconfig replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--syslog] +[o:python-doc:p:python-314:r:library--syslog] file_filter = library/syslog.po source_file = gettext/library/syslog.pot type = PO @@ -3619,7 +3673,7 @@ resource_name = library--syslog replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tabnanny] +[o:python-doc:p:python-314:r:library--tabnanny] file_filter = library/tabnanny.po source_file = gettext/library/tabnanny.pot type = PO @@ -3628,7 +3682,7 @@ resource_name = library--tabnanny replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tarfile] +[o:python-doc:p:python-314:r:library--tarfile] file_filter = library/tarfile.po source_file = gettext/library/tarfile.pot type = PO @@ -3637,7 +3691,7 @@ resource_name = library--tarfile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--telnetlib] +[o:python-doc:p:python-314:r:library--telnetlib] file_filter = library/telnetlib.po source_file = gettext/library/telnetlib.pot type = PO @@ -3646,7 +3700,7 @@ resource_name = library--telnetlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tempfile] +[o:python-doc:p:python-314:r:library--tempfile] file_filter = library/tempfile.po source_file = gettext/library/tempfile.pot type = PO @@ -3655,7 +3709,7 @@ resource_name = library--tempfile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--termios] +[o:python-doc:p:python-314:r:library--termios] file_filter = library/termios.po source_file = gettext/library/termios.pot type = PO @@ -3664,7 +3718,7 @@ resource_name = library--termios replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--test] +[o:python-doc:p:python-314:r:library--test] file_filter = library/test.po source_file = gettext/library/test.pot type = PO @@ -3673,7 +3727,7 @@ resource_name = library--test replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--text] +[o:python-doc:p:python-314:r:library--text] file_filter = library/text.po source_file = gettext/library/text.pot type = PO @@ -3682,7 +3736,7 @@ resource_name = library--text replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--textwrap] +[o:python-doc:p:python-314:r:library--textwrap] file_filter = library/textwrap.po source_file = gettext/library/textwrap.pot type = PO @@ -3691,7 +3745,7 @@ resource_name = library--textwrap replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--threading] +[o:python-doc:p:python-314:r:library--threading] file_filter = library/threading.po source_file = gettext/library/threading.pot type = PO @@ -3700,16 +3754,7 @@ resource_name = library--threading replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--threadsafety] -file_filter = library/threadsafety.po -source_file = gettext/library/threadsafety.pot -type = PO -minimum_perc = 0 -resource_name = library--threadsafety -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--time] +[o:python-doc:p:python-314:r:library--time] file_filter = library/time.po source_file = gettext/library/time.pot type = PO @@ -3718,7 +3763,7 @@ resource_name = library--time replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--timeit] +[o:python-doc:p:python-314:r:library--timeit] file_filter = library/timeit.po source_file = gettext/library/timeit.pot type = PO @@ -3727,7 +3772,7 @@ resource_name = library--timeit replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tk] +[o:python-doc:p:python-314:r:library--tk] file_filter = library/tk.po source_file = gettext/library/tk.pot type = PO @@ -3736,7 +3781,7 @@ resource_name = library--tk replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter] +[o:python-doc:p:python-314:r:library--tkinter] file_filter = library/tkinter.po source_file = gettext/library/tkinter.pot type = PO @@ -3745,7 +3790,7 @@ resource_name = library--tkinter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_colorchooser] +[o:python-doc:p:python-314:r:library--tkinter_colorchooser] file_filter = library/tkinter.colorchooser.po source_file = gettext/library/tkinter.colorchooser.pot type = PO @@ -3754,7 +3799,7 @@ resource_name = library--tkinter_colorchooser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_dnd] +[o:python-doc:p:python-314:r:library--tkinter_dnd] file_filter = library/tkinter.dnd.po source_file = gettext/library/tkinter.dnd.pot type = PO @@ -3763,7 +3808,7 @@ resource_name = library--tkinter_dnd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_font] +[o:python-doc:p:python-314:r:library--tkinter_font] file_filter = library/tkinter.font.po source_file = gettext/library/tkinter.font.pot type = PO @@ -3772,7 +3817,7 @@ resource_name = library--tkinter_font replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_messagebox] +[o:python-doc:p:python-314:r:library--tkinter_messagebox] file_filter = library/tkinter.messagebox.po source_file = gettext/library/tkinter.messagebox.pot type = PO @@ -3781,7 +3826,7 @@ resource_name = library--tkinter_messagebox replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_scrolledtext] +[o:python-doc:p:python-314:r:library--tkinter_scrolledtext] file_filter = library/tkinter.scrolledtext.po source_file = gettext/library/tkinter.scrolledtext.pot type = PO @@ -3790,7 +3835,7 @@ resource_name = library--tkinter_scrolledtext replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_ttk] +[o:python-doc:p:python-314:r:library--tkinter_ttk] file_filter = library/tkinter.ttk.po source_file = gettext/library/tkinter.ttk.pot type = PO @@ -3799,7 +3844,7 @@ resource_name = library--tkinter_ttk replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--token] +[o:python-doc:p:python-314:r:library--token] file_filter = library/token.po source_file = gettext/library/token.pot type = PO @@ -3808,7 +3853,7 @@ resource_name = library--token replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tokenize] +[o:python-doc:p:python-314:r:library--tokenize] file_filter = library/tokenize.po source_file = gettext/library/tokenize.pot type = PO @@ -3817,7 +3862,7 @@ resource_name = library--tokenize replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tomllib] +[o:python-doc:p:python-314:r:library--tomllib] file_filter = library/tomllib.po source_file = gettext/library/tomllib.pot type = PO @@ -3826,7 +3871,7 @@ resource_name = library--tomllib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--trace] +[o:python-doc:p:python-314:r:library--trace] file_filter = library/trace.po source_file = gettext/library/trace.pot type = PO @@ -3835,7 +3880,7 @@ resource_name = library--trace replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--traceback] +[o:python-doc:p:python-314:r:library--traceback] file_filter = library/traceback.po source_file = gettext/library/traceback.pot type = PO @@ -3844,7 +3889,7 @@ resource_name = library--traceback replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tracemalloc] +[o:python-doc:p:python-314:r:library--tracemalloc] file_filter = library/tracemalloc.po source_file = gettext/library/tracemalloc.pot type = PO @@ -3853,7 +3898,7 @@ resource_name = library--tracemalloc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tty] +[o:python-doc:p:python-314:r:library--tty] file_filter = library/tty.po source_file = gettext/library/tty.pot type = PO @@ -3862,7 +3907,7 @@ resource_name = library--tty replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--turtle] +[o:python-doc:p:python-314:r:library--turtle] file_filter = library/turtle.po source_file = gettext/library/turtle.pot type = PO @@ -3871,7 +3916,7 @@ resource_name = library--turtle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--types] +[o:python-doc:p:python-314:r:library--types] file_filter = library/types.po source_file = gettext/library/types.pot type = PO @@ -3880,7 +3925,7 @@ resource_name = library--types replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--typing] +[o:python-doc:p:python-314:r:library--typing] file_filter = library/typing.po source_file = gettext/library/typing.pot type = PO @@ -3889,7 +3934,7 @@ resource_name = library--typing replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unicodedata] +[o:python-doc:p:python-314:r:library--unicodedata] file_filter = library/unicodedata.po source_file = gettext/library/unicodedata.pot type = PO @@ -3898,7 +3943,7 @@ resource_name = library--unicodedata replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unittest] +[o:python-doc:p:python-314:r:library--unittest] file_filter = library/unittest.po source_file = gettext/library/unittest.pot type = PO @@ -3907,7 +3952,7 @@ resource_name = library--unittest replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unittest_mock] +[o:python-doc:p:python-314:r:library--unittest_mock] file_filter = library/unittest.mock.po source_file = gettext/library/unittest.mock.pot type = PO @@ -3916,7 +3961,7 @@ resource_name = library--unittest_mock replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unittest_mock-examples] +[o:python-doc:p:python-314:r:library--unittest_mock-examples] file_filter = library/unittest.mock-examples.po source_file = gettext/library/unittest.mock-examples.pot type = PO @@ -3925,7 +3970,7 @@ resource_name = library--unittest_mock-examples replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unix] +[o:python-doc:p:python-314:r:library--unix] file_filter = library/unix.po source_file = gettext/library/unix.pot type = PO @@ -3934,7 +3979,7 @@ resource_name = library--unix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib] +[o:python-doc:p:python-314:r:library--urllib] file_filter = library/urllib.po source_file = gettext/library/urllib.pot type = PO @@ -3943,7 +3988,7 @@ resource_name = library--urllib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_error] +[o:python-doc:p:python-314:r:library--urllib_error] file_filter = library/urllib.error.po source_file = gettext/library/urllib.error.pot type = PO @@ -3952,7 +3997,7 @@ resource_name = library--urllib_error replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_parse] +[o:python-doc:p:python-314:r:library--urllib_parse] file_filter = library/urllib.parse.po source_file = gettext/library/urllib.parse.pot type = PO @@ -3961,7 +4006,7 @@ resource_name = library--urllib_parse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_request] +[o:python-doc:p:python-314:r:library--urllib_request] file_filter = library/urllib.request.po source_file = gettext/library/urllib.request.pot type = PO @@ -3970,7 +4015,7 @@ resource_name = library--urllib_request replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_robotparser] +[o:python-doc:p:python-314:r:library--urllib_robotparser] file_filter = library/urllib.robotparser.po source_file = gettext/library/urllib.robotparser.pot type = PO @@ -3979,7 +4024,7 @@ resource_name = library--urllib_robotparser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--uu] +[o:python-doc:p:python-314:r:library--uu] file_filter = library/uu.po source_file = gettext/library/uu.pot type = PO @@ -3988,7 +4033,7 @@ resource_name = library--uu replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--uuid] +[o:python-doc:p:python-314:r:library--uuid] file_filter = library/uuid.po source_file = gettext/library/uuid.pot type = PO @@ -3997,7 +4042,7 @@ resource_name = library--uuid replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--venv] +[o:python-doc:p:python-314:r:library--venv] file_filter = library/venv.po source_file = gettext/library/venv.pot type = PO @@ -4006,7 +4051,7 @@ resource_name = library--venv replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--warnings] +[o:python-doc:p:python-314:r:library--warnings] file_filter = library/warnings.po source_file = gettext/library/warnings.pot type = PO @@ -4015,7 +4060,7 @@ resource_name = library--warnings replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--wave] +[o:python-doc:p:python-314:r:library--wave] file_filter = library/wave.po source_file = gettext/library/wave.pot type = PO @@ -4024,7 +4069,7 @@ resource_name = library--wave replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--weakref] +[o:python-doc:p:python-314:r:library--weakref] file_filter = library/weakref.po source_file = gettext/library/weakref.pot type = PO @@ -4033,7 +4078,7 @@ resource_name = library--weakref replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--webbrowser] +[o:python-doc:p:python-314:r:library--webbrowser] file_filter = library/webbrowser.po source_file = gettext/library/webbrowser.pot type = PO @@ -4042,7 +4087,7 @@ resource_name = library--webbrowser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--windows] +[o:python-doc:p:python-314:r:library--windows] file_filter = library/windows.po source_file = gettext/library/windows.pot type = PO @@ -4051,7 +4096,7 @@ resource_name = library--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--winreg] +[o:python-doc:p:python-314:r:library--winreg] file_filter = library/winreg.po source_file = gettext/library/winreg.pot type = PO @@ -4060,7 +4105,7 @@ resource_name = library--winreg replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--winsound] +[o:python-doc:p:python-314:r:library--winsound] file_filter = library/winsound.po source_file = gettext/library/winsound.pot type = PO @@ -4069,7 +4114,7 @@ resource_name = library--winsound replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--wsgiref] +[o:python-doc:p:python-314:r:library--wsgiref] file_filter = library/wsgiref.po source_file = gettext/library/wsgiref.pot type = PO @@ -4078,7 +4123,7 @@ resource_name = library--wsgiref replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xdrlib] +[o:python-doc:p:python-314:r:library--xdrlib] file_filter = library/xdrlib.po source_file = gettext/library/xdrlib.pot type = PO @@ -4087,7 +4132,7 @@ resource_name = library--xdrlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml] +[o:python-doc:p:python-314:r:library--xml] file_filter = library/xml.po source_file = gettext/library/xml.pot type = PO @@ -4096,7 +4141,7 @@ resource_name = library--xml replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_dom] +[o:python-doc:p:python-314:r:library--xml_dom] file_filter = library/xml.dom.po source_file = gettext/library/xml.dom.pot type = PO @@ -4105,7 +4150,7 @@ resource_name = library--xml_dom replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_dom_minidom] +[o:python-doc:p:python-314:r:library--xml_dom_minidom] file_filter = library/xml.dom.minidom.po source_file = gettext/library/xml.dom.minidom.pot type = PO @@ -4114,7 +4159,7 @@ resource_name = library--xml_dom_minidom replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_dom_pulldom] +[o:python-doc:p:python-314:r:library--xml_dom_pulldom] file_filter = library/xml.dom.pulldom.po source_file = gettext/library/xml.dom.pulldom.pot type = PO @@ -4123,7 +4168,7 @@ resource_name = library--xml_dom_pulldom replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_etree_elementtree] +[o:python-doc:p:python-314:r:library--xml_etree_elementtree] file_filter = library/xml.etree.elementtree.po source_file = gettext/library/xml.etree.elementtree.pot type = PO @@ -4132,7 +4177,7 @@ resource_name = library--xml_etree_elementtree replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax] +[o:python-doc:p:python-314:r:library--xml_sax] file_filter = library/xml.sax.po source_file = gettext/library/xml.sax.pot type = PO @@ -4141,7 +4186,7 @@ resource_name = library--xml_sax replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax_handler] +[o:python-doc:p:python-314:r:library--xml_sax_handler] file_filter = library/xml.sax.handler.po source_file = gettext/library/xml.sax.handler.pot type = PO @@ -4150,7 +4195,7 @@ resource_name = library--xml_sax_handler replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax_reader] +[o:python-doc:p:python-314:r:library--xml_sax_reader] file_filter = library/xml.sax.reader.po source_file = gettext/library/xml.sax.reader.pot type = PO @@ -4159,7 +4204,7 @@ resource_name = library--xml_sax_reader replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax_utils] +[o:python-doc:p:python-314:r:library--xml_sax_utils] file_filter = library/xml.sax.utils.po source_file = gettext/library/xml.sax.utils.pot type = PO @@ -4168,7 +4213,7 @@ resource_name = library--xml_sax_utils replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xmlrpc] +[o:python-doc:p:python-314:r:library--xmlrpc] file_filter = library/xmlrpc.po source_file = gettext/library/xmlrpc.pot type = PO @@ -4177,7 +4222,7 @@ resource_name = library--xmlrpc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xmlrpc_client] +[o:python-doc:p:python-314:r:library--xmlrpc_client] file_filter = library/xmlrpc.client.po source_file = gettext/library/xmlrpc.client.pot type = PO @@ -4186,7 +4231,7 @@ resource_name = library--xmlrpc_client replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xmlrpc_server] +[o:python-doc:p:python-314:r:library--xmlrpc_server] file_filter = library/xmlrpc.server.po source_file = gettext/library/xmlrpc.server.pot type = PO @@ -4195,7 +4240,7 @@ resource_name = library--xmlrpc_server replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zipapp] +[o:python-doc:p:python-314:r:library--zipapp] file_filter = library/zipapp.po source_file = gettext/library/zipapp.pot type = PO @@ -4204,7 +4249,7 @@ resource_name = library--zipapp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zipfile] +[o:python-doc:p:python-314:r:library--zipfile] file_filter = library/zipfile.po source_file = gettext/library/zipfile.pot type = PO @@ -4213,7 +4258,7 @@ resource_name = library--zipfile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zipimport] +[o:python-doc:p:python-314:r:library--zipimport] file_filter = library/zipimport.po source_file = gettext/library/zipimport.pot type = PO @@ -4222,7 +4267,7 @@ resource_name = library--zipimport replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zlib] +[o:python-doc:p:python-314:r:library--zlib] file_filter = library/zlib.po source_file = gettext/library/zlib.pot type = PO @@ -4231,7 +4276,7 @@ resource_name = library--zlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zoneinfo] +[o:python-doc:p:python-314:r:library--zoneinfo] file_filter = library/zoneinfo.po source_file = gettext/library/zoneinfo.pot type = PO @@ -4240,7 +4285,7 @@ resource_name = library--zoneinfo replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:license] +[o:python-doc:p:python-314:r:license] file_filter = license.po source_file = gettext/license.pot type = PO @@ -4249,7 +4294,7 @@ resource_name = license replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--compound_stmts] +[o:python-doc:p:python-314:r:reference--compound_stmts] file_filter = reference/compound_stmts.po source_file = gettext/reference/compound_stmts.pot type = PO @@ -4258,7 +4303,7 @@ resource_name = reference--compound_stmts replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--datamodel] +[o:python-doc:p:python-314:r:reference--datamodel] file_filter = reference/datamodel.po source_file = gettext/reference/datamodel.pot type = PO @@ -4267,7 +4312,7 @@ resource_name = reference--datamodel replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--executionmodel] +[o:python-doc:p:python-314:r:reference--executionmodel] file_filter = reference/executionmodel.po source_file = gettext/reference/executionmodel.pot type = PO @@ -4276,7 +4321,7 @@ resource_name = reference--executionmodel replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--expressions] +[o:python-doc:p:python-314:r:reference--expressions] file_filter = reference/expressions.po source_file = gettext/reference/expressions.pot type = PO @@ -4285,7 +4330,7 @@ resource_name = reference--expressions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--grammar] +[o:python-doc:p:python-314:r:reference--grammar] file_filter = reference/grammar.po source_file = gettext/reference/grammar.pot type = PO @@ -4294,7 +4339,7 @@ resource_name = reference--grammar replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--import] +[o:python-doc:p:python-314:r:reference--import] file_filter = reference/import.po source_file = gettext/reference/import.pot type = PO @@ -4303,7 +4348,7 @@ resource_name = reference--import replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--index] +[o:python-doc:p:python-314:r:reference--index] file_filter = reference/index.po source_file = gettext/reference/index.pot type = PO @@ -4312,7 +4357,7 @@ resource_name = reference--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--introduction] +[o:python-doc:p:python-314:r:reference--introduction] file_filter = reference/introduction.po source_file = gettext/reference/introduction.pot type = PO @@ -4321,7 +4366,7 @@ resource_name = reference--introduction replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--lexical_analysis] +[o:python-doc:p:python-314:r:reference--lexical_analysis] file_filter = reference/lexical_analysis.po source_file = gettext/reference/lexical_analysis.pot type = PO @@ -4330,7 +4375,7 @@ resource_name = reference--lexical_analysis replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--simple_stmts] +[o:python-doc:p:python-314:r:reference--simple_stmts] file_filter = reference/simple_stmts.po source_file = gettext/reference/simple_stmts.pot type = PO @@ -4339,7 +4384,7 @@ resource_name = reference--simple_stmts replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--toplevel_components] +[o:python-doc:p:python-314:r:reference--toplevel_components] file_filter = reference/toplevel_components.po source_file = gettext/reference/toplevel_components.pot type = PO @@ -4348,7 +4393,7 @@ resource_name = reference--toplevel_components replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:sphinx] +[o:python-doc:p:python-314:r:sphinx] file_filter = sphinx.po source_file = gettext/sphinx.pot type = PO @@ -4357,7 +4402,7 @@ resource_name = sphinx replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--appendix] +[o:python-doc:p:python-314:r:tutorial--appendix] file_filter = tutorial/appendix.po source_file = gettext/tutorial/appendix.pot type = PO @@ -4366,7 +4411,7 @@ resource_name = tutorial--appendix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--appetite] +[o:python-doc:p:python-314:r:tutorial--appetite] file_filter = tutorial/appetite.po source_file = gettext/tutorial/appetite.pot type = PO @@ -4375,7 +4420,7 @@ resource_name = tutorial--appetite replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--classes] +[o:python-doc:p:python-314:r:tutorial--classes] file_filter = tutorial/classes.po source_file = gettext/tutorial/classes.pot type = PO @@ -4384,7 +4429,7 @@ resource_name = tutorial--classes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--controlflow] +[o:python-doc:p:python-314:r:tutorial--controlflow] file_filter = tutorial/controlflow.po source_file = gettext/tutorial/controlflow.pot type = PO @@ -4393,7 +4438,7 @@ resource_name = tutorial--controlflow replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--datastructures] +[o:python-doc:p:python-314:r:tutorial--datastructures] file_filter = tutorial/datastructures.po source_file = gettext/tutorial/datastructures.pot type = PO @@ -4402,7 +4447,7 @@ resource_name = tutorial--datastructures replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--errors] +[o:python-doc:p:python-314:r:tutorial--errors] file_filter = tutorial/errors.po source_file = gettext/tutorial/errors.pot type = PO @@ -4411,7 +4456,7 @@ resource_name = tutorial--errors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--floatingpoint] +[o:python-doc:p:python-314:r:tutorial--floatingpoint] file_filter = tutorial/floatingpoint.po source_file = gettext/tutorial/floatingpoint.pot type = PO @@ -4420,7 +4465,7 @@ resource_name = tutorial--floatingpoint replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--index] +[o:python-doc:p:python-314:r:tutorial--index] file_filter = tutorial/index.po source_file = gettext/tutorial/index.pot type = PO @@ -4429,7 +4474,7 @@ resource_name = tutorial--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--inputoutput] +[o:python-doc:p:python-314:r:tutorial--inputoutput] file_filter = tutorial/inputoutput.po source_file = gettext/tutorial/inputoutput.pot type = PO @@ -4438,7 +4483,7 @@ resource_name = tutorial--inputoutput replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--interactive] +[o:python-doc:p:python-314:r:tutorial--interactive] file_filter = tutorial/interactive.po source_file = gettext/tutorial/interactive.pot type = PO @@ -4447,7 +4492,7 @@ resource_name = tutorial--interactive replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--interpreter] +[o:python-doc:p:python-314:r:tutorial--interpreter] file_filter = tutorial/interpreter.po source_file = gettext/tutorial/interpreter.pot type = PO @@ -4456,7 +4501,7 @@ resource_name = tutorial--interpreter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--introduction] +[o:python-doc:p:python-314:r:tutorial--introduction] file_filter = tutorial/introduction.po source_file = gettext/tutorial/introduction.pot type = PO @@ -4465,7 +4510,7 @@ resource_name = tutorial--introduction replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--modules] +[o:python-doc:p:python-314:r:tutorial--modules] file_filter = tutorial/modules.po source_file = gettext/tutorial/modules.pot type = PO @@ -4474,7 +4519,7 @@ resource_name = tutorial--modules replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--stdlib] +[o:python-doc:p:python-314:r:tutorial--stdlib] file_filter = tutorial/stdlib.po source_file = gettext/tutorial/stdlib.pot type = PO @@ -4483,7 +4528,7 @@ resource_name = tutorial--stdlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--stdlib2] +[o:python-doc:p:python-314:r:tutorial--stdlib2] file_filter = tutorial/stdlib2.po source_file = gettext/tutorial/stdlib2.pot type = PO @@ -4492,7 +4537,7 @@ resource_name = tutorial--stdlib2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--venv] +[o:python-doc:p:python-314:r:tutorial--venv] file_filter = tutorial/venv.po source_file = gettext/tutorial/venv.pot type = PO @@ -4501,7 +4546,7 @@ resource_name = tutorial--venv replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--whatnow] +[o:python-doc:p:python-314:r:tutorial--whatnow] file_filter = tutorial/whatnow.po source_file = gettext/tutorial/whatnow.pot type = PO @@ -4510,7 +4555,7 @@ resource_name = tutorial--whatnow replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--android] +[o:python-doc:p:python-314:r:using--android] file_filter = using/android.po source_file = gettext/using/android.pot type = PO @@ -4519,7 +4564,7 @@ resource_name = using--android replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--cmdline] +[o:python-doc:p:python-314:r:using--cmdline] file_filter = using/cmdline.po source_file = gettext/using/cmdline.pot type = PO @@ -4528,7 +4573,7 @@ resource_name = using--cmdline replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--configure] +[o:python-doc:p:python-314:r:using--configure] file_filter = using/configure.po source_file = gettext/using/configure.pot type = PO @@ -4537,7 +4582,7 @@ resource_name = using--configure replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--editors] +[o:python-doc:p:python-314:r:using--editors] file_filter = using/editors.po source_file = gettext/using/editors.pot type = PO @@ -4546,7 +4591,7 @@ resource_name = using--editors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--index] +[o:python-doc:p:python-314:r:using--index] file_filter = using/index.po source_file = gettext/using/index.pot type = PO @@ -4555,7 +4600,7 @@ resource_name = using--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--ios] +[o:python-doc:p:python-314:r:using--ios] file_filter = using/ios.po source_file = gettext/using/ios.pot type = PO @@ -4564,7 +4609,7 @@ resource_name = using--ios replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--mac] +[o:python-doc:p:python-314:r:using--mac] file_filter = using/mac.po source_file = gettext/using/mac.pot type = PO @@ -4573,7 +4618,7 @@ resource_name = using--mac replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--unix] +[o:python-doc:p:python-314:r:using--unix] file_filter = using/unix.po source_file = gettext/using/unix.pot type = PO @@ -4582,7 +4627,7 @@ resource_name = using--unix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--windows] +[o:python-doc:p:python-314:r:using--windows] file_filter = using/windows.po source_file = gettext/using/windows.pot type = PO @@ -4591,7 +4636,7 @@ resource_name = using--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_0] +[o:python-doc:p:python-314:r:whatsnew--2_0] file_filter = whatsnew/2.0.po source_file = gettext/whatsnew/2.0.pot type = PO @@ -4600,7 +4645,7 @@ resource_name = whatsnew--2_0 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_1] +[o:python-doc:p:python-314:r:whatsnew--2_1] file_filter = whatsnew/2.1.po source_file = gettext/whatsnew/2.1.pot type = PO @@ -4609,7 +4654,7 @@ resource_name = whatsnew--2_1 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_2] +[o:python-doc:p:python-314:r:whatsnew--2_2] file_filter = whatsnew/2.2.po source_file = gettext/whatsnew/2.2.pot type = PO @@ -4618,7 +4663,7 @@ resource_name = whatsnew--2_2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_3] +[o:python-doc:p:python-314:r:whatsnew--2_3] file_filter = whatsnew/2.3.po source_file = gettext/whatsnew/2.3.pot type = PO @@ -4627,7 +4672,7 @@ resource_name = whatsnew--2_3 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_4] +[o:python-doc:p:python-314:r:whatsnew--2_4] file_filter = whatsnew/2.4.po source_file = gettext/whatsnew/2.4.pot type = PO @@ -4636,7 +4681,7 @@ resource_name = whatsnew--2_4 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_5] +[o:python-doc:p:python-314:r:whatsnew--2_5] file_filter = whatsnew/2.5.po source_file = gettext/whatsnew/2.5.pot type = PO @@ -4645,7 +4690,7 @@ resource_name = whatsnew--2_5 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_6] +[o:python-doc:p:python-314:r:whatsnew--2_6] file_filter = whatsnew/2.6.po source_file = gettext/whatsnew/2.6.pot type = PO @@ -4654,7 +4699,7 @@ resource_name = whatsnew--2_6 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_7] +[o:python-doc:p:python-314:r:whatsnew--2_7] file_filter = whatsnew/2.7.po source_file = gettext/whatsnew/2.7.pot type = PO @@ -4663,7 +4708,7 @@ resource_name = whatsnew--2_7 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_0] +[o:python-doc:p:python-314:r:whatsnew--3_0] file_filter = whatsnew/3.0.po source_file = gettext/whatsnew/3.0.pot type = PO @@ -4672,7 +4717,7 @@ resource_name = whatsnew--3_0 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_1] +[o:python-doc:p:python-314:r:whatsnew--3_1] file_filter = whatsnew/3.1.po source_file = gettext/whatsnew/3.1.pot type = PO @@ -4681,7 +4726,7 @@ resource_name = whatsnew--3_1 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_10] +[o:python-doc:p:python-314:r:whatsnew--3_10] file_filter = whatsnew/3.10.po source_file = gettext/whatsnew/3.10.pot type = PO @@ -4690,7 +4735,7 @@ resource_name = whatsnew--3_10 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_11] +[o:python-doc:p:python-314:r:whatsnew--3_11] file_filter = whatsnew/3.11.po source_file = gettext/whatsnew/3.11.pot type = PO @@ -4699,7 +4744,7 @@ resource_name = whatsnew--3_11 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_12] +[o:python-doc:p:python-314:r:whatsnew--3_12] file_filter = whatsnew/3.12.po source_file = gettext/whatsnew/3.12.pot type = PO @@ -4708,7 +4753,7 @@ resource_name = whatsnew--3_12 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_13] +[o:python-doc:p:python-314:r:whatsnew--3_13] file_filter = whatsnew/3.13.po source_file = gettext/whatsnew/3.13.pot type = PO @@ -4717,7 +4762,7 @@ resource_name = whatsnew--3_13 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_14] +[o:python-doc:p:python-314:r:whatsnew--3_14] file_filter = whatsnew/3.14.po source_file = gettext/whatsnew/3.14.pot type = PO @@ -4726,7 +4771,7 @@ resource_name = whatsnew--3_14 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_2] +[o:python-doc:p:python-314:r:whatsnew--3_2] file_filter = whatsnew/3.2.po source_file = gettext/whatsnew/3.2.pot type = PO @@ -4735,7 +4780,7 @@ resource_name = whatsnew--3_2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_3] +[o:python-doc:p:python-314:r:whatsnew--3_3] file_filter = whatsnew/3.3.po source_file = gettext/whatsnew/3.3.pot type = PO @@ -4744,7 +4789,7 @@ resource_name = whatsnew--3_3 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_4] +[o:python-doc:p:python-314:r:whatsnew--3_4] file_filter = whatsnew/3.4.po source_file = gettext/whatsnew/3.4.pot type = PO @@ -4753,7 +4798,7 @@ resource_name = whatsnew--3_4 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_5] +[o:python-doc:p:python-314:r:whatsnew--3_5] file_filter = whatsnew/3.5.po source_file = gettext/whatsnew/3.5.pot type = PO @@ -4762,7 +4807,7 @@ resource_name = whatsnew--3_5 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_6] +[o:python-doc:p:python-314:r:whatsnew--3_6] file_filter = whatsnew/3.6.po source_file = gettext/whatsnew/3.6.pot type = PO @@ -4771,7 +4816,7 @@ resource_name = whatsnew--3_6 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_7] +[o:python-doc:p:python-314:r:whatsnew--3_7] file_filter = whatsnew/3.7.po source_file = gettext/whatsnew/3.7.pot type = PO @@ -4780,7 +4825,7 @@ resource_name = whatsnew--3_7 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_8] +[o:python-doc:p:python-314:r:whatsnew--3_8] file_filter = whatsnew/3.8.po source_file = gettext/whatsnew/3.8.pot type = PO @@ -4789,7 +4834,7 @@ resource_name = whatsnew--3_8 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_9] +[o:python-doc:p:python-314:r:whatsnew--3_9] file_filter = whatsnew/3.9.po source_file = gettext/whatsnew/3.9.pot type = PO @@ -4798,7 +4843,7 @@ resource_name = whatsnew--3_9 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--changelog] +[o:python-doc:p:python-314:r:whatsnew--changelog] file_filter = whatsnew/changelog.po source_file = gettext/whatsnew/changelog.pot type = PO @@ -4807,7 +4852,7 @@ resource_name = whatsnew--changelog replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--index] +[o:python-doc:p:python-314:r:whatsnew--index] file_filter = whatsnew/index.po source_file = gettext/whatsnew/index.pot type = PO diff --git a/README.en.md b/README.en.md index fe3e3b2360..b489e29772 100644 --- a/README.en.md +++ b/README.en.md @@ -15,8 +15,8 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update- ]]] --> [![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml) [![core 100.00%](https://img.shields.io/badge/core-100.00%25-0.svg)](https://translations.python.org/#pl) -[![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.43%25-0.svg)](https://translations.python.org/#pl) -[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.33%25-0.svg)](https://translations.python.org/#pl) +[![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.71%25-0.svg)](https://translations.python.org/#pl) +[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.43%25-0.svg)](https://translations.python.org/#pl) *Przeczytaj to w innym języku: [polski](README.md)* diff --git a/README.md b/README.md index eb7ec0067c..ab8e0b960f 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,8 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update- ]]] --> [![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml) [![podstawowe artykuły 100.00%](https://img.shields.io/badge/podstawowe_artykuły-100.00%25-0.svg)](https://translations.python.org/#pl) -[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.43%25-0.svg)](https://translations.python.org/#pl) -[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.33%25-0.svg)](https://translations.python.org/#pl) +[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.71%25-0.svg)](https://translations.python.org/#pl) +[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.43%25-0.svg)](https://translations.python.org/#pl) *Read this in another language: [English](README.en.md)* diff --git a/about.po b/about.po index 62c0812ad8..2dea4eeb33 100644 --- a/about.po +++ b/about.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/bugs.po b/bugs.po index 12a82f37cd..057a8ef29e 100644 --- a/bugs.po +++ b/bugs.po @@ -4,18 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Stan Ulbrych, 2025 -# Maciej Olko , 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: Maciej Olko , 2026\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,8 +41,8 @@ msgid "" "to :ref:`contribute `." msgstr "" "Czasem szybsze może być własnoręczne naprawienie błędu i wysłanie patchy do " -"Pythona, usprawnia to proces i angażuje mniej osób. Dowiedz się, jak :ref:" -"`kontrybuować `." +"Pythona, usprawnia to proces i angażuje mniej osób. Dowiedz się, " +"jak :ref:`kontrybuować `." msgid "Documentation bugs" msgstr "Błędy w dokumentacji" diff --git a/builtins/constants.po b/builtins/constants.po new file mode 100644 index 0000000000..ce7d567280 --- /dev/null +++ b/builtins/constants.po @@ -0,0 +1,180 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2026 +# Mariusz Krzaczkowski, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-09-13 18:06+0000\n" +"Last-Translator: Mariusz Krzaczkowski, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Constants" +msgstr "Wbudowane stałe" + +msgid "A small number of constants live in the built-in namespace. They are:" +msgstr "We wbudowanej przestrzeni nazw znajduje się kilka stałych. Są to:" + +msgid "" +"The false value of the :class:`bool` type. Assignments to ``False`` are " +"illegal and raise a :exc:`SyntaxError`." +msgstr "" +"Wartość \"fałsz\" typu :class:`bool`. Przypisania do ``False`` są " +"niedozwolone i rzucają wyjątkiem :exc:`SyntaxError`." + +msgid "" +"The true value of the :class:`bool` type. Assignments to ``True`` are " +"illegal and raise a :exc:`SyntaxError`." +msgstr "" +"Wartość \"prawda\" typu :class:`bool`. Przypisania do ``True`` są " +"niedozwolone i rzucają wyjątkiem :exc:`SyntaxError`." + +msgid "" +"An object frequently used to represent the absence of a value, as when " +"default arguments are not passed to a function. Assignments to ``None`` are " +"illegal and raise a :exc:`SyntaxError`. ``None`` is the sole instance of " +"the :class:`~types.NoneType` type." +msgstr "" + +msgid "" +"A special value which should be returned by the binary special methods " +"(e.g. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object.__add__`, :meth:`~object.__rsub__`, " +"etc.) to indicate that the operation is not implemented with respect to the " +"other type; may be returned by the in-place binary special methods " +"(e.g. :meth:`~object.__imul__`, :meth:`~object.__iand__`, etc.) for the same " +"purpose. It should not be evaluated in a boolean context. :data:`!" +"NotImplemented` is the sole instance of " +"the :class:`types.NotImplementedType` type." +msgstr "" + +msgid "" +"When a binary (or in-place) method returns :data:`!NotImplemented` the " +"interpreter will try the reflected operation on the other type (or some " +"other fallback, depending on the operator). If all attempts return :data:`!" +"NotImplemented`, the interpreter will raise an appropriate exception. " +"Incorrectly returning :data:`!NotImplemented` will result in a misleading " +"error message or the :data:`!NotImplemented` value being returned to Python " +"code." +msgstr "" +"Gdy metoda binarna (albo operująca w miejscu) zwróci :data:`!" +"NotImplemented`, interpreter spróbuje wykonać odpowiadającą jej operację na " +"drugim typie (albo innego mechanizmu rezerwowego, w zależności od rodzaju " +"operatora). Dopiero gdy wszystkie próby zwrócą :data:`!NotImplemented`, " +"interpreter rzuci odpowiednim wyjątkiem. Nieprawidłowe zwracanie :data:`!" +"NotImplemented` spowoduje wyświetlenie mylnego komunikatu błędu lub też " +"zwrócenie wartości :data:`!NotImplemented` do kodu Pythona." + +msgid "See :ref:`implementing-the-arithmetic-operations` for examples." +msgstr "Zobacz przykłady w :ref:`implementing-the-arithmetic-operations`." + +msgid "" +":data:`!NotImplemented` and :exc:`!NotImplementedError` are not " +"interchangeable. This constant should only be used as described above; " +"see :exc:`NotImplementedError` for details on correct usage of the exception." +msgstr "" + +msgid "Evaluating :data:`!NotImplemented` in a boolean context was deprecated." +msgstr "" + +msgid "" +"Evaluating :data:`!NotImplemented` in a boolean context now raises " +"a :exc:`TypeError`. It previously evaluated to :const:`True` and emitted " +"a :exc:`DeprecationWarning` since Python 3.9." +msgstr "" + +msgid "" +"The same as the ellipsis literal \"``...``\", an object frequently used to " +"indicate that something is omitted. Assignment to ``Ellipsis`` is possible, " +"but assignment to ``...`` raises a :exc:`SyntaxError`. ``Ellipsis`` is the " +"sole instance of the :class:`types.EllipsisType` type." +msgstr "" + +msgid "" +"This constant is true if Python was not started with an :option:`-O` option. " +"See also the :keyword:`assert` statement." +msgstr "" +"Ta stała ma wartość True jeśli Python nie został uruchomiony z " +"opcją :option:`-O`. Zobacz także deklarację :keyword:`assert`." + +msgid "" +"The names :data:`None`, :data:`False`, :data:`True` and :data:`__debug__` " +"cannot be reassigned (assignments to them, even as an attribute name, " +"raise :exc:`SyntaxError`), so they can be considered \"true\" constants." +msgstr "" +"Nazwy :data:`None`, :data:`False`, :data:`True` oraz :data:`__debug__` nie " +"mogą być przypisane ponownie (przypisania do nich, nawet jako nazwa " +"atrybutu, rzucają :exc:`SyntaxError`), więc mogą być uważane za „prawdziwe” " +"stałe." + +msgid "Constants added by the :mod:`site` module" +msgstr "Stałe dodane przez moduł :mod:`site`" + +msgid "" +"The :mod:`site` module (which is imported automatically during startup, " +"except if the :option:`-S` command-line option is given) adds several " +"constants to the built-in namespace. They are useful for the interactive " +"interpreter shell and should not be used in programs." +msgstr "" +"Moduł :mod:`site` (który jest importowany automatycznie podczas " +"uruchamiania, z wyjątkiem sytuacji, gdy podano opcję wiersza " +"poleceń :option:`-S`) dodaje kilka stałych do wbudowanej przestrzeni nazw. " +"Są one przydatne w interaktywnej powłoce interpretera i nie powinny być " +"używane w programach." + +msgid "" +"Objects that when printed, print a message like \"Use quit() or Ctrl-D (i.e. " +"EOF) to exit\", and when accessed directly in the interactive interpreter or " +"called as functions, raise :exc:`SystemExit` with the specified exit code." +msgstr "" +"Obiekty, które po wypisaniu wyświetlają komunikat w rodzaju \"Use quit() or " +"Ctrl-D (i.e. EOF) to exit\", a gdy wywołane - rzucą " +"wyjątek :exc:`SystemExit` z podanym kodem wyjścia." + +msgid "" +"Object that when printed, prints the message \"Type help() for interactive " +"help, or help(object) for help about object.\", and when accessed directly " +"in the interactive interpreter, invokes the built-in help system " +"(see :func:`help`)." +msgstr "" +"Obiekt, który po wydrukowaniu wyświetla komunikat „Type help() for " +"interactive help, or help(object) for help about object.”, a przy " +"bezpośrednim wywołaniu w interpreterze interaktywnym uruchamia wbudowany " +"system pomocy (zobacz :func:`help`)." + +msgid "" +"Objects that when printed or called, print the text of copyright or credits, " +"respectively." +msgstr "" +"Obiekty, które, gdy wypisane lub wywołane - wyświetlają treść odpowiednio " +"praw autorskich i słów uznania." + +msgid "" +"Object that when printed, prints the message \"Type license() to see the " +"full license text\", and when called, displays the full license text in a " +"pager-like fashion (one screen at a time)." +msgstr "" +"Obiekt, który, gdy jego nazwa zostanie wpisana w powłoce - wyświetla " +"wiadomość \"Type license() to see the full license text\", a gdy wywołany - " +"wyświetla pełny tekst licencji w sposób podobny do pagera (jeden ekran na " +"raz)." + +msgid "..." +msgstr "..." + +msgid "ellipsis literal" +msgstr "Literalny zapis wielokropka" diff --git a/builtins/exceptions.po b/builtins/exceptions.po new file mode 100644 index 0000000000..6c2285e26f --- /dev/null +++ b/builtins/exceptions.po @@ -0,0 +1,1195 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-09-13 18:06+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Exceptions" +msgstr "" + +msgid "" +"In Python, all exceptions must be instances of a class that derives " +"from :class:`BaseException`. In a :keyword:`try` statement with " +"an :keyword:`except` clause that mentions a particular class, that clause " +"also handles any exception classes derived from that class (but not " +"exception classes from which *it* is derived). Two exception classes that " +"are not related via subclassing are never equivalent, even if they have the " +"same name." +msgstr "" + +msgid "" +"The built-in exceptions listed in this chapter can be generated by the " +"interpreter or built-in functions. Except where mentioned, they have an " +"\"associated value\" indicating the detailed cause of the error. This may " +"be a string or a tuple of several items of information (e.g., an error code " +"and a string explaining the code). The associated value is usually passed " +"as arguments to the exception class's constructor." +msgstr "" + +msgid "" +"User code can raise built-in exceptions. This can be used to test an " +"exception handler or to report an error condition \"just like\" the " +"situation in which the interpreter raises the same exception; but beware " +"that there is nothing to prevent user code from raising an inappropriate " +"error." +msgstr "" + +msgid "" +"The built-in exception classes can be subclassed to define new exceptions; " +"programmers are encouraged to derive new exceptions from " +"the :exc:`Exception` class or one of its subclasses, and not " +"from :exc:`BaseException`. More information on defining exceptions is " +"available in the Python Tutorial under :ref:`tut-userexceptions`." +msgstr "" + +msgid "Exception context" +msgstr "" + +msgid "" +"Three attributes on exception objects provide information about the context " +"in which the exception was raised:" +msgstr "" + +msgid "" +"When raising a new exception while another exception is already being " +"handled, the new exception's :attr:`!__context__` attribute is automatically " +"set to the handled exception. An exception may be handled when " +"an :keyword:`except` or :keyword:`finally` clause, or a :keyword:`with` " +"statement, is used." +msgstr "" + +msgid "" +"This implicit exception context can be supplemented with an explicit cause " +"by using :keyword:`!from` with :keyword:`raise`::" +msgstr "" + +msgid "raise new_exc from original_exc" +msgstr "" + +msgid "" +"The expression following :keyword:`from` must be an exception or " +"``None``. It will be set as :attr:`!__cause__` on the raised exception. " +"Setting :attr:`!__cause__` also implicitly sets the :attr:`!" +"__suppress_context__` attribute to ``True``, so that using ``raise new_exc " +"from None`` effectively replaces the old exception with the new one for " +"display purposes (e.g. converting :exc:`KeyError` to :exc:`AttributeError`), " +"while leaving the old exception available in :attr:`!__context__` for " +"introspection when debugging." +msgstr "" + +msgid "" +"The default traceback display code shows these chained exceptions in " +"addition to the traceback for the exception itself. An explicitly chained " +"exception in :attr:`!__cause__` is always shown when present. An implicitly " +"chained exception in :attr:`!__context__` is shown only if :attr:`!" +"__cause__` is :const:`None` and :attr:`!__suppress_context__` is false." +msgstr "" + +msgid "" +"In either case, the exception itself is always shown after any chained " +"exceptions so that the final line of the traceback always shows the last " +"exception that was raised." +msgstr "" + +msgid "Inheriting from built-in exceptions" +msgstr "" + +msgid "" +"User code can create subclasses that inherit from an exception type. It's " +"recommended to only subclass one exception type at a time to avoid any " +"possible conflicts between how the bases handle the ``args`` attribute, as " +"well as due to possible memory layout incompatibilities." +msgstr "" + +msgid "" +"Most built-in exceptions are implemented in C for efficiency, " +"see: :source:`Objects/exceptions.c`. Some have custom memory layouts which " +"makes it impossible to create a subclass that inherits from multiple " +"exception types. The memory layout of a type is an implementation detail and " +"might change between Python versions, leading to new conflicts in the " +"future. Therefore, it's recommended to avoid subclassing multiple exception " +"types altogether." +msgstr "" + +msgid "Base classes" +msgstr "" + +msgid "" +"The following exceptions are used mostly as base classes for other " +"exceptions." +msgstr "" + +msgid "" +"The base class for all built-in exceptions. It is not meant to be directly " +"inherited by user-defined classes (for that, use :exc:`Exception`). " +"If :func:`str` is called on an instance of this class, the representation of " +"the argument(s) to the instance are returned, or the empty string when there " +"were no arguments." +msgstr "" + +msgid "" +"The tuple of arguments given to the exception constructor. Some built-in " +"exceptions (like :exc:`OSError`) expect a certain number of arguments and " +"assign a special meaning to the elements of this tuple, while others are " +"usually called only with a single string giving an error message." +msgstr "" + +msgid "" +"This method sets *tb* as the new traceback for the exception and returns the " +"exception object. It was more commonly used before the exception chaining " +"features of :pep:`3134` became available. The following example shows how " +"we can convert an instance of ``SomeException`` into an instance of " +"``OtherException`` while preserving the traceback. Once raised, the current " +"frame is pushed onto the traceback of the ``OtherException``, as would have " +"happened to the traceback of the original ``SomeException`` had we allowed " +"it to propagate to the caller. ::" +msgstr "" + +msgid "" +"try:\n" +" ...\n" +"except SomeException:\n" +" tb = sys.exception().__traceback__\n" +" raise OtherException(...).with_traceback(tb)" +msgstr "" + +msgid "" +"A writable field that holds the :ref:`traceback object ` " +"associated with this exception. See also: :ref:`raise`." +msgstr "" + +msgid "" +"Add the string ``note`` to the exception's notes which appear in the " +"standard traceback after the exception string. A :exc:`TypeError` is raised " +"if ``note`` is not a string." +msgstr "" + +msgid "" +"A list of the notes of this exception, which were added " +"with :meth:`add_note`. This attribute is created when :meth:`add_note` is " +"called." +msgstr "" + +msgid "" +"All built-in, non-system-exiting exceptions are derived from this class. " +"All user-defined exceptions should also be derived from this class." +msgstr "" + +msgid "" +"The base class for those built-in exceptions that are raised for various " +"arithmetic " +"errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:`FloatingPointError`." +msgstr "" + +msgid "" +"Raised when a :ref:`buffer ` related operation cannot be " +"performed." +msgstr "" + +msgid "" +"The base class for the exceptions that are raised when a key or index used " +"on a mapping or sequence is invalid: :exc:`IndexError`, :exc:`KeyError`. " +"This can be raised directly by :func:`codecs.lookup`." +msgstr "" + +msgid "Concrete exceptions" +msgstr "" + +msgid "The following exceptions are the exceptions that are usually raised." +msgstr "" + +msgid "Raised when an :keyword:`assert` statement fails." +msgstr "" + +msgid "" +"Raised when an attribute reference (see :ref:`attribute-references`) or " +"assignment fails. (When an object does not support attribute references or " +"attribute assignments at all, :exc:`TypeError` is raised.)" +msgstr "" + +msgid "" +"The optional *name* and *obj* keyword-only arguments set the corresponding " +"attributes:" +msgstr "" + +msgid "The name of the attribute that was attempted to be accessed." +msgstr "" + +msgid "The object that was accessed for the named attribute." +msgstr "" + +msgid "Added the :attr:`name` and :attr:`obj` attributes." +msgstr "" + +msgid "" +"Raised when the :func:`input` function hits an end-of-file condition (EOF) " +"without reading any data. (Note: the :meth:`io.TextIOBase.read` " +"and :meth:`io.IOBase.readline` methods return an empty string when they hit " +"EOF.)" +msgstr "" + +msgid "Not currently used." +msgstr "" + +msgid "" +"Raised when a :term:`generator` or :term:`coroutine` is closed; " +"see :meth:`generator.close` and :meth:`coroutine.close`. It directly " +"inherits from :exc:`BaseException` instead of :exc:`Exception` since it is " +"technically not an error." +msgstr "" + +msgid "" +"Raised when the :keyword:`import` statement has troubles trying to load a " +"module. Also raised when the \"from list\" in ``from ... import`` has a " +"name that cannot be found." +msgstr "" + +msgid "" +"The optional *name* and *path* keyword-only arguments set the corresponding " +"attributes:" +msgstr "" + +msgid "The name of the module that was attempted to be imported." +msgstr "" + +msgid "The path to any file which triggered the exception." +msgstr "" + +msgid "Added the :attr:`name` and :attr:`path` attributes." +msgstr "" + +msgid "" +"A subclass of :exc:`ImportError` which is raised by :keyword:`import` when a " +"module could not be located. It is also raised when ``None`` is found " +"in :data:`sys.modules`." +msgstr "" + +msgid "" +"Raised when a sequence subscript is out of range. (Slice indices are " +"silently truncated to fall in the allowed range; if an index is not an " +"integer, :exc:`TypeError` is raised.)" +msgstr "" + +msgid "" +"Raised when a mapping (dictionary) key is not found in the set of existing " +"keys." +msgstr "" + +msgid "" +"Raised when the user hits the interrupt key (normally :kbd:`Control-C` " +"or :kbd:`Delete`). During execution, a check for interrupts is made " +"regularly. The exception inherits from :exc:`BaseException` so as to not be " +"accidentally caught by code that catches :exc:`Exception` and thus prevent " +"the interpreter from exiting." +msgstr "" + +msgid "" +"Catching a :exc:`KeyboardInterrupt` requires special consideration. Because " +"it can be raised at unpredictable points, it may, in some circumstances, " +"leave the running program in an inconsistent state. It is generally best to " +"allow :exc:`KeyboardInterrupt` to end the program as quickly as possible or " +"avoid raising it entirely. (See :ref:`handlers-and-exceptions`.)" +msgstr "" + +msgid "" +"Raised when an operation runs out of memory but the situation may still be " +"rescued (by deleting some objects). The associated value is a string " +"indicating what kind of (internal) operation ran out of memory. Note that " +"because of the underlying memory management architecture " +"(C's :c:func:`malloc` function), the interpreter may not always be able to " +"completely recover from this situation; it nevertheless raises an exception " +"so that a stack traceback can be printed, in case a run-away program was the " +"cause." +msgstr "" + +msgid "" +"Raised when a local or global name is not found. This applies only to " +"unqualified names. The associated value is an error message that includes " +"the name that could not be found." +msgstr "" + +msgid "The optional *name* keyword-only argument sets the attribute:" +msgstr "" + +msgid "The name of the variable that was attempted to be accessed." +msgstr "" + +msgid "Added the :attr:`name` attribute." +msgstr "" + +msgid "" +"This exception is derived from :exc:`RuntimeError`. In user defined base " +"classes, abstract methods should raise this exception when they require " +"derived classes to override the method, or while the class is being " +"developed to indicate that the real implementation still needs to be added." +msgstr "" + +msgid "" +"It should not be used to indicate that an operator or method is not meant to " +"be supported at all -- in that case either leave the operator / method " +"undefined or, if a subclass, set it to :data:`None`." +msgstr "" + +msgid "" +":exc:`!NotImplementedError` and :data:`!NotImplemented` are not " +"interchangeable. This exception should only be used as described above; " +"see :data:`NotImplemented` for details on correct usage of the built-in " +"constant." +msgstr "" + +msgid "" +"This exception is raised when a system function returns a system-related " +"error, including I/O failures such as \"file not found\" or \"disk full\" " +"(not for illegal argument types or other incidental errors)." +msgstr "" + +msgid "" +"The second form of the constructor sets the corresponding attributes, " +"described below. The attributes default to :const:`None` if not specified. " +"For backwards compatibility, if three arguments are passed, " +"the :attr:`~BaseException.args` attribute contains only a 2-tuple of the " +"first two constructor arguments." +msgstr "" + +msgid "" +"The constructor often actually returns a subclass of :exc:`OSError`, as " +"described in `OS exceptions`_ below. The particular subclass depends on the " +"final :attr:`.errno` value. This behaviour only occurs when " +"constructing :exc:`OSError` directly or via an alias, and is not inherited " +"when subclassing." +msgstr "" + +msgid "A numeric error code from the C variable :c:data:`errno`." +msgstr "" + +msgid "" +"Under Windows, this gives you the native Windows error code. " +"The :attr:`.errno` attribute is then an approximate translation, in POSIX " +"terms, of that native error code." +msgstr "" + +msgid "" +"Under Windows, if the *winerror* constructor argument is an integer, " +"the :attr:`.errno` attribute is determined from the Windows error code, and " +"the *errno* argument is ignored. On other platforms, the *winerror* " +"argument is ignored, and the :attr:`winerror` attribute does not exist." +msgstr "" + +msgid "" +"The corresponding error message, as provided by the operating system. It is " +"formatted by the C functions :c:func:`!perror` under POSIX, and :c:func:`!" +"FormatMessage` under Windows." +msgstr "" + +msgid "" +"For exceptions that involve a file system path (such as :func:`open` " +"or :func:`os.unlink`), :attr:`filename` is the file name passed to the " +"function. For functions that involve two file system paths (such " +"as :func:`os.rename`), :attr:`filename2` corresponds to the second file name " +"passed to the function." +msgstr "" + +msgid "" +":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket.error`, :exc:`select.error` " +"and :exc:`!mmap.error` have been merged into :exc:`OSError`, and the " +"constructor may return a subclass." +msgstr "" + +msgid "" +"The :attr:`filename` attribute is now the original file name passed to the " +"function, instead of the name encoded to or decoded from " +"the :term:`filesystem encoding and error handler`. Also, the *filename2* " +"constructor argument and attribute was added." +msgstr "" + +msgid "" +"Raised when the result of an arithmetic operation is too large to be " +"represented. This cannot occur for integers (which would rather " +"raise :exc:`MemoryError` than give up). However, for historical reasons, " +"OverflowError is sometimes raised for integers that are outside a required " +"range. Because of the lack of standardization of floating-point exception " +"handling in C, most floating-point operations are not checked." +msgstr "" + +msgid "" +"This exception is derived from :exc:`RuntimeError`. It is raised when an " +"operation is blocked during interpreter shutdown also known as :term:`Python " +"finalization `." +msgstr "" + +msgid "" +"Examples of operations which can be blocked with " +"a :exc:`PythonFinalizationError` during the Python finalization:" +msgstr "" + +msgid "Creating a new Python thread." +msgstr "" + +msgid ":meth:`Joining ` a running daemon thread." +msgstr "" + +msgid ":func:`os.fork`." +msgstr ":func:`os.fork`." + +msgid "See also the :func:`sys.is_finalizing` function." +msgstr "" + +msgid "Previously, a plain :exc:`RuntimeError` was raised." +msgstr "" + +msgid ":meth:`threading.Thread.join` can now raise this exception." +msgstr "" + +msgid "" +"This exception is derived from :exc:`RuntimeError`. It is raised when the " +"interpreter detects that the maximum recursion depth " +"(see :func:`sys.getrecursionlimit`) is exceeded." +msgstr "" + +msgid "" +"This exception is raised when a weak reference proxy, created by " +"the :func:`weakref.proxy` function, is used to access an attribute of the " +"referent after it has been garbage collected. For more information on weak " +"references, see the :mod:`weakref` module." +msgstr "" + +msgid "" +"Raised when an error is detected that doesn't fall in any of the other " +"categories. The associated value is a string indicating what precisely went " +"wrong." +msgstr "" + +msgid "" +"Raised by built-in function :func:`next` and " +"an :term:`iterator`\\'s :meth:`~iterator.__next__` method to signal that " +"there are no further items produced by the iterator." +msgstr "" + +msgid "" +"The exception object has a single attribute :attr:`!value`, which is given " +"as an argument when constructing the exception, and defaults " +"to :const:`None`." +msgstr "" + +msgid "" +"When a :term:`generator` or :term:`coroutine` function returns, a " +"new :exc:`StopIteration` instance is raised, and the value returned by the " +"function is used as the :attr:`value` parameter to the constructor of the " +"exception." +msgstr "" + +msgid "" +"If a generator code directly or indirectly raises :exc:`StopIteration`, it " +"is converted into a :exc:`RuntimeError` (retaining the :exc:`StopIteration` " +"as the new exception's cause)." +msgstr "" + +msgid "" +"Added ``value`` attribute and the ability for generator functions to use it " +"to return a value." +msgstr "" + +msgid "" +"Introduced the RuntimeError transformation via ``from __future__ import " +"generator_stop``, see :pep:`479`." +msgstr "" + +msgid "" +"Enable :pep:`479` for all code by default: a :exc:`StopIteration` error " +"raised in a generator is transformed into a :exc:`RuntimeError`." +msgstr "" + +msgid "" +"Must be raised by :meth:`~object.__anext__` method of an :term:`asynchronous " +"iterator` object to stop the iteration." +msgstr "" + +msgid "" +"Raised when the parser encounters a syntax error. This may occur in " +"an :keyword:`import` statement, in a call to the built-in " +"functions :func:`compile`, :func:`exec`, or :func:`eval`, or when reading " +"the initial script or standard input (also interactively)." +msgstr "" + +msgid "" +"The :func:`str` of the exception instance returns only the error message. " +"Details is a tuple whose members are also available as separate attributes." +msgstr "" + +msgid "The name of the file the syntax error occurred in." +msgstr "" + +msgid "" +"Which line number in the file the error occurred in. This is 1-indexed: the " +"first line in the file has a ``lineno`` of 1." +msgstr "" + +msgid "" +"The column in the line where the error occurred. This is 1-indexed: the " +"first character in the line has an ``offset`` of 1." +msgstr "" + +msgid "The source code text involved in the error." +msgstr "" + +msgid "" +"Which line number in the file the error occurred ends in. This is 1-indexed: " +"the first line in the file has a ``lineno`` of 1." +msgstr "" + +msgid "" +"The column in the end line where the error occurred finishes. This is 1-" +"indexed: the first character in the line has an ``offset`` of 1." +msgstr "" + +msgid "" +"For errors in f-string fields, the message is prefixed by \"f-string: \" and " +"the offsets are offsets in a text constructed from the replacement " +"expression. For example, compiling f'Bad {a b} field' results in this args " +"attribute: ('f-string: ...', ('', 1, 2, '(a b)\\n', 1, 5))." +msgstr "" + +msgid "Added the :attr:`end_lineno` and :attr:`end_offset` attributes." +msgstr "" + +msgid "" +"Base class for syntax errors related to incorrect indentation. This is a " +"subclass of :exc:`SyntaxError`." +msgstr "" + +msgid "" +"Raised when indentation contains an inconsistent use of tabs and spaces. " +"This is a subclass of :exc:`IndentationError`." +msgstr "" + +msgid "" +"Raised when the interpreter finds an internal error, but the situation does " +"not look so serious to cause it to abandon all hope. The associated value is " +"a string indicating what went wrong (in low-level terms). " +"In :term:`CPython`, this could be raised by incorrectly using Python's C " +"API, such as returning a ``NULL`` value without an exception set." +msgstr "" + +msgid "" +"If you're confident that this exception wasn't your fault, or the fault of a " +"package you're using, you should report this to the author or maintainer of " +"your Python interpreter. Be sure to report the version of the Python " +"interpreter (``sys.version``; it is also printed at the start of an " +"interactive Python session), the exact error message (the exception's " +"associated value) and if possible the source of the program that triggered " +"the error." +msgstr "" + +msgid "" +"This exception is raised by the :func:`sys.exit` function. It inherits " +"from :exc:`BaseException` instead of :exc:`Exception` so that it is not " +"accidentally caught by code that catches :exc:`Exception`. This allows the " +"exception to properly propagate up and cause the interpreter to exit. When " +"it is not handled, the Python interpreter exits; no stack traceback is " +"printed. The constructor accepts the same optional argument passed " +"to :func:`sys.exit`. If the value is an integer, it specifies the system " +"exit status (passed to C's :c:func:`!exit` function); if it is ``None``, the " +"exit status is zero; if it has another type (such as a string), the object's " +"value is printed and the exit status is one." +msgstr "" + +msgid "" +"A call to :func:`sys.exit` is translated into an exception so that clean-up " +"handlers (:keyword:`finally` clauses of :keyword:`try` statements) can be " +"executed, and so that a debugger can execute a script without running the " +"risk of losing control. The :func:`os._exit` function can be used if it is " +"absolutely positively necessary to exit immediately (for example, in the " +"child process after a call to :func:`os.fork`)." +msgstr "" + +msgid "" +"The exit status or error message that is passed to the constructor. " +"(Defaults to ``None``.)" +msgstr "" + +msgid "" +"Raised when an operation or function is applied to an object of " +"inappropriate type. The associated value is a string giving details about " +"the type mismatch." +msgstr "" + +msgid "" +"This exception may be raised by user code to indicate that an attempted " +"operation on an object is not supported, and is not meant to be. If an " +"object is meant to support a given operation but has not yet provided an " +"implementation, :exc:`NotImplementedError` is the proper exception to raise." +msgstr "" + +msgid "" +"Passing arguments of the wrong type (e.g. passing a :class:`list` when " +"an :class:`int` is expected) should result in a :exc:`TypeError`, but " +"passing arguments with the wrong value (e.g. a number outside expected " +"boundaries) should result in a :exc:`ValueError`." +msgstr "" + +msgid "" +"Raised when a reference is made to a local variable in a function or method, " +"but no value has been bound to that variable. This is a subclass " +"of :exc:`NameError`." +msgstr "" + +msgid "" +"Raised when a Unicode-related encoding or decoding error occurs. It is a " +"subclass of :exc:`ValueError`." +msgstr "" + +msgid "" +":exc:`UnicodeError` has attributes that describe the encoding or decoding " +"error. For example, ``err.object[err.start:err.end]`` gives the particular " +"invalid input that the codec failed on." +msgstr "" + +msgid "The name of the encoding that raised the error." +msgstr "" + +msgid "A string describing the specific codec error." +msgstr "" + +msgid "The object the codec was attempting to encode or decode." +msgstr "" + +msgid "The first index of invalid data in :attr:`object`." +msgstr "" + +msgid "" +"This value should not be negative as it is interpreted as an absolute offset " +"but this constraint is not enforced at runtime." +msgstr "" + +msgid "The index after the last invalid data in :attr:`object`." +msgstr "" + +msgid "" +"Raised when a Unicode-related error occurs during encoding. It is a " +"subclass of :exc:`UnicodeError`." +msgstr "" + +msgid "" +"Raised when a Unicode-related error occurs during decoding. It is a " +"subclass of :exc:`UnicodeError`." +msgstr "" + +msgid "" +"Raised when a Unicode-related error occurs during translating. It is a " +"subclass of :exc:`UnicodeError`." +msgstr "" + +msgid "" +"Raised when an operation or function receives an argument that has the right " +"type but an inappropriate value, and the situation is not described by a " +"more precise exception such as :exc:`IndexError`." +msgstr "" + +msgid "" +"Raised when the second argument of a division or modulo operation is zero. " +"The associated value is a string indicating the type of the operands and the " +"operation." +msgstr "" + +msgid "" +"The following exceptions are kept for compatibility with previous versions; " +"starting from Python 3.3, they are aliases of :exc:`OSError`." +msgstr "" + +msgid "Only available on Windows." +msgstr "" + +msgid "OS exceptions" +msgstr "" + +msgid "" +"The following exceptions are subclasses of :exc:`OSError`, they get raised " +"depending on the system error code." +msgstr "" + +msgid "" +"Raised when an operation would block on an object (e.g. socket) set for non-" +"blocking operation. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` " +"and :py:const:`~errno.EINPROGRESS`." +msgstr "" + +msgid "" +"In addition to those of :exc:`OSError`, :exc:`BlockingIOError` can have one " +"more attribute:" +msgstr "" + +msgid "" +"An integer containing the number of **bytes** written to the stream before " +"it blocked. This attribute is available when using the buffered I/O classes " +"from the :mod:`io` module." +msgstr "" + +msgid "" +"Raised when an operation on a child process failed. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECHILD`." +msgstr "" + +msgid "A base class for connection-related issues." +msgstr "" + +msgid "" +"Subclasses " +"are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:`ConnectionRefusedError` " +"and :exc:`ConnectionResetError`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when trying to write on a pipe " +"while the other end has been closed, or trying to write on a socket which " +"has been shutdown for writing. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when a connection attempt is " +"aborted by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNABORTED`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when a connection attempt is " +"refused by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNREFUSED`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when a connection is reset by " +"the peer. Corresponds to :c:data:`errno` :py:const:`~errno.ECONNRESET`." +msgstr "" + +msgid "" +"Raised when trying to create a file or directory which already exists. " +"Corresponds to :c:data:`errno` :py:const:`~errno.EEXIST`." +msgstr "" + +msgid "" +"Raised when a file or directory is requested but doesn't exist. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ENOENT`." +msgstr "" + +msgid "" +"Raised when a system call is interrupted by an incoming signal. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EINTR`." +msgstr "" + +msgid "" +"Python now retries system calls when a syscall is interrupted by a signal, " +"except if the signal handler raises an exception (see :pep:`475` for the " +"rationale), instead of raising :exc:`InterruptedError`." +msgstr "" + +msgid "" +"Raised when a file operation (such as :func:`os.remove`) is requested on a " +"directory. Corresponds to :c:data:`errno` :py:const:`~errno.EISDIR`." +msgstr "" + +msgid "" +"Raised when a directory operation (such as :func:`os.listdir`) is requested " +"on something which is not a directory. On most POSIX platforms, it may also " +"be raised if an operation attempts to open or traverse a non-directory file " +"as if it were a directory. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ENOTDIR`." +msgstr "" + +msgid "" +"Raised when trying to run an operation without the adequate access rights - " +"for example filesystem permissions. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EACCES`, :py:const:`~errno.EPERM`, " +"and :py:const:`~errno.ENOTCAPABLE`." +msgstr "" + +msgid "" +"WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped " +"to :exc:`PermissionError`." +msgstr "" + +msgid "" +"Raised when a given process doesn't exist. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ESRCH`." +msgstr "" + +msgid "" +"Raised when a system function timed out at the system level. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ETIMEDOUT`." +msgstr "" + +msgid "All the above :exc:`OSError` subclasses were added." +msgstr "" + +msgid ":pep:`3151` - Reworking the OS and IO exception hierarchy" +msgstr "" + +msgid "Warnings" +msgstr "" + +msgid "" +"The following exceptions are used as warning categories; see " +"the :ref:`warning-categories` documentation for more details." +msgstr "" + +msgid "Base class for warning categories." +msgstr "" + +msgid "Base class for warnings generated by user code." +msgstr "" + +msgid "" +"Base class for warnings about deprecated features when those warnings are " +"intended for other Python developers." +msgstr "" + +msgid "" +"Ignored by the default warning filters, except in the ``__main__`` module " +"(:pep:`565`). Enabling the :ref:`Python Development Mode ` shows " +"this warning." +msgstr "" + +msgid "The deprecation policy is described in :pep:`387`." +msgstr "" + +msgid "" +"Base class for warnings about features which are obsolete and expected to be " +"deprecated in the future, but are not deprecated at the moment." +msgstr "" + +msgid "" +"This class is rarely used as emitting a warning about a possible upcoming " +"deprecation is unusual, and :exc:`DeprecationWarning` is preferred for " +"already active deprecations." +msgstr "" + +msgid "" +"Ignored by the default warning filters. Enabling the :ref:`Python " +"Development Mode ` shows this warning." +msgstr "" + +msgid "Base class for warnings about dubious syntax." +msgstr "" + +msgid "" +"This warning is typically emitted when compiling Python source code, and " +"usually won't be reported when running already compiled code." +msgstr "" + +msgid "Base class for warnings about dubious runtime behavior." +msgstr "" + +msgid "" +"Base class for warnings about deprecated features when those warnings are " +"intended for end users of applications that are written in Python." +msgstr "" + +msgid "Base class for warnings about probable mistakes in module imports." +msgstr "" + +msgid "Base class for warnings related to Unicode." +msgstr "" + +msgid "Base class for warnings related to encodings." +msgstr "" + +msgid "See :ref:`io-encoding-warning` for details." +msgstr "" + +msgid "" +"Base class for warnings related to :class:`bytes` and :class:`bytearray`." +msgstr "" + +msgid "Base class for warnings related to resource usage." +msgstr "" + +msgid "Exception groups" +msgstr "" + +msgid "" +"The following are used when it is necessary to raise multiple unrelated " +"exceptions. They are part of the exception hierarchy so they can be handled " +"with :keyword:`except` like all other exceptions. In addition, they are " +"recognised by :keyword:`except*`, which matches their subgroups " +"based on the types of the contained exceptions." +msgstr "" + +msgid "" +"Both of these exception types wrap the exceptions in the sequence ``excs``. " +"The ``msg`` parameter must be a string. The difference between the two " +"classes is that :exc:`BaseExceptionGroup` extends :exc:`BaseException` and " +"it can wrap any exception, while :exc:`ExceptionGroup` " +"extends :exc:`Exception` and it can only wrap subclasses " +"of :exc:`Exception`. This design is so that ``except Exception`` catches " +"an :exc:`ExceptionGroup` but not :exc:`BaseExceptionGroup`." +msgstr "" + +msgid "" +"The :exc:`BaseExceptionGroup` constructor returns an :exc:`ExceptionGroup` " +"rather than a :exc:`BaseExceptionGroup` if all contained exceptions " +"are :exc:`Exception` instances, so it can be used to make the selection " +"automatic. The :exc:`ExceptionGroup` constructor, on the other hand, raises " +"a :exc:`TypeError` if any contained exception is not an :exc:`Exception` " +"subclass." +msgstr "" + +msgid "" +"Exception groups are :ref:`generic ` over the type of their " +"contained exceptions." +msgstr "" + +msgid "" +"The ``excs`` parameter may be any sequence, but lists and tuples are " +"specifically processed more efficiently here. For optimal performance, pass " +"a tuple as ``excs``." +msgstr "" + +msgid "The ``msg`` argument to the constructor. This is a read-only attribute." +msgstr "" + +msgid "" +"A tuple of the exceptions in the ``excs`` sequence given to the constructor. " +"This is a read-only attribute." +msgstr "" + +msgid "" +"Returns an exception group that contains only the exceptions from the " +"current group that match *condition*, or ``None`` if the result is empty." +msgstr "" + +msgid "" +"The condition can be an exception type or tuple of exception types, in which " +"case each exception is checked for a match using the same check that is used " +"in an ``except`` clause. The condition can also be a callable (other than a " +"type object) that accepts an exception as its single argument and returns " +"true for the exceptions that should be in the subgroup." +msgstr "" + +msgid "" +"The nesting structure of the current exception is preserved in the result, " +"as are the values of " +"its :attr:`message`, :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields. Empty nested groups are omitted " +"from the result." +msgstr "" + +msgid "" +"The condition is checked for all exceptions in the nested exception group, " +"including the top-level and any nested exception groups. If the condition is " +"true for such an exception group, it is included in the result in full." +msgstr "" + +msgid "``condition`` can be any callable which is not a type object." +msgstr "" + +msgid "" +"Like :meth:`subgroup`, but returns the pair ``(match, rest)`` where " +"``match`` is ``subgroup(condition)`` and ``rest`` is the remaining non-" +"matching part." +msgstr "" + +msgid "" +"Returns an exception group with the same :attr:`message`, but which wraps " +"the exceptions in ``excs``." +msgstr "" + +msgid "" +"This method is used by :meth:`subgroup` and :meth:`split`, which are used in " +"various contexts to break up an exception group. A subclass needs to " +"override it in order to make :meth:`subgroup` and :meth:`split` return " +"instances of the subclass rather than :exc:`ExceptionGroup`." +msgstr "" + +msgid "" +":meth:`subgroup` and :meth:`split` copy " +"the :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields from the original exception " +"group to the one returned by :meth:`derive`, so these fields do not need to " +"be updated by :meth:`derive`." +msgstr "" + +msgid "" +">>> class MyGroup(ExceptionGroup):\n" +"... def derive(self, excs):\n" +"... return MyGroup(self.message, excs)\n" +"...\n" +">>> e = MyGroup(\"eg\", [ValueError(1), TypeError(2)])\n" +">>> e.add_note(\"a note\")\n" +">>> e.__context__ = Exception(\"context\")\n" +">>> e.__cause__ = Exception(\"cause\")\n" +">>> try:\n" +"... raise e\n" +"... except Exception as e:\n" +"... exc = e\n" +"...\n" +">>> match, rest = exc.split(ValueError)\n" +">>> exc, exc.__context__, exc.__cause__, exc.__notes__\n" +"(MyGroup('eg', [ValueError(1), TypeError(2)]), Exception('context'), " +"Exception('cause'), ['a note'])\n" +">>> match, match.__context__, match.__cause__, match.__notes__\n" +"(MyGroup('eg', [ValueError(1)]), Exception('context'), Exception('cause'), " +"['a note'])\n" +">>> rest, rest.__context__, rest.__cause__, rest.__notes__\n" +"(MyGroup('eg', [TypeError(2)]), Exception('context'), Exception('cause'), " +"['a note'])\n" +">>> exc.__traceback__ is match.__traceback__ is rest.__traceback__\n" +"True" +msgstr "" + +msgid "" +"Note that :exc:`BaseExceptionGroup` defines :meth:`~object.__new__`, so " +"subclasses that need a different constructor signature need to override that " +"rather than :meth:`~object.__init__`. For example, the following defines an " +"exception group subclass which accepts an exit_code and constructs the " +"group's message from it. ::" +msgstr "" + +msgid "" +"class Errors(ExceptionGroup):\n" +" def __new__(cls, errors, exit_code):\n" +" self = super().__new__(Errors, f\"exit code: {exit_code}\", errors)\n" +" self.exit_code = exit_code\n" +" return self\n" +"\n" +" def derive(self, excs):\n" +" return Errors(excs, self.exit_code)" +msgstr "" + +msgid "" +"Like :exc:`ExceptionGroup`, any subclass of :exc:`BaseExceptionGroup` which " +"is also a subclass of :exc:`Exception` can only wrap instances " +"of :exc:`Exception`." +msgstr "" + +msgid "Exception hierarchy" +msgstr "" + +msgid "The class hierarchy for built-in exceptions is:" +msgstr "" + +msgid "" +"BaseException\n" +" ├── BaseExceptionGroup\n" +" ├── GeneratorExit\n" +" ├── KeyboardInterrupt\n" +" ├── SystemExit\n" +" └── Exception\n" +" ├── ArithmeticError\n" +" │ ├── FloatingPointError\n" +" │ ├── OverflowError\n" +" │ └── ZeroDivisionError\n" +" ├── AssertionError\n" +" ├── AttributeError\n" +" ├── BufferError\n" +" ├── EOFError\n" +" ├── ExceptionGroup [BaseExceptionGroup]\n" +" ├── ImportError\n" +" │ └── ModuleNotFoundError\n" +" ├── LookupError\n" +" │ ├── IndexError\n" +" │ └── KeyError\n" +" ├── MemoryError\n" +" ├── NameError\n" +" │ └── UnboundLocalError\n" +" ├── OSError\n" +" │ ├── BlockingIOError\n" +" │ ├── ChildProcessError\n" +" │ ├── ConnectionError\n" +" │ │ ├── BrokenPipeError\n" +" │ │ ├── ConnectionAbortedError\n" +" │ │ ├── ConnectionRefusedError\n" +" │ │ └── ConnectionResetError\n" +" │ ├── FileExistsError\n" +" │ ├── FileNotFoundError\n" +" │ ├── InterruptedError\n" +" │ ├── IsADirectoryError\n" +" │ ├── NotADirectoryError\n" +" │ ├── PermissionError\n" +" │ ├── ProcessLookupError\n" +" │ └── TimeoutError\n" +" ├── ReferenceError\n" +" ├── RuntimeError\n" +" │ ├── NotImplementedError\n" +" │ ├── PythonFinalizationError\n" +" │ └── RecursionError\n" +" ├── StopAsyncIteration\n" +" ├── StopIteration\n" +" ├── SyntaxError\n" +" │ └── IndentationError\n" +" │ └── TabError\n" +" ├── SystemError\n" +" ├── TypeError\n" +" ├── ValueError\n" +" │ └── UnicodeError\n" +" │ ├── UnicodeDecodeError\n" +" │ ├── UnicodeEncodeError\n" +" │ └── UnicodeTranslateError\n" +" └── Warning\n" +" ├── BytesWarning\n" +" ├── DeprecationWarning\n" +" ├── EncodingWarning\n" +" ├── FutureWarning\n" +" ├── ImportWarning\n" +" ├── PendingDeprecationWarning\n" +" ├── ResourceWarning\n" +" ├── RuntimeWarning\n" +" ├── SyntaxWarning\n" +" ├── UnicodeWarning\n" +" └── UserWarning\n" +msgstr "" + +msgid "statement" +msgstr "instrukcja" + +msgid "try" +msgstr "" + +msgid "except" +msgstr "" + +msgid "raise" +msgstr "" + +msgid "exception" +msgstr "" + +msgid "chaining" +msgstr "" + +msgid "__cause__ (exception attribute)" +msgstr "" + +msgid "__context__ (exception attribute)" +msgstr "" + +msgid "__suppress_context__ (exception attribute)" +msgstr "" + +msgid "assert" +msgstr "" + +msgid "module" +msgstr "moduł" + +msgid "errno" +msgstr "" diff --git a/builtins/functions.po b/builtins/functions.po new file mode 100644 index 0000000000..b66efa8cae --- /dev/null +++ b/builtins/functions.po @@ -0,0 +1,4140 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-09-13 18:06+0000\n" +"Last-Translator: Maciej Olko, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Functions" +msgstr "Wbudowane funkcje" + +msgid "" +"The Python interpreter has a number of functions and types built into it " +"that are always available. They are listed here in alphabetical order." +msgstr "" +"Interpreter Pythona ma wbudowane wiele funkcji i typów, które zawsze są " +"dostępne. Spisane są tutaj w kolejności alfabetycznej." + +msgid "**A**" +msgstr "**A**" + +msgid ":func:`abs`" +msgstr ":func:`abs`" + +msgid ":func:`aiter`" +msgstr ":func:`aiter`" + +msgid ":func:`all`" +msgstr ":func:`all`" + +msgid ":func:`anext`" +msgstr ":func:`anext`" + +msgid ":func:`any`" +msgstr ":func:`any`" + +msgid ":func:`ascii`" +msgstr ":func:`ascii`" + +msgid "**B**" +msgstr "**B**" + +msgid ":func:`bin`" +msgstr ":func:`bin`" + +msgid ":func:`bool`" +msgstr ":func:`bool`" + +msgid ":func:`breakpoint`" +msgstr ":func:`breakpoint`" + +msgid "|func-bytearray|_" +msgstr "|func-bytearray|_" + +msgid "|func-bytes|_" +msgstr "|func-bytes|_" + +msgid "**C**" +msgstr "**C**" + +msgid ":func:`callable`" +msgstr ":func:`callable`" + +msgid ":func:`chr`" +msgstr ":func:`chr`" + +msgid ":func:`classmethod`" +msgstr ":func:`classmethod`" + +msgid ":func:`compile`" +msgstr ":func:`compile`" + +msgid ":func:`complex`" +msgstr ":func:`complex`" + +msgid "**D**" +msgstr "**D**" + +msgid ":func:`delattr`" +msgstr ":func:`delattr`" + +msgid "|func-dict|_" +msgstr "|func-dict|_" + +msgid ":func:`dir`" +msgstr ":func:`dir`" + +msgid ":func:`divmod`" +msgstr ":func:`divmod`" + +msgid "**E**" +msgstr "**E**" + +msgid ":func:`enumerate`" +msgstr ":func:`enumerate`" + +msgid ":func:`eval`" +msgstr ":func:`eval`" + +msgid ":func:`exec`" +msgstr ":func:`exec`" + +msgid "**F**" +msgstr "**F**" + +msgid ":func:`filter`" +msgstr ":func:`filter`" + +msgid ":func:`float`" +msgstr ":func:`float`" + +msgid ":func:`format`" +msgstr ":func:`format`" + +msgid "|func-frozenset|_" +msgstr "|func-frozenset|_" + +msgid "**G**" +msgstr "**G**" + +msgid ":func:`getattr`" +msgstr ":func:`getattr`" + +msgid ":func:`globals`" +msgstr ":func:`globals`" + +msgid "**H**" +msgstr "**H**" + +msgid ":func:`hasattr`" +msgstr ":func:`hasattr`" + +msgid ":func:`hash`" +msgstr ":func:`hash`" + +msgid ":func:`help`" +msgstr ":func:`help`" + +msgid ":func:`hex`" +msgstr ":func:`hex`" + +msgid "**I**" +msgstr "**I**" + +msgid ":func:`id`" +msgstr ":func:`id`" + +msgid ":func:`input`" +msgstr ":func:`input`" + +msgid ":func:`int`" +msgstr ":func:`int`" + +msgid ":func:`isinstance`" +msgstr ":func:`isinstance`" + +msgid ":func:`issubclass`" +msgstr ":func:`issubclass`" + +msgid ":func:`iter`" +msgstr ":func:`iter`" + +msgid "**L**" +msgstr "**L**" + +msgid ":func:`len`" +msgstr ":func:`len`" + +msgid "|func-list|_" +msgstr "|func-list|_" + +msgid ":func:`locals`" +msgstr ":func:`locals`" + +msgid "**M**" +msgstr "**M**" + +msgid ":func:`map`" +msgstr ":func:`map`" + +msgid ":func:`max`" +msgstr ":func:`max`" + +msgid "|func-memoryview|_" +msgstr "|func-memoryview|_" + +msgid ":func:`min`" +msgstr ":func:`min`" + +msgid "**N**" +msgstr "**N**" + +msgid ":func:`next`" +msgstr ":func:`next`" + +msgid "**O**" +msgstr "**O**" + +msgid ":func:`object`" +msgstr ":func:`object`" + +msgid ":func:`oct`" +msgstr ":func:`oct`" + +msgid ":func:`open`" +msgstr ":func:`open`" + +msgid ":func:`ord`" +msgstr ":func:`ord`" + +msgid "**P**" +msgstr "**P**" + +msgid ":func:`pow`" +msgstr ":func:`pow`" + +msgid ":func:`print`" +msgstr ":func:`print`" + +msgid ":func:`property`" +msgstr ":func:`property`" + +msgid "**R**" +msgstr "**R**" + +msgid "|func-range|_" +msgstr "|func-range|_" + +msgid ":func:`repr`" +msgstr ":func:`repr`" + +msgid ":func:`reversed`" +msgstr ":func:`reversed`" + +msgid ":func:`round`" +msgstr ":func:`round`" + +msgid "**S**" +msgstr "**S**" + +msgid "|func-set|_" +msgstr "|func-set|_" + +msgid ":func:`setattr`" +msgstr ":func:`setattr`" + +msgid ":func:`slice`" +msgstr ":func:`slice`" + +msgid ":func:`sorted`" +msgstr ":func:`sorted`" + +msgid ":func:`staticmethod`" +msgstr ":func:`staticmethod`" + +msgid "|func-str|_" +msgstr "|func-str|_" + +msgid ":func:`sum`" +msgstr ":func:`sum`" + +msgid ":func:`super`" +msgstr ":func:`super`" + +msgid "**T**" +msgstr "**T**" + +msgid "|func-tuple|_" +msgstr "|func-tuple|_" + +msgid ":func:`type`" +msgstr ":func:`type`" + +msgid "**V**" +msgstr "**V**" + +msgid ":func:`vars`" +msgstr ":func:`vars`" + +msgid "**Z**" +msgstr "**Z**" + +msgid ":func:`zip`" +msgstr ":func:`zip`" + +msgid "**_**" +msgstr "**_**" + +msgid ":func:`__import__`" +msgstr ":func:`__import__`" + +msgid "" +"Return the absolute value of a number. The argument may be an integer, a " +"floating-point number, or an object implementing :meth:`~object.__abs__`. If " +"the argument is a complex number, its magnitude is returned." +msgstr "" +"Zwraca wartość bezwzględną liczby. Argument może być liczbą całkowitą, " +"zmiennoprzecinkową lub obiektem implementującym :meth:`~object.__abs__`. " +"Jeśli argument jest liczbą zespoloną, zwracany jest jej moduł." + +msgid "" +"Return an :term:`asynchronous iterator` for an :term:`asynchronous " +"iterable`. Equivalent to calling ``x.__aiter__()``." +msgstr "" +"Zwraca :term:`asynchroniczny iterator ` " +"dla :term:`asynchronicznego iterable'a `. Ekwiwalent " +"wywołania ``x.__aiter__()``." + +msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant." +msgstr "" +"Uwaga: W przeciwieństwie do :func:`iter`, :func:`aiter` nie ma " +"dwuargumentowego wariantu." + +msgid "" +"Return ``True`` if all elements of the *iterable* are true (or if the " +"iterable is empty). Equivalent to::" +msgstr "" +"Zwraca ``True`` jeśli wszystkie elementy *iterable*'a są prawdziwe (lub " +"jeśli iterable jest pusty). Ekwiwalent kodu::" + +msgid "" +"def all(iterable):\n" +" for element in iterable:\n" +" if not element:\n" +" return False\n" +" return True" +msgstr "" +"def all(iterable):\n" +" for element in iterable:\n" +" if not element:\n" +" return False\n" +" return True" + +msgid "" +"When awaited, return the next item from the given :term:`asynchronous " +"iterator`, or *default* if given and the iterator is :term:`exhausted`." +msgstr "" +"W przypadku oczekiwania zwraca następny element z " +"podanego :term:`asynchronicznego iteratora ` lub " +"wartość *default*, jeżeli jest ona podana, a iterator " +"został :term:`wyczerpany `." + +msgid "" +"This is the async variant of the :func:`next` builtin, and behaves similarly." +msgstr "" +"Jest to asynchroniczny wariant wbudowanej funkcji :func:`next` i zachowuje " +"się podobnie." + +msgid "" +"This calls the :meth:`~object.__anext__` method of *async_iterator*, " +"returning an :term:`awaitable`. Awaiting this returns the next value of the " +"iterator. If *default* is given, it is returned if the iterator is " +"exhausted, otherwise :exc:`StopAsyncIteration` is raised." +msgstr "" +"Wywołuje on metodę :meth:`~object.__anext__` *async_iteratora*, " +"zwracając :term:`awaitable`. Oczekiwanie zwraca następną wartość iteratora. " +"Jeśli podano wartość *default*, jest ona zwracana, jeśli iterator zostanie " +"wyczerpany, w przeciwnym razie zostanie podniesiony " +"wyjątek :exc:`StopAsyncIteration`." + +msgid "" +"Return ``True`` if any element of the *iterable* is true. If the iterable " +"is empty, return ``False``. Equivalent to::" +msgstr "" +"Zwraca ``True`` jeśli jakikolwiek element *iterable*'a jest prawdziwy. Jeśli " +"iterable jest pusty, zwraca ``False``. Ekwiwalent kodu::" + +msgid "" +"def any(iterable):\n" +" for element in iterable:\n" +" if element:\n" +" return True\n" +" return False" +msgstr "" +"def any(iterable):\n" +" for element in iterable:\n" +" if element:\n" +" return True\n" +" return False" + +msgid "" +"As :func:`repr`, return a string containing a printable representation of an " +"object, but escape the non-ASCII characters in the string returned " +"by :func:`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates " +"a string similar to that returned by :func:`repr` in Python 2." +msgstr "" +"Tak jak :func:`repr`, zwraca ciąg znaków zawierający reprezentację obiektu, " +"ale wypisuje znaki nie-ASCII w zwracanym przez :func:`repr` ciągu przy " +"użyciu escape'ów ``\\x``, ``\\u`` lub ``\\U``. Generuje ciąg znaków podobny " +"do tego zwracanego przez :func:`repr` w Pythonie 2." + +msgid "" +"Convert an integer number to a binary string prefixed with \"0b\". The " +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. Some examples:" +msgstr "" +"Konwertuje liczbę całkowitą do binarnego ciągu znaków z prefiksem „0b”. " +"Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int`, musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Kilka przykładów:" + +msgid "" +"If the prefix \"0b\" is desired or not, you can use either of the following " +"ways." +msgstr "" +"Jeśli prefiks „0b” nie jest pożądany, możesz użyć któregoś z poniższych " +"sposobów." + +msgid "" +"See also :func:`enum.bin` to represent negative values as twos-complement." +msgstr "" +"Patrz również :func:`enum.bin` do reprezentowania ujemnych wartości w kodzie " +"uzupełnień do dwóch." + +msgid "See also :func:`format` for more information." +msgstr "Zobacz też :func:`format` by uzyskać więcej informacji." + +msgid "" +"Return a Boolean value, i.e. one of ``True`` or ``False``. The argument is " +"converted using the standard :ref:`truth testing procedure `. If the " +"argument is false or omitted, this returns ``False``; otherwise, it returns " +"``True``. The :class:`bool` class is a subclass of :class:`int` " +"(see :ref:`typesnumeric`). It cannot be subclassed further. Its only " +"instances are ``False`` and ``True`` (see :ref:`typebool`)." +msgstr "" +"Zwraca wartość logiczną, tj. jedno z ``True`` lub ``False``. Wartość " +"argumentu jest konwertowana przy użyciu standardowej procedury " +"testowania :ref:`truth testing procedure`. Jeśli argument jest " +"fałszywy lub pominięty, zwraca ``False``; w przeciwnym razie, zwraca " +"``True``. Klasa :class:`bool` jest podklasą klasy :class:`int` " +"(zobacz :ref:`typesnumeric`). Nie może być dalej podklasowana. Jej jedynymi " +"instancjami są ``False`` i ``True`` (zobacz :ref:`typebool`)." + +msgid "The parameter is now positional-only." +msgstr "Parametr jest teraz tylko-pozycyjny." + +msgid "" +"This function drops you into the debugger at the call site. Specifically, " +"it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight " +"through. By default, ``sys.breakpointhook()`` calls :func:`pdb.set_trace` " +"expecting no arguments. In this case, it is purely a convenience function " +"so you don't have to explicitly import :mod:`pdb` or type as much code to " +"enter the debugger. However, :func:`sys.breakpointhook` can be set to some " +"other function and :func:`breakpoint` will automatically call that, allowing " +"you to drop into the debugger of choice. If :func:`sys.breakpointhook` is " +"not accessible, this function will raise :exc:`RuntimeError`." +msgstr "" +"Ta funkcja powoduje przejście do debuggera w miejscu wywołania. W " +"szczególności wywołuje :func:`sys.breakpointhook`, przekazując do niego " +"bezpośrednio ``args`` i ``kws``. Domyślnie ``sys.breakpointhook()`` wywołuje " +"funkcję :func:`pdb.set_trace` nie oczekującą argumentu. W tym przypadku jest " +"to wyłącznie funkcja dla wygody, aby nie trzeba było jawnie " +"importować :mod:`pdb` ani wpisywać tak dużo kodu, aby wejść do debuggera. " +"Jednakże :func:`sys.breakpointhook` może być ustawiony na inną funkcję " +"i :func:`breakpoint` automatycznie wywoła ją, pozwalając na przejście do " +"wybranego debuggera. Jeśli :func:`sys.breakpointhook` nie jest dostępny, " +"funkcja rzuci :exc:`RuntimeError`." + +msgid "" +"By default, the behavior of :func:`breakpoint` can be changed with " +"the :envvar:`PYTHONBREAKPOINT` environment variable. " +"See :func:`sys.breakpointhook` for usage details." +msgstr "" +"Domyślnie zachowanie funkcji :func:`breakpoint` można zmienić za pomocą " +"zmiennej środowiskowej :envvar:`PYTHONBREAKPOINT`. Szczegółowe informacje " +"można znaleźć w :func:`sys.breakpointhook`." + +msgid "" +"Note that this is not guaranteed if :func:`sys.breakpointhook` has been " +"replaced." +msgstr "" +"Należy pamiętać, że nie jest to gwarantowane, " +"jeśli :func:`sys.breakpointhook` został wymieniony." + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " +"argument ``breakpointhook``." +msgstr "" +"Rzuca :ref:`auditing event ` ``builtins.breakpoint`` z argumentem " +"``breakpointhook``." + +msgid "" +"Return a new array of bytes. The :class:`bytearray` class is a mutable " +"sequence of integers in the range 0 <= x < 256. It has most of the usual " +"methods of mutable sequences, described in :ref:`typesseq-mutable`, as well " +"as most methods that the :class:`bytes` type has, see :ref:`bytes-methods`." +msgstr "" +"Zwraca nową tablicę bajtów. Klasa :class:`bytearray` jest mutowalną " +"sekwencją liczb całkowitych w zakresie 0 <= x < 256. Ma większość metod " +"mutowalnych sekwencji, opisanych w :ref:`typesseq-mutable`, jak również " +"większość metod, które ma typ :class:`bytes`, patrz :ref:`bytes-methods`." + +msgid "" +"The optional *source* parameter can be used to initialize the array in a few " +"different ways:" +msgstr "" +"Opcjonalny parametr *source* może być użyty do inicjalizacji tablicy na " +"kilka różnych sposobów:" + +msgid "" +"If it is a *string*, you must also give the *encoding* (and optionally, " +"*errors*) parameters; :func:`bytearray` then converts the string to bytes " +"using :meth:`str.encode`." +msgstr "" +"Jeśli jest *stringiem*, musisz podać również parametr *encoding* (i " +"opcjonalnie *errors*); :func:`bytearray` konwertuje string na bajty " +"używając :meth:`str.encode`." + +msgid "" +"If it is an *integer*, the array will have that size and will be initialized " +"with null bytes." +msgstr "" +"Jeśli jest *liczbą całkowitą*, tablica będzie miała taki rozmiar i będzie " +"zainicjowana bajtami zerowymi." + +msgid "" +"If it is an object conforming to the :ref:`buffer interface " +"`, a read-only buffer of the object will be used to " +"initialize the bytes array." +msgstr "" +"Jeśli jest to obiekt spełniający :ref:`interfejs bufora `, " +"bufor tylko-do-odczytu obiektu zostanie użyty do zainicjowania tablicy " +"bajtów." + +msgid "" +"If it is an *iterable*, it must be an iterable of integers in the range ``0 " +"<= x < 256``, which are used as the initial contents of the array." +msgstr "" +"Jeśli jest *iterablem*, musi być iterablem składającym się z liczb " +"całkowitych w zakresie ``0 <= x < 256``, które są użyte do zainicjowania " +"tablicy." + +msgid "Without an argument, an array of size 0 is created." +msgstr "Bez argumentu tworzona jest tablica o rozmiarze 0." + +msgid "See also :ref:`binaryseq` and :ref:`typebytearray`." +msgstr "Zobacz też :ref:`binaryseq` i :ref:`typebytearray`." + +msgid "" +"Return a new \"bytes\" object which is an immutable sequence of integers in " +"the range ``0 <= x < 256``. :class:`bytes` is an immutable version " +"of :class:`bytearray` -- it has the same non-mutating methods and the same " +"indexing and slicing behavior." +msgstr "" +"Zwraca nowy obiekt „bajtów”, który jest niemutowalną sekwencją liczb " +"całkowitych z zakresu ``0 <= x < 256``. :class:`bytes` jest niemutowalną " +"wersją :class:`bytearray` -- ma te same niemutujące metody i to samo " +"zachowanie indeksowania i slice'owania." + +msgid "" +"Accordingly, constructor arguments are interpreted as for :func:`bytearray`." +msgstr "" +"Argumenty konstruktora są interpretowane tak jak dla :func:`bytearray`." + +msgid "Bytes objects can also be created with literals, see :ref:`strings`." +msgstr "" +"Obiekty bytes mogą być również tworzone z literałami, patrz :ref:`strings`." + +msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`." +msgstr "Zobacz też :ref:`binaryseq`, :ref:`typebytes` i :ref:`bytes-methods`." + +msgid "" +"Return :const:`True` if the *object* argument appears " +"callable, :const:`False` if not. If this returns ``True``, it is still " +"possible that a call fails, but if it is ``False``, calling *object* will " +"never succeed. Note that classes are callable (calling a class returns a new " +"instance); instances are callable if their class has " +"a :meth:`~object.__call__` method." +msgstr "" +"Zwraca :const:`True` jeśli argument *object* jest " +"wywoływalny, :const:`False` jeśli nie. Jeśli zwraca ``True``, nadal możliwe " +"jest, że wywołanie nie powiedzie się, ale jeśli zwraca ``False``, wywołanie " +"*object* nigdy się nie powiedzie. Należy pamiętać, że klasy są wywoływalne " +"(wywołanie klasy zwraca nową instancję); instancje są wywoływalne, jeśli ich " +"klasa ma metodę :meth:`~object.__call__`." + +msgid "" +"This function was first removed in Python 3.0 and then brought back in " +"Python 3.2." +msgstr "" +"Ta funkcja była wpierw usunięta w Pythonie 3.0 a następnie przywrócona w " +"Pythonie 3.2." + +msgid "" +"Return the string representing a character with the specified Unicode code " +"point. For example, ``chr(97)`` returns the string ``'a'``, while " +"``chr(8364)`` returns the string ``'€'``. This is the inverse of :func:`ord`." +msgstr "" +"Zwraca ciąg znaków reprezentujący znak dla podanego punktu kodowego Unicode. " +"Na przykład ``chr(97)`` zwraca ciąg znaków ``'a'``, a ``chr(8364)`` zwraca " +"ciąg ``'€'``. Jest odwrotnością :func:`ord`." + +msgid "" +"The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in " +"base 16). :exc:`ValueError` will be raised if it is outside that range." +msgstr "" +"Poprawnym zakresem argumentu są wartości od 0 do 1 114 111 (0x10FFFF w " +"systemie szesnastkowym). Dla wartości poza tym zakresem zostanie " +"rzucony :exc:`ValueError`." + +msgid "Transform a method into a class method." +msgstr "Przekształca metodę w metodę klasową." + +msgid "" +"A class method receives the class as an implicit first argument, just like " +"an instance method receives the instance. To declare a class method, use " +"this idiom::" +msgstr "" +"Metoda klasowa otrzymuje klasę jako niejawny pierwszy argument, podobnie jak " +"metoda instancji otrzymuje instancję. Aby zadeklarować metodę klasową, użyj " +"tego idiomu::" + +msgid "" +"class C:\n" +" @classmethod\n" +" def f(cls, arg1, arg2): ..." +msgstr "" +"class C:\n" +" @classmethod\n" +" def f(cls, arg1, arg2): ..." + +msgid "" +"The ``@classmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." +msgstr "" +"Forma ``@classmethod`` jest :term:`dekoratorem ` funkcji – " +"szczegóły znajdziesz w :ref:`function`." + +msgid "" +"A class method can be called either on the class (such as ``C.f()``) or on " +"an instance (such as ``C().f()``). The instance is ignored except for its " +"class. If a class method is called for a derived class, the derived class " +"object is passed as the implied first argument." +msgstr "" +"Metoda klasowa może być wywoływana albo na klasie (na przykład ``C.f()``) " +"albo na instancji (na przykład ``C().f()``). Instancja jest ignorowana, " +"brana jest pod uwagę tylko jej klasa. Jeśli metoda klasowa jest wywołana dla " +"klasy dziedziczącej, obiekt klasy dziedziczącej jest przekazywany jako " +"pierwszy argument." + +msgid "" +"Class methods are different than C++ or Java static methods. If you want " +"those, see :func:`staticmethod` in this section. For more information on " +"class methods, see :ref:`types`." +msgstr "" +"Metody klasowe różnią się od statycznych metod C++ lub Javy. Jeśli chcesz " +"takie, sprawdź :func:`staticmethod` w tej sekcji. Więcej informacji o " +"metodach klasowych znajdziesz w :ref:`types`." + +msgid "" +"Class methods can now wrap other :term:`descriptors ` such " +"as :func:`property`." +msgstr "" +"Metody klasowe mogą teraz opakowywać inne :term:`deskryptory `, " +"takie jak :func:`property`." + +msgid "" +"Class methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`) and have a new ``__wrapped__`` " +"attribute." +msgstr "" +"Metody klasowe dziedziczą teraz atrybuty metod " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`) i mają nowy atrybut ``__wrapped__``." + +msgid "" +"Class methods can no longer wrap other :term:`descriptors ` such " +"as :func:`property`." +msgstr "" +"Metody klas nie mogą już opakowywać innych :term:`deskryptorów ` " +"takich jak :func:`property`." + +msgid "" +"Compile the *source* into a code or AST object. Code objects can be " +"executed by :func:`exec` or :func:`eval`. *source* can either be a normal " +"string, a byte string, or an AST object. Refer to the :mod:`ast` module " +"documentation for information on how to work with AST objects." +msgstr "" +"Kompiluje *source* do obiektu kodu lub obiektu AST. Obiekty kodu mogą wyć " +"wykonywane przy użyciu :func:`exec` lub :func:`eval`. *source* może być " +"zwykłym ciągiem znaków, ciągiem bajtów lub obiektem AST. W dokumentacji " +"modułu :mod:`ast` znajdziesz informacje o tym jak pracować z obiektami AST." + +msgid "" +"The *filename* argument should give the file from which the code was read; " +"pass some recognizable value if it wasn't read from a file (``''`` " +"is commonly used)." +msgstr "" +"Argument *filename* powinien dawać plik, z którego kod został przeczytany; " +"przekaż jakąś rozpoznawalną wartość, jeśli nie został przeczytany z pliku " +"(często używa się ``''``)." + +msgid "" +"The *mode* argument specifies what kind of code must be compiled; it can be " +"``'exec'`` if *source* consists of a sequence of statements, ``'eval'`` if " +"it consists of a single expression, or ``'single'`` if it consists of a " +"single interactive statement (in the latter case, expression statements that " +"evaluate to something other than ``None`` will be printed). It can also be " +"``'func_type'`` if *source* consists of a function type signature, for " +"example ``(int) -> str``; see :func:`ast.parse` for more information. This " +"mode requires passing :data:`ast.PyCF_ONLY_AST` in *flags*." +msgstr "" +"Argument *mode* określa, jaki rodzaj kodu ma zostać skompilowany; może mieć " +"wartość ``'exec'`` jeśli *source* składa się z sekwencji instrukcji, " +"``'eval'`` jeśli składa się z jednego wyrażenia lub ``'single'`` jeśli " +"składa się z jednej interaktywnej instrukcji (w ostatnim przypadku, " +"instrukcje wyrażeń, które ewaluują się do czegoś innego niż ``None``, " +"zostaną wydrukowane na standardowe wyjście). Może mieć również wartość " +"``'func_type'``, jeśli *source* składa się z sygnatury typu funkcji, na " +"przykład ``(int) -> str``; więcej informacji można znaleźć " +"w :func:`ast.parse`. Tryb ten wymaga przekazania :data:`ast.PyCF_ONLY_AST` w " +"argumencie *flags*." + +msgid "" +"The optional arguments *flags* and *dont_inherit* control " +"which :ref:`compiler options ` should be activated and " +"which :ref:`future features ` should be allowed. If neither is " +"present (or both are zero) the code is compiled with the same flags that " +"affect the code that is calling :func:`compile`. If the *flags* argument is " +"given and *dont_inherit* is not (or is zero) then the compiler options and " +"the future statements specified by the *flags* argument are used in addition " +"to those that would be used anyway. If *dont_inherit* is a non-zero integer " +"then the *flags* argument is it -- the flags (future features and compiler " +"options) in the surrounding code are ignored." +msgstr "" +"Opcjonalne argumenty *flags* i *dont_inherit* kontrolują, które :ref:`opcje " +"kompilatora ` powinny być aktywowane i " +"które :ref:`przyszłe funkcje ` powinne być dozwolone. Jeśli żaden z " +"nich nie jest obecny (lub oba są zerowe), kod jest kompilowany z tymi samymi " +"flagami, które wpływają na kod wywołujący :func:`compile`. Jeśli argument " +"*flags* jest podany, a *dont_inherit* nie jest (lub wynosi zero), to opcje " +"kompilatora i przyszłe instrukcje określone przez argument *flags* są " +"używane w dodatku do tych, które i tak byłyby użyte. Jeśli *dont_inherit* " +"jest niezerową liczbą całkowitą, to argument *flags* jest nim – flagi " +"(przyszłe funkcje i opcje kompilatora) w otaczającym kodzie są ignorowane." + +msgid "" +"Compiler options and future statements are specified by bits which can be " +"bitwise ORed together to specify multiple options. The bitfield required to " +"specify a given future feature can be found as " +"the :attr:`~__future__._Feature.compiler_flag` attribute on " +"the :class:`~__future__._Feature` instance in the :mod:`__future__` " +"module. :ref:`Compiler flags ` can be found " +"in :mod:`ast` module, with ``PyCF_`` prefix." +msgstr "" +"Opcje kompilatora i przyszłe instrukcja są określone przez bity, które mogą " +"być łączone bitowo w celu określenia wielu opcji. Pole bitowe wymagane do " +"określenia danej przyszłej funkcji można znaleźć " +"jako :attr:`~__future__._Feature.compiler_flag` atrybut na " +"instancji :class:`~__future__._Feature` w " +"module :mod:`__future__` . :ref:`Flagi kompilatora ` " +"można znaleźć w module :mod:`ast` , z prefiksem ``PyCF_``." + +msgid "" +"The argument *optimize* specifies the optimization level of the compiler; " +"the default value of ``-1`` selects the optimization level of the " +"interpreter as given by :option:`-O` options. Explicit levels are ``0`` (no " +"optimization; ``__debug__`` is true), ``1`` (asserts are removed, " +"``__debug__`` is false) or ``2`` (docstrings are removed too)." +msgstr "" +"Wartość argumentu *optimize* określa poziom optymalizacji kompilatora; " +"wartość domyślna ``-1`` wybiera poziom optymalizacji interpretera podany " +"przez opcje :option:`-O`. Wyraźne poziomy to ``0`` (brak optymalizacji; " +"``__debug__`` to prawda), ``1`` (asercje są usuwane, ``__debug__`` to fałsz) " +"lub ``2`` (docstrings są również usuwane)." + +msgid "" +"This function raises :exc:`SyntaxError` if the compiled source is invalid, " +"including a *source* containing a null character or that cannot be " +"decoded; :exc:`ValueError` if *mode* or *flags* is invalid, or if a string " +"*source* contains surrogate characters; :exc:`MemoryError` " +"or :exc:`RecursionError` if *source* is too complex to parse or compile, for " +"example an expression with many thousands of nested operators; " +"and :exc:`OverflowError` if *source* is too large." +msgstr "" +"Funkcja rzuca :exc:`SyntaxError`, jeśli skompilowany kod źródłowy jest " +"nieprawidłowy, w tym jeśli *source* zawiera znak null lub nie można go " +"zdekodować; :exc:`ValueError` jeśli *mode* lub *flags* są nieprawidłowe, lub " +"jeśli ciąg znaków *source* zawiera znaki zastępcze; :exc:`MemoryError` " +"lub :exc:`RecursionError`, jeśli *source* jest zbyt złożone, by można było " +"je przeanalizować lub skompilować, na przykład wyrażenie zawierające wiele " +"tysięcy zagnieżdżonych operatorów; oraz :exc:`OverflowError`, jeśli *source* " +"jest zbyt duże." + +msgid "" +"If you want to parse Python code into its AST representation, " +"see :func:`ast.parse`." +msgstr "" +"Jeśli chcesz przeanalizować kod Python do jego reprezentacji AST, " +"zobacz :func:`ast.parse`." + +msgid "" +"Raises an :ref:`auditing event ` ``compile`` with arguments " +"``source`` and ``filename``. This event may also be raised by implicit " +"compilation." +msgstr "" +"Rzuci zdarzenie :ref:`auditing ` ``compile`` z argumentem " +"``source`` i ``filename``. To zdarzenie może być również rzucone przez " +"niejawną kompilację." + +msgid "" +"When compiling a string with multi-line code in ``'single'`` or ``'eval'`` " +"mode, input must be terminated by at least one newline character. This is " +"to facilitate detection of incomplete and complete statements in " +"the :mod:`code` module." +msgstr "" +"Podczas kompilacji napisem z kodem wielowierszowym w trybie ``'single'`` lub " +"``'eval'``, dane wejściowe muszą być zakończone co najmniej jedną znak nowej " +"lini. Ma to na celu ułatwienie wykrywania niekompletnych i kompletnych " +"instrukcja w module :mod:`code` ." + +msgid "" +"It is possible to crash the Python interpreter with a sufficiently large/" +"complex string when compiling to an AST object due to stack depth " +"limitations in Python's AST compiler." +msgstr "" +"Możliwe jest zawieszenie interpretera Python z wystarczająco dużym/złożonym " +"napisem podczas kompilacji do obiektu AST z powodu ograniczeń głębokości " +"stosu w kompilatorze AST Python." + +msgid "" +"Allowed use of Windows and Mac newlines. Also, input in ``'exec'`` mode " +"does not have to end in a newline anymore. Added the *optimize* parameter." +msgstr "" +"Zezwolono na używanie nowej linii w systemach Windows i Mac. Ponadto " +"wprowadzanie danych w trybie ``'exec'`` nie musi już kończyć się nową " +"linią. Dodano funkcję *optimize* parametr." + +msgid "" +"Previously, :exc:`TypeError` was raised when null bytes were encountered in " +"*source*." +msgstr "" +"Poprzednio, :exc:`TypeError` został rzucony gdy napotkano bajty null w " +"*source*." + +msgid "" +"``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` can now be passed in flags to enable " +"support for top-level ``await``, ``async for``, and ``async with``." +msgstr "" +"``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` można teraz przekazywać we flagach, aby " +"włączyć obsługę najwyższego poziomu ``await``, ``async for`` i ``async " +"with``." + +msgid "Added support for ``mode='func_type'``." +msgstr "Dodane wsparcie dla ``mode='func_type'``." + +msgid "" +":exc:`SyntaxError` is raised instead of :exc:`ValueError` when null bytes " +"are encountered in *source*." +msgstr "" +":exc:`SyntaxError` jest rzucane zamiast :exc:`ValueError`, gdy w *source* " +"napotkano bajty null." + +msgid "" +"Convert a single string or number to a complex number, or create a complex " +"number from real and imaginary parts." +msgstr "" +"Konwertowanie pojedynczego napisu lub liczby na liczba zespolona lub " +"tworzenie liczba zespolona z części rzeczywistej i urojonej." + +msgid "Examples:" +msgstr "Przykłady:" + +msgid "" +">>> complex('+1.23')\n" +"(1.23+0j)\n" +">>> complex('-4.5j')\n" +"-4.5j\n" +">>> complex('-1.23+4.5j')\n" +"(-1.23+4.5j)\n" +">>> complex('\\t( -1.23+4.5J )\\n')\n" +"(-1.23+4.5j)\n" +">>> complex('-Infinity+NaNj')\n" +"(-inf+nanj)\n" +">>> complex(1.23)\n" +"(1.23+0j)\n" +">>> complex(imag=-4.5)\n" +"-4.5j\n" +">>> complex(-1.23, 4.5)\n" +"(-1.23+4.5j)" +msgstr "" +">>> complex('+1.23')\n" +"(1.23+0j)\n" +">>> complex('-4.5j')\n" +"-4.5j\n" +">>> complex('-1.23+4.5j')\n" +"(-1.23+4.5j)\n" +">>> complex('\\t( -1.23+4.5J )\\n')\n" +"(-1.23+4.5j)\n" +">>> complex('-Infinity+NaNj')\n" +"(-inf+nanj)\n" +">>> complex(1.23)\n" +"(1.23+0j)\n" +">>> complex(imag=-4.5)\n" +"-4.5j\n" +">>> complex(-1.23, 4.5)\n" +"(-1.23+4.5j)" + +msgid "" +"If the argument is a string, it must contain either a real part (in the same " +"format as for :func:`float`) or an imaginary part (in the same format but " +"with a ``'j'`` or ``'J'`` suffix), or both real and imaginary parts (the " +"sign of the imaginary part is mandatory in this case). The string can " +"optionally be surrounded by whitespaces and the round parentheses ``'('`` " +"and ``')'``, which are ignored. The string must not contain whitespace " +"between ``'+'``, ``'-'``, the ``'j'`` or ``'J'`` suffix, and the decimal " +"number. For example, ``complex('1+2j')`` is fine, but ``complex('1 + 2j')`` " +"raises :exc:`ValueError`. More precisely, the input must conform to " +"the :token:`~float:complexvalue` production rule in the following grammar, " +"after parentheses and leading and trailing whitespace characters are removed:" +msgstr "" +"Jeśli argument jest napisem, musi zawierać albo część rzeczywistą (w tym " +"samym formacie co :func:`float`), albo część urojoną (w tym samym formacie, " +"ale z przyrostkiem ``'j'`` lub ``'J'`` ), albo zarówno część rzeczywistą, " +"jak i urojoną (znak części urojonej jest w tym przypadku obowiązkowy). " +"Wartość napis może być opcjonalnie otoczona białymi znakami i okrągłymi " +"nawiasami ``'('`` i ``')'``, które są ignorowane. napis nie może zawierać " +"białych znaków między ``'+'``, ``'-'``, przyrostkiem ``'j'`` lub ``'J'`` a " +"liczbą dziesiętną. Na przykład, ``complex('1+2j')`` jest w porządku, ale " +"``complex('1 + 2j')`` rzuci :exc:`ValueError` . Dokładniej, dane wejściowe " +"muszą być zgodne z regułą produkcji :token:`~float:complexvalue` w poniższej " +"gramatyce, po usunięciu nawiasów oraz początkowych i końcowych znaków:" + +msgid "" +"If the argument is a number, the constructor serves as a numeric conversion " +"like :class:`int` and :class:`float`. For a general Python object ``x``, " +"``complex(x)`` delegates to ``x.__complex__()``. " +"If :meth:`~object.__complex__` is not defined then it falls back " +"to :meth:`~object.__float__`. If :meth:`!__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." +msgstr "" +"Jeśli argument jest liczbą, konstruktor służy jako konwersja numeryczna, " +"podobnie jak :class:`int` i :class:`float`. Dla ogólnego obiektu Python " +"``x`` , ``complex(x)`` deleguje do ``x.__complex__()``. " +"Jeśli :meth:`~object.__complex__` nie jest zdefiniowane, to spada z powrotem " +"do :meth:`~object.__float__`. Jeśli :meth:`!__float__` nie jest " +"zdefiniowane, to spada z powrotem do :meth:`~object.__index__`." + +msgid "" +"If two arguments are provided or keyword arguments are used, each argument " +"may be any numeric type (including complex). If both arguments are real " +"numbers, return a complex number with the real component *real* and the " +"imaginary component *imag*. If both arguments are complex numbers, return a " +"complex number with the real component ``real.real-imag.imag`` and the " +"imaginary component ``real.imag+imag.real``. If one of arguments is a real " +"number, only its real component is used in the above expressions." +msgstr "" +"Jeśli podano dwa argumenty lub argument nazwany, każdy argument może być " +"dowolnego typu liczbowego (w tym liczbą zespoloną). Jeśli oba argumenty są " +"liczbami rzeczywistymi, zwracana jest liczba zespolona ze składnikiem " +"rzeczywistym *real* i składnikiem urojonym *imag*. Jeśli oba argumenty są " +"liczbami zespolonymi, zwracana jest liczba zespolona ze składnikiem " +"rzeczywistym ``real.real-imag.imag`` i składnikiem urojonym " +"``real.imag+imag.real``. Jeśli jeden z argumentów jest liczbą rzeczywistą, w " +"powyższych wyrażeniach używany jest tylko jego składnik rzeczywisty." + +msgid "" +"See also :meth:`complex.from_number` which only accepts a single numeric " +"argument." +msgstr "" +"Zobacz też :meth:`complex.from_number`, która akceptuje tylko jeden argument " +"numeryczny." + +msgid "If all arguments are omitted, returns ``0j``." +msgstr "Jeśli wszystkie argumenty zostaną pominięte, zwraca ``0j`` ." + +msgid "The complex type is described in :ref:`typesnumeric`." +msgstr "Typ Complex został opisany na stronie :ref:`typesnumeric`." + +msgid "Grouping digits with underscores as in code literals is allowed." +msgstr "" +"Dozwolone jest grupowanie cyfr za pomocą podkreślników, tak jak w literałach " +"kodu." + +msgid "" +"Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` " +"and :meth:`~object.__float__` are not defined." +msgstr "" +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__complex__` " +"i :meth:`~object.__float__` nie są zdefiniowane." + +msgid "" +"Passing a complex number as the *real* or *imag* argument is now deprecated; " +"it should only be passed as a single positional argument." +msgstr "" +"Przekazywanie liczby zespolonej przez argumenty *real* lub *imag* jest " +"teraz niezalecane; powinna ona być przekazywana przez pojedynczy argument " +"pozycyjny." + +msgid "" +"This is a relative of :func:`setattr`. The arguments are an object and a " +"string. The string must be the name of one of the object's attributes. The " +"function deletes the named attribute, provided the object allows it. For " +"example, ``delattr(x, 'foobar')`` is equivalent to ``del x.foobar``. *name* " +"need not be a Python identifier (see :func:`setattr`)." +msgstr "" +"Jest to krewny :func:`setattr`. Argumenty są obiektem i napisem. Napis musi " +"być nazwą jednego z atrybut obiektu. Funkcja usuwa nazwany atrybut, pod " +"warunkiem, że obiekt na to pozwala. Na przykład, ``delattr(x, 'foobar')`` " +"jest równoważne ``del x.foobar``. *name* nie musi być identyfikatorem Python " +"(zobacz :func:`setattr`)." + +msgid "" +"Create a new dictionary. The :class:`dict` object is the dictionary class. " +"See also :ref:`typesmapping` for documentation about this class." +msgstr "" +"Tworzy nowy słownik. Obiekt :class:`dict` jest klasą wbudowaną. Zobacz " +"też :ref:`typesmapping` po więcej dokumentacji na temat tej klasy." + +msgid "" +"For other containers see the built-in :class:`list`, :class:`set`, " +"and :class:`tuple` classes, as well as the :mod:`collections` module." +msgstr "" +"Inne kontenery można znaleźć w klasach " +"wbudowanych :class:`list` , :class:`set` i :class:`tuple`, a także " +"moduł :mod:`collections` ." + +msgid "" +"Without arguments, return the list of names in the current local scope. " +"With an argument, attempt to return a list of valid attributes for that " +"object." +msgstr "" +"Bez argumentów, zwraca listę nazw w bieżącym zakresie lokalnym. Z " +"argumentem, próbuje zwrócić listę prawidłowych atrybutów dla tego obiektu." + +msgid "" +"If the object has a method named :meth:`~object.__dir__`, this method will " +"be called and must return the list of attributes. This allows objects that " +"implement a custom :func:`~object.__getattr__` " +"or :func:`~object.__getattribute__` function to customize the " +"way :func:`dir` reports their attributes." +msgstr "" +"Jeśli obiekt posiada metodę o nazwie :meth:`~object.__dir__`, metoda ta " +"zostanie wywołana i musi zwracać listę atrybut. Pozwala to obiektom, które " +"implementują niestandardowe :func:`~object.__getattr__` " +"lub :func:`~object.__getattribute__` funkcje na dostosowanie sposobu, w " +"jaki :func:`dir` zgłasza ich atrybuty." + +msgid "" +"If the object does not provide :meth:`~object.__dir__`, the function tries " +"its best to gather information from the object's :attr:`~object.__dict__` " +"attribute, if defined, and from its type object. The resulting list is not " +"necessarily complete and may be inaccurate when the object has a " +"custom :func:`~object.__getattr__`." +msgstr "" +"Jeśli obiekt nie udostępnia :meth:`~object.__dir__`, funkcja stara się " +"zebrać informacje z :attr:`~object.__dict__` atrybut obiektu, jeśli jest " +"zdefiniowany, oraz z jego obiektu typu. Wynikowa lista niekoniecznie jest " +"kompletna i może być niedokładna, jeśli obiekt ma " +"niestandardowy :func:`~object.__getattr__`." + +msgid "" +"The default :func:`dir` mechanism behaves differently with different types " +"of objects, as it attempts to produce the most relevant, rather than " +"complete, information:" +msgstr "" +"Mechanizm domyślny :func:`dir` zachowuje się inaczej w przypadku różnych " +"typów obiektów, ponieważ stara się uzyskać najbardziej istotne, a nie " +"kompletne informacje:" + +msgid "" +"If the object is a module object, the list contains the names of the " +"module's attributes." +msgstr "" +"Jeśli obiekt jest obiektem moduł, lista zawiera nazwy obiektów moduł " +"atrybutow." + +msgid "" +"If the object is a type or class object, the list contains the names of its " +"attributes, and recursively of the attributes of its bases." +msgstr "" +"Jeśli obiekt jest obiektem typu lub klasy, lista zawiera nazwy jego atrybut " +"i rekurencyjnie atrybut jego baz." + +msgid "" +"Otherwise, the list contains the object's attributes' names, the names of " +"its class's attributes, and recursively of the attributes of its class's " +"base classes." +msgstr "" +"W przeciwnym razie lista zawiera nazwy atrybut' obiektow, nazwy atrybut jego " +"klasy i rekurencyjnie atrybut klas bazowych jego klasy." + +msgid "The resulting list is sorted alphabetically. For example:" +msgstr "Wynikowa lista jest posortowana alfabetycznie. Na przykład:" + +msgid "" +"Because :func:`dir` is supplied primarily as a convenience for use at an " +"interactive prompt, it tries to supply an interesting set of names more than " +"it tries to supply a rigorously or consistently defined set of names, and " +"its detailed behavior may change across releases. For example, metaclass " +"attributes are not in the result list when the argument is a class." +msgstr "" +"Ponieważ :func:`dir` jest dostarczany głównie jako udogodnienie do użycia w " +"interaktywnym wierszu polecenia, stara się dostarczyć interesujący zestaw " +"nazw bardziej niż rygorystycznie lub konsekwentnie zdefiniowany zestaw nazw, " +"a jego szczegółowy zachowanie może się zmieniać w różnych wydaniach. Na " +"przykład, atrybut metaklasy nie znajduje się na liście wyników, gdy argument " +"jest klasą." + +msgid "" +"Take two (non-complex) numbers as arguments and return a pair of numbers " +"consisting of their quotient and remainder when using integer division. " +"With mixed operand types, the rules for binary arithmetic operators apply. " +"For integers, the result is the same as ``(a // b, a % b)``. For floating-" +"point numbers the result is ``(q, a % b)``, where *q* is usually " +"``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b + a " +"% b`` is very close to *a*, if ``a % b`` is non-zero it has the same sign as " +"*b*, and ``0 <= abs(a % b) < abs(b)``." +msgstr "" +"Weź dwie (niezłożone) liczby jako argumenty i zwraca parę liczb składającą " +"się z ich ilorazu i reszty, gdy używasz liczba całkowita dzielenia. W " +"przypadku mieszanych typów operandów obowiązują reguły dla binarnych " +"operatorów arytmetycznych. Dla liczb całkowitych wynik jest taki sam jak " +"``(a // b, a % b)``. Dla liczb zmiennoprzecinkowych wynikiem jest ``(q, a % " +"b)``, gdzie *q* jest zwykle ``math.floor(a / b)``, ale może być o 1 " +"mniejsze. W każdym przypadku ``q * b + a % b`` jest bardzo zbliżone do *a*, " +"jeśli ``a % b`` jest niezerowe, to ma taki sam znak jak *b* i ``0 <= abs(a % " +"b) < abs(b)``." + +msgid "" +"Return an enumerate object. *iterable* must be a sequence, " +"an :term:`iterator`, or some other object which supports iteration. " +"The :meth:`~iterator.__next__` method of the iterator returned " +"by :func:`enumerate` returns a tuple containing a count (from *start* which " +"defaults to 0) and the values obtained from iterating over *iterable*." +msgstr "" +"Zwraca obiekt wyliczeniowy. *iterable* musi być sekwencją, :term:`iteratorem " +"` lub innym obiektem obsługującym iterację. " +"Metoda :meth:`~iterator.__next__` iteratora zwróconego " +"przez :func:`enumerate` zwraca dwukrotkę zawierającą licznik (od *start*, " +"który domyślnie wynosi 0) i wartości uzyskane z iteracji na argumencie " +"*iterable*." + +msgid "Equivalent to::" +msgstr "Odpowiednik::" + +msgid "" +"def enumerate(iterable, start=0):\n" +" n = start\n" +" for elem in iterable:\n" +" yield n, elem\n" +" n += 1" +msgstr "" +"def enumerate(iterable, start=0):\n" +" n = start\n" +" for elem in iterable:\n" +" yield n, elem\n" +" n += 1" + +msgid "Parameters" +msgstr "parametry" + +msgid "A Python expression." +msgstr "Expresja Python." + +msgid "The global namespace (default: ``None``)." +msgstr "Globalna przestrzeń nazw (domyślny: ``None``)." + +msgid "The local namespace (default: ``None``)." +msgstr "Lokalna przestrzeń nazw (domyślny: ``None``)." + +msgid "Returns" +msgstr "Zwraca" + +msgid "The result of the evaluated expression." +msgstr "Wynik obliczonej ekspresji." + +msgid "raises" +msgstr "rzuca" + +msgid "Syntax errors are reported as exceptions." +msgstr "Błędy składni są zgłaszane jako wyjątki." + +msgid "" +"This function executes arbitrary code. Calling it with untrusted user-" +"supplied input will lead to security vulnerabilities." +msgstr "" +"Ta funkcja wykonuje dowolny kod. Wywołanie go z niezaufanymi danymi " +"wejściowymi dostarczonymi przez użytkownika prowadzi do luk w " +"zabezpieczeniach." + +msgid "" +"The *source* argument is parsed and evaluated as a Python expression " +"(technically speaking, an :ref:`expression list `) using the " +"*globals* and *locals* mappings as global and local namespace. If the " +"*globals* dictionary is present and does not contain a value for the key " +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key before *source* is parsed. " +"Overriding ``__builtins__`` can be used to restrict or change the available " +"names, but this is **not** a security mechanism: the executed code can still " +"access all builtins. If the *locals* mapping is omitted it defaults to the " +"*globals* dictionary. If both mappings are omitted, the source is executed " +"with the *globals* and *locals* in the environment where :func:`eval` is " +"called. Note, *eval()* will only have access to the :term:`nested scopes " +"` (non-locals) in the enclosing environment if they are " +"already referenced in the scope that is calling :func:`eval` (e.g. via " +"a :keyword:`nonlocal` statement)." +msgstr "" +"Argument *source* jest analizowany i ewaluowany jako wyrażenie Python " +"(technicznie rzecz biorąc, :ref:`expression list `) przy użyciu " +"mapowań *globals* i *locals* jako globalnej i lokalnej przestrzeni nazw. " +"Jeśli słownik *globals* jest obecny i nie zawiera wartości dla klucza " +"``__builtins__``, odwołanie do słownika wbudowanego modułu :mod:`builtins` " +"jest wstawiane pod tym kluczem, zanim *source* zostanie przeanalizowane. " +"Nadpisywanie ``__builtins__`` może służyć do ograniczenia lub zmiany " +"dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: wykonywany " +"kod nadal ma dostęp do wszystkich wbudowanych funkcji. Jeśli mapowanie " +"*locals* zostanie pominięte, domyślnie będzie to słownik *globals*. Jeśli " +"oba mapowania są pominięte, wyrażenie jest wykonywane z *globals* i *locals* " +"w środowisku, w którym wywoływany jest :func:`eval`. Uwaga, *eval()* będzie " +"miał dostęp do :term:`zagnieżdżonych zakresów ` (non-locals) w " +"otaczającym środowisku tylko wtedy, gdy są one już przywoływane w zakresie, " +"który wywołuje :func:`eval` (np. poprzez instrukcję :keyword:`nonlocal`)." + +msgid "Example:" +msgstr "Przykład:" + +msgid "" +"This function can also be used to execute arbitrary code objects (such as " +"those created by :func:`compile`). In this case, pass a code object instead " +"of a string. If the code object has been compiled with ``'exec'`` as the " +"*mode* argument, :func:`eval`\\'s return value will be ``None``." +msgstr "" +"Ta funkcja może być również używana do wykonywania dowolnych obiektów kodu " +"(takich jak te utworzone przez :func:`compile`). W tym przypadku należy " +"przekazać obiekt kodu zamiast napisu. Jeśli obiekt kodu został skompilowany " +"z ``'exec'`` jako *mode* argument, :func:`eval` wartością zwracana będzie " +"``None``." + +msgid "" +"Hints: dynamic execution of statements is supported by the :func:`exec` " +"function. The :func:`globals` and :func:`locals` functions return the " +"current global and local dictionary, respectively, which may be useful to " +"pass around for use by :func:`eval` or :func:`exec`." +msgstr "" +"Wskazówki: dynamiczne wykonywanie instrukcji jest obsługiwane " +"przez :func:`exec` funkcja . Adresy :func:`globals` i :func:`locals` " +"funkcje zwracaja określaaą odpowiednio bieżący globalny i lokalny adres " +"słownika, który może być przydatny do przekazania do użycia przez " +"adresy :func:`eval` lub :func:`exec`." + +msgid "" +"If the given source is a string, then leading and trailing spaces and tabs " +"are stripped." +msgstr "" +"Jeśli podane źródło to napis, początkowe i końcowe spacje i tabulatory są " +"usuwane." + +msgid "" +"See :func:`ast.literal_eval` for a function to evaluate strings with " +"expressions containing only literals." +msgstr "" +"Zobacz :func:`ast.literal_eval` dla funkcja do oceny napisów z wyrażeniami " +"zawierającymi tylko literały." + +msgid "" +"Raises an :ref:`auditing event ` ``exec`` with the code object as " +"the argument. Code compilation events may also be raised." +msgstr "" +"Rzuci zdarzenie :ref:`auditing event ` ``exec`` z obiektem kodu " +"jako argument. Zdarzenia kompilacji kodu mogą być również rzucone." + +msgid "The *globals* and *locals* arguments can now be passed as keywords." +msgstr "" +"Funkcje *globals* i *locals* argumenty mogą być teraz przekazywane jako " +"słowa kluczowe." + +msgid "" +"The semantics of the default *locals* namespace have been adjusted as " +"described for the :func:`locals` builtin." +msgstr "" +"Semantyka przestrzeni nazw domyślnych *locals* została dostosowana zgodnie z " +"opisem dla wbudowanej :func:`locals` ." + +msgid "" +"This function supports dynamic execution of Python code. *source* must be " +"either a string or a code object. If it is a string, the string is parsed " +"as a suite of Python statements which is then executed (unless a syntax " +"error occurs). [#]_ If it is a code object, it is simply executed. In all " +"cases, the code that's executed is expected to be valid as file input (see " +"the section :ref:`file-input` in the Reference Manual). Be aware that " +"the :keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements " +"may not be used outside of function definitions even within the context of " +"code passed to the :func:`exec` function. The return value is ``None``." +msgstr "" +"Ta funkcja obsługuje dynamiczne wykonywanie kodu Python. *source* musi być " +"albo napis albo obiektem kodu. Jeśli jest to napis, napis jest analizowany " +"jako zestaw instrukcji Pythona, które sa następnie wykonywany (chyba że " +"wystąpi błąd składni). [#]_ Jeśli jest to obiekt kodu, jest on po prostu " +"wykonywany. We wszystkich przypadkach wykonywany kod powinien być " +"prawidłowy jako plik wejściowy (patrz sekcja :ref:`file-input` w Podręczniku " +"referencyjnym). Należy pamiętać, że " +"wartości :keyword:`nonlocal`, :keyword:`yield` i :keyword:`return` " +"instrukcije nie mogą być używane poza definicjami funkcji, nawet w " +"kontekście kodu przekazywanego do :func:`exec` . Wartość zwracana to " +"``None``." + +msgid "" +"In all cases, if the optional parts are omitted, the code is executed in the " +"current scope. If only *globals* is provided, it must be a dictionary (and " +"not a subclass of dictionary), which will be used for both the global and " +"the local variables. If *globals* and *locals* are given, they are used for " +"the global and local variables, respectively. If provided, *locals* can be " +"any mapping object. Remember that at the module level, globals and locals " +"are the same dictionary." +msgstr "" +"We wszystkich przypadkach, jeśli części opcjonalne są pominięte, kod jest " +"wykonywany w bieżącym zakresie. Jeśli podano tylko *globals*, musi to być " +"słownik (a nie podklasa z słownikem), który będzie używany zarówno dla " +"zmiennych globalnych, jak i lokalnych. Jeśli podano *globals* i *locals*, " +"są one używane odpowiednio dla zmiennych globalnych i lokalnych. Jeśli " +"podano *locals*, może to być dowolny obiekt mapowania. Należy pamiętać, że " +"na poziomie moduł, globals i locals są tym samym słownikem." + +msgid "" +"When ``exec`` gets two separate objects as *globals* and *locals*, the code " +"will be executed as if it were embedded in a class definition. This means " +"functions and classes defined in the executed code will not be able to " +"access variables assigned at the top level (as the \"top level\" variables " +"are treated as class variables in a class definition)." +msgstr "" +"Gdy ``exec`` pobiera dwa oddzielne obiekty jako *globals* i *locals*, kod " +"zostanie wykonany tak, jakby był osadzony w definicja klasy. Oznacza to, że " +"funkcja i klasy zdefiniowane w wykonywanym kodzie nie będą mogły uzyskać " +"dostępu do zmiennych przypisanych na najwyższym poziomie (ponieważ zmienne " +"\"najwyższego poziomu\" są traktowane jako zmienne klasowe w definicja " +"klasy)." + +msgid "" +"If the *globals* dictionary does not contain a value for the key " +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key. Overriding " +"``__builtins__`` can be used to restrict or change the available names, but " +"this is **not** a security mechanism: the executed code can still access all " +"builtins." +msgstr "" +"Jeśli słownik *globals* nie zawiera wartości dla klucza ``__builtins__``, " +"odwołanie do słownika z wbudowanego modułu :mod:`builtins` jest wstawiane " +"pod tym kluczem. Nadpisywanie ``__builtins__`` może służyć do ograniczenia " +"lub zmiany dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: " +"wykonywany kod nadal ma dostęp do wszystkich wbudowanych funkcji." + +msgid "" +"The *closure* argument specifies a closure--a tuple of cellvars. It's only " +"valid when the *object* is a code object containing :term:`free (closure) " +"variables `. The length of the tuple must exactly match " +"the length of the code object's :attr:`~codeobject.co_freevars` attribute." +msgstr "" +"Wyrażenie *closure* określa zamknięcie - krotka zmiennych komórkowych. Jest " +"ważne tylko wtedy, gdy *obiekt* jest obiektem kodu zawierającym :term:`wolne " +"(zamknięcie) zmienne `. Długość krotka musi dokładnie " +"odpowiadać długości :attr:`~codeobject.co_freevars` atrybutem obiektu kodu." + +msgid "" +"The built-in functions :func:`globals` and :func:`locals` return the current " +"global and local namespace, respectively, which may be useful to pass around " +"for use as the second and third argument to :func:`exec`." +msgstr "" +"Adresy wbudowane funkcji :func:`globals` i :func:`locals` zwraca to " +"odpowiednio bieżąca globalna i lokalna przestrzeń nazw, które mogą być " +"przydatne do przekazania jako drugi i trzeci argument do :func:`exec`." + +msgid "" +"The default *locals* act as described for function :func:`locals` below. " +"Pass an explicit *locals* dictionary if you need to see effects of the code " +"on *locals* after function :func:`exec` returns." +msgstr "" +"Elementy domyślne *locals* działają w sposób opisany dla " +"funkcji :func:`locals` poniżej. Przekaż jawne *locals* słownik jeśli chcesz " +"zobaczyć efekty kodu na *locals* po funkcji :func:`exec` ." + +msgid "Added the *closure* parameter." +msgstr "Dodano parametr *zamknięcie*." + +msgid "" +"Construct an iterator from those elements of *iterable* for which *function* " +"is true. *iterable* may be either a sequence, a container which supports " +"iteration, or an iterator. If *function* is ``None``, the identity function " +"is assumed, that is, all elements of *iterable* that are false are removed." +msgstr "" +"Konstruuje iterator z tych elementów *iterable*, dla których *funkcja* jest " +"prawdą. *iterable* może być sekwencją, kontenerem obsługującym iterację lub " +"iterator. Jeśli *funkcja* jest ``None``, zakłada się tożsamość funkcji, to " +"znaczy wszystkie elementy *iterable*, które są fałszywe, są usuwane." + +msgid "" +"Note that ``filter(function, iterable)`` is equivalent to the generator " +"expression ``(item for item in iterable if function(item))`` if function is " +"not ``None`` and ``(item for item in iterable if item)`` if function is " +"``None``." +msgstr "" +"Należy zauważyć, że ``filter(function, iterable)`` jest równoważne wyrażeniu " +"generator ``(item for item in iterable if function(item))`` jeśli funkcja " +"nie jest ``None`` i ``(item for item in iterable if item)`` jeśli funkcja " +"jest ``None``." + +msgid "" +"See :func:`itertools.filterfalse` for the complementary function that " +"returns elements of *iterable* for which *function* is false." +msgstr "" +"Zobacz :func:`itertools.filterfalse` dla komplementarnych funkci ktore " +"zwracaja elementy *iterable* dla których *funkcja* jest fałszywe." + +msgid "Return a floating-point number constructed from a number or a string." +msgstr "Zwraca liczba zmiennoprzecinkowa zbudowana z liczby lub napisu." + +msgid "" +">>> float('+1.23')\n" +"1.23\n" +">>> float(' -12345\\n')\n" +"-12345.0\n" +">>> float('1e-003')\n" +"0.001\n" +">>> float('+1E6')\n" +"1000000.0\n" +">>> float('-Infinity')\n" +"-inf" +msgstr "" +">>> float('+1.23')\n" +"1.23\n" +">>> float(' -12345\\n')\n" +"-12345.0\n" +">>> float('1e-003')\n" +"0.001\n" +">>> float('+1E6')\n" +"1000000.0\n" +">>> float('-Infinity')\n" +"-inf" + +msgid "" +"If the argument is a string, it should contain a decimal number, optionally " +"preceded by a sign, and optionally embedded in whitespace. The optional " +"sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect on the value " +"produced. The argument may also be a string representing a NaN (not-a-" +"number), or positive or negative infinity. More precisely, the input must " +"conform to the :token:`~float:floatvalue` production rule in the following " +"grammar, after leading and trailing whitespace characters are removed:" +msgstr "" +"Jeśli argument jest napisem, powinien zawierać liczbę dziesiętną, " +"opcjonalnie poprzedzoną znakiem i opcjonalnie osadzoną w białych znakach. " +"Znak opcjonalny może być ``'+'`` lub ``'-'``; znak ``'+'`` nie ma wpływu na " +"otrzymaną wartość. argument może być również napisem reprezentującym NaN " +"(not-a-number) lub dodatnią lub ujemną nieskończoność. Dokładniej, dane " +"wejściowe muszą być zgodne z regułą produkcji :token:`~float:floatvalue` w " +"poniższej gramatyce, po usunięciu początkowych i końcowych białych znaków " +"znak:" + +msgid "" +"Case is not significant, so, for example, \"inf\", \"Inf\", \"INFINITY\", " +"and \"iNfINity\" are all acceptable spellings for positive infinity." +msgstr "" +"Wielkość liter nie ma znaczenia, więc na przykład \"inf\", \"Inf\", " +"\"INFINITY\" i \"iNfINity\" są akceptowalnymi pisowniami dla dodatniej " +"nieskończoności." + +msgid "" +"Otherwise, if the argument is an integer or a floating-point number, a " +"floating-point number with the same value (within Python's floating-point " +"precision) is returned. If the argument is outside the range of a Python " +"float, an :exc:`OverflowError` will be raised." +msgstr "" +"W przeciwnym razie, jeśli argument jest liczba całkowita lub liczbą " +"zmiennoprzecinkową, zwracana jest liczba zmiennoprzecinkowa o tej samej " +"wartości (w zakresie precyzji zmiennoprzecinkowej Python). Rzuci jeśli " +"argument jest poza zakresem liczby zmiennoprzecinkowej Python, zwrócona " +"zostanie :exc:`OverflowError`." + +msgid "" +"For a general Python object ``x``, ``float(x)`` delegates to " +"``x.__float__()``. If :meth:`~object.__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." +msgstr "" +"W przypadku ogólnego obiektu Python ``x`` , ``float(x)`` deleguje do " +"``x.__float__()``. Jeśli :meth:`~object.__float__` nie jest zdefiniowana, to " +"spada z powrotem do :meth:`~object.__index__`." + +msgid "" +"See also :meth:`float.from_number` which only accepts a numeric argument." +msgstr "" +"Zobacz też :meth:`float.from_number`, która akceptuje tylko jeden argument " +"numeryczny." + +msgid "If no argument is given, ``0.0`` is returned." +msgstr "Jeśli nie podano argumentu, zwracane jest ``0.0``." + +msgid "The float type is described in :ref:`typesnumeric`." +msgstr "Typ float został opisany na stronie :ref:`typesnumeric`." + +msgid "" +"Falls back to :meth:`~object.__index__` if :meth:`~object.__float__` is not " +"defined." +msgstr "" +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__float__` nie " +"jest zdefiniowane." + +msgid "" +"Convert a *value* to a \"formatted\" representation, as controlled by " +"*format_spec*. The interpretation of *format_spec* will depend on the type " +"of the *value* argument; however, there is a standard formatting syntax that " +"is used by most built-in types: :ref:`formatspec`." +msgstr "" +"Konwertuje *value* na \"formatted\" reprezentację, kontrolowaną przez " +"*format_spec*. Interpretacja *format_spec* będzie zależeć od typu *value* " +"argument; jednak istnieje standardowa składnia formatowania, która jest " +"używana przez większość typów wbudowanych: :ref:`formatspec`." + +msgid "" +"The default *format_spec* is an empty string which usually gives the same " +"effect as calling :func:`str(value) `." +msgstr "" +"Parametr domyślny *format_spec* jest pustym napisem, co zwykle daje taki sam " +"efekt jak wywołanie :func:`str(value) `." + +msgid "" +"A call to ``format(value, format_spec)`` is translated to " +"``type(value).__format__(value, format_spec)`` which bypasses the instance " +"dictionary when searching for the value's :meth:`~object.__format__` method. " +"A :exc:`TypeError` exception is raised if the method search " +"reaches :mod:`object` and the *format_spec* is non-empty, or if either the " +"*format_spec* or the return value are not strings." +msgstr "" +"Wywołanie ``format(value, format_spec)`` jest tłumaczone na " +"``type(value).__format__(value, format_spec)``, które omija instancję " +"słownika podczas wyszukiwania metody :meth:`~object.__format__` wartości . " +"Wyjątek :exc:`TypeError` jest rzucony, jeśli wyszukiwanie metody " +"osiągnie :mod:`object` i *format_spec* jest niepusty, lub jeśli " +"*format_spec* lub wartość zwracana nie są napisem." + +msgid "" +"``object().__format__(format_spec)`` raises :exc:`TypeError` if " +"*format_spec* is not an empty string." +msgstr "" +"``object().__format__(format_spec)`` rzuci :exc:`TypeError` jeśli " +"*format_spec* nie jest pustym napisem." + +msgid "" +"Return a new :class:`frozenset` object, optionally with elements taken from " +"*iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-" +"set` for documentation about this class." +msgstr "" +"Zwraca nowy obiekt :class:`frozenset`, opcjonalnie z elementami z " +"*iterable*. :class:`frozenset` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." + +msgid "" +"For other containers see the built-" +"in :class:`set`, :class:`list`, :class:`tuple`, and :class:`dict` classes, " +"as well as the :mod:`collections` module." +msgstr "" +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`set` , :class:`list`, :class:`tuple` i :class:`dict`, jak " +"również moduł :mod:`collections` ." + +msgid "" +"Return the value of the named attribute of *object*. *name* must be a " +"string. If the string is the name of one of the object's attributes, the " +"result is the value of that attribute. For example, ``getattr(x, " +"'foobar')`` is equivalent to ``x.foobar``. If the named attribute does not " +"exist, *default* is returned if provided, otherwise :exc:`AttributeError` is " +"raised. *name* need not be a Python identifier (see :func:`setattr`)." +msgstr "" +"Zwraca wartość nazwanego atrybut obiektu *object*. *name* musi być napisem. " +"Jeśli napis jest nazwą jednego z atrybut obiektu, wynikiem jest wartość tego " +"atrybutu. Na przykład, ``getattr(x, 'foobar')`` jest równoważne " +"``x.foobar``. Jeśli nazwany atrybut nie istnieje, *default* jest zwracany, " +"jeśli został podany, w przeciwnym razie :exc:`AttributeError` jest rzucony. " +"*name* nie musi być identyfikatorem Pythona (Zobacz :func:`setattr`)." + +msgid "" +"Since :ref:`private name mangling ` happens at " +"compilation time, one must manually mangle a private attribute's (attributes " +"with two leading underscores) name in order to retrieve it " +"with :func:`getattr`." +msgstr "" +"Ponieważ :ref:`manipulowanie nazwami prywatnymi ` " +"odbywa się w czasie kompilacji, należy ręcznie zmanipulować nazwę prywatną " +"atrybutu (atrybuty z dwoma wiodącymi podkreśleniami), aby pobrać ją za " +"pomocą :func:`getattr`." + +msgid "" +"Return the dictionary implementing the current module namespace. For code " +"within functions, this is set when the function is defined and remains the " +"same regardless of where the function is called." +msgstr "" +"Zwraca słownik implementującą bieżącą przestrzeń nazw moduł. W przypadku " +"kodu w funkcja, jest on ustawiany, gdy funkcja jest zdefiniowana i pozostaje " +"taki sam niezależnie od tego, gdzie wywoływana jest funkcja." + +msgid "" +"The arguments are an object and a string. The result is ``True`` if the " +"string is the name of one of the object's attributes, ``False`` if not. " +"(This is implemented by calling ``getattr(object, name)`` and seeing whether " +"it raises an :exc:`AttributeError` or not.)" +msgstr "" +"Argumenty to obiekt i napis. Wynikiem jest ``True`` jeśli napis jest nazwą " +"jednego z obiektów atrybut, ``False`` jeśli nie. (Jest to zaimplementowane " +"poprzez wywołanie ``getattr(object, name)`` i sprawdzenie, czy rzucone " +"jest :exc:`AttributeError` )." + +msgid "" +"Return the hash value of the object (if it has one). Hash values are " +"integers. They are used to quickly compare dictionary keys during a " +"dictionary lookup. Numeric values that compare equal have the same hash " +"value (even if they are of different types, as is the case for 1 and 1.0)." +msgstr "" +"Zwraca wartość skrótu obiektu (jeśli taki posiada). Wartości skrótu są " +"liczbami całkowitymi. Są one używane do szybkiego porównywania kluczy " +"słownika podczas wyszukiwania słownika. Wartości numeryczne, które są " +"równe, mają tę samą wartość skrótu (nawet jeśli są różnych typów, jak w " +"przypadku 1 i 1.0)." + +msgid "" +"For objects with custom :meth:`~object.__hash__` methods, note " +"that :func:`hash` truncates the return value based on the bit width of the " +"host machine." +msgstr "" +"W przypadku obiektów z niestandardowymi metodami :meth:`~object.__hash__` " +"należy pamiętać, że :func:`hash` obcina wartość zwracaną w oparciu o " +"szerokość bitową maszyny hosta." + +msgid "" +"Invoke the built-in help system. (This function is intended for interactive " +"use.) If no argument is given, the interactive help system starts on the " +"interpreter console. If the argument is a string, then the string is looked " +"up as the name of a module, function, class, method, keyword, or " +"documentation topic, and a help page is printed on the console. If the " +"argument is any other kind of object, a help page on the object is generated." +msgstr "" +"Wywołuje system pomocy wbudowany. (Ta funkcja jest przeznaczona do użytku " +"interaktywnego.) Jeśli nie podano argumentu, interaktywny system pomocy " +"uruchamia się na konsoli interpretera. Jeśli argument jest napisem, to " +"napis jest wyszukiwany jako nazwa modułu, funkcja, klasa, metoda, słowo " +"kluczowe lub temat dokumentacji, a strona pomocy jest drukowana na konsoli. " +"Jeśli argument jest jakimkolwiek innym rodzajem obiektu, generowana jest " +"strona pomocy dotycząca tego obiektu." + +msgid "" +"Note that if a slash(/) appears in the parameter list of a function when " +"invoking :func:`help`, it means that the parameters prior to the slash are " +"positional-only. For more info, see :ref:`the FAQ entry on positional-only " +"parameters `." +msgstr "" +"Zauważ, że jeśli ukośnik (/) pojawia się na liście parametrów w funkcji " +"podczas wywoływania :func:`help`, oznacza to, że parametry przed ukośnikiem " +"są tylko-pozycyjne. Aby uzyskać więcej informacji, zobacz :ref:`wpis FAQ na " +"temat parametrów tylko-pozycyjnych ` ." + +msgid "" +"This function is added to the built-in namespace by the :mod:`site` module." +msgstr "" +"Ta funkcja jest dodawana do przestrzeni nazw wbudowanych przez " +"moduł :mod:`site` ." + +msgid "" +"Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " +"for callables are now more comprehensive and consistent." +msgstr "" +"Zmiany do :mod:`pydoc` i :mod:`inspect` oznaczają, że zgłoszone sygnatury " +"dla callables są teraz bardziej kompleksowe i spójne." + +msgid "" +"Convert an integer number to a lowercase hexadecimal string prefixed with " +"\"0x\". If *integer* is not a Python :class:`int` object, it has to define " +"an :meth:`~object.__index__` method that returns an integer. Some examples:" +msgstr "" +"Konwertuje liczbę całkowitą na zapis szesnastkowy małymi literami " +"poprzedzony „0x”. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int` , musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Kilka przykładów:" + +msgid "" +"If you want to convert an integer number to an uppercase or lower " +"hexadecimal string with prefix or not, you can use either of the following " +"ways:" +msgstr "" +"Jeśli chcesz przekonwertować liczbe całkowita na wielką lub małą liczbę " +"szesnastkową napis z prefiksem lub bez, możesz użyć jednego z poniższych " +"sposobów:" + +msgid "" +"See also :func:`int` for converting a hexadecimal string to an integer using " +"a base of 16." +msgstr "" +"Zobacz także :func:`int`, aby przekonwertować szesnastkowy napis na liczba " +"całkowita przy użyciu podstawy 16." + +msgid "" +"To obtain a hexadecimal string representation for a float, use " +"the :meth:`float.hex` method." +msgstr "" +"Aby uzyskać napis szesnastkowej reprezentacj dla zmiennoprzecinkowej, należy " +"użyć metody :meth:`float.hex`." + +msgid "" +"Return the \"identity\" of an object. This is an integer which is " +"guaranteed to be unique and constant for this object during its lifetime. " +"Two objects with non-overlapping lifetimes may have the same :func:`id` " +"value." +msgstr "" +"Zwraca \"tożsamość\" obiektu. Jest to liczba całkowita, która jest " +"gwarantowana jako unikalny i stały dla tego obiektu przez cały okres jego " +"życia. Dwa obiekty o nienakładających się okresach życia mogą mieć tę samą " +"wartość :func:`id`." + +msgid "This is the address of the object in memory." +msgstr "Jest to adres obiektu w pamięci." + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.id`` with argument " +"``id``." +msgstr "" +"Rzuci :ref:`auditing event ` ``builtins.id`` bez argumentu " +"``id`` ." + +msgid "" +"If the *prompt* argument is present, it is written to standard output " +"without a trailing newline. The function then reads a line from input, " +"converts it to a string (stripping a trailing newline), and returns that. " +"When EOF is read, :exc:`EOFError` is raised. Example::" +msgstr "" +"Jeśli *prompt* argument jest obecny, jest on zapisywany na standardowe " +"wyjście bez końcowej nowej linii. Następnie funkcja odczytuje linię z " +"wejścia, konwertuje ją na napis (usuwając końcową nową linię) i zwraca. Po " +"odczytaniu EOF, :exc:`EOFError` jest rzucone. Przykład::" + +msgid "" +">>> s = input('--> ')\n" +"--> Monty Python's Flying Circus\n" +">>> s\n" +"\"Monty Python's Flying Circus\"" +msgstr "" +">>> s = input('--> ')\n" +"--> Monty Python's Flying Circus\n" +">>> s\n" +"\"Monty Python's Flying Circus\"" + +msgid "" +"If the :mod:`readline` module was loaded, then :func:`input` will use it to " +"provide elaborate line editing and history features." +msgstr "" +"Jeśli załadowano moduł :mod:`readline` , to :func:`input` użyje go do " +"zapewnienia rozbudowanych funkcji edycji wierszy i historii." + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.input`` with argument " +"``prompt`` before reading input" +msgstr "" +"Rzuca :ref:`auditing event ` ``builtins.input`` z argumentem " +"``prompt`` przed odczytaniem wpisu" + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.input/result`` with " +"the result after successfully reading input." +msgstr "" +"Rzuca zdarzenie :ref:`auditing ` ``builtins.input/result`` z " +"wynikiem po pomyślnym odczytaniu danych wejściowych." + +msgid "" +"Return an integer object constructed from a number or a string, or return " +"``0`` if no arguments are given." +msgstr "" +"Zwraca obiekt liczba całkowita zbudowana z liczby lub napisu, lub zwraca " +"``0`` jeśli nie podano argumentu." + +msgid "" +">>> int(123.45)\n" +"123\n" +">>> int('123')\n" +"123\n" +">>> int(' -12_345\\n')\n" +"-12345\n" +">>> int('FACE', 16)\n" +"64206\n" +">>> int('0xface', 0)\n" +"64206\n" +">>> int('01110011', base=2)\n" +"115" +msgstr "" +">>> int(123.45)\n" +"123\n" +">>> int('123')\n" +"123\n" +">>> int(' -12_345\\n')\n" +"-12345\n" +">>> int('FACE', 16)\n" +"64206\n" +">>> int('0xface', 0)\n" +"64206\n" +">>> int('01110011', base=2)\n" +"115" + +msgid "" +"If the argument defines :meth:`~object.__int__`, ``int(x)`` returns " +"``x.__int__()``. If the argument defines :meth:`~object.__index__`, it " +"returns ``x.__index__()``. For floating-point numbers, this truncates " +"towards zero." +msgstr "" +"Jeśli argument definiuje :meth:`~object.__int__`, ``int(x)`` zwraca " +"``x.__int__()``. Jeśli argument definiuje :meth:`~object.__index__`, to " +"zwraca ``x.__index__()``. W przypadku liczb zmiennoprzecinkowych, są one " +"przycinane w kierunku zera." + +msgid "" +"If the argument is not a number or if *base* is given, then it must be a " +"string, :class:`bytes`, or :class:`bytearray` instance representing an " +"integer in radix *base*. Optionally, the string can be preceded by ``+`` or " +"``-`` (with no space in between), have leading zeros, be surrounded by " +"whitespace, and have single underscores interspersed between digits." +msgstr "" +"Jeśli argument nie jest liczbą lub jeśli podano *base*, musi to być " +"instancja napisu, :class:`bytes` lub :class:`bytearray` reprezentująca " +"liczba całkowita w radix *base*. Opcjonalnie, napis może być poprzedzony " +"przez ``+`` lub ``-`` (bez spacji pomiędzy nimi), mieć początkowe zera, być " +"otoczone białymi znakami i mieć pojedyncze podkreślenia pomiędzy cyframi." + +msgid "" +"A base-n integer string contains digits, each representing a value from 0 to " +"n-1. The values 0--9 can be represented by any Unicode decimal digit. The " +"values 10--35 can be represented by ``a`` to ``z`` (or ``A`` to ``Z``). The " +"default *base* is 10. The allowed bases are 0 and 2--36. Base-2, -8, and -16 " +"strings can be optionally prefixed with ``0b``/``0B``, ``0o``/``0O``, or " +"``0x``/``0X``, as with integer literals in code. For base 0, the string is " +"interpreted in a similar way to an :ref:`integer literal in code " +"`, in that the actual base is 2, 8, 10, or 16 as determined by the " +"prefix. Base 0 also disallows leading zeros: ``int('010', 0)`` is not legal, " +"while ``int('010')`` and ``int('010', 8)`` are." +msgstr "" +"Baza-n liczba całkowita napis zawiera cyfry, z których każda reprezentuje " +"wartość od 0 do n-1. Wartości 0--9 mogą być reprezentowane przez dowolną " +"cyfrę dziesiętną Unicode. Wartości 10-35 mogą być reprezentowane przez ``a`` " +"do ``z`` (lub ``A`` do ``Z``). Domyślna baza jest 10. Dozwolone wartości " +"bazowe to 0 i 2--36. Podstawy 2, -8 i -16 napis mogą być opcjonalnie " +"poprzedzone przedrostkiem ``0b``/``0B``, ``0o``/``0O``, lub ``0x``/``0X``, " +"tak jak w przypadku literałów liczba całkowita w kodzie. Dla podstawy 0, " +"napis jest interpretowane w podobny sposób jak :ref:`liczba całkowita w " +"kodzie `, w którym rzeczywista podstawa wynosi 2, 8, 10 lub 16, " +"zgodnie z przedrostkiem. Podstawa 0 również nie zezwala na zera wiodące: " +"``int('010', 0)`` nie jest legalne, podczas gdy ``int('010')`` i " +"``int('010', 8)`` są." + +msgid "The integer type is described in :ref:`typesnumeric`." +msgstr "Typ liczba całkowita (integer) został opisany w :ref:`typesnumeric`." + +msgid "" +"If *base* is not an instance of :class:`int` and the *base* object has " +"a :meth:`base.__index__ ` method, that method is called to " +"obtain an integer for the base. Previous versions used :meth:`base.__int__ " +"` instead of :meth:`base.__index__ `." +msgstr "" +"Jeśli *base* nie jest instancją :class:`int` i obiekt *base* posiada " +"metodę :meth:`base.__index__ `, metoda ta jest wywoływana " +"w celu uzyskania liczba całkowitych dla bazy. Poprzednie wersje " +"używały :meth:`base.__int__ ` zamiast :meth:`base.__index__ " +"`." + +msgid "The first parameter is now positional-only." +msgstr "Pierwszy parametr jest teraz tylko pozycyjny." + +msgid "" +"Falls back to :meth:`~object.__index__` if :meth:`~object.__int__` is not " +"defined." +msgstr "" +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__int__` nie jest " +"zdefiniowane." + +msgid "" +":class:`int` string inputs and string representations can be limited to help " +"avoid denial of service attacks. A :exc:`ValueError` is raised when the " +"limit is exceeded while converting a string to an :class:`int` or when " +"converting an :class:`int` into a string would exceed the limit. See " +"the :ref:`integer string conversion length limitation ` " +"documentation." +msgstr "" +":class:`int` napis wejścia i reprezentacje napisa mogą być ograniczone, aby " +"pomóc uniknąć ataków typu \"odmowa usługi\". :exc:`ValueError` jest rzucone, " +"gdy limit zostanie przekroczony podczas konwersji napisa na :class:`int` lub " +"gdy konwersja :class:`int` na napis przekroczy limit. Zobacz " +"dokumentację :ref:`liczba całkowita napis ograniczenia długości konwersji " +"`." + +msgid "" +":func:`int` no longer delegates to the :meth:`~object.__trunc__` method." +msgstr ":func:`int` nie deleguje już do metody :meth:`~object.__trunc__`." + +msgid "" +"Return ``True`` if the *object* argument is an instance of the *classinfo* " +"argument, or of a (direct, indirect, or :term:`virtual `) subclass thereof. If *object* is not an object of the given type, " +"the function always returns ``False``. If *classinfo* is a tuple of type " +"objects (or recursively, other such tuples) or a :ref:`types-union` of " +"multiple types, return ``True`` if *object* is an instance of any of the " +"types. If *classinfo* is not a type or tuple of types and such tuples, " +"a :exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised " +"for an invalid type if an earlier check succeeds." +msgstr "" +"Zwraca ``True`` jeśli argument *object* jest instancją argumentu " +"*classinfo*, lub jego (bezpośrednią, pośrednią lub :term:`wirtualną " +"`) podklasą. Jeśli *object* nie jest obiektem " +"danego typu, funkcja zawsze zwraca ``False``. Jeśli *classinfo* jest krotką " +"obiektów typu (lub rekurencyjnie, innych takich krotek) lub :ref:`types-" +"union` wielu typów, zwraca ``True`` jeśli *obiekt* jest instancją " +"któregokolwiek z typów. Jeśli *classinfo* nie jest typem lub krotką typów i " +"takich krotek, rzucany jest wyjątek :exc:`TypeError`. :exc:`TypeError` może " +"nie być rzucony dla nieprawidłowego typu, jeśli wcześniejsze sprawdzenie " +"powiedzie się." + +msgid "*classinfo* can be a :ref:`types-union`." +msgstr "*classinfo* może być :ref:`types-union`." + +msgid "" +"Return ``True`` if *class* is a subclass (direct, indirect, " +"or :term:`virtual `) of *classinfo*. A class is " +"considered a subclass of itself. *classinfo* may be a tuple of class objects " +"(or recursively, other such tuples) or a :ref:`types-union`, in which case " +"return ``True`` if *class* is a subclass of any entry in *classinfo*. In " +"any other case, a :exc:`TypeError` exception is raised." +msgstr "" +"Zwraca ``True`` jeśli *class* jest podklasą (bezpośrednią, pośrednią " +"lub :term:`wirtualną `) *classinfo*. Klasa jest " +"uważana za podklasę samej siebie. *classinfo* może być krotką obiektów klasy " +"(lub rekurencyjnie, innych takich krotek) lub :ref:`types-union`, w którym " +"to przypadku zwraca ``True`` jeśli *class* jest podklasą dowolnego wpisu w " +"*classinfo*. W każdym innym przypadku rzucany jest wyjątek :exc:`TypeError`." + +msgid "" +"Return an :term:`iterator` object. The first argument is interpreted very " +"differently depending on the presence of the second argument. Without a " +"second argument, the single argument must be a collection object which " +"supports the :term:`iterable` protocol (the :meth:`~object.__iter__` " +"method), or it must support the sequence protocol " +"(the :meth:`~object.__getitem__` method with integer arguments starting at " +"``0``). If it does not support either of those protocols, :exc:`TypeError` " +"is raised. If the second argument, *sentinel*, is given, then the first " +"argument must be a callable object. The iterator created in this case will " +"call *callable* with no arguments for each call to " +"its :meth:`~iterator.__next__` method; if the value returned is equal to " +"*sentinel*, :exc:`StopIteration` will be raised, otherwise the value will be " +"returned." +msgstr "" +"Zwraca obiekt :term:`iteratora `. Pierwszy argument jest " +"interpretowany bardzo różnie w zależności od obecności drugiego argumentu. " +"Bez drugiego argumentu, jedyny argument musi być obiektem kolekcji, która " +"obsługuje protokół :term:`iterable` (metoda :meth:`~object.__iter__` ), lub " +"musi obsługiwać protokół sekwencji (metoda :meth:`~object.__getitem__` z " +"argumentami liczb całkowitych zaczynających się od ``0``). Jeśli nie " +"obsługuje żadnego z tych protokołów, zostanie rzucony :exc:`TypeError`. " +"Jeśli podano drugi argument, *sentinel*, to pierwszy argument musi być " +"obiektem wywoływalnym. Utworzony w tym przypadku iterator będzie wywoływał " +"*callable* bez argumentu dla każdego wywołania jego " +"metody :meth:`~iterator.__next__`; jeśli zwrócona wartość jest równa " +"*sentinel*, zostanie rzucone :exc:`StopIteration`, w przeciwnym razie " +"zostanie zwrócona wartość." + +msgid "See also :ref:`typeiter`." +msgstr "Zobacz także :ref:`typeiter`." + +msgid "" +"One useful application of the second form of :func:`iter` is to build a " +"block-reader. For example, reading fixed-width blocks from a binary database " +"file until the end of file is reached::" +msgstr "" +"Jednym z przydatnych aplikacji drugiej formy :func:`iter` jest zbudowanie " +"blok czytnika. Na przykład, odczytywanie stałej szerokości bloku z binarnego " +"pliku bazy danych aż do osiągnięcia końca pliku::" + +msgid "" +"from functools import partial\n" +"with open('mydata.db', 'rb') as f:\n" +" for block in iter(partial(f.read, 64), b''):\n" +" process_block(block)" +msgstr "" +"from functools import partial\n" +"with open('mojedane.db', 'rb') as f:\n" +" for block in iter(partial(f.read, 64), b''):\n" +" process_block(block)" + +msgid "" +"Return the length (the number of items) of an object. The argument may be a " +"sequence (such as a string, bytes, tuple, list, or range) or a collection " +"(such as a dictionary, set, or frozen set)." +msgstr "" +"Zwraca długość (liczba elementów) obiektu. Obiekt argument może być " +"sekwencją (taką jak napis, bajty, krotka, lista lub zakres) lub kolekcją " +"(taką jak słownik, zbiór lub zbiór zamrożony)." + +msgid "" +"``len`` raises :exc:`OverflowError` on lengths larger " +"than :data:`sys.maxsize`, such as :class:`range(2 ** 100) `." +msgstr "" +"``len`` rzuca :exc:`OverflowError` dla długości większych " +"niż :data:`sys.maxsize`, takich jak :class:`range(2 ** 100) `." + +msgid "" +"Rather than being a function, :class:`list` is actually a mutable sequence " +"type, as documented in :ref:`typesseq-list` and :ref:`typesseq`." +msgstr "" +"Zamiast być funkcją, :class:`list` jest w rzeczywistości typem mutowalnej " +"(zmiennej) sekwencji, jak udokumentowano w :ref:`typesseq-list` " +"i :ref:`typesseq`." + +msgid "" +"Return a mapping object representing the current local symbol table, with " +"variable names as the keys, and their currently bound references as the " +"values." +msgstr "" +"Zwraca obiekt mapowania reprezentujący bieżącą lokalną tablicę symboli, z " +"nazwami zmiennych jako kluczami i ich aktualnie powiązanymi referencjami " +"jako wartościami." + +msgid "" +"At module scope, as well as when using :func:`exec` or :func:`eval` with a " +"single namespace, this function returns the same namespace " +"as :func:`globals`." +msgstr "" +"W zakresie moduł, a także podczas korzystania z :func:`exec` " +"lub :func:`eval` z pojedynczą przestrzenią nazw, ta funkcja zwraca ta sama " +"przestrzeń nazw co :func:`globals`." + +msgid "" +"At class scope, it returns the namespace that will be passed to the " +"metaclass constructor." +msgstr "" +"W zakresie klasy, zwraca przestrzeń nazw, która zostanie przekazana do " +"konstruktora metaklasy." + +msgid "" +"When using ``exec()`` or ``eval()`` with separate local and global " +"arguments, it returns the local namespace passed in to the function call." +msgstr "" +"W przypadku korzystania z ``exec()`` lub ``eval()`` z oddzielnymi lokalnymi " +"i globalnymi argumentami, zwraca lokalną przestrzeń nazw przekazaną do " +"wywołania funkcji." + +msgid "" +"In all of the above cases, each call to ``locals()`` in a given frame of " +"execution will return the *same* mapping object. Changes made through the " +"mapping object returned from ``locals()`` will be visible as assigned, " +"reassigned, or deleted local variables, and assigning, reassigning, or " +"deleting local variables will immediately affect the contents of the " +"returned mapping object." +msgstr "" +"We wszystkich powyższych przypadkach każde wywołanie ``locals()`` w danej " +"ramce wykonania spowoduje zwracanie *tego samego* obiektu mapowania. Zmiany " +"dokonane za pośrednictwem obiektu mapowania zwróconego z ``locals()`` będą " +"widoczne jako przypisane, ponownie przypisane lub usunięte zmienne lokalne, " +"a przypisanie, ponowne przypisanie lub usunięcie zmiennych lokalnych " +"natychmiast wpłynie na zawartość zwróconego obiektu mapowania." + +msgid "" +"In an :term:`optimized scope` (including functions, generators, and " +"coroutines), each call to ``locals()`` instead returns a fresh dictionary " +"containing the current bindings of the function's local variables and any " +"nonlocal cell references. In this case, name binding changes made via the " +"returned dict are *not* written back to the corresponding local variables or " +"nonlocal cell references, and assigning, reassigning, or deleting local " +"variables and nonlocal cell references does *not* affect the contents of " +"previously returned dictionaries." +msgstr "" +"W :term:`optimized scope` (włączając w to funkcja, generatory i coroutines), " +"każde wywołanie ``locals()`` zamiast zwracania świeżego słownika zawierający " +"aktualne wiązania zmiennych lokalnych funkcji i wszelkie nielokalne " +"odwołania do komórek. W tym przypadku zmiany powiązań nazw dokonane za " +"pośrednictwem zwróconego dict *nie* są zapisywane z powrotem do odpowiednich " +"zmiennych lokalnych lub nielokalnych odwołań do komórek, a przypisywanie, " +"ponowne przypisywanie lub usuwanie zmiennych lokalnych i nielokalnych " +"odwołań do komórek *nie* wpływa na zawartość wcześniej zwróconego słownika." + +msgid "" +"Calling ``locals()`` as part of a comprehension in a function, generator, or " +"coroutine is equivalent to calling it in the containing scope, except that " +"the comprehension's initialised iteration variables will be included. In " +"other scopes, it behaves as if the comprehension were running as a nested " +"function." +msgstr "" +"Wywołanie ``locals()`` jako części rozumienia w funkcji, generator lub " +"coroutine jest równoważne wywołaniu go w zakresie zawierającym, z wyjątkiem " +"tego, że zainicjowane zmienne iteracyjne rozumienia zostaną uwzględnione. W " +"innych zakresach zachowuje się tak, jakby rozumienie działało jako " +"zagnieżdżone funkcja." + +msgid "" +"Calling ``locals()`` as part of a generator expression is equivalent to " +"calling it in a nested generator function." +msgstr "" +"Wywołanie ``locals()`` jako części wyrażenia generator jest równoważne " +"wywołaniu go w zagnieżdżonym generatorze funkcji ." + +msgid "" +"The behaviour of ``locals()`` in a comprehension has been updated as " +"described in :pep:`709`." +msgstr "" +"Zachowanie ``locals()`` w zrozumieniu została zaktualizowana zgodnie z " +"opisem w :pep:`709`." + +msgid "" +"As part of :pep:`667`, the semantics of mutating the mapping objects " +"returned from this function are now defined. The behavior " +"in :term:`optimized scopes ` is now as described above. " +"Aside from being defined, the behaviour in other scopes remains unchanged " +"from previous versions." +msgstr "" +"Jako część :pep:`667`, semantyka mutowania obiektów mapowania zwróconych z " +"tej funkcji jest teraz zdefiniowana. Zachowanie w :term:`zoptymalizowanych " +"zakresach ` jest teraz opisane powyżej. Poza " +"zdefiniowaniem, zachowanie w innych zakresach pozostaje niezmienione w " +"stosunku do poprzednich wersji." + +msgid "" +"Return an iterator that applies *function* to every item of *iterable*, " +"yielding the results. If additional *iterables* arguments are passed, " +"*function* must take that many arguments and is applied to the items from " +"all iterables in parallel. With multiple iterables, the iterator stops when " +"the shortest iterable is :term:`exhausted`. If *strict* is ``True`` and one " +"of the iterables is exhausted before the others, a :exc:`ValueError` is " +"raised. For cases where the function inputs are already arranged into " +"argument tuples, see :func:`itertools.starmap`." +msgstr "" +"Zwraca iterator, który stosuje funkcję *function* do każdego elementu " +"*iterable*, dając wyniki. Jeśli przekazane zostaną dodatkowe argumenty " +"*iterables*, *funkcja* musi przyjmować taką liczbę argumentów i jest " +"stosowana do elementów ze wszystkich iterabli równolegle. W przypadku wielu " +"iterables, iterator zatrzymuje się, gdy najkrótszy iterable " +"zostanie :term:`wyczerpany `. Jeśli *strict* jest ``True`` i " +"jeden z iterabli wyczerpie się przed innymi, rzucany jest :exc:`ValueError`. " +"Dla przypadków, w których wejścia funkcji są już ułożone w krotki " +"argumentów, zobacz :func:`itertools.starmap`." + +msgid "Added the *strict* parameter." +msgstr "Dodano parametr *strict*." + +msgid "" +"Return the largest item in an iterable or the largest of two or more " +"arguments." +msgstr "" +"Zwraca największy element w iterable'u lub największy z dwóch lub więcej " +"argumentów." + +msgid "" +"If one positional argument is provided, it should be an :term:`iterable`. " +"The largest item in the iterable is returned. If two or more positional " +"arguments are provided, the largest of the positional arguments is returned." +msgstr "" +"Jeśli podano jeden pozycyjny argument, powinien to być :term:`iterable`. " +"Zwracany jest największy element w iterable. Jeśli podano dwa lub więcej " +"argumenty pozycyjne, zwracany jest największy z argumentów pozycyjnych." + +msgid "" +"There are two optional keyword-only arguments. The *key* argument specifies " +"a one-argument ordering function like that used for :meth:`list.sort`. The " +"*default* argument specifies an object to return if the provided iterable is " +"empty. If the iterable is empty and *default* is not provided, " +"a :exc:`ValueError` is raised." +msgstr "" +"Istnieją dwa opcjonalne tylko ze słowem kluczowym argument. *Kluczowy* " +"argument określa jedno-argumentowy uporządkowanie funkcji jak to używane " +"dla :meth:`list.sort`. *Domyślny* argument określa obiekt do zwracania, " +"jeśli podany iterable jest pusty. Jeśli iterable jest pusty i *domyślny* nie " +"jest podany, :exc:`ValueError` jest rzucony." + +msgid "" +"If multiple items are maximal, the function returns the first one " +"encountered. This is consistent with other sort-stability preserving tools " +"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and " +"``heapq.nlargest(1, iterable, key=keyfunc)``." +msgstr "" +"Jeśli wiele elementów jest maksymalnych, funkcja zwraca pierwszy napotkany " +"element. Jest to zgodne z innymi narzędziami zachowującymi stabilność " +"sortowania, takimi jak ``sorted(iterable, key=keyfunc, reverse=True)[0]`` i " +"``heapq.nlargest(1, iterable, key=keyfunc)``." + +msgid "Added the *default* keyword-only parameter." +msgstr "Dodano *default* tylko słowo kluczowe parametr." + +msgid "The *key* can be ``None``." +msgstr "*Kluczem* może być ``None``." + +msgid "" +"Return a \"memory view\" object created from the given argument. " +"See :ref:`typememoryview` for more information." +msgstr "" +"Zwraca obiekt \"memory view\" utworzony z podanego argumentu. Więcej " +"informacji można znaleźć na stronie :ref:`typememoryview`." + +msgid "" +"Return the smallest item in an iterable or the smallest of two or more " +"arguments." +msgstr "" +"Zwraca najmniejszy element w iterable'u lub najmniejszy z dwóch lub więcej " +"argumentów." + +msgid "" +"If one positional argument is provided, it should be an :term:`iterable`. " +"The smallest item in the iterable is returned. If two or more positional " +"arguments are provided, the smallest of the positional arguments is returned." +msgstr "" +"Jeśli podano jeden pozycjny argument, powinien to być :term:`iterable`. " +"Zwracany jest najmniejszy element w iterable. Jeśli podano dwa lub więcej " +"argumenty pozycyjne, zwracany jest najmniejszy z argumentów pozycyjnych." + +msgid "" +"If multiple items are minimal, the function returns the first one " +"encountered. This is consistent with other sort-stability preserving tools " +"such as ``sorted(iterable, key=keyfunc)[0]`` and ``heapq.nsmallest(1, " +"iterable, key=keyfunc)``." +msgstr "" +"Jeśli wiele elementów jest minimalnych, funkcja zwraca pierwszy napotkany. " +"Jest to zgodne z innymi narzędziami zachowującymi stabilność sortowania, " +"takimi jak ``sorted(iterable, key=keyfunc)[0]`` i ``heapq.nsmallest(1, " +"iterable, key=keyfunc)``." + +msgid "" +"Retrieve the next item from the :term:`iterator` by calling " +"its :meth:`~iterator.__next__` method. If *default* is given, it is " +"returned if the iterator is :term:`exhausted`, " +"otherwise :exc:`StopIteration` is raised." +msgstr "" +"Pobiera następny element z :term:`iterator` poprzez wywołanie jego " +"metody :meth:`~iterator.__next__`. Jeśli *domyślny* jest podany, jest " +"zwracany, jeśli iterator jest :term:`wyczerpany `, w przeciwnym " +"razie :exc:`StopIteration` jest rzucony." + +msgid "" +"This is the ultimate base class of all other classes. It has methods that " +"are common to all instances of Python classes. When the constructor is " +"called, it returns a new featureless object. The constructor does not accept " +"any arguments." +msgstr "" +"Jest to ostateczna klasa bazowa wszystkich innych klas. Posiada metody, " +"które są wspólne dla wszystkich instancji klas Pythona. Kiedy konstruktor " +"jest wywoływany, zwraca nowy obiekt bez funkcji. Konstruktor nie akceptuje " +"żadnych argumentów." + +msgid "" +":class:`object` instances do *not* have :attr:`~object.__dict__` attributes, " +"so you can't assign arbitrary attributes to an instance of :class:`object`." +msgstr "" +":class:`object` instancje *nie* mają :attr:`~object.__dict__` atrybut , więc " +"nie można przypisać dowolnego atrybuta do instancji :class:`object`." + +msgid "" +"Convert an integer number to an octal string prefixed with \"0o\". The " +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. For example:" +msgstr "" +"Konwertuje liczbę całkowitą na ósemkowy ciąg znaków z prefiksem \"0o\". " +"Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int`, musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Na przykład:" + +msgid "" +"If you want to convert an integer number to an octal string either with the " +"prefix \"0o\" or not, you can use either of the following ways." +msgstr "" +"Jeśli chcesz przekonwertować liczbę całkowita na ósemkowy napis z " +"przedrostkiem \"0o\" lub bez, możesz użyć jednego z poniższych sposobów." + +msgid "" +"Open *file* and return a corresponding :term:`file object`. If the file " +"cannot be opened, an :exc:`OSError` is raised. See :ref:`tut-files` for more " +"examples of how to use this function." +msgstr "" +"Otwiera *file* i zwraca odpowiedni :term:`obiekt pliku `. " +"Jeśli pliku nie da się otworzyć, rzucany jest :exc:`OSError`. Więcej " +"przykładów użycia tej funkcji można znaleźć w :ref:`tut-files`." + +msgid "" +"*file* is a :term:`path-like object` giving the pathname (absolute or " +"relative to the current working directory) of the file to be opened or an " +"integer file descriptor of the file to be wrapped. (If a file descriptor is " +"given, it is closed when the returned I/O object is closed unless *closefd* " +"is set to ``False``.)" +msgstr "" +"*file* jest :term:`obiektem path-like ` podającym nazwę " +"ścieżki (bezwzględną lub względną do bieżącego katalogu roboczego) pliku, " +"który ma zostać otwarty, lub liczbą całkowitą deskryptora pliku, który ma " +"zostać opakowany. (Jeśli podano deskryptor pliku, jest on zamykany, gdy " +"zwrócony obiekt I/O jest zamykany, chyba że *closefd* jest ustawione na " +"``False``.)" + +msgid "" +"*mode* is an optional string that specifies the mode in which the file is " +"opened. It defaults to ``'r'`` which means open for reading in text mode. " +"Other common values are ``'w'`` for writing (truncating the file if it " +"already exists), ``'x'`` for exclusive creation, and ``'a'`` for appending " +"(which on *some* Unix systems, means that *all* writes append to the end of " +"the file regardless of the current seek position). In text mode, if " +"*encoding* is not specified the encoding used is platform-" +"dependent: :func:`locale.getencoding` is called to get the current locale " +"encoding. (For reading and writing raw bytes use binary mode and leave " +"*encoding* unspecified.) The available modes are:" +msgstr "" +"*mode* to opcjonalny napis , który określa tryb, w którym plik jest " +"otwierany. Domyślnie jest to ``'r'``, co oznacza otwarcie do odczytu w " +"trybie tekstowym. Inne popularne wartości to ``'w'`` dla zapisu (obcinanie " +"pliku, jeśli już istnieje), ``'x'`` dla wyłącznego tworzenia i ``'a'`` dla " +"dołączania (co w *niektórych* systemach Unix oznacza, że *wszystkie* zapisy " +"są dołączane do końca pliku niezależnie od bieżącej pozycji wyszukiwania). " +"W trybie tekstowym, jeśli nie podano *encoding*, używane kodowanie jest " +"zależne od platformy: :func:`locale.getencoding` jest wywoływane w celu " +"uzyskania bieżącego kodowania locale. (Do odczytu i zapisu nieprzetworzonych " +"bajtów należy użyć trybu binarnego i pozostawić *encoding* nieokreślone). " +"Dostępne tryby to:" + +msgid "Character" +msgstr "Znak" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid "``'r'``" +msgstr "``'r'``" + +msgid "open for reading (default)" +msgstr "otwarte do czytania (domyślny)" + +msgid "``'w'``" +msgstr "``'w'``" + +msgid "open for writing, truncating the file first" +msgstr "otworzyć do zapisu, najpierw obcinając plik" + +msgid "``'x'``" +msgstr "``'x'``" + +msgid "open for exclusive creation, failing if the file already exists" +msgstr "" +"otwarcie do wyłącznego utworzenia, niepowodzenie, jeśli plik już istnieje" + +msgid "``'a'``" +msgstr "``'a'``" + +msgid "open for writing, appending to the end of file if it exists" +msgstr "otwarte do zapisu, dołączenie do końca pliku, jeśli istnieje" + +msgid "``'b'``" +msgstr "``'b'``" + +msgid "binary mode" +msgstr "tryb binarny" + +msgid "``'t'``" +msgstr "``'t'``" + +msgid "text mode (default)" +msgstr "tryb tekstowy (domyślny)" + +msgid "``'+'``" +msgstr "``'+'``" + +msgid "open for updating (reading and writing)" +msgstr "otwarte na aktualizację (odczyt i zapis)" + +msgid "" +"The default mode is ``'r'`` (open for reading text, a synonym of ``'rt'``). " +"Modes ``'w+'`` and ``'w+b'`` open and truncate the file. Modes ``'r+'`` and " +"``'r+b'`` open the file with no truncation." +msgstr "" +"Tryb domyślny to ``'r'`` (otwarty do odczytu tekstu, synonim ``'rt'``). " +"Tryby ``'w+'`` i ``'w+b'`` otwierają i obcinają plik. Tryby ``'r+'`` i " +"``'r+b'`` otwierają plik bez obcinania." + +msgid "" +"As mentioned in the :ref:`io-overview`, Python distinguishes between binary " +"and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* " +"argument) return contents as :class:`bytes` objects without any decoding. " +"In text mode (the default, or when ``'t'`` is included in the *mode* " +"argument), the contents of the file are returned as :class:`str`, the bytes " +"having been first decoded using a platform-dependent encoding or using the " +"specified *encoding* if given." +msgstr "" +"Jak wspomniano w :ref:`io-overview`, Python rozróżnia binarne i tekstowe I/" +"O. Pliki otwierane w trybie binarnym (w tym ``'b'`` w *mode* argument) " +"zwracają zawartość jako obiekty :class:`bytes` bez żadnego dekodowania. W " +"trybie tekstowym ( domyślny, lub gdy ``'t'`` jest zawarte w *mode* " +"argument), zawartość pliku jest zwracana jako :class:`str`, bajty zostały " +"najpierw zdekodowane przy użyciu kodowania zależnego od platformy lub przy " +"użyciu określonego *kodowania*, jeśli zostało podane." + +msgid "" +"Python doesn't depend on the underlying operating system's notion of text " +"files; all the processing is done by Python itself, and is therefore " +"platform-independent." +msgstr "" +"Python nie zależy od pojęcia plików tekstowych w systemie operacyjnym; całe " +"przetwarzanie jest wykonywane przez Pythoan i dlatego jest niezależne od " +"platformy." + +msgid "" +"*buffering* is an optional integer used to set the buffering policy. Pass 0 " +"to switch buffering off (only allowed in binary mode), 1 to select line " +"buffering (only usable when writing in text mode), and an integer > 1 to " +"indicate the size in bytes of a fixed-size chunk buffer. Note that " +"specifying a buffer size this way applies for binary buffered I/O, but " +"``TextIOWrapper`` (i.e., files opened with ``mode='r+'``) would have another " +"buffering. To disable buffering in ``TextIOWrapper``, consider using the " +"``write_through`` flag for :func:`io.TextIOWrapper.reconfigure`. When no " +"*buffering* argument is given, the default buffering policy works as follows:" +msgstr "" +"*buffering* to opcjonalna liczba całkowita używana do ustawiania polityki " +"buforowania. Przekaż 0, aby wyłączyć buforowanie (dozwolone tylko w trybie " +"binarnym), 1, aby wybrać buforowanie liniowe (używane tylko podczas pisania " +"w trybie tekstowym) i liczba całkowita > 1, aby wskazać rozmiar w bajtach " +"bufora o stałym rozmiarze. Należy zauważyć, że określenie rozmiaru bufora w " +"ten sposób dotyczy binarnie buforowanego wejścia/wyjścia, ale " +"``TextIOWrapper`` (tj. pliki otwierane za pomocą ``mode='r+'``) będą miały " +"inne buforowanie. Aby wyłączyć buforowanie w ``TextIOWrapper``, należy " +"rozważyć użycie flagi ``write_through`` " +"dla :func:`io.TextIOWrapper.reconfigure`. Gdy nie podano *buforowania* " +"argument, polityka buforowania domyślny działa w następujący sposób:" + +msgid "" +"Binary files are buffered in fixed-size chunks; the size of the buffer is " +"``max(min(blocksize, 8 MiB), DEFAULT_BUFFER_SIZE)`` when the device block " +"size is available. On most systems, the buffer will typically be 128 " +"kilobytes long." +msgstr "" +"Pliki binarne są buforowane w kawałkach o stałym rozmiarze; rozmiar bufora " +"to ``max(min(blocksize, 8 MiB), DEFAULT_BUFFER_SIZE)``, gdy dostępny jest " +"rozmiar bloku urządzenia. W większości systemów rozmiar bufora wynosi " +"zazwyczaj 128 kilobajtów." + +msgid "" +"\"Interactive\" text files (files for which :meth:`~io.IOBase.isatty` " +"returns ``True``) use line buffering. Other text files use the policy " +"described above for binary files." +msgstr "" +"\"Interaktywne\" pliki tekstowe (pliki, dla " +"których :meth:`~io.IOBase.isatty` zwraca ``True`` ) używają buforowania " +"linii. Inne pliki tekstowe używają zasad opisanych powyżej dla plików " +"binarnych." + +msgid "" +"*encoding* is the name of the encoding used to decode or encode the file. " +"This should only be used in text mode. The default encoding is platform " +"dependent (whatever :func:`locale.getencoding` returns), but any :term:`text " +"encoding` supported by Python can be used. See the :mod:`codecs` module for " +"the list of supported encodings." +msgstr "" +"*encoding* to nazwa kodowania używanego do dekodowania lub kodowania pliku. " +"Powinno być używane tylko w trybie tekstowym. Kodowanie domyślne jest " +"zależne od platformy (cokolwiek :func:`locale.getencoding` zwraca ), ale " +"można użyć dowolnego :term:`kodowanie tekstu` obsługiwanego przez Python. " +"Lista obsługiwanych kodowań znajduje się na stronie :mod:`codecs` modułu ." + +msgid "" +"*errors* is an optional string that specifies how encoding and decoding " +"errors are to be handled—this cannot be used in binary mode. A variety of " +"standard error handlers are available (listed under :ref:`error-handlers`), " +"though any error handling name that has been registered " +"with :func:`codecs.register_error` is also valid. The standard names " +"include:" +msgstr "" +"*errors* to opcjonalny napis, który określa sposób obsługi błędów kodowania " +"i dekodowania - nie może być używany w trybie binarnym. Dostępnych jest " +"wiele standardowych programów obsługi błędów (wymienionych w :ref:`error-" +"handlers`), choć każda nazwa obsługi błędów zarejestrowana " +"w :func:`codecs.register_error` jest również ważna. Standardowe nazwy " +"obejmują:" + +msgid "" +"``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " +"error. The default value of ``None`` has the same effect." +msgstr "" +"``'strict'`` do rzucenja wyjątek :exc:`ValueError`, jeśli wystąpi błąd " +"kodowania. Wartość domyślna z ``None`` ma ten sam efekt." + +msgid "" +"``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to " +"data loss." +msgstr "" +"``'ignore'`` ignoruje błędy. Należy pamiętać, że ignorowanie błędów " +"kodowania może prowadzić do utraty danych." + +msgid "" +"``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted " +"where there is malformed data." +msgstr "" +"``'replace'`` powoduje wstawienie znacznika zastępczego (takiego jak " +"``'?'``) tam, gdzie występują zniekształcone dane." + +msgid "" +"``'surrogateescape'`` will represent any incorrect bytes as low surrogate " +"code units ranging from U+DC80 to U+DCFF. These surrogate code units will " +"then be turned back into the same bytes when the ``surrogateescape`` error " +"handler is used when writing data. This is useful for processing files in " +"an unknown encoding." +msgstr "" +"``'surrogateescape'`` będzie reprezentować wszelkie nieprawidłowe bajty jako " +"niskie jednostki kodu zastępczego w zakresie od U+DC80 do U+DCFF. Te " +"jednostki kodu zastępczego zostaną następnie przekształcone z powrotem w te " +"same bajty, gdy podczas zapisu danych zostanie użyta obsługa błędów " +"``surrogateescape``. Jest to przydatne do przetwarzania plików w nieznanym " +"kodowaniu." + +msgid "" +"``'xmlcharrefreplace'`` is only supported when writing to a file. Characters " +"not supported by the encoding are replaced with the appropriate XML " +"character reference :samp:`&#{nnn};`." +msgstr "" +"``'xmlcharrefreplace'`` jest obsługiwany tylko podczas zapisu do pliku. Znak " +"nieobsługiwany przez kodowanie jest zastępowany odpowiednim odniesieniem XML " +"znak :samp:`&#{nnn};` ." + +msgid "" +"``'backslashreplace'`` replaces malformed data by Python's backslashed " +"escape sequences." +msgstr "" +"``'backslashreplace'`` zastępuje zniekształcone dane przez sekwencje " +"specjalne Python'z ukośnikiem wstecznym." + +msgid "" +"``'namereplace'`` (also only supported when writing) replaces unsupported " +"characters with ``\\N{...}`` escape sequences." +msgstr "" +"``'namereplace'`` (również obsługiwane tylko podczas zapisu) zastępuje " +"nieobsługiwane znak sekwencjami ucieczki ``\\N{...}``." + +msgid "" +"*newline* determines how to parse newline characters from the stream. It can " +"be ``None``, ``''``, ``'\\n'``, ``'\\r'``, and ``'\\r\\n'``. It works as " +"follows:" +msgstr "" +"*newline* określa sposób analizowania nowej linii znak ze strumienia. Może " +"to być ``None``, ``''``, ``'\\n'``, ``'\\r'`` i ``'\\r\\n'``. Działa to w " +"następujący sposób:" + +msgid "" +"When reading input from the stream, if *newline* is ``None``, universal " +"newlines mode is enabled. Lines in the input can end in ``'\\n'``, " +"``'\\r'``, or ``'\\r\\n'``, and these are translated into ``'\\n'`` before " +"being returned to the caller. If it is ``''``, universal newlines mode is " +"enabled, but line endings are returned to the caller untranslated. If it " +"has any of the other legal values, input lines are only terminated by the " +"given string, and the line ending is returned to the caller untranslated." +msgstr "" +"Podczas odczytu danych wejściowych ze strumienia, jeśli *newline* to " +"``None``, włączony jest uniwersalny tryb nowych linii. Linie na wejściu " +"mogą kończyć się na ``'\\n'``, ``'\\r'``, lub ``'\\r\\n'``, które są " +"tłumaczone na ``'\\n'`` przed zwróceniem do wywołującego. Jeśli jest to " +"``''``, włączony jest uniwersalny tryb nowych linii, ale zakończenia linii " +"są zwracane do wywołującego bez tłumaczenia. Jeśli ma dowolną z pozostałych " +"legalnych wartości, linie wejściowe są kończone tylko przez podany napis, a " +"zakończenie linii jest zwracane bez tłumaczenia." + +msgid "" +"When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " +"characters written are translated to the system default line " +"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no " +"translation takes place. If *newline* is any of the other legal values, any " +"``'\\n'`` characters written are translated to the given string." +msgstr "" +"Podczas zapisywania danych wyjściowych do strumienia, jeśli *newline* ma " +"wartość ``None``, wszelkie zapisane ``'\\n'`` znaki są tłumaczone na " +"systemowy domyślny separator linii, :data:`os.linesep`. Jeśli *newline* ma " +"wartość ``''`` lub ``'\\n'``, tłumaczenie nie jest wykonywane. Jeśli " +"*newline* jest dowolną z pozostałych legalnych wartości, wszelkie zapisane " +"``'\\n'`` znaki są tłumaczone na podany napis." + +msgid "" +"If *closefd* is ``False`` and a file descriptor rather than a filename was " +"given, the underlying file descriptor will be kept open when the file is " +"closed. If a filename is given *closefd* must be ``True`` (the default); " +"otherwise, an error will be raised." +msgstr "" +"Jeśli *closefd* ma wartość ``False`` i podano deskryptor pliku, a nie nazwę " +"pliku, to bazowy deskryptor pliku pozostanie otwarty po zamknięciu pliku. " +"Jeśli podano nazwę pliku, *closefd* musi mieć wartość ``True`` ( domyślny); " +"w przeciwnym razie wystąpi błąd." + +msgid "" +"A custom opener can be used by passing a callable as *opener*. The " +"underlying file descriptor for the file object is then obtained by calling " +"*opener* with (*file*, *flags*). *opener* must return an open file " +"descriptor (passing :mod:`os.open` as *opener* results in functionality " +"similar to passing ``None``)." +msgstr "" +"Niestandardowy otwieracz może być użyty poprzez przekazanie wywołania jako " +"*opener*. Podstawowy deskryptor pliku dla obiektu pliku jest następnie " +"uzyskiwany przez wywołanie *opener* z (*file*, *flags*). *opener* musi " +"zwracać otwarty deskryptor pliku (przekazanie :mod:`os.open` jako *opener* " +"skutkuje funkcjonalnością podobną do przekazania ``None``)." + +msgid "The newly created file is :ref:`non-inheritable `." +msgstr "Nowo utworzony plik jest :ref:`non-inheritable `." + +msgid "" +"The following example uses the :ref:`dir_fd ` parameter of " +"the :func:`os.open` function to open a file relative to a given directory::" +msgstr "" +"Poniższy przykład używa :ref:`dir_fd ` parametr z :func:`os.open` " +"funkcji do otwarcia pliku względem danego katalogu::" + +msgid "" +">>> import os\n" +">>> dir_fd = os.open('somedir', os.O_RDONLY)\n" +">>> def opener(path, flags):\n" +"... return os.open(path, flags, dir_fd=dir_fd)\n" +"...\n" +">>> with open('spamspam.txt', 'w', opener=opener) as f:\n" +"... print('This will be written to somedir/spamspam.txt', file=f)\n" +"...\n" +">>> os.close(dir_fd) # don't leak a file descriptor" +msgstr "" +">>> import os\n" +">>> dir_fd = os.open('somedir', os.O_RDONLY)\n" +">>> def opener(path, flags):\n" +"... return os.open(path, flags, dir_fd=dir_fd)\n" +"...\n" +">>> with open('spamspam.txt', 'w', opener=opener) as f:\n" +"... print('To zostanie zapisane w somedir/spamspam.txt', file=f)\n" +"...\n" +">>> os.close(dir_fd) # nie ujawniaj deskryptora pliku" + +msgid "" +"The type of :term:`file object` returned by the :func:`open` function " +"depends on the mode. When :func:`open` is used to open a file in a text " +"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass " +"of :class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When " +"used to open a file in a binary mode with buffering, the returned class is a " +"subclass of :class:`io.BufferedIOBase`. The exact class varies: in read " +"binary mode, it returns an :class:`io.BufferedReader`; in write binary and " +"append binary modes, it returns an :class:`io.BufferedWriter`, and in read/" +"write mode, it returns an :class:`io.BufferedRandom`. When buffering is " +"disabled, the raw stream, a subclass " +"of :class:`io.RawIOBase`, :class:`io.FileIO`, is returned." +msgstr "" +"Typ :term:`file object` zwracany przez :func:`open` zależy od trybu. " +"Gdy :func:`open` jest używany do otwarcia pliku w trybie tekstowym (``'w'``, " +"``'r'``, ``'wt'``, ``'rt'``, itd.), to zwracana jest podklasa " +"klasy :class:`io.TextIOBase` (w szczególności :class:`io.TextIOWrapper`). W " +"przypadku użycia do otwarcia pliku w trybie binarnym z buforowaniem, " +"zwracana klasą jest podklasa z :class:`io.BufferedIOBase`. Dokładna klasa " +"różni się: w trybie odczytu binarnego, jest to zwracane " +"z :class:`io.BufferedReader`; w trybach zapisu binarnego i dołączania " +"binarnego, jest to zwracane z :class:`io.BufferedWriter`, a w trybie odczytu/" +"zapisu, jest to zwracane z :class:`io.BufferedRandom`. Gdy buforowanie jest " +"wyłączone, zwracany jest nieprzetworzony strumień, podklasa " +"z :class:`io.RawIOBase`, :class:`io.FileIO`." + +msgid "" +"See also the file handling modules, such as :mod:`fileinput`, :mod:`io` " +"(where :func:`open` is " +"declared), :mod:`os`, :mod:`os.path`, :mod:`tempfile`, and :mod:`shutil`." +msgstr "" +"Zobacz także moduły obsługę plików, takich jak :mod:`fileinput`, :mod:`io` " +"(gdzie " +"zadeklarowano :func:`open` ), :mod:`os`, :mod:`os.path`, :mod:`tempfile` " +"i :mod:`shutil`." + +msgid "" +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " +"``mode``, ``flags``." +msgstr "" +"Rzuca :ref:`auditing event ` ``open`` z argumentami ``path`` , " +"``mode``, ``flags``." + +msgid "" +"The ``mode`` and ``flags`` arguments may have been modified or inferred from " +"the original call." +msgstr "" +"Adresy ``mode`` i ``flags`` argumenty mogły zostać zmodyfikowane lub " +"wywnioskowane z oryginalnego połączenia." + +msgid "The *opener* parameter was added." +msgstr "Dodano *opener* parametr." + +msgid "The ``'x'`` mode was added." +msgstr "Dodano tryb ``'x'``." + +msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." +msgstr ":exc:`IOError` kiedyś był rzucony, teraz jest alias z :exc:`OSError`." + +msgid "" +":exc:`FileExistsError` is now raised if the file opened in exclusive " +"creation mode (``'x'``) already exists." +msgstr "" +":exc:`FileExistsError` jest teraz rzucane, jeśli plik otwarty w trybie " +"wyłącznego tworzenia (``'x'``) już istnieje." + +msgid "The file is now non-inheritable." +msgstr "Plik nie jest teraz dziedziczony." + +msgid "" +"If the system call is interrupted and the signal handler does not raise an " +"exception, the function now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." +msgstr "" +"Jeśli wywołanie systemowe zostanie przerwane, a program obsługi sygnału nie " +"rzuci wyjątku, funkcji ponawia teraz wywołanie systemowe zamiast rzucenja " +"wyjątku :exc:`InterruptedError` (zobacz :pep:`475` dla uzasadnienia)." + +msgid "The ``'namereplace'`` error handler was added." +msgstr "Dodano obsługę błędów ``'namereplace'``." + +msgid "Support added to accept objects implementing :class:`os.PathLike`." +msgstr "" +"Dodano obsługę akceptowania obiektów implementujących :class:`os.PathLike`." + +msgid "" +"On Windows, opening a console buffer may return a subclass " +"of :class:`io.RawIOBase` other than :class:`io.FileIO`." +msgstr "" +"W systemie Windows, otwarcie bufora konsoli może zwracać podklasa " +"z :class:`io.RawIOBase` innego niż :class:`io.FileIO`." + +msgid "The ``'U'`` mode has been removed." +msgstr "Tryb ``'U'`` został usunięty." + +msgid "Return the ordinal value of a character." +msgstr "Zwraca wartość porządkową znaku." + +msgid "" +"If the argument is a one-character string, return the Unicode code point of " +"that character. For example, ``ord('a')`` returns the integer ``97`` and " +"``ord('€')`` (Euro sign) returns ``8364``. This is the inverse " +"of :func:`chr`." +msgstr "" +"Jeśli argument jest jedno-znakowym ciągiem znaków, zwraca punkt kodowy " +"Unicode tego znaku. Na przykład, ``ord('a')`` zwraca liczbę całkowitą ``97`` " +"i ``ord('€')`` (znak euro) zwraca ``8364`` . Jest to odwrotność :func:`chr`." + +msgid "" +"If the argument is a :class:`bytes` or :class:`bytearray` object of length " +"1, return its single byte value. For example, ``ord(b'a')`` returns the " +"integer ``97``." +msgstr "" +"Jeśli argument jest obiektem :class:`bytes` lub :class:`bytearray` o " +"długości 1, zwraca wartość pojedynczego bajtu. Na przykład ``ord(b'a')`` " +"zwraca liczbę całkowitą ``97``." + +msgid "" +"Return *base* to the power *exp*; if *mod* is present, return *base* to the " +"power *exp*, modulo *mod* (computed more efficiently than ``pow(base, exp) % " +"mod``). The two-argument form ``pow(base, exp)`` is equivalent to using the " +"power operator: ``base**exp``." +msgstr "" +"Zwraca *base* do potęgi *exp*; jeśli *mod* jest obecny, zwraca *base* do " +"potęgi *exp*, modulo *mod* (obliczane bardziej efektywnie niż ``pow(base, " +"exp) % mod``). Forma dwóch argumentów ``pow(base, exp)`` jest równoważna " +"użyciu operatora potęgi: ``base**exp``." + +msgid "" +"When arguments are builtin numeric types with mixed operand types, the " +"coercion rules for binary arithmetic operators apply. For :class:`int` " +"operands, the result has the same type as the operands (after coercion) " +"unless the second argument is negative; in that case, all arguments are " +"converted to float and a float result is delivered. For example, ``pow(10, " +"2)`` returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative " +"base of type :class:`int` or :class:`float` and a non-integral exponent, a " +"complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value " +"close to ``3j``. Whereas, for a negative base of type :class:`int` " +"or :class:`float` with an integral exponent, a float result is delivered. " +"For example, ``pow(-9, 2.0)`` returns ``81.0``." +msgstr "" +"Gdy argumenty są wbudowanymi typami numerycznymi z mieszanymi typami " +"operandów, obowiązują zasady koercji dla binarnych operatorów " +"arytmetycznych. Dla operandów :class:`int` wynik ma ten sam typ co operandy " +"(po koercji), chyba że drugi argument jest ujemny; w takim przypadku " +"wszystkie argument są konwertowane na float i dostarczany jest wynik float. " +"Na przykład, ``pow(10, 2)`` zwracać ``100`` , ale ``pow(10, -2)`` zwracać " +"``0.01`` . W przypadku ujemnej podstawy typu :class:`int` " +"lub :class:`float` i wykładnika niecałkowitego wynikiem jest liczba " +"zespolona. Na przykład, ``pow(-9, 0.5)`` zwraca wartość zbliżoną do ``3j``. " +"Natomiast dla ujemnej podstawy typu :class:`int` lub :class:`float` z " +"wykładnikiem całkowitym, dostarczany jest wynik zmiennoprzecinkowy. Na " +"przykład ``pow(-9, 2.0)`` zwraca ``81.0`` ." + +msgid "" +"For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must " +"also be of integer type and *mod* must be nonzero. If *mod* is present and " +"*exp* is negative, *base* must be relatively prime to *mod*. In that case, " +"``pow(inv_base, -exp, mod)`` is returned, where *inv_base* is an inverse to " +"*base* modulo *mod*." +msgstr "" +"Dla operandów :class:`int` *base* i *exp*, jeśli *mod* jest obecny, *mod* " +"musi być również typu liczba całkowita i *mod* musi być niezerowy. Jeśli " +"*mod* jest obecny, a *exp* jest ujemny, *base* musi być względnie pierwsze " +"do *mod*. W takim przypadku zwracana jest wartość ``pow(inv_base, -exp, " +"mod)``, gdzie *inv_base* jest odwrotnością *base* modulo *mod*." + +msgid "Here's an example of computing an inverse for ``38`` modulo ``97``::" +msgstr "Oto przykład obliczania odwrotności dla ``38`` modulo ``97``::" + +msgid "" +">>> pow(38, -1, mod=97)\n" +"23\n" +">>> 23 * 38 % 97 == 1\n" +"True" +msgstr "" +">>> pow(38, -1, mod=97)\n" +"23\n" +">>> 23 * 38 % 97 == 1\n" +"True" + +msgid "" +"For :class:`int` operands, the three-argument form of ``pow`` now allows the " +"second argument to be negative, permitting computation of modular inverses." +msgstr "" +"W przypadku operandów :class:`int`, trzy-argumentowa forma ``pow`` pozwala " +"teraz, aby drugi argument był ujemny, umożliwiając obliczanie odwrotności " +"modularnych." + +msgid "" +"Allow keyword arguments. Formerly, only positional arguments were supported." +msgstr "" +"Zezwalane na argumenty nazwane. Wcześniej obsługiwane były tylko argumenty " +"pozycyjne." + +msgid "" +"Print *objects* to the text stream *file*, separated by *sep* and followed " +"by *end*. *sep*, *end*, *file*, and *flush*, if present, must be given as " +"keyword arguments." +msgstr "" +"Wypisuje *obiekty* do strumienia tekstowego *file*, oddzielone *sep* i " +"zakończone *end*. *sep*, *end*, *file* i *flush*, jeśli występują, muszą " +"być podane jako argument nazwany." + +msgid "" +"All non-keyword arguments are converted to strings like :func:`str` does and " +"written to the stream, separated by *sep* and followed by *end*. Both *sep* " +"and *end* must be strings; they can also be ``None``, which means to use the " +"default values. If no *objects* are given, :func:`print` will just write " +"*end*." +msgstr "" +"Wszystkie non-argumenty nazwane są konwertowane na napis tak jak :func:`str` " +"i zapisywane do strumienia, oddzielone *sep* i *end*. Zarówno *sep* jak i " +"*end* muszą być napisem; mogą być również ``None``, co oznacza użycie " +"wartości domyślne. Jeśli nie podano *objects*, :func:`print` po prostu " +"zapisze *end*." + +msgid "" +"The *file* argument must be an object with a ``write(string)`` method; if it " +"is not present or ``None``, :data:`sys.stdout` will be used. Since printed " +"arguments are converted to text strings, :func:`print` cannot be used with " +"binary mode file objects. For these, use ``file.write(...)`` instead." +msgstr "" +"*Plik* argument musi być obiektem z metodą ``write(string)``; jeśli nie jest " +"obecny lub ``None``, zostanie użyty :data:`sys.stdout`. Ponieważ drukowane " +"argument są konwertowane na tekst napis, :func:`print` nie może być używany " +"z obiektami plików w trybie binarnym. Zamiast tego należy uży " +"``file.write(...)``." + +msgid "" +"Output buffering is usually determined by *file*. However, if *flush* is " +"true, the stream is forcibly flushed." +msgstr "" +"Buforowanie wyjścia jest zwykle określane przez *file*. Jednakże, jeśli " +"*flush* jest prawdą, strumień jest przymusowo opróżniany." + +msgid "Added the *flush* keyword argument." +msgstr "Dodano *flush* argument nazwany." + +msgid "Return a property attribute." +msgstr "Zwraca atrybut właściwości." + +msgid "" +"*fget* is a function for getting an attribute value. *fset* is a function " +"for setting an attribute value. *fdel* is a function for deleting an " +"attribute value. And *doc* creates a docstring for the attribute." +msgstr "" +"*fget* to funkcja do pobierania wartości atrybut. *fset* to funkcja do " +"ustawiania wartości atrybut. *fdel* to funkcja do usuwania wartości " +"atrybut. Z kolei *doc* tworzy docstring dla atrybut." + +msgid "A typical use is to define a managed attribute ``x``::" +msgstr "" +"Typowym zastosowaniem jest zdefiniowanie zarządzanego atrybutu ``x`` ::" + +msgid "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" def getx(self):\n" +" return self._x\n" +"\n" +" def setx(self, value):\n" +" self._x = value\n" +"\n" +" def delx(self):\n" +" del self._x\n" +"\n" +" x = property(getx, setx, delx, \"I'm the 'x' property.\")" +msgstr "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" def getx(self):\n" +" return self._x\n" +"\n" +" def setx(self, value):\n" +" self._x = value\n" +"\n" +" def delx(self):\n" +" del self._x\n" +"\n" +" x = property(getx, setx, delx, \"I'm the 'x' property.\")" + +msgid "" +"If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = " +"value`` will invoke the setter, and ``del c.x`` the deleter." +msgstr "" +"Jeśli *c* jest instancją *C*, ``c.x`` wywoła getter, ``c.x = value`` wywoła " +"setter, a ``del c.x`` deleter." + +msgid "" +"If given, *doc* will be the docstring of the property attribute. Otherwise, " +"the property will copy *fget*'s docstring (if it exists). This makes it " +"possible to create read-only properties easily using :deco:`property` as " +"a :term:`decorator`::" +msgstr "" +"Jeśli zostanie podana, *doc* będzie docstringiem atrybutu właściwości. W " +"przeciwnym razie właściwość skopiuje docstring *fget* (jeśli istnieje). " +"Umożliwia to łatwe tworzenie właściwości tylko do odczytu przy " +"użyciu :deco:`property` jako :term:`dekoratora `::" + +msgid "" +"class Parrot:\n" +" def __init__(self):\n" +" self._voltage = 100000\n" +"\n" +" @property\n" +" def voltage(self):\n" +" \"\"\"Get the current voltage.\"\"\"\n" +" return self._voltage" +msgstr "" +"class Parrot:\n" +" def __init__(self):\n" +" self._voltage = 100000\n" +"\n" +" @property\n" +" def voltage(self):\n" +" \"\"\"Uzyska aktualne napięcie.\"\"\n" +" return self._voltage" + +msgid "" +"The ``@property`` decorator turns the :meth:`!voltage` method into a " +"\"getter\" for a read-only attribute with the same name, and it sets the " +"docstring for *voltage* to \"Get the current voltage.\"" +msgstr "" +"``@property`` dekorator zamienia metodę :meth:`!voltage` w \"getter\" dla " +"tylko do odczytu atrybut o tej samej nazwie i ustawia docstring dla " +"*voltage* na \"Get the current voltage\"." + +msgid "" +"A property object has ``getter``, ``setter``, and ``deleter`` methods usable " +"as decorators that create a copy of the property with the corresponding " +"accessor function set to the decorated function. This is best explained " +"with an example:" +msgstr "" +"Obiekt właściwości ma metody ``getter``, ``setter`` i ``deleter`` używane " +"jako dekorator, które tworzą kopię właściwości z odpowiednim akcesorem " +"funkcji ustawionym na dekorowany funkcja. Najlepiej wyjaśnić to na " +"przykładzie:" + +msgid "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" @property\n" +" def x(self):\n" +" \"\"\"I'm the 'x' property.\"\"\"\n" +" return self._x\n" +"\n" +" @x.setter\n" +" def x(self, value):\n" +" self._x = value\n" +"\n" +" @x.deleter\n" +" def x(self):\n" +" del self._x" +msgstr "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" @property\n" +" def x(self):\n" +" \"\"\"I'm the 'x' property.\"\"\"\n" +" return self._x\n" +"\n" +" @x.setter\n" +" def x(self, value):\n" +" self._x = value\n" +"\n" +" @x.deleter\n" +" def x(self):\n" +" del self._x" + +msgid "" +"This code is exactly equivalent to the first example. Be sure to give the " +"additional functions the same name as the original property (``x`` in this " +"case.)" +msgstr "" +"Ten kod jest dokładnie taki sam jak w pierwszym przykładzie. Pamiętaj, aby " +"nadać dodatkowym funkcjom takie same nazwy jak oryginalnej właściwości (w " +"tym przypadku ``x``)." + +msgid "" +"The returned property object also has the attributes ``fget``, ``fset``, and " +"``fdel`` corresponding to the constructor arguments." +msgstr "" +"Zwrócony obiekt właściwości ma również atrybutow ``fget`` , ``fset`` i " +"``fdel`` odpowiadające konstruktor argumentu." + +msgid "The docstrings of property objects are now writeable." +msgstr "Dokumentacja obiektów właściwości sa teraz zapisywalne." + +msgid "" +"Attribute holding the name of the property. The name of the property can be " +"changed at runtime." +msgstr "" +"Atrybut przechowująca nazwę właściwości. Nazwa właściwości może zostać " +"zmieniona w czasie wykonywania." + +msgid "" +"Rather than being a function, :class:`range` is actually an immutable " +"sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`." +msgstr "" +"Zamiast być funkcja, :class:`range` jest w rzeczywistości niezmiennym typem " +"sekwencji, jak udokumentowano w :ref:`typesseq-range` i :ref:`typesseq`." + +msgid "" +"Return a string containing a printable representation of an object. For " +"many types, this function makes an attempt to return a string that would " +"yield an object with the same value when passed to :func:`eval`; otherwise, " +"the representation is a string enclosed in angle brackets that contains the " +"name of the type of the object together with additional information often " +"including the name and address of the object. A class can control what this " +"function returns for its instances by defining a :meth:`~object.__repr__` " +"method. If :func:`sys.displayhook` is not accessible, this function will " +"raise :exc:`RuntimeError`." +msgstr "" +"Zwraca napis zawierający nadającą się do druku reprezentację obiektu. W " +"przypadku wielu typów, ta funkcja podejmuje próbę zwracanja napisu, która " +"dałaby obiekt o tej samej wartości po przekazaniu do :func:`eval`; w " +"przeciwnym razie reprezentacja jest napisem ujęta w nawiasy kątowe, które " +"zawierają nazwę typu obiektu wraz z dodatkowymi informacjami, często " +"zawierającymi nazwę i adres obiektu. Klasa może kontrolować co funkcja " +"zwraca dla swoich instancji, definiując metodę :meth:`~object.__repr__`. " +"Jeśli :func:`sys.displayhook` nie jest dostępna, ta funkcja będzie " +"rzucona :exc:`RuntimeError` ." + +msgid "This class has a custom representation that can be evaluated::" +msgstr "Ta klasa ma niestandardową reprezentację, którą można ocenić::" + +msgid "" +"class Person:\n" +" def __init__(self, name, age):\n" +" self.name = name\n" +" self.age = age\n" +"\n" +" def __repr__(self):\n" +" return f\"Person('{self.name}', {self.age})\"" +msgstr "" +"class Osoba:\n" +" def __init__(self, imie, wiek):\n" +" self.imie = imie\n" +" self.wiek = wiek\n" +"\n" +" def __repr__(self):\n" +" zwracać f \"Person('{self.imie}', {self.wiek})\"." + +msgid "" +"Return a reverse :term:`iterator`. The argument must be an object which has " +"a :meth:`~object.__reversed__` method or supports the sequence protocol " +"(the :meth:`~object.__len__` method and the :meth:`~object.__getitem__` " +"method with integer arguments starting at ``0``)." +msgstr "" +"Zwraca odwrócony :term:`iterator`. Argument musi być obiektem, który ma " +"metodę :meth:`~object.__reversed__` lub obsługuje protokół sekwencji " +"(metoda :meth:`~object.__len__` i metoda :meth:`~object.__getitem__` z " +"całkowitymi argumentami począwszy od ``0``)." + +msgid "" +"Return *number* rounded to *ndigits* precision after the decimal point. If " +"*ndigits* is omitted or is ``None``, it returns the nearest integer to its " +"input." +msgstr "" +"Zwraca *liczba* zaokrąglona do *cyfr* po przecinku dziesiętnym. Jeśli " +"*ndigits* zostanie pominięte lub będzie ``None``, to zwraca najbliższa " +"liczbe całkowita wartości wejściowej." + +msgid "" +"For the built-in types supporting :func:`round`, values are rounded to the " +"closest multiple of 10 to the power minus *ndigits*; if two multiples are " +"equally close, rounding is done toward the even choice (so, for example, " +"both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and ``round(1.5)`` is " +"``2``). Any integer value is valid for *ndigits* (positive, zero, or " +"negative). The return value is an integer if *ndigits* is omitted or " +"``None``. Otherwise, the return value has the same type as *number*." +msgstr "" +"Dla typów wbudowanych wspierających :func:`round`, wartości są zaokrąglane " +"do najbliższej wielokrotności 10 do potęgi minus *ndigits*; jeśli dwie " +"wielokrotności są równie bliskie, zaokrąglanie jest wykonywane w kierunku " +"parzystego wyboru (więc, na przykład, zarówno ``round(0.5)`` jak i " +"``round(-0.5)`` są ``0``, a ``round(1.5)`` jest ``2``). Każda wartość " +"liczby całkowitej jest ważna dla *cyfr* (dodatnich, zerowych lub ujemnych). " +"zwracana wartość jest liczba całkowita jeśli *ndigits* jest pominięte lub " +"``None``. W przeciwnym razie zwracana wartość ma ten sam typ co *number*." + +msgid "" +"For a general Python object ``number``, ``round`` delegates to " +"``number.__round__``." +msgstr "" +"Dla ogólnego obiektu Python ``number`` , ``round`` deleguje do " +"``number.__round__``." + +msgid "" +"The behavior of :func:`round` for floats can be surprising: for example, " +"``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is " +"not a bug: it's a result of the fact that most decimal fractions can't be " +"represented exactly as a float. See :ref:`tut-fp-issues` for more " +"information." +msgstr "" +"Zachowanie :func:`round` dla zmiennoprzecinkowych może być zaskakujący: na " +"przykład, ``round(2.675, 2)`` daje ``2.67`` zamiast oczekiwanego ``2.68``. " +"Nie jest to błąd: wynika to z faktu, że większość ułamków dziesiętnych nie " +"może być reprezentowana dokładnie jako liczba zmiennoprzecinkowa. Więcej " +"informacji można znaleźć na stronie :ref:`tut-fp-issues`." + +msgid "" +"Return a new :class:`set` object, optionally with elements taken from " +"*iterable*. :class:`set` is a built-in class. See also :ref:`types-set` " +"for documentation about this class." +msgstr "" +"Zwraca nowy obiekt :class:`set`, opcjonalnie z elementami z " +"*iterable*. :class:`set` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." + +msgid "" +"For other containers see the built-" +"in :class:`frozenset`, :class:`list`, :class:`tuple`, and :class:`dict` " +"classes, as well as the :mod:`collections` module." +msgstr "" +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`frozenset` , :class:`list`, :class:`tuple` " +"i :class:`dict`, jak również :mod:`collections` moduł ." + +msgid "" +"This is the counterpart of :func:`getattr`. The arguments are an object, a " +"string, and an arbitrary value. The string may name an existing attribute " +"or a new attribute. The function assigns the value to the attribute, " +"provided the object allows it. For example, ``setattr(x, 'foobar', 123)`` " +"is equivalent to ``x.foobar = 123``." +msgstr "" +"Jest to odpowiednik :func:`getattr`. Argumenty to obiekt, napis i dowolna " +"wartość. Napis może nazywać istniejący atrybut lub nowy atrybut. Funkcja " +"przypisuje wartość do atrybut, pod warunkiem, że obiekt na to pozwala. Na " +"przykład, ``setattr(x, 'foobar', 123)`` jest równoważne ``x.foobar = 123``." + +msgid "" +"*name* need not be a Python identifier as defined in :ref:`identifiers` " +"unless the object chooses to enforce that, for example in a " +"custom :meth:`~object.__getattribute__` or via :attr:`~object.__slots__`. An " +"attribute whose name is not an identifier will not be accessible using the " +"dot notation, but is accessible through :func:`getattr` etc.." +msgstr "" +"*name* nie musi być identyfikatorem Pythona zdefiniowanym " +"w :ref:`identifiers`, chyba że obiekt zdecyduje się to wymusić, na przykład " +"w niestandardowym :meth:`~object.__getattribute__` lub " +"poprzez :attr:`~object.__slots__`. Obiekt atrybut, którego nazwa nie jest " +"identyfikatorem, nie będzie dostępny przy użyciu notacji kropkowej, ale " +"będzie dostępny za pośrednictwem :func:`getattr` itd." + +msgid "" +"Since :ref:`private name mangling ` happens at " +"compilation time, one must manually mangle a private attribute's (attributes " +"with two leading underscores) name in order to set it with :func:`setattr`." +msgstr "" +"Ponieważ :ref:`mangling nazwy prywatnej ` ma miejsce " +"w czasie kompilacji, należy ręcznie zmienić nazwę prywatnego atrybutu " +"(atrybut z dwoma wiodącymi podkreśleniami), aby ustawić ją z :func:`setattr`." + +msgid "" +"Return a :term:`slice` object representing the set of indices specified by " +"``range(start, stop, step)``. The *start* and *step* arguments default to " +"``None``." +msgstr "" +"Zwraca obiekt :term:`slice` reprezentujący zbiór indeksów określonych przez " +"``range(start, stop, step)``. *start* i *step* argumenty domyślne do " +"``None``." + +msgid "" +"Slice objects are also generated when :ref:`slicing syntax ` is " +"used. For example: ``a[start:stop:step]`` or ``a[start:stop, i]``." +msgstr "" +"Obiekty slice są również generowane, gdy używana jest :ref:`składnia " +"slicingu `. Na przykład: ``a[start:stop:step]`` lub " +"``a[start:stop, i]``." + +msgid "" +"See :func:`itertools.islice` for an alternate version that returns " +"an :term:`iterator`." +msgstr "" +"Zobacz :func:`itertools.islice` dla alternatywnej wersji, która " +"zwraca :term:`iterator`." + +msgid "" +"These read-only attributes are set to the argument values (or their " +"default). They have no other explicit functionality; however, they are used " +"by NumPy and other third-party packages." +msgstr "" +"Te atrybuty tylko-do-odczytu są ustawione na wartości argumentów (lub ich " +"wartości domyślne). Nie mają one żadnej innej wyraźnej funkcjonalności; są " +"jednak używane przez NumPy i inne zewnętrzne pakiety." + +msgid "" +"Slice objects are now :term:`hashable` " +"(provided :attr:`~slice.start`, :attr:`~slice.stop`, and :attr:`~slice.step` " +"are hashable)." +msgstr "" +"Obiekty Slice są teraz :term:`hashable` (pod warunkiem, " +"że :attr:`~slice.start`, :attr:`~slice.stop` i :attr:`~slice.step` są " +"hashable)." + +msgid "Return a new sorted list from the items in *iterable*." +msgstr "Zwraca nową posortowaną listę z elementów w *iterable*." + +msgid "" +"Has two optional arguments which must be specified as keyword arguments." +msgstr "" +"Posiada dwa opcjonalne argumenty, które muszą być określone jako argument " +"nazwany." + +msgid "" +"*key* specifies a function of one argument that is used to extract a " +"comparison key from each element in *iterable* (for example, " +"``key=str.lower``). The default value is ``None`` (compare the elements " +"directly)." +msgstr "" +"*key* określa funkcje jednego argumentu, który jest używany do wyodrębnienia " +"klucza porównania z każdego elementu w *iterable* (na przykład " +"``key=str.lower``). Wartość domyślna to ``None`` (bezpośrednie porównanie " +"elementów)." + +msgid "" +"*reverse* is a boolean value. If set to ``True``, then the list elements " +"are sorted as if each comparison were reversed." +msgstr "" +"*reverse* jest wartością logiczną. Jeśli jest ustawiona na ``True``, " +"elementy listy są sortowane tak, jakby każde porównanie było odwrócone." + +msgid "" +"Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a " +"*key* function." +msgstr "" +"Użyj :func:`functools.cmp_to_key` do konwersji starego stylu *cmp* funkcja " +"na *key* funkcja." + +msgid "" +"The built-in :func:`sorted` function is guaranteed to be stable. A sort is " +"stable if it guarantees not to change the relative order of elements that " +"compare equal --- this is helpful for sorting in multiple passes (for " +"example, sort by department, then by salary grade)." +msgstr "" +"Wbudowana :func:`sorted` funkcja ma gwarancję stabilności. Sortowanie jest " +"stabilne, jeśli gwarantuje, że nie zmieni względnej kolejności elementów, " +"które porównują równe --- jest to pomocne przy sortowaniu w wielu " +"przejściach (na przykład sortowanie według działu, a następnie według " +"kategorii wynagrodzenia)." + +msgid "" +"The sort algorithm uses only ``<`` comparisons between items. While " +"defining an :meth:`~object.__lt__` method will suffice for sorting, :PEP:`8` " +"recommends that all six :ref:`rich comparisons ` be " +"implemented. This will help avoid bugs when using the same data with other " +"ordering tools such as :func:`max` that rely on a different underlying " +"method. Implementing all six comparisons also helps avoid confusion for " +"mixed type comparisons which can call the reflected :meth:`~object.__gt__` " +"method." +msgstr "" +"Algorytm sortowania używa tylko porównań ``<`` między elementami. Podczas " +"gdy zdefiniowanie metoda :meth:`~object.__lt__` wystarczy do " +"sortowania, :PEP:`8` zaleca zaimplementowanie wszystkich " +"sześciu :ref:`bogatych porównań `. Pomoże to uniknąć błędów " +"podczas korzystania z tych samych danych z innymi narzędziami " +"porządkującymi, takimi jak :func:`max`, które opierają się na innej metodzie " +"bazowej. Zaimplementowanie wszystkich sześciu porównań pomaga również " +"uniknąć nieporozumień w przypadku porównań typów mieszanych, które mogą " +"wywoływać metodę :meth:`~object.__gt__`." + +msgid "" +"For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." +msgstr "" +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." + +msgid "Transform a method into a static method." +msgstr "Przekształcenie metody w metodę statyczną." + +msgid "" +"A static method does not receive an implicit first argument. To declare a " +"static method, use this idiom::" +msgstr "" +"Metoda statyczna nie otrzymuje niejawnego pierwszego argumentu. Aby " +"zadeklarować metodę statyczną, użyj tego idiomu::" + +msgid "" +"class C:\n" +" @staticmethod\n" +" def f(arg1, arg2, argN): ..." +msgstr "" +"class C:\n" +" @staticmethod\n" +" def f(arg1, arg2, argN): ..." + +msgid "" +"The ``@staticmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." +msgstr "" +"Forma ``@staticmethod`` to :term:`dekorator` funkcji -- " +"zobacz :ref:`function` po szczegóły." + +msgid "" +"A static method can be called either on the class (such as ``C.f()``) or on " +"an instance (such as ``C().f()``). Moreover, the static " +"method :term:`descriptor` is also callable, so it can be used in the class " +"definition (such as ``f()``)." +msgstr "" +"Metoda statyczna może być wywołana na klasie (np. ``C.f()``) lub na " +"instancji (np. ``C().f()``). Co więcej, metoda statyczna :term:`descriptor` " +"jest również wywoływalna, więc może być użyta w definicja klasy (np. " +"``f()``)." + +msgid "" +"Static methods in Python are similar to those found in Java or C++. Also, " +"see :deco:`classmethod` for a variant that is useful for creating alternate " +"class constructors." +msgstr "" +"Metody statyczne w Pythonie są podobne do tych, które można znaleźć w Java " +"lub C++. Zobacz także :deco:`classmethod`, aby zapoznać się z wariantem, " +"który jest przydatny do tworzenia alternatywnych konstruktorów klas." + +msgid "" +"Like all decorators, it is also possible to call ``staticmethod`` as a " +"regular function and do something with its result. This is needed in some " +"cases where you need a reference to a function from a class body and you " +"want to avoid the automatic transformation to instance method. For these " +"cases, use this idiom::" +msgstr "" +"Podobnie jak wszystkie dekoratory, możliwe jest również wywołanie " +"``staticmethod`` jako zwykłoł funkcje i zrobienie czegoś z jego wynikiem. " +"Jest to potrzebne w niektórych przypadkach, gdy potrzebujesz odniesienia do " +"funkcji z ciałej klasy i chcesz uniknąć automatycznej transformacji do " +"metody instancji. W takich przypadkach należy użyć tego idiomu::" + +msgid "" +"def regular_function():\n" +" ...\n" +"\n" +"class C:\n" +" method = staticmethod(regular_function)" +msgstr "" +"def regular_function():\n" +" ...\n" +"\n" +"class C:\n" +" method = staticmethod(regular_function)" + +msgid "For more information on static methods, see :ref:`types`." +msgstr "" +"Więcej informacji na temat metod statycznych można znaleźć na " +"stronie :ref:`types`." + +msgid "" +"Static methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`), have a new ``__wrapped__`` " +"attribute, and are now callable as regular functions." +msgstr "" +"Metody statyczne dziedziczą teraz metodę atrybut " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`), mają nową ``__wrapped__`` atrybut i są " +"teraz wywoływane jako zwykła funkcja." + +msgid "" +"Return a :class:`str` version of *object*. See :func:`str` for details." +msgstr "" +"Zwraca :class:`str` wersja of *object*. Szczegółowe informacje można " +"znaleźć na stronie :func:`str`." + +msgid "" +"``str`` is the built-in string :term:`class`. For general information about " +"strings, see :ref:`textseq`." +msgstr "" +"``str`` jest wbudowanem napisem :term:`class`. Aby uzyskać ogólne " +"informacje na temat napisow, zobacz :ref:`textseq`." + +msgid "" +"Sums *start* and the items of an *iterable* from left to right and returns " +"the total. The *iterable*'s items are normally numbers, and the start value " +"is not allowed to be a string." +msgstr "" +"Sumuje *start* i elementy *iterable* od lewej do prawej i zwraca sumę. " +"Elementy *iterable* są zwykle liczbami, a wartością początkową nie może być " +"napisem." + +msgid "" +"For some use cases, there are good alternatives to :func:`sum`. The " +"preferred, fast way to concatenate a sequence of strings is by calling " +"``''.join(sequence)``. To add floating-point values with extended " +"precision, see :func:`math.fsum`\\. To concatenate a series of iterables, " +"consider using :func:`itertools.chain`." +msgstr "" +"W niektórych przypadkach istnieją dobra alternatywa dla :func:`sum`. " +"Preferowanym, szybkim sposobem na łączyć sekwencji napisów jest wywołanie " +"``''.join(sequence)``. Aby dodać wartości zmiennoprzecinkowe z rozszerzoną " +"precyzją, zobacz :func:`math.fsum`\\. Aby łączyć serię iterable, należy " +"rozważyć użycie :func:`itertools.chain`." + +msgid "The *start* parameter can be specified as a keyword argument." +msgstr "Parametr *start* można określić jako argument nazwany." + +msgid "" +"Summation of floats switched to an algorithm that gives higher accuracy and " +"better commutativity on most builds." +msgstr "" +"Sumowanie zmiennoprzecinkowe zostało przełączone na algorytm, który zapewnia " +"większą dokładność i lepszą przemienność w większości kompilacji." + +msgid "" +"Added specialization for summation of complexes, using same algorithm as for " +"summation of floats." +msgstr "" +"Dodano specjalizację dla sumowania liczb zespolonych, używając tego samego " +"algorytmu co dla sumowania liczb zmiennoprzecinkowych." + +msgid "" +"Return a proxy object that delegates method calls to a parent or sibling " +"class of *type*. This is useful for accessing inherited methods that have " +"been overridden in a class." +msgstr "" +"Zwraca obiekt proxy, który deleguje wywołania metod do klasy nadrzędnej lub " +"rodzeństwa *type*. Jest to przydatne do uzyskiwania dostępu do " +"odziedziczonych metod, które zostały przesłonięte w klasie." + +msgid "" +"The *object_or_type* determines the :term:`method resolution order` to be " +"searched. The search starts from the class right after the *type*." +msgstr "" +"*object_or_type* określa :term:`method resolution order` do przeszukania. " +"Wyszukiwanie rozpoczyna się od klasy zaraz po *type*." + +msgid "" +"For example, if :attr:`~type.__mro__` of *object_or_type* is ``D -> B -> C " +"-> A -> object`` and the value of *type* is ``B``, then :func:`super` " +"searches ``C -> A -> object``." +msgstr "" +"Na przykład, jeśli :attr:`~type.__mro__` z *object_or_type* jest ``D -> B -> " +"C -> A -> object`` i wartość *type* jest ``B``, to :func:`super` wyszukuje " +"``C -> A -> object``." + +msgid "" +"The :attr:`~type.__mro__` attribute of the class corresponding to " +"*object_or_type* lists the method resolution search order used by " +"both :func:`getattr` and :func:`super`. The attribute is dynamic and can " +"change whenever the inheritance hierarchy is updated." +msgstr "" +":attr:`~type.__mro__` atrybut klasy odpowiadającej *object_or_type* wymienia " +"kolejność wyszukiwania metod używaną zarówno przez :func:`getattr` jak " +"i :func:`super`. Adres atrybut jest dynamiczny i może ulec zmianie przy " +"każdej aktualizacji hierarchii dziedziczenia." + +msgid "" +"If the second argument is omitted, the super object returned is unbound. If " +"the second argument is an object, ``isinstance(obj, type)`` must be true. " +"If the second argument is a type, ``issubclass(type2, type)`` must be true " +"(this is useful for classmethods)." +msgstr "" +"Jeśli drugi argument zostanie pominięty, zwrócony superobiekt jest " +"niezwiązany. Jeśli drugi argument jest obiektem, ``isinstance(obj, type)`` " +"musi być prawda. Jeśli drugi argument jest typem, ``issubclass(type2, " +"type)`` musi być prawda (jest to przydatne dla metod klasowych)." + +msgid "" +"When called directly within an ordinary method of a class, both arguments " +"may be omitted (\"zero-argument :func:`!super`\"). In this case, *type* will " +"be the enclosing class, and *obj* will be the first argument of the " +"immediately enclosing function (typically ``self``). (This means that zero-" +"argument :func:`!super` will not work as expected within nested functions, " +"including generator expressions, which implicitly create nested functions.)" +msgstr "" +"W przypadku wywołania bezpośrednio w zwykłej metodzie klasy, obie argument " +"mogą zostać pominięte (\"zero-argument :func:`!super` \"). W takim przypadku " +"*type* będzie klasą otaczającą, a *obj* będzie pierwszym argumentem " +"bezpośrednio otaczającego funkcje (zazwyczaj ``self``). (Oznacza to, że zero-" +"argument :func:`!super` nie będzie działać zgodnie z oczekiwaniami wewnątrz " +"zagnieżdżonych funkci, w tym wyrażeń generator, które domyślnie tworzą " +"zagnieżdżone funkcje)." + +msgid "" +"There are two typical use cases for *super*. In a class hierarchy with " +"single inheritance, *super* can be used to refer to parent classes without " +"naming them explicitly, thus making the code more maintainable. This use " +"closely parallels the use of *super* in other programming languages." +msgstr "" +"Istnieją dwa typowe przypadki użycia *super*. W hierarchii klas z " +"pojedynczym dziedziczeniem, *super* może być używany do odwoływania się do " +"klas nadrzędnych bez ich jawnego nazywania, dzięki czemu kod jest łatwiejszy " +"w utrzymaniu. To zastosowanie jest bardzo podobne do użycia *super* w " +"innych językach programowania." + +msgid "" +"The second use case is to support cooperative multiple inheritance in a " +"dynamic execution environment. This use case is unique to Python and is not " +"found in statically compiled languages or languages that only support single " +"inheritance. This makes it possible to implement \"diamond diagrams\" where " +"multiple base classes implement the same method. Good design dictates that " +"such implementations have the same calling signature in every case (because " +"the order of calls is determined at runtime, because that order adapts to " +"changes in the class hierarchy, and because that order can include sibling " +"classes that are unknown prior to runtime)." +msgstr "" +"Drugim przypadkiem użycia jest obsługa kooperatywnego dziedziczenia " +"wielokrotnego w dynamicznym środowisku wykonawczym. Ten przypadek użycia " +"jest unikalny dla Python i nie występuje w statycznie kompilowanych językach " +"lub językach, które obsługują tylko pojedyncze dziedziczenie. Umożliwia to " +"implementację \"diagramów diamentowych\", w których wiele klas bazowych " +"implementuje tę samą metodę. Dobry projekt nakazuje, aby takie " +"implementacje miały tę samą sygnaturę wywołania w każdym przypadku (ponieważ " +"kolejność wywołań jest określana w czasie wykonywania, ponieważ kolejność ta " +"dostosowuje się do zmian w hierarchii klas i ponieważ kolejność ta może " +"obejmować klasy rodzeństwa, które są nieznane przed uruchomieniem)." + +msgid "For both use cases, a typical superclass call looks like this::" +msgstr "W obu przypadkach typowe wywołanie superklasy wygląda następująco::" + +msgid "" +"class C(B):\n" +" def method(self, arg):\n" +" super().method(arg) # This does the same thing as:\n" +" # super(C, self).method(arg)" +msgstr "" +"class C(B):\n" +" def methoda(self, arg):\n" +" super().methoda(arg) # To robi to samo co:\n" +" # super(C, self).methoda(arg)" + +msgid "" +"In addition to method lookups, :func:`super` also works for attribute " +"lookups. One possible use case for this is calling :term:`descriptors " +"` in a parent or sibling class." +msgstr "" +"Oprócz wyszukiwania metod, :func:`super` działa również dla wyszukiwania " +"atrybut. Jednym z możliwych przypadków użycia jest " +"wywołanie :term:`descriptors ` w klasie nadrzędnej lub " +"podrzędnej." + +msgid "" +"Note that :func:`super` is implemented as part of the binding process for " +"explicit dotted attribute lookups such as ``super().__getitem__(name)``. It " +"does so by implementing its own :meth:`~object.__getattribute__` method for " +"searching classes in a predictable order that supports cooperative multiple " +"inheritance. Accordingly, :func:`super` is undefined for implicit lookups " +"using statements or operators such as ``super()[name]``." +msgstr "" +"Należy zauważyć, że :func:`super` jest zaimplementowany jako część wiązania " +"przetwarzanie/proces dla jawnego wyszukiwania kropkowego atrybut, takiego " +"jak ``super().__getitem__(name)``. Czyni to poprzez implementację własnej " +"metody :meth:`~object.__getattribute__` do wyszukiwania klas w " +"przewidywalnej kolejności, która obsługuje wielokrotne dziedziczenie oparte " +"na współpracy. Odpowiednio, :func:`super` jest niezdefiniowany dla " +"niejawnych wyszukiwań przy użyciu instrukcja lub operatorów takich jak " +"``super()[name]``." + +msgid "" +"Also note that, aside from the zero argument form, :func:`super` is not " +"limited to use inside methods. The two argument form specifies the " +"arguments exactly and makes the appropriate references. The zero argument " +"form only works inside a class definition, as the compiler fills in the " +"necessary details to correctly retrieve the class being defined, as well as " +"accessing the current instance for ordinary methods." +msgstr "" +"Należy również pamiętać, że poza formą zero argument, :func:`super` nie jest " +"ograniczona do użycia wewnątrz metod. Dwie formy argumentów dokładnie " +"określają argumenty i tworzą odpowiednie odniesienia. Forma zero argumentów " +"działa tylko wewnątrz definicja klasy, ponieważ kompilator wypełnia " +"niezbędne szczegóły, aby poprawnie pobrać definiowaną klasę, a także uzyskać " +"dostęp do bieżącej instancji dla zwykłych metod." + +msgid "" +"For practical suggestions on how to design cooperative classes " +"using :func:`super`, see `guide to using super() `_." +msgstr "" +"Praktyczne sugestie dotyczące projektowania klas współpracujących przy " +"użyciu :func:`super` można znaleźć w `poradniku korzystania z super() " +"`_." + +msgid "" +":class:`super` objects are now :mod:`pickleable ` " +"and :mod:`copyable `." +msgstr "" +"Obiekty :class:`super` współpracują teraz z modułami :mod:`pickle` " +"i :mod:`copy`." + +msgid "" +"Rather than being a function, :class:`tuple` is actually an immutable " +"sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`." +msgstr "" +"Zamiast być funkcja, :class:`tuple` jest w rzeczywistości niezmiennym typem " +"sekwencji, jak udokumentowano w :ref:`typesseq-tuple` i :ref:`typesseq`." + +msgid "" +"With one argument, return the type of an *object*. The return value is a " +"type object and generally the same object as returned " +"by :attr:`object.__class__`." +msgstr "" +"Z jednym argumentem, zwraca typ obiektu *object*. Zwracana wartość to " +"obiekt typu i generalnie jest to ten sam obiekt, który został zwrócony " +"przez :attr:`object.__class__`." + +msgid "" +"The :func:`isinstance` built-in function is recommended for testing the type " +"of an object, because it takes subclasses into account." +msgstr "" +"Funkcja wbudowana :func:`isinstance` jest zalecana do testowania typu " +"obiektu, ponieważ uwzględnia podklasy." + +msgid "" +"With three arguments, return a new type object. This is essentially a " +"dynamic form of the :keyword:`class` statement. The *name* string is the " +"class name and becomes the :attr:`~type.__name__` attribute. The *bases* " +"tuple contains the base classes and becomes the :attr:`~type.__bases__` " +"attribute; if empty, :class:`object`, the ultimate base of all classes, is " +"added. The *dict* dictionary contains attribute and method definitions for " +"the class body; it may be copied or wrapped before becoming " +"the :attr:`~type.__dict__` attribute. The following two statements create " +"identical :class:`!type` objects:" +msgstr "" +"Z trzema argumentami, zwraca nowy typ obiektu. Jest to zasadniczo dynamiczna " +"forma instrukcji :keyword:`class`. Ciąg znaków *name* jest nazwą klasy i " +"staje się atrybutem :attr:`~type.__name__`. Krotka *bases* zawiera klasy " +"bazowe i staje się atrybutem :attr:`~type.__bases__`; jeśli jest pusta, " +"dodawana jest :class:`object`, ostateczna baza wszystkich klas. Słownik " +"*dict* zawiera definicje atrybutów i metod dla ciała klasy; może być " +"kopiowany lub wrapowany zanim stanie się atrybutem :attr:`~type.__dict__`. " +"Następujące dwie instrukcja tworzą identyczne obiekty :class:`!type`:" + +msgid "See also:" +msgstr "Zobacz także:" + +msgid "" +":ref:`Documentation on attributes and methods on classes `." +msgstr "" +":ref:`Dokumentacja atrybutow i metod na klasach `." + +msgid ":ref:`bltin-type-objects`" +msgstr ":ref:`bltin-type-objects`" + +msgid "" +"Keyword arguments provided to the three argument form are passed to the " +"appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`) " +"in the same way that keywords in a class definition (besides *metaclass*) " +"would." +msgstr "" +"Argument nazwane dostarczone do trzech formularzy argumenty są przekazywane " +"do odpowiedniego mechanizmu metaklas " +"(zwykle :meth:`~object.__init_subclass__`) w taki sam sposób, jak słowa " +"kluczowe w definicja klasy (poza *metaclass*)." + +msgid "" +"Unlike a :keyword:`class` statement, the three argument form does not call " +"the metaclass ``__prepare__`` method (see :ref:`prepare`). " +"Use :func:`types.new_class` to dynamically create a class using the " +"appropriate metaclass." +msgstr "" +"W przeciwieństwie do instrukcji :keyword:`class`, forma z trzema argumentami " +"nie wywołuje metody ``__prepare__`` metaklasy (zobacz :ref:`prepare`). Aby " +"dynamicznie utworzyć klasę przy użyciu odpowiedniej metaklasy, należy " +"skorzystać z :func:`types.new_class`." + +msgid "See also :ref:`class-customization`." +msgstr "Zobacz także :ref:`class-customization`." + +msgid "" +"Subclasses of :class:`!type` which don't override ``type.__new__`` may no " +"longer use the one-argument form to get the type of an object." +msgstr "" +"Podklasy z :class:`!type`, które nie nadpisują ``type.__new__`` nie mogą już " +"używać formy jednego-argumentu do uzyskania typu obiektu." + +msgid "" +"Return the :attr:`~object.__dict__` attribute for a module, class, instance, " +"or any other object with a :attr:`!__dict__` attribute." +msgstr "" +"Zwraca atrybut :attr:`~object.__dict__` dla moduł, klas, instancji lub " +"dowolnego innego obiektu z :attr:`!__dict__` atrybut ." + +msgid "" +"Objects such as modules and instances have an " +"updateable :attr:`~object.__dict__` attribute; however, other objects may " +"have write restrictions on their :attr:`!__dict__` attributes (for example, " +"classes use a :class:`types.MappingProxyType` to prevent direct dictionary " +"updates)." +msgstr "" +"Obiekty takie jak moduł i instancje mają możliwość " +"aktualizacji :attr:`~object.__dict__` atrybut; jednak inne obiekty mogą mieć " +"ograniczenia zapisu na ich :attr:`!__dict__` atrybut (na przykład klasy " +"używają :class:`types.MappingProxyType`, aby zapobiec bezpośrednim " +"aktualizacjom słownika)." + +msgid "Without an argument, :func:`vars` acts like :func:`locals`." +msgstr "Bez argumenta, :func:`vars` działa jak :func:`locals`." + +msgid "" +"A :exc:`TypeError` exception is raised if an object is specified but it " +"doesn't have a :attr:`~object.__dict__` attribute (for example, if its class " +"defines the :attr:`~object.__slots__` attribute)." +msgstr "" +"Wyjątek :exc:`TypeError` jest rzucony, jeśli obiekt jest określony, ale nie " +"ma :attr:`~object.__dict__` atrybut (na przykład, jeśli jego klasa " +"definiuje :attr:`~object.__slots__` atrybut )." + +msgid "" +"The result of calling this function without an argument has been updated as " +"described for the :func:`locals` builtin." +msgstr "" +"Wynik wywołania tej funkcji bez argumentów został zaktualizowany zgodnie z " +"opisem dla wbudowanej funkcji :func:`locals`." + +msgid "" +"Iterate over several iterables in parallel, producing tuples with an item " +"from each one." +msgstr "" +"Iteruje równolegle po kilku iterables, tworząc krotke z elementem z każdej z " +"nich." + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +">>> for item in zip([1, 2, 3], ['sugar', 'spice', 'everything nice']):\n" +"... print(item)\n" +"...\n" +"(1, 'sugar')\n" +"(2, 'spice')\n" +"(3, 'everything nice')" +msgstr "" +">>> for item in zip([1, 2, 3], ['cukier', 'przyprawa', 'wszystko fajnie']):\n" +"... print(item)\n" +"...\n" +"(1, 'cukier')\n" +"(2, \"przyprawa\")\n" +"(3, \"wszystko fajnie\")" + +msgid "" +"More formally: :func:`zip` returns an iterator of tuples, where the *i*-th " +"tuple contains the *i*-th element from each of the argument iterables." +msgstr "" +"Bardziej formalnie: :func:`zip` zwraca i iterator z krotka, gdzie *i*-ty " +"krotka zawiera *i*-ty element z każdego z argument iterable ." + +msgid "" +"Another way to think of :func:`zip` is that it turns rows into columns, and " +"columns into rows. This is similar to `transposing a matrix `_." +msgstr "" +"Innym sposobem myślenia o :func:`zip` jest to, że zamienia wiersze w " +"kolumny, a kolumny w wiersze. Jest to podobne do `przekształcania macierzy " +"`_." + +msgid "" +":func:`zip` is lazy: The elements won't be processed until the iterable is " +"iterated on, e.g. by a :keyword:`!for` loop or by wrapping in " +"a :class:`list`." +msgstr "" +":func:`zip` jest leniwy: Elementy nie będą przetwarzane, dopóki iterable nie " +"zostanie poddany iteracji, np. przez pętlę :keyword:`!for` lub przez " +"zawinięcie w :class:`list`." + +msgid "" +"One thing to consider is that the iterables passed to :func:`zip` could have " +"different lengths; sometimes by design, and sometimes because of a bug in " +"the code that prepared these iterables. Python offers three different " +"approaches to dealing with this issue:" +msgstr "" +"Jedną rzeczą, którą należy wziąć pod uwagę, jest to, że iterable " +"przekazywane do :func:`zip` mogą mieć różne długości; czasami z założenia, a " +"czasami z powodu błędu w kodzie, który przygotował te iterable. Python " +"oferuje trzy różne podejścia do radzenia sobie z tym problemem:" + +msgid "" +"By default, :func:`zip` stops when the shortest iterable " +"is :term:`exhausted`. It will ignore the remaining items in the longer " +"iterables, cutting off the result to the length of the shortest iterable::" +msgstr "" +"Domyślnie :func:`zip` zatrzymuje się, gdy najkrótszy iterable " +"jest :term:`wyczerpany `. Zignoruje pozostałe elementy w dłuższym " +"iterable, obcinając wynik do długości najkrótszego iterable::" + +msgid "" +">>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))\n" +"[(0, 'fee'), (1, 'fi'), (2, 'fo')]" +msgstr "" +">>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))\n" +"[(0, 'fee'), (1, 'fi'), (2, 'fo')]" + +msgid "" +":func:`zip` is often used in cases where the iterables are assumed to be of " +"equal length. In such cases, it's recommended to use the ``strict=True`` " +"option. Its output is the same as regular :func:`zip`::" +msgstr "" +":func:`zip` jest często używana w przypadkach, gdy zakłada się, że iterable " +"są równej długości. W takich przypadkach zaleca się użycie opcji " +"``strict=True``. Jej wynik jest taki sam jak zwykłego :func:`zip`::" + +msgid "" +">>> list(zip(('a', 'b', 'c'), (1, 2, 3), strict=True))\n" +"[('a', 1), ('b', 2), ('c', 3)]" +msgstr "" +">>> list(zip(('a', 'b', 'c'), (1, 2, 3), strict=True))\n" +"[('a', 1), ('b', 2), ('c', 3)]" + +msgid "" +"Unlike the default behavior, it raises a :exc:`ValueError` if one iterable " +"is :term:`exhausted` before the others:" +msgstr "" +"W przeciwieństwie do domyślnego zachowania , rzuci :exc:`ValueError`, jeśli " +"jeden iterable zostanie :term:`wyczerpany ` przed innymi:" + +msgid "" +"Without the ``strict=True`` argument, any bug that results in iterables of " +"different lengths will be silenced, possibly manifesting as a hard-to-find " +"bug in another part of the program." +msgstr "" +"Bez ``strict=True`` argumentu, każdy błąd, który skutkuje iterable o różnych " +"długościach zostanie wyciszony, prawdopodobnie objawiając się jako trudny do " +"znalezienia błąd w innej części programu." + +msgid "" +"Shorter iterables can be padded with a constant value to make all the " +"iterables have the same length. This is done " +"by :func:`itertools.zip_longest`." +msgstr "" +"Krótsze iterable mogą być uzupełnione stałą wartością, aby wszystkie " +"iterable miały taką samą długość. Odbywa się to " +"poprzez :func:`itertools.zip_longest`." + +msgid "" +"Edge cases: With a single iterable argument, :func:`zip` returns an iterator " +"of 1-tuples. With no arguments, it returns an empty iterator." +msgstr "" +"Przypadki brzegowe: Z pojedynczym iterable argument, :func:`zip` zwraca " +"iterator z 1-krotka. Bez argumentu, to zwraca pusty iterator." + +msgid "Tips and tricks:" +msgstr "Wskazówki i porady:" + +msgid "" +"The left-to-right evaluation order of the iterables is guaranteed. This " +"makes possible an idiom for clustering a data series into n-length groups " +"using ``zip(*[iter(s)]*n, strict=True)``. This repeats the *same* iterator " +"``n`` times so that each output tuple has the result of ``n`` calls to the " +"iterator. This has the effect of dividing the input into n-length chunks." +msgstr "" +"Kolejność oceny od lewej do prawej strony iterable jest gwarantowana. " +"Umożliwia to idiom grupowania serii danych w grupy o długości n przy użyciu " +"``zip(*[iter(s)]*n, strict=True)``. Powtarza to *tę samą* iterator ``n`` " +"razy, tak że każde wyjście krotka ma wynik wywołań ``n`` do iteratora. " +"Powoduje to podzielenie danych wejściowych na fragmenty o długości n." + +msgid "" +":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " +"list::" +msgstr "" +":func:`zip` w połączeniu z operatorem ``*`` może być użyty do rozpakowania " +"listy::" + +msgid "" +">>> x = [1, 2, 3]\n" +">>> y = [4, 5, 6]\n" +">>> list(zip(x, y))\n" +"[(1, 4), (2, 5), (3, 6)]\n" +">>> x2, y2 = zip(*zip(x, y))\n" +">>> x == list(x2) and y == list(y2)\n" +"True" +msgstr "" +">>> x = [1, 2, 3]\n" +">>> y = [4, 5, 6]\n" +">>> list(zip(x, y))\n" +"[(1, 4), (2, 5), (3, 6)]\n" +">>> x2, y2 = zip(*zip(x, y))\n" +">>> x == list(x2) and y == list(y2)\n" +"True" + +msgid "Added the ``strict`` argument." +msgstr "Dodano argument ``strict`` ." + +msgid "" +"This is an advanced function that is not needed in everyday Python " +"programming, unlike :func:`importlib.import_module`." +msgstr "" +"Jest to zaawansowana funkcja, która nie jest potrzebna w codziennym " +"programowaniu Pythona, w przeciwieństwie do :func:`importlib.import_module`." + +msgid "" +"This function is invoked by the :keyword:`import` statement. It can be " +"replaced (by importing the :mod:`builtins` module and assigning to " +"``builtins.__import__``) in order to change semantics of the :keyword:`!" +"import` statement, but doing so is **strongly** discouraged as it is usually " +"simpler to use import hooks (see :pep:`302`) to attain the same goals and " +"does not cause issues with code which assumes the default import " +"implementation is in use. Direct use of :func:`__import__` is also " +"discouraged in favor of :func:`importlib.import_module`." +msgstr "" +"Ten funkcja jest wywoływany przez :keyword:`import` instrukcja . Można go " +"zastąpić (importując :mod:`builtins` moduł i przypisując do " +"``builtins.__import__``) w celu zmiany semantyki :keyword:`!import` " +"instrukcja , ale jest to **bardżo** odradzane, ponieważ zwykle prostsze jest " +"użycie haków importu (zobacz :pep:`302`), aby osiągnąć te same cele i nie " +"powoduje problemów z kodem, który zakłada, że implementacja importu domyślny " +"jest w użyciu. Bezpośrednie użycie :func:`__import__` jest również " +"odradzane na korzyść :func:`importlib.import_module`." + +msgid "" +"The function imports the module *name*, potentially using the given " +"*globals* and *locals* to determine how to interpret the name in a package " +"context. The *fromlist* gives the names of objects or submodules that should " +"be imported from the module given by *name*. The standard implementation " +"does not use its *locals* argument at all and uses its *globals* only to " +"determine the package context of the :keyword:`import` statement." +msgstr "" +"Funkcja importuje moduł *name*, potencjalnie używając podanych *globals* i " +"*locals* do określenia, jak interpretować nazwę w kontekście pakietu. " +"*fromlist* podaje nazwy obiektów lub submodułów, które powinny zostać " +"zaimportowane z moduł podanego przez *name*. Standardowa implementacja nie " +"używa *locals* argumentu w ogóle i używa *globals* tylko do określenia " +"kontekstu pakietu :keyword:`import` instrukcja ." + +msgid "" +"*level* specifies whether to use absolute or relative imports. ``0`` (the " +"default) means only perform absolute imports. Positive values for *level* " +"indicate the number of parent directories to search relative to the " +"directory of the module calling :func:`__import__` (see :pep:`328` for the " +"details)." +msgstr "" +"*level* określa, czy ma być używany import bezwzględny czy względny. ``0`` " +"(domyślnie) oznacza tylko import bezwzględny. Dodatnie wartości dla *level* " +"wskazują liczbę katalogów nadrzędnych do przeszukania względem katalogu " +"moduł wywołującego :func:`__import__` (zobacz :pep:`328` dla szczegółów)." + +msgid "" +"When the *name* variable is of the form ``package.module``, normally, the " +"top-level package (the name up till the first dot) is returned, *not* the " +"module named by *name*. However, when a non-empty *fromlist* argument is " +"given, the module named by *name* is returned." +msgstr "" +"Gdy zmienna *name* ma postać ``package.module``, zwykle zwracany jest pakiet " +"najwyższego poziomu (nazwa do pierwszej kropki), *nie* moduł nazwany przez " +"*name*. Jednakże, gdy podana jest niepusta *fromlist* argument, zwracany " +"jest moduł nazwany przez *name*." + +msgid "" +"For example, the statement ``import spam`` results in bytecode resembling " +"the following code::" +msgstr "" +"Na przykład, instrukcja ``import spam`` skutkuje kodem bajtowym " +"przypominającym następujący kod::" + +msgid "spam = __import__('spam', globals(), locals(), [], 0)" +msgstr "spam = __import__('spam', globals(), locals(), [], 0)" + +msgid "The statement ``import spam.ham`` results in this call::" +msgstr "Instrukcja ``import spam.ham`` skutkuje następującym połączeniem::" + +msgid "spam = __import__('spam.ham', globals(), locals(), [], 0)" +msgstr "spam = __import__('spam.ham', globals(), locals(), [], 0)" + +msgid "" +"Note how :func:`__import__` returns the toplevel module here because this is " +"the object that is bound to a name by the :keyword:`import` statement." +msgstr "" +"Zauważ, że :func:`__import__` zwraca toplevel moduł tutaj, ponieważ jest to " +"obiekt, który jest powiązany z nazwą przez :keyword:`import` instrukcje ." + +msgid "" +"On the other hand, the statement ``from spam.ham import eggs, sausage as " +"saus`` results in ::" +msgstr "" +"Z drugiej strony, instrukcja ``from spam.ham import eggs, sausage as saus`` " +"skutkuje ::" + +msgid "" +"_temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)\n" +"eggs = _temp.eggs\n" +"saus = _temp.sausage" +msgstr "" +"_temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)\n" +"eggs = _temp.eggs\n" +"saus = _temp.sausage" + +msgid "" +"Here, the ``spam.ham`` module is returned from :func:`__import__`. From " +"this object, the names to import are retrieved and assigned to their " +"respective names." +msgstr "" +"Tutaj obiekt ``spam.ham`` jest zwracany z :func:`__import__`. Z tego " +"obiektu pobierane są nazwy do zaimportowania i przypisywane do odpowiednich " +"nazw." + +msgid "" +"If you simply want to import a module (potentially within a package) by " +"name, use :func:`importlib.import_module`." +msgstr "" +"Jeśli chcesz po prostu zaimportować moduł (potencjalnie w ramach pakietu) " +"według nazwy, użyj :func:`importlib.import_module`." + +msgid "" +"Negative values for *level* are no longer supported (which also changes the " +"default value to 0)." +msgstr "" +"Ujemne wartości dla *level* nie są już obsługiwane (co również zmienia " +"wartość domyślny na 0)." + +msgid "" +"When the command line options :option:`-E` or :option:`-I` are being used, " +"the environment variable :envvar:`PYTHONCASEOK` is now ignored." +msgstr "" +"Gdy używane są opcje wiersza poleceń :option:`-E` lub :option:`-I`, opcja " +"zmienna środowiskowa :envvar:`PYTHONCASEOK` jest teraz ignorowana." + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +"Note that the parser only accepts the Unix-style end of line convention. If " +"you are reading the code from a file, make sure to use newline conversion " +"mode to convert Windows or Mac-style newlines." +msgstr "" +"Zwróć uwagę, że parser akceptuje tylko Unixowy styl końca linii. Jeśli " +"wczytujesz kod z pliku, wykorzystaj konwersję linii aby przekonwertować " +"style końca linii Winows albo Mac." + +msgid "Boolean" +msgstr "Wartość logiczna" + +msgid "type" +msgstr "typ" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "exec" +msgstr "exec" + +msgid "NaN" +msgstr "NaN" + +msgid "Infinity" +msgstr "Nieskończoność" + +msgid "__format__" +msgstr "__format__" + +msgid "string" +msgstr "ciąg znaków" + +msgid "format() (built-in function)" +msgstr "format() (wbudowana funkcja)" + +msgid "file object" +msgstr "obiekt plik" + +msgid "open() built-in function" +msgstr "open() wbudowana funkcja" + +msgid "file" +msgstr "plik" + +msgid "modes" +msgstr "tryby" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "line-buffered I/O" +msgstr "Buforowane liniowo I/O" + +msgid "unbuffered I/O" +msgstr "niebuforowane I/O" + +msgid "buffer size, I/O" +msgstr "rozmiar bufora, I/O" + +msgid "I/O control" +msgstr "Kontrola I/O" + +msgid "buffering" +msgstr "buforowanie" + +msgid "text mode" +msgstr "tryb tekstowy" + +msgid "module" +msgstr "moduł" + +msgid "sys" +msgstr "sys" + +msgid "str() (built-in function)" +msgstr "str() (wbudowana funkcja)" + +msgid "object" +msgstr "obiekt" + +msgid "statement" +msgstr "instrukcja" + +msgid "import" +msgstr "import" + +msgid "builtins" +msgstr "builtins" diff --git a/builtins/stdtypes.po b/builtins/stdtypes.po new file mode 100644 index 0000000000..b916beac77 --- /dev/null +++ b/builtins/stdtypes.po @@ -0,0 +1,7999 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-09-13 18:06+0000\n" +"Last-Translator: Maciej Olko, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Types" +msgstr "Wbudowane typy" + +msgid "" +"The following sections describe the standard types that are built into the " +"interpreter." +msgstr "" +"W poniższych sekcjach opisano standardowe typy wbudowane w interpreter." + +msgid "" +"The principal built-in types are numerics, sequences, mappings, classes, " +"instances and exceptions." +msgstr "" +"Głównymi typami wbudowanymi są typy liczbowe, sekwencje, mapowania, klasy, " +"instancje i wyjątki." + +msgid "" +"Some collection classes are mutable. The methods that add, subtract, or " +"rearrange their members in place, and don't return a specific item, never " +"return the collection instance itself but ``None``." +msgstr "" +"Niektóre klasy kolekcji są mutowalne (zmienne). Metody, które dodają, " +"odejmują lub zmieniają kolejność swoich elementów w miejscu, a nie zwracają " +"konkretnego elementu, nigdy nie zwracają instancji kolekcji, lecz ``None``." + +msgid "" +"Some operations are supported by several object types; in particular, " +"practically all objects can be compared for equality, tested for truth " +"value, and converted to a string (with the :func:`repr` function or the " +"slightly different :func:`str` function). The latter function is implicitly " +"used when an object is written by the :func:`print` function." +msgstr "" +"Niektóre operacje są obsługiwane przez kilka typów obiektów; w szczególności " +"praktycznie wszystkie obiekty można porównywać pod kątem równości, sprawdzać " +"ich „prawdziwość” oraz konwertować na ciąg znaków (za pomocą " +"funkcji:func:`repr` lub nieco innej funkcji :func:`str`). Ta ostatnia " +"funkcja jest używana domyślnie, gdy obiekt jest zapisywany za pomocą " +"funkcji :func:`print`." + +msgid "Truth Value Testing" +msgstr "Sprawdzanie wartości logicznej" + +msgid "" +"Any object can be tested for truth value, for use in an :keyword:`if` " +"or :keyword:`while` condition or as operand of the Boolean operations below." +msgstr "" +"Każdy obiekt można poddać testowi „prawdziwości” jego wartości – w celu " +"wykorzystania w warunku typu :keyword:`if` lub :keyword:`while` albo jako " +"operand w poniższych operacjach logicznych." + +msgid "" +"By default, an object is considered true unless its class defines either " +"a :meth:`~object.__bool__` method that returns ``False`` or " +"a :meth:`~object.__len__` method that returns zero, when called with the " +"object. [1]_ If one of the methods raises an exception when called, the " +"exception is propagated and the object does not have a truth value (for " +"example, :data:`NotImplemented`). Here are most of the built-in objects " +"considered false:" +msgstr "" +"Domyślnie obiekt uznaje się za prawdziwy, chyba że jego klasa definiuje albo " +"metodę :meth:`~object.__bool__`, która zwraca ``False``, albo " +"metodę :meth:`~object.__len__`, która zwraca zero po wywołaniu z tym " +"obiektem. [1]_ Jeśli jedna z metod rzuca wyjątek, wyjątek ten jest " +"propagowany, a obiekt nie ma wartości logicznej (na " +"przykład :data:`NotImplemented`). Oto większość obiektów wbudowanych " +"uznawanych za fałsz:" + +msgid "constants defined to be false: ``None`` and ``False``" +msgstr "stałe zdefiniowane jako fałsz: ``None`` oraz ``False``" + +msgid "" +"zero of any numeric type: ``0``, ``0.0``, ``0j``, ``Decimal(0)``, " +"``Fraction(0, 1)``" +msgstr "" + +msgid "" +"empty sequences and collections: ``''``, ``()``, ``[]``, ``{}``, ``set()``, " +"``range(0)``" +msgstr "" +"puste sekwencje oraz kolekcje: ``''``, ``()``, ``[]``, ``{}``, ``set()``, " +"``range(0)``" + +msgid "" +"Operations and built-in functions that have a Boolean result always return " +"``0`` or ``False`` for false and ``1`` or ``True`` for true, unless " +"otherwise stated. (Important exception: the Boolean operations ``or`` and " +"``and`` always return one of their operands.)" +msgstr "" +"Operacje oraz funkcje wbudowane, których wynikiem jest wartość logiczna, " +"zawsze zwracają ``0`` lub ``False`` dla fałszu oraz ``1`` lub ``True`` dla " +"prawdy, o ile nie zaznaczono inaczej. (Ważny wyjątek: operacje logiczne " +"``or`` oraz ``and`` zawsze zwracają jeden ze swoich operandów.)" + +msgid "Boolean Operations --- :keyword:`!and`, :keyword:`!or`, :keyword:`!not`" +msgstr "" + +msgid "These are the Boolean operations, ordered by ascending priority:" +msgstr "" + +msgid "Operation" +msgstr "" + +msgid "Result" +msgstr "" + +msgid "Notes" +msgstr "Notatki" + +msgid "``x or y``" +msgstr "``x or y``" + +msgid "if *x* is true, then *x*, else *y*" +msgstr "" + +msgid "\\(1)" +msgstr "\\(1)" + +msgid "``x and y``" +msgstr "``x and y``" + +msgid "if *x* is false, then *x*, else *y*" +msgstr "" + +msgid "\\(2)" +msgstr "\\(2)" + +msgid "``not x``" +msgstr "``not x``" + +msgid "if *x* is false, then ``True``, else ``False``" +msgstr "" + +msgid "\\(3)" +msgstr "\\(3)" + +msgid "Notes:" +msgstr "Uwagi:" + +msgid "" +"This is a short-circuit operator, so it only evaluates the second argument " +"if the first one is false." +msgstr "" + +msgid "" +"This is a short-circuit operator, so it only evaluates the second argument " +"if the first one is true." +msgstr "" + +msgid "" +"``not`` has a lower priority than non-Boolean operators, so ``not a == b`` " +"is interpreted as ``not (a == b)``, and ``a == not b`` is a syntax error." +msgstr "" + +msgid "Comparisons" +msgstr "" + +msgid "" +"There are eight comparison operations in Python. They all have the same " +"priority (which is higher than that of the Boolean operations). Comparisons " +"can be chained arbitrarily; for example, ``x < y <= z`` is equivalent to ``x " +"< y and y <= z``, except that *y* is evaluated only once (but in both cases " +"*z* is not evaluated at all when ``x < y`` is found to be false)." +msgstr "" + +msgid "This table summarizes the comparison operations:" +msgstr "" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid "``<``" +msgstr "``<``" + +msgid "strictly less than" +msgstr "" + +msgid "``<=``" +msgstr "``<=``" + +msgid "less than or equal" +msgstr "" + +msgid "``>``" +msgstr "``>``" + +msgid "strictly greater than" +msgstr "" + +msgid "``>=``" +msgstr "``>=``" + +msgid "greater than or equal" +msgstr "" + +msgid "``==``" +msgstr "``==``" + +msgid "equal" +msgstr "" + +msgid "``!=``" +msgstr "``!=``" + +msgid "not equal" +msgstr "" + +msgid "``is``" +msgstr "``is``" + +msgid "object identity" +msgstr "" + +msgid "``is not``" +msgstr "``is not``" + +msgid "negated object identity" +msgstr "" + +msgid "" +"Unless stated otherwise, objects of different types never compare equal. The " +"``==`` operator is always defined but for some object types (for example, " +"class objects) is equivalent to :keyword:`is`. The ``<``, ``<=``, ``>`` and " +"``>=`` operators are only defined where they make sense; for example, they " +"raise a :exc:`TypeError` exception when one of the arguments is a complex " +"number." +msgstr "" + +msgid "" +"Non-identical instances of a class normally compare as non-equal unless the " +"class defines the :meth:`~object.__eq__` method." +msgstr "" + +msgid "" +"Instances of a class cannot be ordered with respect to other instances of " +"the same class, or other types of object, unless the class defines enough of " +"the " +"methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` " +"and :meth:`~object.__eq__` are sufficient, if you want the conventional " +"meanings of the comparison operators)." +msgstr "" + +msgid "" +"The behavior of the :keyword:`is` and :keyword:`is not` operators cannot be " +"customized; also they can be applied to any two objects and never raise an " +"exception." +msgstr "" + +msgid "" +"Two more operations with the same syntactic priority, :keyword:`in` " +"and :keyword:`not in`, are supported by types that are :term:`iterable` or " +"implement the :meth:`~object.__contains__` method." +msgstr "" + +msgid "Numeric Types --- :class:`int`, :class:`float`, :class:`complex`" +msgstr "" + +msgid "" +"There are three distinct numeric types: :dfn:`integers`, :dfn:`floating-" +"point numbers`, and :dfn:`complex numbers`. In addition, Booleans are a " +"subtype of integers. Integers have unlimited precision. Floating-point " +"numbers are usually implemented using :c:expr:`double` in C; information " +"about the precision and internal representation of floating-point numbers " +"for the machine on which your program is running is available " +"in :data:`sys.float_info`. Complex numbers have a real and imaginary part, " +"which are each a floating-point number. To extract these parts from a " +"complex number *z*, use ``z.real`` and ``z.imag``. (The standard library " +"includes the additional numeric types :mod:`fractions.Fraction`, for " +"rationals, and :mod:`decimal.Decimal`, for floating-point numbers with user-" +"definable precision.)" +msgstr "" + +msgid "" +"Numbers are created by numeric literals or as the result of built-in " +"functions and operators. Unadorned integer literals (including hex, octal " +"and binary numbers) yield integers. Numeric literals containing a decimal " +"point or an exponent sign yield floating-point numbers. Appending ``'j'`` " +"or ``'J'`` to a numeric literal yields an imaginary number (a complex number " +"with a zero real part) which you can add to an integer or float to get a " +"complex number with real and imaginary parts." +msgstr "" + +msgid "" +"The constructors :func:`int`, :func:`float`, and :func:`complex` can be used " +"to produce numbers of a specific type." +msgstr "" + +msgid "" +"Python fully supports mixed arithmetic: when a binary arithmetic operator " +"has operands of different built-in numeric types, the operand with the " +"\"narrower\" type is widened to that of the other:" +msgstr "" + +msgid "If both arguments are complex numbers, no conversion is performed;" +msgstr "" + +msgid "" +"if either argument is a complex or a floating-point number, the other is " +"converted to a floating-point number;" +msgstr "" + +msgid "otherwise, both must be integers and no conversion is necessary." +msgstr "" + +msgid "" +"Arithmetic with complex and real operands is defined by the usual " +"mathematical formula, for example::" +msgstr "" + +msgid "" +"x + complex(u, v) = complex(x + u, v)\n" +"x * complex(u, v) = complex(x * u, x * v)" +msgstr "" + +msgid "" +"A comparison between numbers of different types behaves as though the exact " +"values of those numbers were being compared. [2]_" +msgstr "" + +msgid "" +"All numeric types (except complex) support the following operations (for " +"priorities of the operations, see :ref:`operator-summary`):" +msgstr "" + +msgid "Full documentation" +msgstr "" + +msgid "``x + y``" +msgstr "``x + y``" + +msgid "sum of *x* and *y*" +msgstr "" + +msgid "``x - y``" +msgstr "``x - y``" + +msgid "difference of *x* and *y*" +msgstr "" + +msgid "``x * y``" +msgstr "``x * y``" + +msgid "product of *x* and *y*" +msgstr "" + +msgid "``x / y``" +msgstr "``x / y``" + +msgid "quotient of *x* and *y*" +msgstr "" + +msgid "``x // y``" +msgstr "``x // y``" + +msgid "floored quotient of *x* and *y*" +msgstr "" + +msgid "\\(1)\\(2)" +msgstr "" + +msgid "``x % y``" +msgstr "``x % y``" + +msgid "remainder of ``x / y``" +msgstr "" + +msgid "``-x``" +msgstr "``-x``" + +msgid "*x* negated" +msgstr "" + +msgid "``+x``" +msgstr "``+x``" + +msgid "*x* unchanged" +msgstr "" + +msgid "``abs(x)``" +msgstr "``abs(x)``" + +msgid "absolute value or magnitude of *x*" +msgstr "" + +msgid ":func:`abs`" +msgstr ":func:`abs`" + +msgid "``int(x)``" +msgstr "``int(x)``" + +msgid "*x* converted to integer" +msgstr "" + +msgid "\\(3)\\(6)" +msgstr "" + +msgid ":func:`int`" +msgstr ":func:`int`" + +msgid "``float(x)``" +msgstr "``float(x)``" + +msgid "*x* converted to floating point" +msgstr "" + +msgid "\\(4)\\(6)" +msgstr "" + +msgid ":func:`float`" +msgstr ":func:`float`" + +msgid "``complex(re, im)``" +msgstr "``complex(re, im)``" + +msgid "" +"a complex number with real part *re*, imaginary part *im*. *im* defaults to " +"zero." +msgstr "" + +msgid "\\(6)" +msgstr "\\(6)" + +msgid ":func:`complex`" +msgstr ":func:`complex`" + +msgid "``c.conjugate()``" +msgstr "``c.conjugate()``" + +msgid "conjugate of the complex number *c*" +msgstr "" + +msgid "``divmod(x, y)``" +msgstr "``divmod(x, y)``" + +msgid "the pair ``(x // y, x % y)``" +msgstr "" + +msgid ":func:`divmod`" +msgstr ":func:`divmod`" + +msgid "``pow(x, y)``" +msgstr "``pow(x, y)``" + +msgid "*x* to the power *y*" +msgstr "" + +msgid "\\(5)" +msgstr "\\(5)" + +msgid ":func:`pow`" +msgstr ":func:`pow`" + +msgid "``x ** y``" +msgstr "``x ** y``" + +msgid "" +"Also referred to as integer division. For operands of type :class:`int`, " +"the result has type :class:`int`. For operands of type :class:`float`, the " +"result has type :class:`float`. In general, the result is a whole integer, " +"though the result's type is not necessarily :class:`int`. The result is " +"always rounded towards minus infinity: ``1//2`` is ``0``, ``(-1)//2`` is " +"``-1``, ``1//(-2)`` is ``-1``, and ``(-1)//(-2)`` is ``0``." +msgstr "" + +msgid "" +"Not for complex numbers. Instead convert to floats using :func:`abs` if " +"appropriate." +msgstr "" + +msgid "" +"Conversion from :class:`float` to :class:`int` truncates, discarding the " +"fractional part. See functions :func:`math.floor` and :func:`math.ceil` for " +"alternative conversions." +msgstr "" + +msgid "" +"float also accepts the strings \"nan\" and \"inf\" with an optional prefix " +"\"+\" or \"-\" for Not a Number (NaN) and positive or negative infinity." +msgstr "" + +msgid "" +"Python defines ``pow(0, 0)`` and ``0 ** 0`` to be ``1``, as is common for " +"programming languages." +msgstr "" + +msgid "" +"The numeric literals accepted include the digits ``0`` to ``9`` or any " +"Unicode equivalent (code points with the ``Nd`` property)." +msgstr "" + +msgid "" +"See `the Unicode Standard `_ for a complete list of code points with the ``Nd`` " +"property." +msgstr "" + +msgid "" +"All :class:`numbers.Real` types (:class:`int` and :class:`float`) also " +"include the following operations:" +msgstr "" + +msgid ":func:`math.trunc(\\ x) `" +msgstr ":func:`math.trunc(\\ x) `" + +msgid "*x* truncated to :class:`~numbers.Integral`" +msgstr "" + +msgid ":func:`round(x[, n]) `" +msgstr ":func:`round(x[, n]) `" + +msgid "" +"*x* rounded to *n* digits, rounding half to even. If *n* is omitted, it " +"defaults to 0." +msgstr "" + +msgid ":func:`math.floor(\\ x) `" +msgstr ":func:`math.floor(\\ x) `" + +msgid "the greatest :class:`~numbers.Integral` <= *x*" +msgstr "" + +msgid ":func:`math.ceil(x) `" +msgstr "" + +msgid "the least :class:`~numbers.Integral` >= *x*" +msgstr "" + +msgid "" +"For additional numeric operations see the :mod:`math` and :mod:`cmath` " +"modules." +msgstr "" + +msgid "Bitwise Operations on Integer Types" +msgstr "" + +msgid "" +"Bitwise operations only make sense for integers. The result of bitwise " +"operations is calculated as though carried out in two's complement with an " +"infinite number of sign bits." +msgstr "" + +msgid "" +"The priorities of the binary bitwise operations are all lower than the " +"numeric operations and higher than the comparisons; the unary operation " +"``~`` has the same priority as the other unary numeric operations (``+`` and " +"``-``)." +msgstr "" + +msgid "This table lists the bitwise operations sorted in ascending priority:" +msgstr "" + +msgid "``x | y``" +msgstr "``x | y``" + +msgid "bitwise :dfn:`or` of *x* and *y*" +msgstr "" + +msgid "\\(4)" +msgstr "\\(4)" + +msgid "``x ^ y``" +msgstr "``x ^ y``" + +msgid "bitwise :dfn:`exclusive or` of *x* and *y*" +msgstr "" + +msgid "``x & y``" +msgstr "``x & y``" + +msgid "bitwise :dfn:`and` of *x* and *y*" +msgstr "" + +msgid "``x << n``" +msgstr "``x << n``" + +msgid "*x* shifted left by *n* bits" +msgstr "" + +msgid "(1)(2)" +msgstr "(1)(2)" + +msgid "``x >> n``" +msgstr "``x >> n``" + +msgid "*x* shifted right by *n* bits" +msgstr "" + +msgid "(1)(3)" +msgstr "" + +msgid "``~x``" +msgstr "``~x``" + +msgid "the bits of *x* inverted" +msgstr "" + +msgid "" +"Negative shift counts are illegal and cause a :exc:`ValueError` to be raised." +msgstr "" + +msgid "" +"A left shift by *n* bits is equivalent to multiplication by ``pow(2, n)``." +msgstr "" + +msgid "" +"A right shift by *n* bits is equivalent to floor division by ``pow(2, n)``." +msgstr "" + +msgid "" +"Performing these calculations with at least one extra sign extension bit in " +"a finite two's complement representation (a working bit-width of ``1 + " +"max(x.bit_length(), y.bit_length())`` or more) is sufficient to get the same " +"result as if there were an infinite number of sign bits." +msgstr "" + +msgid "Additional Methods on Integer Types" +msgstr "" + +msgid "" +"The int type implements the :class:`numbers.Integral` :term:`abstract base " +"class`. In addition, it provides a few more methods:" +msgstr "" + +msgid "" +"Return the number of bits necessary to represent an integer in binary, " +"excluding the sign and leading zeros::" +msgstr "" + +msgid "" +">>> n = -37\n" +">>> bin(n)\n" +"'-0b100101'\n" +">>> n.bit_length()\n" +"6" +msgstr "" +">>> n = -37\n" +">>> bin(n)\n" +"'-0b100101'\n" +">>> n.bit_length()\n" +"6" + +msgid "" +"More precisely, if ``x`` is nonzero, then ``x.bit_length()`` is the unique " +"positive integer ``k`` such that ``2**(k-1) <= abs(x) < 2**k``. " +"Equivalently, when ``abs(x)`` is small enough to have a correctly rounded " +"logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then " +"``x.bit_length()`` returns ``0``." +msgstr "" + +msgid "Equivalent to::" +msgstr "Odpowiednik::" + +msgid "" +"def bit_length(self):\n" +" s = bin(self) # binary representation: bin(-37) --> '-0b100101'\n" +" s = s.lstrip('-0b') # remove leading zeros and minus sign\n" +" return len(s) # len('100101') --> 6" +msgstr "" + +msgid "" +"Return the number of ones in the binary representation of the absolute value " +"of the integer. This is also known as the population count. Example::" +msgstr "" + +msgid "" +">>> n = 19\n" +">>> bin(n)\n" +"'0b10011'\n" +">>> n.bit_count()\n" +"3\n" +">>> (-n).bit_count()\n" +"3" +msgstr "" +">>> n = 19\n" +">>> bin(n)\n" +"'0b10011'\n" +">>> n.bit_count()\n" +"3\n" +">>> (-n).bit_count()\n" +"3" + +msgid "" +"def bit_count(self):\n" +" return bin(self).count(\"1\")" +msgstr "" + +msgid "Return an array of bytes representing an integer." +msgstr "" + +msgid "" +"The integer is represented using *length* bytes, and defaults to 1. " +"An :exc:`OverflowError` is raised if the integer is not representable with " +"the given number of bytes." +msgstr "" + +msgid "" +"The *byteorder* argument determines the byte order used to represent the " +"integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " +"most significant byte is at the beginning of the byte array. If *byteorder* " +"is ``\"little\"``, the most significant byte is at the end of the byte array." +msgstr "" + +msgid "" +"The *signed* argument determines whether two's complement is used to " +"represent the integer. If *signed* is ``False`` and a negative integer is " +"given, an :exc:`OverflowError` is raised. The default value for *signed* is " +"``False``." +msgstr "" + +msgid "" +"The default values can be used to conveniently turn an integer into a single " +"byte object::" +msgstr "" + +msgid "" +">>> (65).to_bytes()\n" +"b'A'" +msgstr "" +">>> (65).to_bytes()\n" +"b'A'" + +msgid "" +"However, when using the default arguments, don't try to convert a value " +"greater than 255 or you'll get an :exc:`OverflowError`." +msgstr "" + +msgid "" +"def to_bytes(n, length=1, byteorder='big', signed=False):\n" +" if byteorder == 'little':\n" +" order = range(length)\n" +" elif byteorder == 'big':\n" +" order = reversed(range(length))\n" +" else:\n" +" raise ValueError(\"byteorder must be either 'little' or 'big'\")\n" +"\n" +" return bytes((n >> i*8) & 0xff for i in order)" +msgstr "" + +msgid "Added default argument values for ``length`` and ``byteorder``." +msgstr "" + +msgid "Return the integer represented by the given array of bytes." +msgstr "" + +msgid "" +"The argument *bytes* must either be a :term:`bytes-like object` or an " +"iterable producing bytes." +msgstr "" + +msgid "" +"The *byteorder* argument determines the byte order used to represent the " +"integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " +"most significant byte is at the beginning of the byte array. If *byteorder* " +"is ``\"little\"``, the most significant byte is at the end of the byte " +"array. To request the native byte order of the host system, " +"use :data:`sys.byteorder` as the byte order value." +msgstr "" + +msgid "" +"The *signed* argument indicates whether two's complement is used to " +"represent the integer." +msgstr "" + +msgid "" +"def from_bytes(bytes, byteorder='big', signed=False):\n" +" if byteorder == 'little':\n" +" little_ordered = list(bytes)\n" +" elif byteorder == 'big':\n" +" little_ordered = list(reversed(bytes))\n" +" else:\n" +" raise ValueError(\"byteorder must be either 'little' or 'big'\")\n" +"\n" +" n = sum(b << i*8 for i, b in enumerate(little_ordered))\n" +" if signed and little_ordered and (little_ordered[-1] & 0x80):\n" +" n -= 1 << 8*len(little_ordered)\n" +"\n" +" return n" +msgstr "" + +msgid "Added default argument value for ``byteorder``." +msgstr "" + +msgid "" +"Return a pair of integers whose ratio is equal to the original integer and " +"has a positive denominator. The integer ratio of integers (whole numbers) " +"is always the integer as the numerator and ``1`` as the denominator." +msgstr "" + +msgid "" +"Returns ``True``. Exists for duck type compatibility " +"with :meth:`float.is_integer`." +msgstr "" + +msgid "Additional Methods on Float" +msgstr "" + +msgid "" +"The float type implements the :class:`numbers.Real` :term:`abstract base " +"class`. float also has the following additional methods." +msgstr "" + +msgid "" +"Class method to return a floating-point number constructed from a number *x*." +msgstr "" + +msgid "" +"If the argument is an integer or a floating-point number, a floating-point " +"number with the same value (within Python's floating-point precision) is " +"returned. If the argument is outside the range of a Python float, " +"an :exc:`OverflowError` will be raised." +msgstr "" + +msgid "" +"For a general Python object ``x``, ``float.from_number(x)`` delegates to " +"``x.__float__()``. If :meth:`~object.__float__` is not defined then it falls " +"back to :meth:`~object.__index__`." +msgstr "" + +msgid "" +"Return a pair of integers whose ratio is exactly equal to the original " +"float. The ratio is in lowest terms and has a positive denominator. " +"Raises :exc:`OverflowError` on infinities and a :exc:`ValueError` on NaNs." +msgstr "" + +msgid "" +"Return ``True`` if the float instance is finite with integral value, and " +"``False`` otherwise::" +msgstr "" + +msgid "" +">>> (-2.0).is_integer()\n" +"True\n" +">>> (3.2).is_integer()\n" +"False" +msgstr "" +">>> (-2.0).is_integer()\n" +"True\n" +">>> (3.2).is_integer()\n" +"False" + +msgid "" +"Two methods support conversion to and from hexadecimal strings. Since " +"Python's floats are stored internally as binary numbers, converting a float " +"to or from a *decimal* string usually involves a small rounding error. In " +"contrast, hexadecimal strings allow exact representation and specification " +"of floating-point numbers. This can be useful when debugging, and in " +"numerical work." +msgstr "" + +msgid "" +"Return a representation of a floating-point number as a hexadecimal string. " +"For finite floating-point numbers, this representation will always include a " +"leading ``0x`` and a trailing ``p`` and exponent." +msgstr "" + +msgid "" +"Class method to return the float represented by a hexadecimal string *s*. " +"The string *s* may have leading and trailing whitespace." +msgstr "" + +msgid "" +"Note that :meth:`float.hex` is an instance method, " +"while :meth:`float.fromhex` is a class method." +msgstr "" + +msgid "A hexadecimal string takes the form::" +msgstr "" + +msgid "[sign] ['0x'] integer ['.' fraction] ['p' exponent]" +msgstr "" + +msgid "" +"where the optional ``sign`` may be either ``+`` or ``-``, ``integer`` and " +"``fraction`` are strings of hexadecimal digits, and ``exponent`` is a " +"decimal integer with an optional leading sign. Case is not significant, and " +"there must be at least one hexadecimal digit in either the integer or the " +"fraction. This syntax is similar to the syntax specified in section 6.4.4.2 " +"of the C99 standard, and also to the syntax used in Java 1.5 onwards. In " +"particular, the output of :meth:`float.hex` is usable as a hexadecimal " +"floating-point literal in C or Java code, and hexadecimal strings produced " +"by C's ``%a`` format character or Java's ``Double.toHexString`` are accepted " +"by :meth:`float.fromhex`." +msgstr "" + +msgid "" +"Note that the exponent is written in decimal rather than hexadecimal, and " +"that it gives the power of 2 by which to multiply the coefficient. For " +"example, the hexadecimal string ``0x3.a7p10`` represents the floating-point " +"number ``(3 + 10./16 + 7./16**2) * 2.0**10``, or ``3740.0``::" +msgstr "" + +msgid "" +">>> float.fromhex('0x3.a7p10')\n" +"3740.0" +msgstr "" +">>> float.fromhex('0x3.a7p10')\n" +"3740.0" + +msgid "" +"Applying the reverse conversion to ``3740.0`` gives a different hexadecimal " +"string representing the same number::" +msgstr "" + +msgid "" +">>> float.hex(3740.0)\n" +"'0x1.d380000000000p+11'" +msgstr "" +">>> float.hex(3740.0)\n" +"'0x1.d380000000000p+11'" + +msgid "Additional Methods on Complex" +msgstr "" + +msgid "" +"The :class:`!complex` type implements " +"the :class:`numbers.Complex` :term:`abstract base class`. :class:`!complex` " +"also has the following additional methods." +msgstr "" + +msgid "Class method to convert a number to a complex number." +msgstr "" + +msgid "" +"For a general Python object ``x``, ``complex.from_number(x)`` delegates to " +"``x.__complex__()``. If :meth:`~object.__complex__` is not defined then it " +"falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not " +"defined then it falls back to :meth:`~object.__index__`." +msgstr "" + +msgid "Hashing of numeric types" +msgstr "" + +msgid "" +"For numbers ``x`` and ``y``, possibly of different types, it's a requirement " +"that ``hash(x) == hash(y)`` whenever ``x == y`` (see " +"the :meth:`~object.__hash__` method documentation for more details). For " +"ease of implementation and efficiency across a variety of numeric types " +"(including :class:`int`, :class:`float`, :class:`decimal.Decimal` " +"and :class:`fractions.Fraction`) Python's hash for numeric types is based on " +"a single mathematical function that's defined for any rational number, and " +"hence applies to all instances of :class:`int` " +"and :class:`fractions.Fraction`, and all finite instances of :class:`float` " +"and :class:`decimal.Decimal`. Essentially, this function is given by " +"reduction modulo ``P`` for a fixed prime ``P``. The value of ``P`` is made " +"available to Python as the :attr:`~sys.hash_info.modulus` attribute " +"of :data:`sys.hash_info`." +msgstr "" + +msgid "" +"Currently, the prime used is ``P = 2**31 - 1`` on machines with 32-bit C " +"longs and ``P = 2**61 - 1`` on machines with 64-bit C longs." +msgstr "" + +msgid "Here are the rules in detail:" +msgstr "" + +msgid "" +"If ``x = m / n`` is a nonnegative rational number and ``n`` is not divisible " +"by ``P``, define ``hash(x)`` as ``m * invmod(n, P) % P``, where ``invmod(n, " +"P)`` gives the inverse of ``n`` modulo ``P``." +msgstr "" + +msgid "" +"If ``x = m / n`` is a nonnegative rational number and ``n`` is divisible by " +"``P`` (but ``m`` is not) then ``n`` has no inverse modulo ``P`` and the rule " +"above doesn't apply; in this case define ``hash(x)`` to be the constant " +"value ``sys.hash_info.inf``." +msgstr "" + +msgid "" +"If ``x = m / n`` is a negative rational number define ``hash(x)`` as ``-" +"hash(-x)``. If the resulting hash is ``-1``, replace it with ``-2``." +msgstr "" + +msgid "" +"The particular values ``sys.hash_info.inf`` and ``-sys.hash_info.inf`` are " +"used as hash values for positive infinity or negative infinity " +"(respectively)." +msgstr "" + +msgid "" +"For a :class:`complex` number ``z``, the hash values of the real and " +"imaginary parts are combined by computing ``hash(z.real) + " +"sys.hash_info.imag * hash(z.imag)``, reduced modulo " +"``2**sys.hash_info.width`` so that it lies in " +"``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - 1))``. " +"Again, if the result is ``-1``, it's replaced with ``-2``." +msgstr "" + +msgid "" +"To clarify the above rules, here's some example Python code, equivalent to " +"the built-in hash, for computing the hash of a rational " +"number, :class:`float`, or :class:`complex`::" +msgstr "" + +msgid "" +"import sys, math\n" +"\n" +"def hash_fraction(m, n):\n" +" \"\"\"Compute the hash of a rational number m / n.\n" +"\n" +" Assumes m and n are integers, with n positive.\n" +" Equivalent to hash(fractions.Fraction(m, n)).\n" +"\n" +" \"\"\"\n" +" P = sys.hash_info.modulus\n" +" # Remove common factors of P. (Unnecessary if m and n already " +"coprime.)\n" +" while m % P == n % P == 0:\n" +" m, n = m // P, n // P\n" +"\n" +" if n % P == 0:\n" +" hash_value = sys.hash_info.inf\n" +" else:\n" +" # Fermat's Little Theorem: pow(n, P-1, P) is 1, so\n" +" # pow(n, P-2, P) gives the inverse of n modulo P.\n" +" hash_value = (abs(m) % P) * pow(n, P - 2, P) % P\n" +" if m < 0:\n" +" hash_value = -hash_value\n" +" if hash_value == -1:\n" +" hash_value = -2\n" +" return hash_value\n" +"\n" +"def hash_float(x):\n" +" \"\"\"Compute the hash of a float x.\"\"\"\n" +"\n" +" if math.isnan(x):\n" +" return object.__hash__(x)\n" +" elif math.isinf(x):\n" +" return sys.hash_info.inf if x > 0 else -sys.hash_info.inf\n" +" else:\n" +" return hash_fraction(*x.as_integer_ratio())\n" +"\n" +"def hash_complex(z):\n" +" \"\"\"Compute the hash of a complex number z.\"\"\"\n" +"\n" +" hash_value = hash_float(z.real) + sys.hash_info.imag * " +"hash_float(z.imag)\n" +" # do a signed reduction modulo 2**sys.hash_info.width\n" +" M = 2**(sys.hash_info.width - 1)\n" +" hash_value = (hash_value & (M - 1)) - (hash_value & M)\n" +" if hash_value == -1:\n" +" hash_value = -2\n" +" return hash_value" +msgstr "" + +msgid "Boolean Type - :class:`bool`" +msgstr "" + +msgid "" +"Booleans represent truth values. The :class:`bool` type has exactly two " +"constant instances: ``True`` and ``False``." +msgstr "" + +msgid "" +"The built-in function :func:`bool` converts any value to a boolean, if the " +"value can be interpreted as a truth value (see section :ref:`truth` above)." +msgstr "" + +msgid "" +"For logical operations, use the :ref:`boolean operators ` ``and``, " +"``or`` and ``not``. When applying the bitwise operators ``&``, ``|``, ``^`` " +"to two booleans, they return a bool equivalent to the logical operations " +"\"and\", \"or\", \"xor\". However, the logical operators ``and``, ``or`` and " +"``!=`` should be preferred over ``&``, ``|`` and ``^``." +msgstr "" + +msgid "" +"The use of the bitwise inversion operator ``~`` is deprecated and will raise " +"an error in Python 3.16." +msgstr "" + +msgid "" +":class:`bool` is a subclass of :class:`int` (see :ref:`typesnumeric`). In " +"many numeric contexts, ``False`` and ``True`` behave like the integers 0 and " +"1, respectively. However, relying on this is discouraged; explicitly convert " +"using :func:`int` instead." +msgstr "" + +msgid "Iterator Types" +msgstr "" + +msgid "" +"Python supports a concept of iteration over containers. This is implemented " +"using two distinct methods; these are used to allow user-defined classes to " +"support iteration. Sequences, described below in more detail, always " +"support the iteration methods." +msgstr "" + +msgid "" +"One method needs to be defined for container objects to " +"provide :term:`iterable` support:" +msgstr "" + +msgid "" +"Return an :term:`iterator` object. The object is required to support the " +"iterator protocol described below. If a container supports different types " +"of iteration, additional methods can be provided to specifically request " +"iterators for those iteration types. (An example of an object supporting " +"multiple forms of iteration would be a tree structure which supports both " +"breadth-first and depth-first traversal.) This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." +msgstr "" + +msgid "" +"The iterator objects themselves are required to support the following two " +"methods, which together form the :dfn:`iterator protocol`:" +msgstr "" + +msgid "" +"Return the :term:`iterator` object itself. This is required to allow both " +"containers and iterators to be used with the :keyword:`for` " +"and :keyword:`in` statements. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." +msgstr "" + +msgid "" +"Return the next item from the :term:`iterator`. If there are no further " +"items, raise the :exc:`StopIteration` exception. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iternext` slot of the type structure for " +"Python objects in the Python/C API." +msgstr "" + +msgid "" +"Python defines several iterator objects to support iteration over general " +"and specific sequence types, dictionaries, and other more specialized " +"forms. The specific types are not important beyond their implementation of " +"the iterator protocol." +msgstr "" + +msgid "" +"Once an iterator's :meth:`~iterator.__next__` method " +"raises :exc:`StopIteration`, it must continue to do so on subsequent calls. " +"Implementations that do not obey this property are deemed broken." +msgstr "" + +msgid "Generator Types" +msgstr "" + +msgid "" +"Python's :term:`generator`\\s provide a convenient way to implement the " +"iterator protocol. If a container object's :meth:`~object.__iter__` method " +"is implemented as a generator, it will automatically return an iterator " +"object (technically, a generator object) supplying " +"the :meth:`~iterator.__iter__` and :meth:`~generator.__next__` methods. More " +"information about generators can be found in :ref:`the documentation for the " +"yield expression `." +msgstr "" + +msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`" +msgstr "" + +msgid "" +"There are three basic sequence types: lists, tuples, and range objects. " +"Additional sequence types tailored for processing of :ref:`binary data " +"` and :ref:`text strings ` are described in dedicated " +"sections." +msgstr "" + +msgid "Common Sequence Operations" +msgstr "" + +msgid "" +"The operations in the following table are supported by most sequence types, " +"both mutable and immutable. The :class:`collections.abc.Sequence` ABC is " +"provided to make it easier to correctly implement these operations on custom " +"sequence types." +msgstr "" + +msgid "" +"This table lists the sequence operations sorted in ascending priority. In " +"the table, *s* and *t* are sequences of the same type, *n*, *i*, *j* and *k* " +"are integers and *x* is an arbitrary object that meets any type and value " +"restrictions imposed by *s*." +msgstr "" + +msgid "" +"The ``in`` and ``not in`` operations have the same priorities as the " +"comparison operations. The ``+`` (concatenation) and ``*`` (repetition) " +"operations have the same priority as the corresponding numeric operations. " +"[3]_" +msgstr "" + +msgid "" +"See :ref:`time-complexity` for the costs of the various sequence operations." +msgstr "" + +msgid "``x in s``" +msgstr "``x in s``" + +msgid "``True`` if an item of *s* is equal to *x*, else ``False``" +msgstr "" + +msgid "``x not in s``" +msgstr "" + +msgid "``False`` if an item of *s* is equal to *x*, else ``True``" +msgstr "" + +msgid "``s + t``" +msgstr "``s + t``" + +msgid "the concatenation of *s* and *t*" +msgstr "" + +msgid "(6)(7)" +msgstr "" + +msgid "``s * n`` or ``n * s``" +msgstr "" + +msgid "equivalent to adding *s* to itself *n* times" +msgstr "" + +msgid "(2)(7)" +msgstr "" + +msgid "``s[i]``" +msgstr "``s[i]``" + +msgid "*i*\\ th item of *s*, origin 0" +msgstr "" + +msgid "(3)(8)" +msgstr "" + +msgid "``s[i:j]``" +msgstr "``s[i:j]``" + +msgid "slice of *s* from *i* to *j*" +msgstr "" + +msgid "(3)(4)" +msgstr "" + +msgid "``s[i:j:k]``" +msgstr "``s[i:j:k]``" + +msgid "slice of *s* from *i* to *j* with step *k*" +msgstr "" + +msgid "(3)(5)" +msgstr "" + +msgid "``len(s)``" +msgstr "``len(s)``" + +msgid "length of *s*" +msgstr "" + +msgid "``min(s)``" +msgstr "``min(s)``" + +msgid "smallest item of *s*" +msgstr "" + +msgid "``max(s)``" +msgstr "``max(s)``" + +msgid "largest item of *s*" +msgstr "" + +msgid "" +"Sequences of the same type also support comparisons. In particular, tuples " +"and lists are compared lexicographically by comparing corresponding " +"elements. This means that to compare equal, every element must compare equal " +"and the two sequences must be of the same type and have the same length. " +"(For full details see :ref:`comparisons` in the language reference.)" +msgstr "" + +msgid "" +"Forward and reversed iterators over mutable sequences access values using an " +"index. That index will continue to march forward (or backward) even if the " +"underlying sequence is mutated. The iterator terminates only when " +"an :exc:`IndexError` or a :exc:`StopIteration` is encountered (or when the " +"index drops below zero)." +msgstr "" + +msgid "" +"While the ``in`` and ``not in`` operations are used only for simple " +"containment testing in the general case, some specialised sequences (such " +"as :class:`str`, :class:`bytes` and :class:`bytearray`) also use them for " +"subsequence testing::" +msgstr "" + +msgid "" +">>> \"gg\" in \"eggs\"\n" +"True" +msgstr "" +">>> \"gg\" in \"eggs\"\n" +"True" + +msgid "" +"Values of *n* less than ``0`` are treated as ``0`` (which yields an empty " +"sequence of the same type as *s*). Note that items in the sequence *s* are " +"not copied; they are referenced multiple times. This often haunts new " +"Python programmers; consider::" +msgstr "" + +msgid "" +">>> lists = [[]] * 3\n" +">>> lists\n" +"[[], [], []]\n" +">>> lists[0].append(3)\n" +">>> lists\n" +"[[3], [3], [3]]" +msgstr "" + +msgid "" +"What has happened is that ``[[]]`` is a one-element list containing an empty " +"list, so all three elements of ``[[]] * 3`` are references to this single " +"empty list. Modifying any of the elements of ``lists`` modifies this single " +"list. You can create a list of different lists this way::" +msgstr "" + +msgid "" +">>> lists = [[] for i in range(3)]\n" +">>> lists[0].append(3)\n" +">>> lists[1].append(5)\n" +">>> lists[2].append(7)\n" +">>> lists\n" +"[[3], [5], [7]]" +msgstr "" + +msgid "" +"Further explanation is available in the FAQ entry :ref:`faq-multidimensional-" +"list`." +msgstr "" + +msgid "" +"If *i* or *j* is negative, the index is relative to the end of sequence *s*: " +"``len(s) + i`` or ``len(s) + j`` is substituted. But note that ``-0`` is " +"still ``0``." +msgstr "" + +msgid "" +"The slice of *s* from *i* to *j* is defined as the sequence of items with " +"index *k* such that ``i <= k < j``." +msgstr "" + +msgid "If *i* is omitted or ``None``, use ``0``." +msgstr "" + +msgid "If *j* is omitted or ``None``, use ``len(s)``." +msgstr "" + +msgid "If *i* or *j* is less than ``-len(s)``, use ``0``." +msgstr "" + +msgid "If *i* or *j* is greater than ``len(s)``, use ``len(s)``." +msgstr "" + +msgid "If *i* is greater than or equal to *j*, the slice is empty." +msgstr "" + +msgid "" +"The slice of *s* from *i* to *j* with step *k* is defined as the sequence of " +"items with index ``x = i + n*k`` such that ``0 <= n < (j-i)/k``. In other " +"words, the indices are ``i``, ``i+k``, ``i+2*k``, ``i+3*k`` and so on, " +"stopping when *j* is reached (but never including *j*). When *k* is " +"positive, *i* and *j* are reduced to ``len(s)`` if they are greater. When " +"*k* is negative, *i* and *j* are reduced to ``len(s) - 1`` if they are " +"greater. If *i* or *j* are omitted or ``None``, they become \"end\" values " +"(which end depends on the sign of *k*). Note, *k* cannot be zero. If *k* is " +"``None``, it is treated like ``1``." +msgstr "" + +msgid "" +"Concatenating immutable sequences always results in a new object. This " +"means that building up a sequence by repeated concatenation will have a " +"quadratic runtime cost in the total sequence length. To get a linear " +"runtime cost, you must switch to one of the alternatives below:" +msgstr "" + +msgid "" +"if concatenating :class:`str` objects, you can build a list and " +"use :meth:`str.join` at the end or else write to an :class:`io.StringIO` " +"instance and retrieve its value when complete" +msgstr "" + +msgid "" +"if concatenating :class:`bytes` objects, you can similarly " +"use :meth:`bytes.join` or :class:`io.BytesIO`, or you can do in-place " +"concatenation with a :class:`bytearray` object. :class:`bytearray` objects " +"are mutable and have an efficient overallocation mechanism" +msgstr "" + +msgid "if concatenating :class:`tuple` objects, extend a :class:`list` instead" +msgstr "" + +msgid "for other types, investigate the relevant class documentation" +msgstr "" + +msgid "" +"Some sequence types (such as :class:`range`) only support item sequences " +"that follow specific patterns, and hence don't support sequence " +"concatenation or repetition." +msgstr "" + +msgid "An :exc:`IndexError` is raised if *i* is outside the sequence range." +msgstr "" + +msgid "Sequence Methods" +msgstr "" + +msgid "Sequence types also support the following methods:" +msgstr "" + +msgid "Return the total number of occurrences of *value* in *sequence*." +msgstr "" + +msgid "Return the index of the first occurrence of *value* in *sequence*." +msgstr "" + +msgid "Raises :exc:`ValueError` if *value* is not found in *sequence*." +msgstr "" + +msgid "" +"The *start* or *stop* arguments allow for efficient searching of subsections " +"of the sequence, beginning at *start* and ending at *stop*. This is roughly " +"equivalent to ``start + sequence[start:stop].index(value)``, only without " +"copying any data." +msgstr "" + +msgid "" +"Not all sequence types support passing the *start* and *stop* arguments." +msgstr "" + +msgid "Immutable Sequence Types" +msgstr "" + +msgid "" +"The only operation that immutable sequence types generally implement that is " +"not also implemented by mutable sequence types is support for " +"the :func:`hash` built-in." +msgstr "" + +msgid "" +"This support allows immutable sequences, such as :class:`tuple` instances, " +"to be used as :class:`dict` keys and stored in :class:`set` " +"and :class:`frozenset` instances." +msgstr "" + +msgid "" +"Attempting to hash an immutable sequence that contains unhashable values " +"will result in :exc:`TypeError`." +msgstr "" + +msgid "Mutable Sequence Types" +msgstr "" + +msgid "" +"The operations in the following table are defined on mutable sequence types. " +"The :class:`collections.abc.MutableSequence` ABC is provided to make it " +"easier to correctly implement these operations on custom sequence types." +msgstr "" + +msgid "" +"In the table *s* is an instance of a mutable sequence type, *t* is any " +"iterable object and *x* is an arbitrary object that meets any type and value " +"restrictions imposed by *s* (for example, :class:`bytearray` only accepts " +"integers that meet the value restriction ``0 <= x <= 255``)." +msgstr "" + +msgid "``s[i] = x``" +msgstr "``s[i] = x``" + +msgid "item *i* of *s* is replaced by *x*" +msgstr "" + +msgid "``del s[i]``" +msgstr "``del s[i]``" + +msgid "removes item *i* of *s*" +msgstr "" + +msgid "``s[i:j] = t``" +msgstr "``s[i:j] = t``" + +msgid "" +"slice of *s* from *i* to *j* is replaced by the contents of the iterable *t*" +msgstr "" + +msgid "``del s[i:j]``" +msgstr "``del s[i:j]``" + +msgid "" +"removes the elements of ``s[i:j]`` from the list (same as ``s[i:j] = []``)" +msgstr "" + +msgid "``s[i:j:k] = t``" +msgstr "``s[i:j:k] = t``" + +msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" +msgstr "" + +msgid "``del s[i:j:k]``" +msgstr "``del s[i:j:k]``" + +msgid "removes the elements of ``s[i:j:k]`` from the list" +msgstr "" + +msgid "``s += t``" +msgstr "" + +msgid "" +"extends *s* with the contents of *t* (for the most part the same as " +"``s[len(s):len(s)] = t``)" +msgstr "" + +msgid "``s *= n``" +msgstr "``s *= n``" + +msgid "updates *s* with its contents repeated *n* times" +msgstr "" + +msgid "" +"If *k* is not equal to ``1``, *t* must have the same length as the slice it " +"is replacing." +msgstr "" + +msgid "" +"The value *n* is an integer, or an object " +"implementing :meth:`~object.__index__`. Zero and negative values of *n* " +"clear the sequence. Items in the sequence are not copied; they are " +"referenced multiple times, as explained for ``s * n`` under :ref:`typesseq-" +"common`." +msgstr "" + +msgid "Mutable Sequence Methods" +msgstr "" + +msgid "Mutable sequence types also support the following methods:" +msgstr "" + +msgid "" +"Append *value* to the end of the sequence. This is equivalent to writing " +"``seq[len(seq):len(seq)] = [value]``." +msgstr "" + +msgid "" +"Remove all items from *sequence*. This is equivalent to writing ``del " +"sequence[:]``." +msgstr "" + +msgid "" +"Create a shallow copy of *sequence*. This is equivalent to writing " +"``sequence[:]``." +msgstr "" + +msgid "" +"The :meth:`!copy` method is not part of " +"the :class:`~collections.abc.MutableSequence` :class:`~abc.ABC`, but most " +"concrete mutable sequence types provide it." +msgstr "" + +msgid "" +"Extend *sequence* with the contents of *iterable*. For the most part, this " +"is the same as writing ``seq[len(seq):len(seq)] = iterable``." +msgstr "" + +msgid "" +"Insert *value* into *sequence* at the given *index*. This is equivalent to " +"writing ``sequence[index:index] = [value]``." +msgstr "" + +msgid "" +"Retrieve the item at *index* and also remove it from *sequence*. By default, " +"the last item in *sequence* is removed and returned." +msgstr "" + +msgid "Remove the first item from *sequence* where ``sequence[i] == value``." +msgstr "" + +msgid "" +"Reverse the items of *sequence* in place. This method maintains economy of " +"space when reversing a large sequence. To remind users that it operates by " +"side-effect, it returns ``None``." +msgstr "" + +msgid "Lists" +msgstr "Listy" + +msgid "" +"Lists are mutable sequences, typically used to store collections of " +"homogeneous items (where the precise degree of similarity will vary by " +"application)." +msgstr "" + +msgid "Lists may be constructed in several ways:" +msgstr "" + +msgid "Using a pair of square brackets to denote the empty list: ``[]``" +msgstr "" + +msgid "" +"Using square brackets, separating items with commas: ``[a]``, ``[a, b, c]``" +msgstr "" + +msgid "Using a list comprehension: ``[x for x in iterable]``" +msgstr "" + +msgid "Using the type constructor: ``list()`` or ``list(iterable)``" +msgstr "" + +msgid "" +"The constructor builds a list whose items are the same and in the same order " +"as *iterable*'s items. *iterable* may be either a sequence, a container " +"that supports iteration, or an iterator object. If *iterable* is already a " +"list, a copy is made and returned, similar to ``iterable[:]``. For example, " +"``list('abc')`` returns ``['a', 'b', 'c']`` and ``list( (1, 2, 3) )`` " +"returns ``[1, 2, 3]``. If no argument is given, the constructor creates a " +"new empty list, ``[]``." +msgstr "" + +msgid "" +"Many other operations also produce lists, including the :func:`sorted` built-" +"in." +msgstr "" + +msgid "Lists are :ref:`generic ` over the types of their items." +msgstr "" + +msgid "" +"Lists implement all of the :ref:`common ` and :ref:`mutable " +"` sequence operations. Lists also provide the following " +"additional method:" +msgstr "" + +msgid "" +"This method sorts the list in place, using only ``<`` comparisons between " +"items. Exceptions are not suppressed - if any comparison operations fail, " +"the entire sort operation will fail (and the list will likely be left in a " +"partially modified state)." +msgstr "" + +msgid "" +":meth:`sort` accepts two arguments that can only be passed by keyword " +"(:ref:`keyword-only arguments `):" +msgstr "" + +msgid "" +"*key* specifies a function of one argument that is used to extract a " +"comparison key from each list element (for example, ``key=str.lower``). The " +"key corresponding to each item in the list is calculated once and then used " +"for the entire sorting process. The default value of ``None`` means that " +"list items are sorted directly without calculating a separate key value." +msgstr "" + +msgid "" +"The :func:`functools.cmp_to_key` utility is available to convert a 2.x style " +"*cmp* function to a *key* function." +msgstr "" + +msgid "" +"*reverse* is a boolean value. If set to ``True``, then the list elements " +"are sorted as if each comparison were reversed." +msgstr "" +"*reverse* jest wartością logiczną. Jeśli jest ustawiona na ``True``, " +"elementy listy są sortowane tak, jakby każde porównanie było odwrócone." + +msgid "" +"This method modifies the sequence in place for economy of space when sorting " +"a large sequence. To remind users that it operates by side effect, it does " +"not return the sorted sequence (use :func:`sorted` to explicitly request a " +"new sorted list instance)." +msgstr "" + +msgid "" +"The :meth:`sort` method is guaranteed to be stable. A sort is stable if it " +"guarantees not to change the relative order of elements that compare equal " +"--- this is helpful for sorting in multiple passes (for example, sort by " +"department, then by salary grade)." +msgstr "" + +msgid "" +"For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." +msgstr "" +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." + +msgid "" +"While a list is being sorted, the effect of attempting to mutate, or even " +"inspect, the list is undefined. The C implementation of Python makes the " +"list appear empty for the duration, and raises :exc:`ValueError` if it can " +"detect that the list has been mutated during a sort." +msgstr "" + +msgid "" +"For detailed information on thread-safety guarantees for :class:`list` " +"objects, see :ref:`thread-safety-list`." +msgstr "" + +msgid "Tuples" +msgstr "" + +msgid "" +"Tuples are immutable sequences, typically used to store collections of " +"heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " +"built-in). Tuples are also used for cases where an immutable sequence of " +"homogeneous data is needed (such as allowing storage in a :class:`set` " +"or :class:`dict` instance)." +msgstr "" + +msgid "Tuples may be constructed in a number of ways:" +msgstr "Krotki mogą być konstruowane na kilka sposobów:" + +msgid "Using a pair of parentheses to denote the empty tuple: ``()``" +msgstr "Przy użyciu pary nawiasów, by oznaczyć pustą krotkę: ``()``" + +msgid "Using a trailing comma for a singleton tuple: ``a,`` or ``(a,)``" +msgstr "" +"Przy użyciu przecinka, by oznaczyć jednoelementową krotkę: ``a,`` lub " +"``(a,)``" + +msgid "Separating items with commas: ``a, b, c`` or ``(a, b, c)``" +msgstr "" + +msgid "Using the :func:`tuple` built-in: ``tuple()`` or ``tuple(iterable)``" +msgstr "" +"Przy użyciu wbudowanej funkcji :func:`tuple`: ``tuple()`` lub " +"``tuple(iterable)``" + +msgid "" +"The constructor builds a tuple whose items are the same and in the same " +"order as *iterable*'s items. *iterable* may be either a sequence, a " +"container that supports iteration, or an iterator object. If *iterable* is " +"already a tuple, it is returned unchanged. For example, ``tuple('abc')`` " +"returns ``('a', 'b', 'c')`` and ``tuple( [1, 2, 3] )`` returns ``(1, 2, " +"3)``. If no argument is given, the constructor creates a new empty tuple, " +"``()``." +msgstr "" + +msgid "" +"Note that it is actually the comma which makes a tuple, not the parentheses. " +"The parentheses are optional, except in the empty tuple case, or when they " +"are needed to avoid syntactic ambiguity. For example, ``f(a, b, c)`` is a " +"function call with three arguments, while ``f((a, b, c))`` is a function " +"call with a 3-tuple as the sole argument." +msgstr "" + +msgid "" +"Tuples implement all of the :ref:`common ` sequence " +"operations." +msgstr "" + +msgid "" +"Tuples are :ref:`generic ` over the types of their contents. For " +"more information, refer to :ref:`the typing documentation on annotating " +"tuples `." +msgstr "" + +msgid "" +"For heterogeneous collections of data where access by name is clearer than " +"access by index, :func:`collections.namedtuple` may be a more appropriate " +"choice than a simple tuple object." +msgstr "" + +msgid "Ranges" +msgstr "" + +msgid "" +"The :class:`range` type represents an immutable sequence of numbers and is " +"commonly used for looping a specific number of times in :keyword:`for` loops." +msgstr "" + +msgid "" +"The arguments to the range constructor must be integers (either built-" +"in :class:`int` or any object that implements the :meth:`~object.__index__` " +"special method). If the *step* argument is omitted, it defaults to ``1``. " +"If the *start* argument is omitted, it defaults to ``0``. If *step* is " +"zero, :exc:`ValueError` is raised." +msgstr "" + +msgid "" +"For a positive *step*, the contents of a range ``r`` are determined by the " +"formula ``r[i] = start + step*i`` where ``i >= 0`` and ``r[i] < stop``." +msgstr "" + +msgid "" +"For a negative *step*, the contents of the range are still determined by the " +"formula ``r[i] = start + step*i``, but the constraints are ``i >= 0`` and " +"``r[i] > stop``." +msgstr "" + +msgid "" +"A range object will be empty if ``r[0]`` does not meet the value constraint. " +"Ranges do support negative indices, but these are interpreted as indexing " +"from the end of the sequence determined by the positive indices." +msgstr "" + +msgid "" +"Ranges containing absolute values larger than :data:`sys.maxsize` are " +"permitted but some features (such as :func:`len`) may " +"raise :exc:`OverflowError`." +msgstr "" + +msgid "Range examples::" +msgstr "" + +msgid "" +">>> list(range(10))\n" +"[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]\n" +">>> list(range(1, 11))\n" +"[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]\n" +">>> list(range(0, 30, 5))\n" +"[0, 5, 10, 15, 20, 25]\n" +">>> list(range(0, 10, 3))\n" +"[0, 3, 6, 9]\n" +">>> list(range(0, -10, -1))\n" +"[0, -1, -2, -3, -4, -5, -6, -7, -8, -9]\n" +">>> list(range(0))\n" +"[]\n" +">>> list(range(1, 0))\n" +"[]" +msgstr "" + +msgid "" +"Ranges implement all of the :ref:`common ` sequence " +"operations except concatenation and repetition (due to the fact that range " +"objects can only represent sequences that follow a strict pattern and " +"repetition and concatenation will usually violate that pattern)." +msgstr "" + +msgid "" +"The value of the *start* parameter (or ``0`` if the parameter was not " +"supplied)" +msgstr "" + +msgid "The value of the *stop* parameter" +msgstr "" + +msgid "" +"The value of the *step* parameter (or ``1`` if the parameter was not " +"supplied)" +msgstr "" + +msgid "" +"The advantage of the :class:`range` type over a regular :class:`list` " +"or :class:`tuple` is that a :class:`range` object will always take the same " +"(small) amount of memory, no matter the size of the range it represents (as " +"it only stores the ``start``, ``stop`` and ``step`` values, calculating " +"individual items and subranges as needed)." +msgstr "" + +msgid "" +"Range objects implement the :class:`collections.abc.Sequence` ABC, and " +"provide features such as containment tests, element index lookup, slicing " +"and support for negative indices (see :ref:`typesseq`):" +msgstr "" + +msgid "" +"Testing range objects for equality with ``==`` and ``!=`` compares them as " +"sequences. That is, two range objects are considered equal if they " +"represent the same sequence of values. (Note that two range objects that " +"compare equal might have different :attr:`~range.start`, :attr:`~range.stop` " +"and :attr:`~range.step` attributes, for example ``range(0) == range(2, 1, " +"3)`` or ``range(0, 3, 2) == range(0, 4, 2)``.)" +msgstr "" + +msgid "" +"Implement the Sequence ABC. Support slicing and negative indices. " +"Test :class:`int` objects for membership in constant time instead of " +"iterating through all items." +msgstr "" + +msgid "" +"Define '==' and '!=' to compare range objects based on the sequence of " +"values they define (instead of comparing based on object identity)." +msgstr "" + +msgid "" +"Added the :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " +"attributes." +msgstr "" + +msgid "" +"The `linspace recipe `_ shows how to implement a lazy version of range " +"suitable for floating-point applications." +msgstr "" + +msgid "Text and Binary Sequence Type Methods Summary" +msgstr "" + +msgid "" +"The following table summarizes the text and binary sequence types methods by " +"category." +msgstr "" + +msgid "Category" +msgstr "" + +msgid ":class:`str` methods" +msgstr ":class:`str` methods" + +msgid ":class:`bytes` and :class:`bytearray` methods" +msgstr "" + +msgid "Formatting" +msgstr "" + +msgid ":meth:`str.format`" +msgstr ":meth:`str.format`" + +msgid ":meth:`str.format_map`" +msgstr ":meth:`str.format_map`" + +msgid ":ref:`f-strings`" +msgstr ":ref:`f-strings`" + +msgid ":ref:`old-string-formatting`" +msgstr ":ref:`old-string-formatting`" + +msgid ":ref:`bytes-formatting`" +msgstr ":ref:`bytes-formatting`" + +msgid "Searching and Replacing" +msgstr "" + +msgid ":meth:`str.find`" +msgstr ":meth:`str.find`" + +msgid ":meth:`str.rfind`" +msgstr ":meth:`str.rfind`" + +msgid ":meth:`bytes.find`" +msgstr ":meth:`bytes.find`" + +msgid ":meth:`bytes.rfind`" +msgstr ":meth:`bytes.rfind`" + +msgid ":meth:`str.index`" +msgstr ":meth:`str.index`" + +msgid ":meth:`str.rindex`" +msgstr ":meth:`str.rindex`" + +msgid ":meth:`bytes.index`" +msgstr ":meth:`bytes.index`" + +msgid ":meth:`bytes.rindex`" +msgstr ":meth:`bytes.rindex`" + +msgid ":meth:`str.startswith`" +msgstr ":meth:`str.startswith`" + +msgid ":meth:`bytes.startswith`" +msgstr ":meth:`bytes.startswith`" + +msgid ":meth:`str.endswith`" +msgstr ":meth:`str.endswith`" + +msgid ":meth:`bytes.endswith`" +msgstr ":meth:`bytes.endswith`" + +msgid ":meth:`str.count`" +msgstr ":meth:`str.count`" + +msgid ":meth:`bytes.count`" +msgstr ":meth:`bytes.count`" + +msgid ":meth:`str.replace`" +msgstr ":meth:`str.replace`" + +msgid ":meth:`bytes.replace`" +msgstr ":meth:`bytes.replace`" + +msgid "Splitting and Joining" +msgstr "" + +msgid ":meth:`str.split`" +msgstr ":meth:`str.split`" + +msgid ":meth:`str.rsplit`" +msgstr ":meth:`str.rsplit`" + +msgid ":meth:`bytes.split`" +msgstr ":meth:`bytes.split`" + +msgid ":meth:`bytes.rsplit`" +msgstr ":meth:`bytes.rsplit`" + +msgid ":meth:`str.splitlines`" +msgstr ":meth:`str.splitlines`" + +msgid ":meth:`bytes.splitlines`" +msgstr ":meth:`bytes.splitlines`" + +msgid ":meth:`str.partition`" +msgstr ":meth:`str.partition`" + +msgid ":meth:`bytes.partition`" +msgstr ":meth:`bytes.partition`" + +msgid ":meth:`str.rpartition`" +msgstr ":meth:`str.rpartition`" + +msgid ":meth:`bytes.rpartition`" +msgstr ":meth:`bytes.rpartition`" + +msgid ":meth:`str.join`" +msgstr ":meth:`str.join`" + +msgid ":meth:`bytes.join`" +msgstr ":meth:`bytes.join`" + +msgid "String Classification" +msgstr "" + +msgid ":meth:`str.isalpha`" +msgstr ":meth:`str.isalpha`" + +msgid ":meth:`bytes.isalpha`" +msgstr ":meth:`bytes.isalpha`" + +msgid ":meth:`str.isdecimal`" +msgstr ":meth:`str.isdecimal`" + +msgid ":meth:`str.isdigit`" +msgstr ":meth:`str.isdigit`" + +msgid ":meth:`bytes.isdigit`" +msgstr ":meth:`bytes.isdigit`" + +msgid ":meth:`str.isnumeric`" +msgstr ":meth:`str.isnumeric`" + +msgid ":meth:`str.isalnum`" +msgstr ":meth:`str.isalnum`" + +msgid ":meth:`bytes.isalnum`" +msgstr ":meth:`bytes.isalnum`" + +msgid ":meth:`str.isidentifier`" +msgstr ":meth:`str.isidentifier`" + +msgid ":meth:`str.islower`" +msgstr ":meth:`str.islower`" + +msgid ":meth:`bytes.islower`" +msgstr ":meth:`bytes.islower`" + +msgid ":meth:`str.isupper`" +msgstr ":meth:`str.isupper`" + +msgid ":meth:`bytes.isupper`" +msgstr ":meth:`bytes.isupper`" + +msgid ":meth:`str.istitle`" +msgstr ":meth:`str.istitle`" + +msgid ":meth:`bytes.istitle`" +msgstr ":meth:`bytes.istitle`" + +msgid ":meth:`str.isspace`" +msgstr ":meth:`str.isspace`" + +msgid ":meth:`bytes.isspace`" +msgstr ":meth:`bytes.isspace`" + +msgid ":meth:`str.isprintable`" +msgstr ":meth:`str.isprintable`" + +msgid "Case Manipulation" +msgstr "" + +msgid ":meth:`str.lower`" +msgstr ":meth:`str.lower`" + +msgid ":meth:`bytes.lower`" +msgstr ":meth:`bytes.lower`" + +msgid ":meth:`str.upper`" +msgstr ":meth:`str.upper`" + +msgid ":meth:`bytes.upper`" +msgstr ":meth:`bytes.upper`" + +msgid ":meth:`str.casefold`" +msgstr ":meth:`str.casefold`" + +msgid ":meth:`str.capitalize`" +msgstr ":meth:`str.capitalize`" + +msgid ":meth:`bytes.capitalize`" +msgstr ":meth:`bytes.capitalize`" + +msgid ":meth:`str.title`" +msgstr ":meth:`str.title`" + +msgid ":meth:`bytes.title`" +msgstr ":meth:`bytes.title`" + +msgid ":meth:`str.swapcase`" +msgstr ":meth:`str.swapcase`" + +msgid ":meth:`bytes.swapcase`" +msgstr ":meth:`bytes.swapcase`" + +msgid "Padding and Stripping" +msgstr "" + +msgid ":meth:`str.ljust`" +msgstr ":meth:`str.ljust`" + +msgid ":meth:`str.rjust`" +msgstr ":meth:`str.rjust`" + +msgid ":meth:`bytes.ljust`" +msgstr ":meth:`bytes.ljust`" + +msgid ":meth:`bytes.rjust`" +msgstr ":meth:`bytes.rjust`" + +msgid ":meth:`str.center`" +msgstr ":meth:`str.center`" + +msgid ":meth:`bytes.center`" +msgstr ":meth:`bytes.center`" + +msgid ":meth:`str.expandtabs`" +msgstr ":meth:`str.expandtabs`" + +msgid ":meth:`bytes.expandtabs`" +msgstr ":meth:`bytes.expandtabs`" + +msgid ":meth:`str.strip`" +msgstr ":meth:`str.strip`" + +msgid ":meth:`bytes.strip`" +msgstr ":meth:`bytes.strip`" + +msgid ":meth:`str.lstrip`" +msgstr ":meth:`str.lstrip`" + +msgid ":meth:`str.rstrip`" +msgstr ":meth:`str.rstrip`" + +msgid ":meth:`bytes.lstrip`" +msgstr ":meth:`bytes.lstrip`" + +msgid ":meth:`bytes.rstrip`" +msgstr ":meth:`bytes.rstrip`" + +msgid ":meth:`str.removeprefix`" +msgstr "" + +msgid ":meth:`bytes.removeprefix`" +msgstr "" + +msgid ":meth:`str.removesuffix`" +msgstr "" + +msgid ":meth:`bytes.removesuffix`" +msgstr "" + +msgid "Translation and Encoding" +msgstr "" + +msgid ":meth:`str.translate`" +msgstr ":meth:`str.translate`" + +msgid ":meth:`bytes.translate`" +msgstr ":meth:`bytes.translate`" + +msgid ":meth:`str.maketrans`" +msgstr ":meth:`str.maketrans`" + +msgid ":meth:`bytes.maketrans`" +msgstr ":meth:`bytes.maketrans`" + +msgid ":meth:`str.encode`" +msgstr ":meth:`str.encode`" + +msgid ":meth:`bytes.decode`" +msgstr ":meth:`bytes.decode`" + +msgid "Text Sequence Type --- :class:`str`" +msgstr "" + +msgid "" +"Textual data in Python is handled with :class:`str` objects, " +"or :dfn:`strings`. Strings are immutable :ref:`sequences ` of " +"Unicode code points. String literals are written in a variety of ways:" +msgstr "" + +msgid "Single quotes: ``'allows embedded \"double\" quotes'``" +msgstr "" + +msgid "Double quotes: ``\"allows embedded 'single' quotes\"``" +msgstr "" + +msgid "" +"Triple quoted: ``'''Three single quotes'''``, ``\"\"\"Three double " +"quotes\"\"\"``" +msgstr "" + +msgid "" +"Triple quoted strings may span multiple lines - all associated whitespace " +"will be included in the string literal." +msgstr "" + +msgid "" +"String literals that are part of a single expression and have only " +"whitespace between them will be implicitly converted to a single string " +"literal. That is, ``(\"spam \" \"eggs\") == \"spam eggs\"``." +msgstr "" + +msgid "" +"See :ref:`strings` for more about the various forms of string literal, " +"including supported :ref:`escape sequences `, and the " +"``r`` (\"raw\") prefix that disables most escape sequence processing." +msgstr "" + +msgid "" +"Strings may also be created from other objects using the :class:`str` " +"constructor." +msgstr "" + +msgid "" +"Since there is no separate \"character\" type, indexing a string produces " +"strings of length 1. That is, for a non-empty string *s*, ``s[0] == s[0:1]``." +msgstr "" + +msgid "" +"There is also no mutable string type, but :meth:`str.join` " +"or :class:`io.StringIO` can be used to efficiently construct strings from " +"multiple fragments." +msgstr "" + +msgid "" +"For backwards compatibility with the Python 2 series, the ``u`` prefix is " +"once again permitted on string literals. It has no effect on the meaning of " +"string literals and cannot be combined with the ``r`` prefix." +msgstr "" + +msgid "" +"Return a :ref:`string ` version of *object*. If *object* is not " +"provided, returns the empty string. Otherwise, the behavior of ``str()`` " +"depends on whether *encoding* or *errors* is given, as follows." +msgstr "" + +msgid "" +"If neither *encoding* nor *errors* is given, ``str(object)`` " +"returns :meth:`type(object).__str__(object) `, which is the " +"\"informal\" or nicely printable string representation of *object*. For " +"string objects, this is the string itself. If *object* does not have " +"a :meth:`~object.__str__` method, then :func:`str` falls back to " +"returning :func:`repr(object) `." +msgstr "" + +msgid "" +"If at least one of *encoding* or *errors* is given, *object* should be " +"a :term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " +"this case, if *object* is a :class:`bytes` (or :class:`bytearray`) object, " +"then ``str(bytes, encoding, errors)`` is equivalent " +"to :meth:`bytes.decode(encoding, errors) `. Otherwise, the " +"bytes object underlying the buffer object is obtained before " +"calling :meth:`bytes.decode`. See :ref:`binaryseq` and :ref:`bufferobjects` " +"for information on buffer objects." +msgstr "" + +msgid "" +"Passing a :class:`bytes` object to :func:`str` without the *encoding* or " +"*errors* arguments falls under the first case of returning the informal " +"string representation (see also the :option:`-b` command-line option to " +"Python). For example::" +msgstr "" + +msgid "" +">>> str(b'Zoot!')\n" +"\"b'Zoot!'\"" +msgstr "" +">>> str(b'Zoot!')\n" +"\"b'Zoot!'\"" + +msgid "" +"For more information on the ``str`` class and its methods, " +"see :ref:`textseq` and the :ref:`string-methods` section below. To output " +"formatted strings, see the :ref:`f-strings` and :ref:`formatstrings` " +"sections. In addition, see the :ref:`stringservices` section." +msgstr "" + +msgid "String Methods" +msgstr "Metody ciągów" + +msgid "" +"Strings implement all of the :ref:`common ` sequence " +"operations, along with the additional methods described below." +msgstr "" + +msgid "" +"Strings also support two styles of string formatting, one providing a large " +"degree of flexibility and customization " +"(see :meth:`str.format`, :ref:`formatstrings` and :ref:`string-formatting`) " +"and the other based on C ``printf`` style formatting that handles a narrower " +"range of types and is slightly harder to use correctly, but is often faster " +"for the cases it can handle (:ref:`old-string-formatting`)." +msgstr "" + +msgid "" +"The :ref:`textservices` section of the standard library covers a number of " +"other modules that provide various text related utilities (including regular " +"expression support in the :mod:`re` module)." +msgstr "" + +msgid "" +"Return a copy of the string with its first character capitalized and the " +"rest lowercased." +msgstr "" + +msgid "" +"The first character is now put into titlecase rather than uppercase. This " +"means that characters like digraphs will only have their first letter " +"capitalized, instead of the full character." +msgstr "" + +msgid "" +"Return a casefolded copy of the string. Casefolded strings may be used for " +"caseless matching." +msgstr "" + +msgid "" +"Casefolding is similar to lowercasing but more aggressive because it is " +"intended to remove all case distinctions in a string. For example, the " +"German lowercase letter ``'ß'`` is equivalent to ``\"ss\"``. Since it is " +"already lowercase, :meth:`lower` would do nothing to " +"``'ß'``; :meth:`casefold` converts it to ``\"ss\"``. For example:" +msgstr "" + +msgid "" +">>> 'straße'.lower()\n" +"'straße'\n" +">>> 'straße'.casefold()\n" +"'strasse'" +msgstr "" + +msgid "" +"The casefolding algorithm is `described in section 3.13 'Default Case " +"Folding' of the Unicode Standard `__." +msgstr "" + +msgid "" +"Return centered in a string of length *width*. Padding is done using the " +"specified *fillchar* (default is an ASCII space). The original string is " +"returned if *width* is less than or equal to ``len(s)``. For example::" +msgstr "" + +msgid "" +">>> 'Python'.center(10)\n" +"' Python '\n" +">>> 'Python'.center(10, '-')\n" +"'--Python--'\n" +">>> 'Python'.center(4)\n" +"'Python'" +msgstr "" + +msgid "" +"Return the number of non-overlapping occurrences of substring *sub* in the " +"range [*start*, *end*]. Optional arguments *start* and *end* are " +"interpreted as in slice notation." +msgstr "" + +msgid "" +"If *sub* is empty, returns the number of empty strings between characters " +"which is the length of the string plus one. For example::" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.count('spam')\n" +"3\n" +">>> 'spam, spam, spam'.count('spam', 5)\n" +"2\n" +">>> 'spam, spam, spam'.count('spam', 5, 10)\n" +"1\n" +">>> 'spam, spam, spam'.count('eggs')\n" +"0\n" +">>> 'spam, spam, spam'.count('')\n" +"17" +msgstr "" + +msgid "Return the string encoded to :class:`bytes`." +msgstr "" + +msgid "" +"*encoding* defaults to ``'utf-8'``; see :ref:`standard-encodings` for " +"possible values." +msgstr "" + +msgid "" +"*errors* controls how encoding errors are handled. If ``'strict'`` (the " +"default), a :exc:`UnicodeError` exception is raised. Other possible values " +"are ``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``, " +"``'backslashreplace'`` and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." +msgstr "" + +msgid "" +"For performance reasons, the value of *errors* is not checked for validity " +"unless an encoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used. For example::" +msgstr "" + +msgid "" +">>> encoded_str_to_bytes = 'Python'.encode()\n" +">>> type(encoded_str_to_bytes)\n" +"\n" +">>> encoded_str_to_bytes\n" +"b'Python'" +msgstr "" + +msgid "Added support for keyword arguments." +msgstr "" + +msgid "" +"The value of the *errors* argument is now checked in :ref:`devmode` and " +"in :ref:`debug mode `." +msgstr "" + +msgid "" +"Return ``True`` if the string ends with the specified *suffix*, otherwise " +"return ``False``. *suffix* can also be a tuple of suffixes to look for. " +"With optional *start*, test beginning at that position. With optional " +"*end*, stop comparing at that position. Using *start* and *end* is " +"equivalent to ``str[start:end].endswith(suffix)``. For example::" +msgstr "" + +msgid "" +">>> 'Python'.endswith('on')\n" +"True\n" +">>> 'a tuple of suffixes'.endswith(('at', 'in'))\n" +"False\n" +">>> 'a tuple of suffixes'.endswith(('at', 'es'))\n" +"True\n" +">>> 'Python is amazing'.endswith('is', 0, 9)\n" +"True" +msgstr "" + +msgid "See also :meth:`startswith` and :meth:`removesuffix`." +msgstr "" + +msgid "" +"Return a copy of the string where all tab characters are replaced by one or " +"more spaces, depending on the current column and the given tab size. Tab " +"positions occur every *tabsize* characters (default is 8, giving tab " +"positions at columns 0, 8, 16 and so on). To expand the string, the current " +"column is set to zero and the string is examined character by character. If " +"the character is a tab (``\\t``), one or more space characters are inserted " +"in the result until the current column is equal to the next tab position. " +"(The tab character itself is not copied.) If the character is a newline " +"(``\\n``) or return (``\\r``), it is copied and the current column is reset " +"to zero. Any other character is copied unchanged and the current column is " +"incremented by one regardless of how the character is represented when " +"printed. For example::" +msgstr "" + +msgid "" +">>> '01\\t012\\t0123\\t01234'.expandtabs()\n" +"'01 012 0123 01234'\n" +">>> '01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"'01 012 0123 01234'\n" +">>> print('01\\t012\\n0123\\t01234'.expandtabs(4))\n" +"01 012\n" +"0123 01234" +msgstr "" + +msgid "" +"Return the lowest index in the string where substring *sub* is found within " +"the slice ``s[start:end]``. Optional arguments *start* and *end* are " +"interpreted as in slice notation. Return ``-1`` if *sub* is not found. For " +"example::" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.find('sp')\n" +"0\n" +">>> 'spam, spam, spam'.find('sp', 5)\n" +"6" +msgstr "" + +msgid "See also :meth:`rfind` and :meth:`index`." +msgstr "" + +msgid "" +"The :meth:`~str.find` method should be used only if you need to know the " +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" +msgstr "" + +msgid "" +">>> 'Py' in 'Python'\n" +"True" +msgstr "" +">>> 'Py' in 'Python'\n" +"True" + +msgid "" +"Perform a string formatting operation. The string on which this method is " +"called can contain literal text or replacement fields delimited by braces " +"``{}``. Each replacement field contains either the numeric index of a " +"positional argument, or the name of a keyword argument. Returns a copy of " +"the string where each replacement field is replaced with the string value of " +"the corresponding argument. For example:" +msgstr "" + +msgid "" +">>> \"The sum of 1 + 2 is {0}\".format(1+2)\n" +"'The sum of 1 + 2 is 3'\n" +">>> \"The sum of {a} + {b} is {answer}\".format(answer=1+2, a=1, b=2)\n" +"'The sum of 1 + 2 is 3'\n" +">>> \"{1} expects the {0} Inquisition!\".format(\"Spanish\", \"Nobody\")\n" +"'Nobody expects the Spanish Inquisition!'" +msgstr "" + +msgid "" +"See :ref:`formatstrings` for a description of the various formatting options " +"that can be specified in format strings." +msgstr "" + +msgid "" +"When formatting a number " +"(:class:`int`, :class:`float`, :class:`complex`, :class:`decimal.Decimal` " +"and subclasses) with the ``n`` type (ex: ``'{:n}'.format(1234)``), the " +"function temporarily sets the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` " +"locale to decode ``decimal_point`` and ``thousands_sep`` fields " +"of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, and the " +"``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. This " +"temporary change affects other threads." +msgstr "" + +msgid "" +"When formatting a number with the ``n`` type, the function sets temporarily " +"the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` locale in some cases." +msgstr "" + +msgid "" +"Similar to ``str.format(**mapping)``, except that ``mapping`` is used " +"directly and not copied to a :class:`dict`. This is useful if for example " +"``mapping`` is a dict subclass:" +msgstr "" + +msgid "" +"Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " +"not found. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.index('spam')\n" +"0\n" +">>> 'spam, spam, spam'.index('eggs')\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +" 'spam, spam, spam'.index('eggs')\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^\n" +"ValueError: substring not found" +msgstr "" + +msgid "See also :meth:`rindex`." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are alphanumeric and there " +"is at least one character, ``False`` otherwise. A character ``c`` is " +"alphanumeric if one of the following returns ``True``: ``c.isalpha()``, " +"``c.isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``. For example:" +msgstr "" + +msgid "" +">>> 'abc123'.isalnum()\n" +"True\n" +">>> 'abc123!@#'.isalnum()\n" +"False\n" +">>> ''.isalnum()\n" +"False\n" +">>> ' '.isalnum()\n" +"False" +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are alphabetic and there is " +"at least one character, ``False`` otherwise. Alphabetic characters are " +"those characters defined in the Unicode character database as \"Letter\", " +"i.e., those with general category property being one of \"Lm\", \"Lt\", " +"\"Lu\", \"Ll\", or \"Lo\". Note that this is different from the `Alphabetic " +"property defined in section 4.10 'Letters, Alphabetic, and Ideographic' of " +"the Unicode Standard `_. For example:" +msgstr "" + +msgid "" +">>> 'Letters and spaces'.isalpha()\n" +"False\n" +">>> 'LettersOnly'.isalpha()\n" +"True\n" +">>> 'µ'.isalpha() # non-ASCII characters can be considered alphabetical " +"too\n" +"True" +msgstr "" + +msgid "See :ref:`unicode-properties`." +msgstr "" + +msgid "" +"Return ``True`` if the string is empty or all characters in the string are " +"ASCII, ``False`` otherwise. ASCII characters have code points in the range " +"U+0000-U+007F. For example:" +msgstr "" + +msgid "" +">>> 'ASCII characters'.isascii()\n" +"True\n" +">>> 'µ'.isascii()\n" +"False" +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are decimal characters and " +"there is at least one character, ``False`` otherwise. Decimal characters are " +"those that can be used to form numbers in base 10, such as U+0660, ARABIC-" +"INDIC DIGIT ZERO. Formally a decimal character is a character in the " +"Unicode General Category \"Nd\". For example:" +msgstr "" + +msgid "" +">>> '0123456789'.isdecimal()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdecimal() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> 'alphabetic'.isdecimal()\n" +"False" +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are digits and there is at " +"least one character, ``False`` otherwise. Digits include decimal characters " +"and digits that need special handling, such as the compatibility superscript " +"digits. This covers digits which cannot be used to form numbers in base 10, " +"like the `Kharosthi numbers `__. Formally, a digit is a character that has the " +"property value Numeric_Type=Digit or Numeric_Type=Decimal." +msgstr "" + +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +">>> '0123456789'.isdigit()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdigit() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isdigit() # Vulgar fraction one fifth\n" +"False\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isnumeric`." +msgstr "" + +msgid "" +"Return ``True`` if the string is a valid identifier according to the " +"language definition, section :ref:`identifiers`." +msgstr "" + +msgid "" +":func:`keyword.iskeyword` can be used to test whether string ``s`` is a " +"reserved identifier, such as :keyword:`def` and :keyword:`class`." +msgstr "" + +msgid "Example: ::" +msgstr "" + +msgid "" +">>> from keyword import iskeyword\n" +"\n" +">>> 'hello'.isidentifier(), iskeyword('hello')\n" +"(True, False)\n" +">>> 'def'.isidentifier(), iskeyword('def')\n" +"(True, True)" +msgstr "" + +msgid "" +"Return ``True`` if all cased characters [4]_ in the string are lowercase and " +"there is at least one cased character, ``False`` otherwise." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are numeric characters, and " +"there is at least one character, ``False`` otherwise. Numeric characters " +"include digit characters, and all characters that have the Unicode numeric " +"value property, e.g. U+2155, VULGAR FRACTION ONE FIFTH. Formally, numeric " +"characters are those with the property value Numeric_Type=Digit, " +"Numeric_Type=Decimal or Numeric_Type=Numeric. For example:" +msgstr "" + +msgid "" +">>> '0123456789'.isnumeric()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isnumeric() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isnumeric() # Vulgar fraction one fifth\n" +"True\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isdigit`." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are printable, ``False`` if " +"it contains at least one non-printable character." +msgstr "" + +msgid "" +"Here \"printable\" means the character is suitable for :func:`repr` to use " +"in its output; \"non-printable\" means that :func:`repr` on built-in types " +"will hex-escape the character. It has no bearing on the handling of strings " +"written to :data:`sys.stdout` or :data:`sys.stderr`." +msgstr "" + +msgid "" +"The printable characters are those which in the Unicode character database " +"(see :mod:`unicodedata`) have a general category in group Letter, Mark, " +"Number, Punctuation, or Symbol (L, M, N, P, or S); plus the ASCII space " +"0x20. Nonprintable characters are those in group Separator or Other (Z or " +"C), except the ASCII space." +msgstr "" + +msgid "" +">>> ''.isprintable(), ' '.isprintable()\n" +"(True, True)\n" +">>> '\\t'.isprintable(), '\\n'.isprintable()\n" +"(False, False)" +msgstr "" + +msgid "See also :meth:`isspace`." +msgstr "" + +msgid "" +"Return ``True`` if there are only whitespace characters in the string and " +"there is at least one character, ``False`` otherwise." +msgstr "" + +msgid "" +">>> ''.isspace()\n" +"False\n" +">>> ' '.isspace()\n" +"True\n" +">>> '\\t\\n'.isspace() # TAB and BREAK LINE\n" +"True\n" +">>> '\\u3000'.isspace() # IDEOGRAPHIC SPACE\n" +"True" +msgstr "" + +msgid "" +"A character is *whitespace* if in the Unicode character database " +"(see :mod:`unicodedata`), either its general category is ``Zs`` " +"(\"Separator, space\"), or its bidirectional class is one of ``WS``, ``B``, " +"or ``S``." +msgstr "" + +msgid "See also :meth:`isprintable`." +msgstr "" + +msgid "" +"Return ``True`` if the string is a titlecased string and there is at least " +"one character, for example uppercase characters may only follow uncased " +"characters and lowercase characters only cased ones. Return ``False`` " +"otherwise." +msgstr "" + +msgid "" +">>> 'Spam, Spam, Spam'.istitle()\n" +"True\n" +">>> 'spam, spam, spam'.istitle()\n" +"False\n" +">>> 'SPAM, SPAM, SPAM'.istitle()\n" +"False" +msgstr "" + +msgid "See also :meth:`title`." +msgstr "" + +msgid "" +"Return ``True`` if all cased characters [4]_ in the string are uppercase and " +"there is at least one cased character, ``False`` otherwise." +msgstr "" + +msgid "" +"Return a string which is the concatenation of the strings in *iterable*. " +"A :exc:`TypeError` will be raised if there are any non-string values in " +"*iterable*, including :class:`bytes` objects. The separator between " +"elements is the string providing this method. For example:" +msgstr "" + +msgid "" +">>> ', '.join(['spam', 'spam', 'spam'])\n" +"'spam, spam, spam'\n" +">>> '-'.join('Python')\n" +"'P-y-t-h-o-n'" +msgstr "" + +msgid "See also :meth:`split`." +msgstr "" + +msgid "" +"Return the string left justified in a string of length *width*. Padding is " +"done using the specified *fillchar* (default is an ASCII space). The " +"original string is returned if *width* is less than or equal to ``len(s)``." +msgstr "" + +msgid "" +">>> 'Python'.ljust(10)\n" +"'Python '\n" +">>> 'Python'.ljust(10, '.')\n" +"'Python....'\n" +">>> 'Monty Python'.ljust(10, '.')\n" +"'Monty Python'" +msgstr "" + +msgid "See also :meth:`rjust`." +msgstr "" + +msgid "" +"Return a copy of the string with all the cased characters [4]_ converted to " +"lowercase. For example:" +msgstr "" + +msgid "" +">>> 'Lower Method Example'.lower()\n" +"'lower method example'" +msgstr "" + +msgid "" +"The lowercasing algorithm used is `described in section 3.13 'Default Case " +"Folding' of the Unicode Standard `__." +msgstr "" + +msgid "" +"Return a copy of the string with leading characters removed. The *chars* " +"argument is a string specifying the set of characters to be removed. If " +"omitted or ``None``, the *chars* argument defaults to removing whitespace. " +"The *chars* argument is not a prefix; rather, all combinations of its values " +"are stripped::" +msgstr "" + +msgid "" +">>> ' spacious '.lstrip()\n" +"'spacious '\n" +">>> 'www.example.com'.lstrip('cmowz.')\n" +"'example.com'" +msgstr "" +">>> ' spacious '.lstrip()\n" +"'spacious '\n" +">>> 'www.example.com'.lstrip('cmowz.')\n" +"'example.com'" + +msgid "" +"See :meth:`str.removeprefix` for a method that will remove a single prefix " +"string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> 'Arthur: three!'.lstrip('Arthur: ')\n" +"'ee!'\n" +">>> 'Arthur: three!'.removeprefix('Arthur: ')\n" +"'three!'" +msgstr "" +">>> 'Arthur: three!'.lstrip('Arthur: ')\n" +"'ee!'\n" +">>> 'Arthur: three!'.removeprefix('Arthur: ')\n" +"'three!'" + +msgid "" +"This static method returns a translation table usable " +"for :meth:`str.translate`." +msgstr "" + +msgid "" +"If there is only one argument, it must be a dictionary mapping Unicode " +"ordinals (integers) or characters (strings of length 1) to Unicode ordinals, " +"strings (of arbitrary lengths) or ``None``. Character keys will then be " +"converted to ordinals." +msgstr "" + +msgid "" +"If there are two arguments, they must be strings of equal length, and in the " +"resulting dictionary, each character in *from* will be mapped to the " +"character at the same position in *to*. If there is a third argument, it " +"must be a string, whose characters will be mapped to ``None`` in the result." +msgstr "" + +msgid "" +"Split the string at the first occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself, and the part " +"after the separator. If the separator is not found, return a 3-tuple " +"containing the string itself, followed by two empty strings." +msgstr "" + +msgid "" +">>> 'Monty Python'.partition(' ')\n" +"('Monty', ' ', 'Python')\n" +">>> \"Monty Python's Flying Circus\".partition(' ')\n" +"('Monty', ' ', \"Python's Flying Circus\")\n" +">>> 'Monty Python'.partition('-')\n" +"('Monty Python', '', '')" +msgstr "" + +msgid "See also :meth:`rpartition`." +msgstr "" + +msgid "" +"If the string starts with the *prefix* string, return " +"``string[len(prefix):]``. Otherwise, return a copy of the original string:" +msgstr "" + +msgid "" +">>> 'TestHook'.removeprefix('Test')\n" +"'Hook'\n" +">>> 'BaseTestCase'.removeprefix('Test')\n" +"'BaseTestCase'" +msgstr "" +">>> 'TestHook'.removeprefix('Test')\n" +"'Hook'\n" +">>> 'BaseTestCase'.removeprefix('Test')\n" +"'BaseTestCase'" + +msgid "See also :meth:`removesuffix` and :meth:`startswith`." +msgstr "" + +msgid "" +"If the string ends with the *suffix* string and that *suffix* is not empty, " +"return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " +"string:" +msgstr "" + +msgid "" +">>> 'MiscTests'.removesuffix('Tests')\n" +"'Misc'\n" +">>> 'TmpDirMixin'.removesuffix('Tests')\n" +"'TmpDirMixin'" +msgstr "" +">>> 'MiscTests'.removesuffix('Tests')\n" +"'Misc'\n" +">>> 'TmpDirMixin'.removesuffix('Tests')\n" +"'TmpDirMixin'" + +msgid "See also :meth:`removeprefix` and :meth:`endswith`." +msgstr "" + +msgid "" +"Return a copy of the string with all occurrences of substring *old* replaced " +"by *new*. If *count* is given, only the first *count* occurrences are " +"replaced. If *count* is not specified or ``-1``, then all occurrences are " +"replaced. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.replace('spam', 'eggs')\n" +"'eggs, eggs, eggs'\n" +">>> 'spam, spam, spam'.replace('spam', 'eggs', 1)\n" +"'eggs, spam, spam'" +msgstr "" + +msgid "*count* is now supported as a keyword argument." +msgstr "" + +msgid "" +"Return the highest index in the string where substring *sub* is found, such " +"that *sub* is contained within ``s[start:end]``. Optional arguments *start* " +"and *end* are interpreted as in slice notation. Return ``-1`` on failure. " +"For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.rfind('sp')\n" +"12\n" +">>> 'spam, spam, spam'.rfind('sp', 0, 10)\n" +"6" +msgstr "" + +msgid "See also :meth:`find` and :meth:`rindex`." +msgstr "" + +msgid "" +"Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " +"not found. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.rindex('spam')\n" +"12\n" +">>> 'spam, spam, spam'.rindex('eggs')\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +" 'spam, spam, spam'.rindex('eggs')\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^\n" +"ValueError: substring not found" +msgstr "" + +msgid "See also :meth:`index` and :meth:`find`." +msgstr "" + +msgid "" +"Return the string right justified in a string of length *width*. Padding is " +"done using the specified *fillchar* (default is an ASCII space). The " +"original string is returned if *width* is less than or equal to ``len(s)``." +msgstr "" + +msgid "" +">>> 'Python'.rjust(10)\n" +"' Python'\n" +">>> 'Python'.rjust(10, '.')\n" +"'....Python'\n" +">>> 'Monty Python'.rjust(10, '.')\n" +"'Monty Python'" +msgstr "" + +msgid "See also :meth:`ljust` and :meth:`zfill`." +msgstr "" + +msgid "" +"Split the string at the last occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself, and the part " +"after the separator. If the separator is not found, return a 3-tuple " +"containing two empty strings, followed by the string itself." +msgstr "" + +msgid "" +">>> 'Monty Python'.rpartition(' ')\n" +"('Monty', ' ', 'Python')\n" +">>> \"Monty Python's Flying Circus\".rpartition(' ')\n" +"(\"Monty Python's Flying\", ' ', 'Circus')\n" +">>> 'Monty Python'.rpartition('-')\n" +"('', '', 'Monty Python')" +msgstr "" + +msgid "See also :meth:`partition`." +msgstr "" + +msgid "" +"Return a list of the words in the string, using *sep* as the delimiter " +"string. If *maxsplit* is given, at most *maxsplit* splits are done, the " +"*rightmost* ones. If *sep* is not specified or ``None``, " +"any :meth:`whitespace ` string is a separator. Except for " +"splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " +"described in detail below." +msgstr "" + +msgid "" +"Return a copy of the string with trailing characters removed. The *chars* " +"argument is a string specifying the set of characters to be removed. If " +"omitted or ``None``, the *chars* argument defaults to removing whitespace. " +"The *chars* argument is not a suffix; rather, all combinations of its values " +"are stripped. For example:" +msgstr "" + +msgid "" +">>> ' spacious '.rstrip()\n" +"' spacious'\n" +">>> 'mississippi'.rstrip('ipz')\n" +"'mississ'" +msgstr "" +">>> ' spacious '.rstrip()\n" +"' spacious'\n" +">>> 'mississippi'.rstrip('ipz')\n" +"'mississ'" + +msgid "" +"See :meth:`removesuffix` for a method that will remove a single suffix " +"string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> 'Monty Python'.rstrip(' Python')\n" +"'M'\n" +">>> 'Monty Python'.removesuffix(' Python')\n" +"'Monty'" +msgstr "" +">>> 'Monty Python'.rstrip(' Python')\n" +"'M'\n" +">>> 'Monty Python'.removesuffix(' Python')\n" +"'Monty'" + +msgid "See also :meth:`strip`." +msgstr "" + +msgid "" +"Return a list of the words in the string, using *sep* as the delimiter " +"string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " +"the list will have at most ``maxsplit+1`` elements). If *maxsplit* is not " +"specified or ``-1``, then there is no limit on the number of splits (all " +"possible splits are made)." +msgstr "" + +msgid "" +"If *sep* is given, consecutive delimiters are not grouped together and are " +"deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " +"``['1', '', '2']``). The *sep* argument may consist of multiple characters " +"as a single delimiter (to split with multiple delimiters, " +"use :func:`re.split`). Splitting an empty string with a specified separator " +"returns ``['']``." +msgstr "" + +msgid "" +">>> '1,2,3'.split(',')\n" +"['1', '2', '3']\n" +">>> '1,2,3'.split(',', maxsplit=1)\n" +"['1', '2,3']\n" +">>> '1,2,,3,'.split(',')\n" +"['1', '2', '', '3', '']\n" +">>> '1<>2<>3<4'.split('<>')\n" +"['1', '2', '3<4']" +msgstr "" + +msgid "" +"If *sep* is not specified or is ``None``, a different splitting algorithm is " +"applied: runs of consecutive :meth:`whitespace ` are regarded " +"as a single separator, and the result will contain no empty strings at the " +"start or end if the string has leading or trailing whitespace. " +"Consequently, splitting an empty string or a string consisting of just " +"whitespace with a ``None`` separator returns ``[]``." +msgstr "" + +msgid "" +">>> '1 2 3'.split()\n" +"['1', '2', '3']\n" +">>> '1 2 3'.split(maxsplit=1)\n" +"['1', '2 3']\n" +">>> ' 1 2 3 '.split()\n" +"['1', '2', '3']" +msgstr "" + +msgid "" +"If *sep* is not specified or is ``None`` and *maxsplit* is ``0``, only " +"leading runs of consecutive whitespace are considered." +msgstr "" + +msgid "" +">>> \"\".split(None, 0)\n" +"[]\n" +">>> \" \".split(None, 0)\n" +"[]\n" +">>> \" foo \".split(maxsplit=0)\n" +"['foo ']" +msgstr "" + +msgid "See also :meth:`join` and :meth:`rsplit`." +msgstr "" + +msgid "" +"Return a list of the lines in the string, breaking at line boundaries. Line " +"breaks are not included in the resulting list unless *keepends* is given and " +"true." +msgstr "" + +msgid "" +"This method splits on the following line boundaries. In particular, the " +"boundaries are a superset of :term:`universal newlines`." +msgstr "" + +msgid "Representation" +msgstr "" + +msgid "Description" +msgstr "Opis" + +msgid "``\\n``" +msgstr "``\\n``" + +msgid "Line Feed" +msgstr "" + +msgid "``\\r``" +msgstr "``\\r``" + +msgid "Carriage Return" +msgstr "" + +msgid "``\\r\\n``" +msgstr "``\\r\\n``" + +msgid "Carriage Return + Line Feed" +msgstr "" + +msgid "``\\v`` or ``\\x0b``" +msgstr "" + +msgid "Line Tabulation" +msgstr "" + +msgid "``\\f`` or ``\\x0c``" +msgstr "" + +msgid "Form Feed" +msgstr "" + +msgid "``\\x1c``" +msgstr "``\\x1c``" + +msgid "File Separator" +msgstr "" + +msgid "``\\x1d``" +msgstr "``\\x1d``" + +msgid "Group Separator" +msgstr "" + +msgid "``\\x1e``" +msgstr "``\\x1e``" + +msgid "Record Separator" +msgstr "" + +msgid "``\\x85``" +msgstr "``\\x85``" + +msgid "Next Line (C1 Control Code)" +msgstr "" + +msgid "``\\u2028``" +msgstr "``\\u2028``" + +msgid "Line Separator" +msgstr "" + +msgid "``\\u2029``" +msgstr "``\\u2029``" + +msgid "Paragraph Separator" +msgstr "" + +msgid "``\\v`` and ``\\f`` added to list of line boundaries." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "" +">>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" +"['ab c', '', 'de fg', 'kl']\n" +">>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines(keepends=True)\n" +"['ab c\\n', '\\n', 'de fg\\r', 'kl\\r\\n']" +msgstr "" + +msgid "" +"Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " +"method returns an empty list for the empty string, and a terminal line break " +"does not result in an extra line::" +msgstr "" + +msgid "" +">>> \"\".splitlines()\n" +"[]\n" +">>> \"One line\\n\".splitlines()\n" +"['One line']" +msgstr "" +">>> \"\".splitlines()\n" +"[]\n" +">>> \"One line\\n\".splitlines()\n" +"['One line']" + +msgid "For comparison, ``split('\\n')`` gives::" +msgstr "" + +msgid "" +">>> ''.split('\\n')\n" +"['']\n" +">>> 'Two lines\\n'.split('\\n')\n" +"['Two lines', '']" +msgstr "" +">>> ''.split('\\n')\n" +"['']\n" +">>> 'Two lines\\n'.split('\\n')\n" +"['Two lines', '']" + +msgid "" +"Return ``True`` if string starts with the *prefix*, otherwise return " +"``False``. *prefix* can also be a tuple of prefixes to look for. With " +"optional *start*, test string beginning at that position. With optional " +"*end*, stop comparing string at that position." +msgstr "" + +msgid "" +">>> 'Python'.startswith('Py')\n" +"True\n" +">>> 'a tuple of prefixes'.startswith(('at', 'a'))\n" +"True\n" +">>> 'Python is amazing'.startswith('is', 7)\n" +"True" +msgstr "" + +msgid "See also :meth:`endswith` and :meth:`removeprefix`." +msgstr "" + +msgid "" +"Return a copy of the string with the leading and trailing characters " +"removed. The *chars* argument is a string specifying the set of characters " +"to be removed. If omitted or ``None``, the *chars* argument defaults to " +"removing whitespace. The *chars* argument is not a prefix or suffix; rather, " +"all combinations of its values are stripped." +msgstr "" + +msgid "Whitespace characters are defined by :meth:`str.isspace`." +msgstr "" + +msgid "" +">>> ' spacious '.strip()\n" +"'spacious'\n" +">>> 'www.example.com'.strip('cmowz.')\n" +"'example'" +msgstr "" +">>> ' spacious '.strip()\n" +"'spacious'\n" +">>> 'www.example.com'.strip('cmowz.')\n" +"'example'" + +msgid "" +"The outermost leading and trailing *chars* argument values are stripped from " +"the string. Characters are removed from the leading end until reaching a " +"string character that is not contained in the set of characters in *chars*. " +"A similar action takes place on the trailing end." +msgstr "" + +msgid "" +">>> comment_string = '#....... Section 3.2.1 Issue #32 .......'\n" +">>> comment_string.strip('.#! ')\n" +"'Section 3.2.1 Issue #32'" +msgstr "" + +msgid "See also :meth:`rstrip`." +msgstr "" + +msgid "" +"Return a copy of the string with uppercase characters converted to lowercase " +"and vice versa. For example:" +msgstr "" + +msgid "" +">>> 'Hello World'.swapcase()\n" +"'hELLO wORLD'" +msgstr "" + +msgid "" +"Note that it is not necessarily true that ``s.swapcase().swapcase() == s``. " +"For example:" +msgstr "" + +msgid "" +">>> 'straße'.swapcase().swapcase()\n" +"'strasse'" +msgstr "" + +msgid "See also :meth:`str.lower` and :meth:`str.upper`." +msgstr "" + +msgid "" +"Return a titlecased version of the string where words start with an " +"uppercase character and the remaining characters are lowercase." +msgstr "" + +msgid "" +">>> 'Hello world'.title()\n" +"'Hello World'" +msgstr "" +">>> 'Hello world'.title()\n" +"'Hello World'" + +msgid "" +"The algorithm uses a simple language-independent definition of a word as " +"groups of consecutive letters. The definition works in many contexts but it " +"means that apostrophes in contractions and possessives form word boundaries, " +"which may not be the desired result::" +msgstr "" + +msgid "" +">>> \"they're bill's friends from the UK\".title()\n" +"\"They'Re Bill'S Friends From The Uk\"" +msgstr "" +">>> \"they're bill's friends from the UK\".title()\n" +"\"They'Re Bill'S Friends From The Uk\"" + +msgid "" +"The :func:`string.capwords` function does not have this problem, as it " +"splits words on spaces only." +msgstr "" + +msgid "" +"Alternatively, a workaround for apostrophes can be constructed using regular " +"expressions::" +msgstr "" + +msgid "" +">>> import re\n" +">>> def titlecase(s):\n" +"... return re.sub(r\"[A-Za-z]+('[A-Za-z]+)?\",\n" +"... lambda mo: mo.group(0).capitalize(),\n" +"... s)\n" +"...\n" +">>> titlecase(\"they're bill's friends.\")\n" +"\"They're Bill's Friends.\"" +msgstr "" + +msgid "See also :meth:`istitle`." +msgstr "" + +msgid "" +"Return a copy of the string in which each character has been mapped through " +"the given translation table. The table must be an object that implements " +"indexing via :meth:`~object.__getitem__`, typically a :term:`mapping` " +"or :term:`sequence`. When indexed by a Unicode ordinal (an integer), the " +"table object can do any of the following: return a Unicode ordinal or a " +"string, to map the character to one or more other characters; return " +"``None``, to delete the character from the return string; or raise " +"a :exc:`LookupError` exception, to map the character to itself." +msgstr "" + +msgid "" +"You can use :meth:`str.maketrans` to create a translation map from character-" +"to-character mappings in different formats." +msgstr "" + +msgid "" +"See also the :mod:`codecs` module for a more flexible approach to custom " +"character mappings." +msgstr "" + +msgid "" +"Return a copy of the string with all the cased characters [4]_ converted to " +"uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " +"contains uncased characters or if the Unicode category of the resulting " +"character(s) is not \"Lu\" (Letter, uppercase), but e.g. \"Lt\" (Letter, " +"titlecase)." +msgstr "" + +msgid "" +"The uppercasing algorithm used is `described in section 3.13 'Default Case " +"Folding' of the Unicode Standard `__." +msgstr "" + +msgid "" +"Return a copy of the string left filled with ASCII ``'0'`` digits to make a " +"string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " +"by inserting the padding *after* the sign character rather than before. The " +"original string is returned if *width* is less than or equal to ``len(s)``." +msgstr "" + +msgid "" +">>> \"42\".zfill(5)\n" +"'00042'\n" +">>> \"-42\".zfill(5)\n" +"'-0042'" +msgstr "" +">>> \"42\".zfill(5)\n" +"'00042'\n" +">>> \"-42\".zfill(5)\n" +"'-0042'" + +msgid "Formatted String Literals (f-strings)" +msgstr "" + +msgid "" +"The :keyword:`await` and :keyword:`async for` can be used in expressions " +"within f-strings." +msgstr "" + +msgid "Added the debug specifier (``=``)" +msgstr "" + +msgid "" +"Many restrictions on expressions within f-strings have been removed. " +"Notably, nested strings, comments, and backslashes are now permitted." +msgstr "" + +msgid "" +"An :dfn:`f-string` (formally a :dfn:`formatted string literal`) is a string " +"literal that is prefixed with ``f`` or ``F``. This type of string literal " +"allows embedding the results of arbitrary Python expressions within " +"*replacement fields*, which are delimited by curly brackets (``{}``). Each " +"replacement field must contain an expression, optionally followed by:" +msgstr "" + +msgid "a *debug specifier* -- an equal sign (``=``);" +msgstr "" + +msgid "a *conversion specifier* -- ``!s``, ``!r`` or ``!a``; and/or" +msgstr "" + +msgid "a *format specifier* prefixed with a colon (``:``)." +msgstr "" + +msgid "" +"See the :ref:`Lexical Analysis section on f-strings ` for details " +"on the syntax of these fields." +msgstr "" + +msgid "Debug specifier" +msgstr "" + +msgid "" +"If a debug specifier -- an equal sign (``=``) -- appears after the " +"replacement field expression, the resulting f-string will contain the " +"expression's source, the equal sign, and the value of the expression. This " +"is often useful for debugging::" +msgstr "" + +msgid "" +">>> number = 14.3\n" +">>> f'{number=}'\n" +"'number=14.3'" +msgstr "" + +msgid "" +"Whitespace before, inside and after the expression, as well as whitespace " +"after the equal sign, is significant --- it is retained in the result::" +msgstr "" + +msgid "" +">>> f'{ number - 4 = }'\n" +"' number - 4 = 10.3'" +msgstr "" + +msgid "Conversion specifier" +msgstr "" + +msgid "" +"By default, the value of a replacement field expression is converted to a " +"string using :func:`str`::" +msgstr "" + +msgid "" +">>> from fractions import Fraction\n" +">>> one_third = Fraction(1, 3)\n" +">>> f'{one_third}'\n" +"'1/3'" +msgstr "" + +msgid "" +"When a debug specifier but no format specifier is used, the default " +"conversion instead uses :func:`repr`::" +msgstr "" + +msgid "" +">>> f'{one_third = }'\n" +"'one_third = Fraction(1, 3)'" +msgstr "" + +msgid "" +"The conversion can be specified explicitly using one of these specifiers:" +msgstr "" + +msgid "``!s`` for :func:`str`" +msgstr "" + +msgid "``!r`` for :func:`repr`" +msgstr "" + +msgid "``!a`` for :func:`ascii`" +msgstr "" + +msgid "" +">>> str(one_third)\n" +"'1/3'\n" +">>> repr(one_third)\n" +"'Fraction(1, 3)'\n" +"\n" +">>> f'{one_third!s} is {one_third!r}'\n" +"'1/3 is Fraction(1, 3)'\n" +"\n" +">>> string = \"¡kočka 😸!\"\n" +">>> ascii(string)\n" +"\"'\\\\xa1ko\\\\u010dka \\\\U0001f638!'\"\n" +"\n" +">>> f'{string = !a}'\n" +"\"string = '\\\\xa1ko\\\\u010dka \\\\U0001f638!'\"" +msgstr "" + +msgid "Format specifier" +msgstr "" + +msgid "" +"After the expression has been evaluated, and possibly converted using an " +"explicit conversion specifier, it is formatted using the :func:`format` " +"function. If the replacement field includes a *format specifier* introduced " +"by a colon (``:``), the specifier is passed to :func:`!format` as the second " +"argument. The result of :func:`!format` is then used as the final value for " +"the replacement field. For example::" +msgstr "" + +msgid "" +">>> from fractions import Fraction\n" +">>> one_third = Fraction(1, 3)\n" +">>> f'{one_third:.6f}'\n" +"'0.333333'\n" +">>> f'{one_third:_^+10}'\n" +"'___+1/3___'\n" +">>> f'{one_third!r:_^20}'\n" +"'___Fraction(1, 3)___'\n" +">>> f'{one_third = :~>10}~'\n" +"'one_third = ~~~~~~~1/3~'" +msgstr "" + +msgid "Template String Literals (t-strings)" +msgstr "" + +msgid "" +"A :dfn:`t-string` (formally a :dfn:`template string literal`) is a string " +"literal that is prefixed with ``t`` or ``T``." +msgstr "" + +msgid "" +"These strings follow the same syntax and evaluation rules as :ref:`formatted " +"string literals `, with the following differences:" +msgstr "" + +msgid "" +"Rather than evaluating to a ``str`` object, template string literals " +"evaluate to a :class:`string.templatelib.Template` object." +msgstr "" + +msgid "" +"The :func:`format` protocol is not used. Instead, the format specifier and " +"conversions (if any) are passed to a " +"new :class:`~string.templatelib.Interpolation` object that is created for " +"each evaluated expression. It is up to code that processes the " +"resulting :class:`~string.templatelib.Template` object to decide how to " +"handle format specifiers and conversions." +msgstr "" + +msgid "" +"Format specifiers containing nested replacement fields are evaluated " +"eagerly, prior to being passed to " +"the :class:`~string.templatelib.Interpolation` object. For instance, an " +"interpolation of the form ``{amount:.{precision}f}`` will evaluate the inner " +"expression ``{precision}`` to determine the value of the ``format_spec`` " +"attribute. If ``precision`` were to be ``2``, the resulting format specifier " +"would be ``'.2f'``." +msgstr "" + +msgid "" +"When the equals sign ``'='`` is provided in an interpolation expression, the " +"text of the expression is appended to the literal string that precedes the " +"relevant interpolation. This includes the equals sign and any surrounding " +"whitespace. The :class:`!Interpolation` instance for the expression will be " +"created as normal, except " +"that :attr:`~string.templatelib.Interpolation.conversion` will be set to " +"'``r``' (:func:`repr`) by default. If an explicit conversion or format " +"specifier is provided, this will override the default behaviour." +msgstr "" + +msgid "``printf``-style String Formatting" +msgstr "" + +msgid "" +"The formatting operations described here exhibit a variety of quirks that " +"lead to a number of common errors (such as failing to display tuples and " +"dictionaries correctly)." +msgstr "" + +msgid "" +"Using :ref:`formatted string literals `, the :meth:`str.format` " +"interface, or :class:`string.Template` may help avoid these errors. Each of " +"these alternatives provides their own trade-offs and benefits of simplicity, " +"flexibility, and/or extensibility." +msgstr "" + +msgid "" +"String objects have one unique built-in operation: the ``%`` operator " +"(modulo). This is also known as the string *formatting* or *interpolation* " +"operator. Given ``format % values`` (where *format* is a string), ``%`` " +"conversion specifications in *format* are replaced with zero or more " +"elements of *values*. The effect is similar to using the :c:func:`sprintf` " +"function in the C language. For example:" +msgstr "" + +msgid "" +">>> print('%s has %d quote types.' % ('Python', 2))\n" +"Python has 2 quote types." +msgstr "" + +msgid "" +"If *format* requires a single argument, *values* may be a single non-tuple " +"object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " +"items specified by the format string, or a single mapping object (for " +"example, a dictionary)." +msgstr "" + +msgid "" +"A conversion specifier contains two or more characters and has the following " +"components, which must occur in this order:" +msgstr "" + +msgid "The ``'%'`` character, which marks the start of the specifier." +msgstr "" + +msgid "" +"Mapping key (optional), consisting of a parenthesised sequence of characters " +"(for example, ``(somename)``)." +msgstr "" + +msgid "" +"Conversion flags (optional), which affect the result of some conversion " +"types." +msgstr "" + +msgid "" +"Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " +"actual width is read from the next element of the tuple in *values*, and the " +"object to convert comes after the minimum field width and optional precision." +msgstr "" + +msgid "" +"Precision (optional), given as a ``'.'`` (dot) followed by the precision. " +"If specified as ``'*'`` (an asterisk), the actual precision is read from the " +"next element of the tuple in *values*, and the value to convert comes after " +"the precision." +msgstr "" + +msgid "Length modifier (optional)." +msgstr "" + +msgid "Conversion type." +msgstr "" + +msgid "" +"When the right argument is a dictionary (or other mapping type), then the " +"formats in the string *must* include a parenthesised mapping key into that " +"dictionary inserted immediately after the ``'%'`` character. The mapping key " +"selects the value to be formatted from the mapping. For example:" +msgstr "" + +msgid "" +"In this case no ``*`` specifiers may occur in a format (since they require a " +"sequential parameter list)." +msgstr "" + +msgid "The conversion flag characters are:" +msgstr "" + +msgid "Flag" +msgstr "" + +msgid "``'#'``" +msgstr "``'#'``" + +msgid "" +"The value conversion will use the \"alternate form\" (where defined below)." +msgstr "" + +msgid "``'0'``" +msgstr "``'0'``" + +msgid "The conversion will be zero padded for numeric values." +msgstr "" + +msgid "``'-'``" +msgstr "``'-'``" + +msgid "" +"The converted value is left adjusted (overrides the ``'0'`` conversion if " +"both are given)." +msgstr "" + +msgid "``' '``" +msgstr "``' '``" + +msgid "" +"(a space) A blank should be left before a positive number (or empty string) " +"produced by a signed conversion." +msgstr "" + +msgid "``'+'``" +msgstr "``'+'``" + +msgid "" +"A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " +"a \"space\" flag)." +msgstr "" + +msgid "" +"A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " +"it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." +msgstr "" + +msgid "The conversion types are:" +msgstr "" + +msgid "Conversion" +msgstr "" + +msgid "``'d'``" +msgstr "``'d'``" + +msgid "Signed integer decimal." +msgstr "" + +msgid "``'i'``" +msgstr "``'i'``" + +msgid "``'o'``" +msgstr "``'o'``" + +msgid "Signed octal value." +msgstr "" + +msgid "``'u'``" +msgstr "``'u'``" + +msgid "Obsolete type -- it is identical to ``'d'``." +msgstr "" + +msgid "``'x'``" +msgstr "``'x'``" + +msgid "Signed hexadecimal (lowercase)." +msgstr "" + +msgid "``'X'``" +msgstr "``'X'``" + +msgid "Signed hexadecimal (uppercase)." +msgstr "" + +msgid "``'e'``" +msgstr "``'e'``" + +msgid "Floating-point exponential format (lowercase)." +msgstr "" + +msgid "``'E'``" +msgstr "``'E'``" + +msgid "Floating-point exponential format (uppercase)." +msgstr "" + +msgid "``'f'``" +msgstr "``'f'``" + +msgid "Floating-point decimal format." +msgstr "" + +msgid "``'F'``" +msgstr "``'F'``" + +msgid "``'g'``" +msgstr "``'g'``" + +msgid "" +"Floating-point format. Uses lowercase exponential format if exponent is less " +"than -4 or not less than precision, decimal format otherwise." +msgstr "" + +msgid "``'G'``" +msgstr "``'G'``" + +msgid "" +"Floating-point format. Uses uppercase exponential format if exponent is less " +"than -4 or not less than precision, decimal format otherwise." +msgstr "" + +msgid "``'c'``" +msgstr "``'c'``" + +msgid "Single character (accepts integer or single character string)." +msgstr "" + +msgid "``'r'``" +msgstr "``'r'``" + +msgid "String (converts any Python object using :func:`repr`)." +msgstr "" + +msgid "``'s'``" +msgstr "``'s'``" + +msgid "String (converts any Python object using :func:`str`)." +msgstr "" + +msgid "``'a'``" +msgstr "``'a'``" + +msgid "String (converts any Python object using :func:`ascii`)." +msgstr "" + +msgid "``'%'``" +msgstr "``'%'``" + +msgid "No argument is converted, results in a ``'%'`` character in the result." +msgstr "" + +msgid "" +"For floating-point formats, the result should be correctly rounded to a " +"given precision ``p`` of digits after the decimal point. The rounding mode " +"matches that of the :func:`round` builtin." +msgstr "" + +msgid "" +"The alternate form causes a leading octal specifier (``'0o'``) to be " +"inserted before the first digit." +msgstr "" + +msgid "" +"The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " +"whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " +"first digit." +msgstr "" + +msgid "" +"The alternate form causes the result to always contain a decimal point, even " +"if no digits follow it." +msgstr "" + +msgid "" +"The precision determines the number of digits after the decimal point and " +"defaults to 6." +msgstr "" + +msgid "" +"The alternate form causes the result to always contain a decimal point, and " +"trailing zeroes are not removed as they would otherwise be." +msgstr "" + +msgid "" +"The precision determines the number of significant digits before and after " +"the decimal point and defaults to 6." +msgstr "" + +msgid "If precision is ``N``, the output is truncated to ``N`` characters." +msgstr "" + +msgid "See :pep:`237`." +msgstr "Zob. :pep:`237`." + +msgid "" +"Since Python strings have an explicit length, ``%s`` conversions do not " +"assume that ``'\\0'`` is the end of the string." +msgstr "" + +msgid "" +"``%f`` conversions for numbers whose absolute value is over 1e50 are no " +"longer replaced by ``%g`` conversions." +msgstr "" + +msgid "" +"Binary Sequence Types " +"--- :class:`bytes`, :class:`bytearray`, :class:`memoryview`" +msgstr "" + +msgid "" +"The core built-in types for manipulating binary data are :class:`bytes` " +"and :class:`bytearray`. They are supported by :class:`memoryview` which uses " +"the :ref:`buffer protocol ` to access the memory of other " +"binary objects without needing to make a copy." +msgstr "" + +msgid "" +"The :mod:`array` module supports efficient storage of basic data types like " +"32-bit integers and IEEE754 double-precision floating values." +msgstr "" + +msgid "Bytes Objects" +msgstr "" + +msgid "" +"Bytes objects are immutable sequences of single bytes. Since many major " +"binary protocols are based on the ASCII text encoding, bytes objects offer " +"several methods that are only valid when working with ASCII compatible data " +"and are closely related to string objects in a variety of other ways." +msgstr "" + +msgid "" +"Firstly, the syntax for bytes literals is largely the same as that for " +"string literals, except that a ``b`` prefix is added:" +msgstr "" + +msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" +msgstr "" + +msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``" +msgstr "" + +msgid "" +"Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" +msgstr "" + +msgid "" +"Only ASCII characters are permitted in bytes literals (regardless of the " +"declared source code encoding). Any binary values over 127 must be entered " +"into bytes literals using the appropriate escape sequence." +msgstr "" + +msgid "" +"As with string literals, bytes literals may also use a ``r`` prefix to " +"disable processing of escape sequences. See :ref:`strings` for more about " +"the various forms of bytes literal, including supported escape sequences." +msgstr "" + +msgid "" +"While bytes literals and representations are based on ASCII text, bytes " +"objects actually behave like immutable sequences of integers, with each " +"value in the sequence restricted such that ``0 <= x < 256`` (attempts to " +"violate this restriction will trigger :exc:`ValueError`). This is done " +"deliberately to emphasise that while many binary formats include ASCII based " +"elements and can be usefully manipulated with some text-oriented algorithms, " +"this is not generally the case for arbitrary binary data (blindly applying " +"text processing algorithms to binary data formats that are not ASCII " +"compatible will usually lead to data corruption)." +msgstr "" + +msgid "" +"In addition to the literal forms, bytes objects can be created in a number " +"of other ways:" +msgstr "" + +msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" +msgstr "" + +msgid "From an iterable of integers: ``bytes(range(20))``" +msgstr "" + +msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" +msgstr "" + +msgid "Also see the :ref:`bytes ` built-in." +msgstr "" + +msgid "" +"Since 2 hexadecimal digits correspond precisely to a single byte, " +"hexadecimal numbers are a commonly used format for describing binary data. " +"Accordingly, the bytes type has an additional class method to read data in " +"that format:" +msgstr "" + +msgid "" +"This :class:`bytes` class method returns a bytes object, decoding the given " +"string object. The string must contain two hexadecimal digits per byte, " +"with ASCII whitespace being ignored." +msgstr "" + +msgid "" +":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " +"spaces." +msgstr "" + +msgid "" +":meth:`bytes.fromhex` now accepts ASCII :class:`bytes` and :term:`bytes-like " +"objects ` as input." +msgstr "" + +msgid "" +"A reverse conversion function exists to transform a bytes object into its " +"hexadecimal representation." +msgstr "" + +msgid "" +"Return a string object containing two hexadecimal digits for each byte in " +"the instance." +msgstr "" + +msgid "" +"If you want to make the hex string easier to read, you can specify a single " +"character separator *sep* parameter to include in the output. By default, " +"this separator will be included between each byte. A second optional " +"*bytes_per_sep* parameter controls the spacing. Positive values calculate " +"the separator position from the right, negative values from the left." +msgstr "" + +msgid "" +":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " +"to insert separators between bytes in the hex output." +msgstr "" + +msgid "" +"Since bytes objects are sequences of integers (akin to a tuple), for a bytes " +"object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " +"object of length 1. (This contrasts with text strings, where both indexing " +"and slicing will produce a string of length 1)" +msgstr "" + +msgid "" +"The representation of bytes objects uses the literal format (``b'...'``) " +"since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " +"always convert a bytes object into a list of integers using ``list(b)``." +msgstr "" + +msgid "Bytearray Objects" +msgstr "" + +msgid "" +":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " +"objects." +msgstr "" + +msgid "" +"There is no dedicated literal syntax for bytearray objects, instead they are " +"always created by calling the constructor:" +msgstr "" + +msgid "Creating an empty instance: ``bytearray()``" +msgstr "" + +msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" +msgstr "" + +msgid "From an iterable of integers: ``bytearray(range(20))``" +msgstr "" + +msgid "" +"Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" +msgstr "" + +msgid "" +"As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " +"operations described in :ref:`bytes-methods`." +msgstr "" + +msgid "Also see the :ref:`bytearray ` built-in." +msgstr "" + +msgid "" +"Since 2 hexadecimal digits correspond precisely to a single byte, " +"hexadecimal numbers are a commonly used format for describing binary data. " +"Accordingly, the bytearray type has an additional class method to read data " +"in that format:" +msgstr "" + +msgid "" +"This :class:`bytearray` class method returns a bytearray object, decoding " +"the given string object. The string must contain two hexadecimal digits per " +"byte, with ASCII whitespace being ignored." +msgstr "" + +msgid "" +":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " +"just spaces." +msgstr "" + +msgid "" +":meth:`bytearray.fromhex` now accepts ASCII :class:`bytes` and :term:`bytes-" +"like objects ` as input." +msgstr "" + +msgid "" +"A reverse conversion function exists to transform a bytearray object into " +"its hexadecimal representation." +msgstr "" + +msgid "" +"Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " +"*sep* and *bytes_per_sep* parameters to insert separators between bytes in " +"the hex output." +msgstr "" + +msgid "" +"Resize the :class:`bytearray` to contain *size* bytes. *size* must be " +"greater than or equal to 0." +msgstr "" + +msgid "" +"If the :class:`bytearray` needs to shrink, bytes beyond *size* are truncated." +msgstr "" + +msgid "" +"If the :class:`bytearray` needs to grow, all new bytes, those beyond *size*, " +"will be set to null bytes." +msgstr "" + +msgid "This is equivalent to:" +msgstr "" + +msgid "Examples:" +msgstr "Przykłady:" + +msgid "" +"Since bytearray objects are sequences of integers (akin to a list), for a " +"bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " +"a bytearray object of length 1. (This contrasts with text strings, where " +"both indexing and slicing will produce a string of length 1)" +msgstr "" + +msgid "" +"The representation of bytearray objects uses the bytes literal format " +"(``bytearray(b'...')``) since it is often more useful than e.g. " +"``bytearray([46, 46, 46])``. You can always convert a bytearray object into " +"a list of integers using ``list(b)``." +msgstr "" + +msgid "" +"For detailed information on thread-safety guarantees for :class:`bytearray` " +"objects, see :ref:`thread-safety-bytearray`." +msgstr "" + +msgid "Bytes and Bytearray Operations" +msgstr "" + +msgid "" +"Both bytes and bytearray objects support the :ref:`common ` " +"sequence operations. They interoperate not just with operands of the same " +"type, but with any :term:`bytes-like object`. Due to this flexibility, they " +"can be freely mixed in operations without causing errors. However, the " +"return type of the result may depend on the order of operands." +msgstr "" + +msgid "" +"The methods on bytes and bytearray objects don't accept strings as their " +"arguments, just as the methods on strings don't accept bytes as their " +"arguments. For example, you have to write::" +msgstr "" + +msgid "" +"a = \"abc\"\n" +"b = a.replace(\"a\", \"f\")" +msgstr "" + +msgid "and::" +msgstr "" + +msgid "" +"a = b\"abc\"\n" +"b = a.replace(b\"a\", b\"f\")" +msgstr "" + +msgid "" +"Some bytes and bytearray operations assume the use of ASCII compatible " +"binary formats, and hence should be avoided when working with arbitrary " +"binary data. These restrictions are covered below." +msgstr "" + +msgid "" +"Using these ASCII based operations to manipulate binary data that is not " +"stored in an ASCII based format may lead to data corruption." +msgstr "" + +msgid "" +"The following methods on bytes and bytearray objects can be used with " +"arbitrary binary data." +msgstr "" + +msgid "" +"Return the number of non-overlapping occurrences of subsequence *sub* in the " +"range [*start*, *end*]. Optional arguments *start* and *end* are " +"interpreted as in slice notation." +msgstr "" + +msgid "" +"The subsequence to search for may be any :term:`bytes-like object` or an " +"integer in the range 0 to 255." +msgstr "" + +msgid "" +"If *sub* is empty, returns the number of empty slices between characters " +"which is the length of the bytes object plus one." +msgstr "" + +msgid "Also accept an integer in the range 0 to 255 as the subsequence." +msgstr "" + +msgid "" +"If the binary data starts with the *prefix* string, return " +"``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " +"data::" +msgstr "" + +msgid "" +">>> b'TestHook'.removeprefix(b'Test')\n" +"b'Hook'\n" +">>> b'BaseTestCase'.removeprefix(b'Test')\n" +"b'BaseTestCase'" +msgstr "" +">>> b'TestHook'.removeprefix(b'Test')\n" +"b'Hook'\n" +">>> b'BaseTestCase'.removeprefix(b'Test')\n" +"b'BaseTestCase'" + +msgid "The *prefix* may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"The bytearray version of this method does *not* operate in place - it always " +"produces a new object, even if no changes were made." +msgstr "" + +msgid "" +"If the binary data ends with the *suffix* string and that *suffix* is not " +"empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " +"original binary data::" +msgstr "" + +msgid "" +">>> b'MiscTests'.removesuffix(b'Tests')\n" +"b'Misc'\n" +">>> b'TmpDirMixin'.removesuffix(b'Tests')\n" +"b'TmpDirMixin'" +msgstr "" +">>> b'MiscTests'.removesuffix(b'Tests')\n" +"b'Misc'\n" +">>> b'TmpDirMixin'.removesuffix(b'Tests')\n" +"b'TmpDirMixin'" + +msgid "The *suffix* may be any :term:`bytes-like object`." +msgstr "" + +msgid "Return the bytes decoded to a :class:`str`." +msgstr "" + +msgid "" +"*errors* controls how decoding errors are handled. If ``'strict'`` (the " +"default), a :exc:`UnicodeError` exception is raised. Other possible values " +"are ``'ignore'``, ``'replace'``, and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." +msgstr "" + +msgid "" +"For performance reasons, the value of *errors* is not checked for validity " +"unless a decoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used." +msgstr "" + +msgid "" +"Passing the *encoding* argument to :class:`str` allows decoding " +"any :term:`bytes-like object` directly, without needing to make a " +"temporary :class:`!bytes` or :class:`!bytearray` object." +msgstr "" + +msgid "" +"Return ``True`` if the binary data ends with the specified *suffix*, " +"otherwise return ``False``. *suffix* can also be a tuple of suffixes to " +"look for. With optional *start*, test beginning at that position. With " +"optional *end*, stop comparing at that position." +msgstr "" + +msgid "The suffix(es) to search for may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"Return the lowest index in the data where the subsequence *sub* is found, " +"such that *sub* is contained in the slice ``s[start:end]``. Optional " +"arguments *start* and *end* are interpreted as in slice notation. Return " +"``-1`` if *sub* is not found." +msgstr "" + +msgid "" +"The :meth:`~bytes.find` method should be used only if you need to know the " +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" +msgstr "" + +msgid "" +">>> b'Py' in b'Python'\n" +"True" +msgstr "" +">>> b'Py' in b'Python'\n" +"True" + +msgid "" +"Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " +"is not found." +msgstr "" + +msgid "" +"Return a bytes or bytearray object which is the concatenation of the binary " +"data sequences in *iterable*. A :exc:`TypeError` will be raised if there " +"are any values in *iterable* that are not :term:`bytes-like objects `, including :class:`str` objects. The separator between " +"elements is the contents of the bytes or bytearray object providing this " +"method." +msgstr "" + +msgid "" +"This static method returns a translation table usable " +"for :meth:`bytes.translate` that will map each character in *from* into the " +"character at the same position in *to*; *from* and *to* must both " +"be :term:`bytes-like objects ` and have the same length." +msgstr "" + +msgid "" +"Split the sequence at the first occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself or its " +"bytearray copy, and the part after the separator. If the separator is not " +"found, return a 3-tuple containing a copy of the original sequence, followed " +"by two empty bytes or bytearray objects." +msgstr "" + +msgid "The separator to search for may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"Return a copy of the sequence with all occurrences of subsequence *old* " +"replaced by *new*. If the optional argument *count* is given, only the " +"first *count* occurrences are replaced." +msgstr "" + +msgid "" +"The subsequence to search for and its replacement may be any :term:`bytes-" +"like object`." +msgstr "" + +msgid "" +"Return the highest index in the sequence where the subsequence *sub* is " +"found, such that *sub* is contained within ``s[start:end]``. Optional " +"arguments *start* and *end* are interpreted as in slice notation. Return " +"``-1`` on failure." +msgstr "" + +msgid "" +"Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " +"*sub* is not found." +msgstr "" + +msgid "" +"Split the sequence at the last occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself or its " +"bytearray copy, and the part after the separator. If the separator is not " +"found, return a 3-tuple containing two empty bytes or bytearray objects, " +"followed by a copy of the original sequence." +msgstr "" + +msgid "" +"Return ``True`` if the binary data starts with the specified *prefix*, " +"otherwise return ``False``. *prefix* can also be a tuple of prefixes to " +"look for. With optional *start*, test beginning at that position. With " +"optional *end*, stop comparing at that position." +msgstr "" + +msgid "The prefix(es) to search for may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"Return a copy of the bytes or bytearray object where all bytes occurring in " +"the optional argument *delete* are removed, and the remaining bytes have " +"been mapped through the given translation table, which must be a bytes " +"object of length 256." +msgstr "" + +msgid "" +"You can use the :func:`bytes.maketrans` method to create a translation table." +msgstr "" + +msgid "" +"Set the *table* argument to ``None`` for translations that only delete " +"characters::" +msgstr "" + +msgid "" +">>> b'read this short text'.translate(None, b'aeiou')\n" +"b'rd ths shrt txt'" +msgstr "" +">>> b'read this short text'.translate(None, b'aeiou')\n" +"b'rd ths shrt txt'" + +msgid "*delete* is now supported as a keyword argument." +msgstr "" + +msgid "" +"The following methods on bytes and bytearray objects have default behaviours " +"that assume the use of ASCII compatible binary formats, but can still be " +"used with arbitrary binary data by passing appropriate arguments. Note that " +"all of the bytearray methods in this section do *not* operate in place, and " +"instead produce new objects." +msgstr "" + +msgid "" +"Return a copy of the object centered in a sequence of length *width*. " +"Padding is done using the specified *fillbyte* (default is an ASCII space). " +"For :class:`bytes` objects, the original sequence is returned if *width* is " +"less than or equal to ``len(s)``." +msgstr "" + +msgid "" +"Return a copy of the object left justified in a sequence of length *width*. " +"Padding is done using the specified *fillbyte* (default is an ASCII space). " +"For :class:`bytes` objects, the original sequence is returned if *width* is " +"less than or equal to ``len(s)``." +msgstr "" + +msgid "" +"Return a copy of the sequence with specified leading bytes removed. The " +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a prefix; rather, all combinations of its values are stripped::" +msgstr "" + +msgid "" +">>> b' spacious '.lstrip()\n" +"b'spacious '\n" +">>> b'www.example.com'.lstrip(b'cmowz.')\n" +"b'example.com'" +msgstr "" +">>> b' spacious '.lstrip()\n" +"b'spacious '\n" +">>> b'www.example.com'.lstrip(b'cmowz.')\n" +"b'example.com'" + +msgid "" +"The binary sequence of byte values to remove may be any :term:`bytes-like " +"object`. See :meth:`~bytes.removeprefix` for a method that will remove a " +"single prefix string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> b'Arthur: three!'.lstrip(b'Arthur: ')\n" +"b'ee!'\n" +">>> b'Arthur: three!'.removeprefix(b'Arthur: ')\n" +"b'three!'" +msgstr "" +">>> b'Arthur: three!'.lstrip(b'Arthur: ')\n" +"b'ee!'\n" +">>> b'Arthur: three!'.removeprefix(b'Arthur: ')\n" +"b'three!'" + +msgid "" +"Return a copy of the object right justified in a sequence of length *width*. " +"Padding is done using the specified *fillbyte* (default is an ASCII space). " +"For :class:`bytes` objects, the original sequence is returned if *width* is " +"less than or equal to ``len(s)``." +msgstr "" + +msgid "" +"Split the binary sequence into subsequences of the same type, using *sep* as " +"the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " +"done, the *rightmost* ones. If *sep* is not specified or ``None``, any " +"subsequence consisting solely of :meth:`ASCII whitespace ` is " +"a separator. Except for splitting from the right, :meth:`rsplit` behaves " +"like :meth:`split` which is described in detail below." +msgstr "" + +msgid "" +"Return a copy of the sequence with specified trailing bytes removed. The " +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a suffix; rather, all combinations of its values are stripped::" +msgstr "" + +msgid "" +">>> b' spacious '.rstrip()\n" +"b' spacious'\n" +">>> b'mississippi'.rstrip(b'ipz')\n" +"b'mississ'" +msgstr "" +">>> b' spacious '.rstrip()\n" +"b' spacious'\n" +">>> b'mississippi'.rstrip(b'ipz')\n" +"b'mississ'" + +msgid "" +"The binary sequence of byte values to remove may be any :term:`bytes-like " +"object`. See :meth:`~bytes.removesuffix` for a method that will remove a " +"single suffix string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> b'Monty Python'.rstrip(b' Python')\n" +"b'M'\n" +">>> b'Monty Python'.removesuffix(b' Python')\n" +"b'Monty'" +msgstr "" +">>> b'Monty Python'.rstrip(b' Python')\n" +"b'M'\n" +">>> b'Monty Python'.removesuffix(b' Python')\n" +"b'Monty'" + +msgid "" +"Split the binary sequence into subsequences of the same type, using *sep* as " +"the delimiter string. If *maxsplit* is given and non-negative, at most " +"*maxsplit* splits are done (thus, the list will have at most ``maxsplit+1`` " +"elements). If *maxsplit* is not specified or is ``-1``, then there is no " +"limit on the number of splits (all possible splits are made)." +msgstr "" + +msgid "" +"If *sep* is given, consecutive delimiters are not grouped together and are " +"deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " +"returns ``[b'1', b'', b'2']``). The *sep* argument may consist of a " +"multibyte sequence as a single delimiter. Splitting an empty sequence with a " +"specified separator returns ``[b'']`` or ``[bytearray(b'')]`` depending on " +"the type of object being split. The *sep* argument may be any :term:`bytes-" +"like object`." +msgstr "" + +msgid "" +">>> b'1,2,3'.split(b',')\n" +"[b'1', b'2', b'3']\n" +">>> b'1,2,3'.split(b',', maxsplit=1)\n" +"[b'1', b'2,3']\n" +">>> b'1,2,,3,'.split(b',')\n" +"[b'1', b'2', b'', b'3', b'']\n" +">>> b'1<>2<>3<4'.split(b'<>')\n" +"[b'1', b'2', b'3<4']" +msgstr "" + +msgid "" +"If *sep* is not specified or is ``None``, a different splitting algorithm is " +"applied: runs of consecutive :meth:`ASCII whitespace ` are " +"regarded as a single separator, and the result will contain no empty strings " +"at the start or end if the sequence has leading or trailing whitespace. " +"Consequently, splitting an empty sequence or a sequence consisting solely of " +"ASCII whitespace without a specified separator returns ``[]``." +msgstr "" + +msgid "" +">>> b'1 2 3'.split()\n" +"[b'1', b'2', b'3']\n" +">>> b'1 2 3'.split(maxsplit=1)\n" +"[b'1', b'2 3']\n" +">>> b' 1 2 3 '.split()\n" +"[b'1', b'2', b'3']" +msgstr "" + +msgid "" +"Return a copy of the sequence with specified leading and trailing bytes " +"removed. The *bytes* argument is a binary sequence specifying the set of " +"byte values to be removed. If omitted or ``None``, the *bytes* argument " +"defaults to removing :meth:`ASCII whitespace `. The *bytes* " +"argument is not a prefix or suffix; rather, all combinations of its values " +"are stripped::" +msgstr "" + +msgid "" +">>> b' spacious '.strip()\n" +"b'spacious'\n" +">>> b'www.example.com'.strip(b'cmowz.')\n" +"b'example'" +msgstr "" +">>> b' spacious '.strip()\n" +"b'spacious'\n" +">>> b'www.example.com'.strip(b'cmowz.')\n" +"b'example'" + +msgid "" +"The binary sequence of byte values to remove may be any :term:`bytes-like " +"object`." +msgstr "" + +msgid "" +"The following methods on bytes and bytearray objects assume the use of ASCII " +"compatible binary formats and should not be applied to arbitrary binary " +"data. Note that all of the bytearray methods in this section do *not* " +"operate in place, and instead produce new objects." +msgstr "" + +msgid "" +"Return a copy of the sequence with each byte interpreted as an ASCII " +"character, and the first byte capitalized and the rest lowercased. Non-ASCII " +"byte values are passed through unchanged." +msgstr "" + +msgid "" +"Return a copy of the sequence where all ASCII tab characters are replaced by " +"one or more ASCII spaces, depending on the current column and the given tab " +"size. Tab positions occur every *tabsize* bytes (default is 8, giving tab " +"positions at columns 0, 8, 16 and so on). To expand the sequence, the " +"current column is set to zero and the sequence is examined byte by byte. If " +"the byte is an ASCII tab character (``b'\\t'``), one or more space " +"characters are inserted in the result until the current column is equal to " +"the next tab position. (The tab character itself is not copied.) If the " +"current byte is an ASCII newline (``b'\\n'``) or carriage return " +"(``b'\\r'``), it is copied and the current column is reset to zero. Any " +"other byte value is copied unchanged and the current column is incremented " +"by one regardless of how the byte value is represented when printed::" +msgstr "" + +msgid "" +">>> b'01\\t012\\t0123\\t01234'.expandtabs()\n" +"b'01 012 0123 01234'\n" +">>> b'01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"b'01 012 0123 01234'" +msgstr "" +">>> b'01\\t012\\t0123\\t01234'.expandtabs()\n" +"b'01 012 0123 01234'\n" +">>> b'01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"b'01 012 0123 01234'" + +msgid "" +"Return ``True`` if all bytes in the sequence are alphabetical ASCII " +"characters or ASCII decimal digits and the sequence is not empty, ``False`` " +"otherwise. Alphabetic ASCII characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``. ASCII decimal " +"digits are those byte values in the sequence ``b'0123456789'``." +msgstr "" + +msgid "" +">>> b'ABCabc1'.isalnum()\n" +"True\n" +">>> b'ABC abc1'.isalnum()\n" +"False" +msgstr "" +">>> b'ABCabc1'.isalnum()\n" +"True\n" +">>> b'ABC abc1'.isalnum()\n" +"False" + +msgid "" +"Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " +"and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " +"characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." +msgstr "" + +msgid "" +">>> b'ABCabc'.isalpha()\n" +"True\n" +">>> b'ABCabc1'.isalpha()\n" +"False" +msgstr "" +">>> b'ABCabc'.isalpha()\n" +"True\n" +">>> b'ABCabc1'.isalpha()\n" +"False" + +msgid "" +"Return ``True`` if the sequence is empty or all bytes in the sequence are " +"ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." +msgstr "" + +msgid "" +"Return ``True`` if all bytes in the sequence are ASCII decimal digits and " +"the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " +"those byte values in the sequence ``b'0123456789'``." +msgstr "" + +msgid "" +">>> b'1234'.isdigit()\n" +"True\n" +">>> b'1.23'.isdigit()\n" +"False" +msgstr "" +">>> b'1234'.isdigit()\n" +"True\n" +">>> b'1.23'.isdigit()\n" +"False" + +msgid "" +"Return ``True`` if there is at least one lowercase ASCII character in the " +"sequence and no uppercase ASCII characters, ``False`` otherwise." +msgstr "" + +msgid "" +">>> b'hello world'.islower()\n" +"True\n" +">>> b'Hello world'.islower()\n" +"False" +msgstr "" +">>> b'hello world'.islower()\n" +"True\n" +">>> b'Hello world'.islower()\n" +"False" + +msgid "" +"Lowercase ASCII characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " +"values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." +msgstr "" + +msgid "" +"Return ``True`` if all bytes in the sequence are ASCII whitespace and the " +"sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " +"those byte values in the sequence ``b' \\t\\n\\r\\x0b\\f'`` (space, tab, " +"newline, carriage return, vertical tab, form feed)." +msgstr "" + +msgid "" +"Return ``True`` if the sequence is ASCII titlecase and the sequence is not " +"empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " +"definition of \"titlecase\"." +msgstr "" + +msgid "" +">>> b'Hello World'.istitle()\n" +"True\n" +">>> b'Hello world'.istitle()\n" +"False" +msgstr "" +">>> b'Hello World'.istitle()\n" +"True\n" +">>> b'Hello world'.istitle()\n" +"False" + +msgid "" +"Return ``True`` if there is at least one uppercase alphabetic ASCII " +"character in the sequence and no lowercase ASCII characters, ``False`` " +"otherwise." +msgstr "" + +msgid "" +">>> b'HELLO WORLD'.isupper()\n" +"True\n" +">>> b'Hello world'.isupper()\n" +"False" +msgstr "" +">>> b'HELLO WORLD'.isupper()\n" +"True\n" +">>> b'Hello world'.isupper()\n" +"False" + +msgid "" +"Return a copy of the sequence with all the uppercase ASCII characters " +"converted to their corresponding lowercase counterpart." +msgstr "" + +msgid "" +">>> b'Hello World'.lower()\n" +"b'hello world'" +msgstr "" +">>> b'Hello World'.lower()\n" +"b'hello world'" + +msgid "" +"Return a list of the lines in the binary sequence, breaking at ASCII line " +"boundaries. This method uses the :term:`universal newlines` approach to " +"splitting lines. Line breaks are not included in the resulting list unless " +"*keepends* is given and true." +msgstr "" + +msgid "" +">>> b'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" +"[b'ab c', b'', b'de fg', b'kl']\n" +">>> b'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines(keepends=True)\n" +"[b'ab c\\n', b'\\n', b'de fg\\r', b'kl\\r\\n']" +msgstr "" + +msgid "" +"Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " +"method returns an empty list for the empty string, and a terminal line break " +"does not result in an extra line::" +msgstr "" + +msgid "" +">>> b\"\".split(b'\\n'), b\"Two lines\\n\".split(b'\\n')\n" +"([b''], [b'Two lines', b''])\n" +">>> b\"\".splitlines(), b\"One line\\n\".splitlines()\n" +"([], [b'One line'])" +msgstr "" + +msgid "" +"Return a copy of the sequence with all the lowercase ASCII characters " +"converted to their corresponding uppercase counterpart and vice-versa." +msgstr "" + +msgid "" +">>> b'Hello World'.swapcase()\n" +"b'hELLO wORLD'" +msgstr "" +">>> b'Hello World'.swapcase()\n" +"b'hELLO wORLD'" + +msgid "" +"Unlike :func:`str.swapcase`, it is always the case that " +"``bin.swapcase().swapcase() == bin`` for the binary versions. Case " +"conversions are symmetrical in ASCII, even though that is not generally true " +"for arbitrary Unicode code points." +msgstr "" + +msgid "" +"Return a titlecased version of the binary sequence where words start with an " +"uppercase ASCII character and the remaining characters are lowercase. " +"Uncased byte values are left unmodified." +msgstr "" + +msgid "" +">>> b'Hello world'.title()\n" +"b'Hello World'" +msgstr "" +">>> b'Hello world'.title()\n" +"b'Hello World'" + +msgid "" +"Lowercase ASCII characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " +"values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``. All other byte " +"values are uncased." +msgstr "" + +msgid "" +">>> b\"they're bill's friends from the UK\".title()\n" +"b\"They'Re Bill'S Friends From The Uk\"" +msgstr "" +">>> b\"they're bill's friends from the UK\".title()\n" +"b\"They'Re Bill'S Friends From The Uk\"" + +msgid "" +"A workaround for apostrophes can be constructed using regular expressions::" +msgstr "" + +msgid "" +">>> import re\n" +">>> def titlecase(s):\n" +"... return re.sub(rb\"[A-Za-z]+('[A-Za-z]+)?\",\n" +"... lambda mo: mo.group(0)[0:1].upper() +\n" +"... mo.group(0)[1:].lower(),\n" +"... s)\n" +"...\n" +">>> titlecase(b\"they're bill's friends.\")\n" +"b\"They're Bill's Friends.\"" +msgstr "" + +msgid "" +"Return a copy of the sequence with all the lowercase ASCII characters " +"converted to their corresponding uppercase counterpart." +msgstr "" + +msgid "" +">>> b'Hello World'.upper()\n" +"b'HELLO WORLD'" +msgstr "" +">>> b'Hello World'.upper()\n" +"b'HELLO WORLD'" + +msgid "" +"Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " +"a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " +"handled by inserting the padding *after* the sign character rather than " +"before. For :class:`bytes` objects, the original sequence is returned if " +"*width* is less than or equal to ``len(seq)``." +msgstr "" + +msgid "" +">>> b\"42\".zfill(5)\n" +"b'00042'\n" +">>> b\"-42\".zfill(5)\n" +"b'-0042'" +msgstr "" +">>> b\"42\".zfill(5)\n" +"b'00042'\n" +">>> b\"-42\".zfill(5)\n" +"b'-0042'" + +msgid "``printf``-style Bytes Formatting" +msgstr "" + +msgid "" +"The formatting operations described here exhibit a variety of quirks that " +"lead to a number of common errors (such as failing to display tuples and " +"dictionaries correctly). If the value being printed may be a tuple or " +"dictionary, wrap it in a tuple." +msgstr "" + +msgid "" +"Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " +"the ``%`` operator (modulo). This is also known as the bytes *formatting* or " +"*interpolation* operator. Given ``format % values`` (where *format* is a " +"bytes object), ``%`` conversion specifications in *format* are replaced with " +"zero or more elements of *values*. The effect is similar to using " +"the :c:func:`sprintf` function in the C language." +msgstr "" + +msgid "" +"If *format* requires a single argument, *values* may be a single non-tuple " +"object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " +"items specified by the format bytes object, or a single mapping object (for " +"example, a dictionary)." +msgstr "" + +msgid "" +"When the right argument is a dictionary (or other mapping type), then the " +"formats in the bytes object *must* include a parenthesised mapping key into " +"that dictionary inserted immediately after the ``'%'`` character. The " +"mapping key selects the value to be formatted from the mapping. For example:" +msgstr "" + +msgid "\\(8)" +msgstr "\\(8)" + +msgid "Single byte (accepts integer or single byte objects)." +msgstr "" + +msgid "``'b'``" +msgstr "``'b'``" + +msgid "" +"Bytes (any object that follows the :ref:`buffer protocol ` or " +"has :meth:`~object.__bytes__`)." +msgstr "" + +msgid "" +"``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " +"bases." +msgstr "" + +msgid "" +"Bytes (converts any Python object using ``repr(obj).encode('ascii', " +"'backslashreplace')``)." +msgstr "" + +msgid "" +"``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " +"bases." +msgstr "" + +msgid "\\(7)" +msgstr "\\(7)" + +msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." +msgstr "" + +msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." +msgstr "" + +msgid ":pep:`461` - Adding % formatting to bytes and bytearray" +msgstr "" + +msgid "Memory Views" +msgstr "" + +msgid "" +":class:`memoryview` objects allow Python code to access the internal data of " +"an object that supports the :ref:`buffer protocol ` without " +"copying." +msgstr "" + +msgid "" +"Create a :class:`memoryview` that references *object*. *object* must " +"support the buffer protocol. Built-in objects that support the buffer " +"protocol include :class:`bytes` and :class:`bytearray`." +msgstr "" + +msgid "" +"A :class:`memoryview` has the notion of an *element*, which is the atomic " +"memory unit handled by the originating *object*. For many simple types such " +"as :class:`bytes` and :class:`bytearray`, an element is a single byte, but " +"other types such as :class:`array.array` may have bigger elements." +msgstr "" + +msgid "" +":class:`!memoryview`\\s are :ref:`generic ` over the type of their " +"underlying data." +msgstr "" + +msgid "" +"``len(view)`` is equal to the length of :meth:`~memoryview.tolist`, which is " +"the nested list representation of the view. If ``view.ndim == 1``, this is " +"equal to the number of elements in the view." +msgstr "" + +msgid "" +"If ``view.ndim == 0``, ``len(view)`` now raises :exc:`TypeError` instead of " +"returning 1." +msgstr "" + +msgid "" +"The :class:`~memoryview.itemsize` attribute will give you the number of " +"bytes in a single element." +msgstr "" + +msgid "" +"A :class:`memoryview` supports slicing and indexing to expose its data. One-" +"dimensional slicing will result in a subview::" +msgstr "" + +msgid "" +">>> v = memoryview(b'abcefg')\n" +">>> v[1]\n" +"98\n" +">>> v[-1]\n" +"103\n" +">>> v[1:4]\n" +"\n" +">>> bytes(v[1:4])\n" +"b'bce'" +msgstr "" + +msgid "" +"If :class:`~memoryview.format` is one of the native format specifiers from " +"the :mod:`struct` module, indexing with an integer or a tuple of integers is " +"also supported and returns a single *element* with the correct type. One-" +"dimensional memoryviews can be indexed with an integer or a one-integer " +"tuple. Multi-dimensional memoryviews can be indexed with tuples of exactly " +"*ndim* integers where *ndim* is the number of dimensions. Zero-dimensional " +"memoryviews can be indexed with the empty tuple." +msgstr "" + +msgid "Here is an example with a non-byte format::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('l', [-11111111, 22222222, -33333333, 44444444])\n" +">>> m = memoryview(a)\n" +">>> m[0]\n" +"-11111111\n" +">>> m[-1]\n" +"44444444\n" +">>> m[::2].tolist()\n" +"[-11111111, -33333333]" +msgstr "" + +msgid "" +"If the underlying object is writable, the memoryview supports one-" +"dimensional slice assignment. Resizing is not allowed::" +msgstr "" + +msgid "" +">>> data = bytearray(b'abcefg')\n" +">>> v = memoryview(data)\n" +">>> v.readonly\n" +"False\n" +">>> v[0] = ord(b'z')\n" +">>> data\n" +"bytearray(b'zbcefg')\n" +">>> v[1:4] = b'123'\n" +">>> data\n" +"bytearray(b'z123fg')\n" +">>> v[2:3] = b'spam'\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"ValueError: memoryview assignment: lvalue and rvalue have different " +"structures\n" +">>> v[2:6] = b'spam'\n" +">>> data\n" +"bytearray(b'z1spam')" +msgstr "" + +msgid "" +"One-dimensional memoryviews of :term:`hashable` (read-only) types with " +"formats 'B', 'b' or 'c' are also hashable. The hash is defined as ``hash(m) " +"== hash(m.tobytes())``::" +msgstr "" + +msgid "" +">>> v = memoryview(b'abcefg')\n" +">>> hash(v) == hash(b'abcefg')\n" +"True\n" +">>> hash(v[2:4]) == hash(b'ce')\n" +"True\n" +">>> hash(v[::-2]) == hash(b'abcefg'[::-2])\n" +"True" +msgstr "" + +msgid "" +"One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " +"with formats 'B', 'b' or 'c' are now :term:`hashable`." +msgstr "" + +msgid "" +"memoryview is now registered automatically " +"with :class:`collections.abc.Sequence`" +msgstr "" + +msgid "memoryviews can now be indexed with a tuple of integers." +msgstr "" + +msgid "memoryview is now a :term:`generic type`." +msgstr "" + +msgid ":class:`memoryview` has several methods:" +msgstr "" + +msgid "" +"A memoryview and a :pep:`3118` exporter are equal if their shapes are " +"equivalent and if all corresponding values are equal when the operands' " +"respective format codes are interpreted using :mod:`struct` syntax." +msgstr "" + +msgid "" +"For the subset of :mod:`struct` format strings currently supported " +"by :meth:`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == " +"w.tolist()``::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('I', [1, 2, 3, 4, 5])\n" +">>> b = array.array('d', [1.0, 2.0, 3.0, 4.0, 5.0])\n" +">>> c = array.array('b', [5, 3, 1])\n" +">>> x = memoryview(a)\n" +">>> y = memoryview(b)\n" +">>> x == a == y == b\n" +"True\n" +">>> x.tolist() == a.tolist() == y.tolist() == b.tolist()\n" +"True\n" +">>> z = y[::-2]\n" +">>> z == c\n" +"True\n" +">>> z.tolist() == c.tolist()\n" +"True" +msgstr "" + +msgid "" +"If either format string is not supported by the :mod:`struct` module, then " +"the objects will always compare as unequal (even if the format strings and " +"buffer contents are identical)::" +msgstr "" + +msgid "" +">>> from ctypes import BigEndianStructure, c_long\n" +">>> class BEPoint(BigEndianStructure):\n" +"... _fields_ = [(\"x\", c_long), (\"y\", c_long)]\n" +"...\n" +">>> point = BEPoint(100, 200)\n" +">>> a = memoryview(point)\n" +">>> b = memoryview(point)\n" +">>> a == point\n" +"False\n" +">>> a == b\n" +"False" +msgstr "" + +msgid "" +"Note that, as with floating-point numbers, ``v is w`` does *not* imply ``v " +"== w`` for memoryview objects." +msgstr "" + +msgid "" +"Previous versions compared the raw memory disregarding the item format and " +"the logical array structure." +msgstr "" + +msgid "" +"Return the data in the buffer as a bytestring. This is equivalent to " +"calling the :class:`bytes` constructor on the memoryview. ::" +msgstr "" + +msgid "" +">>> m = memoryview(b\"abc\")\n" +">>> m.tobytes()\n" +"b'abc'\n" +">>> bytes(m)\n" +"b'abc'" +msgstr "" +">>> m = memoryview(b\"abc\")\n" +">>> m.tobytes()\n" +"b'abc'\n" +">>> bytes(m)\n" +"b'abc'" + +msgid "" +"For non-contiguous arrays the result is equal to the flattened list " +"representation with all elements converted to bytes. :meth:`tobytes` " +"supports all format strings, including those that are not in :mod:`struct` " +"module syntax." +msgstr "" + +msgid "" +"*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " +"original array is converted to C or Fortran order. For contiguous views, 'A' " +"returns an exact copy of the physical memory. In particular, in-memory " +"Fortran order is preserved. For non-contiguous views, the data is converted " +"to C first. *order=None* is the same as *order='C'*." +msgstr "" + +msgid "" +"Return a string object containing two hexadecimal digits for each byte in " +"the buffer. ::" +msgstr "" + +msgid "" +">>> m = memoryview(b\"abc\")\n" +">>> m.hex()\n" +"'616263'" +msgstr "" +">>> m = memoryview(b\"abc\")\n" +">>> m.hex()\n" +"'616263'" + +msgid "" +"Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " +"*sep* and *bytes_per_sep* parameters to insert separators between bytes in " +"the hex output." +msgstr "" + +msgid "Return the data in the buffer as a list of elements. ::" +msgstr "" + +msgid "" +">>> memoryview(b'abc').tolist()\n" +"[97, 98, 99]\n" +">>> import array\n" +">>> a = array.array('d', [1.1, 2.2, 3.3])\n" +">>> m = memoryview(a)\n" +">>> m.tolist()\n" +"[1.1, 2.2, 3.3]" +msgstr "" + +msgid "" +":meth:`tolist` now supports all single character native formats " +"in :mod:`struct` module syntax as well as multi-dimensional representations." +msgstr "" + +msgid "" +"Return a readonly version of the memoryview object. The original memoryview " +"object is unchanged. ::" +msgstr "" + +msgid "" +">>> m = memoryview(bytearray(b'abc'))\n" +">>> mm = m.toreadonly()\n" +">>> mm.tolist()\n" +"[97, 98, 99]\n" +">>> mm[0] = 42\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: cannot modify read-only memory\n" +">>> m[0] = 43\n" +">>> mm.tolist()\n" +"[43, 98, 99]" +msgstr "" + +msgid "" +"Release the underlying buffer exposed by the memoryview object. Many " +"objects take special actions when a view is held on them (for example, " +"a :class:`bytearray` would temporarily forbid resizing); therefore, calling " +"release() is handy to remove these restrictions (and free any dangling " +"resources) as soon as possible." +msgstr "" + +msgid "" +"After this method has been called, any further operation on the view raises " +"a :class:`ValueError` (except :meth:`release` itself which can be called " +"multiple times)::" +msgstr "" + +msgid "" +">>> m = memoryview(b'abc')\n" +">>> m.release()\n" +">>> m[0]\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"ValueError: operation forbidden on released memoryview object" +msgstr "" + +msgid "" +"The context management protocol can be used for a similar effect, using the " +"``with`` statement::" +msgstr "" + +msgid "" +">>> with memoryview(b'abc') as m:\n" +"... m[0]\n" +"...\n" +"97\n" +">>> m[0]\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"ValueError: operation forbidden on released memoryview object" +msgstr "" + +msgid "" +"Cast a memoryview to a new format or shape. *shape* defaults to " +"``[byte_length//new_itemsize]``, which means that the result view will be " +"one-dimensional. The return value is a new memoryview, but the buffer itself " +"is not copied. Supported casts are 1D -> C-:term:`contiguous` and C-" +"contiguous -> 1D." +msgstr "" + +msgid "" +"The destination format is restricted to a single element native format " +"in :mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' " +"or 'c'). The byte length of the result must be the same as the original " +"length. Note that all byte lengths may depend on the operating system." +msgstr "" + +msgid "Cast 1D/long to 1D/unsigned bytes::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('l', [1,2,3])\n" +">>> x = memoryview(a)\n" +">>> x.format\n" +"'l'\n" +">>> x.itemsize\n" +"8\n" +">>> len(x)\n" +"3\n" +">>> x.nbytes\n" +"24\n" +">>> y = x.cast('B')\n" +">>> y.format\n" +"'B'\n" +">>> y.itemsize\n" +"1\n" +">>> len(y)\n" +"24\n" +">>> y.nbytes\n" +"24" +msgstr "" + +msgid "Cast 1D/unsigned bytes to 1D/char::" +msgstr "" + +msgid "" +">>> b = bytearray(b'zyz')\n" +">>> x = memoryview(b)\n" +">>> x[0] = b'a'\n" +"Traceback (most recent call last):\n" +" ...\n" +"TypeError: memoryview: invalid type for format 'B'\n" +">>> y = x.cast('c')\n" +">>> y[0] = b'a'\n" +">>> b\n" +"bytearray(b'ayz')" +msgstr "" + +msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" +msgstr "" + +msgid "" +">>> import struct\n" +">>> buf = struct.pack(\"i\"*12, *list(range(12)))\n" +">>> x = memoryview(buf)\n" +">>> y = x.cast('i', shape=[2,2,3])\n" +">>> y.tolist()\n" +"[[[0, 1, 2], [3, 4, 5]], [[6, 7, 8], [9, 10, 11]]]\n" +">>> y.format\n" +"'i'\n" +">>> y.itemsize\n" +"4\n" +">>> len(y)\n" +"2\n" +">>> y.nbytes\n" +"48\n" +">>> z = y.cast('b')\n" +">>> z.format\n" +"'b'\n" +">>> z.itemsize\n" +"1\n" +">>> len(z)\n" +"48\n" +">>> z.nbytes\n" +"48" +msgstr "" + +msgid "Cast 1D/unsigned long to 2D/unsigned long::" +msgstr "" + +msgid "" +">>> buf = struct.pack(\"L\"*6, *list(range(6)))\n" +">>> x = memoryview(buf)\n" +">>> y = x.cast('L', shape=[2,3])\n" +">>> len(y)\n" +"2\n" +">>> y.nbytes\n" +"48\n" +">>> y.tolist()\n" +"[[0, 1, 2], [3, 4, 5]]" +msgstr "" + +msgid "The source format is no longer restricted when casting to a byte view." +msgstr "" + +msgid "Count the number of occurrences of *value*." +msgstr "" + +msgid "" +"Return the index of the first occurrence of *value* (at or after index " +"*start* and before index *stop*)." +msgstr "" + +msgid "Raises a :exc:`ValueError` if *value* cannot be found." +msgstr "" + +msgid "There are also several readonly attributes available:" +msgstr "" + +msgid "The underlying object of the memoryview::" +msgstr "" + +msgid "" +">>> b = bytearray(b'xyz')\n" +">>> m = memoryview(b)\n" +">>> m.obj is b\n" +"True" +msgstr "" +">>> b = bytearray(b'xyz')\n" +">>> m = memoryview(b)\n" +">>> m.obj is b\n" +"True" + +msgid "" +"``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " +"amount of space in bytes that the array would use in a contiguous " +"representation. It is not necessarily equal to ``len(m)``::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('i', [1,2,3,4,5])\n" +">>> m = memoryview(a)\n" +">>> len(m)\n" +"5\n" +">>> m.nbytes\n" +"20\n" +">>> y = m[::2]\n" +">>> len(y)\n" +"3\n" +">>> y.nbytes\n" +"12\n" +">>> len(y.tobytes())\n" +"12" +msgstr "" + +msgid "Multi-dimensional arrays::" +msgstr "" + +msgid "" +">>> import struct\n" +">>> buf = struct.pack(\"d\"*12, *[1.5*x for x in range(12)])\n" +">>> x = memoryview(buf)\n" +">>> y = x.cast('d', shape=[3,4])\n" +">>> y.tolist()\n" +"[[0.0, 1.5, 3.0, 4.5], [6.0, 7.5, 9.0, 10.5], [12.0, 13.5, 15.0, 16.5]]\n" +">>> len(y)\n" +"3\n" +">>> y.nbytes\n" +"96" +msgstr "" + +msgid "A bool indicating whether the memory is read only." +msgstr "" + +msgid "" +"A string containing the format (in :mod:`struct` module style) for each " +"element in the view. A memoryview can be created from exporters with " +"arbitrary format strings, but some methods (e.g. :meth:`tolist`) are " +"restricted to native single element formats." +msgstr "" + +msgid "" +"format ``'B'`` is now handled according to the struct module syntax. This " +"means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." +msgstr "" + +msgid "The size in bytes of each element of the memoryview::" +msgstr "" + +msgid "" +">>> import array, struct\n" +">>> m = memoryview(array.array('H', [32000, 32001, 32002]))\n" +">>> m.itemsize\n" +"2\n" +">>> m[0]\n" +"32000\n" +">>> struct.calcsize('H') == m.itemsize\n" +"True" +msgstr "" + +msgid "" +"An integer indicating how many dimensions of a multi-dimensional array the " +"memory represents." +msgstr "" + +msgid "" +"A tuple of integers the length of :attr:`ndim` giving the shape of the " +"memory as an N-dimensional array." +msgstr "" + +msgid "An empty tuple instead of ``None`` when ndim = 0." +msgstr "" + +msgid "" +"A tuple of integers the length of :attr:`ndim` giving the size in bytes to " +"access each element for each dimension of the array." +msgstr "" + +msgid "Used internally for PIL-style arrays. The value is informational only." +msgstr "" + +msgid "A bool indicating whether the memory is C-:term:`contiguous`." +msgstr "" + +msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." +msgstr "" + +msgid "A bool indicating whether the memory is :term:`contiguous`." +msgstr "" + +msgid "" +"For information on the thread safety of :class:`memoryview` objects in " +"the :term:`free-threaded build`, see :ref:`thread-safety-memoryview`." +msgstr "" + +msgid "Set Types --- :class:`set`, :class:`frozenset`" +msgstr "" + +msgid "" +"A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " +"objects. Common uses include membership testing, removing duplicates from a " +"sequence, and computing mathematical operations such as intersection, union, " +"difference, and symmetric difference. (For other containers see the built-" +"in :class:`dict`, :class:`list`, and :class:`tuple` classes, and " +"the :mod:`collections` module.) See :ref:`time-complexity` for the costs of " +"the various set operations." +msgstr "" + +msgid "" +"Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " +"in set``. Being an unordered collection, sets do not record element " +"position or order of insertion. Accordingly, sets do not support indexing, " +"slicing, or other sequence-like behavior." +msgstr "" + +msgid "" +"There are currently two built-in set types, :class:`set` " +"and :class:`frozenset`. The :class:`set` type is mutable --- the contents " +"can be changed using methods like :meth:`~set.add` and :meth:`~set.remove`. " +"Since it is mutable, it has no hash value and cannot be used as either a " +"dictionary key or as an element of another set. The :class:`frozenset` type " +"is immutable and :term:`hashable` --- its contents cannot be altered after " +"it is created; it can therefore be used as a dictionary key or as an element " +"of another set." +msgstr "" + +msgid "" +"Non-empty sets (not frozensets) can be created by placing a comma-separated " +"list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " +"addition to the :class:`set` constructor." +msgstr "" + +msgid "The constructors for both classes work the same:" +msgstr "" + +msgid "" +"Return a new set or frozenset object whose elements are taken from " +"*iterable*. The elements of a set must be :term:`hashable`. To represent " +"sets of sets, the inner sets must be :class:`frozenset` objects. If " +"*iterable* is not specified, a new empty set is returned." +msgstr "" + +msgid "Sets can be created by several means:" +msgstr "" + +msgid "" +"Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" +msgstr "" + +msgid "" +"Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" +msgstr "" + +msgid "" +"Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " +"'foo'])``" +msgstr "" + +msgid "" +"Instances of :class:`set` and :class:`frozenset` provide the following " +"operations:" +msgstr "" + +msgid "Return the number of elements in set *s* (cardinality of *s*)." +msgstr "" + +msgid "Test *x* for membership in *s*." +msgstr "" + +msgid "Test *x* for non-membership in *s*." +msgstr "" + +msgid "" +"Return ``True`` if the set has no elements in common with *other*. Sets are " +"disjoint if and only if their intersection is the empty set." +msgstr "" + +msgid "Test whether every element in the set is in *other*." +msgstr "" + +msgid "" +"Test whether the set is a proper subset of *other*, that is, ``set <= other " +"and set != other``." +msgstr "" + +msgid "Test whether every element in *other* is in the set." +msgstr "" + +msgid "" +"Test whether the set is a proper superset of *other*, that is, ``set >= " +"other and set != other``." +msgstr "" + +msgid "Return a new set with elements from the set and all others." +msgstr "" + +msgid "Return a new set with elements common to the set and all others." +msgstr "" + +msgid "Return a new set with elements in the set that are not in the others." +msgstr "" + +msgid "" +"Return a new set with elements in either the set or *other* but not both." +msgstr "" + +msgid "Return a shallow copy of the set." +msgstr "" + +msgid "" +"Note, the non-operator versions " +"of :meth:`~frozenset.union`, :meth:`~frozenset.intersection`, :meth:`~frozenset.difference`, :meth:`~frozenset.symmetric_difference`, :meth:`~frozenset.issubset`, " +"and :meth:`~frozenset.issuperset` methods will accept any iterable as an " +"argument. In contrast, their operator based counterparts require their " +"arguments to be sets. This precludes error-prone constructions like " +"``set('abc') & 'cbs'`` in favor of the more readable " +"``set('abc').intersection('cbs')``." +msgstr "" + +msgid "" +"Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " +"sets are equal if and only if every element of each set is contained in the " +"other (each is a subset of the other). A set is less than another set if and " +"only if the first set is a proper subset of the second set (is a subset, but " +"is not equal). A set is greater than another set if and only if the first " +"set is a proper superset of the second set (is a superset, but is not equal)." +msgstr "" + +msgid "" +"Instances of :class:`set` are compared to instances of :class:`frozenset` " +"based on their members. For example, ``set('abc') == frozenset('abc')`` " +"returns ``True`` and so does ``set('abc') in set([frozenset('abc')])``." +msgstr "" + +msgid "" +"The subset and equality comparisons do not generalize to a total ordering " +"function. For example, any two nonempty disjoint sets are not equal and are " +"not subsets of each other, so *all* of the following return ``False``: " +"``ab``." +msgstr "" + +msgid "" +"Since sets only define partial ordering (subset relationships), the output " +"of the :meth:`list.sort` method is undefined for lists of sets." +msgstr "" + +msgid "Set elements, like dictionary keys, must be :term:`hashable`." +msgstr "" + +msgid "" +"Binary operations that mix :class:`set` instances with :class:`frozenset` " +"return the type of the first operand. For example: ``frozenset('ab') | " +"set('bc')`` returns an instance of :class:`frozenset`." +msgstr "" + +msgid "" +"The following table lists operations available for :class:`set` that do not " +"apply to immutable instances of :class:`frozenset`:" +msgstr "" + +msgid "Update the set, adding elements from all others." +msgstr "" + +msgid "Update the set, keeping only elements found in it and all others." +msgstr "" + +msgid "Update the set, removing elements found in others." +msgstr "" + +msgid "" +"Update the set, keeping only elements found in either set, but not in both." +msgstr "" + +msgid "Add element *elem* to the set." +msgstr "" + +msgid "" +"Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " +"contained in the set." +msgstr "" + +msgid "Remove element *elem* from the set if it is present." +msgstr "" + +msgid "" +"Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " +"if the set is empty." +msgstr "" + +msgid "Remove all elements from the set." +msgstr "" + +msgid "" +"Note, the non-operator versions of " +"the :meth:`~set.update`, :meth:`~set.intersection_update`, :meth:`~set.difference_update`, " +"and :meth:`~set.symmetric_difference_update` methods will accept any " +"iterable as an argument." +msgstr "" + +msgid "" +"Note, the *elem* argument to " +"the :meth:`~object.__contains__`, :meth:`~set.remove`, " +"and :meth:`~set.discard` methods may be a set. To support searching for an " +"equivalent frozenset, a temporary one is created from *elem*." +msgstr "" + +msgid "" +"For detailed information on thread-safety guarantees for :class:`set` " +"objects, see :ref:`thread-safety-set`." +msgstr "" + +msgid "" +"Sets and frozensets are :ref:`generic ` over the type of their " +"elements." +msgstr "" + +msgid "Mapping Types --- :class:`dict`" +msgstr "" + +msgid "" +"A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " +"Mappings are mutable objects. There is currently only one standard mapping " +"type, the :dfn:`dictionary`. (For other containers see the built-" +"in :class:`list`, :class:`set`, and :class:`tuple` classes, and " +"the :mod:`collections` module.) See :ref:`time-complexity` for the costs of " +"the various dictionary operations." +msgstr "" + +msgid "" +"A dictionary's keys are *almost* arbitrary values. Values that are " +"not :term:`hashable`, that is, values containing lists, dictionaries or " +"other mutable types (that are compared by value rather than by object " +"identity) may not be used as keys. Values that compare equal (such as ``1``, " +"``1.0``, and ``True``) can be used interchangeably to index the same " +"dictionary entry." +msgstr "" + +msgid "" +"Return a new dictionary initialized from an optional positional argument and " +"a possibly empty set of keyword arguments." +msgstr "" + +msgid "Dictionaries can be created by several means:" +msgstr "" + +msgid "" +"Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " +"4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" +msgstr "" + +msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" +msgstr "" + +msgid "" +"Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " +"200)])``, ``dict(foo=100, bar=200)``" +msgstr "" + +msgid "" +"If no positional argument is given, an empty dictionary is created. If a " +"positional argument is given and it defines a ``keys()`` method, a " +"dictionary is created by calling :meth:`~object.__getitem__` on the argument " +"with each returned key from the method. Otherwise, the positional argument " +"must be an :term:`iterable` object. Each item in the iterable must itself " +"be an iterable with exactly two elements. The first element of each item " +"becomes a key in the new dictionary, and the second element the " +"corresponding value. If a key occurs more than once, the last value for " +"that key becomes the corresponding value in the new dictionary." +msgstr "" + +msgid "" +"If keyword arguments are given, the keyword arguments and their values are " +"added to the dictionary created from the positional argument. If a key " +"being added is already present, the value from the keyword argument replaces " +"the value from the positional argument." +msgstr "" + +msgid "" +"Dictionaries compare equal if and only if they have the same ``(key, " +"value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " +"'>') raise :exc:`TypeError`. To illustrate dictionary creation and " +"equality, the following examples all return a dictionary equal to " +"``{\"one\": 1, \"two\": 2, \"three\": 3}``::" +msgstr "" + +msgid "" +">>> a = dict(one=1, two=2, three=3)\n" +">>> b = {'one': 1, 'two': 2, 'three': 3}\n" +">>> c = dict(zip(['one', 'two', 'three'], [1, 2, 3]))\n" +">>> d = dict([('two', 2), ('one', 1), ('three', 3)])\n" +">>> e = dict({'three': 3, 'one': 1, 'two': 2})\n" +">>> f = dict({'one': 1, 'three': 3}, two=2)\n" +">>> a == b == c == d == e == f\n" +"True" +msgstr "" + +msgid "" +"Providing keyword arguments as in the first example only works for keys that " +"are valid Python identifiers. Otherwise, any valid keys can be used." +msgstr "" + +msgid "" +"Dictionaries preserve insertion order. Note that updating a key does not " +"affect the order. Keys added after deletion are inserted at the end. ::" +msgstr "" + +msgid "" +">>> d = {\"one\": 1, \"two\": 2, \"three\": 3, \"four\": 4}\n" +">>> d\n" +"{'one': 1, 'two': 2, 'three': 3, 'four': 4}\n" +">>> list(d)\n" +"['one', 'two', 'three', 'four']\n" +">>> list(d.values())\n" +"[1, 2, 3, 4]\n" +">>> d[\"one\"] = 42\n" +">>> d\n" +"{'one': 42, 'two': 2, 'three': 3, 'four': 4}\n" +">>> del d[\"two\"]\n" +">>> d[\"two\"] = None\n" +">>> d\n" +"{'one': 42, 'three': 3, 'four': 4, 'two': None}" +msgstr "" + +msgid "" +"Dictionary order is guaranteed to be insertion order. This behavior was an " +"implementation detail of CPython from 3.6." +msgstr "" + +msgid "" +"Dictionaries are :ref:`generic ` over two types, signifying " +"(respectively) the types of the dictionary's keys and values." +msgstr "" + +msgid "" +"These are the operations that dictionaries support (and therefore, custom " +"mapping types should support too):" +msgstr "" + +msgid "Return a list of all the keys used in the dictionary *d*." +msgstr "" + +msgid "Return the number of items in the dictionary *d*." +msgstr "" + +msgid "" +"Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " +"not in the map." +msgstr "" + +msgid "" +"If a subclass of dict defines a method :meth:`~object.__missing__` and *key* " +"is not present, the ``d[key]`` operation calls that method with the key " +"*key* as argument. The ``d[key]`` operation then returns or raises whatever " +"is returned or raised by the ``__missing__(key)`` call. No other operations " +"or methods invoke :meth:`~object.__missing__`. " +"If :meth:`~object.__missing__` is not defined, :exc:`KeyError` is " +"raised. :meth:`~object.__missing__` must be a method; it cannot be an " +"instance variable::" +msgstr "" + +msgid "" +">>> class Counter(dict):\n" +"... def __missing__(self, key):\n" +"... return 0\n" +"...\n" +">>> c = Counter()\n" +">>> c['red']\n" +"0\n" +">>> c['red'] += 1\n" +">>> c['red']\n" +"1" +msgstr "" + +msgid "" +"The example above shows part of the implementation " +"of :class:`collections.Counter`. A different :meth:`!__missing__` method is " +"used by :class:`collections.defaultdict`." +msgstr "" + +msgid "Set ``d[key]`` to *value*." +msgstr "" + +msgid "" +"Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " +"map." +msgstr "" + +msgid "Return ``True`` if *d* has a key *key*, else ``False``." +msgstr "" + +msgid "Equivalent to ``not key in d``." +msgstr "" + +msgid "" +"Return an iterator over the keys of the dictionary. This is a shortcut for " +"``iter(d.keys())``." +msgstr "" + +msgid "Remove all items from the dictionary." +msgstr "" + +msgid "Return a shallow copy of the dictionary." +msgstr "" + +msgid "" +"Create a new dictionary with keys from *iterable* and values set to *value*." +msgstr "" + +msgid "" +":meth:`fromkeys` is a class method that returns a new dictionary. *value* " +"defaults to ``None``. All of the values refer to just a single instance, so " +"it generally doesn't make sense for *value* to be a mutable object such as " +"an empty list. To get distinct values, use a :ref:`dict comprehension " +"` instead." +msgstr "" + +msgid "" +"Return the value for *key* if *key* is in the dictionary, else *default*. If " +"*default* is not given, it defaults to ``None``, so that this method never " +"raises a :exc:`KeyError`." +msgstr "" + +msgid "" +"Return a new view of the dictionary's items (``(key, value)`` pairs). See " +"the :ref:`documentation of view objects `." +msgstr "" + +msgid "" +"Return a new view of the dictionary's keys. See the :ref:`documentation of " +"view objects `." +msgstr "" + +msgid "" +"If *key* is in the dictionary, remove it and return its value, else return " +"*default*. If *default* is not given and *key* is not in the dictionary, " +"a :exc:`KeyError` is raised." +msgstr "" + +msgid "" +"Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " +"returned in :abbr:`LIFO (last-in, first-out)` order." +msgstr "" + +msgid "" +":meth:`popitem` is useful to destructively iterate over a dictionary, as " +"often used in set algorithms. If the dictionary is empty, " +"calling :meth:`popitem` raises a :exc:`KeyError`." +msgstr "" + +msgid "" +"LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " +"return an arbitrary key/value pair." +msgstr "" + +msgid "" +"Return a reverse iterator over the keys of the dictionary. This is a " +"shortcut for ``reversed(d.keys())``." +msgstr "" + +msgid "" +"If *key* is in the dictionary, return its value. If not, insert *key* with " +"a value of *default* and return *default*. *default* defaults to ``None``." +msgstr "" + +msgid "" +"Update the dictionary with the key/value pairs from *mapping* or *iterable* " +"and *kwargs*, overwriting existing keys. Return ``None``." +msgstr "" + +msgid "" +":meth:`update` accepts either another object with a ``keys()`` method (in " +"which case :meth:`~object.__getitem__` is called with every key returned " +"from the method) or an iterable of key/value pairs (as tuples or other " +"iterables of length two). If keyword arguments are specified, the dictionary " +"is then updated with those key/value pairs: ``d.update(red=1, blue=2)``." +msgstr "" + +msgid "" +"Return a new view of the dictionary's values. See the :ref:`documentation " +"of view objects `." +msgstr "" + +msgid "" +"An equality comparison between one ``dict.values()`` view and another will " +"always return ``False``. This also applies when comparing ``dict.values()`` " +"to itself::" +msgstr "" + +msgid "" +">>> d = {'a': 1}\n" +">>> d.values() == d.values()\n" +"False" +msgstr "" +">>> d = {'a': 1}\n" +">>> d.values() == d.values()\n" +"False" + +msgid "" +"Create a new dictionary with the merged keys and values of *d* and *other*, " +"which must both be dictionaries. The values of *other* take priority when " +"*d* and *other* share keys." +msgstr "" + +msgid "" +"Update the dictionary *d* with keys and values from *other*, which may be " +"either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " +"values of *other* take priority when *d* and *other* share keys." +msgstr "" + +msgid "Dictionaries and dictionary views are reversible. ::" +msgstr "" + +msgid "" +">>> d = {\"one\": 1, \"two\": 2, \"three\": 3, \"four\": 4}\n" +">>> d\n" +"{'one': 1, 'two': 2, 'three': 3, 'four': 4}\n" +">>> list(reversed(d))\n" +"['four', 'three', 'two', 'one']\n" +">>> list(reversed(d.values()))\n" +"[4, 3, 2, 1]\n" +">>> list(reversed(d.items()))\n" +"[('four', 4), ('three', 3), ('two', 2), ('one', 1)]" +msgstr "" + +msgid "Dictionaries are now reversible." +msgstr "" + +msgid "" +":class:`types.MappingProxyType` can be used to create a read-only view of " +"a :class:`dict`." +msgstr "" + +msgid "" +"For detailed information on thread-safety guarantees for :class:`dict` " +"objects, see :ref:`thread-safety-dict`." +msgstr "" + +msgid "Dictionary view objects" +msgstr "" + +msgid "" +"The objects returned by :meth:`dict.keys`, :meth:`dict.values` " +"and :meth:`dict.items` are *view objects*. They provide a dynamic view on " +"the dictionary's entries, which means that when the dictionary changes, the " +"view reflects these changes." +msgstr "" + +msgid "" +"Dictionary views can be iterated over to yield their respective data, and " +"support membership tests:" +msgstr "" + +msgid "Return the number of entries in the dictionary." +msgstr "" + +msgid "" +"Return an iterator over the keys, values or items (represented as tuples of " +"``(key, value)``) in the dictionary." +msgstr "" + +msgid "" +"Keys and values are iterated over in insertion order. This allows the " +"creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = " +"zip(d.values(), d.keys())``. Another way to create the same list is ``pairs " +"= [(v, k) for (k, v) in d.items()]``." +msgstr "" + +msgid "" +"Iterating views while adding or deleting entries in the dictionary may raise " +"a :exc:`RuntimeError` or fail to iterate over all entries." +msgstr "" + +msgid "Dictionary order is guaranteed to be insertion order." +msgstr "" + +msgid "" +"Return ``True`` if *x* is in the underlying dictionary's keys, values or " +"items (in the latter case, *x* should be a ``(key, value)`` tuple)." +msgstr "" + +msgid "" +"Return a reverse iterator over the keys, values or items of the dictionary. " +"The view will be iterated in reverse order of the insertion." +msgstr "" + +msgid "Dictionary views are now reversible." +msgstr "" + +msgid "" +"Return a :class:`types.MappingProxyType` that wraps the original dictionary " +"to which the view refers." +msgstr "" + +msgid "" +"Keys views are set-like since their entries are unique and :term:`hashable`. " +"Items views also have set-like operations since the (key, value) pairs are " +"unique and the keys are hashable. If all values in an items view are " +"hashable as well, then the items view can interoperate with other sets. " +"(Values views are not treated as set-like since the entries are generally " +"not unique.) For set-like views, all of the operations defined for the " +"abstract base class :class:`collections.abc.Set` are available (for example, " +"``==``, ``<``, or ``^``). While using set operators, set-like views accept " +"any iterable as the other operand, unlike sets which only accept sets as the " +"input." +msgstr "" + +msgid "An example of dictionary view usage::" +msgstr "" + +msgid "" +">>> dishes = {'eggs': 2, 'sausage': 1, 'bacon': 1, 'spam': 500}\n" +">>> keys = dishes.keys()\n" +">>> values = dishes.values()\n" +"\n" +">>> # iteration\n" +">>> n = 0\n" +">>> for val in values:\n" +"... n += val\n" +"...\n" +">>> print(n)\n" +"504\n" +"\n" +">>> # keys and values are iterated over in the same order (insertion order)\n" +">>> list(keys)\n" +"['eggs', 'sausage', 'bacon', 'spam']\n" +">>> list(values)\n" +"[2, 1, 1, 500]\n" +"\n" +">>> # view objects are dynamic and reflect dict changes\n" +">>> del dishes['eggs']\n" +">>> del dishes['sausage']\n" +">>> list(keys)\n" +"['bacon', 'spam']\n" +"\n" +">>> # set operations\n" +">>> keys & {'eggs', 'bacon', 'salad'}\n" +"{'bacon'}\n" +">>> keys ^ {'sausage', 'juice'} == {'juice', 'sausage', 'bacon', 'spam'}\n" +"True\n" +">>> keys | ['juice', 'juice', 'juice'] == {'bacon', 'spam', 'juice'}\n" +"True\n" +"\n" +">>> # get back a read-only proxy for the original dictionary\n" +">>> values.mapping\n" +"mappingproxy({'bacon': 1, 'spam': 500})\n" +">>> values.mapping['spam']\n" +"500" +msgstr "" + +msgid "Context Manager Types" +msgstr "" + +msgid "" +"Python's :keyword:`with` statement supports the concept of a runtime context " +"defined by a context manager. This is implemented using a pair of methods " +"that allow user-defined classes to define a runtime context that is entered " +"before the statement body is executed and exited when the statement ends:" +msgstr "" + +msgid "" +"Enter the runtime context and return either this object or another object " +"related to the runtime context. The value returned by this method is bound " +"to the identifier in the :keyword:`!as` clause of :keyword:`with` statements " +"using this context manager." +msgstr "" + +msgid "" +"An example of a context manager that returns itself is a :term:`file " +"object`. File objects return themselves from __enter__() to " +"allow :func:`open` to be used as the context expression in a :keyword:`with` " +"statement." +msgstr "" + +msgid "" +"An example of a context manager that returns a related object is the one " +"returned by :func:`decimal.localcontext`. These managers set the active " +"decimal context to a copy of the original decimal context and then return " +"the copy. This allows changes to be made to the current decimal context in " +"the body of the :keyword:`with` statement without affecting code outside " +"the :keyword:`!with` statement." +msgstr "" + +msgid "" +"Exit the runtime context and return a Boolean flag indicating if any " +"exception that occurred should be suppressed. If an exception occurred while " +"executing the body of the :keyword:`with` statement, the arguments contain " +"the exception type, value and traceback information. Otherwise, all three " +"arguments are ``None``." +msgstr "" + +msgid "" +"Returning a true value from this method will cause the :keyword:`with` " +"statement to suppress the exception and continue execution with the " +"statement immediately following the :keyword:`!with` statement. Otherwise " +"the exception continues propagating after this method has finished executing." +msgstr "" + +msgid "" +"If this method raises an exception while handling an earlier exception from " +"the :keyword:`with` block, the new exception is raised, and the original " +"exception is stored in its :attr:`~BaseException.__context__` attribute." +msgstr "" + +msgid "" +"The exception passed in should never be reraised explicitly - instead, this " +"method should return a false value to indicate that the method completed " +"successfully and does not want to suppress the raised exception. This allows " +"context management code to easily detect whether or not " +"an :meth:`~object.__exit__` method has actually failed." +msgstr "" + +msgid "" +"Python defines several context managers to support easy thread " +"synchronisation, prompt closure of files or other objects, and simpler " +"manipulation of the active decimal arithmetic context. The specific types " +"are not treated specially beyond their implementation of the context " +"management protocol. See the :mod:`contextlib` module for some examples." +msgstr "" + +msgid "" +"Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " +"decorator provide a convenient way to implement these protocols. If a " +"generator function is decorated with the :class:`contextlib.contextmanager` " +"decorator, it will return a context manager implementing the " +"necessary :meth:`~contextmanager.__enter__` " +"and :meth:`~contextmanager.__exit__` methods, rather than the iterator " +"produced by an undecorated generator function." +msgstr "" + +msgid "" +"Note that there is no specific slot for any of these methods in the type " +"structure for Python objects in the Python/C API. Extension types wanting to " +"define these methods must provide them as a normal Python accessible method. " +"Compared to the overhead of setting up the runtime context, the overhead of " +"a single class dictionary lookup is negligible." +msgstr "" + +msgid "" +"Type Annotation Types --- :ref:`Generic Alias `, :ref:`Union `" +msgstr "" + +msgid "" +"The core built-in types for :term:`type annotations ` " +"are :ref:`Generic Alias ` and :ref:`Union `." +msgstr "" + +msgid "Generic Alias Type" +msgstr "" + +msgid "" +"``GenericAlias`` objects are generally created by :ref:`subscripting " +"` a class. They are most often used with :ref:`container " +"classes `, such as :class:`list` or :class:`dict`. For " +"example, ``list[int]`` is a ``GenericAlias`` object created by subscripting " +"the ``list`` class with the argument :class:`int`. ``GenericAlias`` objects " +"are intended primarily for use with :term:`type annotations `." +msgstr "" + +msgid "" +"It is generally only possible to subscript a class if the class implements " +"the special method :meth:`~object.__class_getitem__`." +msgstr "" + +msgid "" +"A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " +"implementing *parameterized generics*." +msgstr "" + +msgid "" +"For a container class, the argument(s) supplied to a :ref:`subscription " +"` of the class may indicate the type(s) of the elements an " +"object contains. For example, ``set[bytes]`` can be used in type annotations " +"to signify a :class:`set` in which all the elements are of " +"type :class:`bytes`." +msgstr "" + +msgid "" +"For a class which defines :meth:`~object.__class_getitem__` but is not a " +"container, the argument(s) supplied to a subscription of the class will " +"often indicate the return type(s) of one or more methods defined on an " +"object. For example, :mod:`regular expressions ` can be used on both " +"the :class:`str` data type and the :class:`bytes` data type:" +msgstr "" + +msgid "" +"If ``x = re.search('foo', 'foo')``, ``x`` will be a :ref:`re.Match ` object where the return values of ``x.group(0)`` and ``x[0]`` will " +"both be of type :class:`str`. We can represent this kind of object in type " +"annotations with the ``GenericAlias`` ``re.Match[str]``." +msgstr "" + +msgid "" +"If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " +"``y`` will also be an instance of ``re.Match``, but the return values of " +"``y.group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " +"annotations, we would represent this variety of :ref:`re.Match ` objects with ``re.Match[bytes]``." +msgstr "" + +msgid "" +"``GenericAlias`` objects are instances of the " +"class :class:`types.GenericAlias`, which can also be used to create " +"``GenericAlias`` objects directly. Specializations of user-" +"defined :ref:`generic classes ` may not be instances " +"of :class:`types.GenericAlias`, but they provide similar functionality." +msgstr "" + +msgid "" +"Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " +"*X*, *Y*, and more depending on the ``T`` used. For example, a function " +"expecting a :class:`list` containing :class:`float` elements::" +msgstr "" + +msgid "" +"def average(values: list[float]) -> float:\n" +" return sum(values) / len(values)" +msgstr "" + +msgid "" +"Another example for :term:`mapping` objects, using a :class:`dict`, which is " +"a generic type expecting two type parameters representing the key type and " +"the value type. In this example, the function expects a ``dict`` with keys " +"of type :class:`str` and values of type :class:`int`::" +msgstr "" + +msgid "" +"def send_post_request(url: str, body: dict[str, int]) -> None:\n" +" ..." +msgstr "" + +msgid "" +"The builtin functions :func:`isinstance` and :func:`issubclass` do not " +"accept ``GenericAlias`` types for their second argument::" +msgstr "" + +msgid "" +">>> isinstance([1, 2], list[str])\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: isinstance() argument 2 cannot be a parameterized generic" +msgstr "" + +msgid "" +"The Python runtime does not enforce :term:`type annotations `. " +"This extends to generic types and their type parameters. When creating a " +"container object from a ``GenericAlias``, the elements in the container are " +"not checked against their type. For example, the following code is " +"discouraged, but will run without errors::" +msgstr "" + +msgid "" +">>> t = list[str]\n" +">>> t([1, 2, 3])\n" +"[1, 2, 3]" +msgstr "" +">>> t = list[str]\n" +">>> t([1, 2, 3])\n" +"[1, 2, 3]" + +msgid "" +"Furthermore, parameterized generics erase type parameters during object " +"creation::" +msgstr "" + +msgid "" +">>> t = list[str]\n" +">>> type(t)\n" +"\n" +"\n" +">>> l = t()\n" +">>> type(l)\n" +"" +msgstr "" + +msgid "" +"Instances of ``GenericAlias`` are not classes at runtime, even though they " +"behave like classes (they can be instantiated and subclassed)::" +msgstr "" + +msgid "" +">>> import inspect\n" +">>> inspect.isclass(list[int])\n" +"False" +msgstr "" + +msgid "" +"This is true for :ref:`user-defined generics ` also." +msgstr "" + +msgid "" +"Calling :func:`repr` or :func:`str` on a generic shows the parameterized " +"type::" +msgstr "" + +msgid "" +">>> repr(list[int])\n" +"'list[int]'\n" +"\n" +">>> str(list[int])\n" +"'list[int]'" +msgstr "" +">>> repr(list[int])\n" +"'list[int]'\n" +"\n" +">>> str(list[int])\n" +"'list[int]'" + +msgid "" +"The :meth:`~object.__getitem__` method of generic containers will raise an " +"exception to disallow mistakes like ``dict[str][str]``::" +msgstr "" + +msgid "" +">>> dict[str][str]\n" +"Traceback (most recent call last):\n" +" ...\n" +"TypeError: dict[str] is not a generic class" +msgstr "" + +msgid "" +"However, such expressions are valid when :ref:`type variables ` " +"are used. The index must have as many elements as there are type variable " +"items in the ``GenericAlias`` object's :attr:`~genericalias.__args__`. ::" +msgstr "" + +msgid "" +">>> from typing import TypeVar\n" +">>> Y = TypeVar('Y')\n" +">>> dict[str, Y][int]\n" +"dict[str, int]" +msgstr "" + +msgid "Standard Generic Classes" +msgstr "" + +msgid "" +"The following standard library classes support parameterized generics. This " +"list is non-exhaustive." +msgstr "" + +msgid ":class:`tuple`" +msgstr ":class:`tuple`" + +msgid ":class:`list`" +msgstr ":class:`list`" + +msgid ":class:`dict`" +msgstr ":class:`dict`" + +msgid ":class:`set`" +msgstr ":class:`set`" + +msgid ":class:`frozenset`" +msgstr ":class:`frozenset`" + +msgid ":class:`type`" +msgstr ":class:`type`" + +msgid ":class:`asyncio.Future`" +msgstr ":class:`asyncio.Future`" + +msgid ":class:`asyncio.Task`" +msgstr ":class:`asyncio.Task`" + +msgid ":class:`collections.deque`" +msgstr ":class:`collections.deque`" + +msgid ":class:`collections.defaultdict`" +msgstr ":class:`collections.defaultdict`" + +msgid ":class:`collections.OrderedDict`" +msgstr ":class:`collections.OrderedDict`" + +msgid ":class:`collections.Counter`" +msgstr ":class:`collections.Counter`" + +msgid ":class:`collections.ChainMap`" +msgstr ":class:`collections.ChainMap`" + +msgid ":class:`collections.abc.Awaitable`" +msgstr ":class:`collections.abc.Awaitable`" + +msgid ":class:`collections.abc.Coroutine`" +msgstr ":class:`collections.abc.Coroutine`" + +msgid ":class:`collections.abc.AsyncIterable`" +msgstr ":class:`collections.abc.AsyncIterable`" + +msgid ":class:`collections.abc.AsyncIterator`" +msgstr ":class:`collections.abc.AsyncIterator`" + +msgid ":class:`collections.abc.AsyncGenerator`" +msgstr ":class:`collections.abc.AsyncGenerator`" + +msgid ":class:`collections.abc.Iterable`" +msgstr ":class:`collections.abc.Iterable`" + +msgid ":class:`collections.abc.Iterator`" +msgstr ":class:`collections.abc.Iterator`" + +msgid ":class:`collections.abc.Generator`" +msgstr ":class:`collections.abc.Generator`" + +msgid ":class:`collections.abc.Reversible`" +msgstr ":class:`collections.abc.Reversible`" + +msgid ":class:`collections.abc.Container`" +msgstr ":class:`collections.abc.Container`" + +msgid ":class:`collections.abc.Collection`" +msgstr ":class:`collections.abc.Collection`" + +msgid ":class:`collections.abc.Callable`" +msgstr ":class:`collections.abc.Callable`" + +msgid ":class:`collections.abc.Set`" +msgstr ":class:`collections.abc.Set`" + +msgid ":class:`collections.abc.MutableSet`" +msgstr ":class:`collections.abc.MutableSet`" + +msgid ":class:`collections.abc.Mapping`" +msgstr ":class:`collections.abc.Mapping`" + +msgid ":class:`collections.abc.MutableMapping`" +msgstr ":class:`collections.abc.MutableMapping`" + +msgid ":class:`collections.abc.Sequence`" +msgstr ":class:`collections.abc.Sequence`" + +msgid ":class:`collections.abc.MutableSequence`" +msgstr ":class:`collections.abc.MutableSequence`" + +msgid ":class:`collections.abc.ByteString`" +msgstr ":class:`collections.abc.ByteString`" + +msgid ":class:`collections.abc.MappingView`" +msgstr ":class:`collections.abc.MappingView`" + +msgid ":class:`collections.abc.KeysView`" +msgstr ":class:`collections.abc.KeysView`" + +msgid ":class:`collections.abc.ItemsView`" +msgstr ":class:`collections.abc.ItemsView`" + +msgid ":class:`collections.abc.ValuesView`" +msgstr ":class:`collections.abc.ValuesView`" + +msgid ":class:`contextlib.AbstractContextManager`" +msgstr ":class:`contextlib.AbstractContextManager`" + +msgid ":class:`contextlib.AbstractAsyncContextManager`" +msgstr ":class:`contextlib.AbstractAsyncContextManager`" + +msgid ":class:`dataclasses.Field`" +msgstr ":class:`dataclasses.Field`" + +msgid ":class:`functools.cached_property`" +msgstr ":class:`functools.cached_property`" + +msgid ":class:`functools.partialmethod`" +msgstr ":class:`functools.partialmethod`" + +msgid ":class:`os.PathLike`" +msgstr ":class:`os.PathLike`" + +msgid ":class:`queue.LifoQueue`" +msgstr ":class:`queue.LifoQueue`" + +msgid ":class:`queue.Queue`" +msgstr ":class:`queue.Queue`" + +msgid ":class:`queue.PriorityQueue`" +msgstr ":class:`queue.PriorityQueue`" + +msgid ":class:`queue.SimpleQueue`" +msgstr ":class:`queue.SimpleQueue`" + +msgid ":ref:`re.Pattern `" +msgstr "" + +msgid ":ref:`re.Match `" +msgstr "" + +msgid ":class:`shelve.BsdDbShelf`" +msgstr ":class:`shelve.BsdDbShelf`" + +msgid ":class:`shelve.DbfilenameShelf`" +msgstr ":class:`shelve.DbfilenameShelf`" + +msgid ":class:`shelve.Shelf`" +msgstr ":class:`shelve.Shelf`" + +msgid ":class:`types.MappingProxyType`" +msgstr ":class:`types.MappingProxyType`" + +msgid ":class:`weakref.WeakKeyDictionary`" +msgstr ":class:`weakref.WeakKeyDictionary`" + +msgid ":class:`weakref.WeakMethod`" +msgstr ":class:`weakref.WeakMethod`" + +msgid ":class:`weakref.WeakSet`" +msgstr ":class:`weakref.WeakSet`" + +msgid ":class:`weakref.WeakValueDictionary`" +msgstr ":class:`weakref.WeakValueDictionary`" + +msgid "Special Attributes of ``GenericAlias`` objects" +msgstr "" + +msgid "All parameterized generics implement special read-only attributes." +msgstr "" + +msgid "This attribute points at the non-parameterized generic class::" +msgstr "" + +msgid "" +">>> list[int].__origin__\n" +"" +msgstr "" +">>> list[int].__origin__\n" +"" + +msgid "" +"This attribute is a :class:`tuple` (possibly of length 1) of generic types " +"passed to the original :meth:`~object.__class_getitem__` of the generic " +"class::" +msgstr "" + +msgid "" +">>> dict[str, list[int]].__args__\n" +"(, list[int])" +msgstr "" +">>> dict[str, list[int]].__args__\n" +"(, list[int])" + +msgid "" +"This attribute is a lazily computed tuple (possibly empty) of unique type " +"variables found in ``__args__``::" +msgstr "" + +msgid "" +">>> from typing import TypeVar\n" +"\n" +">>> T = TypeVar('T')\n" +">>> list[T].__parameters__\n" +"(~T,)" +msgstr "" +">>> from typing import TypeVar\n" +"\n" +">>> T = TypeVar('T')\n" +">>> list[T].__parameters__\n" +"(~T,)" + +msgid "" +"A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " +"have correct ``__parameters__`` after substitution " +"because :class:`typing.ParamSpec` is intended primarily for static type " +"checking." +msgstr "" + +msgid "" +"A boolean that is true if the alias has been unpacked using the ``*`` " +"operator (see :data:`~typing.TypeVarTuple`)." +msgstr "" + +msgid ":pep:`484` - Type Hints" +msgstr "" + +msgid "Introducing Python's framework for type annotations." +msgstr "" + +msgid ":pep:`585` - Type Hinting Generics In Standard Collections" +msgstr "" + +msgid "" +"Introducing the ability to natively parameterize standard-library classes, " +"provided they implement the special class " +"method :meth:`~object.__class_getitem__`." +msgstr "" + +msgid "" +":ref:`Generics`, :ref:`user-defined generics ` " +"and :class:`typing.Generic`" +msgstr "" + +msgid "" +"Documentation on how to implement generic classes that can be parameterized " +"at runtime and understood by static type-checkers." +msgstr "" + +msgid "Union Type" +msgstr "" + +msgid "" +"A union object holds the value of the ``|`` (bitwise or) operation on " +"multiple :ref:`type objects `. These types are intended " +"primarily for :term:`type annotations `. The union type " +"expression enables cleaner type hinting syntax compared to " +"subscripting :class:`typing.Union`." +msgstr "" + +msgid "" +"Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " +"means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " +"example, the following function expects an argument of type :class:`int` " +"or :class:`float`::" +msgstr "" + +msgid "" +"def square(number: int | float) -> int | float:\n" +" return number ** 2" +msgstr "" + +msgid "" +"The ``|`` operator cannot be used at runtime to define unions where one or " +"more members is a forward reference. For example, ``int | \"Foo\"``, where " +"``\"Foo\"`` is a reference to a class not yet defined, will fail at runtime. " +"For unions which include forward references, present the whole expression as " +"a string, e.g. ``\"int | Foo\"``." +msgstr "" + +msgid "" +"Union objects can be tested for equality with other union objects. Details:" +msgstr "" + +msgid "Unions of unions are flattened::" +msgstr "" + +msgid "(int | str) | float == int | str | float" +msgstr "" + +msgid "Redundant types are removed::" +msgstr "" + +msgid "int | str | int == int | str" +msgstr "int | str | int == int | str" + +msgid "When comparing unions, the order is ignored::" +msgstr "" + +msgid "int | str == str | int" +msgstr "int | str == str | int" + +msgid "It creates instances of :class:`typing.Union`::" +msgstr "" + +msgid "" +"int | str == typing.Union[int, str]\n" +"type(int | str) is typing.Union" +msgstr "" + +msgid "Optional types can be spelled as a union with ``None``::" +msgstr "" + +msgid "str | None == typing.Optional[str]" +msgstr "str | None == typing.Optional[str]" + +msgid "" +"Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " +"union object::" +msgstr "" + +msgid "" +">>> isinstance(\"\", int | str)\n" +"True" +msgstr "" +">>> isinstance(\"\", int | str)\n" +"True" + +msgid "" +"However, :ref:`parameterized generics ` in union objects " +"cannot be checked::" +msgstr "" + +msgid "" +">>> isinstance(1, int | list[int]) # short-circuit evaluation\n" +"True\n" +">>> isinstance([1], int | list[int])\n" +"Traceback (most recent call last):\n" +" ...\n" +"TypeError: isinstance() argument 2 cannot be a parameterized generic" +msgstr "" + +msgid "" +"The user-exposed type for the union object can be accessed " +"from :class:`typing.Union` and used for :func:`isinstance` checks::" +msgstr "" + +msgid "" +">>> import typing\n" +">>> isinstance(int | str, typing.Union)\n" +"True\n" +">>> typing.Union()\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: cannot create 'typing.Union' instances" +msgstr "" + +msgid "" +"The :meth:`!__or__` method for type objects was added to support the syntax " +"``X | Y``. If a metaclass implements :meth:`!__or__`, the Union may " +"override it:" +msgstr "" + +msgid "" +">>> class M(type):\n" +"... def __or__(self, other):\n" +"... return \"Hello\"\n" +"...\n" +">>> class C(metaclass=M):\n" +"... pass\n" +"...\n" +">>> C | int\n" +"'Hello'\n" +">>> int | C\n" +"int | C" +msgstr "" + +msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." +msgstr "" + +msgid "" +"Union objects are now instances of :class:`typing.Union`. Previously, they " +"were instances of :class:`types.UnionType`, which remains an alias " +"for :class:`typing.Union`." +msgstr "" + +msgid "Other Built-in Types" +msgstr "" + +msgid "" +"The interpreter supports several other kinds of objects. Most of these " +"support only one or two operations." +msgstr "" + +msgid "Modules" +msgstr "Moduły" + +msgid "" +"The only special operation on a module is attribute access: ``m.name``, " +"where *m* is a module and *name* accesses a name defined in *m*'s symbol " +"table. Module attributes can be assigned to. (Note that " +"the :keyword:`import` statement is not, strictly speaking, an operation on a " +"module object; ``import foo`` does not require a module object named *foo* " +"to exist, rather it requires an (external) *definition* for a module named " +"*foo* somewhere.)" +msgstr "" + +msgid "" +"A special attribute of every module is :attr:`~object.__dict__`. This is the " +"dictionary containing the module's symbol table. Modifying this dictionary " +"will actually change the module's symbol table, but direct assignment to " +"the :attr:`~object.__dict__` attribute is not possible (you can write " +"``m.__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't " +"write ``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is " +"not recommended." +msgstr "" + +msgid "" +"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." +msgstr "" + +msgid "Classes and Class Instances" +msgstr "" + +msgid "See :ref:`objects` and :ref:`class` for these." +msgstr "" + +msgid "Functions" +msgstr "Zadania" + +msgid "" +"Function objects are created by function definitions. The only operation on " +"a function object is to call it: ``func(argument-list)``." +msgstr "" + +msgid "" +"There are really two flavors of function objects: built-in functions and " +"user-defined functions. Both support the same operation (to call the " +"function), but the implementation is different, hence the different object " +"types." +msgstr "" + +msgid "See :ref:`function` for more information." +msgstr "" + +msgid "Methods" +msgstr "" + +msgid "" +"Methods are functions that are called using the attribute notation. There " +"are two flavors: :ref:`built-in methods ` (such " +"as :meth:`~list.append` on lists) and :ref:`class instance methods `. Built-in methods are described with the types that support them." +msgstr "" + +msgid "" +"If you access a method (a function defined in a class namespace) through an " +"instance, you get a special object: a :dfn:`bound method` (also " +"called :ref:`instance method `) object. When called, it " +"will add the ``self`` argument to the argument list. Bound methods have two " +"special read-only attributes: :attr:`m.__self__ ` is the " +"object on which the method operates, and :attr:`m.__func__ " +"` is the function implementing the method. Calling " +"``m(arg-1, arg-2, ..., arg-n)`` is completely equivalent to calling " +"``m.__func__(m.__self__, arg-1, arg-2, ..., arg-n)``." +msgstr "" + +msgid "" +"Like :ref:`function objects `, bound method objects " +"support getting arbitrary attributes. However, since method attributes are " +"actually stored on the underlying function object (:attr:`method.__func__`), " +"setting method attributes on bound methods is disallowed. Attempting to set " +"an attribute on a method results in an :exc:`AttributeError` being raised. " +"In order to set a method attribute, you need to explicitly set it on the " +"underlying function object:" +msgstr "" + +msgid "" +">>> class C:\n" +"... def method(self):\n" +"... pass\n" +"...\n" +">>> c = C()\n" +">>> c.method.whoami = 'my name is method' # can't set on the method\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"AttributeError: 'method' object has no attribute 'whoami'\n" +">>> c.method.__func__.whoami = 'my name is method'\n" +">>> c.method.whoami\n" +"'my name is method'" +msgstr "" + +msgid "See :ref:`instance-methods` for more information." +msgstr "" + +msgid "Code Objects" +msgstr "" + +msgid "" +"Code objects are used by the implementation to represent \"pseudo-compiled\" " +"executable Python code such as a function body. They differ from function " +"objects because they don't contain a reference to their global execution " +"environment. Code objects are returned by the built-in :func:`compile` " +"function and can be extracted from function objects through " +"their :attr:`~function.__code__` attribute. See also the :mod:`code` module." +msgstr "" + +msgid "" +"Accessing :attr:`~function.__code__` raises an :ref:`auditing event " +"` ``object.__getattr__`` with arguments ``obj`` and " +"``\"__code__\"``." +msgstr "" + +msgid "" +"A code object can be executed or evaluated by passing it (instead of a " +"source string) to the :func:`exec` or :func:`eval` built-in functions." +msgstr "" + +msgid "See :ref:`types` for more information." +msgstr "" + +msgid "Type Objects" +msgstr "" + +msgid "" +"Type objects represent the various object types. An object's type is " +"accessed by the built-in function :func:`type`. There are no special " +"operations on types. The standard module :mod:`types` defines names for all " +"standard built-in types." +msgstr "" + +msgid "Types are written like this: ````." +msgstr "" + +msgid "The Null Object" +msgstr "" + +msgid "" +"This object is returned by functions that don't explicitly return a value. " +"It supports no special operations. There is exactly one null object, named " +"``None`` (a built-in name). ``type(None)()`` produces the same singleton." +msgstr "" + +msgid "It is written as ``None``." +msgstr "" + +msgid "The Ellipsis Object" +msgstr "" + +msgid "" +"This object is commonly used to indicate that something is omitted. It " +"supports no special operations. There is exactly one ellipsis object, " +"named :const:`Ellipsis` (a built-in name). ``type(Ellipsis)()`` produces " +"the :const:`Ellipsis` singleton." +msgstr "" + +msgid "It is written as ``Ellipsis`` or ``...``." +msgstr "" + +msgid "" +"In typical use, ``...`` as the ``Ellipsis`` object appears in a few " +"different places, for instance:" +msgstr "" + +msgid "" +"In type annotations, such as :ref:`callable arguments ` or :ref:`tuple elements `." +msgstr "" + +msgid "" +"As the body of a function instead of a :ref:`pass statement `." +msgstr "" + +msgid "" +"In third-party libraries, such as `Numpy's slicing and striding `_." +msgstr "" + +msgid "" +"Python also uses three dots in ways that are not ``Ellipsis`` objects, for " +"instance:" +msgstr "" + +msgid "" +"Doctest's :const:`ELLIPSIS `, as a pattern for missing " +"content." +msgstr "" + +msgid "" +"The default Python prompt of the :term:`interactive` shell when partial " +"input is incomplete." +msgstr "" + +msgid "" +"Lastly, the Python documentation often uses three dots in conventional " +"English usage to mean omitted content, even in code examples that also use " +"them as the ``Ellipsis``." +msgstr "" + +msgid "The NotImplemented Object" +msgstr "" + +msgid "" +"This object is returned from comparisons and binary operations when they are " +"asked to operate on types they don't support. See :ref:`comparisons` for " +"more information. There is exactly one :data:`NotImplemented` " +"object. :code:`type(NotImplemented)()` produces the singleton instance." +msgstr "" + +msgid "It is written as :code:`NotImplemented`." +msgstr "" + +msgid "Internal Objects" +msgstr "" + +msgid "" +"See :ref:`types` for this information. It describes :ref:`stack frame " +"objects `, :ref:`traceback objects `, and " +"slice objects." +msgstr "" + +msgid "Special Attributes" +msgstr "" + +msgid "" +"The implementation adds a few special read-only attributes to several object " +"types, where they are relevant. Some of these are not reported by " +"the :func:`dir` built-in function." +msgstr "" + +msgid "" +"The name of the class, function, method, descriptor, or generator instance." +msgstr "" + +msgid "" +"The :term:`qualified name` of the class, function, method, descriptor, or " +"generator instance." +msgstr "" + +msgid "The name of the module in which a class or function was defined." +msgstr "" + +msgid "" +"The documentation string of a class or function, or ``None`` if undefined." +msgstr "" + +msgid "" +"The :ref:`type parameters ` of generic classes, functions, " +"and :ref:`type aliases `. For classes and functions that are " +"not generic, this will be an empty tuple." +msgstr "" + +msgid "Integer string conversion length limitation" +msgstr "" + +msgid "" +"CPython has a global limit for converting between :class:`int` " +"and :class:`str` to mitigate denial of service attacks. This limit *only* " +"applies to decimal or other non-power-of-two number bases. Hexadecimal, " +"octal, and binary conversions are unlimited. The limit can be configured." +msgstr "" + +msgid "" +"The :class:`int` type in CPython is an arbitrary length number stored in " +"binary form (commonly known as a \"bignum\"). There exists no algorithm that " +"can convert a string to a binary integer or a binary integer to a string in " +"linear time, *unless* the base is a power of 2. Even the best known " +"algorithms for base 10 have sub-quadratic complexity. Converting a large " +"value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." +msgstr "" + +msgid "" +"Limiting conversion size offers a practical way to avoid :cve:`2020-10735`." +msgstr "" + +msgid "" +"The limit is applied to the number of digit characters in the input or " +"output string when a non-linear conversion algorithm would be involved. " +"Underscores and the sign are not counted towards the limit." +msgstr "" + +msgid "" +"When an operation would exceed the limit, a :exc:`ValueError` is raised:" +msgstr "" + +msgid "" +">>> import sys\n" +">>> sys.set_int_max_str_digits(4300) # Illustrative, this is the default.\n" +">>> _ = int('2' * 5432)\n" +"Traceback (most recent call last):\n" +"...\n" +"ValueError: Exceeds the limit (4300 digits) for integer string conversion: " +"value has 5432 digits; use sys.set_int_max_str_digits() to increase the " +"limit\n" +">>> i = int('2' * 4300)\n" +">>> len(str(i))\n" +"4300\n" +">>> i_squared = i*i\n" +">>> len(str(i_squared))\n" +"Traceback (most recent call last):\n" +"...\n" +"ValueError: Exceeds the limit (4300 digits) for integer string conversion; " +"use sys.set_int_max_str_digits() to increase the limit\n" +">>> len(hex(i_squared))\n" +"7144\n" +">>> assert int(hex(i_squared), base=16) == i*i # Hexadecimal is unlimited." +msgstr "" + +msgid "" +"The default limit is 4300 digits as provided " +"in :data:`sys.int_info.default_max_str_digits `. The lowest " +"limit that can be configured is 640 digits as provided " +"in :data:`sys.int_info.str_digits_check_threshold `." +msgstr "" + +msgid "Verification:" +msgstr "" + +msgid "" +">>> import sys\n" +">>> assert sys.int_info.default_max_str_digits == 4300, sys.int_info\n" +">>> assert sys.int_info.str_digits_check_threshold == 640, sys.int_info\n" +">>> msg = int('578966293710682886880994035146873798396722250538762761564'\n" +"... '9252925514383915483333812743580549779436104706260696366600'\n" +"... '571186405732').to_bytes(53, 'big')\n" +"..." +msgstr "" + +msgid "Affected APIs" +msgstr "" + +msgid "" +"The limitation only applies to potentially slow conversions " +"between :class:`int` and :class:`str` or :class:`bytes`:" +msgstr "" + +msgid "``int(string)`` with default base 10." +msgstr "" + +msgid "``int(string, base)`` for all bases that are not a power of 2." +msgstr "" + +msgid "``str(integer)``." +msgstr "``str(integer)``." + +msgid "``repr(integer)``." +msgstr "``repr(integer)``." + +msgid "" +"any other string conversion to base 10, for example ``f\"{integer}\"``, " +"``\"{}\".format(integer)``, or ``b\"%d\" % integer``." +msgstr "" + +msgid "The limitations do not apply to functions with a linear algorithm:" +msgstr "" + +msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." +msgstr "" + +msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." +msgstr "" + +msgid ":func:`hex`, :func:`oct`, :func:`bin`." +msgstr ":func:`hex`, :func:`oct`, :func:`bin`." + +msgid ":ref:`formatspec` for hex, octal, and binary numbers." +msgstr "" + +msgid ":class:`str` to :class:`float`." +msgstr "" + +msgid ":class:`str` to :class:`decimal.Decimal`." +msgstr "" + +msgid "Configuring the limit" +msgstr "" + +msgid "" +"Before Python starts up you can use an environment variable or an " +"interpreter command line flag to configure the limit:" +msgstr "" + +msgid "" +":envvar:`PYTHONINTMAXSTRDIGITS`, e.g. ``PYTHONINTMAXSTRDIGITS=640 python3`` " +"to set the limit to 640 or ``PYTHONINTMAXSTRDIGITS=0 python3`` to disable " +"the limitation." +msgstr "" + +msgid "" +":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " +"int_max_str_digits=640``" +msgstr "" + +msgid "" +":data:`sys.flags.int_max_str_digits` contains the value " +"of :envvar:`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. " +"If both the env var and the ``-X`` option are set, the ``-X`` option takes " +"precedence. A value of *-1* indicates that both were unset, thus a value " +"of :data:`sys.int_info.default_max_str_digits` was used during " +"initialization." +msgstr "" + +msgid "" +"From code, you can inspect the current limit and set a new one using " +"these :mod:`sys` APIs:" +msgstr "" + +msgid "" +":func:`sys.get_int_max_str_digits` and :func:`sys.set_int_max_str_digits` " +"are a getter and setter for the interpreter-wide limit. Subinterpreters have " +"their own limit." +msgstr "" + +msgid "" +"Information about the default and minimum can be found " +"in :data:`sys.int_info`:" +msgstr "" + +msgid "" +":data:`sys.int_info.default_max_str_digits ` is the compiled-" +"in default limit." +msgstr "" + +msgid "" +":data:`sys.int_info.str_digits_check_threshold ` is the lowest " +"accepted value for the limit (other than 0 which disables it)." +msgstr "" + +msgid "" +"Setting a low limit *can* lead to problems. While rare, code exists that " +"contains integer constants in decimal in their source that exceed the " +"minimum threshold. A consequence of setting the limit is that Python source " +"code containing decimal integer literals longer than the limit will " +"encounter an error during parsing, usually at startup time or import time or " +"even at installation time - anytime an up to date ``.pyc`` does not already " +"exist for the code. A workaround for source that contains such large " +"constants is to convert them to ``0x`` hexadecimal form as it has no limit." +msgstr "" + +msgid "" +"Test your application thoroughly if you use a low limit. Ensure your tests " +"run with the limit set early via the environment or flag so that it applies " +"during startup and even during any installation step that may invoke Python " +"to precompile ``.py`` sources to ``.pyc`` files." +msgstr "" + +msgid "Recommended configuration" +msgstr "" + +msgid "" +"The default :data:`sys.int_info.default_max_str_digits` is expected to be " +"reasonable for most applications. If your application requires a different " +"limit, set it from your main entry point using Python version agnostic code " +"as these APIs were added in security patch releases in versions before 3.12." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +">>> import sys\n" +">>> if hasattr(sys, \"set_int_max_str_digits\"):\n" +"... upper_bound = 68000\n" +"... lower_bound = 4004\n" +"... current_limit = sys.get_int_max_str_digits()\n" +"... if current_limit == 0 or current_limit > upper_bound:\n" +"... sys.set_int_max_str_digits(upper_bound)\n" +"... elif current_limit < lower_bound:\n" +"... sys.set_int_max_str_digits(lower_bound)" +msgstr "" + +msgid "If you need to disable it entirely, set it to ``0``." +msgstr "" + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +"Additional information on these special methods may be found in the Python " +"Reference Manual (:ref:`customization`)." +msgstr "" + +msgid "" +"As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " +"and similarly for tuples." +msgstr "" + +msgid "They must have since the parser can't tell the type of the operands." +msgstr "" + +msgid "" +"Cased characters are those with general category property being one of " +"\"Lu\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " +"titlecase)." +msgstr "" + +msgid "" +"To format only a tuple you should therefore provide a singleton tuple whose " +"only element is the tuple to be formatted." +msgstr "" + +msgid "built-in" +msgstr "" + +msgid "types" +msgstr "" + +msgid "statement" +msgstr "instrukcja" + +msgid "if" +msgstr "" + +msgid "while" +msgstr "" + +msgid "truth" +msgstr "" + +msgid "value" +msgstr "" + +msgid "Boolean" +msgstr "Wartość logiczna" + +msgid "operations" +msgstr "" + +msgid "false" +msgstr "" + +msgid "true" +msgstr "" + +msgid "None (Built-in object)" +msgstr "" + +msgid "False (Built-in object)" +msgstr "" + +msgid "operator" +msgstr "" + +msgid "or" +msgstr "" + +msgid "and" +msgstr "" + +msgid "False" +msgstr "" + +msgid "True" +msgstr "" + +msgid "not" +msgstr "" + +msgid "chaining" +msgstr "" + +msgid "comparisons" +msgstr "" + +msgid "comparison" +msgstr "" + +msgid "==" +msgstr "==" + +msgid "< (less)" +msgstr "" + +msgid "<=" +msgstr "" + +msgid "> (greater)" +msgstr "" + +msgid ">=" +msgstr "" + +msgid "!=" +msgstr "" + +msgid "is" +msgstr "" + +msgid "is not" +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "numeric" +msgstr "" + +msgid "objects" +msgstr "" + +msgid "comparing" +msgstr "" + +msgid "__eq__() (instance method)" +msgstr "" + +msgid "__ne__() (instance method)" +msgstr "" + +msgid "__lt__() (instance method)" +msgstr "" + +msgid "__le__() (instance method)" +msgstr "" + +msgid "__gt__() (instance method)" +msgstr "" + +msgid "__ge__() (instance method)" +msgstr "" + +msgid "in" +msgstr "" + +msgid "not in" +msgstr "" + +msgid "integer" +msgstr "" + +msgid "floating-point" +msgstr "" + +msgid "complex number" +msgstr "liczba zespolona" + +msgid "C" +msgstr "C" + +msgid "language" +msgstr "" + +msgid "literals" +msgstr "" + +msgid "hexadecimal" +msgstr "" + +msgid "octal" +msgstr "" + +msgid "binary" +msgstr "" + +msgid "arithmetic" +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "int" +msgstr "int" + +msgid "float" +msgstr "typ (float) zmiennoprzecinkowy pojedynczej precyzji" + +msgid "complex" +msgstr "" + +msgid "+ (plus)" +msgstr "" + +msgid "unary operator" +msgstr "" + +msgid "binary operator" +msgstr "" + +msgid "- (minus)" +msgstr "" + +msgid "* (asterisk)" +msgstr "* (asterysk)" + +msgid "/ (slash)" +msgstr "" + +msgid "//" +msgstr "" + +msgid "% (percent)" +msgstr "" + +msgid "**" +msgstr "**" + +msgid "operations on" +msgstr "" + +msgid "conjugate() (complex number method)" +msgstr "" + +msgid "module" +msgstr "moduł" + +msgid "math" +msgstr "" + +msgid "floor() (in module math)" +msgstr "" + +msgid "ceil() (in module math)" +msgstr "" + +msgid "trunc() (in module math)" +msgstr "" + +msgid "conversions" +msgstr "" + +msgid "bitwise" +msgstr "" + +msgid "shifting" +msgstr "" + +msgid "masking" +msgstr "" + +msgid "| (vertical bar)" +msgstr "" + +msgid "^ (caret)" +msgstr "" + +msgid "& (ampersand)" +msgstr "" + +msgid "<<" +msgstr "" + +msgid ">>" +msgstr "" + +msgid "~ (tilde)" +msgstr "" + +msgid "values" +msgstr "" + +msgid "iterator protocol" +msgstr "" + +msgid "protocol" +msgstr "" + +msgid "iterator" +msgstr "iterator" + +msgid "sequence" +msgstr "sekwencja" + +msgid "iteration" +msgstr "" + +msgid "container" +msgstr "" + +msgid "iteration over" +msgstr "" + +msgid "len" +msgstr "len" + +msgid "min" +msgstr "" + +msgid "max" +msgstr "" + +msgid "concatenation" +msgstr "" + +msgid "operation" +msgstr "" + +msgid "repetition" +msgstr "" + +msgid "subscript" +msgstr "" + +msgid "slice" +msgstr "" + +msgid "loop" +msgstr "" + +msgid "over mutable sequence" +msgstr "" + +msgid "mutable sequence" +msgstr "" + +msgid "loop over" +msgstr "" + +msgid "immutable" +msgstr "" + +msgid "tuple" +msgstr "tuple" + +msgid "hash" +msgstr "" + +msgid "mutable" +msgstr "" + +msgid "list" +msgstr "lista" + +msgid "bytearray" +msgstr "" + +msgid "type" +msgstr "typ" + +msgid "assignment" +msgstr "" + +msgid "del" +msgstr "" + +msgid "range" +msgstr "" + +msgid "string" +msgstr "ciąg znaków" + +msgid "text sequence type" +msgstr "" + +msgid "str (built-in class)" +msgstr "" + +msgid "(see also string)" +msgstr "" + +msgid "io.StringIO" +msgstr "" + +msgid "buffer protocol" +msgstr "" + +msgid "bytes" +msgstr "" + +msgid "methods" +msgstr "" + +msgid "re" +msgstr "" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "str.splitlines method" +msgstr "" + +msgid "! formatted string literal" +msgstr "" + +msgid "formatted string literals" +msgstr "" + +msgid "! f-string" +msgstr "" + +msgid "f-strings" +msgstr "" + +msgid "fstring" +msgstr "fstring" + +msgid "interpolated string literal" +msgstr "interpolowany literał ciąg znaków" + +msgid "formatted literal" +msgstr "sformatowany literał" + +msgid "interpolated literal" +msgstr "interpolowany literał" + +msgid "{} (curly brackets)" +msgstr "" + +msgid "in formatted string literal" +msgstr "" + +msgid "! (exclamation mark)" +msgstr "" + +msgid ": (colon)" +msgstr ": (dwukropek)" + +msgid "= (equals)" +msgstr "" + +msgid "for help in debugging using string literals" +msgstr "" + +msgid "formatting, string (%)" +msgstr "" + +msgid "interpolation, string (%)" +msgstr "" + +msgid "formatting, printf" +msgstr "" + +msgid "interpolation, printf" +msgstr "" + +msgid "printf-style formatting" +msgstr "" + +msgid "sprintf-style formatting" +msgstr "" + +msgid "() (parentheses)" +msgstr "" + +msgid "in printf-style formatting" +msgstr "" + +msgid ". (dot)" +msgstr "" + +msgid "# (hash)" +msgstr "# (hash)" + +msgid "space" +msgstr "" + +msgid "binary sequence types" +msgstr "" + +msgid "memoryview" +msgstr "" + +msgid "array" +msgstr "" + +msgid "bytes.splitlines method" +msgstr "" + +msgid "bytearray.splitlines method" +msgstr "" + +msgid "formatting" +msgstr "" + +msgid "bytes (%)" +msgstr "bytes (%)" + +msgid "bytearray (%)" +msgstr "" + +msgid "interpolation" +msgstr "" + +msgid "set" +msgstr "zestaw" + +msgid "mapping" +msgstr "" + +msgid "dictionary" +msgstr "słownik" + +msgid "__missing__()" +msgstr "__missing__()" + +msgid "context manager" +msgstr "" + +msgid "context management protocol" +msgstr "" + +msgid "context management" +msgstr "" + +msgid "annotation" +msgstr "adnotacja" + +msgid "type annotation; type hint" +msgstr "" + +msgid "GenericAlias" +msgstr "" + +msgid "Generic" +msgstr "" + +msgid "Alias" +msgstr "" + +msgid "Union" +msgstr "" + +msgid "union" +msgstr "" + +msgid "method" +msgstr "metoda" + +msgid "code" +msgstr "" + +msgid "code object" +msgstr "" + +msgid "compile" +msgstr "" + +msgid "__code__ (function object attribute)" +msgstr "" + +msgid "exec" +msgstr "exec" + +msgid "eval" +msgstr "" + +msgid "..." +msgstr "..." + +msgid "ellipsis literal" +msgstr "Literalny zapis wielokropka" diff --git a/builtins/time-complexity.po b/builtins/time-complexity.po new file mode 100644 index 0000000000..42a33e7bf7 --- /dev/null +++ b/builtins/time-complexity.po @@ -0,0 +1,473 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-09-13 18:06+0000\n" +"Last-Translator: python-doc bot, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Time complexity of operations on built-in types" +msgstr "" + +msgid "" +"This page documents the time complexity of various operations on built-in " +"types in CPython. Other Python implementations may have different " +"performance characteristics. Additionally, the listed costs assume exact " +"built-in types, as instances of subclasses may have different costs." +msgstr "" + +msgid "" +"We use |big O notation|_ to describe how the running time of an operation " +"grows with the size of its inputs. Unless stated otherwise, *n* denotes the " +"number of elements currently in the container, and *k* is the value of a " +"numeric parameter, such as an index or a repeat count." +msgstr "" + +msgid ":class:`!list`" +msgstr "" + +msgid "" +"Lists are mutable sequences; for more detail on the implementation " +"see :ref:`how-are-lists-implemented`. The largest costs come from growing " +"beyond the current allocation size (because everything must move), or from " +"inserting or deleting somewhere near the beginning (because everything after " +"that must move). If you need to add or remove at both ends, consider using " +"a :class:`collections.deque` instead." +msgstr "" + +msgid "Operation" +msgstr "" + +msgid "Complexity" +msgstr "" + +msgid "Copy (``l.copy()``)" +msgstr "" + +msgid "*O*\\ (*n*)" +msgstr "" + +msgid "Append (``l.append(x)``) [1]_" +msgstr "" + +msgid "*O*\\ (1)" +msgstr "" + +msgid "Pop (``l.pop(k)``) [1]_ [2]_" +msgstr "" + +msgid "*O*\\ (*n* - *k*)" +msgstr "" + +msgid "Insert (``l.insert(k, x)``) [1]_ [2]_" +msgstr "" + +msgid "Get item (``l[k]``)" +msgstr "" + +msgid "Set item (``l[k] = x``)" +msgstr "" + +msgid "Delete item (``del l[k]``) [2]_" +msgstr "" + +msgid "Iteration" +msgstr "Iteracja" + +msgid "Get slice (``l[i:j]``)" +msgstr "" + +msgid "*O*\\ (*j* - *i*)" +msgstr "" + +msgid "Set slice (``l[i:j] = t``) [1]_" +msgstr "" + +msgid "" +"*O*\\ (*j* - *i*) if len(*t*) == *j* - *i*, otherwise *O*\\ (*n* - *i* + " +"len(*t*))" +msgstr "" + +msgid "Delete slice (``del l[i:j]``)" +msgstr "" + +msgid "*O*\\ (*n* - *i*)" +msgstr "" + +msgid "Extend (``l.extend(t)``) [1]_ [3]_" +msgstr "" + +msgid "*O*\\ (len(*t*))" +msgstr "" + +msgid "Sort (``l.sort()``) [4]_" +msgstr "" + +msgid "*O*\\ (*n* log *n*)" +msgstr "" + +msgid "Concatenate (``l1 + l2``)" +msgstr "" + +msgid "*O*\\ (len(*l1*) + len(*l2*))" +msgstr "" + +msgid "Multiply (``l * k``)" +msgstr "" + +msgid "*O*\\ (*nk*)" +msgstr "" + +msgid "``x in l``" +msgstr "" + +msgid "``min(l)``, ``max(l)``" +msgstr "" + +msgid "Get length (``len(l)``) [5]_" +msgstr "" + +msgid ":class:`!tuple`" +msgstr "" + +msgid "" +"A :class:`tuple` is an :term:`immutable` sequence. Because a tuple can never " +"change, there are no insertion or deletion costs, and making a copy simply " +"returns the same object, so is constant time (*O*\\ (1))." +msgstr "" + +msgid "Copy (``tuple(t)``)" +msgstr "" + +msgid "Get item (``t[k]``)" +msgstr "" + +msgid "Get slice (``t[i:j]``)" +msgstr "" + +msgid "Concatenate (``t1 + t2``)" +msgstr "" + +msgid "*O*\\ (len(*t1*) + len(*t2*))" +msgstr "" + +msgid "Multiply (``t * k``)" +msgstr "" + +msgid "``x in t``" +msgstr "" + +msgid "``min(t)``, ``max(t)``" +msgstr "" + +msgid "Get length (``len(t)``) [5]_" +msgstr "" + +msgid ":class:`!dict`" +msgstr "" + +msgid "" +"The times listed for dict objects are average-case times, as they assume the " +"hash function for the objects is sufficiently robust to make collisions " +"uncommon. They also assume the keys are well-distributed among the set of " +"possible keys. In the worst case, when every key hashes to the same value, " +"each of the *O*\\ (1) operations below instead takes *O*\\ (*n*) time. They " +"also assume that hashing and comparing a key is *O*\\ (1). For more detail " +"on the implementation, see :ref:`how-are-dictionaries-implemented`." +msgstr "" + +msgid "``key in d``" +msgstr "" + +msgid "Copy (``d.copy()``) [7]_" +msgstr "" + +msgid "Get item (``d[key]``, ``d.get(key)``)" +msgstr "" + +msgid "Set item (``d[key] = value``) [1]_" +msgstr "" + +msgid "Delete item (``del d[key]``, ``d.pop(key)``)" +msgstr "" + +msgid "Update (``d.update(t)``, ``d |= t``) [1]_ [3]_ [7]_" +msgstr "" + +msgid "Iteration [7]_" +msgstr "" + +msgid "Get length (``len(d)``) [5]_" +msgstr "" + +msgid ":class:`!set`, :class:`!frozenset`" +msgstr "" + +msgid "" +"See :class:`dict` as the :class:`set` and :class:`frozenset` implementations " +"are similar, and the same caveats apply. In the worst case, *O*\\ (1) " +"operations instead take *O*\\ (*n*) time, and operations that look up every " +"element degrade accordingly." +msgstr "" + +msgid "" +"A :class:`frozenset` is :term:`immutable`, so it does not support adding, " +"discarding, or the in-place update operations. The others below apply to it " +"at the same costs." +msgstr "" + +msgid "``x in s``" +msgstr "``x in s``" + +msgid "Copy (``s.copy()``) [6]_ [7]_" +msgstr "" + +msgid "Add (``s.add(x)``) [1]_" +msgstr "" + +msgid "Discard (``s.discard(x)``, ``s.remove(x)``)" +msgstr "" + +msgid "Union (``s1 | s2``, ``s1.union(s2)``) [7]_" +msgstr "" + +msgid "*O*\\ (len(*s1*) + len(*s2*))" +msgstr "" + +msgid "Update (``s1 |= s2``, ``s1.update(s2)``) [1]_ [7]_" +msgstr "" + +msgid "*O*\\ (len(*s2*))" +msgstr "" + +msgid "Intersection (``s1 & s2``, ``s1.intersection(s2)``) [7]_ [8]_" +msgstr "" + +msgid "*O*\\ (min(len(*s1*), len(*s2*)))" +msgstr "" + +msgid "" +"Intersection update (``s1 &= s2``, ``s1.intersection_update(s2)``) [1]_ [7]_ " +"[8]_" +msgstr "" + +msgid "Difference (``s1 - s2``, ``s1.difference(s2)``) [7]_ [9]_" +msgstr "" + +msgid "*O*\\ (len(*s1*))" +msgstr "" + +msgid "" +"Difference update (``s1 -= s2``, ``s1.difference_update(s2)``) [1]_ [7]_ [8]_" +msgstr "" + +msgid "" +"Symmetric difference (``s1 ^ s2``, ``s1.symmetric_difference(s2)``) [7]_" +msgstr "" + +msgid "" +"Symmetric difference update (``s1 ^= s2``, " +"``s1.symmetric_difference_update(s2)``) [1]_ [7]_" +msgstr "" + +msgid "Get length (``len(s)``) [5]_" +msgstr "" + +msgid ":class:`!str`, :class:`!bytes`, :class:`!bytearray`" +msgstr "" + +msgid "" +":class:`str` and :class:`bytes` objects are immutable sequences of " +"characters and bytes, respectively. As with tuples, copying one returns the " +"original object. A :class:`bytearray` is mutable, and additionally supports " +"the mutating operations of :class:`list` (except :meth:`!sort`), at the same " +"costs. However, deleting at the front with ``del`` (``del b[0]``, ``del " +"b[:k]``) only advances the start of the buffer instead of moving the " +"remaining bytes, and is amortized *O*\\ (1)." +msgstr "" + +msgid "Get item (``s[k]``)" +msgstr "" + +msgid "Get slice (``s[i:j]``)" +msgstr "" + +msgid "Concatenate (``s + t``) [10]_" +msgstr "" + +msgid "*O*\\ (len(*s*) + len(*t*))" +msgstr "" + +msgid "Multiply (``s * k``)" +msgstr "" + +msgid "Substring search (``x in s``, ``s.find(x)``, ``s.index(x)``) [11]_" +msgstr "" + +msgid "Reverse substring search (``s.rfind(x)``, ``s.rindex(x)``) [11]_ [12]_" +msgstr "" + +msgid "*O*\\ (*n* × len(*x*))" +msgstr "" + +msgid "Encode or decode [13]_" +msgstr "" + +msgid ":class:`!memoryview`" +msgstr "" + +msgid "" +":class:`memoryview` objects allow Python code to access the internal data of " +"an object that supports the :ref:`buffer protocol ` without " +"copying. In particular, slicing a memory view returns a new view onto the " +"same buffer." +msgstr "" + +msgid "Create (``memoryview(obj)``)" +msgstr "" + +msgid "Get item (``v[k]``)" +msgstr "" + +msgid "Get slice (``v[i:j]``)" +msgstr "" + +msgid "Index (``v.index(x)``) [11]_ [14]_" +msgstr "" + +msgid "Count (``v.count(x)``) [14]_" +msgstr "" + +msgid "Convert to bytes (``v.tobytes()``, ``bytes(v)``)" +msgstr "" + +msgid "Get length (``len(v)``) [5]_" +msgstr "" + +msgid ":class:`!range`" +msgstr "" + +msgid "" +"A :class:`range` object computes its items on demand from its *start*, " +"*stop* and *step* values, so most operations do not depend on the length of " +"the range." +msgstr "" + +msgid "Get item (``r[k]``)" +msgstr "" + +msgid "Get slice (``r[i:j]``)" +msgstr "" + +msgid "``x in r`` [15]_" +msgstr "" + +msgid "Index and count (``r.index(x)``, ``r.count(x)``) [15]_" +msgstr "" + +msgid "``min(r)``, ``max(r)``" +msgstr "" + +msgid "Get length (``len(r)``) [5]_" +msgstr "" + +msgid "Notes" +msgstr "Notatki" + +msgid "" +"Amortized. An individual operation may occasionally be *O*\\ (*n*) when the " +"underlying storage is resized, but this cost is spread over many operations, " +"depending on the history of the container." +msgstr "" + +msgid "" +"Popping or deleting the element at index *k* of a list of size *n* shifts " +"all elements after *k* one slot to the left, moving *n* - *k* - 1 elements; " +"inserting at index *k* shifts the elements from *k* onwards one slot to the " +"right, moving *n* - *k* elements. The worst case is index 0, where the whole " +"rest of the list has to be moved; the average case, an index in the middle " +"of the list, takes *O*\\ (*n*/2) = *O*\\ (*n*) operations; and operating at " +"the end of the list moves nothing and is *O*\\ (1)." +msgstr "" + +msgid "" +"Plus the cost of iterating over *t*, which may be expensive for an arbitrary " +"iterable." +msgstr "" + +msgid "" +"This is the worst case scenario. Sorting is adaptive and input that is " +"already sorted or reverse-sorted takes only *O*\\ (*n*) comparisons. " +"See :source:`Objects/listsort.txt` for more information." +msgstr "" + +msgid "" +"The number of elements is stored in the object, so ``len()`` does not need " +"to count them." +msgstr "" + +msgid "" +"Copying a :class:`frozenset` is *O*\\ (1) as it returns the original object." +msgstr "" + +msgid "" +"These operations scan the container's internal hash table, which is not " +"shrunk when elements are removed. After removing most elements, they still " +"take time proportional to the container's former size, until a later " +"insertion triggers a resize." +msgstr "" + +msgid "*O*\\ (len(*t*)) if *t* is not a set." +msgstr "" + +msgid "*O*\\ (len(*s*) + len(*t*)) if *t* is not a set." +msgstr "" + +msgid "" +"Each concatenation builds a new object, so building a string by " +"concatenating many pieces in a loop is quadratic in the total length. See " +"the :ref:`note on concatenating immutable sequences ` for alternatives." +msgstr "" + +msgid "" +"With *start* and *end* arguments, *n* is the length of the region searched " +"rather than of *s*, and unlike slicing nothing is copied." +msgstr "" + +msgid "" +"This is the worst case. Reverse searches are *O*\\ (*n*) on typical input. " +"Forward searches instead use a more elaborate algorithm with a linear worst " +"case, described in :source:`Objects/stringlib/" +"stringlib_find_two_way_notes.txt`." +msgstr "" + +msgid "This assumes a codec that does a constant amount of work per character." +msgstr "" + +msgid "" +"These unpack and compare each element individually, so they are much slower " +"than the equivalent :class:`bytes` methods." +msgstr "" + +msgid "" +"Assuming :class:`int` or :class:`bool` arguments. For other types, the range " +"is searched like any other sequence in *O*\\ (*n*) time." +msgstr "" diff --git a/c-api/abstract.po b/c-api/abstract.po index 5c435ffaf9..b7272d2557 100644 --- a/c-api/abstract.po +++ b/c-api/abstract.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,9 +39,9 @@ msgstr "" msgid "" "It is not possible to use these functions on objects that are not properly " -"initialized, such as a list object that has been created by :c:func:" -"`PyList_New`, but whose items have not been set to some non-\\ ``NULL`` " -"value yet." +"initialized, such as a list object that has been created " +"by :c:func:`PyList_New`, but whose items have not been set to some non-\\ " +"``NULL`` value yet." msgstr "" "Nie da się używać tych funckcji na obiektach, które nie zostały prawidłowo " "zainicjowane jak np. lista utworzona za pomocą :c:func:`PyList_New`, której " diff --git a/c-api/allocation.po b/c-api/allocation.po index e388a4ee8f..460926e534 100644 --- a/c-api/allocation.po +++ b/c-api/allocation.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Krzysztof Czarnota, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Krzysztof Czarnota, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,7 +25,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Allocating objects on the heap" -msgstr "" +msgstr " Alokowanie obiektów na stercie" msgid "" "Initialize a newly allocated object *op* with its type and initial " @@ -36,10 +37,10 @@ msgid "" msgstr "" msgid "" -"In general, consider this function to be a low-level routine. Use :c:member:" -"`~PyTypeObject.tp_alloc` where possible. For implementing :c:member:`!" -"tp_alloc` for your type, prefer :c:func:`PyType_GenericAlloc` or :c:func:" -"`PyObject_New`." +"In general, consider this function to be a low-level routine. " +"Use :c:member:`~PyTypeObject.tp_alloc` where possible. For " +"implementing :c:member:`!tp_alloc` for your type, " +"prefer :c:func:`PyType_GenericAlloc` or :c:func:`PyObject_New`." msgstr "" msgid "" @@ -61,10 +62,10 @@ msgstr "" msgid "" "Allocates a new Python object using the C structure type *TYPE* and the " -"Python type object *typeobj* (``PyTypeObject*``) by calling :c:func:" -"`PyObject_Malloc` to allocate memory and initializing it like :c:func:" -"`PyObject_Init`. The caller will own the only reference to the object (i.e. " -"its reference count will be one)." +"Python type object *typeobj* (``PyTypeObject*``) by " +"calling :c:func:`PyObject_Malloc` to allocate memory and initializing it " +"like :c:func:`PyObject_Init`. The caller will own the only reference to the " +"object (i.e. its reference count will be one)." msgstr "" msgid "" @@ -73,20 +74,22 @@ msgid "" msgstr "" msgid "" -"When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, :c:func:" -"`PyType_GenericAlloc` is preferred over a custom function that simply calls " -"this macro." +"When populating a type's :c:member:`~PyTypeObject.tp_alloc` " +"slot, :c:func:`PyType_GenericAlloc` is preferred over a custom function that " +"simply calls this macro." msgstr "" msgid "" -"This macro does not call :c:member:`~PyTypeObject.tp_alloc`, :c:member:" -"`~PyTypeObject.tp_new` (:meth:`~object.__new__`), or :c:member:" -"`~PyTypeObject.tp_init` (:meth:`~object.__init__`)." +"This macro does not " +"call :c:member:`~PyTypeObject.tp_alloc`, :c:member:`~PyTypeObject.tp_new` " +"(:meth:`~object.__new__`), or :c:member:`~PyTypeObject.tp_init` " +"(:meth:`~object.__init__`)." msgstr "" msgid "" -"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:" -"member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_New` instead." +"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set " +"in :c:member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_New` " +"instead." msgstr "" msgid "" @@ -101,9 +104,9 @@ msgstr "" msgid "" "This macro does not construct a fully initialized object of the given type; " -"it merely allocates memory and prepares it for further initialization by :c:" -"member:`~PyTypeObject.tp_init`. To construct a fully initialized object, " -"call *typeobj* instead. For example::" +"it merely allocates memory and prepares it for further initialization " +"by :c:member:`~PyTypeObject.tp_init`. To construct a fully initialized " +"object, call *typeobj* instead. For example::" msgstr "" msgid "PyObject *foo = PyObject_CallNoArgs((PyObject *)&PyFoo_Type);" @@ -126,8 +129,8 @@ msgstr "" msgid "" "It allocates enough memory for the *TYPE* structure plus *size* " -"(``Py_ssize_t``) fields of the size given by the :c:member:`~PyTypeObject." -"tp_itemsize` field of *typeobj*." +"(``Py_ssize_t``) fields of the size given by " +"the :c:member:`~PyTypeObject.tp_itemsize` field of *typeobj*." msgstr "" msgid "The memory is initialized like :c:func:`PyObject_InitVar`." @@ -141,8 +144,9 @@ msgid "" msgstr "" msgid "" -"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set in :c:" -"member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` instead." +"This cannot be used for objects with :c:macro:`Py_TPFLAGS_HAVE_GC` set " +"in :c:member:`~PyTypeObject.tp_flags`; use :c:macro:`PyObject_GC_NewVar` " +"instead." msgstr "" msgid "" diff --git a/c-api/apiabiversion.po b/c-api/apiabiversion.po index eb7548a041..d74f50ebd3 100644 --- a/c-api/apiabiversion.po +++ b/c-api/apiabiversion.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Paweł Kapeluszny, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Paweł Kapeluszny, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,13 +28,16 @@ msgid "API and ABI Versioning" msgstr "API i wersjonowanie ABI" msgid "Build-time version constants" -msgstr "" +msgstr "Stałe wersji czasu budowania" msgid "" "CPython exposes its version number in the following macros. Note that these " "correspond to the version code is **built** with. See :c:var:`Py_Version` " "for the version used at **run time**." msgstr "" +"CPython udostępnia swój numer wersji w poniższych makrach. Należy pamiętać, " +"że odpowiadają one wersji, z użyciem której kod został zbudowany. " +"Zobacz ::c:var:`Py_Version`, aby sprawdzić wersję używaną w czasie działania." msgid "" "See :ref:`stable` for a discussion of API and ABI stability across versions." @@ -62,9 +66,11 @@ msgid "The ``2`` in ``3.4.1a2``. Zero for final releases." msgstr "``2`` w ``3.4.1a2``. Zero dla ostatecznych wydań." msgid "" -"The Python version number encoded in a single integer. See :c:func:" -"`Py_PACK_FULL_VERSION` for the encoding details." +"The Python version number encoded in a single integer. " +"See :c:func:`Py_PACK_FULL_VERSION` for the encoding details." msgstr "" +"Numer wersji Pythona zakodowany w pojedynczej liczbie całkowitej. " +"Zobacz :c:func:`Py_PACK_FULL_VERSION`, aby poznać szczegóły kodowania." msgid "" "Use this for numeric comparisons, for example, ``#if PY_VERSION_HEX >= ...``." @@ -72,16 +78,19 @@ msgstr "" "Używaj to do porównań liczbowych, na przykład ``#if PY_VERSION_HEX >= ...``." msgid "These macros are defined in :source:`Include/patchlevel.h`." -msgstr "" +msgstr "Te makra są zdefiniowane w :source:`Include/patchlevel.h`" msgid "Run-time version" -msgstr "" +msgstr "Wersja środowiska uruchomieniowego" msgid "" -"The Python runtime version number encoded in a single constant integer. See :" -"c:func:`Py_PACK_FULL_VERSION` for the encoding details. This contains the " -"Python version used at run time." +"The Python runtime version number encoded in a single constant integer. " +"See :c:func:`Py_PACK_FULL_VERSION` for the encoding details. This contains " +"the Python version used at run time." msgstr "" +"Numer wersji środowiska uruchomieniowego Pythona zakodowany w pojedynczej " +"stałej całkowitoliczbowej. Zobacz :c:func:`Py_PACK_FULL_VERSION`, aby poznać " +"szczegóły kodowania. Zawiera ona wersję Pythona używaną w czasie działania." msgid "" "Use this for numeric comparisons, for example, ``if (Py_Version >= ...)``." @@ -89,12 +98,14 @@ msgstr "" "Używaj to do porównań liczbowych, na przykład ``if (Py_Version >= ...)``." msgid "Bit-packing macros" -msgstr "" +msgstr "Makra pakowania bitowego" msgid "" "Return the given version, encoded as a single 32-bit integer with the " "following structure:" msgstr "" +"Zwraca podaną wersję, zakodowaną jako pojedyncza 32-bitowa liczba całkowita " +"o następującej strukturze:" msgid "Argument" msgstr "Argument" @@ -103,13 +114,13 @@ msgid "No. of bits" msgstr "Liczba bitów" msgid "Bit mask" -msgstr "" +msgstr "Maska bitowa" msgid "Bit shift" -msgstr "" +msgstr "Przesunięcie bitowe" msgid "Example values" -msgstr "" +msgstr "Przykładowe wartości" msgid "``3.4.1a2``" msgstr "``3.4.1a2``" @@ -217,6 +228,8 @@ msgid "" "Out-of range bits in the arguments are ignored. That is, the macro can be " "defined as:" msgstr "" +"Bity spoza zakresu w argumentach są ignorowane. Oznacza to, że makro można " +"zdefiniować następująco:" msgid "" "#ifndef Py_PACK_FULL_VERSION\n" @@ -241,9 +254,15 @@ msgid "" "``Py_PACK_FULL_VERSION`` is primarily a macro, intended for use in ``#if`` " "directives, but it is also available as an exported function." msgstr "" +"``Py_PACK_FULL_VERSION``to przede wszystkim makro, przeznaczone do użycia w " +"dyrektywach ``#if``, ale jest ono również dostępne jako wyeksportowana " +"funkcja." msgid "" "Equivalent to ``Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)``. The result " "does not correspond to any Python release, but is useful in numeric " "comparisons." msgstr "" +"Równoważne ``Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)``. Wynik ten nie " +"odpowiada żadnemu wydaniu Pythona, ale jest przydatny w porównaniach " +"numerycznych." diff --git a/c-api/arg.po b/c-api/arg.po index 4c97c3025c..41168237dd 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,16 +29,16 @@ msgstr "" msgid "" "These functions are useful when creating your own extension functions and " -"methods. Additional information and examples are available in :ref:" -"`extending-index`." +"methods. Additional information and examples are available " +"in :ref:`extending-index`." msgstr "" msgid "" -"The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c:" -"func:`PyArg_ParseTupleAndKeywords`, and :c:func:`PyArg_Parse`, all use " -"*format strings* which are used to tell the function about the expected " -"arguments. The format strings use the same syntax for each of these " -"functions." +"The first three of these functions " +"described, :c:func:`PyArg_ParseTuple`, :c:func:`PyArg_ParseTupleAndKeywords`, " +"and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell " +"the function about the expected arguments. The format strings use the same " +"syntax for each of these functions." msgstr "" msgid "Parsing arguments" @@ -114,10 +114,10 @@ msgid "" msgstr "" msgid "" -"To ensure that the underlying buffer may be safely borrowed, the object's :c:" -"member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This " -"disallows common mutable objects such as :class:`bytearray`, but also some " -"read-only objects such as :class:`memoryview` of :class:`bytes`." +"To ensure that the underlying buffer may be safely borrowed, the " +"object's :c:member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. " +"This disallows common mutable objects such as :class:`bytearray`, but also " +"some read-only objects such as :class:`memoryview` of :class:`bytes`." msgstr "" msgid "" @@ -141,8 +141,8 @@ msgstr "" msgid "" "This format does not accept :term:`bytes-like objects `. " "If you want to accept filesystem paths and convert them to C character " -"strings, it is preferable to use the ``O&`` format with :c:func:" -"`PyUnicode_FSConverter` as *converter*." +"strings, it is preferable to use the ``O&`` format " +"with :c:func:`PyUnicode_FSConverter` as *converter*." msgstr "" msgid "" @@ -161,8 +161,8 @@ msgid "" msgstr "" msgid "" -"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\*, :" -"c:type:`Py_ssize_t`]" +"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char " +"\\*, :c:type:`Py_ssize_t`]" msgstr "" msgid "" @@ -224,8 +224,8 @@ msgid "" msgstr "" msgid "" -"``y#`` (read-only :term:`bytes-like object`) [const char \\*, :c:type:" -"`Py_ssize_t`]" +"``y#`` (read-only :term:`bytes-like object`) [const char " +"\\*, :c:type:`Py_ssize_t`]" msgstr "" msgid "" @@ -249,9 +249,9 @@ msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]" msgid "" "Requires that the Python object is a :class:`bytearray` object, without " -"attempting any conversion. Raises :exc:`TypeError` if the object is not a :" -"class:`bytearray` object. The C variable may also be declared as :c:expr:" -"`PyObject*`." +"attempting any conversion. Raises :exc:`TypeError` if the object is not " +"a :class:`bytearray` object. The C variable may also be declared " +"as :c:expr:`PyObject*`." msgstr "" msgid "``U`` (:class:`str`) [PyObject \\*]" @@ -269,8 +269,8 @@ msgstr "" msgid "" "This format accepts any object which implements the read-write buffer " "interface. It fills a :c:type:`Py_buffer` structure provided by the caller. " -"The buffer may contain embedded null bytes. The caller has to call :c:func:" -"`PyBuffer_Release` when it is done with the buffer." +"The buffer may contain embedded null bytes. The caller has to " +"call :c:func:`PyBuffer_Release` when it is done with the buffer." msgstr "" msgid "``es`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer]" @@ -296,8 +296,8 @@ msgstr "" msgid "" ":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy " "the encoded data into this buffer and adjust *\\*buffer* to reference the " -"newly allocated storage. The caller is responsible for calling :c:func:" -"`PyMem_Free` to free the allocated buffer after use." +"newly allocated storage. The caller is responsible for " +"calling :c:func:`PyMem_Free` to free the allocated buffer after use." msgstr "" msgid "" @@ -315,8 +315,8 @@ msgstr "" "że obiekt łańcucha znaków wykorzystuje kodowanie przekazane jako parametr." msgid "" -"``es#`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer, :c:type:" -"`Py_ssize_t` \\*buffer_length]" +"``es#`` (:class:`str`) [const char \\*encoding, char " +"\\*\\*buffer, :c:type:`Py_ssize_t` \\*buffer_length]" msgstr "" msgid "" @@ -390,10 +390,11 @@ msgstr "Liczby" msgid "" "These formats allow representing Python numbers or single characters as C " -"numbers. Formats that require :class:`int`, :class:`float` or :class:" -"`complex` can also use the corresponding special methods :meth:`~object." -"__index__`, :meth:`~object.__float__` or :meth:`~object.__complex__` to " -"convert the Python object to the required type." +"numbers. Formats that require :class:`int`, :class:`float` " +"or :class:`complex` can also use the corresponding special " +"methods :meth:`~object.__index__`, :meth:`~object.__float__` " +"or :meth:`~object.__complex__` to convert the Python object to the required " +"type." msgstr "" msgid "" @@ -529,9 +530,9 @@ msgstr "``O`` (object) [PyObject \\*]" msgid "" "Store a Python object (without any conversion) in a C object pointer. The C " -"program thus receives the actual object that was passed. A new :term:" -"`strong reference` to the object is not created (i.e. its reference count is " -"not increased). The pointer stored is not ``NULL``." +"program thus receives the actual object that was passed. A " +"new :term:`strong reference` to the object is not created (i.e. its " +"reference count is not increased). The pointer stored is not ``NULL``." msgstr "" msgid "``O!`` (object) [*typeobject*, PyObject \\*]" @@ -559,12 +560,12 @@ msgid "status = converter(object, address);" msgstr "" msgid "" -"where *object* is the Python object to be converted and *address* is the :c:" -"expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The " -"returned *status* should be ``1`` for a successful conversion and ``0`` if " -"the conversion has failed. When the conversion fails, the *converter* " -"function should raise an exception and leave the content of *address* " -"unmodified." +"where *object* is the Python object to be converted and *address* is " +"the :c:expr:`void*` argument that was passed to the ``PyArg_Parse*`` " +"function. The returned *status* should be ``1`` for a successful conversion " +"and ``0`` if the conversion has failed. When the conversion fails, the " +"*converter* function should raise an exception and leave the content of " +"*address* unmodified." msgstr "" msgid "" @@ -576,8 +577,8 @@ msgid "" msgstr "" msgid "" -"Examples of converters: :c:func:`PyUnicode_FSConverter` and :c:func:" -"`PyUnicode_FSDecoder`." +"Examples of converters: :c:func:`PyUnicode_FSConverter` " +"and :c:func:`PyUnicode_FSDecoder`." msgstr "" msgid ":c:macro:`!Py_CLEANUP_SUPPORTED` was added." @@ -606,8 +607,8 @@ msgstr "" msgid "" "If *items* contains format units which store a :ref:`borrowed buffer ` (``s``, ``s#``, ``z``, ``z#``, ``y``, or ``y#``) or a :" -"term:`borrowed reference` (``S``, ``Y``, ``U``, ``O``, or ``O!``), the " +"borrowed-buffer>` (``s``, ``s#``, ``z``, ``z#``, ``y``, or ``y#``) or " +"a :term:`borrowed reference` (``S``, ``Y``, ``U``, ``O``, or ``O!``), the " "object must be a Python tuple. The *converter* for the ``O&`` format unit in " "*items* must not store a borrowed buffer or a borrowed reference." msgstr "" @@ -636,7 +637,8 @@ msgid "" "optional. The C variables corresponding to optional arguments should be " "initialized to their default value --- when an optional argument is not " "specified, :c:func:`PyArg_ParseTuple` does not touch the contents of the " -"corresponding C variable(s)." +"corresponding C variable(s). For example, the format string ``\"OO|OO\"`` " +"corresponds to the Python signature ``f(a, b, c=None, d=None)``." msgstr "" msgid "``$``" @@ -644,9 +646,11 @@ msgstr "``$``" msgid "" ":c:func:`PyArg_ParseTupleAndKeywords` only: Indicates that the remaining " -"arguments in the Python argument list are keyword-only. Currently, all " -"keyword-only arguments must also be optional arguments, so ``|`` must always " -"be specified before ``$`` in the format string." +"arguments in the Python argument list are keyword-only. They are optional if " +"``|`` was specified before ``$``, and required otherwise. ``|`` cannot be " +"specified after ``$``. For example, the format string ``\"O|O$O\"`` " +"corresponds to the Python signature ``f(a, b=None, *, c=None)``, and the " +"format string ``\"OO$OO\"`` corresponds to ``f(a, b, *, c, d)``." msgstr "" msgid "``:``" @@ -663,8 +667,8 @@ msgstr "``;``" msgid "" "The list of format units ends here; the string after the semicolon is used " -"as the error message *instead* of the default error message. ``:`` and ``;" -"`` mutually exclude each other." +"as the error message *instead* of the default error message. ``:`` and " +"``;`` mutually exclude each other." msgstr "" "Na tym kończy się lista jednostek formatu; ciąg po średniku jest traktowany " "jako informacja o błędzie do użycia *zamiast* automatycznej wiadomości o " @@ -724,9 +728,9 @@ msgid "" msgstr "" msgid "" -"The *keywords* parameter declaration is :c:expr:`char * const *` in C and :c:" -"expr:`const char * const *` in C++. This can be overridden with the :c:macro:" -"`PY_CXX_CONST` macro." +"The *keywords* parameter declaration is :c:expr:`char * const *` in C " +"and :c:expr:`const char * const *` in C++. This can be overridden with " +"the :c:macro:`PY_CXX_CONST` macro." msgstr "" msgid "" @@ -735,9 +739,9 @@ msgid "" msgstr "" msgid "" -"The *keywords* parameter has now type :c:expr:`char * const *` in C and :c:" -"expr:`const char * const *` in C++, instead of :c:expr:`char **`. Added " -"support for non-ASCII keyword parameter names." +"The *keywords* parameter has now type :c:expr:`char * const *` in C " +"and :c:expr:`const char * const *` in C++, instead of :c:expr:`char **`. " +"Added support for non-ASCII keyword parameter names." msgstr "" msgid "" @@ -848,10 +852,10 @@ msgid "" "When memory buffers are passed as parameters to supply data to build " "objects, as for the ``s`` and ``s#`` formats, the required data is copied. " "Buffers provided by the caller are never referenced by the objects created " -"by :c:func:`Py_BuildValue`. In other words, if your code invokes :c:func:" -"`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your " -"code is responsible for calling :c:func:`free` for that memory once :c:func:" -"`Py_BuildValue` returns." +"by :c:func:`Py_BuildValue`. In other words, if your code " +"invokes :c:func:`malloc` and passes the allocated memory " +"to :c:func:`Py_BuildValue`, your code is responsible for " +"calling :c:func:`free` for that memory once :c:func:`Py_BuildValue` returns." msgstr "" msgid "" @@ -1011,9 +1015,9 @@ msgid "" "Pass a Python object untouched but create a new :term:`strong reference` to " "it (i.e. its reference count is incremented by one). If the object passed in " "is a ``NULL`` pointer, it is assumed that this was caused because the call " -"producing the argument found an error and set an exception. Therefore, :c:" -"func:`Py_BuildValue` will return ``NULL`` but won't raise an exception. If " -"no exception has been raised yet, :exc:`SystemError` is set." +"producing the argument found an error and set an exception. " +"Therefore, :c:func:`Py_BuildValue` will return ``NULL`` but won't raise an " +"exception. If no exception has been raised yet, :exc:`SystemError` is set." msgstr "" msgid "``S`` (object) [PyObject \\*]" @@ -1036,9 +1040,9 @@ msgstr "``O&`` (object) [*converter*, *anything*]" msgid "" "Convert *anything* to a Python object through a *converter* function. The " -"function is called with *anything* (which should be compatible with :c:expr:" -"`void*`) as its argument and should return a \"new\" Python object, or " -"``NULL`` if an error occurred." +"function is called with *anything* (which should be compatible " +"with :c:expr:`void*`) as its argument and should return a \"new\" Python " +"object, or ``NULL`` if an error occurred." msgstr "" msgid "``(items)`` (:class:`tuple`) [*matching-items*]" diff --git a/c-api/bool.po b/c-api/bool.po index 757335dd33..f3a34ca472 100644 --- a/c-api/bool.po +++ b/c-api/bool.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,17 +45,13 @@ msgstr "" "Zwraca wartość true, jeśli *o* jest typu :c:data:`PyBool_Type`. Ta funkcja " "zawsze kończy się powodzeniem." -msgid "" -"The Python ``False`` object. This object has no methods and is :term:" -"`immortal`." +msgid "The Python ``False`` object. This object is :term:`immortal`." msgstr "" msgid ":c:data:`Py_False` is :term:`immortal`." msgstr ":c:data:`Py_False` jest :term:`immortal`." -msgid "" -"The Python ``True`` object. This object has no methods and is :term:" -"`immortal`." +msgid "The Python ``True`` object. This object is :term:`immortal`." msgstr "" msgid ":c:data:`Py_True` is :term:`immortal`." diff --git a/c-api/buffer.po b/c-api/buffer.po index 752b20394c..2fbac9f5b6 100644 --- a/c-api/buffer.po +++ b/c-api/buffer.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,10 +28,10 @@ msgstr "" msgid "" "Certain objects available in Python wrap access to an underlying memory " -"array or *buffer*. Such objects include the built-in :class:`bytes` and :" -"class:`bytearray`, and some extension types like :class:`array.array`. Third-" -"party libraries may define their own types for special purposes, such as " -"image processing or numeric analysis." +"array or *buffer*. Such objects include the built-in :class:`bytes` " +"and :class:`bytearray`, and some extension types like :class:`array.array`. " +"Third-party libraries may define their own types for special purposes, such " +"as image processing or numeric analysis." msgstr "" msgid "" @@ -67,14 +67,14 @@ msgid "" msgstr "" msgid "" -"An example consumer of the buffer interface is the :meth:`~io.BufferedIOBase." -"write` method of file objects: any object that can export a series of bytes " -"through the buffer interface can be written to a file. While :meth:`!write` " -"only needs read-only access to the internal contents of the object passed to " -"it, other methods such as :meth:`~io.BufferedIOBase.readinto` need write " -"access to the contents of their argument. The buffer interface allows " -"objects to selectively allow or reject exporting of read-write and read-only " -"buffers." +"An example consumer of the buffer interface is " +"the :meth:`~io.BufferedIOBase.write` method of file objects: any object that " +"can export a series of bytes through the buffer interface can be written to " +"a file. While :meth:`!write` only needs read-only access to the internal " +"contents of the object passed to it, other methods such " +"as :meth:`~io.BufferedIOBase.readinto` need write access to the contents of " +"their argument. The buffer interface allows objects to selectively allow or " +"reject exporting of read-write and read-only buffers." msgstr "" msgid "" @@ -125,8 +125,8 @@ msgstr "" msgid "" "For short instructions how to write an exporting object, see :ref:`Buffer " -"Object Structures `. For obtaining a buffer, see :c:func:" -"`PyObject_GetBuffer`." +"Object Structures `. For obtaining a buffer, " +"see :c:func:`PyObject_GetBuffer`." msgstr "" msgid "" @@ -149,9 +149,9 @@ msgid "" msgstr "" msgid "" -"As a special case, for *temporary* buffers that are wrapped by :c:func:" -"`PyMemoryView_FromBuffer` or :c:func:`PyBuffer_FillInfo` this field is " -"``NULL``. In general, exporting objects MUST NOT use this scheme." +"As a special case, for *temporary* buffers that are wrapped " +"by :c:func:`PyMemoryView_FromBuffer` or :c:func:`PyBuffer_FillInfo` this " +"field is ``NULL``. In general, exporting objects MUST NOT use this scheme." msgstr "" msgid "" @@ -164,8 +164,8 @@ msgstr "" msgid "" "Accessing ``((char *)buf)[0] up to ((char *)buf)[len-1]`` is only valid if " "the buffer has been obtained by a request that guarantees contiguity. In " -"most cases such a request will be :c:macro:`PyBUF_SIMPLE` or :c:macro:" -"`PyBUF_WRITABLE`." +"most cases such a request will be :c:macro:`PyBUF_SIMPLE` " +"or :c:macro:`PyBUF_WRITABLE`." msgstr "" msgid "" @@ -174,27 +174,29 @@ msgid "" msgstr "" msgid "" -"Item size in bytes of a single element. Same as the value of :func:`struct." -"calcsize` called on non-``NULL`` :c:member:`~Py_buffer.format` values." +"Item size in bytes of a single element. Same as the value " +"of :func:`struct.calcsize` called on non-" +"``NULL`` :c:member:`~Py_buffer.format` values." msgstr "" msgid "" -"Important exception: If a consumer requests a buffer without the :c:macro:" -"`PyBUF_FORMAT` flag, :c:member:`~Py_buffer.format` will be set to " -"``NULL``, but :c:member:`~Py_buffer.itemsize` still has the value for the " -"original format." +"Important exception: If a consumer requests a buffer without " +"the :c:macro:`PyBUF_FORMAT` flag, :c:member:`~Py_buffer.format` will be set " +"to ``NULL``, but :c:member:`~Py_buffer.itemsize` still has the value for " +"the original format." msgstr "" msgid "" "If :c:member:`~Py_buffer.shape` is present, the equality ``product(shape) * " -"itemsize == len`` still holds and the consumer can use :c:member:`~Py_buffer." -"itemsize` to navigate the buffer." +"itemsize == len`` still holds and the consumer can " +"use :c:member:`~Py_buffer.itemsize` to navigate the buffer." msgstr "" msgid "" -"If :c:member:`~Py_buffer.shape` is ``NULL`` as a result of a :c:macro:" -"`PyBUF_SIMPLE` or a :c:macro:`PyBUF_WRITABLE` request, the consumer must " -"disregard :c:member:`~Py_buffer.itemsize` and assume ``itemsize == 1``." +"If :c:member:`~Py_buffer.shape` is ``NULL`` as a result of " +"a :c:macro:`PyBUF_SIMPLE` or a :c:macro:`PyBUF_WRITABLE` request, the " +"consumer must disregard :c:member:`~Py_buffer.itemsize` and assume " +"``itemsize == 1``." msgstr "" msgid "" @@ -209,16 +211,17 @@ msgstr "" msgid "" "The number of dimensions the memory represents as an n-dimensional array. If " "it is ``0``, :c:member:`~Py_buffer.buf` points to a single item representing " -"a scalar. In this case, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer." -"strides` and :c:member:`~Py_buffer.suboffsets` MUST be ``NULL``. The maximum " -"number of dimensions is given by :c:macro:`PyBUF_MAX_NDIM`." +"a scalar. In this " +"case, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer.strides` " +"and :c:member:`~Py_buffer.suboffsets` MUST be ``NULL``. The maximum number " +"of dimensions is given by :c:macro:`PyBUF_MAX_NDIM`." msgstr "" msgid "" "An array of :c:type:`Py_ssize_t` of length :c:member:`~Py_buffer.ndim` " "indicating the shape of the memory as an n-dimensional array. Note that " -"``shape[0] * ... * shape[ndim-1] * itemsize`` MUST be equal to :c:member:" -"`~Py_buffer.len`." +"``shape[0] * ... * shape[ndim-1] * itemsize`` MUST be equal " +"to :c:member:`~Py_buffer.len`." msgstr "" msgid "" @@ -300,9 +303,8 @@ msgstr "" msgid "" "The following fields are not influenced by *flags* and must always be filled " -"in with the correct values: :c:member:`~Py_buffer.obj`, :c:member:" -"`~Py_buffer.buf`, :c:member:`~Py_buffer.len`, :c:member:`~Py_buffer." -"itemsize`, :c:member:`~Py_buffer.ndim`." +"in with the correct " +"values: :c:member:`~Py_buffer.obj`, :c:member:`~Py_buffer.buf`, :c:member:`~Py_buffer.len`, :c:member:`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`." msgstr "" msgid "readonly, format" @@ -316,7 +318,7 @@ msgid "" "PyBUF_WRITABLE` can be used to request a simple writable buffer." msgstr "" -msgid "This is a :term:`soft deprecated` alias to :c:macro:`PyBUF_WRITABLE`." +msgid "This is an alias to :c:macro:`PyBUF_WRITABLE`." msgstr "" msgid "" @@ -326,15 +328,15 @@ msgstr "" msgid "" ":c:macro:`PyBUF_WRITABLE` can be \\|'d to any of the flags in the next " -"section. Since :c:macro:`PyBUF_SIMPLE` is defined as 0, :c:macro:" -"`PyBUF_WRITABLE` can be used as a stand-alone flag to request a simple " -"writable buffer." +"section. Since :c:macro:`PyBUF_SIMPLE` is defined as " +"0, :c:macro:`PyBUF_WRITABLE` can be used as a stand-alone flag to request a " +"simple writable buffer." msgstr "" msgid "" -":c:macro:`PyBUF_FORMAT` must be \\|'d to any of the flags except :c:macro:" -"`PyBUF_SIMPLE`, because the latter already implies format ``B`` (unsigned " -"bytes). :c:macro:`!PyBUF_FORMAT` cannot be used on its own." +":c:macro:`PyBUF_FORMAT` must be \\|'d to any of the flags " +"except :c:macro:`PyBUF_SIMPLE`, because the latter already implies format " +"``B`` (unsigned bytes). :c:macro:`!PyBUF_FORMAT` cannot be used on its own." msgstr "" msgid "shape, strides, suboffsets" @@ -427,16 +429,17 @@ msgid "NumPy-style: shape and strides" msgstr "" msgid "" -"The logical structure of NumPy-style arrays is defined by :c:member:" -"`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`, :c:member:`~Py_buffer." -"shape` and :c:member:`~Py_buffer.strides`." +"The logical structure of NumPy-style arrays is defined " +"by :c:member:`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`, :c:member:`~Py_buffer.shape` " +"and :c:member:`~Py_buffer.strides`." msgstr "" msgid "" -"If ``ndim == 0``, the memory location pointed to by :c:member:`~Py_buffer." -"buf` is interpreted as a scalar of size :c:member:`~Py_buffer.itemsize`. In " -"that case, both :c:member:`~Py_buffer.shape` and :c:member:`~Py_buffer." -"strides` are ``NULL``." +"If ``ndim == 0``, the memory location pointed to " +"by :c:member:`~Py_buffer.buf` is interpreted as a scalar of " +"size :c:member:`~Py_buffer.itemsize`. In that case, " +"both :c:member:`~Py_buffer.shape` and :c:member:`~Py_buffer.strides` are " +"``NULL``." msgstr "" msgid "" @@ -530,8 +533,8 @@ msgstr "" msgid "" "Send a request to *exporter* to fill in *view* as specified by *flags*. If " -"the exporter cannot provide a buffer of the exact type, it MUST raise :exc:" -"`BufferError`, set ``view->obj`` to ``NULL`` and return ``-1``." +"the exporter cannot provide a buffer of the exact type, it MUST " +"raise :exc:`BufferError`, set ``view->obj`` to ``NULL`` and return ``-1``." msgstr "" msgid "" @@ -543,9 +546,9 @@ msgstr "" msgid "" "Successful calls to :c:func:`PyObject_GetBuffer` must be paired with calls " -"to :c:func:`PyBuffer_Release`, similar to :c:func:`malloc` and :c:func:" -"`free`. Thus, after the consumer is done with the buffer, :c:func:" -"`PyBuffer_Release` must be called exactly once." +"to :c:func:`PyBuffer_Release`, similar to :c:func:`malloc` " +"and :c:func:`free`. Thus, after the consumer is done with the " +"buffer, :c:func:`PyBuffer_Release` must be called exactly once." msgstr "" msgid "" @@ -556,13 +559,14 @@ msgid "" msgstr "" msgid "" -"It is an error to call this function on a buffer that was not obtained via :" -"c:func:`PyObject_GetBuffer`." +"It is an error to call this function on a buffer that was not obtained " +"via :c:func:`PyObject_GetBuffer`." msgstr "" msgid "" -"Return the implied :c:member:`~Py_buffer.itemsize` from :c:member:" -"`~Py_buffer.format`. On error, raise an exception and return -1." +"Return the implied :c:member:`~Py_buffer.itemsize` " +"from :c:member:`~Py_buffer.format`. On error, raise an exception and return " +"-1." msgstr "" msgid "" diff --git a/c-api/bytearray.po b/c-api/bytearray.po index 4723f0c5f8..0dda8dedbf 100644 --- a/c-api/bytearray.po +++ b/c-api/bytearray.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,6 +30,13 @@ msgid "" "This subtype of :c:type:`PyObject` represents a Python bytearray object." msgstr "" +msgid "" +"The internal buffer of :c:type:`PyByteArrayObject` always includes an extra " +"trailing null byte for compatibility with null terminated C strings. This " +"extra byte is not counted in :c:func:`PyByteArray_Size` nor in the *len* " +"arguments of the functions below." +msgstr "" + msgid "" "This instance of :c:type:`PyTypeObject` represents the Python bytearray " "type; it is the same object as :class:`bytearray` in the Python layer." @@ -52,8 +59,8 @@ msgid "Direct API functions" msgstr "" msgid "" -"Return a new bytearray object from any object, *o*, that implements the :ref:" -"`buffer protocol `." +"Return a new bytearray object from any object, *o*, that implements " +"the :ref:`buffer protocol `." msgstr "" msgid "On failure, return ``NULL`` with an exception set." diff --git a/c-api/bytes.po b/c-api/bytes.po index 2641ad1b92..2b5cba7d2b 100644 --- a/c-api/bytes.po +++ b/c-api/bytes.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,6 +31,13 @@ msgid "" "called with a non-bytes parameter." msgstr "" +msgid "" +"The internal buffer of :c:type:`PyBytesObject` always includes an extra " +"trailing null byte for compatibility with null terminated C strings. This " +"extra byte is not counted in :c:func:`PyBytes_Size` nor in the various " +"*length* and *size* arguments of the functions below." +msgstr "" + msgid "This subtype of :c:type:`PyObject` represents a Python bytes object." msgstr "" @@ -218,8 +225,8 @@ msgid "" "buffer is always null, regardless of whether there are any other null " "bytes. The data must not be modified in any way, unless the object was just " "created using ``PyBytes_FromStringAndSize(NULL, size)``. It must not be " -"deallocated. If *o* is not a bytes object at all, :c:func:" -"`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`." +"deallocated. If *o* is not a bytes object at " +"all, :c:func:`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`." msgstr "" msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking." @@ -252,10 +259,11 @@ msgstr "" msgid "" "Create a new bytes object in *\\*bytes* containing the contents of *newpart* " -"appended to *bytes*; the caller will own the new reference. The reference " -"to the old value of *bytes* will be stolen. If the new object cannot be " -"created, the old reference to *bytes* will still be discarded and the value " -"of *\\*bytes* will be set to ``NULL``; the appropriate exception will be set." +"appended to *bytes*; the caller will own the new reference. The reference to " +"the old value of *bytes* will be \":term:`stolen `\". If the new " +"object cannot be created, the old reference to *bytes* will still be " +"\"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the " +"appropriate exception will be set." msgstr "" msgid "" @@ -273,14 +281,14 @@ msgid "Similar to ``sep.join(iterable)`` in Python." msgstr "" msgid "" -"*sep* must be Python :class:`bytes` object. (Note that :c:func:" -"`PyUnicode_Join` accepts ``NULL`` separator and treats it as a space, " -"whereas :c:func:`PyBytes_Join` doesn't accept ``NULL`` separator.)" +"*sep* must be Python :class:`bytes` object. (Note " +"that :c:func:`PyUnicode_Join` accepts ``NULL`` separator and treats it as a " +"space, whereas :c:func:`PyBytes_Join` doesn't accept ``NULL`` separator.)" msgstr "" msgid "" -"*iterable* must be an iterable object yielding objects that implement the :" -"ref:`buffer protocol `." +"*iterable* must be an iterable object yielding objects that implement " +"the :ref:`buffer protocol `." msgstr "" msgid "" @@ -323,9 +331,9 @@ msgid "" msgstr "" msgid "" -"On success, this function returns a :term:`strong reference` to a :class:" -"`str` object containing the representation. On failure, this returns " -"``NULL`` with an exception set." +"On success, this function returns a :term:`strong reference` to " +"a :class:`str` object containing the representation. On failure, this " +"returns ``NULL`` with an exception set." msgstr "" msgid "" @@ -339,9 +347,9 @@ msgid "" msgstr "" msgid "" -"On success, this function returns a :term:`strong reference` to a Python :" -"class:`bytes` object containing the unescaped string. On failure, this " -"function returns ``NULL`` with an exception set." +"On success, this function returns a :term:`strong reference` to a " +"Python :class:`bytes` object containing the unescaped string. On failure, " +"this function returns ``NULL`` with an exception set." msgstr "" msgid "*unicode* and *recode_encoding* are now unused." diff --git a/c-api/call.po b/c-api/call.po index b8132bc34a..7a10341533 100644 --- a/c-api/call.po +++ b/c-api/call.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -50,8 +50,9 @@ msgid "" msgstr "" msgid "" -"This convention is not only used by *tp_call*: :c:member:`~PyTypeObject." -"tp_new` and :c:member:`~PyTypeObject.tp_init` also pass arguments this way." +"This convention is not only used by " +"*tp_call*: :c:member:`~PyTypeObject.tp_new` " +"and :c:member:`~PyTypeObject.tp_init` also pass arguments this way." msgstr "" msgid "" @@ -70,17 +71,18 @@ msgstr "" msgid "" "As rule of thumb, CPython will prefer the vectorcall for internal calls if " "the callable supports it. However, this is not a hard rule. Additionally, " -"some third-party extensions use *tp_call* directly (rather than using :c:" -"func:`PyObject_Call`). Therefore, a class supporting vectorcall must also " -"implement :c:member:`~PyTypeObject.tp_call`. Moreover, the callable must " -"behave the same regardless of which protocol is used. The recommended way to " -"achieve this is by setting :c:member:`~PyTypeObject.tp_call` to :c:func:" -"`PyVectorcall_Call`. This bears repeating:" +"some third-party extensions use *tp_call* directly (rather than " +"using :c:func:`PyObject_Call`). Therefore, a class supporting vectorcall " +"must also implement :c:member:`~PyTypeObject.tp_call`. Moreover, the " +"callable must behave the same regardless of which protocol is used. The " +"recommended way to achieve this is by " +"setting :c:member:`~PyTypeObject.tp_call` to :c:func:`PyVectorcall_Call`. " +"This bears repeating:" msgstr "" msgid "" -"A class supporting vectorcall **must** also implement :c:member:" -"`~PyTypeObject.tp_call` with the same semantics." +"A class supporting vectorcall **must** also " +"implement :c:member:`~PyTypeObject.tp_call` with the same semantics." msgstr "" msgid "" @@ -100,40 +102,33 @@ msgid "" msgstr "" msgid "" -"Classes can implement the vectorcall protocol by enabling the :c:macro:" -"`Py_TPFLAGS_HAVE_VECTORCALL` flag and setting :c:member:`~PyTypeObject." -"tp_vectorcall_offset` to the offset inside the object structure where a " -"*vectorcallfunc* appears. This is a pointer to a function with the following " -"signature:" +"Classes can implement the vectorcall protocol by enabling " +"the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag and " +"setting :c:member:`~PyTypeObject.tp_vectorcall_offset` to the offset inside " +"the object structure where a *vectorcallfunc* appears. This is a pointer to " +"a function with the following signature:" msgstr "" msgid "*callable* is the object being called." msgstr "" msgid "" -"*args* is a C array consisting of the positional arguments followed by the" -msgstr "" - -msgid "" +"*args* is a C array consisting of the positional arguments followed by the " "values of the keyword arguments. This can be *NULL* if there are no " "arguments." msgstr "" -msgid "*nargsf* is the number of positional arguments plus possibly the" -msgstr "" - msgid "" -":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` flag. To get the actual number of " -"positional arguments from *nargsf*, use :c:func:`PyVectorcall_NARGS`." -msgstr "" - -msgid "*kwnames* is a tuple containing the names of the keyword arguments;" +"*nargsf* is the number of positional arguments plus possibly " +"the :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` flag. To get the actual number " +"of positional arguments from *nargsf*, use :c:func:`PyVectorcall_NARGS`." msgstr "" msgid "" -"in other words, the keys of the kwargs dict. These names must be strings " -"(instances of ``str`` or a subclass) and they must be unique. If there are " -"no keyword arguments, then *kwnames* can instead be *NULL*." +"*kwnames* is a tuple containing the names of the keyword arguments; in other " +"words, the keys of the kwargs dict. These names must be strings (instances " +"of ``str`` or a subclass) and they must be unique. If there are no keyword " +"arguments, then *kwnames* can instead be *NULL*." msgstr "" msgid "" @@ -166,8 +161,8 @@ msgstr "Kontrola Rekursji" msgid "" "When using *tp_call*, callees do not need to worry about :ref:`recursion " -"`: CPython uses :c:func:`Py_EnterRecursiveCall` and :c:func:" -"`Py_LeaveRecursiveCall` for calls made using *tp_call*." +"`: CPython uses :c:func:`Py_EnterRecursiveCall` " +"and :c:func:`Py_LeaveRecursiveCall` for calls made using *tp_call*." msgstr "" msgid "" @@ -210,10 +205,10 @@ msgid "" msgstr "" msgid "" -"This is a specialized function, intended to be put in the :c:member:" -"`~PyTypeObject.tp_call` slot or be used in an implementation of ``tp_call``. " -"It does not check the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag and it does " -"not fall back to ``tp_call``." +"This is a specialized function, intended to be put in " +"the :c:member:`~PyTypeObject.tp_call` slot or be used in an implementation " +"of ``tp_call``. It does not check the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` " +"flag and it does not fall back to ``tp_call``." msgstr "" msgid "Object Calling API" @@ -364,8 +359,8 @@ msgid "" msgstr "" msgid "" -"Note that if you only pass :c:expr:`PyObject *` args, :c:func:" -"`PyObject_CallFunctionObjArgs` is a faster alternative." +"Note that if you only pass :c:expr:`PyObject *` " +"args, :c:func:`PyObject_CallFunctionObjArgs` is a faster alternative." msgstr "" msgid "The type of *format* was changed from ``char *``." @@ -386,17 +381,17 @@ msgid "" msgstr "" msgid "" -"Note that if you only pass :c:expr:`PyObject *` args, :c:func:" -"`PyObject_CallMethodObjArgs` is a faster alternative." +"Note that if you only pass :c:expr:`PyObject *` " +"args, :c:func:`PyObject_CallMethodObjArgs` is a faster alternative." msgstr "" msgid "The types of *name* and *format* were changed from ``char *``." msgstr "" msgid "" -"Call a callable Python object *callable*, with a variable number of :c:expr:" -"`PyObject *` arguments. The arguments are provided as a variable number of " -"parameters followed by *NULL*." +"Call a callable Python object *callable*, with a variable number " +"of :c:expr:`PyObject *` arguments. The arguments are provided as a variable " +"number of parameters followed by *NULL*." msgstr "" msgid "" @@ -423,9 +418,9 @@ msgid "" msgstr "" msgid "" -"Call a callable Python object *callable*. The arguments are the same as for :" -"c:type:`vectorcallfunc`. If *callable* supports vectorcall_, this directly " -"calls the vectorcall function stored in *callable*." +"Call a callable Python object *callable*. The arguments are the same as " +"for :c:type:`vectorcallfunc`. If *callable* supports vectorcall_, this " +"directly calls the vectorcall function stored in *callable*." msgstr "" msgid "as ``_PyObject_Vectorcall``" @@ -454,10 +449,10 @@ msgid "" "method is given as a Python string *name*. The object whose method is called " "is *args[0]*, and the *args* array starting at *args[1]* represents the " "arguments of the call. There must be at least one positional argument. " -"*nargsf* is the number of positional arguments including *args[0]*, plus :c:" -"macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` may " -"temporarily be changed. Keyword arguments can be passed just like in :c:func:" -"`PyObject_Vectorcall`." +"*nargsf* is the number of positional arguments including *args[0]*, " +"plus :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` " +"may temporarily be changed. Keyword arguments can be passed just like " +"in :c:func:`PyObject_Vectorcall`." msgstr "" msgid "" diff --git a/c-api/capsule.po b/c-api/capsule.po index 57f1ce2209..de4095f5b9 100644 --- a/c-api/capsule.po +++ b/c-api/capsule.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -104,8 +104,8 @@ msgstr "" msgid "" "It is legal for a capsule to have a ``NULL`` destructor. This makes a " -"``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :" -"c:func:`PyErr_Occurred` to disambiguate." +"``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` " +"or :c:func:`PyErr_Occurred` to disambiguate." msgstr "" msgid "" @@ -115,8 +115,8 @@ msgstr "" msgid "" "It is legal for a capsule to have a ``NULL`` context. This makes a ``NULL`` " -"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" -"`PyErr_Occurred` to disambiguate." +"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` " +"or :c:func:`PyErr_Occurred` to disambiguate." msgstr "" msgid "" @@ -126,8 +126,8 @@ msgstr "" msgid "" "It is legal for a capsule to have a ``NULL`` name. This makes a ``NULL`` " -"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" -"`PyErr_Occurred` to disambiguate." +"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` " +"or :c:func:`PyErr_Occurred` to disambiguate." msgstr "" msgid "" diff --git a/c-api/code.po b/c-api/code.po index 7e0ec17694..c084a50349 100644 --- a/c-api/code.po +++ b/c-api/code.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,8 +38,8 @@ msgid "" msgstr "" msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:" -"`code object `." +"This is an instance of :c:type:`PyTypeObject` representing the " +"Python :ref:`code object `." msgstr "" msgid "" @@ -69,8 +69,9 @@ msgid "" msgstr "" msgid "" -"Since the definition of the bytecode changes often, calling :c:func:" -"`PyUnstable_Code_New` directly can bind you to a precise Python version." +"Since the definition of the bytecode changes often, " +"calling :c:func:`PyUnstable_Code_New` directly can bind you to a precise " +"Python version." msgstr "" msgid "" @@ -112,13 +113,14 @@ msgstr "" msgid "" "Return the line number of the instruction that occurs on or before " -"``byte_offset`` and ends after it. If you just need the line number of a " -"frame, use :c:func:`PyFrame_GetLineNumber` instead." +"``byte_offset`` and ends after it. This may be ``O(N)`` in the number of " +"instructions in the code object, so it is not performant for iterating over " +"all the line numbers in a code object." msgstr "" msgid "" -"For efficiently iterating over the line numbers in a code object, use :pep:" -"`the API described in PEP 626 <0626#out-of-process-debuggers-and-profilers>`." +"If you just need the line number of a frame, " +"use :c:func:`PyFrame_GetLineNumber` instead." msgstr "" msgid "" @@ -157,9 +159,9 @@ msgstr "" msgid "" "Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new " -"reference to a :c:type:`PyTupleObject` containing the names of the :term:" -"`free (closure) variables `. On error, ``NULL`` is " -"returned and an exception is raised." +"reference to a :c:type:`PyTupleObject` containing the names of " +"the :term:`free (closure) variables `. On error, ``NULL`` " +"is returned and an exception is raised." msgstr "" msgid "" @@ -170,10 +172,10 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyCode_AddWatcher` for the current interpreter. Return ``0`` on success, or " -"``-1`` and set an exception on error (e.g. if the given *watcher_id* was " -"never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyCode_AddWatcher` for the current interpreter. Return ``0`` " +"on success, or ``-1`` and set an exception on error (e.g. if the given " +"*watcher_id* was never registered.)" msgstr "" msgid "" @@ -181,6 +183,12 @@ msgid "" "``PY_CODE_EVENT_CREATE`` - ``PY_CODE_EVENT_DESTROY``" msgstr "" +msgid "" +"Apply the macro *V* to each suffix of :c:type:`PyCodeEvent` constants. " +"Currently expands to ``V(CREATE) V(DESTROY)``. The macro *V* must accept one " +"event name and supply any punctuation needed between expansions." +msgstr "" + msgid "Type of a code object watcher callback function." msgstr "" @@ -209,8 +217,8 @@ msgstr "" msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" @@ -221,7 +229,7 @@ msgid "" "it before returning." msgstr "" -msgid "This is a :term:`soft deprecated` function that does nothing." +msgid "This is a function that does nothing." msgstr "" msgid "" @@ -236,17 +244,17 @@ msgid "Code Object Flags" msgstr "" msgid "" -"Code objects contain a bit-field of flags, which can be retrieved as the :" -"attr:`~codeobject.co_flags` Python attribute (for example using :c:func:" -"`PyObject_GetAttrString`), and set using a *flags* argument to :c:func:" -"`PyUnstable_Code_New` and similar functions." +"Code objects contain a bit-field of flags, which can be retrieved as " +"the :attr:`~codeobject.co_flags` Python attribute (for example " +"using :c:func:`PyObject_GetAttrString`), and set using a *flags* argument " +"to :c:func:`PyUnstable_Code_New` and similar functions." msgstr "" msgid "" "Flags whose names start with ``CO_FUTURE_`` correspond to features normally " -"selectable by :ref:`future statements `. These flags can be used in :" -"c:member:`PyCompilerFlags.cf_flags`. Note that many ``CO_FUTURE_`` flags are " -"mandatory in current versions of Python, and setting them has no effect." +"selectable by :ref:`future statements `. These flags can be used " +"in :c:member:`PyCompilerFlags.cf_flags`. Note that many ``CO_FUTURE_`` flags " +"are mandatory in current versions of Python, and setting them has no effect." msgstr "" msgid "" @@ -340,8 +348,8 @@ msgstr "" msgid "" "If *free* is not ``NULL``: when a code object is deallocated, *free* will be " -"called on non-``NULL`` data stored under the new index. Use :c:func:" -"`Py_DecRef` when storing :c:type:`PyObject`." +"called on non-``NULL`` data stored under the new index. " +"Use :c:func:`Py_DecRef` when storing :c:type:`PyObject`." msgstr "" msgid "as ``_PyEval_RequestCodeExtraIndex``" diff --git a/c-api/codec.po b/c-api/codec.po index 8814b09302..55a935e031 100644 --- a/c-api/codec.po +++ b/c-api/codec.po @@ -51,8 +51,8 @@ msgstr "" msgid "" "*object* is passed through the encoder function found for the given " "*encoding* using the error handling method defined by *errors*. *errors* " -"may be ``NULL`` to use the default method defined for the codec. Raises a :" -"exc:`LookupError` if no encoder can be found." +"may be ``NULL`` to use the default method defined for the codec. Raises " +"a :exc:`LookupError` if no encoder can be found." msgstr "" msgid "Generic codec based decoding API." @@ -61,8 +61,8 @@ msgstr "" msgid "" "*object* is passed through the decoder function found for the given " "*encoding* using the error handling method defined by *errors*. *errors* " -"may be ``NULL`` to use the default method defined for the codec. Raises a :" -"exc:`LookupError` if no encoder can be found." +"may be ``NULL`` to use the default method defined for the codec. Raises " +"a :exc:`LookupError` if no encoder can be found." msgstr "" msgid "Codec lookup API" @@ -71,8 +71,8 @@ msgstr "" msgid "" "In the following functions, the *encoding* string is looked up converted to " "all lower-case characters, which makes encodings looked up through this " -"mechanism effectively case-insensitive. If no codec is found, a :exc:" -"`KeyError` is set and ``NULL`` returned." +"mechanism effectively case-insensitive. If no codec is found, " +"a :exc:`KeyError` is set and ``NULL`` returned." msgstr "" msgid "Get an encoder function for the given *encoding*." @@ -110,9 +110,9 @@ msgid "" msgstr "" msgid "" -"The callback gets a single argument, an instance of :exc:" -"`UnicodeEncodeError`, :exc:`UnicodeDecodeError` or :exc:" -"`UnicodeTranslateError` that holds information about the problematic " +"The callback gets a single argument, an instance " +"of :exc:`UnicodeEncodeError`, :exc:`UnicodeDecodeError` " +"or :exc:`UnicodeTranslateError` that holds information about the problematic " "sequence of characters or bytes and their offset in the original string " "(see :ref:`unicodeexceptions` for functions to extract this information). " "The callback must either raise the given exception, or return a two-item " diff --git a/c-api/complex.po b/c-api/complex.po index 4dafa46cb3..1d7036960b 100644 --- a/c-api/complex.po +++ b/c-api/complex.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -67,43 +67,43 @@ msgid "" "Return the sum of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -"Zwraca sumę dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca sumę dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" -"Return the difference between two complex numbers, using the C :c:type:" -"`Py_complex` representation." +"Return the difference between two complex numbers, using the " +"C :c:type:`Py_complex` representation." msgstr "" -"Zwraca różnicę dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca różnicę dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" -"Return the negation of the complex number *num*, using the C :c:type:" -"`Py_complex` representation." +"Return the negation of the complex number *num*, using the " +"C :c:type:`Py_complex` representation." msgstr "" msgid "" "Return the product of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -"Zwraca iloczyn dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca iloczyn dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" "Return the quotient of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -"Zwraca iloraz dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca iloraz dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" -"If *divisor* is null, this method returns zero and sets :c:data:`errno` to :" -"c:macro:`!EDOM`." +"If *divisor* is null, this method returns zero and sets :c:data:`errno` " +"to :c:macro:`!EDOM`." msgstr "" msgid "" -"Return the exponentiation of *num* by *exp*, using the C :c:type:" -"`Py_complex` representation." +"Return the exponentiation of *num* by *exp*, using the " +"C :c:type:`Py_complex` representation." msgstr "" msgid "" @@ -127,8 +127,8 @@ msgid "" msgstr "" msgid "" -"Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :" -"c:type:`PyComplexObject`. This function always succeeds." +"Return true if its argument is a :c:type:`PyComplexObject` or a subtype " +"of :c:type:`PyComplexObject`. This function always succeeds." msgstr "" msgid "" @@ -150,10 +150,11 @@ msgid "Return the real part of *op* as a C :c:expr:`double`." msgstr "" msgid "" -"If *op* is not a Python complex number object but has a :meth:`~object." -"__complex__` method, this method will first be called to convert *op* to a " -"Python complex number object. If :meth:`!__complex__` is not defined then " -"it falls back to call :c:func:`PyFloat_AsDouble` and returns its result." +"If *op* is not a Python complex number object but has " +"a :meth:`~object.__complex__` method, this method will first be called to " +"convert *op* to a Python complex number object. If :meth:`!__complex__` is " +"not defined then it falls back to call :c:func:`PyFloat_AsDouble` and " +"returns its result." msgstr "" msgid "" @@ -168,28 +169,28 @@ msgid "Return the imaginary part of *op* as a C :c:expr:`double`." msgstr "" msgid "" -"If *op* is not a Python complex number object but has a :meth:`~object." -"__complex__` method, this method will first be called to convert *op* to a " -"Python complex number object. If :meth:`!__complex__` is not defined then " -"it falls back to call :c:func:`PyFloat_AsDouble` and returns ``0.0`` on " -"success." +"If *op* is not a Python complex number object but has " +"a :meth:`~object.__complex__` method, this method will first be called to " +"convert *op* to a Python complex number object. If :meth:`!__complex__` is " +"not defined then it falls back to call :c:func:`PyFloat_AsDouble` and " +"returns ``0.0`` on success." msgstr "" msgid "Return the :c:type:`Py_complex` value of the complex number *op*." msgstr "" msgid "" -"If *op* is not a Python complex number object but has a :meth:`~object." -"__complex__` method, this method will first be called to convert *op* to a " -"Python complex number object. If :meth:`!__complex__` is not defined then " -"it falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not " -"defined then it falls back to :meth:`~object.__index__`." +"If *op* is not a Python complex number object but has " +"a :meth:`~object.__complex__` method, this method will first be called to " +"convert *op* to a Python complex number object. If :meth:`!__complex__` is " +"not defined then it falls back to :meth:`~object.__float__`. If :meth:`!" +"__float__` is not defined then it falls back to :meth:`~object.__index__`." msgstr "" msgid "" -"Upon failure, this method returns :c:type:`Py_complex` with :c:member:" -"`~Py_complex.real` set to ``-1.0`` and with an exception set, so one should " -"call :c:func:`PyErr_Occurred` to check for errors." +"Upon failure, this method returns :c:type:`Py_complex` " +"with :c:member:`~Py_complex.real` set to ``-1.0`` and with an exception set, " +"so one should call :c:func:`PyErr_Occurred` to check for errors." msgstr "" msgid "Use :meth:`~object.__index__` if available." diff --git a/c-api/concrete.po b/c-api/concrete.po index d34b47edae..87caf30bc4 100644 --- a/c-api/concrete.po +++ b/c-api/concrete.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/contextvars.po b/c-api/contextvars.po index e345dcc764..b7797b004f 100644 --- a/c-api/contextvars.po +++ b/c-api/contextvars.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,8 +28,9 @@ msgstr "" msgid "" "In Python 3.7.1 the signatures of all context variables C APIs were " -"**changed** to use :c:type:`PyObject` pointers instead of :c:type:" -"`PyContext`, :c:type:`PyContextVar`, and :c:type:`PyContextToken`, e.g.::" +"**changed** to use :c:type:`PyObject` pointers instead " +"of :c:type:`PyContext`, :c:type:`PyContextVar`, " +"and :c:type:`PyContextToken`, e.g.::" msgstr "" msgid "" @@ -122,10 +123,10 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyContext_AddWatcher` for the current interpreter. Return ``0`` on success, " -"or ``-1`` and set an exception on error (e.g. if the given *watcher_id* was " -"never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyContext_AddWatcher` for the current interpreter. Return " +"``0`` on success, or ``-1`` and set an exception on error (e.g. if the given " +"*watcher_id* was never registered.)" msgstr "" msgid "Enumeration of possible context object watcher events:" @@ -145,8 +146,8 @@ msgstr "" msgid "" "If the callback returns with an exception set, it must return ``-1``; this " -"exception will be printed as an unraisable exception using :c:func:" -"`PyErr_FormatUnraisable`. Otherwise it should return ``0``." +"exception will be printed as an unraisable exception " +"using :c:func:`PyErr_FormatUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" @@ -196,7 +197,7 @@ msgid "" msgstr "" msgid "" -"Reset the state of the *var* context variable to that it was in before :c:" -"func:`PyContextVar_Set` that returned the *token* was called. This function " -"returns ``0`` on success and ``-1`` on error." +"Reset the state of the *var* context variable to that it was in " +"before :c:func:`PyContextVar_Set` that returned the *token* was called. This " +"function returns ``0`` on success and ``-1`` on error." msgstr "" diff --git a/c-api/conversion.po b/c-api/conversion.po index f980a8955b..cf44e07ab2 100644 --- a/c-api/conversion.po +++ b/c-api/conversion.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,22 +24,28 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "String conversion and formatting" -msgstr "" +msgstr "Napis Konwersja i formatowanie ciągów znaków" msgid "Functions for number conversion and formatted string output." -msgstr "" +msgstr "funkcja do konwersji liczb i formatowania napis wyjście." msgid "" "Output not more than *size* bytes to *str* according to the format string " -"*format* and the extra arguments. See the Unix man page :manpage:" -"`snprintf(3)`." +"*format* and the extra arguments. See the Unix man " +"page :manpage:`snprintf(3)`." msgstr "" +"Wyjście nie więcej niż *size* bajtów do *str* zgodnie z format napis " +"*format* i ekstra argument. Zobacz stronę podręcznika " +"Unix :manpage:`snprintf(3)`." msgid "" "Output not more than *size* bytes to *str* according to the format string " -"*format* and the variable argument list *va*. Unix man page :manpage:" -"`vsnprintf(3)`." +"*format* and the variable argument list *va*. Unix man " +"page :manpage:`vsnprintf(3)`." msgstr "" +"Wyprowadzaj nie więcej niż *size* bajtów do *str* zgodnie z ciągiem format " +"napis ującym *format* i listą argument ów zmiennych *va*. Strona podręcznika " +"systemu Unix :manpage:`vsnprintf(3)`." msgid "" ":c:func:`PyOS_snprintf` and :c:func:`PyOS_vsnprintf` wrap the Standard C " @@ -47,6 +53,10 @@ msgid "" "is to guarantee consistent behavior in corner cases, which the Standard C " "functions do not." msgstr "" +":c:func:`PyOS_snprintf` I :c:func:`PyOS_vsnprintf` owinąć Standardowe C " +"biblioteka funkcja :c:func:`snprintf` I :c:func:`vsnprintf`. Ich cel jest " +"zagwarantowanie spójnego zachowanie w skrajnych przypadkach, czego nie " +"zapewniają Standardowe C funkcje języka C." msgid "" "The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. " @@ -56,33 +66,108 @@ msgid "" "equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine " "the necessary buffer size." msgstr "" +"Wraptory zapewniają, że ``str[size-1]`` zawsze jest to ``'\\0'`` wartość " +"zwracać. Nigdy nie zapisują więcej niż *size* bajtów (wliczając " +"końcowy``'\\0'`` ) do str. Obie funkcja wymagają aby ``str != NULL``, " +"``size > 0``, ``format != NULL`` i ``size < INT_MAX``. Należy pamiętać, że " +"oznacza to brak odpowiednika C99 ``n = snprintf(NULL, 0, ...)``, który " +"określałby wymagany rozmiar bufor size." msgid "" "The return value (*rv*) for these functions should be interpreted as follows:" msgstr "" +"The zwracana wartość (*rv*) dla tych funkcja należy interpretować je " +"następująco:" msgid "" "When ``0 <= rv < size``, the output conversion was successful and *rv* " "characters were written to *str* (excluding the trailing ``'\\0'`` byte at " "``str[rv]``)." msgstr "" +"Gdy ``0 <= rv < size``, konwersja danych wyjściowych zakończyła się " +"powodzeniem, a znaki *rv* znak zapisane w *str* (z wyłączeniem końcowego " +"``'\\0'`` bajt o godz ``str[rv]``)" msgid "" "When ``rv >= size``, the output conversion was truncated and a buffer with " "``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is " "``'\\0'`` in this case." msgstr "" +"Gdy ``rv >= size``, konwersja wyjściowa została skrócona, a bufor z ``rv + " +"1`` bajtów byłoby potrzebnych do osiągnięcia sukcesu. ``str[size-1]`` w " +"``'\\0'`` tym przypadku." msgid "" -"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in " -"this case too, but the rest of *str* is undefined. The exact cause of the " -"error depends on the underlying platform." +"When ``rv < 0``, the output conversion failed and ``str[size-1]`` is " +"``'\\0'`` in this case too, but the rest of *str* is undefined. The exact " +"cause of the error depends on the underlying platform." msgstr "" +"Gdy ``rv < 0``, konwersja wyjściowa nie powiodła się i ``str[size-1]`` w " +"``'\\0'`` W tym przypadku również, ale reszta *str* jest niezdefiniowana. " +"Dokładna przyczyna błędu zależy od platformy bazowej." msgid "" "The following functions provide locale-independent string to number " "conversions." msgstr "" +"Poniższe funkcje umożliwiają niezależną od ustawień regionalnych napis " +"konwersję ciągów znaków na liczby." + +msgid "" +"Convert the initial part of the string in ``str`` to an :c:expr:`unsigned " +"long` value according to the given ``base``, which must be between ``2`` and " +"``36`` inclusive, or be the special value ``0``." +msgstr "" +"Konwertuj początkową część ciągu napis na ``str`` do " +"wartości :c:expr:`unsigned long` zgodnie z podanym ``base`` , który musi " +"zawierać się pomiędzy ``2`` i ``36`` inkluzywny lub będący szczególną " +"wartość, ``0`` ." + +msgid "" +"Leading white space and case of characters are ignored. If ``base`` is zero " +"it looks for a leading ``0b``, ``0o`` or ``0x`` to tell which base. If " +"these are absent it defaults to ``10``. Base must be 0 or between 2 and 36 " +"(inclusive). If ``ptr`` is non-``NULL`` it will contain a pointer to the " +"end of the scan." +msgstr "" +"Spacje wiodące i wielkość liter są znak ignorowane. Jeśli ``base`` jest " +"zero, szuka wiodącego ``0b``, ``0o`` lub ``0x`` aby wskazać bazę. Jeżeli ich " +"brakuje, domyślnie ``10``. Podstawa musi wynosić 0 lub mieścić się w " +"przedziale od 2 do 36 (włącznie). Jeśli ``ptr`` jest różna od 0 ``NULL``, " +"będzie zawierać wskaźnik do końca skanowania." + +msgid "" +"If the converted value falls out of range of corresponding return type, " +"range error occurs (:c:data:`errno` is set to :c:macro:`!ERANGE`) " +"and :c:macro:`!ULONG_MAX` is returned. If no conversion can be performed, " +"``0`` is returned." +msgstr "" +"Jeśli przekonwertowana wartość wykracza poza zakres odpowiedniego typu " +"zwracać zwracanego, występuje błąd zakresu (:c:data:`errno` jest ustawiony " +"na :c:macro:`!ERANGE`) i :c:macro:`!ULONG_MAX` zwracana jest wartość. Jeśli " +"nie można wykonać konwersji, ``0`` zwracana jest wartość ." + +msgid "See also the Unix man page :manpage:`strtoul(3)`." +msgstr "patrz również the Unix man page :manpage:`strtoul(3)`." + +msgid "" +"Convert the initial part of the string in ``str`` to an :c:expr:`long` value " +"according to the given ``base``, which must be between ``2`` and ``36`` " +"inclusive, or be the special value ``0``." +msgstr "" +"Konwertuj początkową część napis ciągu na ``str`` do :c:expr:`long` wartość " +"zgodnie z podanym ``base``, która musi być pomiędzy ``2`` i ``36`` włącznie, " +"lub być wartość specjalną ``0``." + +msgid "" +"Same as :c:func:`PyOS_strtoul`, but return a :c:expr:`long` value instead " +"and :c:macro:`LONG_MAX` on overflows." +msgstr "" +"Taki sam jak :c:func:`PyOS_strtoul`, Ale zwracać A :c:expr:`long` wartość " +"zamiast i :c:macro:`LONG_MAX` na przepełnieniach." + +msgid "See also the Unix man page :manpage:`strtol(3)`." +msgstr "patrz również the Unix man page :manpage:`strtol(3)`." msgid "" "Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on " @@ -91,12 +176,20 @@ msgid "" "have leading or trailing whitespace. The conversion is independent of the " "current locale." msgstr "" +"Konwertuj ciąg napis ``s`` a :c:expr:`double`, rzucić a Python Wyjątek w " +"przypadku błędu. Zestaw akceptowanych ciągów napis znaków odpowiada " +"zestawowi ciągów znaków akceptowanych :func:`float`przez konstruktor Python " +"``s``, z tym wyjątkiem, że nie mogą one zawierać spacji na początku ani na " +"końcu. Konwersja jest niezależna od bieżącej lokalizacji." msgid "" -"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:" -"`ValueError` and return ``-1.0`` if the string is not a valid representation " -"of a floating-point number." +"If ``endptr`` is ``NULL``, convert the whole string. " +"Raise :exc:`ValueError` and return ``-1.0`` if the string is not a valid " +"representation of a floating-point number." msgstr "" +"Jeśli ``endptr`` jest ``NULL``, przekonwertować cały napis. " +"Rzucić :exc:`ValueError` I zwracać ``-1.0`` jeśli napis nie jest ważny " +"prawidłową reprezentacją liczby zmiennoprzecinkowej." msgid "" "If endptr is not ``NULL``, convert as much of the string as possible and set " @@ -105,11 +198,17 @@ msgid "" "number, set ``*endptr`` to point to the beginning of the string, raise " "ValueError, and return ``-1.0``." msgstr "" +"Jeśli endptr jest różny od ``NULL`` , konwertuj tak dużą część napis jak to " +"możliwe ``*endptr``, i ustaw wskaźnik na pierwszy nieprzekonwertowany znak. " +"Jeżeli żaden początkowy segment napis nie jest ważny prawidłową " +"reprezentacją liczby zmiennoprzecinkowej, ustaw go tak ``*endptr``, aby " +"wskazywał na początek napis, rzucić zgłoś wyjątek ValueError i zwracać " +"``-1.0`` ." msgid "" "If ``s`` represents a value that is too large to store in a float (for " "example, ``\"1e500\"`` is such a string on many platforms) then if " -"``overflow_exception`` is ``NULL`` return ``Py_HUGE_VAL`` (with an " +"``overflow_exception`` is ``NULL`` return ``Py_INFINITY`` (with an " "appropriate sign) and don't set any exception. Otherwise, " "``overflow_exception`` must point to a Python exception object; raise that " "exception and return ``-1.0``. In both cases, set ``*endptr`` to point to " @@ -120,11 +219,15 @@ msgid "" "If any other error occurs during the conversion (for example an out-of-" "memory error), set the appropriate Python exception and return ``-1.0``." msgstr "" +"Jeżeli podczas konwersji wystąpi jakikolwiek inny błąd (na przykład błąd " +"braku pamięci), ustaw odpowiedni wyjątek Pythona i zwracać ``-1.0``." msgid "" "Convert a :c:expr:`double` *val* to a string using supplied *format_code*, " "*precision*, and *flags*." msgstr "" +"Konwertuje :c:expr:`double` *val* na napis ciąg znaków przy użyciu " +"dostarczonych *format_code*, *precision* i *flags*." msgid "" "*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, " @@ -132,31 +235,43 @@ msgid "" "ignored. The ``'r'`` format code specifies the standard :func:`repr` format." msgstr "" -msgid "" -"*flags* can be zero or more of the values ``Py_DTSF_SIGN``, " -"``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:" +msgid "*flags* can be zero or more of the following values or-ed together:" msgstr "" msgid "" -"``Py_DTSF_SIGN`` means to always precede the returned string with a sign " -"character, even if *val* is non-negative." +"Always precede the returned string with a sign character, even if *val* is " +"non-negative." msgstr "" -msgid "" -"``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look " -"like an integer." +msgid "Ensure that the returned string will not look like an integer." msgstr "" msgid "" -"``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the " -"documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details." +"Apply \"alternate\" formatting rules. See the documentation for " +"the :c:func:`PyOS_snprintf` ``'#'`` specifier for details." +msgstr "" + +msgid "Negative zero is converted to positive zero." msgstr "" msgid "" "If *ptype* is non-``NULL``, then the value it points to will be set to one " -"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying " -"that *val* is a finite number, an infinite number, or not a number, " -"respectively." +"of the following constants depending on the type of *val*:" +msgstr "" + +msgid "*\\*ptype*" +msgstr "" + +msgid "type of *val*" +msgstr "" + +msgid "finite number" +msgstr "" + +msgid "infinite number" +msgstr "" + +msgid "not a number" msgstr "" msgid "" @@ -166,11 +281,104 @@ msgid "" msgstr "" msgid "" -"Case insensitive comparison of strings. The function works almost " -"identically to :c:func:`strcmp` except that it ignores the case." +"Case insensitive comparison of strings. These functions work almost " +"identically to :c:func:`!strcmp` and :c:func:`!strncmp` (respectively), " +"except that they ignore the case of ASCII characters." +msgstr "" +"Porównywanie ciągów znaków bez uwzględniania wielkości napis liter. Funkcja " +"te działają niemal identycznie :c:func:`!strcmp` I :c:func:`!strncmp` " +"(odpowiednio), z tą różnicą, że ignorują wielkość liter znak ASCII." + +msgid "" +"Return ``0`` if the strings are equal, a negative value if *str1* sorts " +"lexicographically before *str2*, or a positive value if it sorts after." +msgstr "" + +msgid "" +"In the *str1* or *str2* arguments, a NUL byte marks the end of the string. " +"For :c:func:`!PyOS_mystrnicmp`, the *size* argument gives the maximum size " +"of the string, as if NUL was present at the index given by *size*." +msgstr "" +"W argumentach *str1* lub *str2* bajt NUL oznacza koniec napis. For :c:func:`!" +"PyOS_mystrnicmp`, Argument *size* podaje maksymalny rozmiar napis ciągu, tak " +"jakby pod indeks określonym przez *size* znajdowała się wartość NUL." + +msgid "These functions do not use the locale." +msgstr "" + +msgid "Case insensitive comparison of strings." +msgstr "Porównywanie ciągów znaków bez uwzględniania wielkości napis." + +msgid "" +"On Windows, these are aliases of :c:func:`!stricmp` and :c:func:`!strnicmp`, " +"respectively." +msgstr "" +"W systemie Windows są to odpowiednio alias :c:func:`!stricmp` i :c:func:`!" +"strnicmp`, ." + +msgid "" +"On other platforms, they are aliases of :c:func:`PyOS_mystricmp` " +"and :c:func:`PyOS_mystrnicmp`, respectively." +msgstr "" +"Na innych platformach są to odpowiednio alias :c:func:`PyOS_mystricmp` " +"i :c:func:`PyOS_mystrnicmp` ." + +msgid "Character classification and conversion" +msgstr "Klasyfikacja i znak konwersja postaci" + +msgid "" +"The following macros provide locale-independent (unlike the C standard " +"library ``ctype.h``) character classification and conversion. The argument " +"must be a signed or unsigned :c:expr:`char`." +msgstr "" +"Poniższe makro zapewniają niezależną od ustawień regionalnych (w " +"przeciwieństwie do biblioteka standardowa C ``ctype.h``) klasyfikację i " +"konwersję znak. Argument musi być znakiem lub znakiem :c:expr:`char`." + +msgid "Return true if the character *c* is an alphanumeric character." +msgstr "" + +msgid "" +"Return true if the character *c* is an alphabetic character (``a-z`` and ``A-" +"Z``)." +msgstr "" + +msgid "Return true if the character *c* is a decimal digit (``0-9``)." +msgstr "" + +msgid "Return true if the character *c* is a lowercase ASCII letter (``a-z``)." +msgstr "" +"Zwraca prawda wartość true, jeśli znak *c* jest małą literą ASCII (``a-z``)." + +msgid "" +"Return true if the character *c* is an uppercase ASCII letter (``A-Z``)." +msgstr "Zwraca prawda jeśli znak *c* to wielka litera ASCII (``A-Z``)." + +msgid "" +"Return true if the character *c* is a whitespace character (space, tab, " +"carriage return, newline, vertical tab, or form feed)." +msgstr "" + +msgid "" +"Return true if the character *c* is a hexadecimal digit (``0-9``, ``a-f``, " +"and ``A-F``)." +msgstr "" + +msgid "Return the lowercase equivalent of the character *c*." +msgstr "Zwraca odpowiednik małej litery znak *c*." + +msgid "Return the uppercase equivalent of the character *c*." +msgstr "Zwraca odpowiednik wielkiej litery znak *c*." + +msgid "Bit masks" +msgstr "" + +msgid "" +"The following constants are bit masks used by the character classification " +"macros above:" msgstr "" msgid "" -"Case insensitive comparison of strings. The function works almost " -"identically to :c:func:`strncmp` except that it ignores the case." +"Values used internally by the ``Py_IS*`` classification macros above. " +"Exposed for backwards compatibility only." msgstr "" diff --git a/c-api/datetime.po b/c-api/datetime.po index a0be7a1ba0..8a44775522 100644 --- a/c-api/datetime.po +++ b/c-api/datetime.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,20 +29,20 @@ msgstr "" msgid "" "Various date and time objects are supplied by the :mod:`datetime` module. " "Before using any of these functions, the header file :file:`datetime.h` must " -"be included in your source (note that this is not included by :file:`Python." -"h`), and the macro :c:macro:`PyDateTime_IMPORT` must be invoked, usually as " -"part of the module initialisation function. The macro puts a pointer to a C " -"structure into a static variable, :c:data:`PyDateTimeAPI`, that is used by " -"the following macros." +"be included in your source (note that this is not included " +"by :file:`Python.h`), and the macro :c:macro:`PyDateTime_IMPORT` must be " +"invoked, usually as part of the module initialisation function. The macro " +"puts a pointer to a C structure into a static " +"variable, :c:data:`PyDateTimeAPI`, that is used by the following macros." msgstr "" msgid "Import the datetime C API." msgstr "" msgid "" -"On success, populate the :c:var:`PyDateTimeAPI` pointer. On failure, set :c:" -"var:`PyDateTimeAPI` to ``NULL`` and set an exception. The caller must check " -"if an error occurred via :c:func:`PyErr_Occurred`:" +"On success, populate the :c:var:`PyDateTimeAPI` pointer. On failure, " +"set :c:var:`PyDateTimeAPI` to ``NULL`` and set an exception. The caller must " +"check if an error occurred via :c:func:`PyErr_Occurred`:" msgstr "" msgid "" @@ -100,8 +100,8 @@ msgstr "" msgid "" "This instance of :c:type:`PyTypeObject` represents the Python type for the " -"difference between two datetime values; it is the same object as :class:" -"`datetime.timedelta` in the Python layer." +"difference between two datetime values; it is the same object " +"as :class:`datetime.timedelta` in the Python layer." msgstr "" msgid "" @@ -113,8 +113,8 @@ msgid "Macro for access to the UTC singleton:" msgstr "" msgid "" -"Returns the time zone singleton representing UTC, the same object as :attr:" -"`datetime.timezone.utc`." +"Returns the time zone singleton representing UTC, the same object " +"as :attr:`datetime.timezone.utc`." msgstr "" msgid "Type-check macros:" @@ -222,9 +222,9 @@ msgstr "" msgid "" "Macros to extract fields from date objects. The argument must be an " -"instance of :c:type:`PyDateTime_Date`, including subclasses (such as :c:type:" -"`PyDateTime_DateTime`). The argument must not be ``NULL``, and the type is " -"not checked:" +"instance of :c:type:`PyDateTime_Date`, including subclasses (such " +"as :c:type:`PyDateTime_DateTime`). The argument must not be ``NULL``, and " +"the type is not checked:" msgstr "" msgid "Return the year, as a positive int." diff --git a/c-api/dict.po b/c-api/dict.po index 085402ccd8..a60ae640e4 100644 --- a/c-api/dict.po +++ b/c-api/dict.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -61,12 +61,13 @@ msgid "" msgstr "" msgid "" -"The type object for mapping proxy objects created by :c:func:" -"`PyDictProxy_New` and for the read-only ``__dict__`` attribute of many built-" -"in types. A :c:type:`PyDictProxy_Type` instance provides a dynamic, read-" -"only view of an underlying dictionary: changes to the underlying dictionary " -"are reflected in the proxy, but the proxy itself does not support mutation " -"operations. This corresponds to :class:`types.MappingProxyType` in Python." +"The type object for mapping proxy objects created " +"by :c:func:`PyDictProxy_New` and for the read-only ``__dict__`` attribute of " +"many built-in types. A :c:type:`PyDictProxy_Type` instance provides a " +"dynamic, read-only view of an underlying dictionary: changes to the " +"underlying dictionary are reflected in the proxy, but the proxy itself does " +"not support mutation operations. This corresponds " +"to :class:`types.MappingProxyType` in Python." msgstr "" msgid "Empty an existing dictionary of all key-value pairs." @@ -80,43 +81,43 @@ msgstr "" msgid "" "The operation is atomic on :term:`free threading ` when " -"*key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` or :class:" -"`bytes`." +"*key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` " +"or :class:`bytes`." msgstr "" msgid "" -"This is the same as :c:func:`PyDict_Contains`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_Contains`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "Return a new dictionary that contains the same key-value pairs as *p*." msgstr "Zwraca nowy słownik zawierający te same pary klucz-wartość co *p*." msgid "" -"Insert *val* into the dictionary *p* with a key of *key*. *key* must be :" -"term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` " -"on success or ``-1`` on failure. This function *does not* steal a reference " -"to *val*." +"Insert *val* into the dictionary *p* with a key of *key*. *key* must " +"be :term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return " +"``0`` on success or ``-1`` on failure. This function *does not* " +"\":term:`steal`\" a reference to *val*." msgstr "" msgid "" -"This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as a :c:" -"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Remove the entry in dictionary *p* with key *key*. *key* must be :term:" -"`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is not in the " -"dictionary, :exc:`KeyError` is raised. Return ``0`` on success or ``-1`` on " -"failure." +"Remove the entry in dictionary *p* with key *key*. *key* must " +"be :term:`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is " +"not in the dictionary, :exc:`KeyError` is raised. Return ``0`` on success or " +"``-1`` on failure." msgstr "" msgid "" -"This is the same as :c:func:`PyDict_DelItem`, but *key* is specified as a :c:" -"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_DelItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -132,7 +133,8 @@ msgstr "" msgid "If the key is missing, set *\\*result* to ``NULL`` and return ``0``." msgstr "" -msgid "On error, raise an exception and return ``-1``." +msgid "" +"On error, raise an exception, set *\\*result* to ``NULL`` and return ``-1``." msgstr "" msgid "See also the :c:func:`PyObject_GetItem` function." @@ -145,9 +147,9 @@ msgid "" msgstr "" msgid "" -"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:" -"`~object.__eq__` methods are silently ignored. Prefer the :c:func:" -"`PyDict_GetItemWithError` function instead." +"Exceptions that occur while this calls :meth:`~object.__hash__` " +"and :meth:`~object.__eq__` methods are silently ignored. Prefer " +"the :c:func:`PyDict_GetItemWithError` function instead." msgstr "" msgid "" @@ -168,16 +170,17 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:" -"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:" -"`~object.__eq__` methods or while creating the temporary :class:`str` object " -"are silently ignored. Prefer using the :c:func:`PyDict_GetItemWithError` " -"function with your own :c:func:`PyUnicode_FromString` *key* instead." +"Exceptions that occur while this calls :meth:`~object.__hash__` " +"and :meth:`~object.__eq__` methods or while creating the " +"temporary :class:`str` object are silently ignored. Prefer using " +"the :c:func:`PyDict_GetItemWithError` function with your " +"own :c:func:`PyUnicode_FromString` *key* instead." msgstr "" msgid "" @@ -188,8 +191,9 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyDict_GetItemRef`, but *key* is specified as a :c:expr:" -"`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`." +"Similar to :c:func:`PyDict_GetItemRef`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -241,9 +245,12 @@ msgid "" "``NULL``, and return ``0``." msgstr "" +msgid "On error, raise an exception and return ``-1``." +msgstr "" + msgid "" -"Similar to :meth:`dict.pop`, but without the default value and not raising :" -"exc:`KeyError` if the key is missing." +"Similar to :meth:`dict.pop`, but without the default value and not " +"raising :exc:`KeyError` if the key is missing." msgstr "" msgid "" @@ -274,16 +281,16 @@ msgid "Similar to :c:func:`PyDict_Size`, but without error checking." msgstr "" msgid "" -"Iterate over all key-value pairs in the dictionary *p*. The :c:type:" -"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the " -"first call to this function to start the iteration; the function returns " -"true for each pair in the dictionary, and false once all pairs have been " -"reported. The parameters *pkey* and *pvalue* should either point to :c:expr:" -"`PyObject*` variables that will be filled in with each key and value, " -"respectively, or may be ``NULL``. Any references returned through them are " -"borrowed. *ppos* should not be altered during iteration. Its value " -"represents offsets within the internal dictionary structure, and since the " -"structure is sparse, the offsets are not consecutive." +"Iterate over all key-value pairs in the dictionary *p*. " +"The :c:type:`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` " +"prior to the first call to this function to start the iteration; the " +"function returns true for each pair in the dictionary, and false once all " +"pairs have been reported. The parameters *pkey* and *pvalue* should either " +"point to :c:expr:`PyObject*` variables that will be filled in with each key " +"and value, respectively, or may be ``NULL``. Any references returned " +"through them are borrowed. *ppos* should not be altered during iteration. " +"Its value represents offsets within the internal dictionary structure, and " +"since the structure is sparse, the offsets are not consecutive." msgstr "" msgid "For example::" @@ -327,8 +334,9 @@ msgstr "" msgid "" "The function is not thread-safe in the :term:`free-threaded ` build without external synchronization. You can use :c:macro:" -"`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while iterating over it::" +"threading>` build without external synchronization. You can " +"use :c:macro:`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while " +"iterating over it::" msgstr "" msgid "" @@ -344,9 +352,9 @@ msgid "" "critical section. However, the references returned for *pkey* and *pvalue* " "are :term:`borrowed ` and are only valid while the " "critical section is held. If you need to use these objects outside the " -"critical section or when the critical section can be suspended, create a :" -"term:`strong reference ` (for example, using :c:func:" -"`Py_NewRef`)." +"critical section or when the critical section can be suspended, create " +"a :term:`strong reference ` (for example, " +"using :c:func:`Py_NewRef`)." msgstr "" msgid "" @@ -366,10 +374,10 @@ msgid "" msgstr "" msgid "" -"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a." -"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back " -"to the iterating over a sequence of key value pairs if the second argument " -"has no \"keys\" attribute. Return ``0`` on success or ``-1`` if an " +"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to " +"``a.update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall " +"back to the iterating over a sequence of key value pairs if the second " +"argument has no \"keys\" attribute. Return ``0`` on success or ``-1`` if an " "exception was raised." msgstr "" @@ -403,19 +411,20 @@ msgstr "" msgid "" "This function is not internally synchronized. In the :term:`free-threaded " -"` build, callers should ensure no concurrent calls to :c:" -"func:`PyDict_AddWatcher` or :c:func:`PyDict_ClearWatcher` are in progress." +"` build, callers should ensure no concurrent calls " +"to :c:func:`PyDict_AddWatcher` or :c:func:`PyDict_ClearWatcher` are in " +"progress." msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error (e.g. if the " -"given *watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error " +"(e.g. if the given *watcher_id* was never registered.)" msgstr "" msgid "" -"Mark dictionary *dict* as watched. The callback granted *watcher_id* by :c:" -"func:`PyDict_AddWatcher` will be called when *dict* is modified or " +"Mark dictionary *dict* as watched. The callback granted *watcher_id* " +"by :c:func:`PyDict_AddWatcher` will be called when *dict* is modified or " "deallocated. Return ``0`` on success or ``-1`` on error." msgstr "" @@ -433,6 +442,13 @@ msgid "" "``PyDict_EVENT_DEALLOCATED``." msgstr "" +msgid "" +"Apply the macro *V* to each suffix of :c:type:`PyDict_WatchEvent` constants. " +"Currently expands to ``V(ADDED) V(MODIFIED) V(DELETED) V(CLONED) V(CLEARED) " +"V(DEALLOCATED)``. The macro *V* must accept one event name and supply any " +"punctuation needed between expansions." +msgstr "" + msgid "Type of a dict watcher callback function." msgstr "" @@ -472,8 +488,8 @@ msgstr "" msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" @@ -533,8 +549,8 @@ msgid "" msgstr "" msgid "" -"Type object for ordered dictionaries. This is the same object as :class:" -"`collections.OrderedDict` in the Python layer." +"Type object for ordered dictionaries. This is the same object " +"as :class:`collections.OrderedDict` in the Python layer." msgstr "" msgid "" diff --git a/c-api/exceptions.po b/c-api/exceptions.po index 940141ee04..a9991ef95c 100644 --- a/c-api/exceptions.po +++ b/c-api/exceptions.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-21 15:07+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -99,9 +99,9 @@ msgstr "" msgid "" "If *set_sys_last_vars* is nonzero, the variable :data:`sys.last_exc` is set " "to the printed exception. For backwards compatibility, the deprecated " -"variables :data:`sys.last_type`, :data:`sys.last_value` and :data:`sys." -"last_traceback` are also set to the type, value and traceback of this " -"exception, respectively." +"variables :data:`sys.last_type`, :data:`sys.last_value` " +"and :data:`sys.last_traceback` are also set to the type, value and traceback " +"of this exception, respectively." msgstr "" msgid "The setting of :data:`sys.last_exc` was added." @@ -151,6 +151,23 @@ msgid "" "chained exceptions and notes." msgstr "" +msgid "Legacy variant of :c:func:`PyErr_DisplayException`." +msgstr "" + +msgid "" +"Print the exception *value* with its traceback to :data:`sys.stderr`. If " +"*value* has no traceback set, *tb* is used as its traceback. The first " +"argument is ignored." +msgstr "" + +msgid "" +"If :data:`sys.stderr` is ``None``, nothing is printed. If :data:`sys.stderr` " +"is not set, the exception is dumped to the C ``stderr`` stream instead." +msgstr "" + +msgid "Use :c:func:`PyErr_DisplayException` instead." +msgstr "" + msgid "Raising exceptions" msgstr "" @@ -176,8 +193,8 @@ msgstr "" msgid "" "This function sets the error indicator and returns ``NULL``. *exception* " "should be a Python exception class. The *format* and subsequent parameters " -"help format the error message; they have the same meaning and values as in :" -"c:func:`PyUnicode_FromFormat`. *format* is an ASCII-encoded string." +"help format the error message; they have the same meaning and values as " +"in :c:func:`PyUnicode_FromFormat`. *format* is an ASCII-encoded string." msgstr "" msgid "" @@ -204,13 +221,14 @@ msgid "" "This is a convenience function to raise an exception when a C library " "function has returned an error and set the C variable :c:data:`errno`. It " "constructs a tuple object whose first item is the integer :c:data:`errno` " -"value and whose second item is the corresponding error message (gotten from :" -"c:func:`!strerror`), and then calls ``PyErr_SetObject(type, object)``. On " -"Unix, when the :c:data:`errno` value is :c:macro:`!EINTR`, indicating an " -"interrupted system call, this calls :c:func:`PyErr_CheckSignals`, and if " -"that set the error indicator, leaves it set to that. The function always " -"returns ``NULL``, so a wrapper function around a system call can write " -"``return PyErr_SetFromErrno(type);`` when the system call returns an error." +"value and whose second item is the corresponding error message (gotten " +"from :c:func:`!strerror`), and then calls ``PyErr_SetObject(type, " +"object)``. On Unix, when the :c:data:`errno` value is :c:macro:`!EINTR`, " +"indicating an interrupted system call, this " +"calls :c:func:`PyErr_CheckSignals`, and if that set the error indicator, " +"leaves it set to that. The function always returns ``NULL``, so a wrapper " +"function around a system call can write ``return PyErr_SetFromErrno(type);`` " +"when the system call returns an error." msgstr "" msgid "" @@ -256,9 +274,9 @@ msgstr "" msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErr`, with the additional behavior " "that if *filename* is not ``NULL``, it is decoded from the filesystem " -"encoding (:func:`os.fsdecode`) and passed to the constructor of :exc:" -"`OSError` as a third parameter to be used to define the :attr:`!filename` " -"attribute of the exception instance." +"encoding (:func:`os.fsdecode`) and passed to the constructor " +"of :exc:`OSError` as a third parameter to be used to define the :attr:`!" +"filename` attribute of the exception instance." msgstr "" msgid "" @@ -330,9 +348,9 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyErr_ProgramTextObject`, but *filename* is a :c:expr:" -"`const char *`, which is decoded with the :term:`filesystem encoding and " -"error handler`, instead of a Python object reference." +"Similar to :c:func:`PyErr_ProgramTextObject`, but *filename* is " +"a :c:expr:`const char *`, which is decoded with the :term:`filesystem " +"encoding and error handler`, instead of a Python object reference." msgstr "" msgid "Issuing warnings" @@ -358,53 +376,58 @@ msgid "" "below) or ``NULL``; the *message* argument is a UTF-8 encoded string. " "*stack_level* is a positive number giving a number of stack frames; the " "warning will be issued from the currently executing line of code in that " -"stack frame. A *stack_level* of 1 is the function calling :c:func:" -"`PyErr_WarnEx`, 2 is the function above that, and so forth." +"stack frame. A *stack_level* of 1 is the function " +"calling :c:func:`PyErr_WarnEx`, 2 is the function above that, and so forth." msgstr "" msgid "" -"Warning categories must be subclasses of :c:data:`PyExc_Warning`; :c:data:" -"`PyExc_Warning` is a subclass of :c:data:`PyExc_Exception`; the default " -"warning category is :c:data:`PyExc_RuntimeWarning`. The standard Python " -"warning categories are available as global variables whose names are " -"enumerated at :ref:`standardwarningcategories`." +"Warning categories must be subclasses " +"of :c:data:`PyExc_Warning`; :c:data:`PyExc_Warning` is a subclass " +"of :c:data:`PyExc_Exception`; the default warning category " +"is :c:data:`PyExc_RuntimeWarning`. The standard Python warning categories " +"are available as global variables whose names are enumerated " +"at :ref:`standardwarningcategories`." msgstr "" msgid "" -"For information about warning control, see the documentation for the :mod:" -"`warnings` module and the :option:`-W` option in the command line " +"For information about warning control, see the documentation for " +"the :mod:`warnings` module and the :option:`-W` option in the command line " "documentation. There is no C API for warning control." msgstr "" +msgid "Equivalent to :c:expr:`PyErr_WarnEx(category, message, 1)`." +msgstr "" + msgid "" "Issue a warning message with explicit control over all warning attributes. " -"This is a straightforward wrapper around the Python function :func:`warnings." -"warn_explicit`; see there for more information. The *module* and *registry* " -"arguments may be set to ``NULL`` to get the default effect described there." +"This is a straightforward wrapper around the Python " +"function :func:`warnings.warn_explicit`; see there for more information. " +"The *module* and *registry* arguments may be set to ``NULL`` to get the " +"default effect described there." msgstr "" msgid "" "Similar to :c:func:`PyErr_WarnExplicitObject` except that *message* and " -"*module* are UTF-8 encoded strings, and *filename* is decoded from the :term:" -"`filesystem encoding and error handler`." +"*module* are UTF-8 encoded strings, and *filename* is decoded from " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "" -"Function similar to :c:func:`PyErr_WarnEx`, but use :c:func:" -"`PyUnicode_FromFormat` to format the warning message. *format* is an ASCII-" -"encoded string." +"Function similar to :c:func:`PyErr_WarnEx`, but " +"uses :c:func:`PyUnicode_FromFormat` to format the warning message. *format* " +"is an ASCII-encoded string." msgstr "" msgid "" -"Similar to :c:func:`PyErr_WarnExplicit`, but uses :c:func:" -"`PyUnicode_FromFormat` to format the warning message. *format* is an ASCII-" -"encoded string." +"Similar to :c:func:`PyErr_WarnExplicit`, but " +"uses :c:func:`PyUnicode_FromFormat` to format the warning message. *format* " +"is an ASCII-encoded string." msgstr "" msgid "" -"Function similar to :c:func:`PyErr_WarnFormat`, but *category* is :exc:" -"`ResourceWarning` and it passes *source* to :class:`!warnings." -"WarningMessage`." +"Function similar to :c:func:`PyErr_WarnFormat`, but *category* " +"is :exc:`ResourceWarning` and it passes *source* to :class:`!" +"warnings.WarningMessage`." msgstr "" msgid "Querying the error indicator" @@ -414,18 +437,19 @@ msgid "" "Test whether the error indicator is set. If set, return the exception " "*type* (the first argument to the last call to one of the ``PyErr_Set*`` " "functions or to :c:func:`PyErr_Restore`). If not set, return ``NULL``. You " -"do not own a reference to the return value, so you do not need to :c:func:" -"`Py_DECREF` it." +"do not own a reference to the return value, so you do not need " +"to :c:func:`Py_DECREF` it." msgstr "" msgid "The caller must have an :term:`attached thread state`." msgstr "" msgid "" -"Do not compare the return value to a specific exception; use :c:func:" -"`PyErr_ExceptionMatches` instead, shown below. (The comparison could easily " -"fail since the exception may be an instance instead of a class, in the case " -"of a class exception, or it may be a subclass of the expected exception.)" +"Do not compare the return value to a specific exception; " +"use :c:func:`PyErr_ExceptionMatches` instead, shown below. (The comparison " +"could easily fail since the exception may be an instance instead of a class, " +"in the case of a class exception, or it may be a subclass of the expected " +"exception.)" msgstr "" msgid "" @@ -471,10 +495,14 @@ msgstr "" msgid "" "Set *exc* as the exception currently being raised, clearing the existing " -"exception if one is set." +"exception if one is set. If *exc* is ``NULL``, just clear the existing " +"exception." +msgstr "" + +msgid "*exc* must be a valid exception or ``NULL``." msgstr "" -msgid "This call steals a reference to *exc*, which must be a valid exception." +msgid "This call \":term:`steals `\" a reference to *exc*." msgstr "" msgid "Use :c:func:`PyErr_GetRaisedException` instead." @@ -540,9 +568,10 @@ msgid "" msgstr "" msgid "" -"This function *does not* implicitly set the :attr:`~BaseException." -"__traceback__` attribute on the exception value. If setting the traceback " -"appropriately is desired, the following additional snippet is needed::" +"This function *does not* implicitly set " +"the :attr:`~BaseException.__traceback__` attribute on the exception value. " +"If setting the traceback appropriately is desired, the following additional " +"snippet is needed::" msgstr "" msgid "" @@ -552,10 +581,11 @@ msgid "" msgstr "" msgid "" -"Retrieve the active exception instance, as would be returned by :func:`sys." -"exception`. This refers to an exception that was *already caught*, not to an " -"exception that was freshly raised. Returns a new reference to the exception " -"or ``NULL``. Does not modify the interpreter's exception state." +"Retrieve the active exception instance, as would be returned " +"by :func:`sys.exception`. This refers to an exception that was *already " +"caught*, not to an exception that was freshly raised. Returns a new " +"reference to the exception or ``NULL``. Does not modify the interpreter's " +"exception state." msgstr "" msgid "" @@ -579,12 +609,12 @@ msgid "" msgstr "" msgid "" -"Retrieve the old-style representation of the exception info, as known from :" -"func:`sys.exc_info`. This refers to an exception that was *already caught*, " -"not to an exception that was freshly raised. Returns new references for the " -"three objects, any of which may be ``NULL``. Does not modify the exception " -"info state. This function is kept for backwards compatibility. Prefer " -"using :c:func:`PyErr_GetHandledException`." +"Retrieve the old-style representation of the exception info, as known " +"from :func:`sys.exc_info`. This refers to an exception that was *already " +"caught*, not to an exception that was freshly raised. Returns new " +"references for the three objects, any of which may be ``NULL``. Does not " +"modify the exception info state. This function is kept for backwards " +"compatibility. Prefer using :c:func:`PyErr_GetHandledException`." msgstr "" msgid "" @@ -597,10 +627,10 @@ msgstr "" msgid "" "Set the exception info, as known from ``sys.exc_info()``. This refers to an " "exception that was *already caught*, not to an exception that was freshly " -"raised. This function steals the references of the arguments. To clear the " -"exception state, pass ``NULL`` for all three arguments. This function is " -"kept for backwards compatibility. Prefer using :c:func:" -"`PyErr_SetHandledException`." +"raised. This function \":term:`steals `\" the references of the " +"arguments. To clear the exception state, pass ``NULL`` for all three " +"arguments. This function is kept for backwards compatibility. Prefer " +"using :c:func:`PyErr_SetHandledException`." msgstr "" msgid "" @@ -613,7 +643,8 @@ msgstr "" msgid "" "The ``type`` and ``traceback`` arguments are no longer used and can be NULL. " "The interpreter now derives them from the exception instance (the ``value`` " -"argument). The function still steals references of all three arguments." +"argument). The function still \":term:`steals `\" references of all " +"three arguments." msgstr "" msgid "Signal Handling" @@ -626,10 +657,10 @@ msgid "" msgstr "" msgid "" -"For example, pressing :kbd:`Ctrl-C` causes a terminal to send the :py:data:" -"`signal.SIGINT` signal. This function executes the corresponding Python " -"signal handler, which, by default, raises the :exc:`KeyboardInterrupt` " -"exception." +"For example, pressing :kbd:`Ctrl-C` causes a terminal to send " +"the :py:data:`signal.SIGINT` signal. This function executes the " +"corresponding Python signal handler, which, by default, raises " +"the :exc:`KeyboardInterrupt` exception." msgstr "" msgid "" @@ -641,8 +672,8 @@ msgid "Handlers invoked by this function currently include:" msgstr "" msgid "" -"Signal handlers, including Python functions registered using the :mod:" -"`signal` module." +"Signal handlers, including Python functions registered using " +"the :mod:`signal` module." msgstr "" msgid "" @@ -685,14 +716,14 @@ msgid "" msgstr "" msgid "" -"This function is async-signal-safe. It can be called without an :term:" -"`attached thread state` and from a C signal handler." +"This function is async-signal-safe. It can be called without " +"an :term:`attached thread state` and from a C signal handler." msgstr "" msgid "" -"Simulate the effect of a signal arriving. The next time :c:func:" -"`PyErr_CheckSignals` is called, the Python signal handler for the given " -"signal number will be called." +"Simulate the effect of a signal arriving. The next " +"time :c:func:`PyErr_CheckSignals` is called, the Python signal handler for " +"the given signal number will be called." msgstr "" msgid "" @@ -703,8 +734,9 @@ msgid "" msgstr "" msgid "" -"If the given signal isn't handled by Python (it was set to :py:const:`signal." -"SIG_DFL` or :py:const:`signal.SIG_IGN`), it will be ignored." +"If the given signal isn't handled by Python (it was set " +"to :py:const:`signal.SIG_DFL` or :py:const:`signal.SIG_IGN`), it will be " +"ignored." msgstr "" msgid "" @@ -795,7 +827,7 @@ msgstr "" msgid "" "Set the context associated with the exception to *ctx*. Use ``NULL`` to " "clear it. There is no type check to make sure that *ctx* is an exception " -"instance. This steals a reference to *ctx*." +"instance. This \":term:`steals `\" a reference to *ctx*." msgstr "" msgid "" @@ -808,7 +840,8 @@ msgstr "" msgid "" "Set the cause associated with the exception to *cause*. Use ``NULL`` to " "clear it. There is no type check to make sure that *cause* is either an " -"exception instance or ``None``. This steals a reference to *cause*." +"exception instance or ``None``. This \":term:`steals `\" a reference " +"to *cause*." msgstr "" msgid "" @@ -826,11 +859,11 @@ msgid "" "Implement part of the interpreter's implementation of :keyword:`!except*`. " "*orig* is the original exception that was caught, and *excs* is the list of " "the exceptions that need to be raised. This list contains the unhandled part " -"of *orig*, if any, as well as the exceptions that were raised from the :" -"keyword:`!except*` clauses (so they have a different traceback from *orig*) " -"and those that were reraised (and have the same traceback as *orig*). Return " -"the :exc:`ExceptionGroup` that needs to be reraised in the end, or ``None`` " -"if there is nothing to reraise." +"of *orig*, if any, as well as the exceptions that were raised from " +"the :keyword:`!except*` clauses (so they have a different traceback from " +"*orig*) and those that were reraised (and have the same traceback as " +"*orig*). Return the :exc:`ExceptionGroup` that needs to be reraised in the " +"end, or ``None`` if there is nothing to reraise." msgstr "" msgid "Unicode Exception Objects" @@ -925,6 +958,12 @@ msgid "" "Otherwise, zero is returned." msgstr "" +msgid "" +"The check is based on the remaining C stack space of the current thread, not " +"on a count of calls, so it is unaffected by :c:func:`Py_SetRecursionLimit` " +"and :func:`sys.setrecursionlimit`." +msgstr "" + msgid "" "*where* should be a UTF-8 encoded string such as ``\" in instance check\"`` " "to be concatenated to the :exc:`RecursionError` message caused by the " @@ -939,6 +978,11 @@ msgid "" "api>`." msgstr "" +msgid "" +"The check is based on the remaining C stack space. Previously, a separate " +"counter of C-level calls was used." +msgstr "" + msgid "" "Ends a :c:func:`Py_EnterRecursiveCall`. Must be called once for each " "*successful* invocation of :c:func:`Py_EnterRecursiveCall`." @@ -946,10 +990,10 @@ msgstr "" msgid "" "Properly implementing :c:member:`~PyTypeObject.tp_repr` for container types " -"requires special recursion handling. In addition to protecting the stack, :" -"c:member:`~PyTypeObject.tp_repr` also needs to track objects to prevent " -"cycles. The following two functions facilitate this functionality. " -"Effectively, these are the C equivalent to :func:`reprlib.recursive_repr`." +"requires special recursion handling. In addition to protecting the " +"stack, :c:member:`~PyTypeObject.tp_repr` also needs to track objects to " +"prevent cycles. The following two functions facilitate this functionality. " +"Effectively, these are the C equivalent to :deco:`reprlib.recursive_repr`." msgstr "" msgid "" @@ -960,8 +1004,9 @@ msgstr "" msgid "" "If the object has already been processed, the function returns a positive " "integer. In that case the :c:member:`~PyTypeObject.tp_repr` implementation " -"should return a string object indicating a cycle. As examples, :class:" -"`dict` objects return ``{...}`` and :class:`list` objects return ``[...]``." +"should return a string object indicating a cycle. As " +"examples, :class:`dict` objects return ``{...}`` and :class:`list` objects " +"return ``[...]``." msgstr "" msgid "" @@ -971,18 +1016,18 @@ msgid "" msgstr "" msgid "" -"Otherwise, the function returns zero and the :c:member:`~PyTypeObject." -"tp_repr` implementation can continue normally." +"Otherwise, the function returns zero and " +"the :c:member:`~PyTypeObject.tp_repr` implementation can continue normally." msgstr "" msgid "" -"Ends a :c:func:`Py_ReprEnter`. Must be called once for each invocation of :" -"c:func:`Py_ReprEnter` that returns zero." +"Ends a :c:func:`Py_ReprEnter`. Must be called once for each invocation " +"of :c:func:`Py_ReprEnter` that returns zero." msgstr "" msgid "" -"Get the recursion limit for the current interpreter. It can be set with :c:" -"func:`Py_SetRecursionLimit`. The recursion limit prevents the Python " +"Get the recursion limit for the current interpreter. It can be set " +"with :c:func:`Py_SetRecursionLimit`. The recursion limit prevents the Python " "interpreter stack from growing infinitely." msgstr "" @@ -1187,14 +1232,8 @@ msgid ":exc:`ZeroDivisionError`" msgstr ":exc:`ZeroDivisionError`" msgid "" -":c:data:`PyExc_BlockingIOError`, :c:data:`PyExc_BrokenPipeError`, :c:data:" -"`PyExc_ChildProcessError`, :c:data:`PyExc_ConnectionError`, :c:data:" -"`PyExc_ConnectionAbortedError`, :c:data:`PyExc_ConnectionRefusedError`, :c:" -"data:`PyExc_ConnectionResetError`, :c:data:`PyExc_FileExistsError`, :c:data:" -"`PyExc_FileNotFoundError`, :c:data:`PyExc_InterruptedError`, :c:data:" -"`PyExc_IsADirectoryError`, :c:data:`PyExc_NotADirectoryError`, :c:data:" -"`PyExc_PermissionError`, :c:data:`PyExc_ProcessLookupError` and :c:data:" -"`PyExc_TimeoutError` were introduced following :pep:`3151`." +":c:data:`PyExc_BlockingIOError`, :c:data:`PyExc_BrokenPipeError`, :c:data:`PyExc_ChildProcessError`, :c:data:`PyExc_ConnectionError`, :c:data:`PyExc_ConnectionAbortedError`, :c:data:`PyExc_ConnectionRefusedError`, :c:data:`PyExc_ConnectionResetError`, :c:data:`PyExc_FileExistsError`, :c:data:`PyExc_FileNotFoundError`, :c:data:`PyExc_InterruptedError`, :c:data:`PyExc_IsADirectoryError`, :c:data:`PyExc_NotADirectoryError`, :c:data:`PyExc_PermissionError`, :c:data:`PyExc_ProcessLookupError` " +"and :c:data:`PyExc_TimeoutError` were introduced following :pep:`3151`." msgstr "" msgid ":c:data:`PyExc_StopAsyncIteration` and :c:data:`PyExc_RecursionError`." @@ -1278,8 +1317,8 @@ msgid "Tracebacks" msgstr "" msgid "" -"Type object for traceback objects. This is available as :class:`types." -"TracebackType` in the Python layer." +"Type object for traceback objects. This is available " +"as :class:`types.TracebackType` in the Python layer." msgstr "" msgid "" diff --git a/c-api/extension-modules.po b/c-api/extension-modules.po new file mode 100644 index 0000000000..e8d028852f --- /dev/null +++ b/c-api/extension-modules.po @@ -0,0 +1,325 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Blessing Oluronbi, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Defining extension modules" +msgstr "Definiowanie modułów rozszerzeń" + +msgid "" +"A C extension for CPython is a shared library (for example, a ``.so`` file " +"on Linux, ``.pyd`` DLL on Windows), which is loadable into the Python " +"process (for example, it is compiled with compatible compiler settings), and " +"which exports an :ref:`initialization function `." +msgstr "" + +msgid "" +"To be importable by default (that is, " +"by :py:class:`importlib.machinery.ExtensionFileLoader`), the shared library " +"must be available on :py:attr:`sys.path`, and must be named after the module " +"name plus an extension listed " +"in :py:attr:`importlib.machinery.EXTENSION_SUFFIXES`." +msgstr "" +"Aby można było importować współdzielona biblioteka współdzieloną domyślny " +"(czyli przez :py:class:`importlib.machinery.ExtensionFileLoader` ), musi być " +"ona dostępna w :py:attr:`sys.path`, a jej nazwa musi składać się z nazwy " +"moduł i rozszerzenia wymienionego " +"w:py:attr:`importlib.machinery.EXTENSION_SUFFIXES` ." + +msgid "" +"Building, packaging and distributing extension modules is best done with " +"third-party tools, and is out of scope of this document. One suitable tool " +"is Setuptools, whose documentation can be found at https://" +"setuptools.pypa.io/en/latest/setuptools.html." +msgstr "" +"Kompilację, pakowanie i dystrybucję modułów rozszerzeń zewnętrzny wykonywać " +"za pomocą narzędzi firm trzecich, co wykracza poza zakres niniejszego " +"dokumentu. Jednym z odpowiednich narzędzi jest Setuptools, którego " +"dokumentację można znaleźć pod adresem https://setuptools.pypa.io/en/latest/" +"setuptools.html." + +msgid "" +"Normally, the initialization function returns a module definition " +"initialized using :c:func:`PyModuleDef_Init`. This allows splitting the " +"creation process into several phases:" +msgstr "" + +msgid "" +"Before any substantial code is executed, Python can determine which " +"capabilities the module supports, and it can adjust the environment or " +"refuse loading an incompatible extension." +msgstr "" + +msgid "" +"By default, Python itself creates the module object -- that is, it does the " +"equivalent of :py:meth:`object.__new__` for classes. It also sets initial " +"attributes like :attr:`~module.__package__` and :attr:`~module.__loader__`." +msgstr "" + +msgid "" +"Afterwards, the module object is initialized using extension-specific code " +"-- the equivalent of :py:meth:`~object.__init__` on classes." +msgstr "" + +msgid "" +"This is called *multi-phase initialization* to distinguish it from the " +"legacy (but still supported) *single-phase initialization* scheme, where the " +"initialization function returns a fully constructed module. See " +"the :ref:`single-phase-initialization section below ` for details." +msgstr "" + +msgid "Added support for multi-phase initialization (:pep:`489`)." +msgstr "" + +msgid "Multiple module instances" +msgstr "" + +msgid "" +"By default, extension modules are not singletons. For example, if " +"the :py:attr:`sys.modules` entry is removed and the module is re-imported, a " +"new module object is created, and typically populated with fresh method and " +"type objects. The old module is subject to normal garbage collection. This " +"mirrors the behavior of pure-Python modules." +msgstr "" + +msgid "" +"Additional module instances may be created in :ref:`sub-interpreters ` or after Python runtime reinitialization " +"(:c:func:`Py_Finalize` and :c:func:`Py_Initialize`). In these cases, sharing " +"Python objects between module instances would likely cause crashes or " +"undefined behavior." +msgstr "" + +msgid "" +"To avoid such issues, each instance of an extension module should be " +"*isolated*: changes to one instance should not implicitly affect the others, " +"and all state owned by the module, including references to Python objects, " +"should be specific to a particular module instance. See :ref:`isolating-" +"extensions-howto` for more details and a practical guide." +msgstr "" + +msgid "" +"A simpler way to avoid these issues is :ref:`raising an error on repeated " +"initialization `." +msgstr "" + +msgid "" +"All modules are expected to support :ref:`sub-interpreters `, or otherwise explicitly signal a lack of support. This is usually " +"achieved by isolation or blocking repeated initialization, as above. A " +"module may also be limited to the main interpreter using " +"the :c:data:`Py_mod_multiple_interpreters` slot." +msgstr "" + +msgid "Initialization function" +msgstr "" + +msgid "" +"The initialization function defined by an extension module has the following " +"signature:" +msgstr "" + +msgid "" +"Its name should be :samp:`PyInit_{}`, with ```` replaced by the " +"name of the module." +msgstr "" + +msgid "" +"For modules with ASCII-only names, the function must instead be " +"named :samp:`PyInit_{}`, with ```` replaced by the name of the " +"module. When using :ref:`multi-phase-initialization`, non-ASCII module names " +"are allowed. In this case, the initialization function name " +"is :samp:`PyInitU_{}`, with ```` encoded using Python's " +"*punycode* encoding with hyphens replaced by underscores. In Python:" +msgstr "" + +msgid "" +"def initfunc_name(name):\n" +" try:\n" +" suffix = b'_' + name.encode('ascii')\n" +" except UnicodeEncodeError:\n" +" suffix = b'U_' + name.encode('punycode').replace(b'-', b'_')\n" +" return b'PyInit' + suffix" +msgstr "" + +msgid "" +"It is recommended to define the initialization function using a helper macro:" +msgstr "" + +msgid "Declare an extension module initialization function. This macro:" +msgstr "" + +msgid "specifies the :c:expr:`PyObject*` return type," +msgstr "" + +msgid "adds any special linkage declarations required by the platform, and" +msgstr "" +"dodaje wszelkie specjalne deklaracje połączeń wymagane przez platformę i" + +msgid "for C++, declares the function as ``extern \"C\"``." +msgstr "dla C++ deklaruje funkcja jako" + +msgid "For example, a module called ``spam`` would be defined like this::" +msgstr "" +"Na przykład moduł o ``spam`` nazwie zostałby zdefiniowany w następujący " +"sposób:" + +msgid "" +"static struct PyModuleDef spam_module = {\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" +" .m_name = \"spam\",\n" +" ...\n" +"};\n" +"\n" +"PyMODINIT_FUNC\n" +"PyInit_spam(void)\n" +"{\n" +" return PyModuleDef_Init(&spam_module);\n" +"}" +msgstr "" + +msgid "" +"It is possible to export multiple modules from a single shared library by " +"defining multiple initialization functions. However, importing them requires " +"using symbolic links or a custom importer, because by default only the " +"function corresponding to the filename is found. See the `Multiple modules " +"in one library `__ section in :pep:`489` for details." +msgstr "" + +msgid "" +"The initialization function is typically the only non-\\ ``static`` item " +"defined in the module's C source." +msgstr "" + +msgid "Multi-phase initialization" +msgstr "Inicjalizacja wielofazowa" + +msgid "" +"Normally, the :ref:`initialization function ` " +"(``PyInit_modulename``) returns a :c:type:`PyModuleDef` instance with non-" +"``NULL`` :c:member:`~PyModuleDef.m_slots`. Before it is returned, the " +"``PyModuleDef`` instance must be initialized using the following function:" +msgstr "" + +msgid "" +"Ensure a module definition is a properly initialized Python object that " +"correctly reports its type and a reference count." +msgstr "" + +msgid "Return *def* cast to ``PyObject*``, or ``NULL`` if an error occurred." +msgstr "" + +msgid "" +"Calling this function is required for :ref:`multi-phase-initialization`. It " +"should not be used in other contexts." +msgstr "" + +msgid "" +"Note that Python assumes that ``PyModuleDef`` structures are statically " +"allocated. This function may return either a new reference or a borrowed " +"one; this reference must not be released." +msgstr "" + +msgid "Legacy single-phase initialization" +msgstr "" + +msgid "" +"Single-phase initialization is a legacy mechanism to initialize extension " +"modules, with known drawbacks and design flaws. Extension module authors are " +"encouraged to use multi-phase initialization instead." +msgstr "" + +msgid "" +"In single-phase initialization, the :ref:`initialization function ` (``PyInit_modulename``) should create, populate and return a " +"module object. This is typically done using :c:func:`PyModule_Create` and " +"functions like :c:func:`PyModule_AddObjectRef`." +msgstr "" + +msgid "" +"Single-phase initialization differs from the :ref:`default ` in the following ways:" +msgstr "" + +msgid "Single-phase modules are, or rather *contain*, “singletons”." +msgstr "" + +msgid "" +"When the module is first initialized, Python saves the contents of the " +"module's ``__dict__`` (that is, typically, the module's functions and types)." +msgstr "" + +msgid "" +"For subsequent imports, Python does not call the initialization function " +"again. Instead, it creates a new module object with a new ``__dict__``, and " +"copies the saved contents to it. For example, given a single-phase module " +"``_testsinglephase`` [#testsinglephase]_ that defines a function ``sum`` and " +"an exception class ``error``:" +msgstr "" + +msgid "" +">>> import sys\n" +">>> import _testsinglephase as one\n" +">>> del sys.modules['_testsinglephase']\n" +">>> import _testsinglephase as two\n" +">>> one is two\n" +"False\n" +">>> one.__dict__ is two.__dict__\n" +"False\n" +">>> one.sum is two.sum\n" +"True\n" +">>> one.error is two.error\n" +"True" +msgstr "" + +msgid "" +"The exact behavior should be considered a CPython implementation detail." +msgstr "" + +msgid "" +"To work around the fact that ``PyInit_modulename`` does not take a *spec* " +"argument, some state of the import machinery is saved and applied to the " +"first suitable module created during the ``PyInit_modulename`` call. " +"Specifically, when a sub-module is imported, this mechanism prepends the " +"parent package name to the name of the module." +msgstr "" + +msgid "" +"A single-phase ``PyInit_modulename`` function should create “its” module " +"object as soon as possible, before any other module objects can be created." +msgstr "" + +msgid "Non-ASCII module names (``PyInitU_modulename``) are not supported." +msgstr "" + +msgid "" +"Single-phase modules support module lookup functions " +"like :c:func:`PyState_FindModule`." +msgstr "" + +msgid "" +"``_testsinglephase`` is an internal module used in CPython's self-test " +"suite; your installation may or may not include it." +msgstr "" diff --git a/c-api/file.po b/c-api/file.po index 415f9a3d2c..09e7192a86 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,12 +29,12 @@ msgstr "" msgid "" "These APIs are a minimal emulation of the Python 2 C API for built-in file " "objects, which used to rely on the buffered I/O (:c:expr:`FILE*`) support " -"from the C standard library. In Python 3, files and streams use the new :" -"mod:`io` module, which defines several layers over the low-level unbuffered " -"I/O of the operating system. The functions described below are convenience " -"C wrappers over these new APIs, and meant mostly for internal error " -"reporting in the interpreter; third-party code is advised to access the :mod:" -"`io` APIs instead." +"from the C standard library. In Python 3, files and streams use the " +"new :mod:`io` module, which defines several layers over the low-level " +"unbuffered I/O of the operating system. The functions described below are " +"convenience C wrappers over these new APIs, and meant mostly for internal " +"error reporting in the interpreter; third-party code is advised to access " +"the :mod:`io` APIs instead." msgstr "" msgid "" @@ -57,22 +57,47 @@ msgstr "Zignoruj atrybut *name*." msgid "" "Return the file descriptor associated with *p* as an :c:expr:`int`. If the " -"object is an integer, its value is returned. If not, the object's :meth:" -"`~io.IOBase.fileno` method is called if it exists; the method must return an " -"integer, which is returned as the file descriptor value. Sets an exception " -"and returns ``-1`` on failure." +"object is an integer, its value is returned. If not, the " +"object's :meth:`~io.IOBase.fileno` method is called if it exists; the method " +"must return an integer, which is returned as the file descriptor value. " +"Sets an exception and returns ``-1`` on failure." msgstr "" msgid "" "Equivalent to ``p.readline([n])``, this function reads one line from the " -"object *p*. *p* may be a file object or any object with a :meth:`~io.IOBase." -"readline` method. If *n* is ``0``, exactly one line is read, regardless of " -"the length of the line. If *n* is greater than ``0``, no more than *n* " -"bytes will be read from the file; a partial line can be returned. In both " -"cases, an empty string is returned if the end of the file is reached " -"immediately. If *n* is less than ``0``, however, one line is read " -"regardless of length, but :exc:`EOFError` is raised if the end of the file " -"is reached immediately." +"object *p*. *p* may be a file object or any object with " +"a :meth:`~io.IOBase.readline` method. If *n* is ``0``, exactly one line is " +"read, regardless of the length of the line. If *n* is greater than ``0``, " +"no more than *n* bytes will be read from the file; a partial line can be " +"returned. In both cases, an empty string is returned if the end of the file " +"is reached immediately. If *n* is less than ``0``, however, one line is " +"read regardless of length, but :exc:`EOFError` is raised if the end of the " +"file is reached immediately." +msgstr "" + +msgid "" +"Read a line from the C stream *stream* into the buffer *buf*, like the C " +"standard library function :c:func:`!fgets`, but treating all of ``\\n``, " +"``\\r`` and ``\\r\\n`` as line endings (see :term:`universal newlines`). Any " +"``\\r`` or ``\\r\\n`` read from the stream is stored in *buf* as a single " +"``\\n``." +msgstr "" + +msgid "" +"At most ``n - 1`` characters are stored in *buf*; reading stops after a " +"newline has been stored or when the end of the file is reached. The result " +"is always null-terminated. *stream* should be opened in binary mode, so that " +"the C library does not perform its own newline translation." +msgstr "" + +msgid "" +"Return *buf* on success. Return ``NULL`` if no characters could be read, " +"because *stream* is at end of file, a read error occurred, or *n* is less " +"than 2. Like :c:func:`!fgets`, this function does not distinguish between " +"end of file and a read error, and it does not set an exception." +msgstr "" + +msgid "*fobj* exists only for backward compatibility and must be ``NULL``." msgstr "" msgid "" @@ -117,8 +142,9 @@ msgstr "" msgid "" "Open *path* with the mode ``'rb'``. *path* must be a Python :class:`str` " -"object. The behavior of this function may be overridden by :c:func:" -"`PyFile_SetOpenCodeHook` to allow for some preprocessing of the text." +"object. The behavior of this function may be overridden " +"by :c:func:`PyFile_SetOpenCodeHook` to allow for some preprocessing of the " +"text." msgstr "" msgid "This is analogous to :func:`io.open_code` in Python." @@ -131,8 +157,8 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 encoded :c:" -"expr:`const char*`." +"Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 " +"encoded :c:expr:`const char*`." msgstr "" msgid "" @@ -168,9 +194,14 @@ msgid "" msgstr "" msgid "" -"Type of file-like objects used internally at Python startup when :py:mod:" -"`io` is not yet available. Use Python :py:func:`open` or :c:func:" -"`PyFile_FromFd` to create file objects instead." +"Type of file-like objects used internally at Python startup " +"when :py:mod:`io` is not yet available. Use Python :py:func:`open` " +"or :c:func:`PyFile_FromFd` to create file objects instead." +msgstr "" + +msgid "" +"The string literal ``\"b\"``, used to open files in binary mode. Exposed for " +"backwards compatibility only." msgstr "" msgid "object" diff --git a/c-api/float.po b/c-api/float.po index 3ecc060c40..4e3a6070e1 100644 --- a/c-api/float.po +++ b/c-api/float.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,8 +36,8 @@ msgid "" msgstr "" msgid "" -"Return true if its argument is a :c:type:`PyFloatObject` or a subtype of :c:" -"type:`PyFloatObject`. This function always succeeds." +"Return true if its argument is a :c:type:`PyFloatObject` or a subtype " +"of :c:type:`PyFloatObject`. This function always succeeds." msgstr "" msgid "" @@ -56,11 +56,11 @@ msgstr "" msgid "" "Return a C :c:expr:`double` representation of the contents of *pyfloat*. If " -"*pyfloat* is not a Python floating-point object but has a :meth:`~object." -"__float__` method, this method will first be called to convert *pyfloat* " -"into a float. If :meth:`!__float__` is not defined then it falls back to :" -"meth:`~object.__index__`. This method returns ``-1.0`` upon failure, so one " -"should call :c:func:`PyErr_Occurred` to check for errors." +"*pyfloat* is not a Python floating-point object but has " +"a :meth:`~object.__float__` method, this method will first be called to " +"convert *pyfloat* into a float. If :meth:`!__float__` is not defined then it " +"falls back to :meth:`~object.__index__`. This method returns ``-1.0`` upon " +"failure, so one should call :c:func:`PyErr_Occurred` to check for errors." msgstr "" msgid "Use :meth:`~object.__index__` if available." @@ -78,8 +78,8 @@ msgid "" msgstr "" msgid "" -"Return the maximum representable finite float *DBL_MAX* as C :c:expr:" -"`double`." +"Return the maximum representable finite float *DBL_MAX* as " +"C :c:expr:`double`." msgstr "" msgid "" @@ -129,8 +129,8 @@ msgid "High precision (long double) definition of :data:`~math.pi` constant." msgstr "" msgid "" -"The definition (accurate for a :c:expr:`double` type) of the :data:`math." -"tau` constant." +"The definition (accurate for a :c:expr:`double` type) of " +"the :data:`math.tau` constant." msgstr "" msgid "Return :data:`math.nan` from a function." @@ -183,9 +183,9 @@ msgstr "" msgid "" "The pack and unpack functions provide an efficient platform-independent way " "to store floating-point values as byte strings. The Pack routines produce a " -"bytes string from a C :c:expr:`double`, and the Unpack routines produce a C :" -"c:expr:`double` from such a bytes string. The suffix (2, 4 or 8) specifies " -"the number of bytes in the bytes string." +"bytes string from a C :c:expr:`double`, and the Unpack routines produce a " +"C :c:expr:`double` from such a bytes string. The suffix (2, 4 or 8) " +"specifies the number of bytes in the bytes string." msgstr "" msgid "" @@ -215,12 +215,12 @@ msgid "Pack functions" msgstr "" msgid "" -"The pack routines write 2, 4 or 8 bytes, starting at *p*. *le* is an :c:expr:" -"`int` argument, non-zero if you want the bytes string in little-endian " -"format (exponent last, at ``p+1``, ``p+3``, or ``p+6`` and ``p+7``), zero if " -"you want big-endian format (exponent first, at *p*). The :c:macro:" -"`PY_BIG_ENDIAN` constant can be used to use the native endian: it is equal " -"to ``1`` on big endian processor, or ``0`` on little endian processor." +"The pack routines write 2, 4 or 8 bytes, starting at *p*. *le* is " +"an :c:expr:`int` argument, non-zero if you want the bytes string in little-" +"endian format (exponent last, at ``p+1``, ``p+3``, or ``p+6`` and ``p+7``), " +"zero if you want big-endian format (exponent first, at *p*). Use " +"the :c:macro:`PY_LITTLE_ENDIAN` constant to select the native endian: it is " +"equal to ``0`` on big endian processor, or ``1`` on little endian processor." msgstr "" msgid "" @@ -250,18 +250,18 @@ msgid "Unpack functions" msgstr "" msgid "" -"The unpack routines read 2, 4 or 8 bytes, starting at *p*. *le* is an :c:" -"expr:`int` argument, non-zero if the bytes string is in little-endian format " -"(exponent last, at ``p+1``, ``p+3`` or ``p+6`` and ``p+7``), zero if big-" -"endian (exponent first, at *p*). The :c:macro:`PY_BIG_ENDIAN` constant can " -"be used to use the native endian: it is equal to ``1`` on big endian " -"processor, or ``0`` on little endian processor." +"The unpack routines read 2, 4 or 8 bytes, starting at *p*. *le* is " +"an :c:expr:`int` argument, non-zero if the bytes string is in little-endian " +"format (exponent last, at ``p+1``, ``p+3`` or ``p+6`` and ``p+7``), zero if " +"big-endian (exponent first, at *p*). Use the :c:macro:`PY_LITTLE_ENDIAN` " +"constant to select the native endian: it is equal to ``0`` on big endian " +"processor, or ``1`` on little endian processor." msgstr "" msgid "" -"Return value: The unpacked double. On error, this is ``-1.0`` and :c:func:" -"`PyErr_Occurred` is true (and an exception is set, most likely :exc:" -"`OverflowError`)." +"Return value: The unpacked double. On error, this is ``-1.0`` " +"and :c:func:`PyErr_Occurred` is true (and an exception is set, most " +"likely :exc:`OverflowError`)." msgstr "" msgid "" diff --git a/c-api/frame.po b/c-api/frame.po index 48e09b2dc6..75b6dc4d8a 100644 --- a/c-api/frame.po +++ b/c-api/frame.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2022-11-05 19:48+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -23,7 +23,7 @@ msgstr "" "(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" -msgid "Frame Objects" +msgid "Frame objects" msgstr "" msgid "The C structure of the objects used to describe frame objects." @@ -46,30 +46,37 @@ msgid "See also :ref:`Reflection `." msgstr "" msgid "" -"The type of frame objects. It is the same object as :py:class:`types." -"FrameType` in the Python layer." +"The type of frame objects. It is the same object " +"as :py:class:`types.FrameType` in the Python layer." msgstr "" msgid "" "Previously, this type was only available after including ````." msgstr "" +msgid "" +"Create a new frame object. This function returns a :term:`strong reference` " +"to the new frame object on success, and returns ``NULL`` with an exception " +"set on failure." +msgstr "" + msgid "Return non-zero if *obj* is a frame object." msgstr "" msgid "" -"Previously, this function was only available after including ````." +"Previously, this function was only available after including " +"````." msgstr "" msgid "Get the *frame* next outer frame." msgstr "" msgid "" -"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame." +"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer " +"frame. This raises no exceptions." msgstr "" -msgid "Get the *frame*'s ``f_builtins`` attribute." +msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute." msgstr "" msgid "Return a :term:`strong reference`. The result cannot be ``NULL``." @@ -93,17 +100,160 @@ msgstr "" msgid "Return a :term:`strong reference`, or ``NULL``." msgstr "" -msgid "Get the *frame*'s ``f_globals`` attribute." +msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute." msgstr "" -msgid "Get the *frame*'s ``f_lasti`` attribute." +msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute." msgstr "" msgid "Returns -1 if ``frame.f_lasti`` is ``None``." msgstr "" -msgid "Get the *frame*'s ``f_locals`` attribute (:class:`dict`)." +msgid "Get the variable *name* of *frame*." +msgstr "" + +msgid "Return a :term:`strong reference` to the variable value on success." +msgstr "" + +msgid "" +"Raise :exc:`NameError` and return ``NULL`` if the variable does not exist." +msgstr "" + +msgid "Raise an exception and return ``NULL`` on error." +msgstr "" + +msgid "*name* type must be a :class:`str`." +msgstr "" + +msgid "" +"Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string " +"encoded in UTF-8." +msgstr "" + +msgid "" +"Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to " +"an :term:`optimized scope`, this returns a write-through proxy object that " +"allows modifying the locals. In all other cases (classes, " +"modules, :func:`exec`, :func:`eval`) it returns the mapping representing the " +"frame locals directly (as described for :func:`locals`)." +msgstr "" + +msgid "" +"As part of :pep:`667`, return an instance " +"of :c:var:`PyFrameLocalsProxy_Type`." msgstr "" msgid "Return the line number that *frame* is currently executing." msgstr "" + +msgid "Frame locals proxies" +msgstr "" + +msgid "" +"The :attr:`~frame.f_locals` attribute on a :ref:`frame object ` is an instance of a \"frame-locals proxy\". The proxy object " +"exposes a write-through view of the underlying locals dictionary for the " +"frame. This ensures that the variables exposed by ``f_locals`` are always up " +"to date with the live local variables in the frame itself." +msgstr "" + +msgid "See :pep:`667` for more information." +msgstr "" + +msgid "The type of frame :func:`locals` proxy objects." +msgstr "" + +msgid "Return non-zero if *obj* is a frame :func:`locals` proxy." +msgstr "" + +msgid "Legacy local variable APIs" +msgstr "" + +msgid "" +"These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothing. " +"They exist solely for backwards compatibility." +msgstr "" + +msgid "" +"Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` " +"attribute of *f* to the internal \"fast\" array of local variables, allowing " +"changes in frame objects to be visible to the interpreter. If *clear* was " +"true, this function would process variables that were unset in the locals " +"dictionary." +msgstr "" + +msgid "This function now does nothing." +msgstr "" + +msgid "" +"Prior to Python 3.13, this function would copy the internal \"fast\" array " +"of local variables (which is used by the interpreter) to " +"the :attr:`~frame.f_locals` attribute of *f*, allowing changes in local " +"variables to be visible to frame objects." +msgstr "" + +msgid "" +"Prior to Python 3.13, this function was similar " +"to :c:func:`PyFrame_FastToLocals`, but would return ``0`` on success, and " +"``-1`` with an exception set on failure." +msgstr "" + +msgid ":pep:`667`" +msgstr "" + +msgid "Internal frames" +msgstr "" + +msgid "Unless using :pep:`523`, you will not need this." +msgstr "" + +msgid "The interpreter's internal frame representation." +msgstr "" + +msgid "Return a :term:`strong reference` to the code object for the frame." +msgstr "" + +msgid "Return the byte offset into the last executed instruction." +msgstr "" + +msgid "" +"Return the currently executing line number, or -1 if there is no line number." +msgstr "" + +msgid "" +"An array of executable kinds (executor types) for frames, used for internal " +"debugging and tracing." +msgstr "" + +msgid "" +"Tools like debuggers and profilers can use this to identify the type of " +"execution context associated with a frame (such as to filter out internal " +"frames). The entries are indexed by the following constants:" +msgstr "" + +msgid "Constant" +msgstr "Stała" + +msgid "Description" +msgstr "Opis" + +msgid "" +"The frame is internal (For example: inlined) and should be skipped by tools." +msgstr "" + +msgid "The frame corresponds to a standard Python function." +msgstr "" + +msgid "The frame corresponds to a function defined in native code." +msgstr "" + +msgid "The frame corresponds to a method on a class instance." +msgstr "" + +msgid "" +"Note that reading the executable kind from a frame is currently only " +"possible with undocumented internal APIs." +msgstr "" + +msgid "The number of entries in :c:data:`PyUnstable_ExecutableKinds`." +msgstr "" diff --git a/c-api/function.po b/c-api/function.po index af3d7f4e45..2983c14098 100644 --- a/c-api/function.po +++ b/c-api/function.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -34,14 +34,14 @@ msgstr "Struktura C używana dla funkcji." msgid "" "This is an instance of :c:type:`PyTypeObject` and represents the Python " -"function type. It is exposed to Python programmers as ``types." -"FunctionType``." +"function type. It is exposed to Python programmers as " +"``types.FunctionType``." msgstr "" msgid "" -"Return true if *o* is a function object (has type :c:data:" -"`PyFunction_Type`). The parameter must not be ``NULL``. This function " -"always succeeds." +"Return true if *o* is a function object (has " +"type :c:data:`PyFunction_Type`). The parameter must not be ``NULL``. This " +"function always succeeds." msgstr "" msgid "" @@ -51,18 +51,19 @@ msgid "" msgstr "" msgid "" -"The function's docstring and name are retrieved from the code object. :attr:" -"`~function.__module__` is retrieved from *globals*. The argument defaults, " -"annotations and closure are set to ``NULL``. :attr:`~function.__qualname__` " -"is set to the same value as the code object's :attr:`~codeobject." -"co_qualname` field." +"The function's docstring and name are retrieved from the code " +"object. :attr:`~function.__module__` is retrieved from *globals*. The " +"argument defaults, annotations and closure are set to " +"``NULL``. :attr:`~function.__qualname__` is set to the same value as the " +"code object's :attr:`~codeobject.co_qualname` field." msgstr "" msgid "" -"As :c:func:`PyFunction_New`, but also allows setting the function object's :" -"attr:`~function.__qualname__` attribute. *qualname* should be a unicode " -"object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set " -"to the same value as the code object's :attr:`~codeobject.co_qualname` field." +"As :c:func:`PyFunction_New`, but also allows setting the function " +"object's :attr:`~function.__qualname__` attribute. *qualname* should be a " +"unicode object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute " +"is set to the same value as the code " +"object's :attr:`~codeobject.co_qualname` field." msgstr "" msgid "Return the code object associated with the function object *op*." @@ -140,8 +141,8 @@ msgstr "" msgid "" "These functions are similar to their ``PyFunction_Get*`` counterparts, but " -"do not do type checking. Passing anything other than an instance of :c:data:" -"`PyFunction_Type` is undefined behavior." +"do not do type checking. Passing anything other than an instance " +"of :c:data:`PyFunction_Type` is undefined behavior." msgstr "" msgid "" @@ -152,10 +153,10 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyFunction_AddWatcher` for the current interpreter. Return ``0`` on " -"success, or ``-1`` and set an exception on error (e.g. if the given " -"*watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyFunction_AddWatcher` for the current interpreter. Return " +"``0`` on success, or ``-1`` and set an exception on error (e.g. if the " +"given *watcher_id* was never registered.)" msgstr "" msgid "Enumeration of possible function watcher events:" @@ -176,14 +177,22 @@ msgstr "``PyFunction_EVENT_MODIFY_DEFAULTS``" msgid "``PyFunction_EVENT_MODIFY_KWDEFAULTS``" msgstr "``PyFunction_EVENT_MODIFY_KWDEFAULTS``" +msgid "" +"Apply the macro *V* to each suffix of :c:type:`PyFunction_WatchEvent` " +"constants. Currently expands to ``V(CREATE) V(DESTROY) V(MODIFY_CODE) " +"V(MODIFY_DEFAULTS) V(MODIFY_KWDEFAULTS) V(MODIFY_QUALNAME)``. The macro *V* " +"must accept one event name and supply any punctuation needed between " +"expansions." +msgstr "" + msgid "Type of a function watcher callback function." msgstr "" msgid "" "If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` " -"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a :term:" -"`borrowed reference` to the new value that is about to be stored in *func* " -"for the attribute that is being modified." +"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold " +"a :term:`borrowed reference` to the new value that is about to be stored in " +"*func* for the attribute that is being modified." msgstr "" msgid "" @@ -211,8 +220,8 @@ msgstr "" msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" diff --git a/c-api/gcsupport.po b/c-api/gcsupport.po index 7ecefb25b5..e1e0eca829 100644 --- a/c-api/gcsupport.po +++ b/c-api/gcsupport.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -71,8 +71,8 @@ msgid "" msgstr "" msgid "" -"Before fields which refer to other containers are invalidated, :c:func:" -"`PyObject_GC_UnTrack` must be called." +"Before fields which refer to other containers are " +"invalidated, :c:func:`PyObject_GC_UnTrack` must be called." msgstr "" msgid "" @@ -80,35 +80,35 @@ msgid "" msgstr "" msgid "" -"If a type adds the Py_TPFLAGS_HAVE_GC, then it *must* implement at least a :" -"c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one from its " -"subclass or subclasses." +"If a type adds the Py_TPFLAGS_HAVE_GC, then it *must* implement at least " +"a :c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one from " +"its subclass or subclasses." msgstr "" msgid "" "When calling :c:func:`PyType_Ready` or some of the APIs that indirectly call " "it like :c:func:`PyType_FromSpecWithBases` or :c:func:`PyType_FromSpec` the " -"interpreter will automatically populate the :c:member:`~PyTypeObject." -"tp_flags`, :c:member:`~PyTypeObject.tp_traverse` and :c:member:" -"`~PyTypeObject.tp_clear` fields if the type inherits from a class that " -"implements the garbage collector protocol and the child class does *not* " -"include the :c:macro:`Py_TPFLAGS_HAVE_GC` flag." +"interpreter will automatically populate " +"the :c:member:`~PyTypeObject.tp_flags`, :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields if the type inherits from a " +"class that implements the garbage collector protocol and the child class " +"does *not* include the :c:macro:`Py_TPFLAGS_HAVE_GC` flag." msgstr "" msgid "" -"Analogous to :c:macro:`PyObject_New` but for container objects with the :c:" -"macro:`Py_TPFLAGS_HAVE_GC` flag set." +"Analogous to :c:macro:`PyObject_New` but for container objects with " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag set." msgstr "" msgid "" -"Do not call this directly to allocate memory for an object; call the type's :" -"c:member:`~PyTypeObject.tp_alloc` slot instead." +"Do not call this directly to allocate memory for an object; call the " +"type's :c:member:`~PyTypeObject.tp_alloc` slot instead." msgstr "" msgid "" -"When populating a type's :c:member:`~PyTypeObject.tp_alloc` slot, :c:func:" -"`PyType_GenericAlloc` is preferred over a custom function that simply calls " -"this macro." +"When populating a type's :c:member:`~PyTypeObject.tp_alloc` " +"slot, :c:func:`PyType_GenericAlloc` is preferred over a custom function that " +"simply calls this macro." msgstr "" msgid "" @@ -129,8 +129,8 @@ msgid ":c:member:`~PyTypeObject.tp_alloc`" msgstr ":c:member:`~PyTypeObject.tp_alloc`" msgid "" -"Analogous to :c:macro:`PyObject_NewVar` but for container objects with the :" -"c:macro:`Py_TPFLAGS_HAVE_GC` flag set." +"Analogous to :c:macro:`PyObject_NewVar` but for container objects with " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag set." msgstr "" msgid ":c:macro:`PyObject_NewVar`" @@ -149,16 +149,16 @@ msgid "" msgstr "" msgid "" -"Memory allocated by this function must be freed with :c:func:" -"`PyObject_GC_Del` (usually called via the object's :c:member:`~PyTypeObject." -"tp_free` slot)." +"Memory allocated by this function must be freed " +"with :c:func:`PyObject_GC_Del` (usually called via the " +"object's :c:member:`~PyTypeObject.tp_free` slot)." msgstr "" msgid "" "The function is marked as unstable because the final mechanism for reserving " "extra data after an instance is not yet decided. For allocating a variable " -"number of fields, prefer using :c:type:`PyVarObject` and :c:member:" -"`~PyTypeObject.tp_itemsize` instead." +"number of fields, prefer using :c:type:`PyVarObject` " +"and :c:member:`~PyTypeObject.tp_itemsize` instead." msgstr "" msgid "" @@ -207,19 +207,19 @@ msgid "This is analogous to the Python function :func:`gc.is_finalized`." msgstr "" msgid "" -"Releases memory allocated to an object using :c:macro:`PyObject_GC_New` or :" -"c:macro:`PyObject_GC_NewVar`." +"Releases memory allocated to an object using :c:macro:`PyObject_GC_New` " +"or :c:macro:`PyObject_GC_NewVar`." msgstr "" msgid "" -"Do not call this directly to free an object's memory; call the type's :c:" -"member:`~PyTypeObject.tp_free` slot instead." +"Do not call this directly to free an object's memory; call the " +"type's :c:member:`~PyTypeObject.tp_free` slot instead." msgstr "" msgid "" -"Do not use this for memory allocated by :c:macro:`PyObject_New`, :c:macro:" -"`PyObject_NewVar`, or related allocation functions; use :c:func:" -"`PyObject_Free` instead." +"Do not use this for memory allocated " +"by :c:macro:`PyObject_New`, :c:macro:`PyObject_NewVar`, or related " +"allocation functions; use :c:func:`PyObject_Free` instead." msgstr "" msgid ":c:func:`PyObject_Free` is the non-GC equivalent of this function." @@ -237,10 +237,10 @@ msgstr ":c:member:`~PyTypeObject.tp_free`" msgid "" "Remove the object *op* from the set of container objects tracked by the " "collector. Note that :c:func:`PyObject_GC_Track` can be called again on " -"this object to add it back to the set of tracked objects. The deallocator (:" -"c:member:`~PyTypeObject.tp_dealloc` handler) should call this for the object " -"before any of the fields used by the :c:member:`~PyTypeObject.tp_traverse` " -"handler become invalid." +"this object to add it back to the set of tracked objects. The deallocator " +"(:c:member:`~PyTypeObject.tp_dealloc` handler) should call this for the " +"object before any of the fields used by " +"the :c:member:`~PyTypeObject.tp_traverse` handler become invalid." msgstr "" msgid "" @@ -254,12 +254,12 @@ msgid "" msgstr "" msgid "" -"Type of the visitor function passed to the :c:member:`~PyTypeObject." -"tp_traverse` handler. The function should be called with an object to " -"traverse as *object* and the third parameter to the :c:member:`~PyTypeObject." -"tp_traverse` handler as *arg*. The Python core uses several visitor " -"functions to implement cyclic garbage detection; it's not expected that " -"users will need to write their own visitor functions." +"Type of the visitor function passed to " +"the :c:member:`~PyTypeObject.tp_traverse` handler. The function should be " +"called with an object to traverse as *object* and the third parameter to " +"the :c:member:`~PyTypeObject.tp_traverse` handler as *arg*. The Python core " +"uses several visitor functions to implement cyclic garbage detection; it's " +"not expected that users will need to write their own visitor functions." msgstr "" msgid "" @@ -283,10 +283,10 @@ msgid "" msgstr "" msgid "" -"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:" -"func:`Py_VISIT` macro is provided. In order to use this macro, the :c:" -"member:`~PyTypeObject.tp_traverse` implementation must name its arguments " -"exactly *visit* and *arg*:" +"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, " +"a :c:func:`Py_VISIT` macro is provided. In order to use this macro, " +"the :c:member:`~PyTypeObject.tp_traverse` implementation must name its " +"arguments exactly *visit* and *arg*:" msgstr "" msgid "" @@ -307,8 +307,8 @@ msgid "" msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:" -"`inquiry` type, or ``NULL`` if the object is immutable." +"The :c:member:`~PyTypeObject.tp_clear` handler must be of " +"the :c:type:`inquiry` type, or ``NULL`` if the object is immutable." msgstr "" msgid "" @@ -336,8 +336,8 @@ msgstr "" msgid "" "Returns the number of collected + unreachable objects which cannot be " "collected. If the garbage collector is disabled or already collecting, " -"returns ``0`` immediately. Errors during garbage collection are passed to :" -"data:`sys.unraisablehook`. This function does not raise exceptions." +"returns ``0`` immediately. Errors during garbage collection are passed " +"to :data:`sys.unraisablehook`. This function does not raise exceptions." msgstr "" msgid "" @@ -380,9 +380,9 @@ msgid "" msgstr "" msgid "" -"Type of the visitor function to be passed to :c:func:" -"`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* passed to " -"``PyUnstable_GC_VisitObjects``. Return ``1`` to continue iteration, return " -"``0`` to stop iteration. Other return values are reserved for now so " -"behavior on returning anything else is undefined." +"Type of the visitor function to be passed " +"to :c:func:`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* " +"passed to ``PyUnstable_GC_VisitObjects``. Return ``1`` to continue " +"iteration, return ``0`` to stop iteration. Other return values are reserved " +"for now so behavior on returning anything else is undefined." msgstr "" diff --git a/c-api/gen.po b/c-api/gen.po index d7260df3d9..cd238b5d1e 100644 --- a/c-api/gen.po +++ b/c-api/gen.po @@ -29,8 +29,8 @@ msgstr "" msgid "" "Generator objects are what Python uses to implement generator iterators. " "They are normally created by iterating over a function that yields values, " -"rather than explicitly calling :c:func:`PyGen_New` or :c:func:" -"`PyGen_NewWithQualName`." +"rather than explicitly calling :c:func:`PyGen_New` " +"or :c:func:`PyGen_NewWithQualName`." msgstr "" msgid "The C structure used for generator objects." diff --git a/c-api/import.po b/c-api/import.po index f0c5cfe733..e776db1848 100644 --- a/c-api/import.po +++ b/c-api/import.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,8 +27,8 @@ msgid "Importing Modules" msgstr "" msgid "" -"This is a wrapper around :c:func:`PyImport_Import()` which takes a :c:expr:" -"`const char *` as an argument instead of a :c:expr:`PyObject *`." +"This is a wrapper around :c:func:`PyImport_Import()` which takes " +"a :c:expr:`const char *` as an argument instead of a :c:expr:`PyObject *`." msgstr "" msgid "This function is a deprecated alias of :c:func:`PyImport_ImportModule`." @@ -51,14 +51,15 @@ msgstr "" msgid "" "The return value is a new reference to the imported module or top-level " -"package, or ``NULL`` with an exception set on failure. Like for :func:" -"`__import__`, the return value when a submodule of a package was requested " -"is normally the top-level package, unless a non-empty *fromlist* was given." +"package, or ``NULL`` with an exception set on failure. Like " +"for :func:`__import__`, the return value when a submodule of a package was " +"requested is normally the top-level package, unless a non-empty *fromlist* " +"was given." msgstr "" msgid "" -"Failing imports remove incomplete module objects, like with :c:func:" -"`PyImport_ImportModule`." +"Failing imports remove incomplete module objects, like " +"with :c:func:`PyImport_ImportModule`." msgstr "" msgid "" @@ -110,10 +111,10 @@ msgstr "" msgid "" "This function does not load or import the module; if the module wasn't " -"already loaded, you will get an empty module object. Use :c:func:" -"`PyImport_ImportModule` or one of its variants to import a module. Package " -"structures implied by a dotted name for *name* are not created if not " -"already present." +"already loaded, you will get an empty module object. " +"Use :c:func:`PyImport_ImportModule` or one of its variants to import a " +"module. Package structures implied by a dotted name for *name* are not " +"created if not already present." msgstr "" msgid "" @@ -132,11 +133,11 @@ msgid "" "function :func:`compile`, load the module. Return a new reference to the " "module object, or ``NULL`` with an exception set if an error occurred. " "*name* is removed from :data:`sys.modules` in error cases, even if *name* " -"was already in :data:`sys.modules` on entry to :c:func:" -"`PyImport_ExecCodeModule`. Leaving incompletely initialized modules in :" -"data:`sys.modules` is dangerous, as imports of such modules have no way to " -"know that the module object is an unknown (and probably damaged with respect " -"to the module author's intents) state." +"was already in :data:`sys.modules` on entry " +"to :c:func:`PyImport_ExecCodeModule`. Leaving incompletely initialized " +"modules in :data:`sys.modules` is dangerous, as imports of such modules have " +"no way to know that the module object is an unknown (and probably damaged " +"with respect to the module author's intents) state." msgstr "" msgid "" @@ -148,13 +149,13 @@ msgstr "" msgid "" "The module's :attr:`~module.__file__` attribute will be set to the code " -"object's :attr:`~codeobject.co_filename`. If applicable, :attr:`~module." -"__cached__` will also be set." +"object's :attr:`~codeobject.co_filename`. If " +"applicable, :attr:`~module.__cached__` will also be set." msgstr "" msgid "" -"This function will reload the module if it was already imported. See :c:" -"func:`PyImport_ReloadModule` for the intended way to reload a module." +"This function will reload the module if it was already imported. " +"See :c:func:`PyImport_ReloadModule` for the intended way to reload a module." msgstr "" msgid "" @@ -163,8 +164,8 @@ msgid "" msgstr "" msgid "" -"See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:" -"`PyImport_ExecCodeModuleWithPathnames`." +"See also :c:func:`PyImport_ExecCodeModuleEx` " +"and :c:func:`PyImport_ExecCodeModuleWithPathnames`." msgstr "" msgid "" @@ -187,8 +188,8 @@ msgid "" msgstr "" msgid "" -"Setting :attr:`~module.__cached__` is deprecated. See :class:`~importlib." -"machinery.ModuleSpec` for alternatives." +"Setting :attr:`~module.__cached__` is deprecated. " +"See :class:`~importlib.machinery.ModuleSpec` for alternatives." msgstr "" msgid "" @@ -222,8 +223,8 @@ msgid "" msgstr "" msgid "" -"Return the dictionary used for the module administration (a.k.a. ``sys." -"modules``). Note that this is a per-interpreter variable." +"Return the dictionary used for the module administration (a.k.a. " +"``sys.modules``). Note that this is a per-interpreter variable." msgstr "" msgid "" @@ -238,16 +239,17 @@ msgid "" "dict. If it wasn't yet cached, traverse :data:`sys.path_hooks` until a hook " "is found that can handle the path item. Return ``None`` if no hook could; " "this tells our caller that the :term:`path based finder` could not find a " -"finder for this path item. Cache the result in :data:`sys." -"path_importer_cache`. Return a new reference to the finder object." +"finder for this path item. Cache the result " +"in :data:`sys.path_importer_cache`. Return a new reference to the finder " +"object." msgstr "" msgid "" "Load a frozen module named *name*. Return ``1`` for success, ``0`` if the " "module is not found, and ``-1`` with an exception set if the initialization " -"failed. To access the imported module on a successful load, use :c:func:" -"`PyImport_ImportModule`. (Note the misnomer --- this function would reload " -"the module if it was already imported.)" +"failed. To access the imported module on a successful load, " +"use :c:func:`PyImport_ImportModule`. (Note the misnomer --- this function " +"would reload the module if it was already imported.)" msgstr "" msgid "The ``__file__`` attribute is no longer set on the module." @@ -261,17 +263,17 @@ msgstr "" msgid "" "This is the structure type definition for frozen module descriptors, as " "generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the " -"Python source distribution). Its definition, found in :file:`Include/import." -"h`, is::" +"Python source distribution). Its definition, found in :file:`Include/" +"import.h`, is:" msgstr "" msgid "" "struct _frozen {\n" -" const char *name;\n" +" const char *name; /* ASCII encoded string */\n" " const unsigned char *code;\n" " int size;\n" -" bool is_package;\n" -"};" +" int is_package;\n" +"};\n" msgstr "" msgid "" @@ -311,12 +313,12 @@ msgstr "" msgid "" "Add a collection of modules to the table of built-in modules. The *newtab* " -"array must end with a sentinel entry which contains ``NULL`` for the :c:" -"member:`~_inittab.name` field; failure to provide the sentinel value can " -"result in a memory fault. Returns ``0`` on success or ``-1`` if insufficient " -"memory could be allocated to extend the internal table. In the event of " -"failure, no modules are added to the internal table. This must be called " -"before :c:func:`Py_Initialize`." +"array must end with a sentinel entry which contains ``NULL`` for " +"the :c:member:`~_inittab.name` field; failure to provide the sentinel value " +"can result in a memory fault. Returns ``0`` on success or ``-1`` if " +"insufficient memory could be allocated to extend the internal table. In the " +"event of failure, no modules are added to the internal table. This must be " +"called before :c:func:`Py_Initialize`." msgstr "" msgid "" @@ -327,8 +329,8 @@ msgstr "" msgid "" "The table of built-in modules used by Python initialization. Do not use this " -"directly; use :c:func:`PyImport_AppendInittab` and :c:func:" -"`PyImport_ExtendInittab` instead." +"directly; use :c:func:`PyImport_AppendInittab` " +"and :c:func:`PyImport_ExtendInittab` instead." msgstr "" msgid "Import the module *mod_name* and get its attribute *attr_name*." @@ -338,10 +340,10 @@ msgid "Names must be Python :class:`str` objects." msgstr "" msgid "" -"Helper function combining :c:func:`PyImport_Import` and :c:func:" -"`PyObject_GetAttr`. For example, it can raise :exc:`ImportError` if the " -"module is not found, and :exc:`AttributeError` if the attribute doesn't " -"exist." +"Helper function combining :c:func:`PyImport_Import` " +"and :c:func:`PyObject_GetAttr`. For example, it can raise :exc:`ImportError` " +"if the module is not found, and :exc:`AttributeError` if the attribute " +"doesn't exist." msgstr "" msgid "" diff --git a/c-api/index.po b/c-api/index.po index ed801cfe5a..6de3faa53d 100644 --- a/c-api/index.po +++ b/c-api/index.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,15 +25,15 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Python/C API reference manual" -msgstr "" +msgstr "Podręcznik API Python/C" msgid "" "This manual documents the API used by C and C++ programmers who want to " -"write extension modules or embed Python. It is a companion to :ref:" -"`extending-index`, which describes the general principles of extension " -"writing but does not document the API functions in detail." +"write extension modules or embed Python. It is a companion " +"to :ref:`extending-index`, which describes the general principles of " +"extension writing but does not document the API functions in detail." msgstr "" "Ten podręcznik dokumentuje API używany przez programistów C i C++, którzy " -"chcą napisać rozszerzenie moduł lub osadzić Pythona. Jest to dodatek do :" -"ref:`extending-index`, który opisuje ogólne zasady pisania rozszerzeń, ale " -"nie dokumentuje szczegółowo API ." +"chcą napisać rozszerzenie moduł lub osadzić Pythona. Jest to dodatek " +"do :ref:`extending-index`, który opisuje ogólne zasady pisania rozszerzeń, " +"ale nie dokumentuje szczegółowo API ." diff --git a/c-api/init.po b/c-api/init.po index d24364df2a..638eab2199 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -163,10 +163,8 @@ msgstr ":c:func:`PyMutex_Unlock`" msgid "" "Despite their apparent similarity to some of the functions listed above, the " "following functions **should not be called** before the interpreter has been " -"initialized: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:" -"`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:" -"`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:" -"`Py_GetProgramName`, :c:func:`PyEval_InitThreads`, and :c:func:`Py_RunMain`." +"initialized: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`Py_GetProgramName`, :c:func:`PyEval_InitThreads`, " +"and :c:func:`Py_RunMain`." msgstr "" msgid "Global configuration variables" @@ -174,36 +172,36 @@ msgstr "" msgid "" "Python has variables for the global configuration to control different " -"features and options. By default, these flags are controlled by :ref:" -"`command line options `." +"features and options. By default, these flags are controlled " +"by :ref:`command line options `." msgstr "" msgid "" "When a flag is set by an option, the value of the flag is the number of " -"times that the option was set. For example, ``-b`` sets :c:data:" -"`Py_BytesWarningFlag` to 1 and ``-bb`` sets :c:data:`Py_BytesWarningFlag` to " -"2." +"times that the option was set. For example, ``-b`` " +"sets :c:data:`Py_BytesWarningFlag` to 1 and ``-bb`` " +"sets :c:data:`Py_BytesWarningFlag` to 2." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"bytes_warning` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.bytes_warning` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :" -"class:`str` or :class:`bytes` with :class:`int`. Issue an error if greater " -"or equal to ``2``." +"Issue a warning when comparing :class:`bytes` or :class:`bytearray` " +"with :class:`str` or :class:`bytes` with :class:`int`. Issue an error if " +"greater or equal to ``2``." msgstr "" msgid "Set by the :option:`-b` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"parser_debug` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.parser_debug` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -217,9 +215,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"write_bytecode` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.write_bytecode` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -233,22 +231,23 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"pathconfig_warnings` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.pathconfig_warnings` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Suppress error messages when calculating the module search path in :c:func:" -"`Py_GetPath`." +"Suppress error messages when calculating the module search path " +"in :c:func:`Py_GetPath`." msgstr "" msgid "Private flag used by ``_freeze_module`` and ``frozenmain`` programs." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"hash_seed` and :c:member:`PyConfig.use_hash_seed` should be used instead, " +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.hash_seed` " +"and :c:member:`PyConfig.use_hash_seed` should be used instead, " "see :ref:`Python Initialization Configuration `." msgstr "" @@ -263,23 +262,23 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"use_environment` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.use_environment` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:" -"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." +"Ignore all :envvar:`!PYTHON*` environment variables, " +"e.g. :envvar:`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." msgstr "" msgid "Set by the :option:`-E` and :option:`-I` options." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"inspect` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.inspect` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -294,18 +293,18 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"interactive` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.interactive` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Set by the :option:`-i` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"isolated` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.isolated` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -317,9 +316,9 @@ msgid "Set by the :option:`-I` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyPreConfig." -"legacy_windows_fs_encoding` should be used instead, see :ref:`Python " -"Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyPreConfig.legacy_windows_fs_encoding` should be used " +"instead, see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -340,14 +339,14 @@ msgid "Availability" msgstr "Dostępność" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"legacy_windows_stdio` should be used instead, see :ref:`Python " -"Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.legacy_windows_stdio` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!io." -"_WindowsConsoleIO` for :mod:`sys` standard streams." +"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!" +"io._WindowsConsoleIO` for :mod:`sys` standard streams." msgstr "" msgid "" @@ -359,41 +358,41 @@ msgid "See :pep:`528` for more details." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"site_import` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.site_import` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails. Also disable these " -"manipulations if :mod:`site` is explicitly imported later (call :func:`site." -"main` if you want them to be triggered)." +"manipulations if :mod:`site` is explicitly imported later " +"(call :func:`site.main` if you want them to be triggered)." msgstr "" msgid "Set by the :option:`-S` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"user_site_directory` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.user_site_directory` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Don't add the :data:`user site-packages directory ` to :data:" -"`sys.path`." +"Don't add the :data:`user site-packages directory ` " +"to :data:`sys.path`." msgstr "" msgid "" -"Set by the :option:`-s` and :option:`-I` options, and the :envvar:" -"`PYTHONNOUSERSITE` environment variable." +"Set by the :option:`-s` and :option:`-I` options, and " +"the :envvar:`PYTHONNOUSERSITE` environment variable." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"optimization_level` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.optimization_level` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -402,9 +401,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"quiet` should be used instead, see :ref:`Python Initialization Configuration " -"`." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.quiet` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -415,9 +414,9 @@ msgid "Set by the :option:`-q` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"buffered_stdio` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.buffered_stdio` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Force the stdout and stderr streams to be unbuffered." @@ -429,9 +428,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"verbose` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.verbose` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -451,8 +450,9 @@ msgstr "" msgid "" "Initialize the Python interpreter. In an application embedding Python, " -"this should be called before using any other Python/C API functions; see :" -"ref:`Before Python Initialization ` for the few exceptions." +"this should be called before using any other Python/C API functions; " +"see :ref:`Before Python Initialization ` for the few " +"exceptions." msgstr "" msgid "" @@ -506,17 +506,18 @@ msgstr "" msgid "" "Undo all initializations made by :c:func:`Py_Initialize` and subsequent use " -"of Python/C API functions, and destroy all sub-interpreters (see :c:func:" -"`Py_NewInterpreter` below) that were created and not yet destroyed since the " -"last call to :c:func:`Py_Initialize`. This is a no-op when called for a " -"second time (without calling :c:func:`Py_Initialize` again first)." +"of Python/C API functions, and destroy all sub-interpreters " +"(see :c:func:`Py_NewInterpreter` below) that were created and not yet " +"destroyed since the last call to :c:func:`Py_Initialize`. This is a no-op " +"when called for a second time (without calling :c:func:`Py_Initialize` again " +"first)." msgstr "" msgid "" "Since this is the reverse of :c:func:`Py_Initialize`, it should be called in " "the same thread with the same interpreter active. That means the main " -"thread and the main interpreter. This should never be called while :c:func:" -"`Py_RunMain` is running." +"thread and the main interpreter. This should never be called " +"while :c:func:`Py_RunMain` is running." msgstr "" msgid "" @@ -562,8 +563,8 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"_PySys_ClearAuditHooks`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython._PySys_ClearAuditHooks`` with no arguments." msgstr "" msgid "" @@ -606,9 +607,9 @@ msgid "" msgstr "" msgid "" -"In terms of the CPython runtime configuration APIs documented in the :ref:" -"`runtime configuration ` section (and without accounting for " -"error handling), ``Py_Main`` is approximately equivalent to::" +"In terms of the CPython runtime configuration APIs documented in " +"the :ref:`runtime configuration ` section (and without " +"accounting for error handling), ``Py_Main`` is approximately equivalent to::" msgstr "" msgid "" @@ -623,25 +624,25 @@ msgstr "" msgid "" "In normal usage, an embedding application will call this function *instead* " -"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` or :c:func:" -"`Py_InitializeFromConfig` directly, and all settings will be applied as " -"described elsewhere in this documentation. If this function is instead " -"called *after* a preceding runtime initialization API call, then exactly " -"which environmental and command line configuration settings will be updated " -"is version dependent (as it depends on which settings correctly support " -"being modified after they have already been set once when the runtime was " -"first initialized)." +"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` " +"or :c:func:`Py_InitializeFromConfig` directly, and all settings will be " +"applied as described elsewhere in this documentation. If this function is " +"instead called *after* a preceding runtime initialization API call, then " +"exactly which environmental and command line configuration settings will be " +"updated is version dependent (as it depends on which settings correctly " +"support being modified after they have already been set once when the " +"runtime was first initialized)." msgstr "" msgid "Executes the main module in a fully configured CPython runtime." msgstr "" msgid "" -"Executes the command (:c:member:`PyConfig.run_command`), the script (:c:" -"member:`PyConfig.run_filename`) or the module (:c:member:`PyConfig." -"run_module`) specified on the command line or in the configuration. If none " -"of these values are set, runs the interactive Python prompt (REPL) using the " -"``__main__`` module's global namespace." +"Executes the command (:c:member:`PyConfig.run_command`), the script " +"(:c:member:`PyConfig.run_filename`) or the module " +"(:c:member:`PyConfig.run_module`) specified on the command line or in the " +"configuration. If none of these values are set, runs the interactive Python " +"prompt (REPL) using the ``__main__`` module's global namespace." msgstr "" msgid "" @@ -667,8 +668,8 @@ msgstr "" msgid "" "See :ref:`Python Configuration ` for an example of a " -"customized Python that always runs in isolated mode using :c:func:" -"`Py_RunMain`." +"customized Python that always runs in isolated mode " +"using :c:func:`Py_RunMain`." msgstr "" msgid "" @@ -684,9 +685,9 @@ msgid "Process-wide parameters" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"program_name` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.program_name` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -703,8 +704,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:" -"`wchar_t*` string." +"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get " +"a :c:expr:`wchar_t*` string." msgstr "" msgid "" @@ -722,8 +723,8 @@ msgid "It now returns ``NULL`` if called before :c:func:`Py_Initialize`." msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"executable\") ` (:data:`sys." -"executable`) instead." +"Use :c:func:`PyConfig_Get(\"executable\") ` " +"(:data:`sys.executable`) instead." msgstr "" msgid "" @@ -740,10 +741,10 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"base_prefix\") ` (:data:`sys." -"base_prefix`) instead. Use :c:func:`PyConfig_Get(\"prefix\") ` " -"(:data:`sys.prefix`) if :ref:`virtual environments ` need to be " -"handled." +"Use :c:func:`PyConfig_Get(\"base_prefix\") ` " +"(:data:`sys.base_prefix`) instead. Use :c:func:`PyConfig_Get(\"prefix\") " +"` (:data:`sys.prefix`) if :ref:`virtual environments ` need to be handled." msgstr "" msgid "" @@ -752,11 +753,11 @@ msgid "" "with :c:member:`PyConfig.program_name` and some environment variables; for " "example, if the program name is ``'/usr/local/bin/python'``, the exec-prefix " "is ``'/usr/local'``. The returned string points into static storage; the " -"caller should not modify its value. This corresponds to the :makevar:" -"`exec_prefix` variable in the top-level :file:`Makefile` and the ``--exec-" -"prefix`` argument to the :program:`configure` script at build time. The " -"value is available to Python code as ``sys.base_exec_prefix``. It is only " -"useful on Unix." +"caller should not modify its value. This corresponds to " +"the :makevar:`exec_prefix` variable in the top-level :file:`Makefile` and " +"the ``--exec-prefix`` argument to the :program:`configure` script at build " +"time. The value is available to Python code as ``sys.base_exec_prefix``. " +"It is only useful on Unix." msgstr "" msgid "" @@ -781,17 +782,18 @@ msgid "" msgstr "" msgid "" -"System administrators will know how to configure the :program:`mount` or :" -"program:`automount` programs to share :file:`/usr/local` between platforms " -"while having :file:`/usr/local/plat` be a different filesystem for each " -"platform." +"System administrators will know how to configure the :program:`mount` " +"or :program:`automount` programs to share :file:`/usr/local` between " +"platforms while having :file:`/usr/local/plat` be a different filesystem for " +"each platform." msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"base_exec_prefix\") ` (:data:`sys." -"base_exec_prefix`) instead. Use :c:func:`PyConfig_Get(\"exec_prefix\") " -"` (:data:`sys.exec_prefix`) if :ref:`virtual environments " -"` need to be handled." +"Use :c:func:`PyConfig_Get(\"base_exec_prefix\") ` " +"(:data:`sys.base_exec_prefix`) instead. " +"Use :c:func:`PyConfig_Get(\"exec_prefix\") ` " +"(:data:`sys.exec_prefix`) if :ref:`virtual environments ` need to " +"be handled." msgstr "" msgid "" @@ -815,8 +817,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"module_search_paths\") ` (:data:" -"`sys.path`) instead." +"Use :c:func:`PyConfig_Get(\"module_search_paths\") ` " +"(:data:`sys.path`) instead." msgstr "" msgid "" @@ -831,8 +833,8 @@ msgid "" "The first word (up to the first space character) is the current Python " "version; the first characters are the major and minor version separated by a " "period. The returned string points into static storage; the caller should " -"not modify its value. The value is available to Python code as :data:`sys." -"version`." +"not modify its value. The value is available to Python code " +"as :data:`sys.version`." msgstr "" msgid "See also the :c:var:`Py_Version` constant." @@ -884,10 +886,10 @@ msgid "\"#67, Aug 1 1997, 22:34:28\"" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"argv`, :c:member:`PyConfig.parse_argv` and :c:member:`PyConfig.safe_path` " -"should be used instead, see :ref:`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.argv`, :c:member:`PyConfig.parse_argv` " +"and :c:member:`PyConfig.safe_path` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -908,8 +910,8 @@ msgstr "" msgid "" "If the name of an existing script is passed in ``argv[0]``, the absolute " -"path of the directory where the script is located is prepended to :data:`sys." -"path`." +"path of the directory where the script is located is prepended " +"to :data:`sys.path`." msgstr "" msgid "" @@ -931,32 +933,33 @@ msgstr "" msgid "" "On versions before 3.1.3, you can achieve the same effect by manually " -"popping the first :data:`sys.path` element after having called :c:func:" -"`PySys_SetArgv`, for example using::" +"popping the first :data:`sys.path` element after having " +"called :c:func:`PySys_SetArgv`, for example using::" msgstr "" msgid "PyRun_SimpleString(\"import sys; sys.path.pop(0)\\n\");" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"argv` and :c:member:`PyConfig.parse_argv` should be used instead, see :ref:" -"`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.argv` and :c:member:`PyConfig.parse_argv` should " +"be used instead, see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to " -"``1`` unless the :program:`python` interpreter was started with the :option:" -"`-I`." +"``1`` unless the :program:`python` interpreter was started with " +"the :option:`-I`." msgstr "" msgid "The *updatepath* value depends on :option:`-I`." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"home` should be used instead, see :ref:`Python Initialization Configuration " -"`." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.home` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -973,14 +976,14 @@ msgid "" msgstr "" msgid "" -"Return the default \"home\", that is, the value set by :c:member:`PyConfig." -"home`, or the value of the :envvar:`PYTHONHOME` environment variable if it " -"is set." +"Return the default \"home\", that is, the value set " +"by :c:member:`PyConfig.home`, or the value of the :envvar:`PYTHONHOME` " +"environment variable if it is set." msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"home\") ` or the :envvar:" -"`PYTHONHOME` environment variable instead." +"Use :c:func:`PyConfig_Get(\"home\") ` or " +"the :envvar:`PYTHONHOME` environment variable instead." msgstr "" msgid "Thread State and the Global Interpreter Lock" @@ -999,20 +1002,21 @@ msgid "" msgstr "" msgid "" -"Therefore, the rule exists that only the thread that has acquired the :term:" -"`GIL` may operate on Python objects or call Python/C API functions. In order " -"to emulate concurrency of execution, the interpreter regularly tries to " -"switch threads (see :func:`sys.setswitchinterval`). The lock is also " -"released around potentially blocking I/O operations like reading or writing " -"a file, so that other Python threads can run in the meantime." +"Therefore, the rule exists that only the thread that has acquired " +"the :term:`GIL` may operate on Python objects or call Python/C API " +"functions. In order to emulate concurrency of execution, the interpreter " +"regularly tries to switch threads (see :func:`sys.setswitchinterval`). The " +"lock is also released around potentially blocking I/O operations like " +"reading or writing a file, so that other Python threads can run in the " +"meantime." msgstr "" msgid "" "The Python interpreter keeps some thread-specific bookkeeping information " -"inside a data structure called :c:type:`PyThreadState`, known as a :term:" -"`thread state`. Each OS thread has a thread-local pointer to a :c:type:" -"`PyThreadState`; a thread state referenced by this pointer is considered to " -"be :term:`attached `." +"inside a data structure called :c:type:`PyThreadState`, known as " +"a :term:`thread state`. Each OS thread has a thread-local pointer to " +"a :c:type:`PyThreadState`; a thread state referenced by this pointer is " +"considered to be :term:`attached `." msgstr "" msgid "" @@ -1027,10 +1031,10 @@ msgstr "" msgid "" "In general, there will always be an :term:`attached thread state` when using " -"Python's C API. Only in some specific cases (such as in a :c:macro:" -"`Py_BEGIN_ALLOW_THREADS` block) will the thread not have an attached thread " -"state. If uncertain, check if :c:func:`PyThreadState_GetUnchecked` returns " -"``NULL``." +"Python's C API. Only in some specific cases (such as in " +"a :c:macro:`Py_BEGIN_ALLOW_THREADS` block) will the thread not have an " +"attached thread state. If uncertain, check " +"if :c:func:`PyThreadState_GetUnchecked` returns ``NULL``." msgstr "" msgid "Detaching the thread state from extension code" @@ -1078,30 +1082,30 @@ msgstr "" msgid "" "The :term:`attached thread state` holds the :term:`GIL` for the entire " -"interpreter. When detaching the :term:`attached thread state`, the :term:" -"`GIL` is released, allowing other threads to attach a thread state to their " -"own thread, thus getting the :term:`GIL` and can start executing. The " -"pointer to the prior :term:`attached thread state` is stored as a local " +"interpreter. When detaching the :term:`attached thread state`, " +"the :term:`GIL` is released, allowing other threads to attach a thread state " +"to their own thread, thus getting the :term:`GIL` and can start executing. " +"The pointer to the prior :term:`attached thread state` is stored as a local " "variable. Upon reaching :c:macro:`Py_END_ALLOW_THREADS`, the thread state " -"that was previously :term:`attached ` is passed to :c:" -"func:`PyEval_RestoreThread`. This function will block until another releases " -"its :term:`thread state `, thus allowing the old :" -"term:`thread state ` to get re-attached and the C API " -"can be called again." +"that was previously :term:`attached ` is passed " +"to :c:func:`PyEval_RestoreThread`. This function will block until another " +"releases its :term:`thread state `, thus allowing the " +"old :term:`thread state ` to get re-attached and the " +"C API can be called again." msgstr "" msgid "" "For :term:`free-threaded ` builds, the :term:`GIL` is " "normally out of the question, but detaching the :term:`thread state " "` is still required for blocking I/O and long " -"operations. The difference is that threads don't have to wait for the :term:" -"`GIL` to be released to attach their thread state, allowing true multi-core " -"parallelism." +"operations. The difference is that threads don't have to wait for " +"the :term:`GIL` to be released to attach their thread state, allowing true " +"multi-core parallelism." msgstr "" msgid "" -"Calling system I/O functions is the most common use case for detaching the :" -"term:`thread state `, but it can also be useful " +"Calling system I/O functions is the most common use case for detaching " +"the :term:`thread state `, but it can also be useful " "before calling long-running computations which don't need access to Python " "objects, such as compression or cryptographic functions operating over " "memory buffers. For example, the standard :mod:`zlib` and :mod:`hashlib` " @@ -1113,21 +1117,21 @@ msgid "Non-Python created threads" msgstr "" msgid "" -"When threads are created using the dedicated Python APIs (such as the :mod:" -"`threading` module), a thread state is automatically associated to them and " -"the code showed above is therefore correct. However, when threads are " -"created from C (for example by a third-party library with its own thread " -"management), they don't hold the :term:`GIL`, because they don't have an :" -"term:`attached thread state`." +"When threads are created using the dedicated Python APIs (such as " +"the :mod:`threading` module), a thread state is automatically associated to " +"them and the code showed above is therefore correct. However, when threads " +"are created from C (for example by a third-party library with its own thread " +"management), they don't hold the :term:`GIL`, because they don't have " +"an :term:`attached thread state`." msgstr "" msgid "" "If you need to call Python code from these threads (often this will be part " "of a callback API provided by the aforementioned third-party library), you " -"must first register these threads with the interpreter by creating an :term:" -"`attached thread state` before you can start using the Python/C API. When " -"you are done, you should detach the :term:`thread state `, and finally free it." +"must first register these threads with the interpreter by creating " +"an :term:`attached thread state` before you can start using the Python/C " +"API. When you are done, you should detach the :term:`thread state `, and finally free it." msgstr "" msgid "" @@ -1151,13 +1155,13 @@ msgstr "" msgid "" "Note that the ``PyGILState_*`` functions assume there is only one global " "interpreter (created automatically by :c:func:`Py_Initialize`). Python " -"supports the creation of additional interpreters (using :c:func:" -"`Py_NewInterpreter`), but mixing multiple interpreters and the " -"``PyGILState_*`` API is unsupported. This is because :c:func:" -"`PyGILState_Ensure` and similar functions default to :term:`attaching " -"` a :term:`thread state` for the main interpreter, " -"meaning that the thread can't safely interact with the calling " -"subinterpreter." +"supports the creation of additional interpreters " +"(using :c:func:`Py_NewInterpreter`), but mixing multiple interpreters and " +"the ``PyGILState_*`` API is unsupported. This is " +"because :c:func:`PyGILState_Ensure` and similar functions default " +"to :term:`attaching ` a :term:`thread state` for the " +"main interpreter, meaning that the thread can't safely interact with the " +"calling subinterpreter." msgstr "" msgid "Supporting subinterpreters in non-Python threads" @@ -1212,11 +1216,11 @@ msgid "" "of additional (non-Python) locks that need to be acquired before or reset " "after a fork. OS facilities such as :c:func:`!pthread_atfork` would need to " "be used to accomplish the same thing. Additionally, when extending or " -"embedding Python, calling :c:func:`fork` directly rather than through :func:" -"`os.fork` (and returning to or calling into Python) may result in a deadlock " -"by one of Python's internal locks being held by a thread that is defunct " -"after the fork. :c:func:`PyOS_AfterFork_Child` tries to reset the necessary " -"locks, but is not always able to." +"embedding Python, calling :c:func:`fork` directly rather than " +"through :func:`os.fork` (and returning to or calling into Python) may result " +"in a deadlock by one of Python's internal locks being held by a thread that " +"is defunct after the fork. :c:func:`PyOS_AfterFork_Child` tries to reset the " +"necessary locks, but is not always able to." msgstr "" msgid "" @@ -1236,17 +1240,17 @@ msgstr "" msgid "" "In the late stage of :term:`interpreter shutdown`, after attempting to wait " -"for non-daemon threads to exit (though this can be interrupted by :class:" -"`KeyboardInterrupt`) and running the :mod:`atexit` functions, the runtime is " -"marked as *finalizing*: :c:func:`Py_IsFinalizing` and :func:`sys." -"is_finalizing` return true. At this point, only the *finalization thread* " -"that initiated finalization (typically the main thread) is allowed to " -"acquire the :term:`GIL`." +"for non-daemon threads to exit (though this can be interrupted " +"by :class:`KeyboardInterrupt`) and running the :mod:`atexit` functions, the " +"runtime is marked as *finalizing*: :c:func:`Py_IsFinalizing` " +"and :func:`sys.is_finalizing` return true. At this point, only the " +"*finalization thread* that initiated finalization (typically the main " +"thread) is allowed to acquire the :term:`GIL`." msgstr "" msgid "" -"If any thread, other than the finalization thread, attempts to attach a :" -"term:`thread state` during finalization, either explicitly or implicitly, " +"If any thread, other than the finalization thread, attempts to attach " +"a :term:`thread state` during finalization, either explicitly or implicitly, " "the thread enters **a permanently blocked state** where it remains until the " "program exits. In most cases this is harmless, but this can result in " "deadlock if a later stage of finalization attempts to acquire a lock owned " @@ -1363,8 +1367,8 @@ msgid "" msgstr "" msgid "" -"Set the :term:`attached thread state` to *tstate*, and return the :term:" -"`thread state` that was attached prior to calling." +"Set the :term:`attached thread state` to *tstate*, and return " +"the :term:`thread state` that was attached prior to calling." msgstr "" msgid "" @@ -1386,8 +1390,8 @@ msgid "" msgstr "" msgid "" -"The type of the value returned by :c:func:`PyGILState_Ensure` and passed to :" -"c:func:`PyGILState_Release`." +"The type of the value returned by :c:func:`PyGILState_Ensure` and passed " +"to :c:func:`PyGILState_Release`." msgstr "" msgid "The GIL was already held when :c:func:`PyGILState_Ensure` was called." @@ -1401,20 +1405,20 @@ msgid "" "of the current state of Python, or of the :term:`attached thread state`. " "This may be called as many times as desired by a thread as long as each call " "is matched with a call to :c:func:`PyGILState_Release`. In general, other " -"thread-related APIs may be used between :c:func:`PyGILState_Ensure` and :c:" -"func:`PyGILState_Release` calls as long as the thread state is restored to " -"its previous state before the Release(). For example, normal usage of the :" -"c:macro:`Py_BEGIN_ALLOW_THREADS` and :c:macro:`Py_END_ALLOW_THREADS` macros " -"is acceptable." +"thread-related APIs may be used between :c:func:`PyGILState_Ensure` " +"and :c:func:`PyGILState_Release` calls as long as the thread state is " +"restored to its previous state before the Release(). For example, normal " +"usage of the :c:macro:`Py_BEGIN_ALLOW_THREADS` " +"and :c:macro:`Py_END_ALLOW_THREADS` macros is acceptable." msgstr "" msgid "" "The return value is an opaque \"handle\" to the :term:`attached thread " -"state` when :c:func:`PyGILState_Ensure` was called, and must be passed to :c:" -"func:`PyGILState_Release` to ensure Python is left in the same state. Even " -"though recursive calls are allowed, these handles *cannot* be shared - each " -"unique call to :c:func:`PyGILState_Ensure` must save the handle for its call " -"to :c:func:`PyGILState_Release`." +"state` when :c:func:`PyGILState_Ensure` was called, and must be passed " +"to :c:func:`PyGILState_Release` to ensure Python is left in the same state. " +"Even though recursive calls are allowed, these handles *cannot* be shared - " +"each unique call to :c:func:`PyGILState_Ensure` must save the handle for its " +"call to :c:func:`PyGILState_Release`." msgstr "" msgid "" @@ -1432,14 +1436,14 @@ msgstr "" msgid "" "Release any resources previously acquired. After this call, Python's state " -"will be the same as it was prior to the corresponding :c:func:" -"`PyGILState_Ensure` call (but generally this state will be unknown to the " -"caller, hence the use of the GILState API)." +"will be the same as it was prior to the " +"corresponding :c:func:`PyGILState_Ensure` call (but generally this state " +"will be unknown to the caller, hence the use of the GILState API)." msgstr "" msgid "" -"Every call to :c:func:`PyGILState_Ensure` must be matched by a call to :c:" -"func:`PyGILState_Release` on the same thread." +"Every call to :c:func:`PyGILState_Ensure` must be matched by a call " +"to :c:func:`PyGILState_Release` on the same thread." msgstr "" msgid "" @@ -1451,8 +1455,8 @@ msgstr "" msgid "" "This function may return non-``NULL`` even when the :term:`thread state` is " -"detached. Prefer :c:func:`PyThreadState_Get` or :c:func:" -"`PyThreadState_GetUnchecked` for most cases." +"detached. Prefer :c:func:`PyThreadState_Get` " +"or :c:func:`PyThreadState_GetUnchecked` for most cases." msgstr "" msgid ":c:func:`PyThreadState_Get`" @@ -1461,18 +1465,18 @@ msgstr "" msgid "" "Return ``1`` if the current thread is holding the :term:`GIL` and ``0`` " "otherwise. This function can be called from any thread at any time. Only if " -"it has had its :term:`thread state ` initialized via :" -"c:func:`PyGILState_Ensure` will it return ``1``. This is mainly a helper/" -"diagnostic function. It can be useful for example in callback contexts or " -"memory allocation functions when knowing that the :term:`GIL` is locked can " -"allow the caller to perform sensitive actions or otherwise behave " +"it has had its :term:`thread state ` initialized " +"via :c:func:`PyGILState_Ensure` will it return ``1``. This is mainly a " +"helper/diagnostic function. It can be useful for example in callback " +"contexts or memory allocation functions when knowing that the :term:`GIL` is " +"locked can allow the caller to perform sensitive actions or otherwise behave " "differently." msgstr "" msgid "" "If the current Python process has ever created a subinterpreter, this " -"function will *always* return ``1``. Prefer :c:func:" -"`PyThreadState_GetUnchecked` for most cases." +"function will *always* return ``1``. " +"Prefer :c:func:`PyThreadState_GetUnchecked` for most cases." msgstr "" msgid "" @@ -1481,27 +1485,27 @@ msgid "" msgstr "" msgid "" -"This macro expands to ``{ PyThreadState *_save; _save = PyEval_SaveThread();" -"``. Note that it contains an opening brace; it must be matched with a " -"following :c:macro:`Py_END_ALLOW_THREADS` macro. See above for further " -"discussion of this macro." +"This macro expands to ``{ PyThreadState *_save; _save = " +"PyEval_SaveThread();``. Note that it contains an opening brace; it must be " +"matched with a following :c:macro:`Py_END_ALLOW_THREADS` macro. See above " +"for further discussion of this macro." msgstr "" msgid "" "This macro expands to ``PyEval_RestoreThread(_save); }``. Note that it " -"contains a closing brace; it must be matched with an earlier :c:macro:" -"`Py_BEGIN_ALLOW_THREADS` macro. See above for further discussion of this " -"macro." +"contains a closing brace; it must be matched with an " +"earlier :c:macro:`Py_BEGIN_ALLOW_THREADS` macro. See above for further " +"discussion of this macro." msgstr "" msgid "" -"This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent to :" -"c:macro:`Py_END_ALLOW_THREADS` without the closing brace." +"This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent " +"to :c:macro:`Py_END_ALLOW_THREADS` without the closing brace." msgstr "" msgid "" -"This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent to :" -"c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " +"This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent " +"to :c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " "declaration." msgstr "" @@ -1513,8 +1517,8 @@ msgid "" msgstr "" msgid "" -":c:func:`Py_Initialize()` now initializes the :term:`GIL` and sets an :term:" -"`attached thread state`." +":c:func:`Py_Initialize()` now initializes the :term:`GIL` and sets " +"an :term:`attached thread state`." msgstr "" msgid "" @@ -1524,25 +1528,25 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_New`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython.PyInterpreterState_New`` with no arguments." msgstr "" msgid "" -"Reset all information in an interpreter state object. There must be an :" -"term:`attached thread state` for the interpreter." +"Reset all information in an interpreter state object. There must be " +"an :term:`attached thread state` for the interpreter." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_Clear`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython.PyInterpreterState_Clear`` with no arguments." msgstr "" msgid "" -"Destroy an interpreter state object. There **should not** be an :term:" -"`attached thread state` for the target interpreter. The interpreter state " -"must have been reset with a previous call to :c:func:" -"`PyInterpreterState_Clear`." +"Destroy an interpreter state object. There **should not** be " +"an :term:`attached thread state` for the target interpreter. The interpreter " +"state must have been reset with a previous call " +"to :c:func:`PyInterpreterState_Clear`." msgstr "" msgid "" @@ -1551,8 +1555,8 @@ msgid "" msgstr "" msgid "" -"Reset all information in a :term:`thread state` object. *tstate* must be :" -"term:`attached `" +"Reset all information in a :term:`thread state` object. *tstate* must " +"be :term:`attached `" msgstr "" msgid "" @@ -1564,9 +1568,9 @@ msgid "The :c:member:`!PyThreadState.on_delete` callback was removed." msgstr "" msgid "" -"Destroy a :term:`thread state` object. *tstate* should not be :term:" -"`attached ` to any thread. *tstate* must have been " -"reset with a previous call to :c:func:`PyThreadState_Clear`." +"Destroy a :term:`thread state` object. *tstate* should not " +"be :term:`attached ` to any thread. *tstate* must " +"have been reset with a previous call to :c:func:`PyThreadState_Clear`." msgstr "" msgid "" @@ -1630,13 +1634,13 @@ msgstr "" msgid "" "CPython implements :ref:`recursion control ` for C code by " "raising :py:exc:`RecursionError` when it notices that the machine execution " -"stack is close to overflow. See for example the :c:func:" -"`Py_EnterRecursiveCall` function. For this, it needs to know the location of " -"the current thread's stack, which it normally gets from the operating " -"system. When the stack is changed, for example using context switching " -"techniques like the Boost library's ``boost::context``, you must call :c:" -"func:`~PyUnstable_ThreadState_SetStackProtection` to inform CPython of the " -"change." +"stack is close to overflow. See for example " +"the :c:func:`Py_EnterRecursiveCall` function. For this, it needs to know the " +"location of the current thread's stack, which it normally gets from the " +"operating system. When the stack is changed, for example using context " +"switching techniques like the Boost library's ``boost::context``, you must " +"call :c:func:`~PyUnstable_ThreadState_SetStackProtection` to inform CPython " +"of the change." msgstr "" msgid "" @@ -1747,8 +1751,8 @@ msgid "" msgstr "" msgid "" -"The type of the *id* parameter changed from :c:expr:`long` to :c:expr:" -"`unsigned long`." +"The type of the *id* parameter changed from :c:expr:`long` " +"to :c:expr:`unsigned long`." msgstr "" msgid "" @@ -1761,9 +1765,10 @@ msgid "" msgstr "" msgid "" -"Updated to be consistent with :c:func:`PyEval_RestoreThread`, :c:func:" -"`Py_END_ALLOW_THREADS`, and :c:func:`PyGILState_Ensure`, and terminate the " -"current thread if called while the interpreter is finalizing." +"Updated to be consistent " +"with :c:func:`PyEval_RestoreThread`, :c:func:`Py_END_ALLOW_THREADS`, " +"and :c:func:`PyGILState_Ensure`, and terminate the current thread if called " +"while the interpreter is finalizing." msgstr "" msgid "" @@ -1773,8 +1778,8 @@ msgstr "" msgid "" "Detach the :term:`attached thread state`. The *tstate* argument, which must " -"not be ``NULL``, is only used to check that it represents the :term:" -"`attached thread state` --- if it isn't, a fatal error is reported." +"not be ``NULL``, is only used to check that it represents " +"the :term:`attached thread state` --- if it isn't, a fatal error is reported." msgstr "" msgid "" @@ -1803,9 +1808,9 @@ msgid "" msgstr "" msgid "" -"You can switch between sub-interpreters using the :c:func:" -"`PyThreadState_Swap` function. You can create and destroy them using the " -"following functions:" +"You can switch between sub-interpreters using " +"the :c:func:`PyThreadState_Swap` function. You can create and destroy them " +"using the following functions:" msgstr "" msgid "" @@ -1823,10 +1828,10 @@ msgid "" msgstr "" msgid "" -"If this is ``0`` then :c:member:`~PyInterpreterConfig." -"check_multi_interp_extensions` must be ``1`` (non-zero). If this is ``1`` " -"then :c:member:`~PyInterpreterConfig.gil` must not be :c:macro:" -"`PyInterpreterConfig_OWN_GIL`." +"If this is ``0`` " +"then :c:member:`~PyInterpreterConfig.check_multi_interp_extensions` must be " +"``1`` (non-zero). If this is ``1`` then :c:member:`~PyInterpreterConfig.gil` " +"must not be :c:macro:`PyInterpreterConfig_OWN_GIL`." msgstr "" msgid "" @@ -1856,21 +1861,21 @@ msgstr "" msgid "" "If this is ``0`` then the sub-interpreter's :mod:`threading` module won't " -"create daemon threads. Otherwise daemon threads are allowed (as long as :c:" -"member:`~PyInterpreterConfig.allow_threads` is non-zero)." +"create daemon threads. Otherwise daemon threads are allowed (as long " +"as :c:member:`~PyInterpreterConfig.allow_threads` is non-zero)." msgstr "" msgid "" "If this is ``0`` then all extension modules may be imported, including " "legacy (single-phase init) modules, in any thread where the sub-interpreter " -"is currently active. Otherwise only multi-phase init extension modules (see :" -"pep:`489`) may be imported. (Also see :c:macro:" -"`Py_mod_multiple_interpreters`.)" +"is currently active. Otherwise only multi-phase init extension modules " +"(see :pep:`489`) may be imported. (Also " +"see :c:macro:`Py_mod_multiple_interpreters`.)" msgstr "" msgid "" -"This must be ``1`` (non-zero) if :c:member:`~PyInterpreterConfig." -"use_main_obmalloc` is ``0``." +"This must be ``1`` (non-zero) " +"if :c:member:`~PyInterpreterConfig.use_main_obmalloc` is ``0``." msgstr "" msgid "" @@ -1888,20 +1893,20 @@ msgid "Use the sub-interpreter's own GIL." msgstr "" msgid "" -"If this is :c:macro:`PyInterpreterConfig_OWN_GIL` then :c:member:" -"`PyInterpreterConfig.use_main_obmalloc` must be ``0``." +"If this is :c:macro:`PyInterpreterConfig_OWN_GIL` " +"then :c:member:`PyInterpreterConfig.use_main_obmalloc` must be ``0``." msgstr "" msgid "" "Create a new sub-interpreter. This is an (almost) totally separate " "environment for the execution of Python code. In particular, the new " "interpreter has separate, independent versions of all imported modules, " -"including the fundamental modules :mod:`builtins`, :mod:`__main__` and :mod:" -"`sys`. The table of loaded modules (``sys.modules``) and the module search " -"path (``sys.path``) are also separate. The new environment has no ``sys." -"argv`` variable. It has new standard I/O stream file objects ``sys.stdin``, " -"``sys.stdout`` and ``sys.stderr`` (however these refer to the same " -"underlying file descriptors)." +"including the fundamental modules :mod:`builtins`, :mod:`__main__` " +"and :mod:`sys`. The table of loaded modules (``sys.modules``) and the " +"module search path (``sys.path``) are also separate. The new environment " +"has no ``sys.argv`` variable. It has new standard I/O stream file objects " +"``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` (however these refer to the " +"same underlying file descriptors)." msgstr "" msgid "" @@ -1923,12 +1928,12 @@ msgid "" "Like all other Python/C API functions, an :term:`attached thread state` must " "be present before calling this function, but it might be detached upon " "returning. On success, the returned thread state will be :term:`attached " -"`. If the sub-interpreter is created with its own :" -"term:`GIL` then the :term:`attached thread state` of the calling interpreter " -"will be detached. When the function returns, the new interpreter's :term:" -"`thread state` will be :term:`attached ` to the " -"current thread and the previous interpreter's :term:`attached thread state` " -"will remain detached." +"`. If the sub-interpreter is created with its " +"own :term:`GIL` then the :term:`attached thread state` of the calling " +"interpreter will be detached. When the function returns, the new " +"interpreter's :term:`thread state` will be :term:`attached ` to the current thread and the previous interpreter's :term:`attached " +"thread state` will remain detached." msgstr "" msgid "" @@ -1955,47 +1960,48 @@ msgstr "" msgid "" "Note that the config is used only briefly and does not get modified. During " -"initialization the config's values are converted into various :c:type:" -"`PyInterpreterState` values. A read-only copy of the config may be stored " -"internally on the :c:type:`PyInterpreterState`." +"initialization the config's values are converted into " +"various :c:type:`PyInterpreterState` values. A read-only copy of the config " +"may be stored internally on the :c:type:`PyInterpreterState`." msgstr "" msgid "Extension modules are shared between (sub-)interpreters as follows:" msgstr "" msgid "" -"For modules using multi-phase initialization, e.g. :c:func:" -"`PyModule_FromDefAndSpec`, a separate module object is created and " -"initialized for each interpreter. Only C-level static and global variables " -"are shared between these module objects." +"For modules using multi-phase initialization, " +"e.g. :c:func:`PyModule_FromDefAndSpec`, a separate module object is created " +"and initialized for each interpreter. Only C-level static and global " +"variables are shared between these module objects." msgstr "" msgid "" -"For modules using single-phase initialization, e.g. :c:func:" -"`PyModule_Create`, the first time a particular extension is imported, it is " -"initialized normally, and a (shallow) copy of its module's dictionary is " -"squirreled away. When the same extension is imported by another " -"(sub-)interpreter, a new module is initialized and filled with the contents " -"of this copy; the extension's ``init`` function is not called. Objects in " -"the module's dictionary thus end up shared across (sub-)interpreters, which " -"might cause unwanted behavior (see `Bugs and caveats`_ below)." +"For modules using single-phase initialization, " +"e.g. :c:func:`PyModule_Create`, the first time a particular extension is " +"imported, it is initialized normally, and a (shallow) copy of its module's " +"dictionary is squirreled away. When the same extension is imported by " +"another (sub-)interpreter, a new module is initialized and filled with the " +"contents of this copy; the extension's ``init`` function is not called. " +"Objects in the module's dictionary thus end up shared across " +"(sub-)interpreters, which might cause unwanted behavior (see `Bugs and " +"caveats`_ below)." msgstr "" msgid "" "Note that this is different from what happens when an extension is imported " -"after the interpreter has been completely re-initialized by calling :c:func:" -"`Py_FinalizeEx` and :c:func:`Py_Initialize`; in that case, the extension's " -"``initmodule`` function *is* called again. As with multi-phase " -"initialization, this means that only C-level static and global variables are " -"shared between these modules." +"after the interpreter has been completely re-initialized by " +"calling :c:func:`Py_FinalizeEx` and :c:func:`Py_Initialize`; in that case, " +"the extension's ``initmodule`` function *is* called again. As with multi-" +"phase initialization, this means that only C-level static and global " +"variables are shared between these modules." msgstr "" msgid "" -"Create a new sub-interpreter. This is essentially just a wrapper around :c:" -"func:`Py_NewInterpreterFromConfig` with a config that preserves the existing " -"behavior. The result is an unisolated sub-interpreter that shares the main " -"interpreter's GIL, allows fork/exec, allows daemon threads, and allows " -"single-phase init modules." +"Create a new sub-interpreter. This is essentially just a wrapper " +"around :c:func:`Py_NewInterpreterFromConfig` with a config that preserves " +"the existing behavior. The result is an unisolated sub-interpreter that " +"shares the main interpreter's GIL, allows fork/exec, allows daemon threads, " +"and allows single-phase init modules." msgstr "" msgid "" @@ -2081,10 +2087,10 @@ msgid "" "delicate, because these APIs assume a bijection between Python thread states " "and OS-level threads, an assumption broken by the presence of sub-" "interpreters. It is highly recommended that you don't switch sub-" -"interpreters between a pair of matching :c:func:`PyGILState_Ensure` and :c:" -"func:`PyGILState_Release` calls. Furthermore, extensions (such as :mod:" -"`ctypes`) using these APIs to allow calling of Python code from non-Python " -"created threads will probably be broken when using sub-interpreters." +"interpreters between a pair of matching :c:func:`PyGILState_Ensure` " +"and :c:func:`PyGILState_Release` calls. Furthermore, extensions (such " +"as :mod:`ctypes`) using these APIs to allow calling of Python code from non-" +"Python created threads will probably be broken when using sub-interpreters." msgstr "" msgid "Asynchronous Notifications" @@ -2126,9 +2132,9 @@ msgstr "" msgid "" "This function doesn't need an :term:`attached thread state`. However, to " -"call this function in a subinterpreter, the caller must have an :term:" -"`attached thread state`. Otherwise, the function *func* can be scheduled to " -"be called from the wrong interpreter." +"call this function in a subinterpreter, the caller must have " +"an :term:`attached thread state`. Otherwise, the function *func* can be " +"scheduled to be called from the wrong interpreter." msgstr "" msgid "" @@ -2136,8 +2142,8 @@ msgid "" "no guarantee that *func* will be called as quick as possible. If the main " "thread is busy executing a system call, *func* won't be called before the " "system call returns. This function is generally **not** suitable for " -"calling Python code from arbitrary C threads. Instead, use the :ref:" -"`PyGILState API`." +"calling Python code from arbitrary C threads. Instead, use " +"the :ref:`PyGILState API`." msgstr "" msgid "" @@ -2163,8 +2169,8 @@ msgstr "" msgid "" "If this is not called in the main thread of the main interpreter, this " -"function does nothing and returns ``0``. The caller must hold an :term:" -"`attached thread state`." +"function does nothing and returns ``0``. The caller must hold " +"an :term:`attached thread state`." msgstr "" msgid "This function only runs pending calls in the main interpreter." @@ -2192,11 +2198,9 @@ msgid "" "The type of the trace function registered using :c:func:`PyEval_SetProfile` " "and :c:func:`PyEval_SetTrace`. The first parameter is the object passed to " "the registration function as *obj*, *frame* is the frame object to which the " -"event pertains, *what* is one of the constants :c:data:`PyTrace_CALL`, :c:" -"data:`PyTrace_EXCEPTION`, :c:data:`PyTrace_LINE`, :c:data:`PyTrace_RETURN`, :" -"c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION`, :c:data:" -"`PyTrace_C_RETURN`, or :c:data:`PyTrace_OPCODE`, and *arg* depends on the " -"value of *what*:" +"event pertains, *what* is one of the " +"constants :c:data:`PyTrace_CALL`, :c:data:`PyTrace_EXCEPTION`, :c:data:`PyTrace_LINE`, :c:data:`PyTrace_RETURN`, :c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION`, :c:data:`PyTrace_C_RETURN`, " +"or :c:data:`PyTrace_OPCODE`, and *arg* depends on the value of *what*:" msgstr "" msgid "Value of *what*" @@ -2264,8 +2268,8 @@ msgstr "" msgid "" "The value passed as the *what* parameter to a :c:type:`Py_tracefunc` " "function (but not a profiling function) when a line-number event is being " -"reported. It may be disabled for a frame by setting :attr:`~frame." -"f_trace_lines` to *0* on that frame." +"reported. It may be disabled for a frame by " +"setting :attr:`~frame.f_trace_lines` to *0* on that frame." msgstr "" msgid "" @@ -2291,8 +2295,8 @@ msgstr "" msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions (but " "not profiling functions) when a new opcode is about to be executed. This " -"event is not emitted by default: it must be explicitly requested by setting :" -"attr:`~frame.f_trace_opcodes` to *1* on the frame." +"event is not emitted by default: it must be explicitly requested by " +"setting :attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" msgid "" @@ -2300,8 +2304,9 @@ msgid "" "function as its first parameter, and may be any Python object, or ``NULL``. " "If the profile function needs to maintain state, using a different value for " "*obj* for each thread provides a convenient and thread-safe place to store " -"it. The profile function is called for all monitored events except :c:data:" -"`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`." +"it. The profile function is called for all monitored events " +"except :c:data:`PyTrace_LINE` :c:data:`PyTrace_OPCODE` " +"and :c:data:`PyTrace_EXCEPTION`." msgstr "" msgid "See also the :func:`sys.setprofile` function." @@ -2319,13 +2324,13 @@ msgid "" msgstr "" msgid "" -"Set the tracing function to *func*. This is similar to :c:func:" -"`PyEval_SetProfile`, except the tracing function does receive line-number " -"events and per-opcode events, but does not receive any event related to C " -"function objects being called. Any trace function registered using :c:func:" -"`PyEval_SetTrace` will not receive :c:data:`PyTrace_C_CALL`, :c:data:" -"`PyTrace_C_EXCEPTION` or :c:data:`PyTrace_C_RETURN` as a value for the " -"*what* parameter." +"Set the tracing function to *func*. This is similar " +"to :c:func:`PyEval_SetProfile`, except the tracing function does receive " +"line-number events and per-opcode events, but does not receive any event " +"related to C function objects being called. Any trace function registered " +"using :c:func:`PyEval_SetTrace` will not " +"receive :c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION` " +"or :c:data:`PyTrace_C_RETURN` as a value for the *what* parameter." msgstr "" msgid "See also the :func:`sys.settrace` function." @@ -2346,12 +2351,12 @@ msgid "Reference tracing" msgstr "" msgid "" -"The type of the trace function registered using :c:func:" -"`PyRefTracer_SetTracer`. The first parameter is a Python object that has " -"been just created (when **event** is set to :c:data:`PyRefTracer_CREATE`) or " -"about to be destroyed (when **event** is set to :c:data:" -"`PyRefTracer_DESTROY`). The **data** argument is the opaque pointer that was " -"provided when :c:func:`PyRefTracer_SetTracer` was called." +"The type of the trace function registered " +"using :c:func:`PyRefTracer_SetTracer`. The first parameter is a Python " +"object that has been just created (when **event** is set " +"to :c:data:`PyRefTracer_CREATE`) or about to be destroyed (when **event** is " +"set to :c:data:`PyRefTracer_DESTROY`). The **data** argument is the opaque " +"pointer that was provided when :c:func:`PyRefTracer_SetTracer` was called." msgstr "" msgid "" @@ -2443,10 +2448,10 @@ msgid "" msgstr "" msgid "" -"None of these API functions handle memory management on behalf of the :c:" -"expr:`void*` values. You need to allocate and deallocate them yourself. If " -"the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, these functions " -"don't do refcount operations on them either." +"None of these API functions handle memory management on behalf of " +"the :c:expr:`void*` values. You need to allocate and deallocate them " +"yourself. If the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, " +"these functions don't do refcount operations on them either." msgstr "" msgid "Thread Specific Storage (TSS) API" @@ -2488,8 +2493,9 @@ msgid "" msgstr "" msgid "" -"Return a value which is the same state as a value initialized with :c:macro:" -"`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic allocation failure." +"Return a value which is the same state as a value initialized " +"with :c:macro:`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic " +"allocation failure." msgstr "" msgid "" @@ -2508,8 +2514,8 @@ msgstr "" msgid "" "The parameter *key* of these functions must not be ``NULL``. Moreover, the " "behaviors of :c:func:`PyThread_tss_set` and :c:func:`PyThread_tss_get` are " -"undefined if the given :c:type:`Py_tss_t` has not been initialized by :c:" -"func:`PyThread_tss_create`." +"undefined if the given :c:type:`Py_tss_t` has not been initialized " +"by :c:func:`PyThread_tss_create`." msgstr "" msgid "" @@ -2528,9 +2534,9 @@ msgstr "" msgid "" "Destroy a TSS key to forget the values associated with the key across all " "threads, and change the key's initialization state to uninitialized. A " -"destroyed key is able to be initialized again by :c:func:" -"`PyThread_tss_create`. This function can be called repeatedly on the same " -"key -- calling it on an already destroyed key is a no-op." +"destroyed key is able to be initialized again " +"by :c:func:`PyThread_tss_create`. This function can be called repeatedly on " +"the same key -- calling it on an already destroyed key is a no-op." msgstr "" msgid "" @@ -2625,10 +2631,11 @@ msgstr "" msgid "" "Critical sections are intended to be used for custom types implemented in C-" -"API extensions. They should generally not be used with built-in types like :" -"class:`list` and :class:`dict` because their public C-APIs already use " -"critical sections internally, with the notable exception of :c:func:" -"`PyDict_Next`, which requires critical section to be acquired externally." +"API extensions. They should generally not be used with built-in types " +"like :class:`list` and :class:`dict` because their public C-APIs already use " +"critical sections internally, with the notable exception " +"of :c:func:`PyDict_Next`, which requires critical section to be acquired " +"externally." msgstr "" msgid "" @@ -2657,11 +2664,11 @@ msgid "" msgstr "" msgid "" -"Operations that need to lock two objects at once must use :c:macro:" -"`Py_BEGIN_CRITICAL_SECTION2`. You *cannot* use nested critical sections to " -"lock more than one object at once, because the inner critical section may " -"suspend the outer critical sections. This API does not provide a way to " -"lock more than two objects at once." +"Operations that need to lock two objects at once must " +"use :c:macro:`Py_BEGIN_CRITICAL_SECTION2`. You *cannot* use nested critical " +"sections to lock more than one object at once, because the inner critical " +"section may suspend the outer critical sections. This API does not provide " +"a way to lock more than two objects at once." msgstr "" msgid "Example usage::" @@ -2683,8 +2690,8 @@ msgid "" "can call arbitrary code through an object's deallocation function. The " "critical section API avoids potential deadlocks due to reentrancy and lock " "ordering by allowing the runtime to temporarily suspend the critical section " -"if the code triggered by the finalizer blocks and calls :c:func:" -"`PyEval_SaveThread`." +"if the code triggered by the finalizer blocks and " +"calls :c:func:`PyEval_SaveThread`." msgstr "" msgid "" @@ -2770,8 +2777,8 @@ msgid "Legacy Locking APIs" msgstr "" msgid "" -"These APIs are obsolete since Python 3.13 with the introduction of :c:type:" -"`PyMutex`." +"These APIs are obsolete since Python 3.13 with the introduction " +"of :c:type:`PyMutex`." msgstr "" msgid "These APIs are now a simple wrapper around ``PyMutex``." @@ -2825,13 +2832,13 @@ msgstr "" msgid "" "If *intr_flag* is ``1``, acquiring the lock may be interrupted by a signal, " "in which case this function returns :c:enumerator:`PY_LOCK_INTR`. Upon " -"interruption, it's generally expected that the caller makes a call to :c:" -"func:`Py_MakePendingCalls` to propagate an exception to Python code." +"interruption, it's generally expected that the caller makes a call " +"to :c:func:`Py_MakePendingCalls` to propagate an exception to Python code." msgstr "" msgid "" -"If the lock is successfully acquired, this function returns :c:enumerator:" -"`PY_LOCK_ACQUIRED`." +"If the lock is successfully acquired, this function " +"returns :c:enumerator:`PY_LOCK_ACQUIRED`." msgstr "" msgid "Acquire *lock*." @@ -2885,17 +2892,17 @@ msgid "Return the identifier of the current thread, which will never be zero." msgstr "" msgid "" -"This function cannot fail, and the caller does not need to hold an :term:" -"`attached thread state`." +"This function cannot fail, and the caller does not need to hold " +"an :term:`attached thread state`." msgstr "" msgid ":py:func:`threading.get_ident`" msgstr "" msgid "" -"Get general information about the current thread in the form of a :ref:" -"`struct sequence ` object. This information is " -"accessible as :py:attr:`sys.thread_info` in Python." +"Get general information about the current thread in the form of " +"a :ref:`struct sequence ` object. This information " +"is accessible as :py:attr:`sys.thread_info` in Python." msgstr "" msgid "" diff --git a/c-api/init_config.po b/c-api/init_config.po index 1e09de5645..95904ec3af 100644 --- a/c-api/init_config.po +++ b/c-api/init_config.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,25 +25,29 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Python Initialization Configuration" -msgstr "" +msgstr "Konfiguracja inicjalizacja Pythona" msgid "PyInitConfig C API" -msgstr "" +msgstr "API C PyInitConfig" msgid "Python can be initialized with :c:func:`Py_InitializeFromInitConfig`." msgstr "" +":c:func:`Py_InitializeFromInitConfig`Python może zostać zainicjowany za " +"pomocą." msgid "" "The :c:func:`Py_RunMain` function can be used to write a customized Python " "program." msgstr "" +"Funkcja ta może być użyta do napisania dostosowanego programu w języku " +"Python.:c:func:`Py_RunMain`" msgid "" "See also :ref:`Initialization, Finalization, and Threads `." -msgstr "" +msgstr "inicjalizacja patrz również, wątek" msgid ":pep:`741` \"Python Configuration C API\"." -msgstr "" +msgstr "„Konfiguracja języka C w Pythona API”.:pep:`741`" msgid "Example" msgstr "Przykład" @@ -51,6 +56,8 @@ msgid "" "Example of customized Python always running with the :ref:`Python " "Development Mode ` enabled; return ``-1`` on error:" msgstr "" +"Przykład dostosowanego języka Python zawsze działającego z " +"włączonym :ref:`Tryb deweloperski Python`; zwracać w przypadku błędu:``-1``" msgid "" "int init_python(void)\n" @@ -87,35 +94,73 @@ msgid "" " }\n" "}" msgstr "" +"nt init_python(void)\n" +"{\n" +"PyInitConfig *config = PyInitConfig_Create();\n" +"if (config == NULL) {\n" +"printf(\"PYTHON INIT ERROR: alokacja pamięci nie powiodła się\\n\");\n" +"zwracać -1;\n" +"}\n" +"\n" +"// Włącz tryb programistyczny Pythona\n" +"if (PyInitConfig_SetInt(config, \"dev_mode\", 1) < 0) {\n" +"goto error;\n" +"}\n" +"\n" +"// Zainicjuj Pythona konfiguracją\n" +"if (Py_InitializeFromInitConfig(config) < 0) {\n" +"goto error;\n" +"}\n" +"PyInitConfig_Free(config);\n" +"zwracać 0;\n" +"\n" +"error:\n" +"{\n" +"// Wyświetl komunikat o błędzie.\n" +"//\n" +"// Używany jest ten nietypowy styl nawiasów klamrowych, ponieważ nie można " +"sprawić, by\n" +"// cele goto wskazywały na deklaracje zmiennych.\n" +"const char *err_msg;\n" +"(void)PyInitConfig_GetError(config, &err_msg);\n" +"printf(\"BŁĄD INICJALIZACJI PYTHONA: \\n\", err_msg);\n" +"PyInitConfig_Free(config);\n" +"zwracać -1;\n" +"}\n" +"}" msgid "Create Config" -msgstr "" +msgstr "Utwórz konfigurację" msgid "Opaque structure to configure the Python initialization." -msgstr "" +msgstr "Nieprzezroczysta struktura do konfiguracji inicjalizacja Pythona." msgid "" "Create a new initialization configuration using :ref:`Isolated Configuration " "` default values." msgstr "" +"Utwórz nową konfigurację inicjalizacja przy użyciu domyślny " +"wartości :ref:`Izolowana konfiguracja` '`." msgid "It must be freed by :c:func:`PyInitConfig_Free`." -msgstr "" +msgstr "Musi zostać uwolniony przez:c:func:`PyInitConfig_Free`" msgid "Return ``NULL`` on memory allocation failure." -msgstr "" +msgstr " Zwraca w przypadku niepowodzenia alokacja pamięci. ``NULL``" msgid "Free memory of the initialization configuration *config*." -msgstr "" +msgstr "Zwolnij pamięć konfiguracji inicjalizacja *config*." msgid "If *config* is ``NULL``, no operation is performed." msgstr "" +"Jeżeli *config* ma ``NULL``wartość , żadna operacja nie zostanie wykonana." msgid "Error Handling" msgstr "Przechwytywanie błędów" msgid "Get the *config* error message." -msgstr "" +msgstr "Otrzymasz komunikat o błędzie *config*." msgid "Set *\\*err_msg* and return ``1`` if an error is set." msgstr "" @@ -482,11 +527,11 @@ msgid "``\"legacy_windows_fs_encoding\"``" msgstr "``\"legacy_windows_fs_encoding\"``" msgid "" -":c:member:`legacy_windows_fs_encoding `" +":c:member:`legacy_windows_fs_encoding " +"`" msgstr "" -":c:member:`legacy_windows_fs_encoding `" +":c:member:`legacy_windows_fs_encoding " +"`" msgid "``\"legacy_windows_stdio\"``" msgstr "``\"legacy_windows_stdio\"``" @@ -723,21 +768,21 @@ msgid "Visibility:" msgstr "" msgid "" -"Public: Can be retrieved by :c:func:`PyConfig_Get` and set by :c:func:" -"`PyConfig_Set`." +"Public: Can be retrieved by :c:func:`PyConfig_Get` and set " +"by :c:func:`PyConfig_Set`." msgstr "" msgid "" -"Read-only: Can be retrieved by :c:func:`PyConfig_Get`, but cannot be set by :" -"c:func:`PyConfig_Set`." +"Read-only: Can be retrieved by :c:func:`PyConfig_Get`, but cannot be set " +"by :c:func:`PyConfig_Set`." msgstr "" msgid "Runtime Python configuration API" msgstr "" msgid "" -"At runtime, it's possible to get and set configuration options using :c:func:" -"`PyConfig_Get` and :c:func:`PyConfig_Set` functions." +"At runtime, it's possible to get and set configuration options " +"using :c:func:`PyConfig_Get` and :c:func:`PyConfig_Set` functions." msgstr "" msgid "" @@ -792,13 +837,18 @@ msgid "" "arguments ``name``, ``value``." msgstr "" +msgid "" +"The function now replaces :data:`sys.flags` (create a new object), instead " +"of modifying :data:`sys.flags` in-place." +msgstr "" + msgid "PyConfig C API" msgstr "" msgid "" -"Python can be initialized with :c:func:`Py_InitializeFromConfig` and the :c:" -"type:`PyConfig` structure. It can be preinitialized with :c:func:" -"`Py_PreInitialize` and the :c:type:`PyPreConfig` structure." +"Python can be initialized with :c:func:`Py_InitializeFromConfig` and " +"the :c:type:`PyConfig` structure. It can be preinitialized " +"with :c:func:`Py_PreInitialize` and the :c:type:`PyPreConfig` structure." msgstr "" msgid "There are two kinds of configuration:" @@ -981,7 +1031,7 @@ msgid "" " if (PyStatus_Exception(status)) {\n" " Py_ExitStatusException(status);\n" " }\n" -" PyMem_Free(ptr);\n" +" PyMem_RawFree(ptr);\n" " return 0;\n" "}" msgstr "" @@ -1027,8 +1077,8 @@ msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): use ``malloc()`` of the C library." msgstr "" msgid "" -"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with :" -"ref:`debug hooks `." +"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` " +"with :ref:`debug hooks `." msgstr "" msgid "" @@ -1042,12 +1092,12 @@ msgid "" msgstr "" msgid "" -"``PYMEM_ALLOCATOR_MIMALLOC`` (``6``): use ``mimalloc``, a fast malloc " +"``PYMEM_ALLOCATOR_MIMALLOC`` (``7``): use ``mimalloc``, a fast malloc " "replacement." msgstr "" msgid "" -"``PYMEM_ALLOCATOR_MIMALLOC_DEBUG`` (``7``): use ``mimalloc``, a fast malloc " +"``PYMEM_ALLOCATOR_MIMALLOC_DEBUG`` (``8``): use ``mimalloc``, a fast malloc " "replacement with :ref:`debug hooks `." msgstr "" @@ -1073,8 +1123,8 @@ msgid "Set the LC_CTYPE locale to the user preferred locale." msgstr "" msgid "" -"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` and :c:" -"member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``." +"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` " +"and :c:member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``." msgstr "" msgid "See the :term:`locale encoding`." @@ -1136,15 +1186,15 @@ msgid "Default: ``0``." msgstr "" msgid "" -"If non-zero, :c:func:`Py_PreInitializeFromArgs` and :c:func:" -"`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument the same way " -"the regular Python parses command line arguments: see :ref:`Command Line " -"Arguments `." +"If non-zero, :c:func:`Py_PreInitializeFromArgs` " +"and :c:func:`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument " +"the same way the regular Python parses command line arguments: " +"see :ref:`Command Line Arguments `." msgstr "" msgid "" -"Use :ref:`environment variables `? See :c:member:`PyConfig." -"use_environment`." +"Use :ref:`environment variables `? " +"See :c:member:`PyConfig.use_environment`." msgstr "" msgid "Default: ``1`` in Python config and ``0`` in isolated config." @@ -1177,8 +1227,8 @@ msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)" msgstr "" msgid "" -"Set the :ref:`Python UTF-8 Mode ` (:c:member:`PyPreConfig." -"utf8_mode`)" +"Set the :ref:`Python UTF-8 Mode ` " +"(:c:member:`PyPreConfig.utf8_mode`)" msgstr "" msgid "" @@ -1196,34 +1246,34 @@ msgid "*preconfig* must not be ``NULL``." msgstr "" msgid "" -"Parse *argv* command line arguments (bytes strings) if :c:member:" -"`~PyPreConfig.parse_argv` of *preconfig* is non-zero." +"Parse *argv* command line arguments (bytes strings) " +"if :c:member:`~PyPreConfig.parse_argv` of *preconfig* is non-zero." msgstr "" msgid "" -"Parse *argv* command line arguments (wide strings) if :c:member:" -"`~PyPreConfig.parse_argv` of *preconfig* is non-zero." +"Parse *argv* command line arguments (wide strings) " +"if :c:member:`~PyPreConfig.parse_argv` of *preconfig* is non-zero." msgstr "" msgid "" -"The caller is responsible to handle exceptions (error or exit) using :c:func:" -"`PyStatus_Exception` and :c:func:`Py_ExitStatusException`." +"The caller is responsible to handle exceptions (error or exit) " +"using :c:func:`PyStatus_Exception` and :c:func:`Py_ExitStatusException`." msgstr "" msgid "" -"For :ref:`Python Configuration ` (:c:func:" -"`PyPreConfig_InitPythonConfig`), if Python is initialized with command line " -"arguments, the command line arguments must also be passed to preinitialize " -"Python, since they have an effect on the pre-configuration like encodings. " -"For example, the :option:`-X utf8 <-X>` command line option enables the :ref:" -"`Python UTF-8 Mode `." +"For :ref:`Python Configuration ` " +"(:c:func:`PyPreConfig_InitPythonConfig`), if Python is initialized with " +"command line arguments, the command line arguments must also be passed to " +"preinitialize Python, since they have an effect on the pre-configuration " +"like encodings. For example, the :option:`-X utf8 <-X>` command line option " +"enables the :ref:`Python UTF-8 Mode `." msgstr "" msgid "" "``PyMem_SetAllocator()`` can be called after :c:func:`Py_PreInitialize` and " "before :c:func:`Py_InitializeFromConfig` to install a custom memory " -"allocator. It can be called before :c:func:`Py_PreInitialize` if :c:member:" -"`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``." +"allocator. It can be called before :c:func:`Py_PreInitialize` " +"if :c:member:`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``." msgstr "" msgid "" @@ -1299,8 +1349,8 @@ msgstr "" msgid "" "Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) " -"from the *argv* list of bytes strings. Decode bytes using :c:func:" -"`Py_DecodeLocale`." +"from the *argv* list of bytes strings. Decode bytes " +"using :c:func:`Py_DecodeLocale`." msgstr "" msgid "Set the list of wide strings *list* to *length* and *items*." @@ -1320,15 +1370,16 @@ msgstr "" msgid "" "The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` " "arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after " -"arguments are parsed. Since Python arguments are stripped from :c:member:" -"`PyConfig.argv`, parsing arguments twice would parse the application options " -"as Python options." +"arguments are parsed. Since Python arguments are stripped " +"from :c:member:`PyConfig.argv`, parsing arguments twice would parse the " +"application options as Python options." msgstr "" msgid "" -"The :c:member:`PyConfig.argv` arguments are now only parsed once, :c:member:" -"`PyConfig.parse_argv` is set to ``2`` after arguments are parsed, and " -"arguments are only parsed if :c:member:`PyConfig.parse_argv` equals ``1``." +"The :c:member:`PyConfig.argv` arguments are now only parsed " +"once, :c:member:`PyConfig.parse_argv` is set to ``2`` after arguments are " +"parsed, and arguments are only parsed if :c:member:`PyConfig.parse_argv` " +"equals ``1``." msgstr "" msgid "" @@ -1342,10 +1393,10 @@ msgstr "" msgid "" "Most ``PyConfig`` methods :ref:`preinitialize Python ` if needed. " -"In that case, the Python preinitialization configuration (:c:type:" -"`PyPreConfig`) is based on the :c:type:`PyConfig`. If configuration fields " -"which are in common with :c:type:`PyPreConfig` are tuned, they must be set " -"before calling a :c:type:`PyConfig` method:" +"In that case, the Python preinitialization configuration " +"(:c:type:`PyPreConfig`) is based on the :c:type:`PyConfig`. If configuration " +"fields which are in common with :c:type:`PyPreConfig` are tuned, they must " +"be set before calling a :c:type:`PyConfig` method:" msgstr "" msgid ":c:member:`PyConfig.dev_mode`" @@ -1363,8 +1414,8 @@ msgstr ":c:member:`PyConfig.use_environment`" msgid "" "Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` " "is used, this method must be called before other methods, since the " -"preinitialization configuration depends on command line arguments (if :c:" -"member:`~PyConfig.parse_argv` is non-zero)." +"preinitialization configuration depends on command line arguments " +"(if :c:member:`~PyConfig.parse_argv` is non-zero)." msgstr "" msgid "" @@ -1373,18 +1424,20 @@ msgid "" msgstr "" msgid "" -"Set :data:`sys.argv` command line arguments based on :c:member:`~PyConfig." -"argv`. These parameters are similar to those passed to the program's :c:" -"func:`main` function with the difference that the first entry should refer " -"to the script file to be executed rather than the executable hosting the " -"Python interpreter. If there isn't a script that will be run, the first " -"entry in :c:member:`~PyConfig.argv` can be an empty string." +"Set :data:`sys.argv` command line arguments based " +"on :c:member:`~PyConfig.argv`. These parameters are similar to those passed " +"to the program's :c:func:`main` function with the difference that the first " +"entry should refer to the script file to be executed rather than the " +"executable hosting the Python interpreter. If there isn't a script that " +"will be run, the first entry in :c:member:`~PyConfig.argv` can be an empty " +"string." msgstr "" msgid "" -"Set :c:member:`~PyConfig.parse_argv` to ``1`` to parse :c:member:`~PyConfig." -"argv` the same way the regular Python parses Python command line arguments " -"and then to strip Python arguments from :c:member:`~PyConfig.argv`." +"Set :c:member:`~PyConfig.parse_argv` to ``1`` to " +"parse :c:member:`~PyConfig.argv` the same way the regular Python parses " +"Python command line arguments and then to strip Python arguments " +"from :c:member:`~PyConfig.argv`." msgstr "" msgid "" @@ -1399,8 +1452,8 @@ msgid "See also the :c:member:`~PyConfig.orig_argv` member." msgstr "" msgid "" -"If equals to zero, ``Py_RunMain()`` prepends a potentially unsafe path to :" -"data:`sys.path` at startup:" +"If equals to zero, ``Py_RunMain()`` prepends a potentially unsafe path " +"to :data:`sys.path` at startup:" msgstr "" msgid "" @@ -1419,8 +1472,8 @@ msgid "" msgstr "" msgid "" -"Set to ``1`` by the :option:`-P` command line option and the :envvar:" -"`PYTHONSAFEPATH` environment variable." +"Set to ``1`` by the :option:`-P` command line option and " +"the :envvar:`PYTHONSAFEPATH` environment variable." msgstr "" msgid "Default: ``0`` in Python config, ``1`` in isolated config." @@ -1435,10 +1488,10 @@ msgstr "" msgid "See also :c:member:`PyConfig.exec_prefix`." msgstr "" -msgid "Python base executable: :data:`sys._base_executable`." +msgid "Python base executable: ``sys._base_executable``." msgstr "" -msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable." +msgid "Set by the ``__PYVENV_LAUNCHER__`` environment variable." msgstr "" msgid "Set from :c:member:`PyConfig.executable` if ``NULL``." @@ -1459,8 +1512,8 @@ msgid "" msgstr "" msgid "" -"Set to ``0`` by the :option:`-u` command line option and the :envvar:" -"`PYTHONUNBUFFERED` environment variable." +"Set to ``0`` by the :option:`-u` command line option and " +"the :envvar:`PYTHONUNBUFFERED` environment variable." msgstr "" msgid "stdin is always opened in buffered mode." @@ -1470,8 +1523,9 @@ msgid "Default: ``1``." msgstr "Domyślny: ``1``." msgid "" -"If equals to ``1``, issue a warning when comparing :class:`bytes` or :class:" -"`bytearray` with :class:`str`, or comparing :class:`bytes` with :class:`int`." +"If equals to ``1``, issue a warning when comparing :class:`bytes` " +"or :class:`bytearray` with :class:`str`, or comparing :class:`bytes` " +"with :class:`int`." msgstr "" msgid "" @@ -1483,9 +1537,9 @@ msgid "Incremented by the :option:`-b` command line option." msgstr "" msgid "" -"If non-zero, emit a :exc:`EncodingWarning` warning when :class:`io." -"TextIOWrapper` uses its default encoding. See :ref:`io-encoding-warning` for " -"details." +"If non-zero, emit a :exc:`EncodingWarning` warning " +"when :class:`io.TextIOWrapper` uses its default encoding. See :ref:`io-" +"encoding-warning` for details." msgstr "" msgid "" @@ -1500,8 +1554,8 @@ msgid "" msgstr "" msgid "" -"Control the validation behavior of hash-based ``.pyc`` files: value of the :" -"option:`--check-hash-based-pycs` command line option." +"Control the validation behavior of hash-based ``.pyc`` files: value of " +"the :option:`--check-hash-based-pycs` command line option." msgstr "" msgid "Valid values:" @@ -1547,8 +1601,8 @@ msgid "If non-zero, enable the :ref:`Python Development Mode `." msgstr "" msgid "" -"Set to ``1`` by the :option:`-X dev <-X>` option and the :envvar:" -"`PYTHONDEVMODE` environment variable." +"Set to ``1`` by the :option:`-X dev <-X>` option and " +"the :envvar:`PYTHONDEVMODE` environment variable." msgstr "" msgid "Dump Python references?" @@ -1580,8 +1634,8 @@ msgid "See also :c:member:`PyConfig.base_exec_prefix`." msgstr "" msgid "" -"The absolute path of the executable binary for the Python interpreter: :data:" -"`sys.executable`." +"The absolute path of the executable binary for the Python " +"interpreter: :data:`sys.executable`." msgstr "" msgid "See also :c:member:`PyConfig.base_executable`." @@ -1594,22 +1648,22 @@ msgid "If non-zero, call :func:`faulthandler.enable` at startup." msgstr "" msgid "" -"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:" -"`PYTHONFAULTHANDLER` environment variable." +"Set to ``1`` by :option:`-X faulthandler <-X>` and " +"the :envvar:`PYTHONFAULTHANDLER` environment variable." msgstr "" msgid "" -":term:`Filesystem encoding `: :func:" -"`sys.getfilesystemencoding`." +":term:`Filesystem encoding `: :func:`sys.getfilesystemencoding`." msgstr "" msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default." msgstr "" msgid "" -"On Windows: use ``\"utf-8\"`` by default, or ``\"mbcs\"`` if :c:member:" -"`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is non-" -"zero." +"On Windows: use ``\"utf-8\"`` by default, or ``\"mbcs\"`` " +"if :c:member:`~PyPreConfig.legacy_windows_fs_encoding` " +"of :c:type:`PyPreConfig` is non-zero." msgstr "" msgid "Default encoding on other platforms:" @@ -1640,14 +1694,19 @@ msgid "See also the :c:member:`~PyConfig.filesystem_errors` member." msgstr "" msgid "" -":term:`Filesystem error handler `: :" -"func:`sys.getfilesystemencodeerrors`." +"See also :c:func:`PyUnicode_EncodeFSDefault` and :ref:`related functions " +"` for encoding paths at runtime." msgstr "" msgid "" -"On Windows: use ``\"surrogatepass\"`` by default, or ``\"replace\"`` if :c:" -"member:`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is " -"non-zero." +":term:`Filesystem error handler `: :func:`sys.getfilesystemencodeerrors`." +msgstr "" + +msgid "" +"On Windows: use ``\"surrogatepass\"`` by default, or ``\"replace\"`` " +"if :c:member:`~PyPreConfig.legacy_windows_fs_encoding` " +"of :c:type:`PyPreConfig` is non-zero." msgstr "" msgid "On other platforms: use ``\"surrogateescape\"`` by default." @@ -1711,8 +1770,8 @@ msgid "" msgstr "" msgid "" -"Set by the :option:`-X importtime <-X>` option and the :envvar:" -"`PYTHONPROFILEIMPORTTIME` environment variable." +"Set by the :option:`-X importtime <-X>` option and " +"the :envvar:`PYTHONPROFILEIMPORTTIME` environment variable." msgstr "" msgid "Added support for ``import_time = 2``" @@ -1729,8 +1788,8 @@ msgid "" msgstr "" msgid "" -"Incremented by the :option:`-i` command line option. Set to ``1`` if the :" -"envvar:`PYTHONINSPECT` environment variable is non-empty." +"Incremented by the :option:`-i` command line option. Set to ``1`` if " +"the :envvar:`PYTHONINSPECT` environment variable is non-empty." msgstr "" msgid "Install Python signal handlers?" @@ -1748,10 +1807,11 @@ msgstr "" msgid "" "Configures the :ref:`integer string conversion length limitation " "`. An initial value of ``-1`` means the value will be " -"taken from the command line or environment or otherwise default to 4300 (:" -"data:`sys.int_info.default_max_str_digits`). A value of ``0`` disables the " -"limitation. Values greater than zero but less than 640 (:data:`sys.int_info." -"str_digits_check_threshold`) are unsupported and will produce an error." +"taken from the command line or environment or otherwise default to 4300 " +"(:data:`sys.int_info.default_max_str_digits`). A value of ``0`` disables " +"the limitation. Values greater than zero but less than 640 " +"(:data:`sys.int_info.str_digits_check_threshold`) are unsupported and will " +"produce an error." msgstr "" msgid "" @@ -1760,19 +1820,20 @@ msgid "" msgstr "" msgid "" -"Default: ``-1`` in Python mode. 4300 (:data:`sys.int_info." -"default_max_str_digits`) in isolated mode." +"Default: ``-1`` in Python mode. 4300 " +"(:data:`sys.int_info.default_max_str_digits`) in isolated mode." msgstr "" msgid "" "If the value of :c:member:`~PyConfig.cpu_count` is not ``-1`` then it will " -"override the return values of :func:`os.cpu_count`, :func:`os." -"process_cpu_count`, and :func:`multiprocessing.cpu_count`." +"override the return values " +"of :func:`os.cpu_count`, :func:`os.process_cpu_count`, " +"and :func:`multiprocessing.cpu_count`." msgstr "" msgid "" -"Configured by the :samp:`-X cpu_count={n|default}` command line flag or the :" -"envvar:`PYTHON_CPU_COUNT` environment variable." +"Configured by the :samp:`-X cpu_count={n|default}` command line flag or " +"the :envvar:`PYTHON_CPU_COUNT` environment variable." msgstr "" msgid "Default: ``-1``." @@ -1806,14 +1867,14 @@ msgid "Set to ``1`` by the :option:`-I` command line option." msgstr "" msgid "" -"See also the :ref:`Isolated Configuration ` and :c:" -"member:`PyPreConfig.isolated`." +"See also the :ref:`Isolated Configuration ` " +"and :c:member:`PyPreConfig.isolated`." msgstr "" msgid "" -"If non-zero, use :class:`io.FileIO` instead of :class:`!io." -"_WindowsConsoleIO` for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys." -"stderr`." +"If non-zero, use :class:`io.FileIO` instead of :class:`!" +"io._WindowsConsoleIO` for :data:`sys.stdin`, :data:`sys.stdout` " +"and :data:`sys.stderr`." msgstr "" msgid "" @@ -1844,9 +1905,9 @@ msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable." msgstr "" msgid "" -"Default: value of the ``PLATLIBDIR`` macro which is set by the :option:" -"`configure --with-platlibdir option <--with-platlibdir>` (default: " -"``\"lib\"``, or ``\"DLLs\"`` on Windows)." +"Default: value of the ``PLATLIBDIR`` macro which is set by " +"the :option:`configure --with-platlibdir option <--with-platlibdir>` " +"(default: ``\"lib\"``, or ``\"DLLs\"`` on Windows)." msgstr "" msgid "" @@ -1857,8 +1918,8 @@ msgid "" msgstr "" msgid "" -"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:" -"data:`os.pathsep`)." +"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` " +"(:data:`os.pathsep`)." msgstr "" msgid "Set by the :envvar:`PYTHONPATH` environment variable." @@ -1868,10 +1929,10 @@ msgid "Module search paths: :data:`sys.path`." msgstr "" msgid "" -"If :c:member:`~PyConfig.module_search_paths_set` is equal to ``0``, :c:func:" -"`Py_InitializeFromConfig` will replace :c:member:`~PyConfig." -"module_search_paths` and sets :c:member:`~PyConfig.module_search_paths_set` " -"to ``1``." +"If :c:member:`~PyConfig.module_search_paths_set` is equal to " +"``0``, :c:func:`Py_InitializeFromConfig` will " +"replace :c:member:`~PyConfig.module_search_paths` and " +"sets :c:member:`~PyConfig.module_search_paths_set` to ``1``." msgstr "" msgid "" @@ -1892,8 +1953,8 @@ msgid "``2``: Level 1, strip docstrings." msgstr "" msgid "" -"Incremented by the :option:`-O` command line option. Set to the :envvar:" -"`PYTHONOPTIMIZE` environment variable value." +"Incremented by the :option:`-O` command line option. Set to " +"the :envvar:`PYTHONOPTIMIZE` environment variable value." msgstr "" msgid "" @@ -1902,16 +1963,17 @@ msgid "" msgstr "" msgid "" -"If :c:member:`~PyConfig.orig_argv` list is empty and :c:member:`~PyConfig." -"argv` is not a list only containing an empty string, :c:func:`PyConfig_Read` " -"copies :c:member:`~PyConfig.argv` into :c:member:`~PyConfig.orig_argv` " -"before modifying :c:member:`~PyConfig.argv` (if :c:member:`~PyConfig." -"parse_argv` is non-zero)." +"If :c:member:`~PyConfig.orig_argv` list is empty " +"and :c:member:`~PyConfig.argv` is not a list only containing an empty " +"string, :c:func:`PyConfig_Read` copies :c:member:`~PyConfig.argv` " +"into :c:member:`~PyConfig.orig_argv` before " +"modifying :c:member:`~PyConfig.argv` (if :c:member:`~PyConfig.parse_argv` is " +"non-zero)." msgstr "" msgid "" -"See also the :c:member:`~PyConfig.argv` member and the :c:func:" -"`Py_GetArgcArgv` function." +"See also the :c:member:`~PyConfig.argv` member and " +"the :c:func:`Py_GetArgcArgv` function." msgstr "" msgid "Default: empty list." @@ -1927,8 +1989,8 @@ msgid "" msgstr "" msgid "" -"The :c:member:`PyConfig.argv` arguments are now only parsed if :c:member:" -"`PyConfig.parse_argv` equals to ``1``." +"The :c:member:`PyConfig.argv` arguments are now only parsed " +"if :c:member:`PyConfig.parse_argv` equals to ``1``." msgstr "" msgid "" @@ -1937,8 +1999,8 @@ msgid "" msgstr "" msgid "" -"Incremented by the :option:`-d` command line option. Set to the :envvar:" -"`PYTHONDEBUG` environment variable value." +"Incremented by the :option:`-d` command line option. Set to " +"the :envvar:`PYTHONDEBUG` environment variable value." msgstr "" msgid "" @@ -1971,8 +2033,8 @@ msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set." msgstr "" msgid "" -"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:" -"`__PYVENV_LAUNCHER__` environment variable if set." +"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use ``__PYVENV_LAUNCHER__`` " +"environment variable if set." msgstr "" msgid "" @@ -1985,8 +2047,8 @@ msgid "" msgstr "" msgid "" -"Directory where cached ``.pyc`` files are written: :data:`sys." -"pycache_prefix`." +"Directory where cached ``.pyc`` files are " +"written: :data:`sys.pycache_prefix`." msgstr "" msgid "" @@ -2013,8 +2075,9 @@ msgid "Used by :c:func:`Py_RunMain`." msgstr "" msgid "" -"Filename passed on the command line: trailing command line argument without :" -"option:`-c` or :option:`-m`. It is used by the :c:func:`Py_RunMain` function." +"Filename passed on the command line: trailing command line argument " +"without :option:`-c` or :option:`-m`. It is used by the :c:func:`Py_RunMain` " +"function." msgstr "" msgid "" @@ -2068,8 +2131,8 @@ msgid "Set to ``0`` by the :option:`-S` command line option." msgstr "" msgid "" -":data:`sys.flags.no_site ` is set to the inverted value of :c:" -"member:`~PyConfig.site_import`." +":data:`sys.flags.no_site ` is set to the inverted value " +"of :c:member:`~PyConfig.site_import`." msgstr "" msgid "" @@ -2086,8 +2149,8 @@ msgid "Set to ``1`` by the :option:`-x` command line option." msgstr "" msgid "" -"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :" -"data:`sys.stderr` (but :data:`sys.stderr` always uses " +"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` " +"and :data:`sys.stderr` (but :data:`sys.stderr` always uses " "``\"backslashreplace\"`` error handler)." msgstr "" @@ -2128,8 +2191,8 @@ msgid "If non-zero, call :func:`tracemalloc.start` at startup." msgstr "" msgid "" -"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :" -"envvar:`PYTHONTRACEMALLOC` environment variable." +"Set by :option:`-X tracemalloc=N <-X>` command line option and by " +"the :envvar:`PYTHONTRACEMALLOC` environment variable." msgstr "" msgid "Enable the Linux ``perf`` profiler support?" @@ -2144,13 +2207,13 @@ msgid "" msgstr "" msgid "" -"Set to ``1`` by :option:`-X perf <-X>` command-line option and the :envvar:" -"`PYTHONPERFSUPPORT` environment variable." +"Set to ``1`` by :option:`-X perf <-X>` command-line option and " +"the :envvar:`PYTHONPERFSUPPORT` environment variable." msgstr "" msgid "" -"Set to ``2`` by the :option:`-X perf_jit <-X>` command-line option and the :" -"envvar:`PYTHON_PERF_JIT_SUPPORT` environment variable." +"Set to ``2`` by the :option:`-X perf_jit <-X>` command-line option and " +"the :envvar:`PYTHON_PERF_JIT_SUPPORT` environment variable." msgstr "" msgid "See :ref:`perf_profiling` for more information." @@ -2217,18 +2280,18 @@ msgstr "" msgid "" "The :mod:`warnings` module adds :data:`sys.warnoptions` in the reverse " "order: the last :c:member:`PyConfig.warnoptions` item becomes the first item " -"of :data:`warnings.filters` which is checked first (highest priority)." +"of ``warnings.filters`` which is checked first (highest priority)." msgstr "" msgid "" -"The :option:`-W` command line options adds its value to :c:member:`~PyConfig." -"warnoptions`, it can be used multiple times." +"The :option:`-W` command line options adds its value " +"to :c:member:`~PyConfig.warnoptions`, it can be used multiple times." msgstr "" msgid "" "The :envvar:`PYTHONWARNINGS` environment variable can also be used to add " -"warning options. Multiple options can be specified, separated by commas (``," -"``)." +"warning options. Multiple options can be specified, separated by commas " +"(``,``)." msgstr "" msgid "" @@ -2237,13 +2300,13 @@ msgid "" msgstr "" msgid "" -"Set to ``0`` by the :option:`-B` command line option and the :envvar:" -"`PYTHONDONTWRITEBYTECODE` environment variable." +"Set to ``0`` by the :option:`-B` command line option and " +"the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable." msgstr "" msgid "" -":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:" -"member:`~PyConfig.write_bytecode`." +":data:`sys.dont_write_bytecode` is initialized to the inverted value " +"of :c:member:`~PyConfig.write_bytecode`." msgstr "" msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`." @@ -2260,8 +2323,8 @@ msgstr "" msgid "" "If :c:member:`~PyConfig.parse_argv` is non-zero, :c:member:`~PyConfig.argv` " "arguments are parsed the same way the regular Python parses :ref:`command " -"line arguments `, and Python arguments are stripped from :" -"c:member:`~PyConfig.argv`." +"line arguments `, and Python arguments are stripped " +"from :c:member:`~PyConfig.argv`." msgstr "" msgid "" @@ -2281,11 +2344,12 @@ msgid "" msgstr "" msgid "" -"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` or :c:" -"func:`PyImport_ExtendInittab` are used, they must be set or called after " -"Python preinitialization and before the Python initialization. If Python is " -"initialized multiple times, :c:func:`PyImport_AppendInittab` or :c:func:" -"`PyImport_ExtendInittab` must be called before each Python initialization." +"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` " +"or :c:func:`PyImport_ExtendInittab` are used, they must be set or called " +"after Python preinitialization and before the Python initialization. If " +"Python is initialized multiple times, :c:func:`PyImport_AppendInittab` " +"or :c:func:`PyImport_ExtendInittab` must be called before each Python " +"initialization." msgstr "" msgid "" @@ -2390,9 +2454,10 @@ msgid "Isolated Configuration" msgstr "" msgid "" -":c:func:`PyPreConfig_InitIsolatedConfig` and :c:func:" -"`PyConfig_InitIsolatedConfig` functions create a configuration to isolate " -"Python from the system. For example, to embed Python into an application." +":c:func:`PyPreConfig_InitIsolatedConfig` " +"and :c:func:`PyConfig_InitIsolatedConfig` functions create a configuration " +"to isolate Python from the system. For example, to embed Python into an " +"application." msgstr "" msgid "" @@ -2412,9 +2477,9 @@ msgid "Python Configuration" msgstr "" msgid "" -":c:func:`PyPreConfig_InitPythonConfig` and :c:func:" -"`PyConfig_InitPythonConfig` functions create a configuration to build a " -"customized Python which behaves as the regular Python." +":c:func:`PyPreConfig_InitPythonConfig` " +"and :c:func:`PyConfig_InitPythonConfig` functions create a configuration to " +"build a customized Python which behaves as the regular Python." msgstr "" msgid "" @@ -2424,8 +2489,9 @@ msgstr "" msgid "" "This function enables C locale coercion (:pep:`538`) and :ref:`Python UTF-8 " -"Mode ` (:pep:`540`) depending on the LC_CTYPE locale, :envvar:" -"`PYTHONUTF8` and :envvar:`PYTHONCOERCECLOCALE` environment variables." +"Mode ` (:pep:`540`) depending on the LC_CTYPE " +"locale, :envvar:`PYTHONUTF8` and :envvar:`PYTHONCOERCECLOCALE` environment " +"variables." msgstr "" msgid "Python Path Configuration" @@ -2456,8 +2522,8 @@ msgid "current working directory: to get absolute paths" msgstr "" msgid "" -"``PATH`` environment variable to get the program full path (from :c:member:" -"`PyConfig.program_name`)" +"``PATH`` environment variable to get the program full path " +"(from :c:member:`PyConfig.program_name`)" msgstr "" msgid "``__PYVENV_LAUNCHER__`` environment variable" @@ -2487,22 +2553,18 @@ msgstr ":c:member:`PyConfig.exec_prefix`" msgid ":c:member:`PyConfig.executable`" msgstr ":c:member:`PyConfig.executable`" -msgid "" -":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig." -"module_search_paths`" -msgstr "" -":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig." -"module_search_paths`" +msgid ":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig.module_search_paths`" +msgstr ":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig.module_search_paths`" msgid ":c:member:`PyConfig.prefix`" msgstr ":c:member:`PyConfig.prefix`" msgid "" "If at least one \"output field\" is not set, Python calculates the path " -"configuration to fill unset fields. If :c:member:`~PyConfig." -"module_search_paths_set` is equal to ``0``, :c:member:`~PyConfig." -"module_search_paths` is overridden and :c:member:`~PyConfig." -"module_search_paths_set` is set to ``1``." +"configuration to fill unset fields. " +"If :c:member:`~PyConfig.module_search_paths_set` is equal to " +"``0``, :c:member:`~PyConfig.module_search_paths` is overridden " +"and :c:member:`~PyConfig.module_search_paths_set` is set to ``1``." msgstr "" msgid "" @@ -2521,9 +2583,10 @@ msgid "" msgstr "" msgid "" -"If :c:member:`~PyConfig.base_prefix` or :c:member:`~PyConfig." -"base_exec_prefix` fields are not set, they inherit their value from :c:" -"member:`~PyConfig.prefix` and :c:member:`~PyConfig.exec_prefix` respectively." +"If :c:member:`~PyConfig.base_prefix` " +"or :c:member:`~PyConfig.base_exec_prefix` fields are not set, they inherit " +"their value from :c:member:`~PyConfig.prefix` " +"and :c:member:`~PyConfig.exec_prefix` respectively." msgstr "" msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:" @@ -2531,8 +2594,8 @@ msgstr "" msgid "" "If :c:member:`~PyConfig.run_filename` is set and is a directory which " -"contains a ``__main__.py`` script, prepend :c:member:`~PyConfig." -"run_filename` to :data:`sys.path`." +"contains a ``__main__.py`` script, " +"prepend :c:member:`~PyConfig.run_filename` to :data:`sys.path`." msgstr "" msgid "If :c:member:`~PyConfig.isolated` is zero:" @@ -2553,10 +2616,10 @@ msgstr "" msgid "" "If :c:member:`~PyConfig.site_import` is non-zero, :data:`sys.path` can be " -"modified by the :mod:`site` module. If :c:member:`~PyConfig." -"user_site_directory` is non-zero and the user's site-package directory " -"exists, the :mod:`site` module appends the user's site-package directory to :" -"data:`sys.path`." +"modified by the :mod:`site` module. " +"If :c:member:`~PyConfig.user_site_directory` is non-zero and the user's site-" +"package directory exists, the :mod:`site` module appends the user's site-" +"package directory to :data:`sys.path`." msgstr "" msgid "The following configuration files are used by the path configuration:" @@ -2597,14 +2660,14 @@ msgid "" msgstr "" msgid "" -"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:" -"`PyConfig.base_executable`." +"The ``__PYVENV_LAUNCHER__`` environment variable is used to " +"set :c:member:`PyConfig.base_executable`." msgstr "" msgid "" ":c:member:`~PyConfig.prefix`, and :c:member:`~PyConfig.exec_prefix`, are now " -"set to the ``pyvenv.cfg`` directory. This was previously done by :mod:" -"`site`, therefore affected by :option:`-S`." +"set to the ``pyvenv.cfg`` directory. This was previously done " +"by :mod:`site`, therefore affected by :option:`-S`." msgstr "" msgid "Py_GetArgcArgv()" diff --git a/c-api/interp-lifecycle.po b/c-api/interp-lifecycle.po index 3af030bb44..f8a8b8b4de 100644 --- a/c-api/interp-lifecycle.po +++ b/c-api/interp-lifecycle.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2026-02-25 14:46+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -160,8 +160,8 @@ msgstr ":c:func:`PyMutex_Unlock`" msgid "" "Despite their apparent similarity to some of the functions listed above, the " "following functions **should not be called** before the interpreter has been " -"initialized: :c:func:`Py_EncodeLocale`, :c:func:`PyEval_InitThreads`, and :c:" -"func:`Py_RunMain`." +"initialized: :c:func:`Py_EncodeLocale`, :c:func:`PyEval_InitThreads`, " +"and :c:func:`Py_RunMain`." msgstr "" msgid "Global configuration variables" @@ -169,36 +169,36 @@ msgstr "" msgid "" "Python has variables for the global configuration to control different " -"features and options. By default, these flags are controlled by :ref:" -"`command line options `." +"features and options. By default, these flags are controlled " +"by :ref:`command line options `." msgstr "" msgid "" "When a flag is set by an option, the value of the flag is the number of " -"times that the option was set. For example, ``-b`` sets :c:data:" -"`Py_BytesWarningFlag` to 1 and ``-bb`` sets :c:data:`Py_BytesWarningFlag` to " -"2." +"times that the option was set. For example, ``-b`` " +"sets :c:data:`Py_BytesWarningFlag` to 1 and ``-bb`` " +"sets :c:data:`Py_BytesWarningFlag` to 2." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"bytes_warning` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.bytes_warning` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :" -"class:`str` or :class:`bytes` with :class:`int`. Issue an error if greater " -"or equal to ``2``." +"Issue a warning when comparing :class:`bytes` or :class:`bytearray` " +"with :class:`str` or :class:`bytes` with :class:`int`. Issue an error if " +"greater or equal to ``2``." msgstr "" msgid "Set by the :option:`-b` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"parser_debug` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.parser_debug` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -212,9 +212,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"write_bytecode` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.write_bytecode` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -228,17 +228,18 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"pathconfig_warnings` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.pathconfig_warnings` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Private flag used by ``_freeze_module`` and ``frozenmain`` programs." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"hash_seed` and :c:member:`PyConfig.use_hash_seed` should be used instead, " +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.hash_seed` " +"and :c:member:`PyConfig.use_hash_seed` should be used instead, " "see :ref:`Python Initialization Configuration `." msgstr "" @@ -253,23 +254,23 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"use_environment` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.use_environment` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:" -"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." +"Ignore all :envvar:`!PYTHON*` environment variables, " +"e.g. :envvar:`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." msgstr "" msgid "Set by the :option:`-E` and :option:`-I` options." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"inspect` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.inspect` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -284,18 +285,18 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"interactive` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.interactive` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Set by the :option:`-i` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"isolated` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.isolated` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -307,9 +308,9 @@ msgid "Set by the :option:`-I` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyPreConfig." -"legacy_windows_fs_encoding` should be used instead, see :ref:`Python " -"Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyPreConfig.legacy_windows_fs_encoding` should be used " +"instead, see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -330,14 +331,14 @@ msgid "Availability" msgstr "Dostępność" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"legacy_windows_stdio` should be used instead, see :ref:`Python " -"Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.legacy_windows_stdio` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!io." -"_WindowsConsoleIO` for :mod:`sys` standard streams." +"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!" +"io._WindowsConsoleIO` for :mod:`sys` standard streams." msgstr "" msgid "" @@ -349,41 +350,41 @@ msgid "See :pep:`528` for more details." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"site_import` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.site_import` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails. Also disable these " -"manipulations if :mod:`site` is explicitly imported later (call :func:`site." -"main` if you want them to be triggered)." +"manipulations if :mod:`site` is explicitly imported later " +"(call :func:`site.main` if you want them to be triggered)." msgstr "" msgid "Set by the :option:`-S` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"user_site_directory` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.user_site_directory` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Don't add the :data:`user site-packages directory ` to :data:" -"`sys.path`." +"Don't add the :data:`user site-packages directory ` " +"to :data:`sys.path`." msgstr "" msgid "" -"Set by the :option:`-s` and :option:`-I` options, and the :envvar:" -"`PYTHONNOUSERSITE` environment variable." +"Set by the :option:`-s` and :option:`-I` options, and " +"the :envvar:`PYTHONNOUSERSITE` environment variable." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"optimization_level` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.optimization_level` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -392,9 +393,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"quiet` should be used instead, see :ref:`Python Initialization Configuration " -"`." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.quiet` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -405,9 +406,9 @@ msgid "Set by the :option:`-q` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"buffered_stdio` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.buffered_stdio` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Force the stdout and stderr streams to be unbuffered." @@ -419,9 +420,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"verbose` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.verbose` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -441,8 +442,9 @@ msgstr "" msgid "" "Initialize the Python interpreter. In an application embedding Python, this " -"should be called before using any other Python/C API functions; see :ref:" -"`Before Python Initialization ` for the few exceptions." +"should be called before using any other Python/C API functions; " +"see :ref:`Before Python Initialization ` for the few " +"exceptions." msgstr "" msgid "" @@ -496,17 +498,18 @@ msgstr "" msgid "" "Undo all initializations made by :c:func:`Py_Initialize` and subsequent use " -"of Python/C API functions, and destroy all sub-interpreters (see :c:func:" -"`Py_NewInterpreter` below) that were created and not yet destroyed since the " -"last call to :c:func:`Py_Initialize`. This is a no-op when called for a " -"second time (without calling :c:func:`Py_Initialize` again first)." +"of Python/C API functions, and destroy all sub-interpreters " +"(see :c:func:`Py_NewInterpreter` below) that were created and not yet " +"destroyed since the last call to :c:func:`Py_Initialize`. This is a no-op " +"when called for a second time (without calling :c:func:`Py_Initialize` again " +"first)." msgstr "" msgid "" "Since this is the reverse of :c:func:`Py_Initialize`, it should be called in " "the same thread with the same interpreter active. That means the main " -"thread and the main interpreter. This should never be called while :c:func:" -"`Py_RunMain` is running." +"thread and the main interpreter. This should never be called " +"while :c:func:`Py_RunMain` is running." msgstr "" msgid "" @@ -552,8 +555,8 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"_PySys_ClearAuditHooks`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython._PySys_ClearAuditHooks`` with no arguments." msgstr "" msgid "" @@ -596,9 +599,9 @@ msgid "" msgstr "" msgid "" -"In terms of the CPython runtime configuration APIs documented in the :ref:" -"`runtime configuration ` section (and without accounting for " -"error handling), ``Py_Main`` is approximately equivalent to::" +"In terms of the CPython runtime configuration APIs documented in " +"the :ref:`runtime configuration ` section (and without " +"accounting for error handling), ``Py_Main`` is approximately equivalent to::" msgstr "" msgid "" @@ -613,25 +616,68 @@ msgstr "" msgid "" "In normal usage, an embedding application will call this function *instead* " -"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` or :c:func:" -"`Py_InitializeFromConfig` directly, and all settings will be applied as " -"described elsewhere in this documentation. If this function is instead " -"called *after* a preceding runtime initialization API call, then exactly " -"which environmental and command line configuration settings will be updated " -"is version dependent (as it depends on which settings correctly support " -"being modified after they have already been set once when the runtime was " -"first initialized)." +"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` " +"or :c:func:`Py_InitializeFromConfig` directly, and all settings will be " +"applied as described elsewhere in this documentation. If this function is " +"instead called *after* a preceding runtime initialization API call, then " +"exactly which environmental and command line configuration settings will be " +"updated is version dependent (as it depends on which settings correctly " +"support being modified after they have already been set once when the " +"runtime was first initialized)." +msgstr "" + +msgid "" +"The main program for a \"frozen\" Python program (an executable that embeds " +"the interpreter together with the bytecode of the program's modules, as " +"produced by the :program:`freeze` utility; see :source:`Tools/freeze`)." +msgstr "" + +msgid "" +"This function initializes the interpreter, imports the frozen module named " +"``__main__``, and finalizes the interpreter. The frozen modules must have " +"been registered in :c:var:`PyImport_FrozenModules` before calling this " +"function; it is a fatal error if ``__main__`` is not among them." +msgstr "" + +msgid "" +"*argc* and *argv* are byte strings like the arguments of a C program's " +"``main`` function, and are passed to the interpreter " +"with :c:func:`PyConfig_SetBytesArgv`. Unlike :c:func:`Py_Main`, the " +"arguments are not parsed as Python command line options " +"(:c:member:`PyConfig.parse_argv` is ``0``), so all of them are made " +"available to the program in :data:`sys.argv`. Apart from that, the " +"interpreter uses the :ref:`Python Configuration `, so " +"environment variables such as :envvar:`PYTHONPATH` are honored. Warnings " +"about the path configuration (:c:member:`PyConfig.pathconfig_warnings`) are " +"suppressed. If :envvar:`PYTHONINSPECT` is set and standard input is a " +"terminal, an interactive prompt is run after ``__main__`` has finished, as " +"with the :option:`-i` option." +msgstr "" + +msgid "" +"Return ``0`` if ``__main__`` ran without an unhandled exception, ``1`` " +"otherwise, and ``120`` if finalizing the interpreter failed " +"(see :c:func:`Py_FinalizeEx`). An unhandled :exc:`SystemExit` terminates the " +"process. If the interpreter cannot be initialized, the process exits " +"via :c:func:`Py_ExitStatusException`." +msgstr "" + +msgid "" +"On Windows, this function is not exported by the Python DLL. " +"The :program:`freeze` utility compiles :file:`Python/frozenmain.c` into the " +"frozen program instead, together with the Windows-specific hooks that the " +"function requires." msgstr "" msgid "Executes the main module in a fully configured CPython runtime." msgstr "" msgid "" -"Executes the command (:c:member:`PyConfig.run_command`), the script (:c:" -"member:`PyConfig.run_filename`) or the module (:c:member:`PyConfig." -"run_module`) specified on the command line or in the configuration. If none " -"of these values are set, runs the interactive Python prompt (REPL) using the " -"``__main__`` module's global namespace." +"Executes the command (:c:member:`PyConfig.run_command`), the script " +"(:c:member:`PyConfig.run_filename`) or the module " +"(:c:member:`PyConfig.run_module`) specified on the command line or in the " +"configuration. If none of these values are set, runs the interactive Python " +"prompt (REPL) using the ``__main__`` module's global namespace." msgstr "" msgid "" @@ -657,8 +703,8 @@ msgstr "" msgid "" "See :ref:`Python Configuration ` for an example of a " -"customized Python that always runs in isolated mode using :c:func:" -"`Py_RunMain`." +"customized Python that always runs in isolated mode " +"using :c:func:`Py_RunMain`." msgstr "" msgid "" @@ -675,17 +721,17 @@ msgstr "" msgid "" "In the late stage of :term:`interpreter shutdown`, after attempting to wait " -"for non-daemon threads to exit (though this can be interrupted by :class:" -"`KeyboardInterrupt`) and running the :mod:`atexit` functions, the runtime is " -"marked as *finalizing*: :c:func:`Py_IsFinalizing` and :func:`sys." -"is_finalizing` return true. At this point, only the *finalization thread* " -"that initiated finalization (typically the main thread) is allowed to " -"acquire the :term:`GIL`." +"for non-daemon threads to exit (though this can be interrupted " +"by :class:`KeyboardInterrupt`) and running the :mod:`atexit` functions, the " +"runtime is marked as *finalizing*: :c:func:`Py_IsFinalizing` " +"and :func:`sys.is_finalizing` return true. At this point, only the " +"*finalization thread* that initiated finalization (typically the main " +"thread) is allowed to acquire the :term:`GIL`." msgstr "" msgid "" -"If any thread, other than the finalization thread, attempts to attach a :" -"term:`thread state` during finalization, either explicitly or implicitly, " +"If any thread, other than the finalization thread, attempts to attach " +"a :term:`thread state` during finalization, either explicitly or implicitly, " "the thread enters **a permanently blocked state** where it remains until the " "program exits. In most cases this is harmless, but this can result in " "deadlock if a later stage of finalization attempts to acquire a lock owned " @@ -707,9 +753,9 @@ msgid "Process-wide parameters" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"program_name` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.program_name` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -726,8 +772,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:" -"`wchar_t*` string." +"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get " +"a :c:expr:`wchar_t*` string." msgstr "" msgid "" @@ -745,8 +791,8 @@ msgid "It now returns ``NULL`` if called before :c:func:`Py_Initialize`." msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"executable\") ` (:data:`sys." -"executable`) instead." +"Use :c:func:`PyConfig_Get(\"executable\") ` " +"(:data:`sys.executable`) instead." msgstr "" msgid "" @@ -763,10 +809,10 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"base_prefix\") ` (:data:`sys." -"base_prefix`) instead. Use :c:func:`PyConfig_Get(\"prefix\") ` " -"(:data:`sys.prefix`) if :ref:`virtual environments ` need to be " -"handled." +"Use :c:func:`PyConfig_Get(\"base_prefix\") ` " +"(:data:`sys.base_prefix`) instead. Use :c:func:`PyConfig_Get(\"prefix\") " +"` (:data:`sys.prefix`) if :ref:`virtual environments ` need to be handled." msgstr "" msgid "" @@ -775,11 +821,11 @@ msgid "" "with :c:member:`PyConfig.program_name` and some environment variables; for " "example, if the program name is ``'/usr/local/bin/python'``, the exec-prefix " "is ``'/usr/local'``. The returned string points into static storage; the " -"caller should not modify its value. This corresponds to the :makevar:" -"`exec_prefix` variable in the top-level :file:`Makefile` and the ``--exec-" -"prefix`` argument to the :program:`configure` script at build time. The " -"value is available to Python code as ``sys.base_exec_prefix``. It is only " -"useful on Unix." +"caller should not modify its value. This corresponds to " +"the :makevar:`exec_prefix` variable in the top-level :file:`Makefile` and " +"the ``--exec-prefix`` argument to the :program:`configure` script at build " +"time. The value is available to Python code as ``sys.base_exec_prefix``. " +"It is only useful on Unix." msgstr "" msgid "" @@ -804,17 +850,18 @@ msgid "" msgstr "" msgid "" -"System administrators will know how to configure the :program:`mount` or :" -"program:`automount` programs to share :file:`/usr/local` between platforms " -"while having :file:`/usr/local/plat` be a different filesystem for each " -"platform." +"System administrators will know how to configure the :program:`mount` " +"or :program:`automount` programs to share :file:`/usr/local` between " +"platforms while having :file:`/usr/local/plat` be a different filesystem for " +"each platform." msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"base_exec_prefix\") ` (:data:`sys." -"base_exec_prefix`) instead. Use :c:func:`PyConfig_Get(\"exec_prefix\") " -"` (:data:`sys.exec_prefix`) if :ref:`virtual environments " -"` need to be handled." +"Use :c:func:`PyConfig_Get(\"base_exec_prefix\") ` " +"(:data:`sys.base_exec_prefix`) instead. " +"Use :c:func:`PyConfig_Get(\"exec_prefix\") ` " +"(:data:`sys.exec_prefix`) if :ref:`virtual environments ` need to " +"be handled." msgstr "" msgid "" @@ -838,8 +885,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"module_search_paths\") ` (:data:" -"`sys.path`) instead." +"Use :c:func:`PyConfig_Get(\"module_search_paths\") ` " +"(:data:`sys.path`) instead." msgstr "" msgid "" @@ -854,8 +901,8 @@ msgid "" "The first word (up to the first space character) is the current Python " "version; the first characters are the major and minor version separated by a " "period. The returned string points into static storage; the caller should " -"not modify its value. The value is available to Python code as :data:`sys." -"version`." +"not modify its value. The value is available to Python code " +"as :data:`sys.version`." msgstr "" msgid "See also the :c:var:`Py_Version` constant." @@ -907,10 +954,10 @@ msgid "\"#67, Aug 1 1997, 22:34:28\"" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"argv`, :c:member:`PyConfig.parse_argv` and :c:member:`PyConfig.safe_path` " -"should be used instead, see :ref:`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.argv`, :c:member:`PyConfig.parse_argv` " +"and :c:member:`PyConfig.safe_path` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -931,8 +978,8 @@ msgstr "" msgid "" "If the name of an existing script is passed in ``argv[0]``, the absolute " -"path of the directory where the script is located is prepended to :data:`sys." -"path`." +"path of the directory where the script is located is prepended " +"to :data:`sys.path`." msgstr "" msgid "" @@ -954,32 +1001,33 @@ msgstr "" msgid "" "On versions before 3.1.3, you can achieve the same effect by manually " -"popping the first :data:`sys.path` element after having called :c:func:" -"`PySys_SetArgv`, for example using::" +"popping the first :data:`sys.path` element after having " +"called :c:func:`PySys_SetArgv`, for example using::" msgstr "" msgid "PyRun_SimpleString(\"import sys; sys.path.pop(0)\\n\");" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"argv` and :c:member:`PyConfig.parse_argv` should be used instead, see :ref:" -"`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.argv` and :c:member:`PyConfig.parse_argv` should " +"be used instead, see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to " -"``1`` unless the :program:`python` interpreter was started with the :option:" -"`-I`." +"``1`` unless the :program:`python` interpreter was started with " +"the :option:`-I`." msgstr "" msgid "The *updatepath* value depends on :option:`-I`." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"home` should be used instead, see :ref:`Python Initialization Configuration " -"`." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.home` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -996,14 +1044,14 @@ msgid "" msgstr "" msgid "" -"Return the default \"home\", that is, the value set by :c:member:`PyConfig." -"home`, or the value of the :envvar:`PYTHONHOME` environment variable if it " -"is set." +"Return the default \"home\", that is, the value set " +"by :c:member:`PyConfig.home`, or the value of the :envvar:`PYTHONHOME` " +"environment variable if it is set." msgstr "" msgid "" -"Use :c:func:`PyConfig_Get(\"home\") ` or the :envvar:" -"`PYTHONHOME` environment variable instead." +"Use :c:func:`PyConfig_Get(\"home\") ` or " +"the :envvar:`PYTHONHOME` environment variable instead." msgstr "" msgid "PyEval_InitThreads()" @@ -1036,6 +1084,9 @@ msgstr "ścieżka" msgid "Py_FinalizeEx (C function)" msgstr "" +msgid "freeze utility" +msgstr "" + msgid "Py_Initialize()" msgstr "" diff --git a/c-api/intro.po b/c-api/intro.po index 7ab94da277..ac436bfd21 100644 --- a/c-api/intro.po +++ b/c-api/intro.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -34,8 +34,8 @@ msgid "" "API. The first reason is to write *extension modules* for specific purposes; " "these are C modules that extend the Python interpreter. This is probably " "the most common use. The second reason is to use Python as a component in a " -"larger application; this technique is generally referred to as :dfn:" -"`embedding` Python in an application." +"larger application; this technique is generally referred to " +"as :dfn:`embedding` Python in an application." msgstr "" "Interfejs programowania aplikacji w Pythonie daje programistom języków C i C+" "+ dostęp do programu interpretującego polecenia języka pytonowskiego na " @@ -46,8 +46,8 @@ msgstr "" "pisanie *modułów rozszerzających* dla szczególnych powodów; są to moduły " "języka C, które rozszerzają interpreter Pythona. To jest zwykle najczęstsze " "użycie. Drugą przyczyną jest użycie Pythona jako komponentu większego " -"programu; ta technika jest zwykle określana mianem załączania - z ang. - :" -"dfn:`embedding` w aplikacji." +"programu; ta technika jest zwykle określana mianem załączania - z ang. " +"- :dfn:`embedding` w aplikacji." msgid "" "Writing an extension module is a relatively well-understood process, where a " @@ -124,12 +124,12 @@ msgstr "" msgid "" "This implies inclusion of the following standard headers: ````, " -"````, ````, ````, ```` and ```` (if available)." +"````, ````, ````, ```` and " +"```` (if available)." msgstr "" "Oznacza to włączenie następujących standardowych nagłówek: ````, " -"````, ````, ````, ```` i ```` (jeśli są dostępne)." +"````, ````, ````, ```` i " +"```` (jeśli są dostępne)." msgid "" "Since Python may define some pre-processor definitions which affect the " @@ -137,8 +137,8 @@ msgid "" "any standard headers are included." msgstr "" "Jako że Python może definiować pewne definicje preprocesora, które wpływają " -"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć plik :file:" -"`Python.h` przed jakimikolwiek standardowymi nagłówkami." +"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć " +"plik :file:`Python.h` przed jakimikolwiek standardowymi nagłówkami." msgid "" "It is recommended to always define ``PY_SSIZE_T_CLEAN`` before including " @@ -170,22 +170,22 @@ msgstr "" msgid "" "The header files are typically installed with Python. On Unix, these are " -"located in the directories :file:`{prefix}/include/pythonversion/` and :file:" -"`{exec_prefix}/include/pythonversion/`, where :option:`prefix <--prefix>` " -"and :option:`exec_prefix <--exec-prefix>` are defined by the corresponding " -"parameters to Python's :program:`configure` script and *version* is ``'%d." -"%d' % sys.version_info[:2]``. On Windows, the headers are installed in :" -"file:`{prefix}/include`, where ``prefix`` is the installation directory " -"specified to the installer." +"located in the directories :file:`{prefix}/include/pythonversion/` " +"and :file:`{exec_prefix}/include/pythonversion/`, where :option:`prefix <--" +"prefix>` and :option:`exec_prefix <--exec-prefix>` are defined by the " +"corresponding parameters to Python's :program:`configure` script and " +"*version* is ``'%d.%d' % sys.version_info[:2]``. On Windows, the headers " +"are installed in :file:`{prefix}/include`, where ``prefix`` is the " +"installation directory specified to the installer." msgstr "" msgid "" "To include the headers, place both directories (if different) on your " "compiler's search path for includes. Do *not* place the parent directories " "on the search path and then use ``#include ``; this will " -"break on multi-platform builds since the platform independent headers under :" -"option:`prefix <--prefix>` include the platform specific headers from :" -"option:`exec_prefix <--exec-prefix>`." +"break on multi-platform builds since the platform independent headers " +"under :option:`prefix <--prefix>` include the platform specific headers " +"from :option:`exec_prefix <--exec-prefix>`." msgstr "" msgid "" @@ -199,9 +199,10 @@ msgstr "" msgid "" "Several useful macros are defined in the Python header files. Many are " -"defined closer to where they are useful (for example, :c:macro:" -"`Py_RETURN_NONE`, :c:macro:`PyMODINIT_FUNC`). Others of a more general " -"utility are defined here. This is not necessarily a complete listing." +"defined closer to where they are useful (for " +"example, :c:macro:`Py_RETURN_NONE`, :c:macro:`PyMODINIT_FUNC`). Others of a " +"more general utility are defined here. This is not necessarily a complete " +"listing." msgstr "" msgid "" @@ -356,6 +357,11 @@ msgid "" "255]. This macro returns ``c`` cast to an ``unsigned char``." msgstr "" +msgid "" +"Constants describing the byte order of the platform that Python was built " +"for. Exactly one of them is ``1`` and the other is ``0``." +msgstr "" + msgid "Assertion utilities" msgstr "" @@ -373,8 +379,8 @@ msgid "" msgstr "" msgid "" -"In debug mode, and on unsupported compilers, the macro expands to a call to :" -"c:func:`Py_FatalError`." +"In debug mode, and on unsupported compilers, the macro expands to a call " +"to :c:func:`Py_FatalError`." msgstr "" msgid "" @@ -396,9 +402,9 @@ msgid "" msgstr "" msgid "" -"On release builds of Python, this is roughly equivalent to :samp:" -"`(({smaller}) {value})` (in C++, :samp:`static_cast<{smaller}>({value})` " -"will be used instead)." +"On release builds of Python, this is roughly equivalent " +"to :samp:`(({smaller}) {value})` (in C++, :samp:`static_cast<{smaller}" +">({value})` will be used instead)." msgstr "" msgid "" @@ -506,9 +512,9 @@ msgid "" msgstr "" msgid "" -"If Python is :ref:`built in debug mode ` (if the :c:macro:" -"`Py_DEBUG` macro is defined), the :c:macro:`Py_ALWAYS_INLINE` macro does " -"nothing." +"If Python is :ref:`built in debug mode ` (if " +"the :c:macro:`Py_DEBUG` macro is defined), the :c:macro:`Py_ALWAYS_INLINE` " +"macro does nothing." msgstr "" msgid "It must be specified before the function return type. Usage::" @@ -519,8 +525,8 @@ msgstr "" msgid "" "Disable inlining on a function. For example, it reduces the C stack " -"consumption: useful on LTO+PGO builds which heavily inline code (see :issue:" -"`33720`)." +"consumption: useful on LTO+PGO builds which heavily inline code " +"(see :issue:`33720`)." msgstr "" msgid "" @@ -619,17 +625,13 @@ msgstr "" msgid "Consider using the C99 standard suffixes ``LL`` and ``LLU`` directly." msgstr "" -msgid "" -"This is a :term:`soft deprecated` alias to :c:func:`!memcpy`. Use :c:func:`!" -"memcpy` directly instead." +msgid "This is an alias to :c:func:`!memcpy`." msgstr "" -msgid "The macro is :term:`soft deprecated`." +msgid "Use :c:func:`!memcpy` directly instead." msgstr "" -msgid "" -"This is a :term:`soft deprecated` alias to the C99-standard ``va_copy`` " -"function." +msgid "This is an alias to the C99-standard ``va_copy`` function." msgstr "" msgid "" @@ -650,28 +652,28 @@ msgid "" "are treated the same way by the Python language in most situations (e.g., " "assignments, scope rules, and argument passing), it is only fitting that " "they should be represented by a single C type. Almost all Python objects " -"live on the heap: you never declare an automatic or static variable of type :" -"c:type:`PyObject`, only pointer variables of type :c:expr:`PyObject*` can " -"be declared. The sole exception are the type objects; since these must " +"live on the heap: you never declare an automatic or static variable of " +"type :c:type:`PyObject`, only pointer variables of type :c:expr:`PyObject*` " +"can be declared. The sole exception are the type objects; since these must " "never be deallocated, they are typically static :c:type:`PyTypeObject` " "objects." msgstr "" msgid "" -"All Python objects (even Python integers) have a :dfn:`type` and a :dfn:" -"`reference count`. An object's type determines what kind of object it is (e." -"g., an integer, a list, or a user-defined function; there are many more as " -"explained in :ref:`types`). For each of the well-known types there is a " -"macro to check whether an object is of that type; for instance, " +"All Python objects (even Python integers) have a :dfn:`type` and " +"a :dfn:`reference count`. An object's type determines what kind of object " +"it is (e.g., an integer, a list, or a user-defined function; there are many " +"more as explained in :ref:`types`). For each of the well-known types there " +"is a macro to check whether an object is of that type; for instance, " "``PyList_Check(a)`` is true if (and only if) the object pointed to by *a* is " "a Python list." msgstr "" "Wszystkie przedmioty języka pytonowskiego (nawet liczby całkowite języka " "pytonowskiego) mają :dfn:`rodzaj` i :dfn:`liczbę odniesień`. Typ przedmiotu " "określa jakiego rodzaju przedmiot to jest (np. liczba całkowita, lista, lub " -"zadanie zdefiniowane przez użytkownika; jest wiele więcej jak wyjaśniono w :" -"ref:`types`). Dla każdego z dobrze-znanych rodzajów istnieje makropolecenie " -"sprawdzające czy przedmiot jest tego rodzaju; na przykład, " +"zadanie zdefiniowane przez użytkownika; jest wiele więcej jak wyjaśniono " +"w :ref:`types`). Dla każdego z dobrze-znanych rodzajów istnieje " +"makropolecenie sprawdzające czy przedmiot jest tego rodzaju; na przykład, " "``PyList_Check(a)`` jest prawdziwe wtedy (i tylko wtedy) gdy przedmiot na " "który wskazuje *a* jest lista z języka pytonowskiego." @@ -696,18 +698,18 @@ msgid "" "Reference counts are always manipulated explicitly. The normal way is to " "use the macro :c:func:`Py_INCREF` to take a new reference to an object (i.e. " "increment its reference count by one), and :c:func:`Py_DECREF` to release " -"that reference (i.e. decrement the reference count by one). The :c:func:" -"`Py_DECREF` macro is considerably more complex than the incref one, since it " -"must check whether the reference count becomes zero and then cause the " -"object's deallocator to be called. The deallocator is a function pointer " -"contained in the object's type structure. The type-specific deallocator " -"takes care of releasing references for other objects contained in the object " -"if this is a compound object type, such as a list, as well as performing any " -"additional finalization that's needed. There's no chance that the reference " -"count can overflow; at least as many bits are used to hold the reference " -"count as there are distinct memory locations in virtual memory (assuming " -"``sizeof(Py_ssize_t) >= sizeof(void*)``). Thus, the reference count " -"increment is a simple operation." +"that reference (i.e. decrement the reference count by one). " +"The :c:func:`Py_DECREF` macro is considerably more complex than the incref " +"one, since it must check whether the reference count becomes zero and then " +"cause the object's deallocator to be called. The deallocator is a function " +"pointer contained in the object's type structure. The type-specific " +"deallocator takes care of releasing references for other objects contained " +"in the object if this is a compound object type, such as a list, as well as " +"performing any additional finalization that's needed. There's no chance " +"that the reference count can overflow; at least as many bits are used to " +"hold the reference count as there are distinct memory locations in virtual " +"memory (assuming ``sizeof(Py_ssize_t) >= sizeof(void*)``). Thus, the " +"reference count increment is a simple operation." msgstr "" msgid "" @@ -733,8 +735,8 @@ msgid "" "conceivably remove the object from the list, releasing that reference, and " "possibly deallocating it. The real danger is that innocent-looking " "operations may invoke arbitrary Python code which could do this; there is a " -"code path which allows control to flow back to the user from a :c:func:" -"`Py_DECREF`, so almost any operation is potentially dangerous." +"code path which allows control to flow back to the user from " +"a :c:func:`Py_DECREF`, so almost any operation is potentially dangerous." msgstr "" msgid "" @@ -756,37 +758,37 @@ msgid "" "shared). \"Owning a reference\" means being responsible for calling " "Py_DECREF on it when the reference is no longer needed. Ownership can also " "be transferred, meaning that the code that receives ownership of the " -"reference then becomes responsible for eventually releasing it by calling :c:" -"func:`Py_DECREF` or :c:func:`Py_XDECREF` when it's no longer needed---or " -"passing on this responsibility (usually to its caller). When a function " -"passes ownership of a reference on to its caller, the caller is said to " -"receive a *new* reference. When no ownership is transferred, the caller is " -"said to *borrow* the reference. Nothing needs to be done for a :term:" -"`borrowed reference`." +"reference then becomes responsible for eventually releasing it by " +"calling :c:func:`Py_DECREF` or :c:func:`Py_XDECREF` when it's no longer " +"needed---or passing on this responsibility (usually to its caller). When a " +"function passes ownership of a reference on to its caller, the caller is " +"said to receive a *new* reference. When no ownership is transferred, the " +"caller is said to *borrow* the reference. Nothing needs to be done for " +"a :term:`borrowed reference`." msgstr "" msgid "" "Conversely, when a calling function passes in a reference to an object, " "there are two possibilities: the function *steals* a reference to the " -"object, or it does not. *Stealing a reference* means that when you pass a " -"reference to a function, that function assumes that it now owns that " -"reference, and you are not responsible for it any longer." +"object, or it does not." msgstr "" -"Idąc dalej, gdy wywołujące zadanie przekazuje odniesienie do przedmiotu, " -"istnieją dwie możliwości: zadanie *kradnie* odniesienie do przedmiotu, lub " -"nie kradnie go. *Kradnięcie odniesienia* oznacza, że gdy przekazujesz " -"odniesienie do zadania, to zadanie przyjmuje, że teraz ono posiada " -"odniesienie i nie jesteś za nie odpowiedzialny ani chwili dłużej." msgid "" -"Few functions steal references; the two notable exceptions are :c:func:" -"`PyList_SetItem` and :c:func:`PyTuple_SetItem`, which steal a reference to " -"the item (but not to the tuple or list into which the item is put!). These " -"functions were designed to steal a reference because of a common idiom for " -"populating a tuple or list with newly created objects; for example, the code " -"to create the tuple ``(1, 2, \"three\")`` could look like this (forgetting " -"about error handling for the moment; a better way to code this is shown " -"below)::" +"*Stealing a reference* means that when you pass a reference to a function, " +"that function assumes that it now owns that reference. Since the new owner " +"can use :c:func:`!Py_DECREF` at its discretion, you (the caller) must not " +"use that reference after the call." +msgstr "" + +msgid "" +"Few functions steal references; the two notable exceptions " +"are :c:func:`PyList_SetItem` and :c:func:`PyTuple_SetItem`, which steal a " +"reference to the item (but not to the tuple or list into which the item is " +"put!). These functions were designed to steal a reference because of a " +"common idiom for populating a tuple or list with newly created objects; for " +"example, the code to create the tuple ``(1, 2, \"three\")`` could look like " +"this (forgetting about error handling for the moment; a better way to code " +"this is shown below)::" msgstr "" msgid "" @@ -808,21 +810,22 @@ msgstr "" msgid "" "Incidentally, :c:func:`PyTuple_SetItem` is the *only* way to set tuple " "items; :c:func:`PySequence_SetItem` and :c:func:`PyObject_SetItem` refuse to " -"do this since tuples are an immutable data type. You should only use :c:" -"func:`PyTuple_SetItem` for tuples that you are creating yourself." +"do this since tuples are an immutable data type. You should only " +"use :c:func:`PyTuple_SetItem` for tuples that you are creating yourself." msgstr "" msgid "" -"Equivalent code for populating a list can be written using :c:func:" -"`PyList_New` and :c:func:`PyList_SetItem`." +"Equivalent code for populating a list can be written " +"using :c:func:`PyList_New` and :c:func:`PyList_SetItem`." msgstr "" msgid "" "However, in practice, you will rarely use these ways of creating and " -"populating a tuple or list. There's a generic function, :c:func:" -"`Py_BuildValue`, that can create most common objects from C values, directed " -"by a :dfn:`format string`. For example, the above two blocks of code could " -"be replaced by the following (which also takes care of the error checking)::" +"populating a tuple or list. There's a generic " +"function, :c:func:`Py_BuildValue`, that can create most common objects from " +"C values, directed by a :dfn:`format string`. For example, the above two " +"blocks of code could be replaced by the following (which also takes care of " +"the error checking)::" msgstr "" msgid "" @@ -952,19 +955,33 @@ msgstr "Typy" msgid "" "There are few other data types that play a significant role in the Python/C " -"API; most are simple C types such as :c:expr:`int`, :c:expr:`long`, :c:expr:" -"`double` and :c:expr:`char*`. A few structure types are used to describe " -"static tables used to list the functions exported by a module or the data " -"attributes of a new object type, and another is used to describe the value " -"of a complex number. These will be discussed together with the functions " -"that use them." +"API; most are simple C types such " +"as :c:expr:`int`, :c:expr:`long`, :c:expr:`double` and :c:expr:`char*`. A " +"few structure types are used to describe static tables used to list the " +"functions exported by a module or the data attributes of a new object type, " +"and another is used to describe the value of a complex number. These will " +"be discussed together with the functions that use them." msgstr "" msgid "" "A signed integral type such that ``sizeof(Py_ssize_t) == sizeof(size_t)``. " "C99 doesn't define such a thing directly (size_t is an unsigned integral " -"type). See :pep:`353` for details. ``PY_SSIZE_T_MAX`` is the largest " -"positive value of type :c:type:`Py_ssize_t`." +"type). See :pep:`353` for details." +msgstr "" + +msgid "" +"A constant of type :c:type:`Py_ssize_t` with value ``-1``, representing an " +"invalid size." +msgstr "" + +msgid "" +"The limit values (largest positive one and smallest negative one, " +"respectively) of type :c:type:`Py_ssize_t`." +msgstr "" + +msgid "" +"The maximum value of the Windows ``DWORD`` type. Expands to ``0xffffffff`` " +"on all platforms." msgstr "" msgid "Exceptions" @@ -1001,38 +1018,38 @@ msgstr "" msgid "" "Exception state is maintained in per-thread storage (this is equivalent to " "using global storage in an unthreaded application). A thread can be in one " -"of two states: an exception has occurred, or not. The function :c:func:" -"`PyErr_Occurred` can be used to check for this: it returns a borrowed " -"reference to the exception type object when an exception has occurred, and " -"``NULL`` otherwise. There are a number of functions to set the exception " -"state: :c:func:`PyErr_SetString` is the most common (though not the most " -"general) function to set the exception state, and :c:func:`PyErr_Clear` " -"clears the exception state." +"of two states: an exception has occurred, or not. The " +"function :c:func:`PyErr_Occurred` can be used to check for this: it returns " +"a borrowed reference to the exception type object when an exception has " +"occurred, and ``NULL`` otherwise. There are a number of functions to set " +"the exception state: :c:func:`PyErr_SetString` is the most common (though " +"not the most general) function to set the exception state, " +"and :c:func:`PyErr_Clear` clears the exception state." msgstr "" msgid "" "The full exception state consists of three objects (all of which can be " "``NULL``): the exception type, the corresponding exception value, and the " -"traceback. These have the same meanings as the Python result of ``sys." -"exc_info()``; however, they are not the same: the Python objects represent " -"the last exception being handled by a Python :keyword:`try` ... :keyword:" -"`except` statement, while the C level exception state only exists while an " -"exception is being passed on between C functions until it reaches the Python " -"bytecode interpreter's main loop, which takes care of transferring it to " -"``sys.exc_info()`` and friends." +"traceback. These have the same meanings as the Python result of " +"``sys.exc_info()``; however, they are not the same: the Python objects " +"represent the last exception being handled by a " +"Python :keyword:`try` ... :keyword:`except` statement, while the C level " +"exception state only exists while an exception is being passed on between C " +"functions until it reaches the Python bytecode interpreter's main loop, " +"which takes care of transferring it to ``sys.exc_info()`` and friends." msgstr "" msgid "" "Note that starting with Python 1.5, the preferred, thread-safe way to access " -"the exception state from Python code is to call the function :func:`sys." -"exc_info`, which returns the per-thread exception state for Python code. " -"Also, the semantics of both ways to access the exception state have changed " -"so that a function which catches an exception will save and restore its " -"thread's exception state so as to preserve the exception state of its " -"caller. This prevents common bugs in exception handling code caused by an " -"innocent-looking function overwriting the exception being handled; it also " -"reduces the often unwanted lifetime extension for objects that are " -"referenced by the stack frames in the traceback." +"the exception state from Python code is to call the " +"function :func:`sys.exc_info`, which returns the per-thread exception state " +"for Python code. Also, the semantics of both ways to access the exception " +"state have changed so that a function which catches an exception will save " +"and restore its thread's exception state so as to preserve the exception " +"state of its caller. This prevents common bugs in exception handling code " +"caused by an innocent-looking function overwriting the exception being " +"handled; it also reduces the often unwanted lifetime extension for objects " +"that are referenced by the stack frames in the traceback." msgstr "" "Zauważ że poczynając od języka pytonowskiego w wersji 1.5 preferowaną, " "bezpiecznym dla wątków sposobem na dostęp do stanu wyjątku z poziomu kodu " @@ -1131,14 +1148,14 @@ msgstr "" msgid "" "This example represents an endorsed use of the ``goto`` statement in C! It " -"illustrates the use of :c:func:`PyErr_ExceptionMatches` and :c:func:" -"`PyErr_Clear` to handle specific exceptions, and the use of :c:func:" -"`Py_XDECREF` to dispose of owned references that may be ``NULL`` (note the " -"``'X'`` in the name; :c:func:`Py_DECREF` would crash when confronted with a " -"``NULL`` reference). It is important that the variables used to hold owned " -"references are initialized to ``NULL`` for this to work; likewise, the " -"proposed return value is initialized to ``-1`` (failure) and only set to " -"success after the final call made is successful." +"illustrates the use of :c:func:`PyErr_ExceptionMatches` " +"and :c:func:`PyErr_Clear` to handle specific exceptions, and the use " +"of :c:func:`Py_XDECREF` to dispose of owned references that may be ``NULL`` " +"(note the ``'X'`` in the name; :c:func:`Py_DECREF` would crash when " +"confronted with a ``NULL`` reference). It is important that the variables " +"used to hold owned references are initialized to ``NULL`` for this to work; " +"likewise, the proposed return value is initialized to ``-1`` (failure) and " +"only set to success after the final call made is successful." msgstr "" msgid "Embedding Python" @@ -1165,10 +1182,11 @@ msgid "" msgstr "" msgid "" -":c:func:`Py_Initialize` does not set the \"script argument list\" (``sys." -"argv``). If this variable is needed by Python code that will be executed " -"later, setting :c:member:`PyConfig.argv` and :c:member:`PyConfig.parse_argv` " -"must be set: see :ref:`Python Initialization Configuration `." +":c:func:`Py_Initialize` does not set the \"script argument list\" " +"(``sys.argv``). If this variable is needed by Python code that will be " +"executed later, setting :c:member:`PyConfig.argv` " +"and :c:member:`PyConfig.parse_argv` must be set: see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -1186,43 +1204,45 @@ msgid "" "For instance, if the Python executable is found in :file:`/usr/local/bin/" "python`, it will assume that the libraries are in :file:`/usr/local/lib/" "python{X.Y}`. (In fact, this particular path is also the \"fallback\" " -"location, used when no executable file named :file:`python` is found along :" -"envvar:`PATH`.) The user can override this behavior by setting the " +"location, used when no executable file named :file:`python` is found " +"along :envvar:`PATH`.) The user can override this behavior by setting the " "environment variable :envvar:`PYTHONHOME`, or insert additional directories " "in front of the standard path by setting :envvar:`PYTHONPATH`." msgstr "" "Na przykład, jeśli plik wykonywalny programu interpretującego polecenia " "języka pytonowskiego znajduje się w katalogu :file:`/usr/local/bin/python`, " -"będzie zakładał, że biblioteki są w katalogu :file:`/usr/local/lib/python{X." -"Y}` (Faktycznie, ta szczególna ścieżka jest także \"ratunkowym\" położeniem, " -"używanym gdy żaden plik wykonywalny nazwany :file:`python` nie znajdzie się " -"w katalogach znajdujących się w zmiennej środowiskowej :envvar:`PATH`.) " -"Użytkownik może podmienić to zachowanie przez ustawienie zmiennej " -"środowiskowej :envvar:`PYTHONHOME`, lub wstawić dodatkowe katalogi przed " -"sztandarową ścieżką przez ustawienie zmiennej środowiskowej :envvar:" -"`PYTHONPATH`." +"będzie zakładał, że biblioteki są w katalogu :file:`/usr/local/lib/" +"python{X.Y}` (Faktycznie, ta szczególna ścieżka jest także \"ratunkowym\" " +"położeniem, używanym gdy żaden plik wykonywalny nazwany :file:`python` nie " +"znajdzie się w katalogach znajdujących się w zmiennej " +"środowiskowej :envvar:`PATH`.) Użytkownik może podmienić to zachowanie przez " +"ustawienie zmiennej środowiskowej :envvar:`PYTHONHOME`, lub wstawić " +"dodatkowe katalogi przed sztandarową ścieżką przez ustawienie zmiennej " +"środowiskowej :envvar:`PYTHONPATH`." msgid "" -"The embedding application can steer the search by setting :c:member:" -"`PyConfig.program_name` *before* calling :c:func:`Py_InitializeFromConfig`. " -"Note that :envvar:`PYTHONHOME` still overrides this and :envvar:`PYTHONPATH` " -"is still inserted in front of the standard path. An application that " -"requires total control has to provide its own implementation of :c:func:" -"`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, and :c:" -"func:`Py_GetProgramFullPath` (all defined in :file:`Modules/getpath.c`)." +"The embedding application can steer the search by " +"setting :c:member:`PyConfig.program_name` *before* " +"calling :c:func:`Py_InitializeFromConfig`. Note that :envvar:`PYTHONHOME` " +"still overrides this and :envvar:`PYTHONPATH` is still inserted in front of " +"the standard path. An application that requires total control has to " +"provide its own implementation " +"of :c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, " +"and :c:func:`Py_GetProgramFullPath` (all defined in :file:`Modules/" +"getpath.c`)." msgstr "" msgid "" "Sometimes, it is desirable to \"uninitialize\" Python. For instance, the " -"application may want to start over (make another call to :c:func:" -"`Py_Initialize`) or the application is simply done with its use of Python " -"and wants to free memory allocated by Python. This can be accomplished by " -"calling :c:func:`Py_FinalizeEx`. The function :c:func:`Py_IsInitialized` " -"returns true if Python is currently in the initialized state. More " -"information about these functions is given in a later chapter. Notice that :" -"c:func:`Py_FinalizeEx` does *not* free all memory allocated by the Python " -"interpreter, e.g. memory allocated by extension modules currently cannot be " -"released." +"application may want to start over (make another call " +"to :c:func:`Py_Initialize`) or the application is simply done with its use " +"of Python and wants to free memory allocated by Python. This can be " +"accomplished by calling :c:func:`Py_FinalizeEx`. The " +"function :c:func:`Py_IsInitialized` returns true if Python is currently in " +"the initialized state. More information about these functions is given in a " +"later chapter. Notice that :c:func:`Py_FinalizeEx` does *not* free all " +"memory allocated by the Python interpreter, e.g. memory allocated by " +"extension modules currently cannot be released." msgstr "" msgid "Debugging Builds" @@ -1240,22 +1260,22 @@ msgstr "" "programu więc nie są załączane domyślnie." msgid "" -"A full list of the various types of debugging builds is in the file :file:" -"`Misc/SpecialBuilds.txt` in the Python source distribution. Builds are " -"available that support tracing of reference counts, debugging the memory " -"allocator, or low-level profiling of the main interpreter loop. Only the " -"most frequently used builds will be described in the remainder of this " +"A full list of the various types of debugging builds is in the " +"file :file:`Misc/SpecialBuilds.txt` in the Python source distribution. " +"Builds are available that support tracing of reference counts, debugging the " +"memory allocator, or low-level profiling of the main interpreter loop. Only " +"the most frequently used builds will be described in the remainder of this " "section." msgstr "" msgid "" "Compiling the interpreter with the :c:macro:`!Py_DEBUG` macro defined " "produces what is generally meant by :ref:`a debug build of Python `. :c:macro:`!Py_DEBUG` is enabled in the Unix build by adding :option:" -"`--with-pydebug` to the :file:`./configure` command. It is also implied by " -"the presence of the not-Python-specific :c:macro:`!_DEBUG` macro. When :c:" -"macro:`!Py_DEBUG` is enabled in the Unix build, compiler optimization is " -"disabled." +"build>`. :c:macro:`!Py_DEBUG` is enabled in the Unix build by " +"adding :option:`--with-pydebug` to the :file:`./configure` command. It is " +"also implied by the presence of the not-Python-specific :c:macro:`!_DEBUG` " +"macro. When :c:macro:`!Py_DEBUG` is enabled in the Unix build, compiler " +"optimization is disabled." msgstr "" msgid "" @@ -1264,12 +1284,12 @@ msgid "" msgstr "" msgid "" -"Defining :c:macro:`Py_TRACE_REFS` enables reference tracing (see the :option:" -"`configure --with-trace-refs option <--with-trace-refs>`). When defined, a " -"circular doubly linked list of active objects is maintained by adding two " -"extra fields to every :c:type:`PyObject`. Total allocations are tracked as " -"well. Upon exit, all existing references are printed. (In interactive mode " -"this happens after every statement run by the interpreter.)" +"Defining ``Py_TRACE_REFS`` enables reference tracing (see " +"the :option:`configure --with-trace-refs option <--with-trace-refs>`). When " +"defined, a circular doubly linked list of active objects is maintained by " +"adding two extra fields to every :c:type:`PyObject`. Total allocations are " +"tracked as well. Upon exit, all existing references are printed. (In " +"interactive mode this happens after every statement run by the interpreter.)" msgstr "" msgid "" @@ -1329,8 +1349,8 @@ msgid "" msgstr "" msgid "" -"`Python Packaging User Guide: Binary Extensions `_" +"`Python Packaging User Guide: Binary Extensions `_" msgstr "" "Pakiety Pythona Podręcznik Użytkownika: Rozszerzenia Binarne\n" ", YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,8 +29,8 @@ msgstr "" msgid "" "This section explains how a type's slots relate to each other throughout the " "life of an object. It is not intended to be a complete canonical reference " -"for the slots; instead, refer to the slot-specific documentation in :ref:" -"`type-structs` for details about a particular slot." +"for the slots; instead, refer to the slot-specific documentation " +"in :ref:`type-structs` for details about a particular slot." msgstr "" msgid "Life Events" @@ -56,14 +56,15 @@ msgid ":c:member:`~PyTypeObject.tp_new` is called to create a new object." msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_alloc` is directly called by :c:member:" -"`~PyTypeObject.tp_new` to allocate the memory for the new object." +":c:member:`~PyTypeObject.tp_alloc` is directly called " +"by :c:member:`~PyTypeObject.tp_new` to allocate the memory for the new " +"object." msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_init` initializes the newly created object. :c:" -"member:`!tp_init` can be called again to re-initialize an object, if " -"desired. The :c:member:`!tp_init` call can also be skipped entirely, for " +":c:member:`~PyTypeObject.tp_init` initializes the newly created " +"object. :c:member:`!tp_init` can be called again to re-initialize an object, " +"if desired. The :c:member:`!tp_init` call can also be skipped entirely, for " "example by Python code calling :py:meth:`~object.__new__`." msgstr "" @@ -95,17 +96,18 @@ msgstr "" msgid "" "When :c:member:`~PyTypeObject.tp_dealloc` finishes object destruction, it " -"directly calls :c:member:`~PyTypeObject.tp_free` (usually set to :c:func:" -"`PyObject_Free` or :c:func:`PyObject_GC_Del` automatically as appropriate " -"for the type) to deallocate the memory." +"directly calls :c:member:`~PyTypeObject.tp_free` (usually set " +"to :c:func:`PyObject_Free` or :c:func:`PyObject_GC_Del` automatically as " +"appropriate for the type) to deallocate the memory." msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_finalize` function is permitted to add a " "reference to the object if desired. If it does, the object is " "*resurrected*, preventing its pending destruction. (Only :c:member:`!" -"tp_finalize` is allowed to resurrect an object; :c:member:`~PyTypeObject." -"tp_clear` and :c:member:`~PyTypeObject.tp_dealloc` cannot without calling " +"tp_finalize` is allowed to resurrect an " +"object; :c:member:`~PyTypeObject.tp_clear` " +"and :c:member:`~PyTypeObject.tp_dealloc` cannot without calling " "into :c:member:`!tp_finalize`.) Resurrecting an object may or may not cause " "the object's *finalized* mark to be removed. Currently, Python does not " "remove the *finalized* mark from a resurrected object if it supports garbage " @@ -115,32 +117,35 @@ msgid "" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_dealloc` can optionally call :c:member:" -"`~PyTypeObject.tp_finalize` via :c:func:`PyObject_CallFinalizerFromDealloc` " -"if it wishes to reuse that code to help with object destruction. This is " -"recommended because it guarantees that :c:member:`!tp_finalize` is always " -"called before destruction. See the :c:member:`~PyTypeObject.tp_dealloc` " -"documentation for example code." +":c:member:`~PyTypeObject.tp_dealloc` can optionally " +"call :c:member:`~PyTypeObject.tp_finalize` " +"via :c:func:`PyObject_CallFinalizerFromDealloc` if it wishes to reuse that " +"code to help with object destruction. This is recommended because it " +"guarantees that :c:member:`!tp_finalize` is always called before " +"destruction. See the :c:member:`~PyTypeObject.tp_dealloc` documentation for " +"example code." msgstr "" msgid "" -"If the object is a member of a :term:`cyclic isolate` and either :c:member:" -"`~PyTypeObject.tp_clear` fails to break the reference cycle or the cyclic " -"isolate is not detected (perhaps :func:`gc.disable` was called, or the :c:" -"macro:`Py_TPFLAGS_HAVE_GC` flag was erroneously omitted in one of the " -"involved types), the objects remain indefinitely uncollectable (they " -"\"leak\"). See :data:`gc.garbage`." +"If the object is a member of a :term:`cyclic isolate` and " +"either :c:member:`~PyTypeObject.tp_clear` fails to break the reference cycle " +"or the cyclic isolate is not detected (perhaps :func:`gc.disable` was " +"called, or the :c:macro:`Py_TPFLAGS_HAVE_GC` flag was erroneously omitted in " +"one of the involved types), the objects remain indefinitely uncollectable " +"(they \"leak\"). See :data:`gc.garbage`." msgstr "" msgid "" -"If the object is marked as supporting garbage collection (the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag is set in :c:member:`~PyTypeObject.tp_flags`), the " -"following events are also possible:" +"If the object is marked as supporting garbage collection " +"(the :c:macro:`Py_TPFLAGS_HAVE_GC` flag is set " +"in :c:member:`~PyTypeObject.tp_flags`), the following events are also " +"possible:" msgstr "" msgid "" -"The garbage collector occasionally calls :c:member:`~PyTypeObject." -"tp_traverse` to identify :term:`cyclic isolates `." +"The garbage collector occasionally " +"calls :c:member:`~PyTypeObject.tp_traverse` to identify :term:`cyclic " +"isolates `." msgstr "" msgid "" @@ -234,8 +239,9 @@ msgid "" "behavior when an object referencing the destroyed object is itself " "destroyed. The clearing step makes object destruction a two-phase process: " "first :c:member:`~PyTypeObject.tp_clear` is called to partially destroy the " -"objects enough to detangle them from each other, then :c:member:" -"`~PyTypeObject.tp_dealloc` is called to complete the destruction." +"objects enough to detangle them from each other, " +"then :c:member:`~PyTypeObject.tp_dealloc` is called to complete the " +"destruction." msgstr "" msgid "" @@ -244,9 +250,9 @@ msgid "" "contracts. An object's finalizer is allowed to execute arbitrary Python " "code, and is even allowed to prevent the impending destruction by adding a " "reference. The finalizer is only related to destruction by call order---if " -"it runs, it runs before destruction, which starts with :c:member:" -"`~PyTypeObject.tp_clear` (if called) and concludes with :c:member:" -"`~PyTypeObject.tp_dealloc`." +"it runs, it runs before destruction, which starts " +"with :c:member:`~PyTypeObject.tp_clear` (if called) and concludes " +"with :c:member:`~PyTypeObject.tp_dealloc`." msgstr "" msgid "" @@ -282,13 +288,13 @@ msgid "" "Without any reference cycles, an object can be simply destroyed once its " "last reference is deleted; the finalization and clearing steps are not " "necessary to safely reclaim unused objects. However, it can be useful to " -"automatically call :c:member:`~PyTypeObject.tp_finalize` and :c:member:" -"`~PyTypeObject.tp_clear` before destruction anyway because type design is " -"simplified when all objects always experience the same series of events " -"regardless of whether they participated in a cyclic isolate. Python " -"currently only calls :c:member:`~PyTypeObject.tp_finalize` and :c:member:" -"`~PyTypeObject.tp_clear` as needed to destroy a cyclic isolate; this may " -"change in a future version." +"automatically call :c:member:`~PyTypeObject.tp_finalize` " +"and :c:member:`~PyTypeObject.tp_clear` before destruction anyway because " +"type design is simplified when all objects always experience the same series " +"of events regardless of whether they participated in a cyclic isolate. " +"Python currently only calls :c:member:`~PyTypeObject.tp_finalize` " +"and :c:member:`~PyTypeObject.tp_clear` as needed to destroy a cyclic " +"isolate; this may change in a future version." msgstr "" msgid "Functions" diff --git a/c-api/list.po b/c-api/list.po index 3289949269..f6b82cdeda 100644 --- a/c-api/list.po +++ b/c-api/list.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -49,12 +49,12 @@ msgstr "" msgid "" "If *len* is greater than zero, the returned list object's items are set to " -"``NULL``. Thus you cannot use abstract API functions such as :c:func:" -"`PySequence_SetItem` or expose the object to Python code before setting all " -"items to a real object with :c:func:`PyList_SetItem` or :c:func:" -"`PyList_SET_ITEM()`. The following APIs are safe APIs before the list is " -"fully initialized: :c:func:`PyList_SetItem()` and :c:func:" -"`PyList_SET_ITEM()`." +"``NULL``. Thus you cannot use abstract API functions such " +"as :c:func:`PySequence_SetItem` or expose the object to Python code before " +"setting all items to a real object with :c:func:`PyList_SetItem` " +"or :c:func:`PyList_SET_ITEM()`. The following APIs are safe APIs before the " +"list is fully initialized: :c:func:`PyList_SetItem()` " +"and :c:func:`PyList_SET_ITEM()`." msgstr "" msgid "" @@ -79,8 +79,8 @@ msgstr "" msgid "" "In the :term:`free-threaded build`, the returned :term:`borrowed reference` " -"may become invalid if another thread modifies the list concurrently. Prefer :" -"c:func:`PyList_GetItemRef`, which returns a :term:`strong reference`." +"may become invalid if another thread modifies the list concurrently. " +"Prefer :c:func:`PyList_GetItemRef`, which returns a :term:`strong reference`." msgstr "" msgid "Similar to :c:func:`PyList_GetItem`, but without error checking." @@ -93,8 +93,9 @@ msgid "" msgstr "" msgid "" -"This function \"steals\" a reference to *item* and discards a reference to " -"an item already in the list at the affected position." +"This function \":term:`steals `\" a reference to *item*, even on " +"error. On success, it discards a reference to an item already in the list at " +"the affected position (unless it was ``NULL``)." msgstr "" msgid "" @@ -103,21 +104,23 @@ msgid "" msgstr "" msgid "" -"Bounds checking is performed as an assertion if Python is built in :ref:" -"`debug mode ` or :option:`with assertions <--with-assertions>`." +"Bounds checking is performed as an assertion if Python is built " +"in :ref:`debug mode ` or :option:`with assertions <--with-" +"assertions>`." msgstr "" msgid "" -"This macro \"steals\" a reference to *item*, and, unlike :c:func:" -"`PyList_SetItem`, does *not* discard a reference to any item that is being " -"replaced; any reference in *list* at position *i* will be leaked." +"This macro \":term:`steals `\" a reference to *item*, and, " +"unlike :c:func:`PyList_SetItem`, does *not* discard a reference to any item " +"that is being replaced; any reference in *list* at position *i* will be " +"leaked." msgstr "" msgid "" "In the :term:`free-threaded build`, this macro has no internal " "synchronization. It is normally only used to fill in new lists where no " -"other thread has a reference to the list. If the list may be shared, use :c:" -"func:`PyList_SetItem` instead, which uses a :term:`per-object lock`." +"other thread has a reference to the list. If the list may be shared, " +"use :c:func:`PyList_SetItem` instead, which uses a :term:`per-object lock`." msgstr "" msgid "" @@ -165,11 +168,11 @@ msgid "" msgstr "" msgid "" -"In the :term:`free-threaded build`, when *iterable* is a :class:`list`, :" -"class:`set`, :class:`dict`, or dict view, both *list* and *iterable* (or its " -"underlying dict) are locked for the duration of the operation. For other " -"iterables, only *list* is locked; *iterable* may be concurrently modified by " -"another thread." +"In the :term:`free-threaded build`, when *iterable* is " +"a :class:`list`, :class:`set`, :class:`dict`, or dict view, both *list* and " +"*iterable* (or its underlying dict) are locked for the duration of the " +"operation. For other iterables, only *list* is locked; *iterable* may be " +"concurrently modified by another thread." msgstr "" msgid "" @@ -189,10 +192,11 @@ msgid "" msgstr "" msgid "" -"In the :term:`free-threaded build`, element comparison via :meth:`~object." -"__lt__` can execute arbitrary Python code, during which the :term:`per-" -"object lock` may be temporarily released. For built-in types (:class:`str`, :" -"class:`int`, :class:`float`), the lock is not released during comparison." +"In the :term:`free-threaded build`, element comparison " +"via :meth:`~object.__lt__` can execute arbitrary Python code, during which " +"the :term:`per-object lock` may be temporarily released. For built-in types " +"(:class:`str`, :class:`int`, :class:`float`), the lock is not released " +"during comparison." msgstr "" msgid "" diff --git a/c-api/long.po b/c-api/long.po index c2517d61f7..9d67354b4a 100644 --- a/c-api/long.po +++ b/c-api/long.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,8 +45,8 @@ msgid "" msgstr "" msgid "" -"Return true if its argument is a :c:type:`PyLongObject` or a subtype of :c:" -"type:`PyLongObject`. This function always succeeds." +"Return true if its argument is a :c:type:`PyLongObject` or a subtype " +"of :c:type:`PyLongObject`. This function always succeeds." msgstr "" msgid "" @@ -85,19 +85,19 @@ msgid "" msgstr "" msgid "" -"Return a new :c:type:`PyLongObject` object from a signed C :c:expr:`int32_t` " -"or :c:expr:`int64_t`, or ``NULL`` with an exception set on failure." +"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long " +"long`, or ``NULL`` on failure." msgstr "" msgid "" -"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long " -"long`, or ``NULL`` on failure." +"Return a new :c:type:`PyLongObject` object from a signed C :c:expr:`int32_t` " +"or :c:expr:`int64_t`, or ``NULL`` with an exception set on failure." msgstr "" msgid "" -"Return a new :c:type:`PyLongObject` object from an unsigned C :c:expr:" -"`uint32_t` or :c:expr:`uint64_t`, or ``NULL`` with an exception set on " -"failure." +"Return a new :c:type:`PyLongObject` object from an unsigned " +"C :c:expr:`uint32_t` or :c:expr:`uint64_t`, or ``NULL`` with an exception " +"set on failure." msgstr "" msgid "" @@ -163,8 +163,9 @@ msgid "Macro for creating a Python integer from a process identifier." msgstr "" msgid "" -"This can be defined as an alias to :c:func:`PyLong_FromLong` or :c:func:" -"`PyLong_FromLongLong`, depending on the size of the system's PID type." +"This can be defined as an alias to :c:func:`PyLong_FromLong` " +"or :c:func:`PyLong_FromLongLong`, depending on the size of the system's PID " +"type." msgstr "" msgid "" @@ -174,8 +175,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:" -"expr:`long`." +"Raise :exc:`OverflowError` if the value of *obj* is out of range for " +"a :c:expr:`long`." msgstr "" msgid "Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." @@ -193,15 +194,16 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyLong_AsLong`, but store the result in a C :c:expr:" -"`int` instead of a C :c:expr:`long`." +"Similar to :c:func:`PyLong_AsLong`, but store the result in a " +"C :c:expr:`int` instead of a C :c:expr:`long`." msgstr "" msgid "" -"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less than :c:" -"macro:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and " -"return ``-1``; otherwise, set *\\*overflow* to ``0``. If any other " -"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual." +"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less " +"than :c:macro:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, " +"respectively, and return ``-1``; otherwise, set *\\*overflow* to ``0``. If " +"any other exception occurs set *\\*overflow* to ``0`` and return ``-1`` as " +"usual." msgstr "" msgid "" @@ -211,15 +213,16 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:" -"expr:`long long`." +"Raise :exc:`OverflowError` if the value of *obj* is out of range for " +"a :c:expr:`long long`." msgstr "" msgid "" -"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less than :c:" -"macro:`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and " -"return ``-1``; otherwise, set *\\*overflow* to ``0``. If any other " -"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual." +"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less " +"than :c:macro:`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, " +"respectively, and return ``-1``; otherwise, set *\\*overflow* to ``0``. If " +"any other exception occurs set *\\*overflow* to ``0`` and return ``-1`` as " +"usual." msgstr "" msgid "" @@ -228,8 +231,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"type:`Py_ssize_t`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:type:`Py_ssize_t`." msgstr "" msgid "" @@ -238,8 +241,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"expr:`unsigned long`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:expr:`unsigned long`." msgstr "" msgid "" @@ -253,8 +256,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"type:`size_t`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:type:`size_t`." msgstr "" msgid "" @@ -268,8 +271,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an :" -"c:expr:`unsigned long long`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"an :c:expr:`unsigned long long`." msgstr "" msgid "" @@ -283,8 +286,9 @@ msgstr "" msgid "" "Return a C :c:expr:`unsigned long` representation of *obj*. If *obj* is not " -"an instance of :c:type:`PyLongObject`, first call its :meth:`~object." -"__index__` method (if present) to convert it to a :c:type:`PyLongObject`." +"an instance of :c:type:`PyLongObject`, first call " +"its :meth:`~object.__index__` method (if present) to convert it to " +"a :c:type:`PyLongObject`." msgstr "" msgid "" @@ -299,8 +303,9 @@ msgstr "" msgid "" "Return a C :c:expr:`unsigned long long` representation of *obj*. If *obj* " -"is not an instance of :c:type:`PyLongObject`, first call its :meth:`~object." -"__index__` method (if present) to convert it to a :c:type:`PyLongObject`." +"is not an instance of :c:type:`PyLongObject`, first call " +"its :meth:`~object.__index__` method (if present) to convert it to " +"a :c:type:`PyLongObject`." msgstr "" msgid "" @@ -319,9 +324,9 @@ msgid "" msgstr "" msgid "" -"If *obj* is not an instance of :c:type:`PyLongObject`, first call its :meth:" -"`~object.__index__` method (if present) to convert it to a :c:type:" -"`PyLongObject`." +"If *obj* is not an instance of :c:type:`PyLongObject`, first call " +"its :meth:`~object.__index__` method (if present) to convert it to " +"a :c:type:`PyLongObject`." msgstr "" msgid "If the *obj* value is out of range, raise an :exc:`OverflowError`." @@ -349,8 +354,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"expr:`double`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:expr:`double`." msgstr "" msgid "" @@ -360,8 +365,8 @@ msgstr "" msgid "" "Convert a Python integer *pylong* to a C :c:expr:`void` pointer. If *pylong* " "cannot be converted, an :exc:`OverflowError` will be raised. This is only " -"assured to produce a usable :c:expr:`void` pointer for values created with :" -"c:func:`PyLong_FromVoidPtr`." +"assured to produce a usable :c:expr:`void` pointer for values created " +"with :c:func:`PyLong_FromVoidPtr`." msgstr "" msgid "" @@ -540,8 +545,8 @@ msgid "" "passed, its :meth:`~object.__index__` method will be called first. This may " "result in Python code executing and other threads being allowed to run, " "which could cause changes to other objects or values in use. When *flags* is " -"``-1``, this option is not set, and non-integer values will raise :exc:" -"`TypeError`." +"``-1``, this option is not set, and non-integer values will " +"raise :exc:`TypeError`." msgstr "" msgid "" @@ -555,9 +560,9 @@ msgid "Macro for converting a Python integer into a process identifier." msgstr "" msgid "" -"This can be defined as an alias to :c:func:`PyLong_AsLong`, :c:func:" -"`PyLong_FromLongLong`, or :c:func:`PyLong_AsInt`, depending on the size of " -"the system's PID type." +"This can be defined as an alias " +"to :c:func:`PyLong_AsLong`, :c:func:`PyLong_FromLongLong`, " +"or :c:func:`PyLong_AsInt`, depending on the size of the system's PID type." msgstr "" msgid "Get the sign of the integer object *obj*." @@ -614,9 +619,10 @@ msgstr "" msgid "" "This function makes it possible for performance-critical code to implement a " -"“fast path” for small integers. For compact values use :c:func:" -"`PyUnstable_Long_CompactValue`; for others fall back to a :c:func:" -"`PyLong_As* ` function or :c:func:`PyLong_AsNativeBytes`." +"“fast path” for small integers. For compact values " +"use :c:func:`PyUnstable_Long_CompactValue`; for others fall back to " +"a :c:func:`PyLong_As* ` function " +"or :c:func:`PyLong_AsNativeBytes`." msgstr "" msgid "The speedup is expected to be negligible for most users." @@ -635,6 +641,21 @@ msgstr "" msgid "Otherwise, the return value is undefined." msgstr "" +msgid "Build configuration" +msgstr "" + +msgid "" +"The number of bits in each digit of CPython's native representation of " +"integers. The value can currently be either ``30`` (the default) or ``15``, " +"selected with :option:`--enable-big-digits` when building Python." +msgstr "" + +msgid "" +"To access the native representation of integers, " +"use :c:func:`PyLong_GetNativeLayout` and " +"its :c:member:`~PyLongLayout.bits_per_digit` member instead." +msgstr "" + msgid "Export API" msgstr "" @@ -644,9 +665,9 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyLong_GetNativeLayout` to get the native layout of Python :" -"class:`int` objects, used internally for integers with \"big enough\" " -"absolute value." +"Use :c:func:`PyLong_GetNativeLayout` to get the native layout of " +"Python :class:`int` objects, used internally for integers with \"big " +"enough\" absolute value." msgstr "" msgid "" @@ -705,23 +726,23 @@ msgid "" msgstr "" msgid "" -"If :c:member:`digits` is not ``NULL``, use :c:member:`negative`, :c:member:" -"`ndigits` and :c:member:`digits` members." +"If :c:member:`digits` is not ``NULL``, " +"use :c:member:`negative`, :c:member:`ndigits` and :c:member:`digits` members." msgstr "" msgid "" -"The native integer value of the exported :class:`int` object. Only valid if :" -"c:member:`digits` is ``NULL``." +"The native integer value of the exported :class:`int` object. Only valid " +"if :c:member:`digits` is ``NULL``." msgstr "" msgid "" -"``1`` if the number is negative, ``0`` otherwise. Only valid if :c:member:" -"`digits` is not ``NULL``." +"``1`` if the number is negative, ``0`` otherwise. Only valid " +"if :c:member:`digits` is not ``NULL``." msgstr "" msgid "" -"Number of digits in :c:member:`digits` array. Only valid if :c:member:" -"`digits` is not ``NULL``." +"Number of digits in :c:member:`digits` array. Only valid " +"if :c:member:`digits` is not ``NULL``." msgstr "" msgid "Read-only array of unsigned digits. Can be ``NULL``." @@ -768,8 +789,8 @@ msgid "A Python :class:`int` writer instance." msgstr "" msgid "" -"The instance must be destroyed by :c:func:`PyLongWriter_Finish` or :c:func:" -"`PyLongWriter_Discard`." +"The instance must be destroyed by :c:func:`PyLongWriter_Finish` " +"or :c:func:`PyLongWriter_Discard`." msgstr "" msgid "Create a :c:type:`PyLongWriter`." @@ -794,8 +815,8 @@ msgstr "" msgid "" "After a successful call to this function, the caller should fill in the " "array of digits *digits* and then call :c:func:`PyLongWriter_Finish` to get " -"a Python :class:`int`. The layout of *digits* is described by :c:func:" -"`PyLong_GetNativeLayout`." +"a Python :class:`int`. The layout of *digits* is described " +"by :c:func:`PyLong_GetNativeLayout`." msgstr "" msgid "" @@ -842,10 +863,11 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyLong_GetNativeLayout` instead, along with :c:func:" -"`PyLong_Export` to read integer data or :c:type:`PyLongWriter` to write it. " -"These currently use the same layout, but are designed to continue working " -"correctly even if CPython's internal integer representation changes." +"Use :c:func:`PyLong_GetNativeLayout` instead, along " +"with :c:func:`PyLong_Export` to read integer data or :c:type:`PyLongWriter` " +"to write it. These currently use the same layout, but are designed to " +"continue working correctly even if CPython's internal integer representation " +"changes." msgstr "" msgid "" diff --git a/c-api/mapping.po b/c-api/mapping.po index 7bd9b811c0..a63d955d87 100644 --- a/c-api/mapping.po +++ b/c-api/mapping.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,8 +27,8 @@ msgid "Mapping Protocol" msgstr "" msgid "" -"See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` and :c:func:" -"`PyObject_DelItem`." +"See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` " +"and :c:func:`PyObject_DelItem`." msgstr "" msgid "" @@ -45,9 +45,9 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyObject_GetItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_GetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -70,18 +70,18 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyObject_SetItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_SetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "This is an alias of :c:func:`PyObject_DelItem`." msgstr "" msgid "" -"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -104,23 +104,23 @@ msgstr "" msgid "" "Exceptions which occur when this calls the :meth:`~object.__getitem__` " -"method are silently ignored. For proper error handling, use :c:func:" -"`PyMapping_HasKeyWithError`, :c:func:`PyMapping_GetOptionalItem` or :c:func:" -"`PyObject_GetItem()` instead." +"method are silently ignored. For proper error handling, " +"use :c:func:`PyMapping_HasKeyWithError`, :c:func:`PyMapping_GetOptionalItem` " +"or :c:func:`PyObject_GetItem()` instead." msgstr "" msgid "" -"This is the same as :c:func:`PyMapping_HasKey`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyMapping_HasKey`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" "Exceptions that occur when this calls the :meth:`~object.__getitem__` method " "or while creating the temporary :class:`str` object are silently ignored. " -"For proper error handling, use :c:func:`PyMapping_HasKeyStringWithError`, :c:" -"func:`PyMapping_GetOptionalItemString` or :c:func:`PyMapping_GetItemString` " -"instead." +"For proper error handling, " +"use :c:func:`PyMapping_HasKeyStringWithError`, :c:func:`PyMapping_GetOptionalItemString` " +"or :c:func:`PyMapping_GetItemString` instead." msgstr "" msgid "" diff --git a/c-api/memory.po b/c-api/memory.po index cf3dfc9c51..b1a2d30d8d 100644 --- a/c-api/memory.po +++ b/c-api/memory.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -80,13 +80,14 @@ msgstr "" msgid "" "To avoid memory corruption, extension writers should never try to operate on " -"Python objects with the functions exported by the C library: :c:func:" -"`malloc`, :c:func:`calloc`, :c:func:`realloc` and :c:func:`free`. This will " -"result in mixed calls between the C allocator and the Python memory manager " -"with fatal consequences, because they implement different algorithms and " -"operate on different heaps. However, one may safely allocate and release " -"memory blocks with the C library allocator for individual purposes, as shown " -"in the following example::" +"Python objects with the functions exported by the C " +"library: :c:func:`malloc`, :c:func:`calloc`, :c:func:`realloc` " +"and :c:func:`free`. This will result in mixed calls between the C " +"allocator and the Python memory manager with fatal consequences, because " +"they implement different algorithms and operate on different heaps. " +"However, one may safely allocate and release memory blocks with the C " +"library allocator for individual purposes, as shown in the following " +"example::" msgstr "" msgid "" @@ -120,8 +121,8 @@ msgid "" "certain circumstances, the Python memory manager may or may not trigger " "appropriate actions, like garbage collection, memory compaction or other " "preventive procedures. Note that by using the C library allocator as shown " -"in the previous example, the allocated memory for the I/O buffer escapes " -"completely the Python memory manager." +"in the previous example, the allocated memory for the I/O buffer completely " +"escapes the Python memory manager." msgstr "" msgid "" @@ -182,9 +183,9 @@ msgid "" msgstr "" msgid "" -"For example, buffers (non-Python objects) should be allocated using :c:func:" -"`PyMem_Malloc`, :c:func:`PyMem_RawMalloc`, or :c:func:`malloc`, but not :c:" -"func:`PyObject_Malloc`." +"For example, buffers (non-Python objects) should be allocated " +"using :c:func:`PyMem_Malloc`, :c:func:`PyMem_RawMalloc`, " +"or :c:func:`malloc`, but not :c:func:`PyObject_Malloc`." msgstr "" msgid "See :ref:`Memory Allocation APIs `." @@ -195,8 +196,8 @@ msgstr "" msgid "" "The following function sets are wrappers to the system allocator. These " -"functions are thread-safe, so a :term:`thread state` does not need to be :" -"term:`attached `." +"functions are thread-safe, so a :term:`thread state` does not need to " +"be :term:`attached `." msgstr "" msgid "" @@ -218,9 +219,9 @@ msgid "" msgstr "" msgid "" -"Allocates *nelem* elements each whose size in bytes is *elsize* and returns " -"a pointer of type :c:expr:`void*` to the allocated memory, or ``NULL`` if " -"the request fails. The memory is initialized to zeros." +"Allocates *nelem* elements each of size *elsize* bytes and returns a pointer " +"of type :c:expr:`void*` to the allocated memory, or ``NULL`` if the request " +"fails. The memory is initialized to zeros." msgstr "" msgid "" @@ -241,9 +242,9 @@ msgid "" msgstr "" msgid "" -"Unless *p* is ``NULL``, it must have been returned by a previous call to :c:" -"func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` or :c:func:" -"`PyMem_RawCalloc`." +"Unless *p* is ``NULL``, it must have been returned by a previous call " +"to :c:func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` " +"or :c:func:`PyMem_RawCalloc`." msgstr "" msgid "" @@ -253,9 +254,9 @@ msgstr "" msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " -"previous call to :c:func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` or :c:" -"func:`PyMem_RawCalloc`. Otherwise, or if ``PyMem_RawFree(p)`` has been " -"called before, undefined behavior occurs." +"previous call to :c:func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` " +"or :c:func:`PyMem_RawCalloc`. Otherwise, or if ``PyMem_RawFree(p)`` has " +"been called before, undefined behavior occurs." msgstr "" msgid "If *p* is ``NULL``, no operation is performed." @@ -273,8 +274,8 @@ msgstr "" msgid "" "In the GIL-enabled build (default build) the :ref:`default memory allocator " "` uses the :ref:`pymalloc memory allocator " -"`, whereas in the :term:`free-threaded build`, the default is the :" -"ref:`mimalloc memory allocator ` instead." +"`, whereas in the :term:`free-threaded build`, the default is " +"the :ref:`mimalloc memory allocator ` instead." msgstr "" msgid "" @@ -309,8 +310,8 @@ msgid "" msgstr "" msgid "" -"Unless *p* is ``NULL``, it must have been returned by a previous call to :c:" -"func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` or :c:func:`PyMem_Calloc`." +"Unless *p* is ``NULL``, it must have been returned by a previous call " +"to :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` or :c:func:`PyMem_Calloc`." msgstr "" msgid "" @@ -320,9 +321,9 @@ msgstr "" msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " -"previous call to :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` or :c:func:" -"`PyMem_Calloc`. Otherwise, or if ``PyMem_Free(p)`` has been called before, " -"undefined behavior occurs." +"previous call to :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` " +"or :c:func:`PyMem_Calloc`. Otherwise, or if ``PyMem_Free(p)`` has been " +"called before, undefined behavior occurs." msgstr "" msgid "" @@ -399,10 +400,10 @@ msgid "" msgstr "" msgid "" -"The :ref:`default object allocator ` uses the :" -"ref:`pymalloc memory allocator `. In the :term:`free-threaded " -"` build, the default is the :ref:`mimalloc memory allocator " -"` instead." +"The :ref:`default object allocator ` uses " +"the :ref:`pymalloc memory allocator `. In the :term:`free-" +"threaded ` build, the default is the :ref:`mimalloc memory " +"allocator ` instead." msgstr "" msgid "" @@ -424,9 +425,9 @@ msgid "" msgstr "" msgid "" -"Unless *p* is ``NULL``, it must have been returned by a previous call to :c:" -"func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` or :c:func:" -"`PyObject_Calloc`." +"Unless *p* is ``NULL``, it must have been returned by a previous call " +"to :c:func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` " +"or :c:func:`PyObject_Calloc`." msgstr "" msgid "" @@ -436,19 +437,19 @@ msgstr "" msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " -"previous call to :c:func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` or :c:" -"func:`PyObject_Calloc`. Otherwise, or if ``PyObject_Free(p)`` has been " -"called before, undefined behavior occurs." +"previous call to :c:func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` " +"or :c:func:`PyObject_Calloc`. Otherwise, or if ``PyObject_Free(p)`` has " +"been called before, undefined behavior occurs." msgstr "" msgid "" -"Do not call this directly to free an object's memory; call the type's :c:" -"member:`~PyTypeObject.tp_free` slot instead." +"Do not call this directly to free an object's memory; call the " +"type's :c:member:`~PyTypeObject.tp_free` slot instead." msgstr "" msgid "" -"Do not use this for memory allocated by :c:macro:`PyObject_GC_New` or :c:" -"macro:`PyObject_GC_NewVar`; use :c:func:`PyObject_GC_Del` instead." +"Do not use this for memory allocated by :c:macro:`PyObject_GC_New` " +"or :c:macro:`PyObject_GC_NewVar`; use :c:func:`PyObject_GC_Del` instead." msgstr "" msgid "" @@ -559,8 +560,9 @@ msgid "Name: value for :envvar:`PYTHONMALLOC` environment variable." msgstr "" msgid "" -"``malloc``: system allocators from the standard C library, C functions: :c:" -"func:`malloc`, :c:func:`calloc`, :c:func:`realloc` and :c:func:`free`." +"``malloc``: system allocators from the standard C library, C " +"functions: :c:func:`malloc`, :c:func:`calloc`, :c:func:`realloc` " +"and :c:func:`free`." msgstr "" msgid "``pymalloc``: :ref:`pymalloc memory allocator `." @@ -622,8 +624,8 @@ msgid "free a memory block" msgstr "" msgid "" -"The :c:type:`!PyMemAllocator` structure was renamed to :c:type:" -"`PyMemAllocatorEx` and a new ``calloc`` field was added." +"The :c:type:`!PyMemAllocator` structure was renamed " +"to :c:type:`PyMemAllocatorEx` and a new ``calloc`` field was added." msgstr "" msgid "Enum used to identify an allocator domain. Domains:" @@ -672,8 +674,8 @@ msgstr "" msgid "" "For the remaining domains, the allocator must also be thread-safe: the " -"allocator may be called in different interpreters that do not share a :term:" -"`GIL`." +"allocator may be called in different interpreters that do not share " +"a :term:`GIL`." msgstr "" msgid "" @@ -691,19 +693,20 @@ msgid ":c:func:`PyMem_SetAllocator` does have the following contract:" msgstr "" msgid "" -"It can be called after :c:func:`Py_PreInitialize` and before :c:func:" -"`Py_InitializeFromConfig` to install a custom memory allocator. There are no " -"restrictions over the installed allocator other than the ones imposed by the " -"domain (for instance, the Raw Domain allows the allocator to be called " -"without an :term:`attached thread state`). See :ref:`the section on " -"allocator domains ` for more information." +"It can be called after :c:func:`Py_PreInitialize` and " +"before :c:func:`Py_InitializeFromConfig` to install a custom memory " +"allocator. There are no restrictions over the installed allocator other than " +"the ones imposed by the domain (for instance, the Raw Domain allows the " +"allocator to be called without an :term:`attached thread state`). " +"See :ref:`the section on allocator domains ` for more " +"information." msgstr "" msgid "" -"If called after Python has finish initializing (after :c:func:" -"`Py_InitializeFromConfig` has been called) the allocator **must** wrap the " -"existing allocator. Substituting the current allocator for some other " -"arbitrary one is **not supported**." +"If called after Python has finish initializing " +"(after :c:func:`Py_InitializeFromConfig` has been called) the allocator " +"**must** wrap the existing allocator. Substituting the current allocator for " +"some other arbitrary one is **not supported**." msgstr "" msgid "All allocators must be thread-safe." @@ -718,8 +721,8 @@ msgid "Debug hooks on the Python memory allocators" msgstr "" msgid "" -"When :ref:`Python is built in debug mode `, the :c:func:" -"`PyMem_SetupDebugHooks` function is called at the :ref:`Python " +"When :ref:`Python is built in debug mode `, " +"the :c:func:`PyMem_SetupDebugHooks` function is called at the :ref:`Python " "preinitialization ` to setup debug hooks on Python memory " "allocators to detect memory errors." msgstr "" @@ -859,11 +862,11 @@ msgstr "" msgid "" "The :c:func:`PyMem_SetupDebugHooks` function now also works on Python " -"compiled in release mode. On error, the debug hooks now use :mod:" -"`tracemalloc` to get the traceback where a memory block was allocated. The " -"debug hooks now also check if there is an :term:`attached thread state` when " -"functions of :c:macro:`PYMEM_DOMAIN_OBJ` and :c:macro:`PYMEM_DOMAIN_MEM` " -"domains are called." +"compiled in release mode. On error, the debug hooks now " +"use :mod:`tracemalloc` to get the traceback where a memory block was " +"allocated. The debug hooks now also check if there is an :term:`attached " +"thread state` when functions of :c:macro:`PYMEM_DOMAIN_OBJ` " +"and :c:macro:`PYMEM_DOMAIN_MEM` domains are called." msgstr "" msgid "" @@ -880,14 +883,14 @@ msgid "" "Python has a *pymalloc* allocator optimized for small objects (smaller or " "equal to 512 bytes) with a short lifetime. It uses memory mappings called " "\"arenas\" with a fixed size of either 256 KiB on 32-bit platforms or 1 MiB " -"on 64-bit platforms. It falls back to :c:func:`PyMem_RawMalloc` and :c:func:" -"`PyMem_RawRealloc` for allocations larger than 512 bytes." +"on 64-bit platforms. It falls back to :c:func:`PyMem_RawMalloc` " +"and :c:func:`PyMem_RawRealloc` for allocations larger than 512 bytes." msgstr "" msgid "" "*pymalloc* is the :ref:`default allocator ` of " -"the :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) and :c:macro:" -"`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) domains." +"the :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) " +"and :c:macro:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) domains." msgstr "" msgid "The arena allocator uses the following functions:" @@ -904,8 +907,9 @@ msgstr "" msgid "" "This allocator is disabled if Python is configured with the :option:`--" -"without-pymalloc` option. It can also be disabled at runtime using the :" -"envvar:`PYTHONMALLOC` environment variable (ex: ``PYTHONMALLOC=malloc``)." +"without-pymalloc` option. It can also be disabled at runtime using " +"the :envvar:`PYTHONMALLOC` environment variable (ex: " +"``PYTHONMALLOC=malloc``)." msgstr "" msgid "" @@ -958,19 +962,20 @@ msgstr "" msgid "" "In the :term:`free-threaded ` build, mimalloc is the default " -"and **required** allocator for the :c:macro:`PYMEM_DOMAIN_MEM` and :c:macro:" -"`PYMEM_DOMAIN_OBJ` domains. It cannot be disabled in free-threaded builds. " -"The free-threaded build uses per-thread mimalloc heaps, which allows " -"allocation and deallocation to proceed without locking in most cases." +"and **required** allocator for the :c:macro:`PYMEM_DOMAIN_MEM` " +"and :c:macro:`PYMEM_DOMAIN_OBJ` domains. It cannot be disabled in free-" +"threaded builds. The free-threaded build uses per-thread mimalloc heaps, " +"which allows allocation and deallocation to proceed without locking in most " +"cases." msgstr "" msgid "" "In the default (non-free-threaded) build, mimalloc is available but not the " -"default allocator. It can be selected at runtime using :envvar:" -"`PYTHONMALLOC`\\ ``=mimalloc`` (or ``mimalloc_debug`` to include :ref:`debug " -"hooks `). It can be disabled at build time using the :" -"option:`--without-mimalloc` configure option, but this option cannot be " -"combined with :option:`--disable-gil`." +"default allocator. It can be selected at runtime " +"using :envvar:`PYTHONMALLOC`\\ ``=mimalloc`` (or ``mimalloc_debug`` to " +"include :ref:`debug hooks `). It can be disabled at " +"build time using the :option:`--without-mimalloc` configure option, but this " +"option cannot be combined with :option:`--disable-gil`." msgstr "" msgid "tracemalloc C API" @@ -1003,8 +1008,8 @@ msgid "" "the I/O buffer is allocated from the Python heap by using the first function " "set::" msgstr "" -"Tutaj jest przykład z sekcji \"przeglądu pamięci\" - z ang. - :ref:" -"`memoryoverview`, przepisane, tak aby przestrzeń wejścia/wyjścia była " +"Tutaj jest przykład z sekcji \"przeglądu pamięci\" - z ang. " +"- :ref:`memoryoverview`, przepisane, tak aby przestrzeń wejścia/wyjścia była " "przydzielona ze sterty Pythona używając pierwszego zestawu zadań::" msgid "" @@ -1062,8 +1067,9 @@ msgstr "" msgid "" "In addition to the functions aimed at handling raw memory blocks from the " -"Python heap, objects in Python are allocated and released with :c:macro:" -"`PyObject_New`, :c:macro:`PyObject_NewVar` and :c:func:`PyObject_Free`." +"Python heap, objects in Python are allocated and released " +"with :c:macro:`PyObject_New`, :c:macro:`PyObject_NewVar` " +"and :c:func:`PyObject_Free`." msgstr "" msgid "" diff --git a/c-api/memoryview.po b/c-api/memoryview.po index 80e894260c..9622b53742 100644 --- a/c-api/memoryview.po +++ b/c-api/memoryview.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -87,9 +87,10 @@ msgstr "" msgid "" "Return either a pointer to the exporting object that the memoryview is based " -"on or ``NULL`` if the memoryview has been created by one of the functions :c:" -"func:`PyMemoryView_FromMemory` or :c:func:`PyMemoryView_FromBuffer`. *mview* " -"**must** be a memoryview instance." +"on or ``NULL`` if the memoryview has been created by one of the " +"functions :c:func:`PyMemoryView_FromMemory` " +"or :c:func:`PyMemoryView_FromBuffer`. *mview* **must** be a memoryview " +"instance." msgstr "" msgid "object" diff --git a/c-api/method.po b/c-api/method.po index c00e1e42fa..27b563295b 100644 --- a/c-api/method.po +++ b/c-api/method.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,9 +38,9 @@ msgid "" msgstr "" msgid "" -"Return true if *o* is an instance method object (has type :c:data:" -"`PyInstanceMethod_Type`). The parameter must not be ``NULL``. This function " -"always succeeds." +"Return true if *o* is an instance method object (has " +"type :c:data:`PyInstanceMethod_Type`). The parameter must not be ``NULL``. " +"This function always succeeds." msgstr "" msgid "" diff --git a/c-api/module.po b/c-api/module.po index 65e076fe18..1e0378be98 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -37,16 +37,17 @@ msgid "" msgstr "" msgid "" -"Return true if *p* is a module object, but not a subtype of :c:data:" -"`PyModule_Type`. This function always succeeds." +"Return true if *p* is a module object, but not a subtype " +"of :c:data:`PyModule_Type`. This function always succeeds." msgstr "" msgid "" "Return a new module object with :attr:`module.__name__` set to *name*. The " -"module's :attr:`!__name__`, :attr:`~module.__doc__`, :attr:`~module." -"__package__` and :attr:`~module.__loader__` attributes are filled in (all " -"but :attr:`!__name__` are set to ``None``). The caller is responsible for " -"setting a :attr:`~module.__file__` attribute." +"module's :attr:`!" +"__name__`, :attr:`~module.__doc__`, :attr:`~module.__package__` " +"and :attr:`~module.__loader__` attributes are filled in (all but :attr:`!" +"__name__` are set to ``None``). The caller is responsible for setting " +"a :attr:`~module.__file__` attribute." msgstr "" msgid "Return ``NULL`` with an exception set on error." @@ -71,8 +72,8 @@ msgstr "" msgid "" "It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` " -"functions rather than directly manipulate a module's :attr:`~object." -"__dict__`." +"functions rather than directly manipulate a " +"module's :attr:`~object.__dict__`." msgstr "" msgid "" @@ -93,14 +94,14 @@ msgstr "" msgid "" "The returned buffer is only valid until the module is renamed or destroyed. " -"Note that Python code may rename a module by setting its :py:attr:`~module." -"__name__` attribute." +"Note that Python code may rename a module by setting " +"its :py:attr:`~module.__name__` attribute." msgstr "" msgid "" "Return the \"state\" of the module, that is, a pointer to the block of " -"memory allocated at module creation time, or ``NULL``. See :c:member:" -"`PyModuleDef.m_size`." +"memory allocated at module creation time, or ``NULL``. " +"See :c:member:`PyModuleDef.m_size`." msgstr "" msgid "" @@ -109,16 +110,16 @@ msgid "" msgstr "" msgid "" -"On error, return ``NULL`` with an exception set. Use :c:func:" -"`PyErr_Occurred` to tell this case apart from a missing :c:type:`!" -"PyModuleDef`." +"On error, return ``NULL`` with an exception set. " +"Use :c:func:`PyErr_Occurred` to tell this case apart from a " +"missing :c:type:`!PyModuleDef`." msgstr "" msgid "" -"Return the name of the file from which *module* was loaded using *module*'s :" -"attr:`~module.__file__` attribute. If this is not defined, or if it is not " -"a string, raise :exc:`SystemError` and return ``NULL``; otherwise return a " -"reference to a Unicode object." +"Return the name of the file from which *module* was loaded using " +"*module*'s :attr:`~module.__file__` attribute. If this is not defined, or " +"if it is not a string, raise :exc:`SystemError` and return ``NULL``; " +"otherwise return a reference to a Unicode object." msgstr "" msgid "" @@ -127,8 +128,9 @@ msgid "" msgstr "" msgid "" -"The returned buffer is only valid until the module's :py:attr:`~module." -"__file__` attribute is reassigned or the module is destroyed." +"The returned buffer is only valid until the " +"module's :py:attr:`~module.__file__` attribute is reassigned or the module " +"is destroyed." msgstr "" msgid "" @@ -145,9 +147,9 @@ msgid "" msgstr "" msgid "" -"Modules defined using the C API typically use a *module definition*, :c:type:" -"`PyModuleDef` -- a statically allocated, constant “description\" of how a " -"module should be created." +"Modules defined using the C API typically use a *module " +"definition*, :c:type:`PyModuleDef` -- a statically allocated, constant " +"“description\" of how a module should be created." msgstr "" msgid "" @@ -177,8 +179,8 @@ msgid "Name for the new module." msgstr "" msgid "" -"Docstring for the module; usually a docstring variable created with :c:macro:" -"`PyDoc_STRVAR` is used." +"Docstring for the module; usually a docstring variable created " +"with :c:macro:`PyDoc_STRVAR` is used." msgstr "" msgid "" @@ -189,8 +191,8 @@ msgstr "" msgid "" "This memory area is allocated based on *m_size* on module creation, and " -"freed when the module object is deallocated, after the :c:member:" -"`~PyModuleDef.m_free` function has been called, if present." +"freed when the module object is deallocated, after " +"the :c:member:`~PyModuleDef.m_free` function has been called, if present." msgstr "" msgid "" @@ -211,8 +213,9 @@ msgid "See :PEP:`3121` for more details." msgstr "" msgid "" -"A pointer to a table of module-level functions, described by :c:type:" -"`PyMethodDef` values. Can be ``NULL`` if no functions are present." +"A pointer to a table of module-level functions, described " +"by :c:type:`PyMethodDef` values. Can be ``NULL`` if no functions are " +"present." msgstr "" msgid "" @@ -236,8 +239,8 @@ msgid "" "allocated yet. This is the case immediately after the module is created and " "before the module is executed (:c:data:`Py_mod_exec` function). More " "precisely, this function is not called if :c:member:`~PyModuleDef.m_size` is " -"greater than 0 and the module state (as returned by :c:func:" -"`PyModule_GetState`) is ``NULL``." +"greater than 0 and the module state (as returned " +"by :c:func:`PyModule_GetState`) is ``NULL``." msgstr "" msgid "No longer called before the module state is allocated." @@ -307,12 +310,12 @@ msgid "" msgstr "" msgid "" -"There is no requirement for the returned object to be an instance of :c:type:" -"`PyModule_Type`. Any type can be used, as long as it supports setting and " -"getting import-related attributes. However, only ``PyModule_Type`` instances " -"may be returned if the ``PyModuleDef`` has non-``NULL`` ``m_traverse``, " -"``m_clear``, ``m_free``; non-zero ``m_size``; or slots other than " -"``Py_mod_create``." +"There is no requirement for the returned object to be an instance " +"of :c:type:`PyModule_Type`. Any type can be used, as long as it supports " +"setting and getting import-related attributes. However, only " +"``PyModule_Type`` instances may be returned if the ``PyModuleDef`` has non-" +"``NULL`` ``m_traverse``, ``m_clear``, ``m_free``; non-zero ``m_size``; or " +"slots other than ``Py_mod_create``." msgstr "" msgid "" @@ -394,9 +397,9 @@ msgstr "" msgid "" "Create a new module object, given the definition in *def*. This is a macro " -"that calls :c:func:`PyModule_Create2` with *module_api_version* set to :c:" -"macro:`PYTHON_API_VERSION`, or to :c:macro:`PYTHON_ABI_VERSION` if using " -"the :ref:`limited API `." +"that calls :c:func:`PyModule_Create2` with *module_api_version* set " +"to :c:macro:`PYTHON_API_VERSION`, or to :c:macro:`PYTHON_ABI_VERSION` if " +"using the :ref:`limited API `." msgstr "" msgid "" @@ -417,8 +420,9 @@ msgstr "" msgid "" "This macro calls :c:func:`PyModule_FromDefAndSpec2` with " -"*module_api_version* set to :c:macro:`PYTHON_API_VERSION`, or to :c:macro:" -"`PYTHON_ABI_VERSION` if using the :ref:`limited API `." +"*module_api_version* set to :c:macro:`PYTHON_API_VERSION`, or " +"to :c:macro:`PYTHON_ABI_VERSION` if using the :ref:`limited API `." msgstr "" msgid "" @@ -519,17 +523,17 @@ msgstr "" msgid "" "The number of different *name* strings passed to this function should be " "kept small, usually by only using statically allocated strings as *name*. " -"For names that aren't known at compile time, prefer calling :c:func:" -"`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For more " -"details, see :c:func:`PyUnicode_InternFromString`, which may be used " -"internally to create a key object." +"For names that aren't known at compile time, prefer " +"calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` " +"directly. For more details, see :c:func:`PyUnicode_InternFromString`, which " +"may be used internally to create a key object." msgstr "" msgid "" -"Similar to :c:func:`PyModule_AddObjectRef`, but \"steals\" a reference to " -"*value*. It can be called with a result of function that returns a new " -"reference without bothering to check its result or even saving it to a " -"variable." +"Similar to :c:func:`PyModule_AddObjectRef`, but \":term:`steals `\" a " +"reference to *value* (even on error). It can be called with a result of " +"function that returns a new reference without bothering to check its result " +"or even saving it to a variable." msgstr "" msgid "" @@ -539,8 +543,8 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to " -"*value* on success (if it returns ``0``)." +"Similar to :c:func:`PyModule_AddObjectRef`, but :term:`steals ` a " +"reference to *value* on success (if it returns ``0``)." msgstr "" msgid "" @@ -555,8 +559,8 @@ msgid "" msgstr "" msgid "" -"This means that its return value must be checked, and calling code must :c:" -"func:`Py_XDECREF` *value* manually on error." +"This means that its return value must be checked, and calling code " +"must :c:func:`Py_XDECREF` *value* manually on error." msgstr "" msgid "" @@ -579,8 +583,8 @@ msgid "" msgstr "" msgid "" -"This is a convenience function that calls :c:func:`PyLong_FromLong` and :c:" -"func:`PyModule_AddObjectRef`; see their documentation for details." +"This is a convenience function that calls :c:func:`PyLong_FromLong` " +"and :c:func:`PyModule_AddObjectRef`; see their documentation for details." msgstr "" msgid "" @@ -591,9 +595,9 @@ msgid "" msgstr "" msgid "" -"This is a convenience function that calls :c:func:" -"`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; see their " -"documentation for details." +"This is a convenience function that " +"calls :c:func:`PyUnicode_InternFromString` " +"and :c:func:`PyModule_AddObjectRef`; see their documentation for details." msgstr "" msgid "" @@ -647,12 +651,12 @@ msgstr "" msgid "" "Indicate that *module* does or does not support running without the global " "interpreter lock (GIL), using one of the values from :c:macro:`Py_mod_gil`. " -"It must be called during *module*'s initialization function when using :ref:" -"`single-phase-initialization`. If this function is not called during module " -"initialization, the import machinery assumes the module does not support " -"running without the GIL. This function is only available in Python builds " -"configured with :option:`--disable-gil`. Return ``-1`` with an exception set " -"on error, ``0`` on success." +"It must be called during *module*'s initialization function when " +"using :ref:`single-phase-initialization`. If this function is not called " +"during module initialization, the import machinery assumes the module does " +"not support running without the GIL. This function is only available in " +"Python builds configured with :option:`--disable-gil`. Return ``-1`` with an " +"exception set on error, ``0`` on success." msgstr "" msgid "Module lookup (single-phase initialization)" @@ -681,8 +685,8 @@ msgstr "" msgid "" "Attaches the module object passed to the function to the interpreter state. " -"This allows the module object to be accessible via :c:func:" -"`PyState_FindModule`." +"This allows the module object to be accessible " +"via :c:func:`PyState_FindModule`." msgstr "" msgid "Only effective on modules created using single-phase initialization." diff --git a/c-api/monitoring.po b/c-api/monitoring.po index 2224ef37dc..c9cf20546d 100644 --- a/c-api/monitoring.po +++ b/c-api/monitoring.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Marcin Bardź, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Marcin Bardź, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,7 +28,7 @@ msgid "Monitoring C API" msgstr "" msgid "Added in version 3.13." -msgstr "" +msgstr "Dodane w wersji 3.13." msgid "" "An extension may need to interact with the event monitoring system. " @@ -44,10 +45,10 @@ msgid "" "accepts a ``PyMonitoringState`` struct which contains concise information " "about the activation state of events, as well as the event arguments, which " "include a ``PyObject*`` representing the code object, the instruction offset " -"and sometimes additional, event-specific arguments (see :mod:`sys." -"monitoring` for details about the signatures of the different event " -"callbacks). The ``codelike`` argument should be an instance of :class:`types." -"CodeType` or of a type that emulates it." +"and sometimes additional, event-specific arguments " +"(see :mod:`sys.monitoring` for details about the signatures of the different " +"event callbacks). The ``codelike`` argument should be an instance " +"of :class:`types.CodeType` or of a type that emulates it." msgstr "" msgid "" @@ -105,23 +106,23 @@ msgid "Fire a ``C_RETURN`` event." msgstr "" msgid "" -"Fire a ``PY_THROW`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``PY_THROW`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``RAISE`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``RAISE`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``C_RAISE`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``C_RAISE`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``RERAISE`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``RERAISE`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" @@ -130,14 +131,14 @@ msgid "" msgstr "" msgid "" -"Fire a ``PY_UNWIND`` event with the current exception (as returned by :c:" -"func:`PyErr_GetRaisedException`)." +"Fire a ``PY_UNWIND`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``STOP_ITERATION`` event. If ``value`` is an instance of :exc:" -"`StopIteration`, it is used. Otherwise, a new :exc:`StopIteration` instance " -"is created with ``value`` as its argument." +"Fire a ``STOP_ITERATION`` event. If ``value`` is an instance " +"of :exc:`StopIteration`, it is used. Otherwise, a new :exc:`StopIteration` " +"instance is created with ``value`` as its argument." msgstr "" msgid "Managing the Monitoring State" @@ -152,12 +153,12 @@ msgid "" "Enter a monitored scope. ``event_types`` is an array of the event IDs for " "events that may be fired from the scope. For example, the ID of a " "``PY_START`` event is the value ``PY_MONITORING_EVENT_PY_START``, which is " -"numerically equal to the base-2 logarithm of ``sys.monitoring.events." -"PY_START``. ``state_array`` is an array with a monitoring state entry for " -"each event in ``event_types``, it is allocated by the user but populated by :" -"c:func:`!PyMonitoring_EnterScope` with information about the activation " -"state of the event. The size of ``event_types`` (and hence also of " -"``state_array``) is given in ``length``." +"numerically equal to the base-2 logarithm of " +"``sys.monitoring.events.PY_START``. ``state_array`` is an array with a " +"monitoring state entry for each event in ``event_types``, it is allocated by " +"the user but populated by :c:func:`!PyMonitoring_EnterScope` with " +"information about the activation state of the event. The size of " +"``event_types`` (and hence also of ``state_array``) is given in ``length``." msgstr "" msgid "" @@ -240,6 +241,14 @@ msgstr ":monitoring-event:`RERAISE`" msgid ":monitoring-event:`STOP_ITERATION`" msgstr ":monitoring-event:`STOP_ITERATION`" +msgid "" +"Use :c:macro:`PY_MONITORING_EVENT_BRANCH_LEFT` " +"and :c:macro:`PY_MONITORING_EVENT_BRANCH_RIGHT` instead." +msgstr "" + +msgid ":monitoring-event:`BRANCH_LEFT` and :monitoring-event:`BRANCH_RIGHT`" +msgstr "" + msgid "" "Exit the last scope that was entered with :c:func:`!PyMonitoring_EnterScope`." msgstr "" diff --git a/c-api/none.po b/c-api/none.po index c9ebbd0d26..490afc5326 100644 --- a/c-api/none.po +++ b/c-api/none.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/number.po b/c-api/number.po index d56b195aa3..8d79626e7b 100644 --- a/c-api/number.po +++ b/c-api/number.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -226,8 +226,8 @@ msgid "" msgstr "" msgid "" -"Returns the *o* converted to a Python int on success or ``NULL`` with a :exc:" -"`TypeError` exception raised on failure." +"Returns the *o* converted to a Python int on success or ``NULL`` with " +"a :exc:`TypeError` exception raised on failure." msgstr "" msgid "" @@ -239,8 +239,8 @@ msgid "" "Returns the integer *n* converted to base *base* as a string. The *base* " "argument must be one of 2, 8, 10, or 16. For base 2, 8, or 16, the returned " "string is prefixed with a base marker of ``'0b'``, ``'0o'``, or ``'0x'``, " -"respectively. If *n* is not a Python int, it is converted with :c:func:" -"`PyNumber_Index` first." +"respectively. If *n* is not a Python int, it is converted " +"with :c:func:`PyNumber_Index` first." msgstr "" msgid "" @@ -250,12 +250,12 @@ msgid "" msgstr "" msgid "" -"If *o* can be converted to a Python int but the attempt to convert to a :c:" -"type:`Py_ssize_t` value would raise an :exc:`OverflowError`, then the *exc* " -"argument is the type of exception that will be raised (usually :exc:" -"`IndexError` or :exc:`OverflowError`). If *exc* is ``NULL``, then the " -"exception is cleared and the value is clipped to ``PY_SSIZE_T_MIN`` for a " -"negative integer or ``PY_SSIZE_T_MAX`` for a positive integer." +"If *o* can be converted to a Python int but the attempt to convert to " +"a :c:type:`Py_ssize_t` value would raise an :exc:`OverflowError`, then the " +"*exc* argument is the type of exception that will be raised " +"(usually :exc:`IndexError` or :exc:`OverflowError`). If *exc* is ``NULL``, " +"then the exception is cleared and the value is clipped to ``PY_SSIZE_T_MIN`` " +"for a negative integer or ``PY_SSIZE_T_MAX`` for a positive integer." msgstr "" msgid "" diff --git a/c-api/object.po b/c-api/object.po index d08d8f5b14..c0d11e88f6 100644 --- a/c-api/object.po +++ b/c-api/object.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -111,8 +111,8 @@ msgid "" msgstr "" msgid "" -"This function is primarily intended for backwards compatibility: using :c:" -"func:`Py_GetConstant` is recommended for new code." +"This function is primarily intended for backwards compatibility: " +"using :c:func:`Py_GetConstant` is recommended for new code." msgstr "" msgid "" @@ -127,14 +127,15 @@ msgstr "" msgid "" "Properly handle returning :c:data:`Py_NotImplemented` from within a C " -"function (that is, create a new :term:`strong reference` to :const:" -"`NotImplemented` and return it)." +"function (that is, create a new :term:`strong reference` " +"to :const:`NotImplemented` and return it)." msgstr "" msgid "" -"Flag to be used with multiple functions that print the object (like :c:func:" -"`PyObject_Print` and :c:func:`PyFile_WriteObject`). If passed, these " -"functions use the :func:`str` of the object instead of the :func:`repr`." +"Flag to be used with multiple functions that print the object " +"(like :c:func:`PyObject_Print` and :c:func:`PyFile_WriteObject`). If passed, " +"these functions use the :func:`str` of the object instead of " +"the :func:`repr`." msgstr "" msgid "" @@ -162,24 +163,25 @@ msgid "" msgstr "" msgid "" -"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" -"`~object.__getattribute__` methods aren't propagated, but instead given to :" -"func:`sys.unraisablehook`. For proper error handling, use :c:func:" -"`PyObject_HasAttrWithError`, :c:func:`PyObject_GetOptionalAttr` or :c:func:" -"`PyObject_GetAttr` instead." +"Exceptions that occur when this calls :meth:`~object.__getattr__` " +"and :meth:`~object.__getattribute__` methods aren't propagated, but instead " +"given to :func:`sys.unraisablehook`. For proper error handling, " +"use :c:func:`PyObject_HasAttrWithError`, :c:func:`PyObject_GetOptionalAttr` " +"or :c:func:`PyObject_GetAttr` instead." msgstr "" msgid "" "This is the same as :c:func:`PyObject_HasAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" -"`~object.__getattribute__` methods or while creating the temporary :class:" -"`str` object are silently ignored. For proper error handling, use :c:func:" -"`PyObject_HasAttrStringWithError`, :c:func:`PyObject_GetOptionalAttrString` " +"Exceptions that occur when this calls :meth:`~object.__getattr__` " +"and :meth:`~object.__getattribute__` methods or while creating the " +"temporary :class:`str` object are silently ignored. For proper error " +"handling, " +"use :c:func:`PyObject_HasAttrStringWithError`, :c:func:`PyObject_GetOptionalAttrString` " "or :c:func:`PyObject_GetAttrString` instead." msgstr "" @@ -190,32 +192,33 @@ msgid "" msgstr "" msgid "" -"If the missing attribute should not be treated as a failure, you can use :c:" -"func:`PyObject_GetOptionalAttr` instead." +"If the missing attribute should not be treated as a failure, you can " +"use :c:func:`PyObject_GetOptionalAttr` instead." msgstr "" msgid "" "This is the same as :c:func:`PyObject_GetAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"If the missing attribute should not be treated as a failure, you can use :c:" -"func:`PyObject_GetOptionalAttrString` instead." +"If the missing attribute should not be treated as a failure, you can " +"use :c:func:`PyObject_GetOptionalAttrString` instead." msgstr "" msgid "" -"Variant of :c:func:`PyObject_GetAttr` which doesn't raise :exc:" -"`AttributeError` if the attribute is not found." +"Variant of :c:func:`PyObject_GetAttr` which doesn't " +"raise :exc:`AttributeError` if the attribute is not found." msgstr "" msgid "" -"If the attribute is found, return ``1`` and set *\\*result* to a new :term:" -"`strong reference` to the attribute. If the attribute is not found, return " -"``0`` and set *\\*result* to ``NULL``; the :exc:`AttributeError` is " -"silenced. If an error other than :exc:`AttributeError` is raised, return " -"``-1`` and set *\\*result* to ``NULL``." +"If the attribute is found, return ``1`` and set *\\*result* to a " +"new :term:`strong reference` to the attribute. If the attribute is not " +"found, return ``0`` and set *\\*result* to ``NULL``; " +"the :exc:`AttributeError` is silenced. If an error other " +"than :exc:`AttributeError` is raised, return ``-1`` and set *\\*result* to " +"``NULL``." msgstr "" msgid "" @@ -227,10 +230,11 @@ msgstr "" msgid "" "Generic attribute getter function that is meant to be put into a type " "object's ``tp_getattro`` slot. It looks for a descriptor in the dictionary " -"of classes in the object's MRO as well as an attribute in the object's :attr:" -"`~object.__dict__` (if present). As outlined in :ref:`descriptors`, data " -"descriptors take preference over instance attributes, while non-data " -"descriptors don't. Otherwise, an :exc:`AttributeError` is raised." +"of classes in the object's MRO as well as an attribute in the " +"object's :attr:`~object.__dict__` (if present). As outlined " +"in :ref:`descriptors`, data descriptors take preference over instance " +"attributes, while non-data descriptors don't. Otherwise, " +"an :exc:`AttributeError` is raised." msgstr "" msgid "" @@ -247,8 +251,8 @@ msgstr "" msgid "" "This is the same as :c:func:`PyObject_SetAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -259,10 +263,10 @@ msgstr "" msgid "" "The number of different attribute names passed to this function should be " "kept small, usually by using a statically allocated string as *attr_name*. " -"For attribute names that aren't known at compile time, prefer calling :c:" -"func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For " -"more details, see :c:func:`PyUnicode_InternFromString`, which may be used " -"internally to create a key object." +"For attribute names that aren't known at compile time, prefer " +"calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` " +"directly. For more details, see :c:func:`PyUnicode_InternFromString`, which " +"may be used internally to create a key object." msgstr "" msgid "" @@ -283,17 +287,17 @@ msgstr "" msgid "" "This is the same as :c:func:`PyObject_DelAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" "The number of different attribute names passed to this function should be " "kept small, usually by using a statically allocated string as *attr_name*. " -"For attribute names that aren't known at compile time, prefer calling :c:" -"func:`PyUnicode_FromString` and :c:func:`PyObject_DelAttr` directly. For " -"more details, see :c:func:`PyUnicode_InternFromString`, which may be used " -"internally to create a key object for lookup." +"For attribute names that aren't known at compile time, prefer " +"calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_DelAttr` " +"directly. For more details, see :c:func:`PyUnicode_InternFromString`, which " +"may be used internally to create a key object for lookup." msgstr "" msgid "" @@ -330,12 +334,12 @@ msgstr "" msgid "" "Compare the values of *o1* and *o2* using the operation specified by *opid*, " -"which must be one of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :" -"c:macro:`Py_NE`, :c:macro:`Py_GT`, or :c:macro:`Py_GE`, corresponding to " -"``<``, ``<=``, ``==``, ``!=``, ``>``, or ``>=`` respectively. This is the " -"equivalent of the Python expression ``o1 op o2``, where ``op`` is the " -"operator corresponding to *opid*. Returns the value of the comparison on " -"success, or ``NULL`` on failure." +"which must be one " +"of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_GT`, " +"or :c:macro:`Py_GE`, corresponding to ``<``, ``<=``, ``==``, ``!=``, ``>``, " +"or ``>=`` respectively. This is the equivalent of the Python expression ``o1 " +"op o2``, where ``op`` is the operator corresponding to *opid*. Returns the " +"value of the comparison on success, or ``NULL`` on failure." msgstr "" msgid "" @@ -377,10 +381,10 @@ msgstr "" msgid "" "As :c:func:`PyObject_Repr`, compute a string representation of object *o*, " -"but escape the non-ASCII characters in the string returned by :c:func:" -"`PyObject_Repr` with ``\\x``, ``\\u`` or ``\\U`` escapes. This generates a " -"string similar to that returned by :c:func:`PyObject_Repr` in Python 2. " -"Called by the :func:`ascii` built-in function." +"but escape the non-ASCII characters in the string returned " +"by :c:func:`PyObject_Repr` with ``\\x``, ``\\u`` or ``\\U`` escapes. This " +"generates a string similar to that returned by :c:func:`PyObject_Repr` in " +"Python 2. Called by the :func:`ascii` built-in function." msgstr "" msgid "" @@ -416,8 +420,8 @@ msgstr "" msgid "" "If *cls* has a :meth:`~type.__subclasscheck__` method, it will be called to " "determine the subclass status as described in :pep:`3119`. Otherwise, " -"*derived* is a subclass of *cls* if it is a direct or indirect subclass, i." -"e. contained in :attr:`cls.__mro__ `." +"*derived* is a subclass of *cls* if it is a direct or indirect subclass, " +"i.e. contained in :attr:`cls.__mro__ `." msgstr "" msgid "" @@ -438,8 +442,8 @@ msgid "" msgstr "" msgid "" -"An instance *inst* can override what is considered its class by having a :" -"attr:`~object.__class__` attribute." +"An instance *inst* can override what is considered its class by having " +"a :attr:`~object.__class__` attribute." msgstr "" msgid "" @@ -524,9 +528,9 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -534,8 +538,8 @@ msgid "" "(possibly empty) list of strings appropriate for the object argument, or " "``NULL`` if there was an error. If the argument is ``NULL``, this is like " "the Python ``dir()``, returning the names of the current locals; in this " -"case, if no execution frame is active then ``NULL`` is returned but :c:func:" -"`PyErr_Occurred` will return false." +"case, if no execution frame is active then ``NULL`` is returned " +"but :c:func:`PyErr_Occurred` will return false." msgstr "" msgid "" @@ -547,16 +551,16 @@ msgstr "" msgid "" "This is equivalent to the Python ``__iter__(self): return self`` method. It " -"is intended for :term:`iterator` types, to be used in the :c:member:" -"`PyTypeObject.tp_iter` slot." +"is intended for :term:`iterator` types, to be used in " +"the :c:member:`PyTypeObject.tp_iter` slot." msgstr "" msgid "" -"This is the equivalent to the Python expression ``aiter(o)``. Takes an :" -"class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. " -"This is typically a new iterator but if the argument is an :class:" -"`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and returns " -"``NULL`` if the object cannot be iterated." +"This is the equivalent to the Python expression ``aiter(o)``. Takes " +"an :class:`AsyncIterable` object and returns an :class:`AsyncIterator` for " +"it. This is typically a new iterator but if the argument is " +"an :class:`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and " +"returns ``NULL`` if the object cannot be iterated." msgstr "" msgid "Get a pointer to subclass-specific data reserved for *cls*." @@ -578,21 +582,21 @@ msgstr "" msgid "" "This may be larger than requested using :c:member:`-PyType_Spec.basicsize " -"`; it is safe to use this larger size (e.g. with :c:" -"func:`!memset`)." +"`; it is safe to use this larger size (e.g. " +"with :c:func:`!memset`)." msgstr "" msgid "" -"The type *cls* **must** have been created using negative :c:member:" -"`PyType_Spec.basicsize`. Python does not check this." +"The type *cls* **must** have been created using " +"negative :c:member:`PyType_Spec.basicsize`. Python does not check this." msgstr "" msgid "On error, set an exception and return a negative value." msgstr "" msgid "" -"Get a pointer to per-item data for a class with :c:macro:" -"`Py_TPFLAGS_ITEMS_AT_END`." +"Get a pointer to per-item data for a class " +"with :c:macro:`Py_TPFLAGS_ITEMS_AT_END`." msgstr "" msgid "" @@ -643,8 +647,8 @@ msgstr "" msgid "" "This function is intended to be used soon after *obj* is created, by the " -"code that creates it, such as in the object's :c:member:`~PyTypeObject." -"tp_new` slot." +"code that creates it, such as in the " +"object's :c:member:`~PyTypeObject.tp_new` slot." msgstr "" msgid "" @@ -659,10 +663,10 @@ msgid "" "has the only reference to the object. For arguments to C functions, this " "should be used instead of checking if the reference count is ``1``. Starting " "with Python 3.14, the interpreter internally avoids some reference count " -"modifications when loading objects onto the operands stack by :term:" -"`borrowing ` references when possible, which means that " -"a reference count of ``1`` by itself does not guarantee that a function " -"argument uniquely referenced." +"modifications when loading objects onto the operands stack " +"by :term:`borrowing ` references when possible, which " +"means that a reference count of ``1`` by itself does not guarantee that a " +"function argument uniquely referenced." msgstr "" msgid "" diff --git a/c-api/perfmaps.po b/c-api/perfmaps.po new file mode 100644 index 0000000000..54baaa978d --- /dev/null +++ b/c-api/perfmaps.po @@ -0,0 +1,141 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: python-doc bot, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Support for Perf Maps" +msgstr "" + +msgid "" +"On supported platforms (as of this writing, only Linux), the runtime can " +"take advantage of *perf map files* to make Python functions visible to an " +"external profiling tool (such as `perf `_). A running process may create a file in the ``/tmp`` " +"directory, which contains entries that can map a section of executable code " +"to a name. This interface is described in the `documentation of the Linux " +"Perf tool `_." +msgstr "" + +msgid "" +"In Python, these helper APIs can be used by libraries and features that rely " +"on generating machine code on the fly." +msgstr "" + +msgid "" +"Note that holding an :term:`attached thread state` is not required for these " +"APIs." +msgstr "" + +msgid "" +"Open the ``/tmp/perf-$pid.map`` file, unless it's already opened, and create " +"a lock to ensure thread-safe writes to the file (provided the writes are " +"done through :c:func:`PyUnstable_WritePerfMapEntry`). Normally, there's no " +"need to call this explicitly; just " +"use :c:func:`PyUnstable_WritePerfMapEntry` and it will initialize the state " +"on first call." +msgstr "" + +msgid "" +"Returns ``0`` on success, ``-1`` on failure to create/open the perf map " +"file, or ``-2`` on failure to create a lock. Check ``errno`` for more " +"information about the cause of a failure." +msgstr "" + +msgid "" +"Write one single entry to the ``/tmp/perf-$pid.map`` file. This function is " +"thread safe. Here is what an example entry looks like::" +msgstr "" + +msgid "" +"# address size name\n" +"7f3529fcf759 b py::bar:/run/t.py" +msgstr "" + +msgid "" +"Will call :c:func:`PyUnstable_PerfMapState_Init` before writing the entry, " +"if the perf map file is not already opened. Returns ``0`` on success, or the " +"same error codes as :c:func:`PyUnstable_PerfMapState_Init` on failure." +msgstr "" + +msgid "" +"Close the perf map file opened by :c:func:`PyUnstable_PerfMapState_Init`. " +"This is called by the runtime itself during interpreter shut-down. In " +"general, there shouldn't be a reason to explicitly call this, except to " +"handle specific scenarios such as forking." +msgstr "" + +msgid "" +"Open the ``/tmp/perf-$pid.map`` file and append the content of " +"*parent_filename* to it." +msgstr "" + +msgid "" +"This function is available on all platforms but only generates output on " +"platforms that support perf maps (currently only Linux). On other platforms, " +"it does nothing." +msgstr "" + +msgid "Compile the given code object using the current perf trampoline." +msgstr "" + +msgid "" +"The \"current\" trampoline is the one set by the runtime or the most " +"recent :c:func:`PyUnstable_PerfTrampoline_SetPersistAfterFork` call." +msgstr "" + +msgid "" +"If no trampoline is set, falls back to normal compilation (no perf map " +"entry)." +msgstr "" + +msgid "Parameters" +msgstr "parametry" + +msgid "The code object to compile." +msgstr "" + +msgid "Returns" +msgstr "Zwraca" + +msgid "0 on success, -1 on failure." +msgstr "" + +msgid "Set whether the perf trampoline should persist after a fork." +msgstr "" + +msgid "" +"If ``enable`` is true (non-zero): perf map file remains open/valid post-" +"fork. Child process inherits all existing perf map entries." +msgstr "" + +msgid "" +"If ``enable`` is false (zero): perf map closes post-fork. Child process gets " +"empty perf map." +msgstr "" + +msgid "Default: false (clears on fork)." +msgstr "" + +msgid "1 to enable, 0 to disable." +msgstr "" diff --git a/c-api/picklebuffer.po b/c-api/picklebuffer.po index 22fa44c82b..5c8c87bae2 100644 --- a/c-api/picklebuffer.po +++ b/c-api/picklebuffer.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-11-17 14:16+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -65,8 +65,9 @@ msgstr "" msgid "" "The returned pointer is valid as long as *picklebuf* is alive and has not " -"been released. The caller must not modify or free the returned :c:type:" -"`Py_buffer`. If the pickle buffer has been released, raise :exc:`ValueError`." +"been released. The caller must not modify or free the " +"returned :c:type:`Py_buffer`. If the pickle buffer has been released, " +"raise :exc:`ValueError`." msgstr "" msgid "" diff --git a/c-api/profiling.po b/c-api/profiling.po index 3430ed3da8..8f4dbe20eb 100644 --- a/c-api/profiling.po +++ b/c-api/profiling.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2026-02-25 14:46+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,11 +45,9 @@ msgid "" "The type of the trace function registered using :c:func:`PyEval_SetProfile` " "and :c:func:`PyEval_SetTrace`. The first parameter is the object passed to " "the registration function as *obj*, *frame* is the frame object to which the " -"event pertains, *what* is one of the constants :c:data:`PyTrace_CALL`, :c:" -"data:`PyTrace_EXCEPTION`, :c:data:`PyTrace_LINE`, :c:data:`PyTrace_RETURN`, :" -"c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION`, :c:data:" -"`PyTrace_C_RETURN`, or :c:data:`PyTrace_OPCODE`, and *arg* depends on the " -"value of *what*:" +"event pertains, *what* is one of the " +"constants :c:data:`PyTrace_CALL`, :c:data:`PyTrace_EXCEPTION`, :c:data:`PyTrace_LINE`, :c:data:`PyTrace_RETURN`, :c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION`, :c:data:`PyTrace_C_RETURN`, " +"or :c:data:`PyTrace_OPCODE`, and *arg* depends on the value of *what*:" msgstr "" msgid "Value of *what*" @@ -117,8 +115,8 @@ msgstr "" msgid "" "The value passed as the *what* parameter to a :c:type:`Py_tracefunc` " "function (but not a profiling function) when a line-number event is being " -"reported. It may be disabled for a frame by setting :attr:`~frame." -"f_trace_lines` to *0* on that frame." +"reported. It may be disabled for a frame by " +"setting :attr:`~frame.f_trace_lines` to *0* on that frame." msgstr "" msgid "" @@ -144,8 +142,8 @@ msgstr "" msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions (but " "not profiling functions) when a new opcode is about to be executed. This " -"event is not emitted by default: it must be explicitly requested by setting :" -"attr:`~frame.f_trace_opcodes` to *1* on the frame." +"event is not emitted by default: it must be explicitly requested by " +"setting :attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" msgid "" @@ -153,8 +151,9 @@ msgid "" "function as its first parameter, and may be any Python object, or ``NULL``. " "If the profile function needs to maintain state, using a different value for " "*obj* for each thread provides a convenient and thread-safe place to store " -"it. The profile function is called for all monitored events except :c:data:" -"`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`." +"it. The profile function is called for all monitored events " +"except :c:data:`PyTrace_LINE` :c:data:`PyTrace_OPCODE` " +"and :c:data:`PyTrace_EXCEPTION`." msgstr "" msgid "See also the :func:`sys.setprofile` function." @@ -175,13 +174,13 @@ msgid "" msgstr "" msgid "" -"Set the tracing function to *func*. This is similar to :c:func:" -"`PyEval_SetProfile`, except the tracing function does receive line-number " -"events and per-opcode events, but does not receive any event related to C " -"function objects being called. Any trace function registered using :c:func:" -"`PyEval_SetTrace` will not receive :c:data:`PyTrace_C_CALL`, :c:data:" -"`PyTrace_C_EXCEPTION` or :c:data:`PyTrace_C_RETURN` as a value for the " -"*what* parameter." +"Set the tracing function to *func*. This is similar " +"to :c:func:`PyEval_SetProfile`, except the tracing function does receive " +"line-number events and per-opcode events, but does not receive any event " +"related to C function objects being called. Any trace function registered " +"using :c:func:`PyEval_SetTrace` will not " +"receive :c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION` " +"or :c:data:`PyTrace_C_RETURN` as a value for the *what* parameter." msgstr "" msgid "See also the :func:`sys.settrace` function." @@ -202,12 +201,12 @@ msgid "Reference tracing" msgstr "" msgid "" -"The type of the trace function registered using :c:func:" -"`PyRefTracer_SetTracer`. The first parameter is a Python object that has " -"been just created (when **event** is set to :c:data:`PyRefTracer_CREATE`) or " -"about to be destroyed (when **event** is set to :c:data:" -"`PyRefTracer_DESTROY`). The **data** argument is the opaque pointer that was " -"provided when :c:func:`PyRefTracer_SetTracer` was called." +"The type of the trace function registered " +"using :c:func:`PyRefTracer_SetTracer`. The first parameter is a Python " +"object that has been just created (when **event** is set " +"to :c:data:`PyRefTracer_CREATE`) or about to be destroyed (when **event** is " +"set to :c:data:`PyRefTracer_DESTROY`). The **data** argument is the opaque " +"pointer that was provided when :c:func:`PyRefTracer_SetTracer` was called." msgstr "" msgid "" @@ -263,3 +262,17 @@ msgid "" "called. If no tracer was registered this function will return NULL and will " "set the **data** pointer to NULL." msgstr "" + +msgid "Performance statistics" +msgstr "" + +msgid "" +"Largest micro-operation identifier for which CPython allocates performance " +"statistics counters. Available only in builds configured with :option:`--" +"enable-pystats`." +msgstr "" + +msgid "" +"This constant is intended for internal use only and is not useful to " +"extension modules." +msgstr "" diff --git a/c-api/refcounting.po b/c-api/refcounting.po index 5828c6a315..304d2de621 100644 --- a/c-api/refcounting.po +++ b/c-api/refcounting.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,10 +36,10 @@ msgstr "" msgid "" "Note that the returned value may not actually reflect how many references to " -"the object are actually held. For example, some objects are :term:" -"`immortal` and have a very high refcount that does not reflect the actual " -"number of references. Consequently, do not rely on the returned value to be " -"accurate, other than a value of 0 or 1." +"the object are actually held. For example, some objects " +"are :term:`immortal` and have a very high refcount that does not reflect the " +"actual number of references. Consequently, do not rely on the returned " +"value to be accurate, other than a value of 0 or 1." msgstr "" msgid "" @@ -54,8 +54,8 @@ msgid "" msgstr "" msgid "" -"See also the function :c:func:" -"`PyUnstable_Object_IsUniqueReferencedTemporary()`." +"See also the " +"function :c:func:`PyUnstable_Object_IsUniqueReferencedTemporary()`." msgstr "" msgid ":c:func:`Py_REFCNT()` is changed to the inline static function." @@ -84,8 +84,8 @@ msgid "" msgstr "" msgid "" -"This function is usually used to convert a :term:`borrowed reference` to a :" -"term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be " +"This function is usually used to convert a :term:`borrowed reference` to " +"a :term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be " "used to create a new :term:`strong reference`." msgstr "" @@ -98,8 +98,8 @@ msgid "" msgstr "" msgid "" -"Do not expect this function to actually modify *o* in any way. For at least :" -"pep:`some objects <0683>`, this function has no effect." +"Do not expect this function to actually modify *o* in any way. For at " +"least :pep:`some objects <0683>`, this function has no effect." msgstr "" msgid "" @@ -170,13 +170,13 @@ msgid "" msgstr "" msgid "" -"Do not expect this function to actually modify *o* in any way. For at least :" -"pep:`some objects <683>`, this function has no effect." +"Do not expect this function to actually modify *o* in any way. For at " +"least :pep:`some objects <683>`, this function has no effect." msgstr "" msgid "" -"The deallocation function can cause arbitrary Python code to be invoked (e." -"g. when a class instance with a :meth:`~object.__del__` method is " +"The deallocation function can cause arbitrary Python code to be invoked " +"(e.g. when a class instance with a :meth:`~object.__del__` method is " "deallocated). While exceptions in such code are not propagated, the " "executed code has free access to all Python global variables. This means " "that any object that is reachable from a global variable should be in a " @@ -218,8 +218,9 @@ msgid "" msgstr "" msgid "" -"Release a :term:`strong reference` to object *o*. A function version of :c:" -"func:`Py_XDECREF`. It can be used for runtime dynamic embedding of Python." +"Release a :term:`strong reference` to object *o*. A function version " +"of :c:func:`Py_XDECREF`. It can be used for runtime dynamic embedding of " +"Python." msgstr "" msgid "" diff --git a/c-api/reflection.po b/c-api/reflection.po index 688f5fdd04..92f7b975e3 100644 --- a/c-api/reflection.po +++ b/c-api/reflection.po @@ -57,6 +57,6 @@ msgstr "" msgid "" "Return a description string, depending on the type of *func*. Return values " "include \"()\" for functions and methods, \" constructor\", \" instance\", " -"and \" object\". Concatenated with the result of :c:func:" -"`PyEval_GetFuncName`, the result will be a description of *func*." +"and \" object\". Concatenated with the result " +"of :c:func:`PyEval_GetFuncName`, the result will be a description of *func*." msgstr "" diff --git a/c-api/sequence.po b/c-api/sequence.po index c41182d4ad..82e0494b3c 100644 --- a/c-api/sequence.po +++ b/c-api/sequence.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,10 +28,10 @@ msgstr "" msgid "" "Return ``1`` if the object provides the sequence protocol, and ``0`` " -"otherwise. Note that it returns ``1`` for Python classes with a :meth:" -"`~object.__getitem__` method, unless they are :class:`dict` subclasses, " -"since in general it is impossible to determine what type of keys the class " -"supports. This function always succeeds." +"otherwise. Note that it returns ``1`` for Python classes with " +"a :meth:`~object.__getitem__` method, unless they are :class:`dict` " +"subclasses, since in general it is impossible to determine what type of keys " +"the class supports. This function always succeeds." msgstr "" msgid "" @@ -75,8 +75,8 @@ msgstr "" msgid "" "Assign object *v* to the *i*\\ th element of *o*. Raise an exception and " "return ``-1`` on failure; return ``0`` on success. This is the equivalent " -"of the Python statement ``o[i] = v``. This function *does not* steal a " -"reference to *v*." +"of the Python statement ``o[i] = v``. This function *does not* " +"\":term:`steal`\" a reference to *v*." msgstr "" msgid "" @@ -154,16 +154,17 @@ msgid "" msgstr "" msgid "" -"Returns the length of *o*, assuming that *o* was returned by :c:func:" -"`PySequence_Fast` and that *o* is not ``NULL``. The size can also be " -"retrieved by calling :c:func:`PySequence_Size` on *o*, but :c:func:" -"`PySequence_Fast_GET_SIZE` is faster because it can assume *o* is a list or " -"tuple." +"Returns the length of *o*, assuming that *o* was returned " +"by :c:func:`PySequence_Fast` and that *o* is not ``NULL``. The size can " +"also be retrieved by calling :c:func:`PySequence_Size` on *o*, " +"but :c:func:`PySequence_Fast_GET_SIZE` is faster because it can assume *o* " +"is a list or tuple." msgstr "" msgid "" -"Return the *i*\\ th element of *o*, assuming that *o* was returned by :c:" -"func:`PySequence_Fast`, *o* is not ``NULL``, and that *i* is within bounds." +"Return the *i*\\ th element of *o*, assuming that *o* was returned " +"by :c:func:`PySequence_Fast`, *o* is not ``NULL``, and that *i* is within " +"bounds." msgstr "" msgid "" @@ -178,10 +179,10 @@ msgid "" msgstr "" msgid "" -"Return the *i*\\ th element of *o* or ``NULL`` on failure. Faster form of :c:" -"func:`PySequence_GetItem` but without checking that :c:func:" -"`PySequence_Check` on *o* is true and without adjustment for negative " -"indices." +"Return the *i*\\ th element of *o* or ``NULL`` on failure. Faster form " +"of :c:func:`PySequence_GetItem` but without checking " +"that :c:func:`PySequence_Check` on *o* is true and without adjustment for " +"negative indices." msgstr "" msgid "built-in function" diff --git a/c-api/set.po b/c-api/set.po index e26e784077..664efb0d70 100644 --- a/c-api/set.po +++ b/c-api/set.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,35 +29,32 @@ msgstr "" msgid "" "This section details the public API for :class:`set` and :class:`frozenset` " "objects. Any functionality not listed below is best accessed using either " -"the abstract object protocol (including :c:func:`PyObject_CallMethod`, :c:" -"func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:" -"`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, and :c:" -"func:`PyObject_GetIter`) or the abstract number protocol (including :c:func:" -"`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:" -"`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:" -"`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:" -"`PyNumber_InPlaceXor`)." +"the abstract object protocol " +"(including :c:func:`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, " +"and :c:func:`PyObject_GetIter`) or the abstract number protocol " +"(including :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, " +"and :c:func:`PyNumber_InPlaceXor`)." msgstr "" msgid "" "This subtype of :c:type:`PyObject` is used to hold the internal data for " -"both :class:`set` and :class:`frozenset` objects. It is like a :c:type:" -"`PyDictObject` in that it is a fixed size for small sets (much like tuple " -"storage) and will point to a separate, variable sized block of memory for " -"medium and large sized sets (much like list storage). None of the fields of " -"this structure should be considered public and all are subject to change. " -"All access should be done through the documented API rather than by " +"both :class:`set` and :class:`frozenset` objects. It is like " +"a :c:type:`PyDictObject` in that it is a fixed size for small sets (much " +"like tuple storage) and will point to a separate, variable sized block of " +"memory for medium and large sized sets (much like list storage). None of the " +"fields of this structure should be considered public and all are subject to " +"change. All access should be done through the documented API rather than by " "manipulating the values in the structure." msgstr "" msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :class:" -"`set` type." +"This is an instance of :c:type:`PyTypeObject` representing the " +"Python :class:`set` type." msgstr "" msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :class:" -"`frozenset` type." +"This is an instance of :c:type:`PyTypeObject` representing the " +"Python :class:`frozenset` type." msgstr "" msgid "" @@ -111,19 +108,19 @@ msgstr "" msgid "" "Return a new :class:`frozenset` containing objects returned by the " "*iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset. " -"Return the new set on success or ``NULL`` on failure. Raise :exc:" -"`TypeError` if *iterable* is not actually iterable." +"Return the new set on success or ``NULL`` on failure. " +"Raise :exc:`TypeError` if *iterable* is not actually iterable." msgstr "" msgid "" -"The following functions and macros are available for instances of :class:" -"`set` or :class:`frozenset` or instances of their subtypes." +"The following functions and macros are available for instances " +"of :class:`set` or :class:`frozenset` or instances of their subtypes." msgstr "" msgid "" "Return the length of a :class:`set` or :class:`frozenset` object. Equivalent " -"to ``len(anyset)``. Raises a :exc:`SystemError` if *anyset* is not a :class:" -"`set`, :class:`frozenset`, or an instance of a subtype." +"to ``len(anyset)``. Raises a :exc:`SystemError` if *anyset* is not " +"a :class:`set`, :class:`frozenset`, or an instance of a subtype." msgstr "" msgid "Macro form of :c:func:`PySet_Size` without error checking." @@ -133,15 +130,15 @@ msgid "" "Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is " "encountered. Unlike the Python :meth:`~object.__contains__` method, this " "function does not automatically convert unhashable sets into temporary " -"frozensets. Raise a :exc:`TypeError` if the *key* is unhashable. Raise :exc:" -"`SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, or an " -"instance of a subtype." +"frozensets. Raise a :exc:`TypeError` if the *key* is unhashable. " +"Raise :exc:`SystemError` if *anyset* is not " +"a :class:`set`, :class:`frozenset`, or an instance of a subtype." msgstr "" msgid "" "The operation is atomic on :term:`free threading ` when " -"*key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` or :class:" -"`bytes`." +"*key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` " +"or :class:`bytes`." msgstr "" msgid "" @@ -150,8 +147,8 @@ msgid "" "values of brand new frozensets before they are exposed to other code). " "Return ``0`` on success or ``-1`` on failure. Raise a :exc:`TypeError` if " "the *key* is unhashable. Raise a :exc:`MemoryError` if there is no room to " -"grow. Raise a :exc:`SystemError` if *set* is not an instance of :class:" -"`set` or its subtype." +"grow. Raise a :exc:`SystemError` if *set* is not an instance " +"of :class:`set` or its subtype." msgstr "" msgid "" @@ -177,8 +174,8 @@ msgstr "" msgid "" "Empty an existing set of all elements. Return ``0`` on success. Return " -"``-1`` and raise :exc:`SystemError` if *set* is not an instance of :class:" -"`set` or its subtype." +"``-1`` and raise :exc:`SystemError` if *set* is not an instance " +"of :class:`set` or its subtype." msgstr "" msgid "" @@ -191,8 +188,8 @@ msgid "Deprecated API" msgstr "" msgid "" -"A :term:`soft deprecated` constant representing the size of an internal " -"preallocated table inside :c:type:`PySetObject` instances." +"A constant representing the size of an internal preallocated table " +"inside :c:type:`PySetObject` instances." msgstr "" msgid "" diff --git a/c-api/slice.po b/c-api/slice.po index 2fe40cb5ef..26dc7cd8fe 100644 --- a/c-api/slice.po +++ b/c-api/slice.po @@ -76,8 +76,8 @@ msgstr "" msgid "" "This function is considered not safe for resizable sequences. Its invocation " -"should be replaced by a combination of :c:func:`PySlice_Unpack` and :c:func:" -"`PySlice_AdjustIndices` where ::" +"should be replaced by a combination of :c:func:`PySlice_Unpack` " +"and :c:func:`PySlice_AdjustIndices` where ::" msgstr "" msgid "is replaced by ::" @@ -124,6 +124,6 @@ msgstr "" msgid "" "The Python ``Ellipsis`` object. This object has no methods. It needs to be " -"treated just like any other object with respect to reference counts. Like :" -"c:data:`Py_None` it is a singleton object." +"treated just like any other object with respect to reference counts. " +"Like :c:data:`Py_None` it is a singleton object." msgstr "" diff --git a/c-api/stable.po b/c-api/stable.po index a6f75af847..d45cf3077f 100644 --- a/c-api/stable.po +++ b/c-api/stable.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,10 +35,10 @@ msgstr "" msgid "" "CPython's Application Binary Interface (ABI) is forward- and backwards-" -"compatible across a minor release (if these are compiled the same way; see :" -"ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will " -"work on 3.10.8 and vice versa, but will need to be compiled separately for " -"3.9.x and 3.11.x." +"compatible across a minor release (if these are compiled the same way; " +"see :ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 " +"will work on 3.10.8 and vice versa, but will need to be compiled separately " +"for 3.9.x and 3.11.x." msgstr "" msgid "There are two tiers of C API with different stability expectations:" @@ -61,9 +61,9 @@ msgstr "" msgid "" "Names prefixed by an underscore, such as ``_Py_InternalState``, are private " "API that can change without notice even in patch releases. If you need to " -"use this API, consider reaching out to `CPython developers `_ to discuss adding public API for your use " -"case." +"use this API, consider reaching out to `CPython developers `_ to discuss adding public API for " +"your use case." msgstr "" msgid "Unstable C API" @@ -151,8 +151,8 @@ msgstr "" msgid "" "On Windows, extensions that use the Stable ABI should be linked against " -"``python3.dll`` rather than a version-specific library such as ``python39." -"dll``." +"``python3.dll`` rather than a version-specific library such as " +"``python39.dll``." msgstr "" msgid "" @@ -204,9 +204,10 @@ msgstr "" msgid "" "Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee " -"that code conforms to the :ref:`Limited API ` or the :ref:" -"`Stable ABI `. ``Py_LIMITED_API`` only covers definitions, but " -"an API also includes other issues, such as expected semantics." +"that code conforms to the :ref:`Limited API ` or " +"the :ref:`Stable ABI `. ``Py_LIMITED_API`` only covers " +"definitions, but an API also includes other issues, such as expected " +"semantics." msgstr "" msgid "" @@ -248,9 +249,9 @@ msgstr "" msgid "" "ABI stability depends not only on Python, but also on the compiler used, " -"lower-level libraries and compiler options. For the purposes of the :ref:" -"`Stable ABI `, these details define a “platform”. They usually " -"depend on the OS type and processor architecture" +"lower-level libraries and compiler options. For the purposes of " +"the :ref:`Stable ABI `, these details define a “platform”. They " +"usually depend on the OS type and processor architecture" msgstr "" msgid "" diff --git a/c-api/structures.po b/c-api/structures.po index a8362c9890..229e9b64ee 100644 --- a/c-api/structures.po +++ b/c-api/structures.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -57,8 +57,8 @@ msgid "" msgstr "" msgid "" -"The members must not be accessed directly; instead use macros such as :c:" -"macro:`Py_REFCNT` and :c:macro:`Py_TYPE`." +"The members must not be accessed directly; instead use macros such " +"as :c:macro:`Py_REFCNT` and :c:macro:`Py_TYPE`." msgstr "" msgid "" @@ -78,15 +78,15 @@ msgid "" msgstr "" msgid "" -"An extension of :c:type:`PyObject` that adds the :c:member:`~PyVarObject." -"ob_size` field. This is intended for objects that have some notion of " -"*length*." +"An extension of :c:type:`PyObject` that adds " +"the :c:member:`~PyVarObject.ob_size` field. This is intended for objects " +"that have some notion of *length*." msgstr "" msgid "" "As with :c:type:`!PyObject`, the members must not be accessed directly; " -"instead use macros such as :c:macro:`Py_SIZE`, :c:macro:`Py_REFCNT` and :c:" -"macro:`Py_TYPE`." +"instead use macros such as :c:macro:`Py_SIZE`, :c:macro:`Py_REFCNT` " +"and :c:macro:`Py_TYPE`." msgstr "" msgid "" @@ -100,8 +100,8 @@ msgstr "" msgid "" "Object creation functions such as :c:func:`PyObject_NewVar` will generally " "set this field to the requested size (number of items). After creation, " -"arbitrary values can be stored in :c:member:`!ob_size` using :c:macro:" -"`Py_SET_SIZE`." +"arbitrary values can be stored in :c:member:`!ob_size` " +"using :c:macro:`Py_SET_SIZE`." msgstr "" msgid "" @@ -206,8 +206,8 @@ msgid "Set the :c:member:`~PyVarObject.ob_size` field of *o* to *size*." msgstr "" msgid "" -"This is a macro which expands to initialization values for a new :c:type:" -"`PyObject` type. This macro expands to::" +"This is a macro which expands to initialization values for a " +"new :c:type:`PyObject` type. This macro expands to::" msgstr "" msgid "" @@ -216,9 +216,9 @@ msgid "" msgstr "" msgid "" -"This is a macro which expands to initialization values for a new :c:type:" -"`PyVarObject` type, including the :c:member:`~PyVarObject.ob_size` field. " -"This macro expands to::" +"This is a macro which expands to initialization values for a " +"new :c:type:`PyVarObject` type, including " +"the :c:member:`~PyVarObject.ob_size` field. This macro expands to::" msgstr "" msgid "" @@ -332,20 +332,21 @@ msgid "There are these calling conventions:" msgstr "" msgid "" -"This is the typical calling convention, where the methods have the type :c:" -"type:`PyCFunction`. The function expects two :c:expr:`PyObject*` values. The " -"first one is the *self* object for methods; for module functions, it is the " -"module object. The second parameter (often called *args*) is a tuple object " -"representing all arguments. This parameter is typically processed using :c:" -"func:`PyArg_ParseTuple` or :c:func:`PyArg_UnpackTuple`." +"This is the typical calling convention, where the methods have the " +"type :c:type:`PyCFunction`. The function expects two :c:expr:`PyObject*` " +"values. The first one is the *self* object for methods; for module " +"functions, it is the module object. The second parameter (often called " +"*args*) is a tuple object representing all arguments. This parameter is " +"typically processed using :c:func:`PyArg_ParseTuple` " +"or :c:func:`PyArg_UnpackTuple`." msgstr "" msgid "" -"Can only be used in certain combinations with other flags: :ref:" -"`METH_VARARGS | METH_KEYWORDS `, :ref:" -"`METH_FASTCALL | METH_KEYWORDS ` and :ref:" -"`METH_METHOD | METH_FASTCALL | METH_KEYWORDS `." +"Can only be used in certain combinations with other " +"flags: :ref:`METH_VARARGS | METH_KEYWORDS `, :ref:`METH_FASTCALL | METH_KEYWORDS ` and :ref:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS " +"`." msgstr "" msgid ":c:expr:`METH_VARARGS | METH_KEYWORDS`" @@ -414,15 +415,15 @@ msgid "" msgstr "" msgid "" -"The function must have 2 parameters. Since the second parameter is unused, :" -"c:macro:`Py_UNUSED` can be used to prevent a compiler warning." +"The function must have 2 parameters. Since the second parameter is " +"unused, :c:macro:`Py_UNUSED` can be used to prevent a compiler warning." msgstr "" msgid "" -"Methods with a single object argument can be listed with the :c:macro:" -"`METH_O` flag, instead of invoking :c:func:`PyArg_ParseTuple` with a " -"``\"O\"`` argument. They have the type :c:type:`PyCFunction`, with the " -"*self* parameter, and a :c:expr:`PyObject*` parameter representing the " +"Methods with a single object argument can be listed with " +"the :c:macro:`METH_O` flag, instead of invoking :c:func:`PyArg_ParseTuple` " +"with a ``\"O\"`` argument. They have the type :c:type:`PyCFunction`, with " +"the *self* parameter, and a :c:expr:`PyObject*` parameter representing the " "single argument." msgstr "" @@ -436,16 +437,13 @@ msgstr "" msgid "" "The method will be passed the type object as the first parameter rather than " "an instance of the type. This is used to create *class methods*, similar to " -"what is created when using the :func:`classmethod` built-in function." +"what is created when using the :deco:`classmethod` built-in decorator." msgstr "" -"Metodzie zostanie przekazany typ obiektu jako pierwszy parametr zamiast " -"instancji tego typu. Jest to używane aby tworzyć *metody klasowe*, podobnie " -"do tego, co jest tworzone przy użyciu wbudowanej funkcji :func:`classmethod`." msgid "" "The method will be passed ``NULL`` as the first parameter rather than an " "instance of the type. This is used to create *static methods*, similar to " -"what is created when using the :func:`staticmethod` built-in function." +"what is created when using the :deco:`staticmethod` built-in decorator." msgstr "" msgid "" @@ -459,12 +457,12 @@ msgid "" "The method will be loaded in place of existing definitions. Without " "*METH_COEXIST*, the default is to skip repeated definitions. Since slot " "wrappers are loaded before the method table, the existence of a " -"*sq_contains* slot, for example, would generate a wrapped method named :meth:" -"`~object.__contains__` and preclude the loading of a corresponding " -"PyCFunction with the same name. With the flag defined, the PyCFunction will " -"be loaded in place of the wrapper object and will co-exist with the slot. " -"This is helpful because calls to PyCFunctions are optimized more than " -"wrapper object calls." +"*sq_contains* slot, for example, would generate a wrapped method " +"named :meth:`~object.__contains__` and preclude the loading of a " +"corresponding PyCFunction with the same name. With the flag defined, the " +"PyCFunction will be loaded in place of the wrapper object and will co-exist " +"with the slot. This is helpful because calls to PyCFunctions are optimized " +"more than wrapper object calls." msgstr "" msgid "" @@ -530,8 +528,8 @@ msgid "Equivalent to ``PyCMethod_New(ml, self, NULL, NULL)``." msgstr "" msgid "" -"Get the function's flags on *func* as they were passed to :c:member:" -"`~PyMethodDef.ml_flags`." +"Get the function's flags on *func* as they were passed " +"to :c:member:`~PyMethodDef.ml_flags`." msgstr "" msgid "" @@ -550,8 +548,8 @@ msgid "" msgstr "" msgid "" -"Get the function pointer on *func* as it was passed to :c:member:" -"`~PyMethodDef.ml_meth`." +"Get the function pointer on *func* as it was passed " +"to :c:member:`~PyMethodDef.ml_meth`." msgstr "" msgid "" @@ -581,6 +579,17 @@ msgid "" "checking." msgstr "" +msgid "" +"Return a :term:`borrowed reference` to the defining class of *func* if " +"its :c:member:`~PyMethodDef.ml_flags` includes :c:macro:`METH_METHOD`. " +"Otherwise, return ``NULL`` without setting an exception." +msgstr "" + +msgid "" +"*func* must be a C function object and must not be ``NULL``. This function " +"does not perform error or type checking." +msgstr "" + msgid "Accessing attributes of extension types" msgstr "" @@ -621,18 +630,18 @@ msgstr "" msgid "" "By default (when :c:member:`~PyMemberDef.flags` is ``0``), members allow " "both read and write access. Use the :c:macro:`Py_READONLY` flag for read-" -"only access. Certain types, like :c:macro:`Py_T_STRING`, imply :c:macro:" -"`Py_READONLY`. Only :c:macro:`Py_T_OBJECT_EX` (and legacy :c:macro:" -"`T_OBJECT`) members can be deleted." +"only access. Certain types, like :c:macro:`Py_T_STRING`, " +"imply :c:macro:`Py_READONLY`. Only :c:macro:`Py_T_OBJECT_EX` (and " +"legacy :c:macro:`T_OBJECT`) members can be deleted." msgstr "" msgid "" "For heap-allocated types (created using :c:func:`PyType_FromSpec` or " "similar), ``PyMemberDef`` may contain a definition for the special member " -"``\"__vectorcalloffset__\"``, corresponding to :c:member:`~PyTypeObject." -"tp_vectorcall_offset` in type objects. This member must be defined with " -"``Py_T_PYSSIZET``, and either ``Py_READONLY`` or ``Py_READONLY | " -"Py_RELATIVE_OFFSET``. For example::" +"``\"__vectorcalloffset__\"``, corresponding " +"to :c:member:`~PyTypeObject.tp_vectorcall_offset` in type objects. This " +"member must be defined with ``Py_T_PYSSIZET``, and either ``Py_READONLY`` or " +"``Py_READONLY | Py_RELATIVE_OFFSET``. For example::" msgstr "" msgid "" @@ -647,9 +656,9 @@ msgid "(You may need to ``#include `` for :c:func:`!offsetof`.)" msgstr "" msgid "" -"The legacy offsets :c:member:`~PyTypeObject.tp_dictoffset` and :c:member:" -"`~PyTypeObject.tp_weaklistoffset` can be defined similarly using " -"``\"__dictoffset__\"`` and ``\"__weaklistoffset__\"`` members, but " +"The legacy offsets :c:member:`~PyTypeObject.tp_dictoffset` " +"and :c:member:`~PyTypeObject.tp_weaklistoffset` can be defined similarly " +"using ``\"__dictoffset__\"`` and ``\"__weaklistoffset__\"`` members, but " "extensions are strongly encouraged to use :c:macro:`Py_TPFLAGS_MANAGED_DICT` " "and :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` instead." msgstr "" @@ -708,11 +717,11 @@ msgstr "" msgid "" "Can only be used as part of the :c:data:`Py_tp_members` :c:type:`slot " -"` when creating a class using negative :c:member:`~PyType_Spec." -"basicsize`. It is mandatory in that case. When setting :c:member:" -"`~PyTypeObject.tp_members` from the slot during class creation, Python " -"clears the flag and sets :c:member:`PyMemberDef.offset` to the offset from " -"the ``PyObject`` struct." +"` when creating a class using " +"negative :c:member:`~PyType_Spec.basicsize`. It is mandatory in that case. " +"When setting :c:member:`~PyTypeObject.tp_members` from the slot during class " +"creation, Python clears the flag and sets :c:member:`PyMemberDef.offset` to " +"the offset from the ``PyObject`` struct." msgstr "" msgid "" @@ -724,13 +733,29 @@ msgid "" msgstr "" msgid "" -"The :c:macro:`!READONLY` macro was renamed to :c:macro:`Py_READONLY`. The :c:" -"macro:`!PY_AUDIT_READ` macro was renamed with the ``Py_`` prefix. The new " -"names are now always available. Previously, these required ``#include " +"The :c:macro:`!READONLY` macro was renamed to :c:macro:`Py_READONLY`. " +"The :c:macro:`PY_AUDIT_READ` macro was renamed with the ``Py_`` prefix. The " +"new names are now always available. Previously, these required ``#include " "\"structmember.h\"``. The header is still available and it provides the old " "names." msgstr "" +msgid "" +"Soft-deprecated alias of :c:macro:`Py_AUDIT_READ` (note capitalization of " +"the ``y``). Only available with ``#include \"structmember.h\"``." +msgstr "" + +msgid "Use :c:macro:`Py_AUDIT_READ` instead." +msgstr "" + +msgid "" +"A member flag that has no effect, retained solely for backwards " +"compatibility. This is only available with ``#include \"structmember.h\"``." +msgstr "" + +msgid "Omit this flag instead." +msgstr "" + msgid "Member types" msgstr "" @@ -743,8 +768,8 @@ msgid "" msgstr "" msgid "" -"Unless marked (D), attributes defined this way cannot be deleted using e.g. :" -"keyword:`del` or :py:func:`delattr`." +"Unless marked (D), attributes defined this way cannot be deleted using " +"e.g. :keyword:`del` or :py:func:`delattr`." msgstr "" msgid "Macro name" diff --git a/c-api/subinterpreters.po b/c-api/subinterpreters.po index c0e15f3211..b14f86476c 100644 --- a/c-api/subinterpreters.po +++ b/c-api/subinterpreters.po @@ -5,16 +5,15 @@ # # Translators: # Rafael Fontenelle , 2026 -# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2026-02-25 14:46+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,9 +44,9 @@ msgid "" msgstr "" msgid "" -"You can switch between sub-interpreters using the :c:func:" -"`PyThreadState_Swap` function. You can create and destroy them using the " -"following functions:" +"You can switch between sub-interpreters using " +"the :c:func:`PyThreadState_Swap` function. You can create and destroy them " +"using the following functions:" msgstr "" msgid "" @@ -65,10 +64,10 @@ msgid "" msgstr "" msgid "" -"If this is ``0`` then :c:member:`~PyInterpreterConfig." -"check_multi_interp_extensions` must be ``1`` (non-zero). If this is ``1`` " -"then :c:member:`~PyInterpreterConfig.gil` must not be :c:macro:" -"`PyInterpreterConfig_OWN_GIL`." +"If this is ``0`` " +"then :c:member:`~PyInterpreterConfig.check_multi_interp_extensions` must be " +"``1`` (non-zero). If this is ``1`` then :c:member:`~PyInterpreterConfig.gil` " +"must not be :c:macro:`PyInterpreterConfig_OWN_GIL`." msgstr "" msgid "" @@ -98,21 +97,21 @@ msgstr "" msgid "" "If this is ``0`` then the sub-interpreter's :mod:`threading` module won't " -"create daemon threads. Otherwise daemon threads are allowed (as long as :c:" -"member:`~PyInterpreterConfig.allow_threads` is non-zero)." +"create daemon threads. Otherwise daemon threads are allowed (as long " +"as :c:member:`~PyInterpreterConfig.allow_threads` is non-zero)." msgstr "" msgid "" "If this is ``0`` then all extension modules may be imported, including " "legacy (single-phase init) modules, in any thread where the sub-interpreter " -"is currently active. Otherwise only multi-phase init extension modules (see :" -"pep:`489`) may be imported. (Also see :c:macro:" -"`Py_mod_multiple_interpreters`.)" +"is currently active. Otherwise only multi-phase init extension modules " +"(see :pep:`489`) may be imported. (Also " +"see :c:macro:`Py_mod_multiple_interpreters`.)" msgstr "" msgid "" -"This must be ``1`` (non-zero) if :c:member:`~PyInterpreterConfig." -"use_main_obmalloc` is ``0``." +"This must be ``1`` (non-zero) " +"if :c:member:`~PyInterpreterConfig.use_main_obmalloc` is ``0``." msgstr "" msgid "" @@ -130,20 +129,20 @@ msgid "Use the sub-interpreter's own GIL." msgstr "" msgid "" -"If this is :c:macro:`PyInterpreterConfig_OWN_GIL` then :c:member:" -"`PyInterpreterConfig.use_main_obmalloc` must be ``0``." +"If this is :c:macro:`PyInterpreterConfig_OWN_GIL` " +"then :c:member:`PyInterpreterConfig.use_main_obmalloc` must be ``0``." msgstr "" msgid "" "Create a new sub-interpreter. This is an (almost) totally separate " "environment for the execution of Python code. In particular, the new " "interpreter has separate, independent versions of all imported modules, " -"including the fundamental modules :mod:`builtins`, :mod:`__main__` and :mod:" -"`sys`. The table of loaded modules (``sys.modules``) and the module search " -"path (``sys.path``) are also separate. The new environment has no ``sys." -"argv`` variable. It has new standard I/O stream file objects ``sys.stdin``, " -"``sys.stdout`` and ``sys.stderr`` (however these refer to the same " -"underlying file descriptors)." +"including the fundamental modules :mod:`builtins`, :mod:`__main__` " +"and :mod:`sys`. The table of loaded modules (``sys.modules``) and the " +"module search path (``sys.path``) are also separate. The new environment " +"has no ``sys.argv`` variable. It has new standard I/O stream file objects " +"``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` (however these refer to the " +"same underlying file descriptors)." msgstr "" msgid "" @@ -165,12 +164,12 @@ msgid "" "Like all other Python/C API functions, an :term:`attached thread state` must " "be present before calling this function, but it might be detached upon " "returning. On success, the returned thread state will be :term:`attached " -"`. If the sub-interpreter is created with its own :" -"term:`GIL` then the :term:`attached thread state` of the calling interpreter " -"will be detached. When the function returns, the new interpreter's :term:" -"`thread state` will be :term:`attached ` to the " -"current thread and the previous interpreter's :term:`attached thread state` " -"will remain detached." +"`. If the sub-interpreter is created with its " +"own :term:`GIL` then the :term:`attached thread state` of the calling " +"interpreter will be detached. When the function returns, the new " +"interpreter's :term:`thread state` will be :term:`attached ` to the current thread and the previous interpreter's :term:`attached " +"thread state` will remain detached." msgstr "" msgid "" @@ -197,19 +196,19 @@ msgstr "" msgid "" "Note that the config is used only briefly and does not get modified. During " -"initialization the config's values are converted into various :c:type:" -"`PyInterpreterState` values. A read-only copy of the config may be stored " -"internally on the :c:type:`PyInterpreterState`." +"initialization the config's values are converted into " +"various :c:type:`PyInterpreterState` values. A read-only copy of the config " +"may be stored internally on the :c:type:`PyInterpreterState`." msgstr "" msgid "Extension modules are shared between (sub-)interpreters as follows:" msgstr "" msgid "" -"For modules using multi-phase initialization, e.g. :c:func:" -"`PyModule_FromDefAndSpec`, a separate module object is created and " -"initialized for each interpreter. Only C-level static and global variables " -"are shared between these module objects." +"For modules using multi-phase initialization, " +"e.g. :c:func:`PyModule_FromDefAndSpec`, a separate module object is created " +"and initialized for each interpreter. Only C-level static and global " +"variables are shared between these module objects." msgstr "" msgid "" @@ -226,19 +225,19 @@ msgstr "" msgid "" "Note that this is different from what happens when an extension is imported " -"after the interpreter has been completely re-initialized by calling :c:func:" -"`Py_FinalizeEx` and :c:func:`Py_Initialize`; in that case, the extension's " -"``initmodule`` function *is* called again. As with multi-phase " -"initialization, this means that only C-level static and global variables are " -"shared between these modules." +"after the interpreter has been completely re-initialized by " +"calling :c:func:`Py_FinalizeEx` and :c:func:`Py_Initialize`; in that case, " +"the extension's ``initmodule`` function *is* called again. As with multi-" +"phase initialization, this means that only C-level static and global " +"variables are shared between these modules." msgstr "" msgid "" -"Create a new sub-interpreter. This is essentially just a wrapper around :c:" -"func:`Py_NewInterpreterFromConfig` with a config that preserves the existing " -"behavior. The result is an unisolated sub-interpreter that shares the main " -"interpreter's GIL, allows fork/exec, allows daemon threads, and allows " -"single-phase init modules." +"Create a new sub-interpreter. This is essentially just a wrapper " +"around :c:func:`Py_NewInterpreterFromConfig` with a config that preserves " +"the existing behavior. The result is an unisolated sub-interpreter that " +"shares the main interpreter's GIL, allows fork/exec, allows daemon threads, " +"and allows single-phase init modules." msgstr "" msgid "" @@ -324,10 +323,10 @@ msgid "" "delicate, because these APIs assume a bijection between Python thread states " "and OS-level threads, an assumption broken by the presence of sub-" "interpreters. It is highly recommended that you don't switch sub-" -"interpreters between a pair of matching :c:func:`PyGILState_Ensure` and :c:" -"func:`PyGILState_Release` calls. Furthermore, extensions (such as :mod:" -"`ctypes`) using these APIs to allow calling of Python code from non-Python " -"created threads will probably be broken when using sub-interpreters." +"interpreters between a pair of matching :c:func:`PyGILState_Ensure` " +"and :c:func:`PyGILState_Release` calls. Furthermore, extensions (such " +"as :mod:`ctypes`) using these APIs to allow calling of Python code from non-" +"Python created threads will probably be broken when using sub-interpreters." msgstr "" msgid "High-level APIs" @@ -417,8 +416,8 @@ msgid "" msgstr "" msgid "" -":c:func:`Py_Initialize()` now initializes the :term:`GIL` and sets an :term:" -"`attached thread state`." +":c:func:`Py_Initialize()` now initializes the :term:`GIL` and sets " +"an :term:`attached thread state`." msgstr "" msgid "" @@ -428,25 +427,25 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_New`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython.PyInterpreterState_New`` with no arguments." msgstr "" msgid "" -"Reset all information in an interpreter state object. There must be an :" -"term:`attached thread state` for the interpreter." +"Reset all information in an interpreter state object. There must be " +"an :term:`attached thread state` for the interpreter." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_Clear`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython.PyInterpreterState_Clear`` with no arguments." msgstr "" msgid "" -"Destroy an interpreter state object. There **should not** be an :term:" -"`attached thread state` for the target interpreter. The interpreter state " -"must have been reset with a previous call to :c:func:" -"`PyInterpreterState_Clear`." +"Destroy an interpreter state object. There **should not** be " +"an :term:`attached thread state` for the target interpreter. The interpreter " +"state must have been reset with a previous call " +"to :c:func:`PyInterpreterState_Clear`." msgstr "" msgid "Advanced debugger support" diff --git a/c-api/sys.po b/c-api/sys.po index f57ec94ee6..35e5d0435c 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -27,12 +27,12 @@ msgid "Operating System Utilities" msgstr "" msgid "" -"Return the file system representation for *path*. If the object is a :class:" -"`str` or :class:`bytes` object, then a new :term:`strong reference` is " -"returned. If the object implements the :class:`os.PathLike` interface, then :" -"meth:`~os.PathLike.__fspath__` is returned as long as it is a :class:`str` " -"or :class:`bytes` object. Otherwise :exc:`TypeError` is raised and ``NULL`` " -"is returned." +"Return the file system representation for *path*. If the object is " +"a :class:`str` or :class:`bytes` object, then a new :term:`strong reference` " +"is returned. If the object implements the :class:`os.PathLike` interface, " +"then :meth:`~os.PathLike.__fspath__` is returned as long as it is " +"a :class:`str` or :class:`bytes` object. Otherwise :exc:`TypeError` is " +"raised and ``NULL`` is returned." msgstr "" msgid "" @@ -90,8 +90,8 @@ msgstr "" msgid "" ":func:`os.register_at_fork` allows registering custom Python functions to be " -"called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` and :" -"c:func:`PyOS_AfterFork_Child`." +"called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` " +"and :c:func:`PyOS_AfterFork_Child`." msgstr "" msgid "" @@ -120,20 +120,20 @@ msgstr "" msgid "" "Set the signal handler for signal *i* to be *h*; return the old signal " -"handler. This is a thin wrapper around either :c:func:`!sigaction` or :c:" -"func:`!signal`. Do not call those functions directly!" +"handler. This is a thin wrapper around either :c:func:`!sigaction` " +"or :c:func:`!signal`. Do not call those functions directly!" msgstr "" msgid "" "This function should not be called directly: use the :c:type:`PyConfig` API " -"with the :c:func:`PyConfig_SetBytesString` function which ensures that :ref:" -"`Python is preinitialized `." +"with the :c:func:`PyConfig_SetBytesString` function which ensures " +"that :ref:`Python is preinitialized `." msgstr "" msgid "" "This function must not be called before :ref:`Python is preinitialized ` and so that the LC_CTYPE locale is properly configured: see the :c:" -"func:`Py_PreInitialize` function." +"preinit>` and so that the LC_CTYPE locale is properly configured: see " +"the :c:func:`Py_PreInitialize` function." msgstr "" msgid "" @@ -146,9 +146,10 @@ msgid "" msgstr "" msgid "" -"Return a pointer to a newly allocated wide character string, use :c:func:" -"`PyMem_RawFree` to free the memory. If size is not ``NULL``, write the " -"number of wide characters excluding the null character into ``*size``" +"Return a pointer to a newly allocated wide character string, " +"use :c:func:`PyMem_RawFree` to free the memory. If size is not ``NULL``, " +"write the number of wide characters excluding the null character into " +"``*size``" msgstr "" msgid "" @@ -158,9 +159,9 @@ msgid "" msgstr "" msgid "" -"The :term:`filesystem encoding and error handler` are selected by :c:func:" -"`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:" -"`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." +"The :term:`filesystem encoding and error handler` are selected " +"by :c:func:`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid "" @@ -173,8 +174,8 @@ msgid "" msgstr "" msgid "" -"The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:" -"`PyUnicode_DecodeLocaleAndSize` functions." +"The :c:func:`PyUnicode_DecodeFSDefaultAndSize` " +"and :c:func:`PyUnicode_DecodeLocaleAndSize` functions." msgstr "" msgid "" @@ -183,8 +184,8 @@ msgid "" msgstr "" msgid "" -"The function now uses the UTF-8 encoding on Windows if :c:member:" -"`PyPreConfig.legacy_windows_fs_encoding` is zero;" +"The function now uses the UTF-8 encoding on Windows " +"if :c:member:`PyPreConfig.legacy_windows_fs_encoding` is zero;" msgstr "" msgid "" @@ -216,8 +217,8 @@ msgid "" msgstr "" msgid "" -"The function now uses the UTF-8 encoding on Windows if :c:member:" -"`PyPreConfig.legacy_windows_fs_encoding` is zero." +"The function now uses the UTF-8 encoding on Windows " +"if :c:member:`PyPreConfig.legacy_windows_fs_encoding` is zero." msgstr "" msgid "" @@ -226,8 +227,8 @@ msgid "" msgstr "" msgid "" -"*path* must be a :class:`str` object, a :class:`bytes` object, or a :term:" -"`path-like object`." +"*path* must be a :class:`str` object, a :class:`bytes` object, or " +"a :term:`path-like object`." msgstr "" msgid "" @@ -236,8 +237,8 @@ msgid "" msgstr "" msgid "" -"The file must be closed by :c:func:`Py_fclose` rather than calling directly :" -"c:func:`!fclose`." +"The file must be closed by :c:func:`Py_fclose` rather than calling " +"directly :c:func:`!fclose`." msgstr "" msgid "The file descriptor is created non-inheritable (:pep:`446`)." @@ -310,9 +311,9 @@ msgid "" msgstr "" msgid "" -"Function similar to PySys_WriteStdout() but format the message using :c:func:" -"`PyUnicode_FromFormatV` and don't truncate the message to an arbitrary " -"length." +"Function similar to PySys_WriteStdout() but format the message " +"using :c:func:`PyUnicode_FromFormatV` and don't truncate the message to an " +"arbitrary length." msgstr "" msgid "" @@ -321,8 +322,9 @@ msgid "" msgstr "" msgid "" -"Return the current dictionary of :option:`-X` options, similarly to :data:" -"`sys._xoptions`. On error, ``NULL`` is returned and an exception is set." +"Return the current dictionary of :option:`-X` options, similarly " +"to :data:`sys._xoptions`. On error, ``NULL`` is returned and an exception " +"is set." msgstr "" msgid "" @@ -347,8 +349,9 @@ msgid "" msgstr "" msgid "" -"Note that ``#`` format characters should always be treated as :c:type:" -"`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined." +"Note that ``#`` format characters should always be treated " +"as :c:type:`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was " +"defined." msgstr "" msgid ":func:`sys.audit` performs the same function from Python code." @@ -386,8 +389,8 @@ msgstr "" msgid "" "This function is safe to call before :c:func:`Py_Initialize`. When called " "after runtime initialization, existing audit hooks are notified and may " -"silently abort the operation by raising an error subclassed from :class:" -"`Exception` (other errors will not be silenced)." +"silently abort the operation by raising an error subclassed " +"from :class:`Exception` (other errors will not be silenced)." msgstr "" msgid "" @@ -424,8 +427,8 @@ msgid "" "This function should only be invoked when a condition is detected that would " "make it dangerous to continue using the Python interpreter; e.g., when the " "object administration appears to be corrupted. On Unix, the standard C " -"library function :c:func:`!abort` is called which will attempt to produce a :" -"file:`core` file." +"library function :c:func:`!abort` is called which will attempt to produce " +"a :file:`core` file." msgstr "" msgid "" @@ -439,8 +442,8 @@ msgstr "" msgid "" "Exit the current process. This calls :c:func:`Py_FinalizeEx` and then calls " -"the standard C library function ``exit(status)``. If :c:func:" -"`Py_FinalizeEx` indicates an error, the exit status is set to 120." +"the standard C library function ``exit(status)``. " +"If :c:func:`Py_FinalizeEx` indicates an error, the exit status is set to 120." msgstr "" msgid "Errors from finalization no longer ignored." diff --git a/c-api/threads.po b/c-api/threads.po index cc49cb9347..23400badc0 100644 --- a/c-api/threads.po +++ b/c-api/threads.po @@ -5,16 +5,15 @@ # # Translators: # Rafael Fontenelle , 2026 -# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2026-02-25 14:46+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -89,9 +88,9 @@ msgid "" msgstr "" msgid "" -"If it turns out that you do need to create a thread state, call :c:func:" -"`PyThreadState_New` followed by :c:func:`PyThreadState_Swap`, or use the " -"dangerous :c:func:`PyGILState_Ensure` function." +"If it turns out that you do need to create a thread state, " +"call :c:func:`PyThreadState_New` followed by :c:func:`PyThreadState_Swap`, " +"or use the dangerous :c:func:`PyGILState_Ensure` function." msgstr "" msgid "Detaching the thread state from extension code" @@ -188,27 +187,27 @@ msgid "" msgstr "" msgid "" -"This macro expands to ``{ PyThreadState *_save; _save = PyEval_SaveThread();" -"``. Note that it contains an opening brace; it must be matched with a " -"following :c:macro:`Py_END_ALLOW_THREADS` macro. See above for further " -"discussion of this macro." +"This macro expands to ``{ PyThreadState *_save; _save = " +"PyEval_SaveThread();``. Note that it contains an opening brace; it must be " +"matched with a following :c:macro:`Py_END_ALLOW_THREADS` macro. See above " +"for further discussion of this macro." msgstr "" msgid "" "This macro expands to ``PyEval_RestoreThread(_save); }``. Note that it " -"contains a closing brace; it must be matched with an earlier :c:macro:" -"`Py_BEGIN_ALLOW_THREADS` macro. See above for further discussion of this " -"macro." +"contains a closing brace; it must be matched with an " +"earlier :c:macro:`Py_BEGIN_ALLOW_THREADS` macro. See above for further " +"discussion of this macro." msgstr "" msgid "" -"This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent to :" -"c:macro:`Py_END_ALLOW_THREADS` without the closing brace." +"This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent " +"to :c:macro:`Py_END_ALLOW_THREADS` without the closing brace." msgstr "" msgid "" -"This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent to :" -"c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " +"This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent " +"to :c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " "declaration." msgstr "" @@ -216,11 +215,11 @@ msgid "Non-Python created threads" msgstr "" msgid "" -"When threads are created using the dedicated Python APIs (such as the :mod:" -"`threading` module), a thread state is automatically associated with them, " -"However, when a thread is created from native code (for example, by a third-" -"party library with its own thread management), it doesn't hold an attached " -"thread state." +"When threads are created using the dedicated Python APIs (such as " +"the :mod:`threading` module), a thread state is automatically associated " +"with them, However, when a thread is created from native code (for example, " +"by a third-party library with its own thread management), it doesn't hold an " +"attached thread state." msgstr "" msgid "" @@ -237,8 +236,9 @@ msgstr "" msgid "" "``PyThreadState_New`` requires an argument pointing to the desired " -"interpreter; such a pointer can be acquired via a call to :c:func:" -"`PyInterpreterState_Get` from the code where the thread was created." +"interpreter; such a pointer can be acquired via a call " +"to :c:func:`PyInterpreterState_Get` from the code where the thread was " +"created." msgstr "" msgid "For example::" @@ -275,8 +275,8 @@ msgstr "" msgid "" "Another common pattern to call Python code from a non-Python thread is to " -"use :c:func:`PyGILState_Ensure` followed by a call to :c:func:" -"`PyGILState_Release`." +"use :c:func:`PyGILState_Ensure` followed by a call " +"to :c:func:`PyGILState_Release`." msgstr "" msgid "" @@ -328,11 +328,11 @@ msgid "" "of additional (non-Python) locks that need to be acquired before or reset " "after a fork. OS facilities such as :c:func:`!pthread_atfork` would need to " "be used to accomplish the same thing. Additionally, when extending or " -"embedding Python, calling :c:func:`fork` directly rather than through :func:" -"`os.fork` (and returning to or calling into Python) may result in a deadlock " -"by one of Python's internal locks being held by a thread that is defunct " -"after the fork. :c:func:`PyOS_AfterFork_Child` tries to reset the necessary " -"locks, but is not always able to." +"embedding Python, calling :c:func:`fork` directly rather than " +"through :func:`os.fork` (and returning to or calling into Python) may result " +"in a deadlock by one of Python's internal locks being held by a thread that " +"is defunct after the fork. :c:func:`PyOS_AfterFork_Child` tries to reset the " +"necessary locks, but is not always able to." msgstr "" msgid "" @@ -427,8 +427,8 @@ msgid "" msgstr "" msgid "" -"Set the :term:`attached thread state` to *tstate*, and return the :term:" -"`thread state` that was attached prior to calling." +"Set the :term:`attached thread state` to *tstate*, and return " +"the :term:`thread state` that was attached prior to calling." msgstr "" msgid "" @@ -453,8 +453,8 @@ msgid "" msgstr "" msgid "" -"The type of the value returned by :c:func:`PyGILState_Ensure` and passed to :" -"c:func:`PyGILState_Release`." +"The type of the value returned by :c:func:`PyGILState_Ensure` and passed " +"to :c:func:`PyGILState_Release`." msgstr "" msgid "The GIL was already held when :c:func:`PyGILState_Ensure` was called." @@ -468,20 +468,20 @@ msgid "" "of the current state of Python, or of the :term:`attached thread state`. " "This may be called as many times as desired by a thread as long as each call " "is matched with a call to :c:func:`PyGILState_Release`. In general, other " -"thread-related APIs may be used between :c:func:`PyGILState_Ensure` and :c:" -"func:`PyGILState_Release` calls as long as the thread state is restored to " -"its previous state before the Release(). For example, normal usage of the :" -"c:macro:`Py_BEGIN_ALLOW_THREADS` and :c:macro:`Py_END_ALLOW_THREADS` macros " -"is acceptable." +"thread-related APIs may be used between :c:func:`PyGILState_Ensure` " +"and :c:func:`PyGILState_Release` calls as long as the thread state is " +"restored to its previous state before the Release(). For example, normal " +"usage of the :c:macro:`Py_BEGIN_ALLOW_THREADS` " +"and :c:macro:`Py_END_ALLOW_THREADS` macros is acceptable." msgstr "" msgid "" "The return value is an opaque \"handle\" to the :term:`attached thread " -"state` when :c:func:`PyGILState_Ensure` was called, and must be passed to :c:" -"func:`PyGILState_Release` to ensure Python is left in the same state. Even " -"though recursive calls are allowed, these handles *cannot* be shared - each " -"unique call to :c:func:`PyGILState_Ensure` must save the handle for its call " -"to :c:func:`PyGILState_Release`." +"state` when :c:func:`PyGILState_Ensure` was called, and must be passed " +"to :c:func:`PyGILState_Release` to ensure Python is left in the same state. " +"Even though recursive calls are allowed, these handles *cannot* be shared - " +"each unique call to :c:func:`PyGILState_Ensure` must save the handle for its " +"call to :c:func:`PyGILState_Release`." msgstr "" msgid "" @@ -499,14 +499,14 @@ msgstr "" msgid "" "Release any resources previously acquired. After this call, Python's state " -"will be the same as it was prior to the corresponding :c:func:" -"`PyGILState_Ensure` call (but generally this state will be unknown to the " -"caller, hence the use of the GILState API)." +"will be the same as it was prior to the " +"corresponding :c:func:`PyGILState_Ensure` call (but generally this state " +"will be unknown to the caller, hence the use of the GILState API)." msgstr "" msgid "" -"Every call to :c:func:`PyGILState_Ensure` must be matched by a call to :c:" -"func:`PyGILState_Release` on the same thread." +"Every call to :c:func:`PyGILState_Ensure` must be matched by a call " +"to :c:func:`PyGILState_Release` on the same thread." msgstr "" msgid "" @@ -518,8 +518,8 @@ msgstr "" msgid "" "This function may return non-``NULL`` even when the :term:`thread state` is " -"detached. Prefer :c:func:`PyThreadState_Get` or :c:func:" -"`PyThreadState_GetUnchecked` for most cases." +"detached. Prefer :c:func:`PyThreadState_Get` " +"or :c:func:`PyThreadState_GetUnchecked` for most cases." msgstr "" msgid ":c:func:`PyThreadState_Get`" @@ -528,18 +528,18 @@ msgstr "" msgid "" "Return ``1`` if the current thread is holding the :term:`GIL` and ``0`` " "otherwise. This function can be called from any thread at any time. Only if " -"it has had its :term:`thread state ` initialized via :" -"c:func:`PyGILState_Ensure` will it return ``1``. This is mainly a helper/" -"diagnostic function. It can be useful for example in callback contexts or " -"memory allocation functions when knowing that the :term:`GIL` is locked can " -"allow the caller to perform sensitive actions or otherwise behave " +"it has had its :term:`thread state ` initialized " +"via :c:func:`PyGILState_Ensure` will it return ``1``. This is mainly a " +"helper/diagnostic function. It can be useful for example in callback " +"contexts or memory allocation functions when knowing that the :term:`GIL` is " +"locked can allow the caller to perform sensitive actions or otherwise behave " "differently." msgstr "" msgid "" "If the current Python process has ever created a subinterpreter, this " -"function will *always* return ``1``. Prefer :c:func:" -"`PyThreadState_GetUnchecked` for most cases." +"function will *always* return ``1``. " +"Prefer :c:func:`PyThreadState_GetUnchecked` for most cases." msgstr "" msgid "Low-level APIs" @@ -551,8 +551,8 @@ msgid "" msgstr "" msgid "" -"Reset all information in a :term:`thread state` object. *tstate* must be :" -"term:`attached `" +"Reset all information in a :term:`thread state` object. *tstate* must " +"be :term:`attached `" msgstr "" msgid "" @@ -564,9 +564,9 @@ msgid "The :c:member:`!PyThreadState.on_delete` callback was removed." msgstr "" msgid "" -"Destroy a :term:`thread state` object. *tstate* should not be :term:" -"`attached ` to any thread. *tstate* must have been " -"reset with a previous call to :c:func:`PyThreadState_Clear`." +"Destroy a :term:`thread state` object. *tstate* should not " +"be :term:`attached ` to any thread. *tstate* must " +"have been reset with a previous call to :c:func:`PyThreadState_Clear`." msgstr "" msgid "" @@ -630,13 +630,13 @@ msgstr "" msgid "" "CPython implements :ref:`recursion control ` for C code by " "raising :py:exc:`RecursionError` when it notices that the machine execution " -"stack is close to overflow. See for example the :c:func:" -"`Py_EnterRecursiveCall` function. For this, it needs to know the location of " -"the current thread's stack, which it normally gets from the operating " -"system. When the stack is changed, for example using context switching " -"techniques like the Boost library's ``boost::context``, you must call :c:" -"func:`~PyUnstable_ThreadState_SetStackProtection` to inform CPython of the " -"change." +"stack is close to overflow. See for example " +"the :c:func:`Py_EnterRecursiveCall` function. For this, it needs to know the " +"location of the current thread's stack, which it normally gets from the " +"operating system. When the stack is changed, for example using context " +"switching techniques like the Boost library's ``boost::context``, you must " +"call :c:func:`~PyUnstable_ThreadState_SetStackProtection` to inform CPython " +"of the change." msgstr "" msgid "" @@ -678,9 +678,10 @@ msgid "" msgstr "" msgid "" -"Updated to be consistent with :c:func:`PyEval_RestoreThread`, :c:func:" -"`Py_END_ALLOW_THREADS`, and :c:func:`PyGILState_Ensure`, and terminate the " -"current thread if called while the interpreter is finalizing." +"Updated to be consistent " +"with :c:func:`PyEval_RestoreThread`, :c:func:`Py_END_ALLOW_THREADS`, " +"and :c:func:`PyGILState_Ensure`, and terminate the current thread if called " +"while the interpreter is finalizing." msgstr "" msgid "" @@ -690,8 +691,8 @@ msgstr "" msgid "" "Detach the :term:`attached thread state`. The *tstate* argument, which must " -"not be ``NULL``, is only used to check that it represents the :term:" -"`attached thread state` --- if it isn't, a fatal error is reported." +"not be ``NULL``, is only used to check that it represents " +"the :term:`attached thread state` --- if it isn't, a fatal error is reported." msgstr "" msgid "" @@ -738,9 +739,9 @@ msgstr "" msgid "" "This function doesn't need an :term:`attached thread state`. However, to " -"call this function in a subinterpreter, the caller must have an :term:" -"`attached thread state`. Otherwise, the function *func* can be scheduled to " -"be called from the wrong interpreter." +"call this function in a subinterpreter, the caller must have " +"an :term:`attached thread state`. Otherwise, the function *func* can be " +"scheduled to be called from the wrong interpreter." msgstr "" msgid "" @@ -748,8 +749,8 @@ msgid "" "no guarantee that *func* will be called as quick as possible. If the main " "thread is busy executing a system call, *func* won't be called before the " "system call returns. This function is generally **not** suitable for " -"calling Python code from arbitrary C threads. Instead, use the :ref:" -"`PyGILState API`." +"calling Python code from arbitrary C threads. Instead, use " +"the :ref:`PyGILState API`." msgstr "" msgid "" @@ -775,8 +776,8 @@ msgstr "" msgid "" "If this is not called in the main thread of the main interpreter, this " -"function does nothing and returns ``0``. The caller must hold an :term:" -"`attached thread state`." +"function does nothing and returns ``0``. The caller must hold " +"an :term:`attached thread state`." msgstr "" msgid "This function only runs pending calls in the main interpreter." @@ -785,17 +786,17 @@ msgstr "" msgid "" "Asynchronously raise an exception in a thread. The *id* argument is the " "thread id of the target thread; *exc* is the exception object to be raised. " -"This function does not steal any references to *exc*. To prevent naive " -"misuse, you must write your own C extension to call this. Must be called " -"with an :term:`attached thread state`. Returns the number of thread states " -"modified; this is normally one, but will be zero if the thread id isn't " -"found. If *exc* is ``NULL``, the pending exception (if any) for the thread " -"is cleared. This raises no exceptions." +"This function does not :term:`steal` any references to *exc*. To prevent " +"naive misuse, you must write your own C extension to call this. Must be " +"called with an :term:`attached thread state`. Returns the number of thread " +"states modified; this is normally one, but will be zero if the thread id " +"isn't found. If *exc* is ``NULL``, the pending exception (if any) for the " +"thread is cleared. This raises no exceptions." msgstr "" msgid "" -"The type of the *id* parameter changed from :c:expr:`long` to :c:expr:" -"`unsigned long`." +"The type of the *id* parameter changed from :c:expr:`long` " +"to :c:expr:`unsigned long`." msgstr "" msgid "Operating system thread APIs" @@ -827,17 +828,17 @@ msgid "Return the identifier of the current thread, which will never be zero." msgstr "" msgid "" -"This function cannot fail, and the caller does not need to hold an :term:" -"`attached thread state`." +"This function cannot fail, and the caller does not need to hold " +"an :term:`attached thread state`." msgstr "" msgid ":py:func:`threading.get_ident`" msgstr "" msgid "" -"Get general information about the current thread in the form of a :ref:" -"`struct sequence ` object. This information is " -"accessible as :py:attr:`sys.thread_info` in Python." +"Get general information about the current thread in the form of " +"a :ref:`struct sequence ` object. This information " +"is accessible as :py:attr:`sys.thread_info` in Python." msgstr "" msgid "" diff --git a/c-api/time.po b/c-api/time.po index 3a2eb9f960..a7fc052368 100644 --- a/c-api/time.po +++ b/c-api/time.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -44,8 +44,8 @@ msgid "" msgstr "" msgid "" -"The reference point for timestamps depends on the clock used. For example, :" -"c:func:`PyTime_Time` returns timestamps relative to the UNIX epoch." +"The reference point for timestamps depends on the clock used. For " +"example, :c:func:`PyTime_Time` returns timestamps relative to the UNIX epoch." msgstr "" msgid "" diff --git a/c-api/tuple.po b/c-api/tuple.po index f27dec44ea..1a9b8ddf96 100644 --- a/c-api/tuple.po +++ b/c-api/tuple.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -66,15 +66,15 @@ msgstr "" msgid "" "Return the object at position *pos* in the tuple pointed to by *p*. If " -"*pos* is negative or out of bounds, return ``NULL`` and set an :exc:" -"`IndexError` exception." +"*pos* is negative or out of bounds, return ``NULL`` and set " +"an :exc:`IndexError` exception." msgstr "" msgid "" "The returned reference is borrowed from the tuple *p* (that is: it is only " "valid as long as you hold a reference to *p*). To get a :term:`strong " -"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) ` or :c:" -"func:`PySequence_GetItem`." +"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) ` " +"or :c:func:`PySequence_GetItem`." msgstr "" msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments." @@ -97,8 +97,9 @@ msgid "" msgstr "" msgid "" -"This function \"steals\" a reference to *o* and discards a reference to an " -"item already in the tuple at the affected position." +"This function \":term:`steals `\" a reference to *o* and discards a " +"reference to an item already in the tuple at the affected position (unless " +"it was NULL)." msgstr "" msgid "" @@ -107,14 +108,16 @@ msgid "" msgstr "" msgid "" -"Bounds checking is performed as an assertion if Python is built in :ref:" -"`debug mode ` or :option:`with assertions <--with-assertions>`." +"Bounds checking is performed as an assertion if Python is built " +"in :ref:`debug mode ` or :option:`with assertions <--with-" +"assertions>`." msgstr "" msgid "" -"This function \"steals\" a reference to *o*, and, unlike :c:func:" -"`PyTuple_SetItem`, does *not* discard a reference to any item that is being " -"replaced; any reference in the tuple at position *pos* will be leaked." +"This function \":term:`steals `\" a reference to *o*, and, " +"unlike :c:func:`PyTuple_SetItem`, does *not* discard a reference to any item " +"that is being replaced; any reference in the tuple at position *pos* will be " +"leaked." msgstr "" msgid "" @@ -133,24 +136,24 @@ msgid "" "Client code should never assume that the resulting value of ``*p`` will be " "the same as before calling this function. If the object referenced by ``*p`` " "is replaced, the original ``*p`` is destroyed. On failure, returns ``-1`` " -"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` or :exc:" -"`SystemError`." +"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` " +"or :exc:`SystemError`." msgstr "" msgid "Struct Sequence Objects" msgstr "" msgid "" -"Struct sequence objects are the C equivalent of :func:`~collections." -"namedtuple` objects, i.e. a sequence whose items can also be accessed " -"through attributes. To create a struct sequence, you first have to create a " -"specific struct sequence type." +"Struct sequence objects are the C equivalent " +"of :func:`~collections.namedtuple` objects, i.e. a sequence whose items can " +"also be accessed through attributes. To create a struct sequence, you first " +"have to create a specific struct sequence type." msgstr "" msgid "" "Create a new struct sequence type from the data in *desc*, described below. " -"Instances of the resulting type can be created with :c:func:" -"`PyStructSequence_New`." +"Instances of the resulting type can be created " +"with :c:func:`PyStructSequence_New`." msgstr "" msgid "Return ``NULL`` with an exception set on failure." @@ -183,15 +186,15 @@ msgstr "" msgid "" "Describes a field of a struct sequence. As a struct sequence is modeled as a " -"tuple, all fields are typed as :c:expr:`PyObject*`. The index in the :c:" -"member:`~PyStructSequence_Desc.fields` array of the :c:type:" -"`PyStructSequence_Desc` determines which field of the struct sequence is " -"described." +"tuple, all fields are typed as :c:expr:`PyObject*`. The index in " +"the :c:member:`~PyStructSequence_Desc.fields` array of " +"the :c:type:`PyStructSequence_Desc` determines which field of the struct " +"sequence is described." msgstr "" msgid "" -"Name for the field or ``NULL`` to end the list of named fields, set to :c:" -"data:`PyStructSequence_UnnamedField` to leave unnamed." +"Name for the field or ``NULL`` to end the list of named fields, set " +"to :c:data:`PyStructSequence_UnnamedField` to leave unnamed." msgstr "" msgid "Field docstring or ``NULL`` to omit." @@ -204,8 +207,8 @@ msgid "The type was changed from ``char *``." msgstr "" msgid "" -"Creates an instance of *type*, which must have been created with :c:func:" -"`PyStructSequence_NewType`." +"Creates an instance of *type*, which must have been created " +"with :c:func:`PyStructSequence_NewType`." msgstr "" msgid "" @@ -224,7 +227,7 @@ msgid "" "new instances." msgstr "" -msgid "This function \"steals\" a reference to *o*." +msgid "This function \":term:`steals `\" a reference to *o*." msgstr "" msgid "Alias to :c:func:`PyStructSequence_SetItem`." diff --git a/c-api/type.po b/c-api/type.po index ca74441211..676dc870bc 100644 --- a/c-api/type.po +++ b/c-api/type.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,8 +30,8 @@ msgid "The C structure of the objects used to describe built-in types." msgstr "" msgid "" -"This is the type object for type objects; it is the same object as :class:" -"`type` in the Python layer." +"This is the type object for type objects; it is the same object " +"as :class:`type` in the Python layer." msgstr "" msgid "" @@ -52,9 +52,9 @@ msgstr "" msgid "" "Return the :c:member:`~PyTypeObject.tp_flags` member of *type*. This " "function is primarily meant for use with ``Py_LIMITED_API``; the individual " -"flag bits are guaranteed to be stable across Python releases, but access to :" -"c:member:`~PyTypeObject.tp_flags` itself is not part of the :ref:`limited " -"API `." +"flag bits are guaranteed to be stable across Python releases, but access " +"to :c:member:`~PyTypeObject.tp_flags` itself is not part of " +"the :ref:`limited API `." msgstr "" msgid "The return type is now ``unsigned long`` rather than ``long``." @@ -97,24 +97,24 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* (previously returned from :c:func:" -"`PyType_AddWatcher`). Return ``0`` on success, ``-1`` on error (e.g. if " -"*watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* (previously returned " +"from :c:func:`PyType_AddWatcher`). Return ``0`` on success, ``-1`` on error " +"(e.g. if *watcher_id* was never registered.)" msgstr "" msgid "" "An extension should never call ``PyType_ClearWatcher`` with a *watcher_id* " -"that was not returned to it by a previous call to :c:func:" -"`PyType_AddWatcher`." +"that was not returned to it by a previous call " +"to :c:func:`PyType_AddWatcher`." msgstr "" msgid "" -"Mark *type* as watched. The callback granted *watcher_id* by :c:func:" -"`PyType_AddWatcher` will be called whenever :c:func:`PyType_Modified` " -"reports a change to *type*. (The callback may be called only once for a " -"series of consecutive modifications to *type*, if :c:func:`!_PyType_Lookup` " -"is not called on *type* between the modifications; this is an implementation " -"detail and subject to change.)" +"Mark *type* as watched. The callback granted *watcher_id* " +"by :c:func:`PyType_AddWatcher` will be called " +"whenever :c:func:`PyType_Modified` reports a change to *type*. (The callback " +"may be called only once for a series of consecutive modifications to *type*, " +"if :c:func:`!_PyType_Lookup` is not called on *type* between the " +"modifications; this is an implementation detail and subject to change.)" msgstr "" msgid "" @@ -123,8 +123,8 @@ msgid "" msgstr "" msgid "" -"Mark *type* as not watched. This undoes a previous call to :c:func:" -"`PyType_Watch`. *type* must not be ``NULL``." +"Mark *type* as not watched. This undoes a previous call " +"to :c:func:`PyType_Watch`. *type* must not be ``NULL``." msgstr "" msgid "" @@ -172,9 +172,10 @@ msgid "Return true if *a* is a subtype of *b*." msgstr "" msgid "" -"This function only checks for actual subtypes, which means that :meth:`~type." -"__subclasscheck__` is not called on *b*. Call :c:func:`PyObject_IsSubclass` " -"to do the same check that :func:`issubclass` would do." +"This function only checks for actual subtypes, which means " +"that :meth:`~type.__subclasscheck__` is not called on *b*. " +"Call :c:func:`PyObject_IsSubclass` to do the same check " +"that :func:`issubclass` would do." msgstr "" msgid "" @@ -185,25 +186,27 @@ msgid "" msgstr "" msgid "" -"Do not call this directly to allocate memory for an object; call the type's :" -"c:member:`~PyTypeObject.tp_alloc` slot instead." +"Do not call this directly to allocate memory for an object; call the " +"type's :c:member:`~PyTypeObject.tp_alloc` slot instead." msgstr "" msgid "" -"For types that support garbage collection (i.e., the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag is set), this function behaves like :c:macro:" -"`PyObject_GC_New` or :c:macro:`PyObject_GC_NewVar` (except the memory is " -"guaranteed to be zeroed before initialization), and should be paired with :c:" -"func:`PyObject_GC_Del` in :c:member:`~PyTypeObject.tp_free`. Otherwise, it " -"behaves like :c:macro:`PyObject_New` or :c:macro:`PyObject_NewVar` (except " -"the memory is guaranteed to be zeroed before initialization) and should be " -"paired with :c:func:`PyObject_Free` in :c:member:`~PyTypeObject.tp_free`." +"For types that support garbage collection (i.e., " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag is set), this function behaves " +"like :c:macro:`PyObject_GC_New` or :c:macro:`PyObject_GC_NewVar` (except the " +"memory is guaranteed to be zeroed before initialization), and should be " +"paired with :c:func:`PyObject_GC_Del` in :c:member:`~PyTypeObject.tp_free`. " +"Otherwise, it behaves like :c:macro:`PyObject_New` " +"or :c:macro:`PyObject_NewVar` (except the memory is guaranteed to be zeroed " +"before initialization) and should be paired with :c:func:`PyObject_Free` " +"in :c:member:`~PyTypeObject.tp_free`." msgstr "" msgid "" "Generic handler for the :c:member:`~PyTypeObject.tp_new` slot of a type " -"object. Creates a new instance using the type's :c:member:`~PyTypeObject." -"tp_alloc` slot and returns the resulting object." +"object. Creates a new instance using the " +"type's :c:member:`~PyTypeObject.tp_alloc` slot and returns the resulting " +"object." msgstr "" msgid "" @@ -217,31 +220,31 @@ msgid "" "If some of the base classes implements the GC protocol and the provided type " "does not include the :c:macro:`Py_TPFLAGS_HAVE_GC` in its flags, then the GC " "protocol will be automatically implemented from its parents. On the " -"contrary, if the type being created does include :c:macro:" -"`Py_TPFLAGS_HAVE_GC` in its flags then it **must** implement the GC protocol " -"itself by at least implementing the :c:member:`~PyTypeObject.tp_traverse` " -"handle." +"contrary, if the type being created does " +"include :c:macro:`Py_TPFLAGS_HAVE_GC` in its flags then it **must** " +"implement the GC protocol itself by at least implementing " +"the :c:member:`~PyTypeObject.tp_traverse` handle." msgstr "" msgid "" -"Return the type's name. Equivalent to getting the type's :attr:`~type." -"__name__` attribute." +"Return the type's name. Equivalent to getting the " +"type's :attr:`~type.__name__` attribute." msgstr "" msgid "" -"Return the type's qualified name. Equivalent to getting the type's :attr:" -"`~type.__qualname__` attribute." +"Return the type's qualified name. Equivalent to getting the " +"type's :attr:`~type.__qualname__` attribute." msgstr "" msgid "" "Return the type's fully qualified name. Equivalent to ``f\"{type.__module__}." -"{type.__qualname__}\"``, or :attr:`type.__qualname__` if :attr:`type." -"__module__` is not a string or is equal to ``\"builtins\"``." +"{type.__qualname__}\"``, or :attr:`type.__qualname__` " +"if :attr:`type.__module__` is not a string or is equal to ``\"builtins\"``." msgstr "" msgid "" -"Return the type's module name. Equivalent to getting the :attr:`type." -"__module__` attribute." +"Return the type's module name. Equivalent to getting " +"the :attr:`type.__module__` attribute." msgstr "" msgid "" @@ -282,14 +285,14 @@ msgid "" "not return the intended result. ``Py_TYPE(self)`` may be a *subclass* of the " "intended class, and subclasses are not necessarily defined in the same " "module as their superclass. See :c:type:`PyCMethod` to get the class that " -"defines the method. See :c:func:`PyType_GetModuleByDef` for cases when :c:" -"type:`!PyCMethod` cannot be used." +"defines the method. See :c:func:`PyType_GetModuleByDef` for cases " +"when :c:type:`!PyCMethod` cannot be used." msgstr "" msgid "" "Return the state of the module object associated with the given type. This " -"is a shortcut for calling :c:func:`PyModule_GetState()` on the result of :c:" -"func:`PyType_GetModule`." +"is a shortcut for calling :c:func:`PyModule_GetState()` on the result " +"of :c:func:`PyType_GetModule`." msgstr "" msgid "" @@ -298,8 +301,8 @@ msgid "" msgstr "" msgid "" -"Find the first superclass whose module was created from the given :c:type:" -"`PyModuleDef` *def*, and return that module." +"Find the first superclass whose module was created from the " +"given :c:type:`PyModuleDef` *def*, and return that module." msgstr "" msgid "" @@ -307,16 +310,17 @@ msgid "" msgstr "" msgid "" -"This function is intended to be used together with :c:func:" -"`PyModule_GetState()` to get module state from slot methods (such as :c:" -"member:`~PyTypeObject.tp_init` or :c:member:`~PyNumberMethods.nb_add`) and " -"other places where a method's defining class cannot be passed using the :c:" -"type:`PyCMethod` calling convention." +"This function is intended to be used together " +"with :c:func:`PyModule_GetState()` to get module state from slot methods " +"(such as :c:member:`~PyTypeObject.tp_init` " +"or :c:member:`~PyNumberMethods.nb_add`) and other places where a method's " +"defining class cannot be passed using the :c:type:`PyCMethod` calling " +"convention." msgstr "" msgid "" -"Find the first superclass in *type*'s :term:`method resolution order` whose :" -"c:macro:`Py_tp_token` token is equal to the given one." +"Find the first superclass in *type*'s :term:`method resolution order` " +"whose :c:macro:`Py_tp_token` token is equal to the given one." msgstr "" msgid "" @@ -368,8 +372,8 @@ msgid "" msgstr "" msgid "" -"Create and return a :ref:`heap type ` from the *spec* (see :c:" -"macro:`Py_TPFLAGS_HEAPTYPE`)." +"Create and return a :ref:`heap type ` from the *spec* " +"(see :c:macro:`Py_TPFLAGS_HEAPTYPE`)." msgstr "" msgid "" @@ -385,17 +389,17 @@ msgstr "" msgid "" "The *bases* argument can be used to specify base classes; it can either be " -"only one class or a tuple of classes. If *bases* is ``NULL``, the :c:data:" -"`Py_tp_bases` slot is used instead. If that also is ``NULL``, the :c:data:" -"`Py_tp_base` slot is used instead. If that also is ``NULL``, the new type " -"derives from :class:`object`." +"only one class or a tuple of classes. If *bases* is ``NULL``, " +"the :c:data:`Py_tp_bases` slot is used instead. If that also is ``NULL``, " +"the :c:data:`Py_tp_base` slot is used instead. If that also is ``NULL``, the " +"new type derives from :class:`object`." msgstr "" msgid "" "The *module* argument can be used to record the module in which the new " "class is defined. It must be a module object or ``NULL``. If not ``NULL``, " -"the module is associated with the new type and can later be retrieved with :" -"c:func:`PyType_GetModule`. The associated module is not inherited by " +"the module is associated with the new type and can later be retrieved " +"with :c:func:`PyType_GetModule`. The associated module is not inherited by " "subclasses; it must be specified for each class individually." msgstr "" @@ -403,10 +407,10 @@ msgid "This function calls :c:func:`PyType_Ready` on the new type." msgstr "" msgid "" -"Note that this function does *not* fully match the behavior of calling :py:" -"class:`type() ` or using the :keyword:`class` statement. With user-" -"provided base types or metaclasses, prefer :ref:`calling ` :py:" -"class:`type` (or the metaclass) over ``PyType_From*`` functions. " +"Note that this function does *not* fully match the behavior of " +"calling :py:class:`type() ` or using the :keyword:`class` statement. " +"With user-provided base types or metaclasses, prefer :ref:`calling ` :py:class:`type` (or the metaclass) over ``PyType_From*`` functions. " "Specifically:" msgstr "" @@ -482,8 +486,8 @@ msgid "Name of the type, used to set :c:member:`PyTypeObject.tp_name`." msgstr "" msgid "" -"If positive, specifies the size of the instance in bytes. It is used to set :" -"c:member:`PyTypeObject.tp_basicsize`." +"If positive, specifies the size of the instance in bytes. It is used to " +"set :c:member:`PyTypeObject.tp_basicsize`." msgstr "" msgid "" @@ -493,19 +497,20 @@ msgstr "" msgid "" "If negative, the absolute value specifies how much space instances of the " -"class need *in addition* to the superclass. Use :c:func:" -"`PyObject_GetTypeData` to get a pointer to subclass-specific memory reserved " -"this way. For negative :c:member:`!basicsize`, Python will insert padding " -"when needed to meet :c:member:`~PyTypeObject.tp_basicsize`'s alignment " -"requirements." +"class need *in addition* to the superclass. " +"Use :c:func:`PyObject_GetTypeData` to get a pointer to subclass-specific " +"memory reserved this way. For negative :c:member:`!basicsize`, Python will " +"insert padding when needed to meet :c:member:`~PyTypeObject.tp_basicsize`'s " +"alignment requirements." msgstr "" msgid "Previously, this field could not be negative." msgstr "" msgid "" -"Size of one element of a variable-size type, in bytes. Used to set :c:member:" -"`PyTypeObject.tp_itemsize`. See ``tp_itemsize`` documentation for caveats." +"Size of one element of a variable-size type, in bytes. Used to " +"set :c:member:`PyTypeObject.tp_itemsize`. See ``tp_itemsize`` documentation " +"for caveats." msgstr "" msgid "" @@ -517,7 +522,8 @@ msgid "" msgstr "" msgid "" -"The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize`)." +"The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize` is " +"zero)." msgstr "" msgid "" @@ -537,8 +543,8 @@ msgid "Type flags, used to set :c:member:`PyTypeObject.tp_flags`." msgstr "" msgid "" -"If the ``Py_TPFLAGS_HEAPTYPE`` flag is not set, :c:func:" -"`PyType_FromSpecWithBases` sets it automatically." +"If the ``Py_TPFLAGS_HEAPTYPE`` flag is not " +"set, :c:func:`PyType_FromSpecWithBases` sets it automatically." msgstr "" msgid "" @@ -558,10 +564,9 @@ msgid "A slot ID." msgstr "" msgid "" -"Slot IDs are named like the field names of the structures :c:type:" -"`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:" -"type:`PyMappingMethods` and :c:type:`PyAsyncMethods` with an added ``Py_`` " -"prefix. For example, use:" +"Slot IDs are named like the field names of the " +"structures :c:type:`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:type:`PyMappingMethods` " +"and :c:type:`PyAsyncMethods` with an added ``Py_`` prefix. For example, use:" msgstr "" msgid ":c:data:`Py_tp_dealloc` to set :c:member:`PyTypeObject.tp_dealloc`" @@ -586,13 +591,13 @@ msgid "" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_weaklistoffset` (use :c:macro:" -"`Py_TPFLAGS_MANAGED_WEAKREF` instead if possible)" +":c:member:`~PyTypeObject.tp_weaklistoffset` " +"(use :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` instead if possible)" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_dictoffset` (use :c:macro:" -"`Py_TPFLAGS_MANAGED_DICT` instead if possible)" +":c:member:`~PyTypeObject.tp_dictoffset` " +"(use :c:macro:`Py_TPFLAGS_MANAGED_DICT` instead if possible)" msgstr "" msgid "" @@ -602,8 +607,8 @@ msgstr "" msgid "" "If it is not possible to switch to a ``MANAGED`` flag (for example, for " -"vectorcall or to support Python older than 3.12), specify the offset in :c:" -"data:`Py_tp_members`. See :ref:`PyMemberDef documentation ` for details." msgstr "" @@ -612,29 +617,28 @@ msgid "" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_dict`, :c:member:`~PyTypeObject.tp_mro`, :c:" -"member:`~PyTypeObject.tp_cache`, :c:member:`~PyTypeObject.tp_subclasses`, " +":c:member:`~PyTypeObject.tp_dict`, :c:member:`~PyTypeObject.tp_mro`, :c:member:`~PyTypeObject.tp_cache`, :c:member:`~PyTypeObject.tp_subclasses`, " "and :c:member:`~PyTypeObject.tp_weaklist`." msgstr "" msgid "" "Setting :c:data:`Py_tp_bases` or :c:data:`Py_tp_base` may be problematic on " -"some platforms. To avoid issues, use the *bases* argument of :c:func:" -"`PyType_FromSpecWithBases` instead." +"some platforms. To avoid issues, use the *bases* argument " +"of :c:func:`PyType_FromSpecWithBases` instead." msgstr "" msgid "Slots in :c:type:`PyBufferProcs` may be set in the unlimited API." msgstr "" msgid "" -":c:member:`~PyBufferProcs.bf_getbuffer` and :c:member:`~PyBufferProcs." -"bf_releasebuffer` are now available under the :ref:`limited API `." +":c:member:`~PyBufferProcs.bf_getbuffer` " +"and :c:member:`~PyBufferProcs.bf_releasebuffer` are now available under " +"the :ref:`limited API `." msgstr "" msgid "" -"The field :c:member:`~PyTypeObject.tp_vectorcall` can now be set using :c:" -"data:`Py_tp_vectorcall`. See the field's documentation for details." +"The field :c:member:`~PyTypeObject.tp_vectorcall` can now be set " +"using :c:data:`Py_tp_vectorcall`. See the field's documentation for details." msgstr "" msgid "" @@ -687,13 +691,13 @@ msgid "" msgstr "" msgid "" -"To get the token for a given class (without considering superclasses), use :" -"c:func:`PyType_GetSlot` with ``Py_tp_token``." +"To get the token for a given class (without considering superclasses), " +"use :c:func:`PyType_GetSlot` with ``Py_tp_token``." msgstr "" msgid "" -"Used as a value with :c:data:`Py_tp_token` to set the token to the class's :" -"c:type:`PyType_Spec`. Expands to ``NULL``." +"Used as a value with :c:data:`Py_tp_token` to set the token to the " +"class's :c:type:`PyType_Spec`. Expands to ``NULL``." msgstr "" msgid "object" diff --git a/c-api/typehints.po b/c-api/typehints.po index fbcdc3778e..d4273d8a9b 100644 --- a/c-api/typehints.po +++ b/c-api/typehints.po @@ -36,14 +36,14 @@ msgid "" "Create a :ref:`GenericAlias ` object. Equivalent to " "calling the Python class :class:`types.GenericAlias`. The *origin* and " "*args* arguments set the ``GenericAlias``\\ 's ``__origin__`` and " -"``__args__`` attributes respectively. *origin* should be a :c:expr:" -"`PyTypeObject*`, and *args* can be a :c:expr:`PyTupleObject*` or any " -"``PyObject*``. If *args* passed is not a tuple, a 1-tuple is automatically " -"constructed and ``__args__`` is set to ``(args,)``. Minimal checking is done " -"for the arguments, so the function will succeed even if *origin* is not a " -"type. The ``GenericAlias``\\ 's ``__parameters__`` attribute is constructed " -"lazily from ``__args__``. On failure, an exception is raised and ``NULL`` " -"is returned." +"``__args__`` attributes respectively. *origin* should be " +"a :c:expr:`PyTypeObject*`, and *args* can be a :c:expr:`PyTupleObject*` or " +"any ``PyObject*``. If *args* passed is not a tuple, a 1-tuple is " +"automatically constructed and ``__args__`` is set to ``(args,)``. Minimal " +"checking is done for the arguments, so the function will succeed even if " +"*origin* is not a type. The ``GenericAlias``\\ 's ``__parameters__`` " +"attribute is constructed lazily from ``__args__``. On failure, an exception " +"is raised and ``NULL`` is returned." msgstr "" msgid "Here's an example of how to make an extension type generic::" diff --git a/c-api/typeobj.po b/c-api/typeobj.po index cd166fcbe2..c6b65c37f3 100644 --- a/c-api/typeobj.po +++ b/c-api/typeobj.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,7 +25,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Type Object Structures" -msgstr "" +msgstr "Struktury obiektów typu" msgid "" "Perhaps one of the most important structures of the Python object system is " @@ -35,6 +36,13 @@ msgid "" "they are very important to the interpreter itself and to any extension " "module that implements new types." msgstr "" +"Prawdopodobnie jedną z najważniejszych struktur systemu obiektów Python jest " +"struktura definiująca nowy typ: struktura :c:type:`PyTypeObject`. Obiekty " +"typów można obsługiwać za pomocą dowolnej z funkcja ``PyObject_*`` lub " +"``PyType_*``, ale nie oferują one wiele interesującego dla większości " +"aplikacja Python. Obiekty te są fundamentalne dla zachowania obiektów, " +"dlatego są bardzo ważne dla samego interpreter i rozszerz moduł rozszerzeń " +"wdraża nowe typy." msgid "" "Type objects are fairly large compared to most of the standard types. The " @@ -44,30 +52,38 @@ msgid "" "detail in this section. The fields will be described in the order in which " "they occur in the structure." msgstr "" +"wartośćObiekty typu są dość duże w porównaniu z większością typów " +"standardowych. Wynika to z faktu, że każdy obiekt typu przechowuje dużą " +"liczbę wdraża wartość, głównie wskaźników do funkcja języka C, z których " +"każdy wdraża niewielką część funkcjonalności typu. Pola obiektu typu zostaną " +"szczegółowo omówione w tej sekcji. Zostaną one opisane w kolejności, w " +"jakiej występują w strukturze." msgid "" "In addition to the following quick reference, the :ref:`typedef-examples` " -"section provides at-a-glance insight into the meaning and use of :c:type:" -"`PyTypeObject`." +"section provides at-a-glance insight into the meaning and use " +"of :c:type:`PyTypeObject`." msgstr "" +"Oprócz poniższego szybkiego odniesienia sekcja :ref:`typedef-examples` " +"umożliwia szybki wgląd w znaczenie i użycie :c:type:`PyTypeObject`." msgid "Quick Reference" -msgstr "" +msgstr "Szybkie odniesienie" msgid "\"tp slots\"" -msgstr "" +msgstr "„gniazda tp”" msgid "PyTypeObject Slot [#slots]_" -msgstr "" +msgstr "PyTypeObject Slot 1'[#slots]_'" msgid ":ref:`Type `" msgstr ":ref:`Type `" msgid "special methods/attrs" -msgstr "" +msgstr "metody/atrybuty specjalne" msgid "Info [#cols]_" -msgstr "" +msgstr "Informacje [#cols]_" msgid "O" msgstr "O" @@ -85,7 +101,7 @@ msgid " :c:member:`~PyTypeObject.tp_name`" msgstr " :c:member:`~PyTypeObject.tp_name`" msgid "const char *" -msgstr "" +msgstr "znak stały *" msgid "__name__" msgstr "__name__" @@ -247,7 +263,7 @@ msgid ":c:type:`richcmpfunc`" msgstr ":c:type:`richcmpfunc`" msgid "__lt__, __le__, __eq__, __ne__, __gt__, __ge__" -msgstr "" +msgstr "__lt__, __le__, __eq__, __ne__, __gt__, __ge__" msgid "(:c:member:`~PyTypeObject.tp_weaklistoffset`)" msgstr "(:c:member:`~PyTypeObject.tp_weaklistoffset`)" @@ -382,7 +398,7 @@ msgid "[:c:member:`~PyTypeObject.tp_subclasses`]" msgstr "[:c:member:`~PyTypeObject.tp_subclasses`]" msgid "void *" -msgstr "" +msgstr "próżnia *" msgid "__subclasses__" msgstr "__subclasses__" @@ -420,30 +436,38 @@ msgstr "nieoznaczony typ znakowy" msgid "" "**()**: A slot name in parentheses indicates it is (effectively) deprecated." msgstr "" +"**()**: Nazwa slotu w nawiasach oznacza, że ​​jest on (faktycznie) " +"przestarzały." msgid "" "**<>**: Names in angle brackets should be initially set to ``NULL`` and " "treated as read-only." msgstr "" +"**<>**: Nazwy w nawiasach kątowych powinny być początkowo ustawione na " +"``NULL`` i traktowane jako tylko do odczytu." msgid "**[]**: Names in square brackets are for internal use only." msgstr "" +"**[]**: Nazwy w nawiasach kwadratowych są przeznaczone wyłącznie do użytku " +"wewnętrznego." msgid "" "**** (as a prefix) means the field is required (must be non-``NULL``)." msgstr "" +"**** (jako prefiks) oznacza, że ​​pole jest wymagane (nie może być wartością " +"``NULL``)." msgid "Columns:" -msgstr "" +msgstr "Kolumny:" msgid "**\"O\"**: set on :c:data:`PyBaseObject_Type`" -msgstr "" +msgstr "**\"O\"**: ustawiono na :c:data:`PyBaseObject_Type`" msgid "**\"T\"**: set on :c:data:`PyType_Type`" -msgstr "" +msgstr "**\"T\"**: ustawione na :c:data:`PyType_Type`" msgid "**\"D\"**: default (if slot is set to ``NULL``)" -msgstr "" +msgstr "**\"D\"**: domyślny (jeśli slot jest ustawiony na ``NULL``)" msgid "" "X - PyType_Ready sets this value if it is NULL\n" @@ -452,9 +476,13 @@ msgid "" "\n" "Also see the inheritance column (\"I\")." msgstr "" +"X - PyType_Ready ustawia tę wartość, jeśli jest ona NULL~ - PyType_Ready " +"zawsze ustawia tę wartość (powinna być NULL)? - PyType_Ready może ustawić tę " +"wartość w zależności od innych slotówZobacz także kolumnę dziedziczenia " +"(\"I\")." msgid "**\"I\"**: inheritance" -msgstr "" +msgstr "**\"I\"**: dziedziczenie" msgid "" "X - type slot is inherited via *PyType_Ready* if defined with a *NULL* " @@ -464,20 +492,30 @@ msgid "" "description\n" "? - it's complicated; see the slot's description" msgstr "" +"wartośćX - typ slotu dziedziczony jest przez *PyType_Ready*, jeśli " +"zdefiniowany jest z X - typ slotu dziedziczony jest przez *PyType_Ready*, " +"jeśli zdefiniowany jest z wartość *NULL*% - sloty podstruktury są " +"dziedziczone indywidualnieG - dziedziczone, ale tylko w połączeniu z innymi " +"slotami; zobacz opis slotu? - to skomplikowane; zobacz opis slotu*NULL*% - " +"sloty podstruktury są dziedziczone indywidualnieG - dziedziczone, ale tylko " +"w połączeniu z innymi slotami; zobacz opis slotu? - to skomplikowane; zobacz " +"opis slotu" msgid "" "Note that some slots are effectively inherited through the normal attribute " "lookup chain." msgstr "" +"Należy pamiętać, że niektóre sloty są skutecznie dziedziczone poprzez " +"normalny łańcuch wyszukiwania atrybut." msgid "sub-slots" msgstr "sub-slots" msgid "Slot" -msgstr "" +msgstr "Szczelina" msgid "special methods" -msgstr "" +msgstr "metody specjalne" msgid ":c:member:`~PyAsyncMethods.am_await`" msgstr ":c:member:`~PyAsyncMethods.am_await`" @@ -798,7 +836,7 @@ msgid ":c:func:`getbufferproc`" msgstr ":c:func:`getbufferproc`" msgid "__buffer__" -msgstr "" +msgstr "__bufor__" msgid ":c:member:`~PyBufferProcs.bf_releasebuffer`" msgstr ":c:member:`~PyBufferProcs.bf_releasebuffer`" @@ -807,22 +845,22 @@ msgid ":c:func:`releasebufferproc`" msgstr ":c:func:`releasebufferproc`" msgid "__release_\\ buffer\\__" -msgstr "" +msgstr "__release_\\ bufor\\__" msgid "slot typedefs" -msgstr "" +msgstr "definicje typów gniazd" msgid "typedef" msgstr "typedef" msgid "Parameter Types" -msgstr "" +msgstr "Typy parametr" msgid "Return Type" -msgstr "" +msgstr "Typ zwracać" msgid "void" -msgstr "" +msgstr "próżnia" msgid ":c:type:`visitproc`" msgstr ":c:type:`visitproc`" @@ -843,16 +881,18 @@ msgid ":c:type:`releasebufferproc`" msgstr ":c:type:`releasebufferproc`" msgid "See :ref:`slot-typedefs` below for more detail." -msgstr "" +msgstr "Więcej szczegółów znajdziesz poniżej w :ref:`slot-typedefs`." msgid "PyTypeObject Definition" -msgstr "" +msgstr "Definicja obiektu PyTypeObject" msgid "" -"The structure definition for :c:type:`PyTypeObject` can be found in :file:" -"`Include/cpython/object.h`. For convenience of reference, this repeats the " -"definition found there:" +"The structure definition for :c:type:`PyTypeObject` can be found " +"in :file:`Include/cpython/object.h`. For convenience of reference, this " +"repeats the definition found there:" msgstr "" +"Definicję struktury dla :c:type:`PyTypeObject` można znaleźć w " +"pliku :file:`Include/cpython/object.h`. Dla wygody powtórzono tam definicję:" msgid "" "typedef struct _typeobject {\n" @@ -951,39 +991,117 @@ msgid "" " uint16_t tp_versions_used;\n" "} PyTypeObject;\n" msgstr "" +"typedef struct _typeobject { PyObject_VAR_HEAD const char *tp_name; /* Do " +"drukowania, w formacie \".\" */ Py_ssize_t tp_basicsize, tp_itemsize; /* Do " +"alokacji */ /* Metody do implementacji standardowych operacji */ destruktor " +"tp_dealloc; Py_ssize_t tp_vectorcall_offset; getattrfunc tp_getattr; " +"setattrfunc tp_setattr; PyAsyncMethods *tp_as_async; /* dawniej znane jako " +"tp_compare (Python 2) lub tp_reserved (Python 3) */ reprfunc tp_repr; /* " +"Zestawy metod dla klas standardowych */ PyNumberMethods *tp_as_number; " +"PySequenceMethods *tp_as_sequence; PyMappingMethods *tp_as_mapping; /* " +"Więcej standardowych operacji (tutaj dla zgodności binarnej) */ hashfunc " +"tp_hash; ternaryfunc tp_call;reprfunc tp_str; getattrofunc tp_getattro; " +"setattrofunc tp_setattro; /* Funkcje umożliwiające dostęp do obiektu jako " +"bufora wejścia/wyjścia */ PyBufferProcs *tp_as_buffer; /* Flagi definiujące " +"obecność opcjonalnych/rozszerzonych funkcji */ unsigned long tp_flags; const " +"char *tp_doc; /* Ciąg dokumentacji */ /* Przypisane znaczenie w wersji 2.0 " +"*/ /* wywołanie funkcji dla wszystkich dostępnych obiektów */ traverseproc " +"tp_traverse; /* usunięcie odniesień do zawartych obiektów */ inquiry " +"tp_clear; /* Przypisane znaczenie w wersji 2.1 */ /* rozbudowane porównania " +"*/ richcmpfunc tp_richcompare;/* włączanie słabych odniesień */ Py_ssize_t " +"tp_weaklistoffset; /* Iteratory */ getiterfunc tp_iter; iternextfunc " +"tp_iternext; /* Deskryptor atrybutu i elementy podklas */ PyMethodDef " +"*tp_methods; PyMemberDef *tp_members; PyGetSetDef *tp_getset; // Silne " +"odwołanie do typu sterty, pożyczone odwołanie do typu statycznego " +"PyTypeObject *tp_base; PyObject *tp_dict; descrgetfunc tp_descr_get; " +"descrsetfunc tp_descr_set; Py_ssize_t tp_dictoffset; initproc tp_init; " +"allocfunc tp_alloc;\n" +"typedef struct _typeobject { PyObject_VAR_HEAD const char *tp_name; /* Do " +"wydruku, w formacie \".\" */ Py_ssize_t tp_basicsize, tp_itemsize; /* Do " +"alokacji */ /* Metody implementujące standardowe operacje */ destruktor " +"tp_dealloc; Py_ssize_t tp_vectorcall_offset; getattrfunc tp_getattr; " +"setattrfunc tp_setattr; PyAsyncMethods *tp_as_async; /* dawniej znane jako " +"tp_compare (Python 2) lub tp_reserved (Python 3) */ reprfunc tp_repr; /* " +"Zestawy metod dla klas standardowych */ PyNumberMethods *tp_as_number; " +"PySequenceMethods *tp_as_sequence; PyMappingMethods *tp_as_mapping; /* " +"'{'Więcej standardowych operacji (tutaj dla zgodności binarnej) */ hashfunc " +"tp_hash; ternaryfunc tp_call; reprfunc tp_str; getattrofunc tp_getattro; " +"setattrofunc tp_setattro; /* Funkcje umożliwiające dostęp do obiektu jako " +"bufora wejścia/wyjścia */ PyBufferProcs *tp_as_buffer; /* Flagi definiujące " +"obecność opcjonalnych/rozszerzonych funkcji */ unsigned long tp_flags; const " +"char *tp_doc; /* Ciąg dokumentacji */ /* Przypisane znaczenie w wersji 2.0 " +"*/ /* wywołanie funkcji dla wszystkich dostępnych obiektów */ traverseproc " +"tp_traverse; /* usunięcie odniesień do zawartych obiektów */ inquiry " +"tp_clear; /* Przypisane znaczenie w wersji 2.1 */ /* rozbudowane porównania " +"*/ richcmpfunc tp_richcompare; /* włączanie słabych odniesień */ Py_ssize_t " +"tp_weaklistoffset; /* Iteratory */ getiterfunc tp_iter; iternextfunc " +"tp_iternext; /* Deskryptor atrybutu i elementy podklas */ PyMethodDef " +"*tp_methods; PyMemberDef *tp_members; PyGetSetDef *tp_getset; // Silne " +"odwołanie do typu sterty, pożyczone odwołanie do typu statycznego " +"PyTypeObject *tp_base; PyObject *tp_dict; descrgetfunc tp_descr_get; " +"descrsetfunc tp_descr_set; Py_ssize_t tp_dictoffset; initproc tp_init; " +"allocfunc tp_alloc; newfunc tp_new; freefunc tp_free; /* Procedura niskiego " +"poziomu obsługi wolnej pamięci */ query tp_is_gc; /* Dla PyObject_IS_GC */ " +"PyObject *tp_bases; PyObject *tp_mro; /* kolejność rozwiązywania metod */ " +"PyObject *tp_cache; /* nie jest już używane */ void *tp_subclasses; /* dla " +"statycznych typów wbudowanych jest to indeks */ PyObject *tp_weaklist; /* " +"nie jest używany dla statycznych typów wbudowanych */ destruktor tp_del; /* " +"Atrybut typu znacznik wersji pamięci podręcznej. Dodano w wersji 2.6. * " +"Jeśli zero, pamięć podręczna jest nieprawidłowa i musi zostać zainicjowana. " +"*/ unsigned int tp_version_tag; destruktor tp_finalize; vectorcallfunc " +"tp_vectorcall; /* zestaw bitów, którego type-watchers interesują się tym " +"typem */ unsigned char tp_watched; /* Liczba użytych wartości " +"tp_version_tag. * Ustaw na _Py_ATTR_CACHE_UNUSED, jeśli pamięć podręczna " +"atrybutów jest * wyłączona dla tego typu (np. z powodu niestandardowych " +"wpisów MRO). * W przeciwnym razie ograniczone do MAX_VERSIONS_PER_CLASS " +"(zdefiniowane gdzie indziej). */ uint16_t tp_versions_used; PyTypeObject;\n" msgid "PyObject Slots" -msgstr "" +msgstr "Sloty PyObject" msgid "" -"The type object structure extends the :c:type:`PyVarObject` structure. The :" -"c:member:`~PyVarObject.ob_size` field is used for dynamic types (created by :" -"c:func:`!type_new`, usually called from a class statement). Note that :c:" -"data:`PyType_Type` (the metatype) initializes :c:member:`~PyTypeObject." -"tp_itemsize`, which means that its instances (i.e. type objects) *must* have " +"The type object structure extends the :c:type:`PyVarObject` structure. " +"The :c:member:`~PyVarObject.ob_size` field is used for dynamic types " +"(created by :c:func:`!type_new`, usually called from a class statement). " +"Note that :c:data:`PyType_Type` (the metatype) " +"initializes :c:member:`~PyTypeObject.tp_itemsize`, which means that its " +"instances (i.e. type objects) *must* have " "the :c:member:`~PyVarObject.ob_size` field." msgstr "" +"Struktura obiektu typu rozszerza strukturę :c:type:`PyVarObject`. " +"Pole :c:member:`~PyVarObject.ob_size` jest używane dla typów dynamicznych " +"(tworzonych przez :c:func:`!type_new`, zwykle nazywane 'oświadczeniem' " +"klasowym”). Należy pamiętać, że :c:data:`PyType_Type` (metatyp) " +"inicjuje :c:member:`~PyTypeObject.tp_itemsize`, co oznacza, że ​​jego " +"instancje (tj. obiekty typu) *muszą* mieć " +"pole :c:member:`~PyVarObject.ob_size`." msgid ":c:member:`PyObject.ob_refcnt`" -msgstr "" +msgstr ":c:member:`PyObject.ob_refcnt`" msgid "" "The type object's reference count is initialized to ``1`` by the " "``PyObject_HEAD_INIT`` macro. Note that for :ref:`statically allocated type " -"objects `, the type's instances (objects whose :c:member:" -"`~PyObject.ob_type` points back to the type) do *not* count as references. " -"But for :ref:`dynamically allocated type objects `, the " -"instances *do* count as references." -msgstr "" +"objects `, the type's instances (objects " +"whose :c:member:`~PyObject.ob_type` points back to the type) do *not* count " +"as references. But for :ref:`dynamically allocated type objects `, the instances *do* count as references." +msgstr "" +"Liczba odwołań do obiektu typu jest inicjowana na ``1`` przez makro " +"``PyObject_HEAD_INIT``. Należy pamiętać, że w przypadku :ref:`obiektów typu " +"alokowanych statycznie`, instancje typu (obiekty, " +"których :c:member:`~PyObject.ob_type` wskazuje na typ) *nie* liczą się jako " +"odwołania. Natomiast w przypadku :ref:`obiektów typu alokowanych " +"dynamicznie`, instancje *liczą się* jako odwołania." msgid "**Inheritance:**" -msgstr "" +msgstr "**Dziedzictwo:**" msgid "This field is not inherited by subtypes." -msgstr "" +msgstr "To pole nie jest dziedziczone przez podtypy." msgid ":c:member:`PyObject.ob_type`" -msgstr "" +msgstr ":c:member:`PyObject.ob_type`" msgid "" "This is the type's type, in other words its metatype. It is initialized by " @@ -995,44 +1113,70 @@ msgid "" "explicitly at the start of the module's initialization function, before " "doing anything else. This is typically done like this::" msgstr "" +"funkcjaTo jest typ typu, innymi słowy jego metatyp. Jest on inicjowany przez " +"argument makra ``PyObject_HEAD_INIT``, a jego wartość powinna normalnie " +"wynosić ``&PyType_Type``. Jednak w przypadku dynamicznie ładowalnych modułów " +"rozszerzeń, które muszą działać w systemie Windows (przynajmniej), " +"kompilator zgłasza, ważny że ​​nie jest to inicjator. Dlatego przyjętą " +"konwencją jest przekazywanie ``NULL`` do makro makro ``PyObject_HEAD_INIT`` " +"i jawne inicjowanie tego pola na początku funkcja inicjalizacja modułu, " +"przed wykonaniem jakichkolwiek innych czynności. Zazwyczaj robi się to w " +"następujący sposób:" msgid "Foo_Type.ob_type = &PyType_Type;" -msgstr "" +msgstr "Foo_Type.ob_type = &PyType_Type;" msgid "" -"This should be done before any instances of the type are created. :c:func:" -"`PyType_Ready` checks if :c:member:`~PyObject.ob_type` is ``NULL``, and if " -"so, initializes it to the :c:member:`~PyObject.ob_type` field of the base " -"class. :c:func:`PyType_Ready` will not change this field if it is non-zero." +"This should be done before any instances of the type are " +"created. :c:func:`PyType_Ready` checks if :c:member:`~PyObject.ob_type` is " +"``NULL``, and if so, initializes it to the :c:member:`~PyObject.ob_type` " +"field of the base class. :c:func:`PyType_Ready` will not change this field " +"if it is non-zero." msgstr "" +"Należy to zrobić przed utworzeniem jakichkolwiek wystąpień " +"typu. :c:func:`PyType_Ready` sprawdza, czy :c:member:`~PyObject.ob_type` ma " +"wartość ``NULL``, i jeśli tak, to inicjuje go w " +"polu :c:member:`~PyObject.ob_type` klasa bazowa. :c:func:`PyType_Ready` nie " +"zmieni tego pola, jeśli ma ono wartość różną od zera." msgid "This field is inherited by subtypes." -msgstr "" +msgstr "To pole jest dziedziczone przez podtypy." msgid "PyVarObject Slots" -msgstr "" +msgstr "Sloty PyVarObject" msgid ":c:member:`PyVarObject.ob_size`" -msgstr "" +msgstr ":c:member:`PyVarObject.ob_size`" msgid "" "For :ref:`statically allocated type objects `, this should be " "initialized to zero. For :ref:`dynamically allocated type objects `, this field has a special internal meaning." msgstr "" +"W przypadku obiektów typu :ref:`statycznie przydzielanych`, '`' pole to powinno zostać zainicjowane zerem. W przypadku obiektów " +"typu ' :ref:`dynamicznie przydzielanych`, pole to ma specjalne " +"'`' znaczenie wewnętrzne." msgid "This field should be accessed using the :c:func:`Py_SIZE()` macro." msgstr "" +"Dostęp do tego pola należy uzyskać za pomocą makro :c:func:`Py_SIZE()`." msgid "PyTypeObject Slots" -msgstr "" +msgstr "Sloty PyTypeObject" msgid "" "Each slot has a section describing inheritance. If :c:func:`PyType_Ready` " "may set a value when the field is set to ``NULL`` then there will also be a " -"\"Default\" section. (Note that many fields set on :c:data:" -"`PyBaseObject_Type` and :c:data:`PyType_Type` effectively act as defaults.)" +"\"Default\" section. (Note that many fields set " +"on :c:data:`PyBaseObject_Type` and :c:data:`PyType_Type` effectively act as " +"defaults.)" msgstr "" +"wartośćKażdy slot ma sekcję opisującą dziedziczenie. " +"Jeśli :c:func:`PyType_Ready` może ustawić wartość, gdy pole jest ustawione " +"na ``NULL``, pojawi się również sekcja „domyślny”. (Należy pamiętać, że " +"wiele pól ustawionych w :c:data:`PyBaseObject_Type` i :c:data:`PyType_Type` " +"działa jako wartość domyślne)." msgid "" "Pointer to a NUL-terminated string containing the name of the type. For " @@ -1040,16 +1184,27 @@ msgid "" "module name, followed by a dot, followed by the type name; for built-in " "types, it should be just the type name. If the module is a submodule of a " "package, the full package name is part of the full module name. For " -"example, a type named :class:`!T` defined in module :mod:`!M` in subpackage :" -"mod:`!Q` in package :mod:`!P` should have the :c:member:`~PyTypeObject." -"tp_name` initializer ``\"P.Q.M.T\"``." +"example, a type named :class:`!T` defined in module :mod:`!M` in " +"subpackage :mod:`!Q` in package :mod:`!P` should have " +"the :c:member:`~PyTypeObject.tp_name` initializer ``\"P.Q.M.T\"``." msgstr "" +"Wskaźnik do napis ciągu zakończyć znakiem NUL, zawierającego nazwę typu. W " +"przypadku typów dostępnych jako zmienne napis globalne modułu ciąg powinien " +"składać się z pełnej nazwy modułu, po której następuje kropka i nazwa typu; " +"w przypadku typów wbudowany(-a) powinna to być po prostu nazwa typu. Jeśli " +"moduł jest podmodułem wbudowany(-a) pakiet, pełna nazwa pakiet jest częścią " +"pełnej nazwy modułu. Na przykład typ o nazwie :class:`!T` zdefiniowany w " +"module :mod:`!M` w subpakiet :mod:`!Q` w pakiet :mod:`!P` powinien mieć " +"inicjator :c:member:`~PyTypeObject.tp_name` ``\"P.Q.M.T\"``." msgid "" "For :ref:`dynamically allocated type objects `, this should just " "be the type name, and the module name explicitly stored in the type dict as " "the value for key ``'__module__'``." msgstr "" +"W przypadku :ref:`obiektów typu przydzielanych dynamicznie` powinna to być " +"po prostu nazwa typu i nazwa moduł jawnie '`' zapisane w " +"słowniku typów jako wartość klucza ``'__module__'``." msgid "" "For :ref:`statically allocated type objects `, the *tp_name* " @@ -1057,41 +1212,65 @@ msgid "" "accessible as the :attr:`~type.__module__` attribute, and everything after " "the last dot is made accessible as the :attr:`~type.__name__` attribute." msgstr "" +"W przypadku obiektów typu :ref:`statycznie alokowanych` pole *tp_name* " +"powinno zawierać kropkę. Wszystko przed ostatnią kropką jest udostępniane " +"jako atrybut :attr:`~type.__module__`, a wszystko po ostatniej kropce jest " +"udostępniane jako atrybut :attr:`~type.__name__`." msgid "" "If no dot is present, the entire :c:member:`~PyTypeObject.tp_name` field is " -"made accessible as the :attr:`~type.__name__` attribute, and the :attr:" -"`~type.__module__` attribute is undefined (unless explicitly set in the " -"dictionary, as explained above). This means your type will be impossible to " -"pickle. Additionally, it will not be listed in module documentations " -"created with pydoc." +"made accessible as the :attr:`~type.__name__` attribute, and " +"the :attr:`~type.__module__` attribute is undefined (unless explicitly set " +"in the dictionary, as explained above). This means your type will be " +"impossible to pickle. Additionally, it will not be listed in module " +"documentations created with pydoc." msgstr "" +"Jeśli kropka nie jest obecna, całe pole :c:member:`~PyTypeObject.tp_name` " +"jest dostępne jako atrybut :attr:`~type.__name__`, a " +"atrybut :attr:`~type.__module__` jest niezdefiniowany (chyba że zostanie " +"jawnie ustawiony w słowniku, jak wyjaśniono powyżej). Oznacza to, że Twój " +"typ nie będzie mógł zostać zamarynowany. Dodatkowo nie będzie on wymieniony " +"w dokumentacji modułó utworzonej za pomocą pydoc." msgid "" -"This field must not be ``NULL``. It is the only required field in :c:func:" -"`PyTypeObject` (other than potentially :c:member:`~PyTypeObject." -"tp_itemsize`)." +"This field must not be ``NULL``. It is the only required field " +"in :c:func:`PyTypeObject` (other than " +"potentially :c:member:`~PyTypeObject.tp_itemsize`)." msgstr "" +"To pole nie może mieć wartości ``NULL``. Jest to jedyne wymagane pole " +"w :c:func:`PyTypeObject` (oprócz " +"potencjalnie :c:member:`~PyTypeObject.tp_itemsize`)." msgid "" "These fields allow calculating the size in bytes of instances of the type." msgstr "" +"Pola te umożliwiają obliczenie rozmiaru instancji danego typu w bajtach." msgid "" -"There are two kinds of types: types with fixed-length instances have a zero :" -"c:member:`!tp_itemsize` field, types with variable-length instances have a " -"non-zero :c:member:`!tp_itemsize` field. For a type with fixed-length " -"instances, all instances have the same size, given in :c:member:`!" -"tp_basicsize`. (Exceptions to this rule can be made using :c:func:" -"`PyUnstable_Object_GC_NewWithExtraData`.)" +"There are two kinds of types: types with fixed-length instances have a " +"zero :c:member:`!tp_itemsize` field, types with variable-length instances " +"have a non-zero :c:member:`!tp_itemsize` field. For a type with fixed-" +"length instances, all instances have the same size, given in :c:member:`!" +"tp_basicsize`. (Exceptions to this rule can be made " +"using :c:func:`PyUnstable_Object_GC_NewWithExtraData`.)" msgstr "" +"Istnieją dwa rodzaje typów: typy o stałej długość instancja mają " +"pole :c:member:`!tp_itemsize` zerowe, typy o zmiennej długość instancja mają " +"pole :c:member:`!tp_itemsize` niezerowe. W przypadku typu o stałej długość " +"instancja wszystkie instancja mają ten sam rozmiar, określony w " +"polu :c:member:`!tp_basicsize`. (Wyjątki od tej reguły można utworzyć za " +"pomocą :c:func:`PyUnstable_Object_GC_NewWithExtraData`)." msgid "" -"For a type with variable-length instances, the instances must have an :c:" -"member:`~PyVarObject.ob_size` field, and the instance size is :c:member:`!" -"tp_basicsize` plus N times :c:member:`!tp_itemsize`, where N is the " -"\"length\" of the object." +"For a type with variable-length instances, the instances must have " +"an :c:member:`~PyVarObject.ob_size` field, and the instance size " +"is :c:member:`!tp_basicsize` plus N times :c:member:`!tp_itemsize`, where N " +"is the \"length\" of the object." msgstr "" +"W przypadku typu z instancjami o zmiennej długość, instancje muszą mieć " +"pole :c:member:`~PyVarObject.ob_size`, a rozmiar instancja " +"wynosi :c:member:`!tp_basicsize` plus N razy :c:member:`!tp_itemsize`, gdzie " +"N to długość obiektu." msgid "" "Functions like :c:func:`PyObject_NewVar` will take the value of N as an " @@ -1099,44 +1278,74 @@ msgid "" "field. Note that the :c:member:`~PyVarObject.ob_size` field may later be " "used for other purposes. For example, :py:type:`int` instances use the bits " "of :c:member:`~PyVarObject.ob_size` in an implementation-defined way; the " -"underlying storage and its size should be accessed using :c:func:" -"`PyLong_Export`." +"underlying storage and its size should be accessed " +"using :c:func:`PyLong_Export`." msgstr "" +"Funkcja takie jak :c:func:`PyObject_NewVar` przyjmują wartość N jako " +"argument i zapisują ją w polu :c:member:`~PyVarObject.ob_size` instancja. " +"Należy pamiętać, że pole cel:c:member:`~PyVarObject.ob_size` może być " +"później wdrożenie do innych celów. Na przykład instancja :py:type:`int` " +"używają bitów :c:member:`~PyVarObject.ob_size` w sposób zdefiniowany w " +"implementacji; dostęp do pamięci masowej i jej rozmiaru powinien być możliwy " +"za pomocą :c:func:`PyLong_Export`." msgid "" -"The :c:member:`~PyVarObject.ob_size` field should be accessed using the :c:" -"func:`Py_SIZE()` and :c:func:`Py_SET_SIZE()` macros." +"The :c:member:`~PyVarObject.ob_size` field should be accessed using " +"the :c:func:`Py_SIZE()` and :c:func:`Py_SET_SIZE()` macros." msgstr "" +"Do pola :c:member:`~PyVarObject.ob_size` należy uzyskać dostęp za pomocą " +"makr :c:func:`Py_SIZE()` i :c:func:`Py_SET_SIZE()` makro." msgid "" "Also, the presence of an :c:member:`~PyVarObject.ob_size` field in the " "instance layout doesn't mean that the instance structure is variable-length. " "For example, the :py:type:`list` type has fixed-length instances, yet those " -"instances have a :c:member:`~PyVarObject.ob_size` field. (As with :py:type:" -"`int`, avoid reading lists' :c:member:`!ob_size` directly. Call :c:func:" -"`PyList_Size` instead.)" +"instances have a :c:member:`~PyVarObject.ob_size` field. (As " +"with :py:type:`int`, avoid reading lists' :c:member:`!ob_size` directly. " +"Call :c:func:`PyList_Size` instead.)" msgstr "" +"Ponadto obecność pola :c:member:`~PyVarObject.ob_size` w układzie instancja " +"nie oznacza, że ​​struktura instancja ma zmienną długość. Na przykład " +"typ :py:type:`list` ma instancja o stałej długość, a mimo to instancja te " +"mają pole :c:member:`~PyVarObject.ob_size`. (Podobnie jak w " +"przypadku :py:type:`int`, należy unikać bezpośredniego odczytywania " +"pola :c:member:`!ob_size` list. Zamiast tego należy " +"wywołać :c:func:`PyList_Size`)." msgid "" -"The :c:member:`!tp_basicsize` includes size needed for data of the type's :c:" -"member:`~PyTypeObject.tp_base`, plus any extra data needed by each instance." +"The :c:member:`!tp_basicsize` includes size needed for data of the " +"type's :c:member:`~PyTypeObject.tp_base`, plus any extra data needed by each " +"instance." msgstr "" +":c:member:`!tp_basicsize` obejmuje rozmiar potrzebny dla danych " +"typu :c:member:`~PyTypeObject.tp_base`, plus wszelkie dodatkowe dane " +"potrzebne każdej instancja." msgid "" "The correct way to set :c:member:`!tp_basicsize` is to use the ``sizeof`` " "operator on the struct used to declare the instance layout. This struct must " -"include the struct used to declare the base type. In other words, :c:member:" -"`!tp_basicsize` must be greater than or equal to the base's :c:member:`!" -"tp_basicsize`." +"include the struct used to declare the base type. In other " +"words, :c:member:`!tp_basicsize` must be greater than or equal to the " +"base's :c:member:`!tp_basicsize`." msgstr "" +"Prawidłowym sposobem ustawienia :c:member:`!tp_basicsize` jest użycie " +"operatora ``sizeof`` w strukturze użytej do zadeklarowania układu instancja. " +"Struktura ta musi zawierać strukturę użytą do zadeklarowania typu bazowego. " +"Innymi słowy, :c:member:`!tp_basicsize` musi być większe lub " +"równe :c:member:`!tp_basicsize` elementu bazowego." msgid "" "Since every type is a subtype of :py:type:`object`, this struct must " -"include :c:type:`PyObject` or :c:type:`PyVarObject` (depending on whether :c:" -"member:`~PyVarObject.ob_size` should be included). These are usually defined " -"by the macro :c:macro:`PyObject_HEAD` or :c:macro:`PyObject_VAR_HEAD`, " -"respectively." +"include :c:type:`PyObject` or :c:type:`PyVarObject` (depending on " +"whether :c:member:`~PyVarObject.ob_size` should be included). These are " +"usually defined by the macro :c:macro:`PyObject_HEAD` " +"or :c:macro:`PyObject_VAR_HEAD`, respectively." msgstr "" +"Ponieważ każdy typ jest podtypem :py:type:`object`, ta struktura musi " +"zawierać :c:type:`PyObject` lub :c:type:`PyVarObject` (w zależności od tego, " +"czy :c:member:`~PyVarObject.ob_size` ma być uwzględniony). Są one zazwyczaj " +"definiowane odpowiednio przez makro :c:macro:`PyObject_HEAD` " +"lub :c:macro:`PyObject_VAR_HEAD`." msgid "" "The basic size does not include the GC header size, as that header is not " @@ -1144,8 +1353,8 @@ msgid "" msgstr "" msgid "" -"For cases where struct used to declare the base type is unknown, see :c:" -"member:`PyType_Spec.basicsize` and :c:func:`PyType_FromMetaclass`." +"For cases where struct used to declare the base type is unknown, " +"see :c:member:`PyType_Spec.basicsize` and :c:func:`PyType_FromMetaclass`." msgstr "" msgid "Notes about alignment:" @@ -1194,10 +1403,11 @@ msgid "" msgstr "" msgid "" -"If you may call functions that may set the error indicator, you must use :c:" -"func:`PyErr_GetRaisedException` and :c:func:`PyErr_SetRaisedException` to " -"ensure you don't clobber a preexisting error indicator (the deallocation " -"could have occurred while processing a different error):" +"If you may call functions that may set the error indicator, you must " +"use :c:func:`PyErr_GetRaisedException` " +"and :c:func:`PyErr_SetRaisedException` to ensure you don't clobber a " +"preexisting error indicator (the deallocation could have occurred while " +"processing a different error):" msgstr "" msgid "" @@ -1222,14 +1432,14 @@ msgstr "" msgid "" "Python will destroy an object immediately or some time after the final " -"reference to the object is deleted, unless its finalizer (:c:member:" -"`~PyTypeObject.tp_finalize`) subsequently resurrects the object." +"reference to the object is deleted, unless its finalizer " +"(:c:member:`~PyTypeObject.tp_finalize`) subsequently resurrects the object." msgstr "" msgid "" -"An object will not be destroyed while it is being automatically finalized (:" -"c:member:`~PyTypeObject.tp_finalize`) or automatically cleared (:c:member:" -"`~PyTypeObject.tp_clear`)." +"An object will not be destroyed while it is being automatically finalized " +"(:c:member:`~PyTypeObject.tp_finalize`) or automatically cleared " +"(:c:member:`~PyTypeObject.tp_clear`)." msgstr "" msgid "" @@ -1251,17 +1461,17 @@ msgid "" msgstr "" msgid "" -"It is permissible to call :c:member:`~PyTypeObject.tp_clear` from :c:member:" -"`!tp_dealloc` to reduce code duplication and to guarantee that the object is " -"always cleared before destruction. Beware that :c:member:`!tp_clear` might " -"have already been called." +"It is permissible to call :c:member:`~PyTypeObject.tp_clear` " +"from :c:member:`!tp_dealloc` to reduce code duplication and to guarantee " +"that the object is always cleared before destruction. Beware " +"that :c:member:`!tp_clear` might have already been called." msgstr "" msgid "" "If the type is heap allocated (:c:macro:`Py_TPFLAGS_HEAPTYPE`), the " -"deallocator should release the owned reference to its type object (via :c:" -"func:`Py_DECREF`) after calling the type deallocator. See the example code " -"below.::" +"deallocator should release the owned reference to its type object " +"(via :c:func:`Py_DECREF`) after calling the type deallocator. See the " +"example code below.::" msgstr "" msgid "" @@ -1361,10 +1571,10 @@ msgid "" msgstr "" msgid "" -"Any class that sets ``Py_TPFLAGS_HAVE_VECTORCALL`` must also set :c:member:" -"`~PyTypeObject.tp_call` and make sure its behaviour is consistent with the " -"*vectorcallfunc* function. This can be done by setting *tp_call* to :c:func:" -"`PyVectorcall_Call`." +"Any class that sets ``Py_TPFLAGS_HAVE_VECTORCALL`` must also " +"set :c:member:`~PyTypeObject.tp_call` and make sure its behaviour is " +"consistent with the *vectorcallfunc* function. This can be done by setting " +"*tp_call* to :c:func:`PyVectorcall_Call`." msgstr "" msgid "" @@ -1374,18 +1584,18 @@ msgstr "" msgid "" "Before version 3.12, it was not recommended for :ref:`mutable heap types " -"` to implement the vectorcall protocol. When a user sets :attr:" -"`~object.__call__` in Python code, only *tp_call* is updated, likely making " -"it inconsistent with the vectorcall function. Since 3.12, setting " -"``__call__`` will disable vectorcall optimization by clearing the :c:macro:" -"`Py_TPFLAGS_HAVE_VECTORCALL` flag." +"` to implement the vectorcall protocol. When a user " +"sets :attr:`~object.__call__` in Python code, only *tp_call* is updated, " +"likely making it inconsistent with the vectorcall function. Since 3.12, " +"setting ``__call__`` will disable vectorcall optimization by clearing " +"the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag." msgstr "" msgid "" -"This field is always inherited. However, the :c:macro:" -"`Py_TPFLAGS_HAVE_VECTORCALL` flag is not always inherited. If it's not set, " -"then the subclass won't use :ref:`vectorcall `, except when :c:" -"func:`PyVectorcall_Call` is explicitly called." +"This field is always inherited. However, " +"the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag is not always inherited. If " +"it's not set, then the subclass won't use :ref:`vectorcall `, " +"except when :c:func:`PyVectorcall_Call` is explicitly called." msgstr "" msgid "An optional pointer to the get-attribute-string function." @@ -1398,17 +1608,16 @@ msgid "" "attribute name." msgstr "" -msgid "" -"Group: :c:member:`~PyTypeObject.tp_getattr`, :c:member:`~PyTypeObject." -"tp_getattro`" +msgid "Group: :c:member:`~PyTypeObject.tp_getattr`, :c:member:`~PyTypeObject.tp_getattro`" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_getattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_getattro`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_getattr` " "and :c:member:`~PyTypeObject.tp_getattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_getattr` and :c:member:`~PyTypeObject." -"tp_getattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_getattr` " +"and :c:member:`~PyTypeObject.tp_getattro` are both ``NULL``." msgstr "" msgid "" @@ -1422,17 +1631,16 @@ msgid "" "attribute name." msgstr "" -msgid "" -"Group: :c:member:`~PyTypeObject.tp_setattr`, :c:member:`~PyTypeObject." -"tp_setattro`" +msgid "Group: :c:member:`~PyTypeObject.tp_setattr`, :c:member:`~PyTypeObject.tp_setattro`" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_setattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_setattro`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_setattr` " "and :c:member:`~PyTypeObject.tp_setattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_setattr` and :c:member:`~PyTypeObject." -"tp_setattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_setattr` " +"and :c:member:`~PyTypeObject.tp_setattro` are both ``NULL``." msgstr "" msgid "" @@ -1450,8 +1658,8 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a function that implements the built-in function :" -"func:`repr`." +"An optional pointer to a function that implements the built-in " +"function :func:`repr`." msgstr "" msgid "The signature is the same as for :c:func:`PyObject_Repr`::" @@ -1511,8 +1719,8 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a function that implements the built-in function :" -"func:`hash`." +"An optional pointer to a function that implements the built-in " +"function :func:`hash`." msgstr "" msgid "The signature is the same as for :c:func:`PyObject_Hash`::" @@ -1529,9 +1737,9 @@ msgstr "" msgid "" "When this field is not set (*and* :c:member:`~PyTypeObject.tp_richcompare` " -"is not set), an attempt to take the hash of the object raises :exc:" -"`TypeError`. This is the same as setting it to :c:func:" -"`PyObject_HashNotImplemented`." +"is not set), an attempt to take the hash of the object " +"raises :exc:`TypeError`. This is the same as setting it " +"to :c:func:`PyObject_HashNotImplemented`." msgstr "" msgid "" @@ -1540,21 +1748,20 @@ msgid "" "as the equivalent of ``__hash__ = None`` at the Python level, causing " "``isinstance(o, collections.Hashable)`` to correctly return ``False``. Note " "that the converse is also true - setting ``__hash__ = None`` on a class at " -"the Python level will result in the ``tp_hash`` slot being set to :c:func:" -"`PyObject_HashNotImplemented`." +"the Python level will result in the ``tp_hash`` slot being set " +"to :c:func:`PyObject_HashNotImplemented`." msgstr "" -msgid "" -"Group: :c:member:`~PyTypeObject.tp_hash`, :c:member:`~PyTypeObject." -"tp_richcompare`" +msgid "Group: :c:member:`~PyTypeObject.tp_hash`, :c:member:`~PyTypeObject.tp_richcompare`" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_richcompare`: a subtype inherits both of :c:member:`~PyTypeObject." -"tp_richcompare` and :c:member:`~PyTypeObject.tp_hash`, when the subtype's :c:" -"member:`~PyTypeObject.tp_richcompare` and :c:member:`~PyTypeObject.tp_hash` " -"are both ``NULL``." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_richcompare`: a subtype inherits both " +"of :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash`, when the " +"subtype's :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash` are both ``NULL``." msgstr "" msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericHash`." @@ -1570,11 +1777,11 @@ msgid "PyObject *tp_call(PyObject *self, PyObject *args, PyObject *kwargs);" msgstr "" msgid "" -"An optional pointer to a function that implements the built-in operation :" -"func:`str`. (Note that :class:`str` is a type now, and :func:`str` calls " -"the constructor for that type. This constructor calls :c:func:" -"`PyObject_Str` to do the actual work, and :c:func:`PyObject_Str` will call " -"this handler.)" +"An optional pointer to a function that implements the built-in " +"operation :func:`str`. (Note that :class:`str` is a type now, " +"and :func:`str` calls the constructor for that type. This constructor " +"calls :c:func:`PyObject_Str` to do the actual work, " +"and :c:func:`PyObject_Str` will call this handler.)" msgstr "" msgid "The signature is the same as for :c:func:`PyObject_Str`::" @@ -1605,17 +1812,18 @@ msgid "PyObject *tp_getattro(PyObject *self, PyObject *attr);" msgstr "" msgid "" -"It is usually convenient to set this field to :c:func:" -"`PyObject_GenericGetAttr`, which implements the normal way of looking for " -"object attributes." +"It is usually convenient to set this field " +"to :c:func:`PyObject_GenericGetAttr`, which implements the normal way of " +"looking for object attributes." msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_getattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_getattr`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_getattr` " "and :c:member:`~PyTypeObject.tp_getattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_getattr` and :c:member:`~PyTypeObject." -"tp_getattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_getattr` " +"and :c:member:`~PyTypeObject.tp_getattro` are both ``NULL``." msgstr "" msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericGetAttr`." @@ -1629,17 +1837,18 @@ msgstr "" msgid "" "In addition, setting *value* to ``NULL`` to delete an attribute must be " -"supported. It is usually convenient to set this field to :c:func:" -"`PyObject_GenericSetAttr`, which implements the normal way of setting object " -"attributes." +"supported. It is usually convenient to set this field " +"to :c:func:`PyObject_GenericSetAttr`, which implements the normal way of " +"setting object attributes." msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_setattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_setattr`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_setattr` " "and :c:member:`~PyTypeObject.tp_setattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_setattr` and :c:member:`~PyTypeObject." -"tp_setattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_setattr` " +"and :c:member:`~PyTypeObject.tp_setattro` are both ``NULL``." msgstr "" msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericSetAttr`." @@ -1659,12 +1868,12 @@ msgstr "" msgid "" "This field is a bit mask of various flags. Some flags indicate variant " "semantics for certain situations; others are used to indicate that certain " -"fields in the type object (or in the extension structures referenced via :c:" -"member:`~PyTypeObject.tp_as_number`, :c:member:`~PyTypeObject." -"tp_as_sequence`, :c:member:`~PyTypeObject.tp_as_mapping`, and :c:member:" -"`~PyTypeObject.tp_as_buffer`) that were historically not always present are " -"valid; if such a flag bit is clear, the type fields it guards must not be " -"accessed and must be considered to have a zero or ``NULL`` value instead." +"fields in the type object (or in the extension structures referenced " +"via :c:member:`~PyTypeObject.tp_as_number`, :c:member:`~PyTypeObject.tp_as_sequence`, :c:member:`~PyTypeObject.tp_as_mapping`, " +"and :c:member:`~PyTypeObject.tp_as_buffer`) that were historically not " +"always present are valid; if such a flag bit is clear, the type fields it " +"guards must not be accessed and must be considered to have a zero or " +"``NULL`` value instead." msgstr "" msgid "" @@ -1675,10 +1884,11 @@ msgid "" "type's value of the flag bit is copied into the subtype together with a " "pointer to the extension structure. The :c:macro:`Py_TPFLAGS_HAVE_GC` flag " "bit is inherited together with the :c:member:`~PyTypeObject.tp_traverse` " -"and :c:member:`~PyTypeObject.tp_clear` fields, i.e. if the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and the :c:member:" -"`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject.tp_clear` fields in " -"the subtype exist and have ``NULL`` values." +"and :c:member:`~PyTypeObject.tp_clear` fields, i.e. if " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and " +"the :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields in the subtype exist and have " +"``NULL`` values." msgstr "" msgid "" @@ -1691,10 +1901,10 @@ msgstr "" msgid "" "The following bit masks are currently defined; these can be ORed together " -"using the ``|`` operator to form the value of the :c:member:`~PyTypeObject." -"tp_flags` field. The macro :c:func:`PyType_HasFeature` takes a type and a " -"flags value, *tp* and *f*, and checks whether ``tp->tp_flags & f`` is non-" -"zero." +"using the ``|`` operator to form the value of " +"the :c:member:`~PyTypeObject.tp_flags` field. The " +"macro :c:func:`PyType_HasFeature` takes a type and a flags value, *tp* and " +"*f*, and checks whether ``tp->tp_flags & f`` is non-zero." msgstr "" msgid "" @@ -1704,9 +1914,9 @@ msgid "" "a reference to the type, and the type object is INCREF'ed when a new " "instance is created, and DECREF'ed when an instance is destroyed (this does " "not apply to instances of subtypes; only the type referenced by the " -"instance's ob_type gets INCREF'ed or DECREF'ed). Heap types should also :ref:" -"`support garbage collection ` as they can form a " -"reference cycle with their own module object." +"instance's ob_type gets INCREF'ed or DECREF'ed). Heap types should " +"also :ref:`support garbage collection ` as they " +"can form a reference cycle with their own module object." msgstr "" msgid "???" @@ -1719,8 +1929,8 @@ msgid "" msgstr "" msgid "" -"This bit is set when the type object has been fully initialized by :c:func:" -"`PyType_Ready`." +"This bit is set when the type object has been fully initialized " +"by :c:func:`PyType_Ready`." msgstr "" msgid "" @@ -1731,24 +1941,23 @@ msgstr "" msgid "" "This bit is set when the object supports garbage collection. If this bit is " "set, memory for new instances (see :c:member:`~PyTypeObject.tp_alloc`) must " -"be allocated using :c:macro:`PyObject_GC_New` or :c:func:" -"`PyType_GenericAlloc` and deallocated (see :c:member:`~PyTypeObject." -"tp_free`) using :c:func:`PyObject_GC_Del`. More information in section :ref:" -"`supporting-cycle-detection`." +"be allocated using :c:macro:`PyObject_GC_New` " +"or :c:func:`PyType_GenericAlloc` and deallocated " +"(see :c:member:`~PyTypeObject.tp_free`) using :c:func:`PyObject_GC_Del`. " +"More information in section :ref:`supporting-cycle-detection`." msgstr "" -msgid "" -"Group: :c:macro:`Py_TPFLAGS_HAVE_GC`, :c:member:`~PyTypeObject." -"tp_traverse`, :c:member:`~PyTypeObject.tp_clear`" +msgid "Group: :c:macro:`Py_TPFLAGS_HAVE_GC`, :c:member:`~PyTypeObject.tp_traverse`, :c:member:`~PyTypeObject.tp_clear`" msgstr "" msgid "" -"The :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is inherited together with the :c:" -"member:`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject.tp_clear` " -"fields, i.e. if the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is clear in the " -"subtype and the :c:member:`~PyTypeObject.tp_traverse` and :c:member:" -"`~PyTypeObject.tp_clear` fields in the subtype exist and have ``NULL`` " -"values." +"The :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is inherited together with " +"the :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields, i.e. if " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and " +"the :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields in the subtype exist and have " +"``NULL`` values." msgstr "" msgid "" @@ -1774,21 +1983,21 @@ msgid "" msgstr "" msgid "" -"This flag enables an optimization for typical method calls like ``obj." -"meth()``: it avoids creating a temporary \"bound method\" object for ``obj." -"meth``." +"This flag enables an optimization for typical method calls like " +"``obj.meth()``: it avoids creating a temporary \"bound method\" object for " +"``obj.meth``." msgstr "" msgid "" -"This flag is never inherited by types without the :c:macro:" -"`Py_TPFLAGS_IMMUTABLETYPE` flag set. For extension types, it is inherited " -"whenever :c:member:`~PyTypeObject.tp_descr_get` is inherited." +"This flag is never inherited by types without " +"the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag set. For extension types, it " +"is inherited whenever :c:member:`~PyTypeObject.tp_descr_get` is inherited." msgstr "" msgid "" -"This bit indicates that instances of the class have a :attr:`~object." -"__dict__` attribute, and that the space for the dictionary is managed by the " -"VM." +"This bit indicates that instances of the class have " +"a :attr:`~object.__dict__` attribute, and that the space for the dictionary " +"is managed by the VM." msgstr "" msgid "If this flag is set, :c:macro:`Py_TPFLAGS_HAVE_GC` should also be set." @@ -1810,13 +2019,13 @@ msgid "" msgstr "" msgid "" -"This flag is inherited unless the :c:member:`~PyTypeObject." -"tp_weaklistoffset` field is set in a superclass." +"This flag is inherited unless " +"the :c:member:`~PyTypeObject.tp_weaklistoffset` field is set in a superclass." msgstr "" msgid "" -"Only usable with variable-size types, i.e. ones with non-zero :c:member:" -"`~PyTypeObject.tp_itemsize`." +"Only usable with variable-size types, i.e. ones with non-" +"zero :c:member:`~PyTypeObject.tp_itemsize`." msgstr "" msgid "" @@ -1834,13 +2043,14 @@ msgid "This flag is inherited." msgstr "" msgid "" -"Functions such as :c:func:`PyLong_Check` will call :c:func:" -"`PyType_FastSubclass` with one of these flags to quickly determine if a type " -"is a subclass of a built-in type; such specific checks are faster than a " -"generic check, like :c:func:`PyObject_IsInstance`. Custom types that inherit " -"from built-ins should have their :c:member:`~PyTypeObject.tp_flags` set " -"appropriately, or the code that interacts with such types will behave " -"differently depending on what kind of check is used." +"Functions such as :c:func:`PyLong_Check` will " +"call :c:func:`PyType_FastSubclass` with one of these flags to quickly " +"determine if a type is a subclass of a built-in type; such specific checks " +"are faster than a generic check, like :c:func:`PyObject_IsInstance`. Custom " +"types that inherit from built-ins should have " +"their :c:member:`~PyTypeObject.tp_flags` set appropriately, or the code that " +"interacts with such types will behave differently depending on what kind of " +"check is used." msgstr "" msgid "" @@ -1849,8 +2059,9 @@ msgid "" msgstr "" msgid "" -"This flag isn't necessary anymore, as the interpreter assumes the :c:member:" -"`~PyTypeObject.tp_finalize` slot is always present in the type structure." +"This flag isn't necessary anymore, as the interpreter assumes " +"the :c:member:`~PyTypeObject.tp_finalize` slot is always present in the type " +"structure." msgstr "" msgid "" @@ -1872,8 +2083,8 @@ msgid "" msgstr "" msgid "" -"This flag is now removed from a class when the class's :py:meth:`~object." -"__call__` method is reassigned." +"This flag is now removed from a class when the " +"class's :py:meth:`~object.__call__` method is reassigned." msgstr "" msgid "This flag can now be inherited by mutable classes." @@ -1893,8 +2104,9 @@ msgid "This flag is not inherited." msgstr "" msgid "" -"Disallow creating instances of the type: set :c:member:`~PyTypeObject." -"tp_new` to NULL and don't create the ``__new__`` key in the type dictionary." +"Disallow creating instances of the type: " +"set :c:member:`~PyTypeObject.tp_new` to NULL and don't create the " +"``__new__`` key in the type dictionary." msgstr "" msgid "" @@ -1903,9 +2115,9 @@ msgid "" msgstr "" msgid "" -"The flag is set automatically on :ref:`static types ` if :c:" -"member:`~PyTypeObject.tp_base` is NULL or ``&PyBaseObject_Type`` and :c:" -"member:`~PyTypeObject.tp_new` is NULL." +"The flag is set automatically on :ref:`static types ` " +"if :c:member:`~PyTypeObject.tp_base` is NULL or ``&PyBaseObject_Type`` " +"and :c:member:`~PyTypeObject.tp_new` is NULL." msgstr "" msgid "" @@ -1933,8 +2145,8 @@ msgid "" msgstr "" msgid "" -"This flag is inherited by types that do not already set :c:macro:" -"`Py_TPFLAGS_SEQUENCE`." +"This flag is inherited by types that do not already " +"set :c:macro:`Py_TPFLAGS_SEQUENCE`." msgstr "" msgid ":pep:`634` -- Structural Pattern Matching: Specification" @@ -1948,8 +2160,8 @@ msgid "" msgstr "" msgid "" -"This flag is inherited by types that do not already set :c:macro:" -"`Py_TPFLAGS_MAPPING`." +"This flag is inherited by types that do not already " +"set :c:macro:`Py_TPFLAGS_MAPPING`." msgstr "" msgid "" @@ -1963,9 +2175,9 @@ msgid "" msgstr "" msgid "" -"This is a :term:`soft deprecated` macro that does nothing. Historically, " -"this would indicate that the :c:member:`~PyTypeObject.tp_version_tag` field " -"was available and initialized." +"This macro does nothing. Historically, this would indicate that " +"the :c:member:`~PyTypeObject.tp_version_tag` field was available and " +"initialized." msgstr "" msgid "" @@ -2020,11 +2232,11 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_traverse` pointer is used by the garbage " -"collector to detect reference cycles. A typical implementation of a :c:" -"member:`~PyTypeObject.tp_traverse` function simply calls :c:func:`Py_VISIT` " -"on each of the instance's members that are Python objects that the instance " -"owns. For example, this is function :c:func:`!local_traverse` from the :mod:" -"`!_thread` extension module::" +"collector to detect reference cycles. A typical implementation of " +"a :c:member:`~PyTypeObject.tp_traverse` function simply " +"calls :c:func:`Py_VISIT` on each of the instance's members that are Python " +"objects that the instance owns. For example, this is function :c:func:`!" +"local_traverse` from the :mod:`!_thread` extension module::" msgstr "" msgid "" @@ -2071,9 +2283,9 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, the traverse function must call :c:func:" -"`PyObject_VisitManagedDict` like this::" +"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, the traverse function must " +"call :c:func:`PyObject_VisitManagedDict` like this::" msgstr "" msgid "PyObject_VisitManagedDict((PyObject*)self, visit, arg);" @@ -2098,17 +2310,18 @@ msgid "" msgstr "" msgid "" -"Note that :c:func:`Py_VISIT` requires the *visit* and *arg* parameters to :c:" -"func:`!local_traverse` to have these specific names; don't name them just " -"anything." +"Note that :c:func:`Py_VISIT` requires the *visit* and *arg* parameters " +"to :c:func:`!local_traverse` to have these specific names; don't name them " +"just anything." msgstr "" msgid "" "Instances of :ref:`heap-allocated types ` hold a reference to " -"their type. Their traversal function must therefore either visit :c:func:" -"`Py_TYPE(self) `, or delegate this responsibility by calling " -"``tp_traverse`` of another heap-allocated type (such as a heap-allocated " -"superclass). If they do not, the type object may not be garbage-collected." +"their type. Their traversal function must therefore either " +"visit :c:func:`Py_TYPE(self) `, or delegate this responsibility by " +"calling ``tp_traverse`` of another heap-allocated type (such as a heap-" +"allocated superclass). If they do not, the type object may not be garbage-" +"collected." msgstr "" msgid "" @@ -2123,10 +2336,12 @@ msgid "" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_clear` and the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :c:" -"member:`~PyTypeObject.tp_traverse`, and :c:member:`~PyTypeObject.tp_clear` " -"are all inherited from the base type if they are all zero in the subtype." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_clear` and " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag " +"bit, :c:member:`~PyTypeObject.tp_traverse`, " +"and :c:member:`~PyTypeObject.tp_clear` are all inherited from the base type " +"if they are all zero in the subtype." msgstr "" msgid "An optional pointer to a clear function. The signature is::" @@ -2146,15 +2361,15 @@ msgid "" ":c:member:`!tp_clear` does not need to delete references to objects that " "can't participate in reference cycles, such as Python strings or Python " "integers. However, it may be convenient to clear all references, and write " -"the type's :c:member:`~PyTypeObject.tp_dealloc` function to invoke :c:member:" -"`!tp_clear` to avoid code duplication. (Beware that :c:member:`!tp_clear` " -"might have already been called. Prefer calling idempotent functions like :c:" -"func:`Py_CLEAR`.)" +"the type's :c:member:`~PyTypeObject.tp_dealloc` function to " +"invoke :c:member:`!tp_clear` to avoid code duplication. (Beware " +"that :c:member:`!tp_clear` might have already been called. Prefer calling " +"idempotent functions like :c:func:`Py_CLEAR`.)" msgstr "" msgid "" -"Any non-trivial cleanup should be performed in :c:member:`~PyTypeObject." -"tp_finalize` instead of :c:member:`!tp_clear`." +"Any non-trivial cleanup should be performed " +"in :c:member:`~PyTypeObject.tp_finalize` instead of :c:member:`!tp_clear`." msgstr "" msgid "" @@ -2179,8 +2394,8 @@ msgid "" msgstr "" msgid "" -"This function differs from the destructor (:c:member:`~PyTypeObject." -"tp_dealloc`) in the following ways:" +"This function differs from the destructor " +"(:c:member:`~PyTypeObject.tp_dealloc`) in the following ways:" msgstr "" msgid "" @@ -2188,17 +2403,17 @@ msgid "" "that might participate in a reference cycle. The purpose of the destructor, " "on the other hand, is a superset: it must release *all* resources it owns, " "including references to objects that cannot participate in a reference cycle " -"(e.g., integers) as well as the object's own memory (by calling :c:member:" -"`~PyTypeObject.tp_free`)." +"(e.g., integers) as well as the object's own memory (by " +"calling :c:member:`~PyTypeObject.tp_free`)." msgstr "" msgid "" "When :c:member:`!tp_clear` is called, other objects might still hold " "references to the object being cleared. Because of this, :c:member:`!" -"tp_clear` must not deallocate the object's own memory (:c:member:" -"`~PyTypeObject.tp_free`). The destructor, on the other hand, is only called " -"when no (strong) references exist, and as such, must safely destroy the " -"object itself by deallocating it." +"tp_clear` must not deallocate the object's own memory " +"(:c:member:`~PyTypeObject.tp_free`). The destructor, on the other hand, is " +"only called when no (strong) references exist, and as such, must safely " +"destroy the object itself by deallocating it." msgstr "" msgid "" @@ -2233,10 +2448,10 @@ msgid "" msgstr "" msgid "" -"Python will not destroy an object until after any automatic calls to its :c:" -"member:`!tp_clear` function have returned. This ensures that the act of " -"breaking a reference cycle does not invalidate the ``self`` pointer while :c:" -"member:`!tp_clear` is still executing." +"Python will not destroy an object until after any automatic calls to " +"its :c:member:`!tp_clear` function have returned. This ensures that the act " +"of breaking a reference cycle does not invalidate the ``self`` pointer " +"while :c:member:`!tp_clear` is still executing." msgstr "" msgid "" @@ -2254,12 +2469,13 @@ msgid "" "Taken together, all :c:member:`~PyTypeObject.tp_clear` functions in the " "system must combine to break all reference cycles. This is subtle, and if " "in any doubt supply a :c:member:`~PyTypeObject.tp_clear` function. For " -"example, the tuple type does not implement a :c:member:`~PyTypeObject." -"tp_clear` function, because it's possible to prove that no reference cycle " -"can be composed entirely of tuples. Therefore the :c:member:`~PyTypeObject." -"tp_clear` functions of other types are responsible for breaking any cycle " -"containing a tuple. This isn't immediately obvious, and there's rarely a " -"good reason to avoid implementing :c:member:`~PyTypeObject.tp_clear`." +"example, the tuple type does not implement " +"a :c:member:`~PyTypeObject.tp_clear` function, because it's possible to " +"prove that no reference cycle can be composed entirely of tuples. Therefore " +"the :c:member:`~PyTypeObject.tp_clear` functions of other types are " +"responsible for breaking any cycle containing a tuple. This isn't " +"immediately obvious, and there's rarely a good reason to avoid " +"implementing :c:member:`~PyTypeObject.tp_clear`." msgstr "" msgid "" @@ -2284,9 +2500,9 @@ msgstr "" msgid "" "The :c:func:`Py_CLEAR` macro should be used, because clearing references is " -"delicate: the reference to the contained object must not be released (via :" -"c:func:`Py_DECREF`) until after the pointer to the contained object is set " -"to ``NULL``. This is because releasing the reference may cause the " +"delicate: the reference to the contained object must not be released " +"(via :c:func:`Py_DECREF`) until after the pointer to the contained object is " +"set to ``NULL``. This is because releasing the reference may cause the " "contained object to become trash, triggering a chain of reclamation activity " "that may include invoking arbitrary Python code (due to finalizers, or " "weakref callbacks, associated with the contained object). If it's possible " @@ -2297,19 +2513,21 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, the clear function must call :c:func:" -"`PyObject_ClearManagedDict` like this::" +"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, the clear function must " +"call :c:func:`PyObject_ClearManagedDict` like this::" msgstr "" msgid "PyObject_ClearManagedDict((PyObject*)self);" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_traverse` and the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :" -"c:member:`~PyTypeObject.tp_traverse`, and :c:member:`~PyTypeObject.tp_clear` " -"are all inherited from the base type if they are all zero in the subtype." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_traverse` and " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag " +"bit, :c:member:`~PyTypeObject.tp_traverse`, " +"and :c:member:`~PyTypeObject.tp_clear` are all inherited from the base type " +"if they are all zero in the subtype." msgstr "" msgid "" @@ -2332,8 +2550,9 @@ msgid "" msgstr "" msgid "" -"The following constants are defined to be used as the third argument for :c:" -"member:`~PyTypeObject.tp_richcompare` and for :c:func:`PyObject_RichCompare`:" +"The following constants are defined to be used as the third argument " +"for :c:member:`~PyTypeObject.tp_richcompare` and " +"for :c:func:`PyObject_RichCompare`:" msgstr "" msgid "Constant" @@ -2378,18 +2597,20 @@ msgid "On error, sets an exception and returns ``NULL`` from the function." msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_hash`: a subtype inherits :c:member:`~PyTypeObject.tp_richcompare` and :c:" -"member:`~PyTypeObject.tp_hash` when the subtype's :c:member:`~PyTypeObject." -"tp_richcompare` and :c:member:`~PyTypeObject.tp_hash` are both ``NULL``." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_hash`: a subtype " +"inherits :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash` when the " +"subtype's :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash` are both ``NULL``." msgstr "" msgid "" -":c:data:`PyBaseObject_Type` provides a :c:member:`~PyTypeObject." -"tp_richcompare` implementation, which may be inherited. However, if only :c:" -"member:`~PyTypeObject.tp_hash` is defined, not even the inherited function " -"is used and instances of the type will not be able to participate in any " -"comparisons." +":c:data:`PyBaseObject_Type` provides " +"a :c:member:`~PyTypeObject.tp_richcompare` implementation, which may be " +"inherited. However, if only :c:member:`~PyTypeObject.tp_hash` is defined, " +"not even the inherited function is used and instances of the type will not " +"be able to participate in any comparisons." msgstr "" msgid "" @@ -2402,8 +2623,8 @@ msgid "" "greater than zero and contains the offset in the instance structure of the " "weak reference list head (ignoring the GC header, if present); this offset " "is used by :c:func:`PyObject_ClearWeakRefs` and the ``PyWeakref_*`` " -"functions. The instance structure needs to include a field of type :c:expr:" -"`PyObject*` which is initialized to ``NULL``." +"functions. The instance structure needs to include a field of " +"type :c:expr:`PyObject*` which is initialized to ``NULL``." msgstr "" msgid "" @@ -2425,16 +2646,17 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, then :c:member:`~PyTypeObject." -"tp_weaklistoffset` will be set to a negative value, to indicate that it is " -"unsafe to use this field." +"If the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, " +"then :c:member:`~PyTypeObject.tp_weaklistoffset` will be set to a negative " +"value, to indicate that it is unsafe to use this field." msgstr "" msgid "" "An optional pointer to a function that returns an :term:`iterator` for the " -"object. Its presence normally signals that the instances of this type are :" -"term:`iterable` (although sequences may be iterable without this function)." +"object. Its presence normally signals that the instances of this type " +"are :term:`iterable` (although sequences may be iterable without this " +"function)." msgstr "" msgid "This function has the same signature as :c:func:`PyObject_GetIter`::" @@ -2444,18 +2666,18 @@ msgid "PyObject *tp_iter(PyObject *self);" msgstr "" msgid "" -"An optional pointer to a function that returns the next item in an :term:" -"`iterator`. The signature is::" +"An optional pointer to a function that returns the next item in " +"an :term:`iterator`. The signature is::" msgstr "" msgid "PyObject *tp_iternext(PyObject *self);" msgstr "" msgid "" -"When the iterator is exhausted, it must return ``NULL``; a :exc:" -"`StopIteration` exception may or may not be set. When another error occurs, " -"it must return ``NULL`` too. Its presence signals that the instances of " -"this type are iterators." +"When the iterator is :term:`exhausted`, the ``tp_iternext`` function must " +"return ``NULL``; a :exc:`StopIteration` exception may or may not be set. " +"When another error occurs, it must return ``NULL`` too. The presence of " +"``tp_iternext`` signals that the instances of this type are iterators." msgstr "" msgid "" @@ -2468,8 +2690,8 @@ msgid "This function has the same signature as :c:func:`PyIter_Next`." msgstr "" msgid "" -"An optional pointer to a static ``NULL``-terminated array of :c:type:" -"`PyMethodDef` structures, declaring regular methods of this type." +"An optional pointer to a static ``NULL``-terminated array " +"of :c:type:`PyMethodDef` structures, declaring regular methods of this type." msgstr "" msgid "" @@ -2483,9 +2705,9 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a static ``NULL``-terminated array of :c:type:" -"`PyMemberDef` structures, declaring regular data members (fields or slots) " -"of instances of this type." +"An optional pointer to a static ``NULL``-terminated array " +"of :c:type:`PyMemberDef` structures, declaring regular data members (fields " +"or slots) of instances of this type." msgstr "" msgid "" @@ -2499,9 +2721,9 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a static ``NULL``-terminated array of :c:type:" -"`PyGetSetDef` structures, declaring computed attributes of instances of this " -"type." +"An optional pointer to a static ``NULL``-terminated array " +"of :c:type:`PyGetSetDef` structures, declaring computed attributes of " +"instances of this type." msgstr "" msgid "" @@ -2529,10 +2751,10 @@ msgid "" msgstr "" msgid "" -"However, the unary '&' operator applied to a non-static variable like :c:" -"data:`PyBaseObject_Type` is not required to produce an address constant. " -"Compilers may support this (gcc does), MSVC does not. Both compilers are " -"strictly standard conforming in this particular behavior." +"However, the unary '&' operator applied to a non-static variable " +"like :c:data:`PyBaseObject_Type` is not required to produce an address " +"constant. Compilers may support this (gcc does), MSVC does not. Both " +"compilers are strictly standard conforming in this particular behavior." msgstr "" msgid "" @@ -2556,20 +2778,21 @@ msgid "" "called; it may also be initialized to a dictionary containing initial " "attributes for the type. Once :c:func:`PyType_Ready` has initialized the " "type, extra attributes for the type may be added to this dictionary only if " -"they don't correspond to overloaded operations (like :meth:`~object." -"__add__`). Once initialization for the type has finished, this field should " -"be treated as read-only." +"they don't correspond to overloaded operations " +"(like :meth:`~object.__add__`). Once initialization for the type has " +"finished, this field should be treated as read-only." msgstr "" msgid "" -"Some types may not store their dictionary in this slot. Use :c:func:" -"`PyType_GetDict` to retrieve the dictionary for an arbitrary type." +"Some types may not store their dictionary in this slot. " +"Use :c:func:`PyType_GetDict` to retrieve the dictionary for an arbitrary " +"type." msgstr "" msgid "" "Internals detail: For static builtin types, this is always ``NULL``. " -"Instead, the dict for such types is stored on ``PyInterpreterState``. Use :c:" -"func:`PyType_GetDict` to get the dict for an arbitrary type." +"Instead, the dict for such types is stored on ``PyInterpreterState``. " +"Use :c:func:`PyType_GetDict` to get the dict for an arbitrary type." msgstr "" msgid "" @@ -2583,8 +2806,8 @@ msgid "" msgstr "" msgid "" -"It is not safe to use :c:func:`PyDict_SetItem` on or otherwise modify :c:" -"member:`~PyTypeObject.tp_dict` with the dictionary C-API." +"It is not safe to use :c:func:`PyDict_SetItem` on or otherwise " +"modify :c:member:`~PyTypeObject.tp_dict` with the dictionary C-API." msgstr "" msgid "An optional pointer to a \"descriptor get\" function." @@ -2615,8 +2838,8 @@ msgstr "" msgid "" "If the instances of this type have a dictionary containing instance " "variables, this field is non-zero and contains the offset in the instances " -"of the type of the instance variable dictionary; this offset is used by :c:" -"func:`PyObject_GenericGetAttr`." +"of the type of the instance variable dictionary; this offset is used " +"by :c:func:`PyObject_GenericGetAttr`." msgstr "" msgid "" @@ -2631,22 +2854,23 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_dictoffset` should be regarded as write-" -"only. To get the pointer to the dictionary call :c:func:" -"`PyObject_GenericGetDict`. Calling :c:func:`PyObject_GenericGetDict` may " -"need to allocate memory for the dictionary, so it is may be more efficient " -"to call :c:func:`PyObject_GetAttr` when accessing an attribute on the object." +"only. To get the pointer to the dictionary " +"call :c:func:`PyObject_GenericGetDict`. " +"Calling :c:func:`PyObject_GenericGetDict` may need to allocate memory for " +"the dictionary, so it is may be more efficient to " +"call :c:func:`PyObject_GetAttr` when accessing an attribute on the object." msgstr "" msgid "" -"It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit and :c:" -"member:`~PyTypeObject.tp_dictoffset`." +"It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit " +"and :c:member:`~PyTypeObject.tp_dictoffset`." msgstr "" msgid "" "This field is inherited by subtypes. A subtype should not override this " "offset; doing so could be unsafe, if C code tries to access the dictionary " -"at the previous offset. To properly support inheritance, use :c:macro:" -"`Py_TPFLAGS_MANAGED_DICT`." +"at the previous offset. To properly support inheritance, " +"use :c:macro:`Py_TPFLAGS_MANAGED_DICT`." msgstr "" msgid "" @@ -2656,9 +2880,10 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, then :c:member:`~PyTypeObject.tp_dictoffset` " -"will be set to ``-1``, to indicate that it is unsafe to use this field." +"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, " +"then :c:member:`~PyTypeObject.tp_dictoffset` will be set to ``-1``, to " +"indicate that it is unsafe to use this field." msgstr "" msgid "An optional pointer to an instance initialization function." @@ -2676,19 +2901,19 @@ msgstr "" msgid "" "The self argument is the instance to be initialized; the *args* and *kwds* " -"arguments represent positional and keyword arguments of the call to :meth:" -"`~object.__init__`." +"arguments represent positional and keyword arguments of the call " +"to :meth:`~object.__init__`." msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_init` function, if not ``NULL``, is called " -"when an instance is created normally by calling its type, after the type's :" -"c:member:`~PyTypeObject.tp_new` function has returned an instance of the " -"type. If the :c:member:`~PyTypeObject.tp_new` function returns an instance " -"of some other type that is not a subtype of the original type, no :c:member:" -"`~PyTypeObject.tp_init` function is called; if :c:member:`~PyTypeObject." -"tp_new` returns an instance of a subtype of the original type, the " -"subtype's :c:member:`~PyTypeObject.tp_init` is called." +"when an instance is created normally by calling its type, after the " +"type's :c:member:`~PyTypeObject.tp_new` function has returned an instance of " +"the type. If the :c:member:`~PyTypeObject.tp_new` function returns an " +"instance of some other type that is not a subtype of the original type, " +"no :c:member:`~PyTypeObject.tp_init` function is called; " +"if :c:member:`~PyTypeObject.tp_new` returns an instance of a subtype of the " +"original type, the subtype's :c:member:`~PyTypeObject.tp_init` is called." msgstr "" msgid "Returns ``0`` on success, ``-1`` and sets an exception on error." @@ -2705,8 +2930,8 @@ msgid "PyObject *tp_alloc(PyTypeObject *self, Py_ssize_t nitems);" msgstr "" msgid "" -"Static subtypes inherit this slot, which will be :c:func:" -"`PyType_GenericAlloc` if inherited from :class:`object`." +"Static subtypes inherit this slot, which will " +"be :c:func:`PyType_GenericAlloc` if inherited from :class:`object`." msgstr "" msgid ":ref:`Heap subtypes ` do not inherit this slot." @@ -2729,9 +2954,9 @@ msgstr "" msgid "" "The *subtype* argument is the type of the object being created; the *args* " "and *kwds* arguments represent positional and keyword arguments of the call " -"to the type. Note that *subtype* doesn't have to equal the type whose :c:" -"member:`~PyTypeObject.tp_new` function is called; it may be a subtype of " -"that type (but not an unrelated type)." +"to the type. Note that *subtype* doesn't have to equal the type " +"whose :c:member:`~PyTypeObject.tp_new` function is called; it may be a " +"subtype of that type (but not an unrelated type)." msgstr "" msgid "" @@ -2740,9 +2965,9 @@ msgid "" "only as much further initialization as is absolutely necessary. " "Initialization that can safely be ignored or repeated should be placed in " "the :c:member:`~PyTypeObject.tp_init` handler. A good rule of thumb is that " -"for immutable types, all initialization should take place in :c:member:" -"`~PyTypeObject.tp_new`, while for mutable types, most initialization should " -"be deferred to :c:member:`~PyTypeObject.tp_init`." +"for immutable types, all initialization should take place " +"in :c:member:`~PyTypeObject.tp_new`, while for mutable types, most " +"initialization should be deferred to :c:member:`~PyTypeObject.tp_init`." msgstr "" msgid "" @@ -2751,9 +2976,10 @@ msgid "" msgstr "" msgid "" -"This field is inherited by subtypes, except it is not inherited by :ref:" -"`static types ` whose :c:member:`~PyTypeObject.tp_base` is " -"``NULL`` or ``&PyBaseObject_Type``." +"This field is inherited by subtypes, except it is not inherited " +"by :ref:`static types ` " +"whose :c:member:`~PyTypeObject.tp_base` is ``NULL`` or " +"``&PyBaseObject_Type``." msgstr "" msgid "" @@ -2771,22 +2997,23 @@ msgid "void tp_free(void *self);" msgstr "" msgid "" -"This function must free the memory allocated by :c:member:`~PyTypeObject." -"tp_alloc`." +"This function must free the memory allocated " +"by :c:member:`~PyTypeObject.tp_alloc`." msgstr "" msgid "" "Static subtypes inherit this slot, which will be :c:func:`PyObject_Free` if " "inherited from :class:`object`. Exception: If the type supports garbage " -"collection (i.e., the :c:macro:`Py_TPFLAGS_HAVE_GC` flag is set in :c:member:" -"`~PyTypeObject.tp_flags`) and it would inherit :c:func:`PyObject_Free`, then " -"this slot is not inherited but instead defaults to :c:func:`PyObject_GC_Del`." +"collection (i.e., the :c:macro:`Py_TPFLAGS_HAVE_GC` flag is set " +"in :c:member:`~PyTypeObject.tp_flags`) and it would " +"inherit :c:func:`PyObject_Free`, then this slot is not inherited but instead " +"defaults to :c:func:`PyObject_GC_Del`." msgstr "" msgid "" "For :ref:`heap subtypes `, this slot defaults to a deallocator " -"suitable to match :c:func:`PyType_GenericAlloc` and the value of the :c:" -"macro:`Py_TPFLAGS_HAVE_GC` flag." +"suitable to match :c:func:`PyType_GenericAlloc` and the value of " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag." msgstr "" msgid "An optional pointer to a function called by the garbage collector." @@ -2795,26 +3022,26 @@ msgstr "" msgid "" "The garbage collector needs to know whether a particular object is " "collectible or not. Normally, it is sufficient to look at the object's " -"type's :c:member:`~PyTypeObject.tp_flags` field, and check the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag bit. But some types have a mixture of statically " -"and dynamically allocated instances, and the statically allocated instances " -"are not collectible. Such types should define this function; it should " -"return ``1`` for a collectible instance, and ``0`` for a non-collectible " -"instance. The signature is::" +"type's :c:member:`~PyTypeObject.tp_flags` field, and check " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit. But some types have a mixture " +"of statically and dynamically allocated instances, and the statically " +"allocated instances are not collectible. Such types should define this " +"function; it should return ``1`` for a collectible instance, and ``0`` for a " +"non-collectible instance. The signature is::" msgstr "" msgid "int tp_is_gc(PyObject *self);" msgstr "" msgid "" -"(The only example of this are types themselves. The metatype, :c:data:" -"`PyType_Type`, defines this function to distinguish between statically and :" -"ref:`dynamically allocated types `.)" +"(The only example of this are types themselves. The " +"metatype, :c:data:`PyType_Type`, defines this function to distinguish " +"between statically and :ref:`dynamically allocated types `.)" msgstr "" msgid "" -"This slot has no default. If this field is ``NULL``, :c:macro:" -"`Py_TPFLAGS_HAVE_GC` is used as the functional equivalent." +"This slot has no default. If this field is " +"``NULL``, :c:macro:`Py_TPFLAGS_HAVE_GC` is used as the functional equivalent." msgstr "" msgid "Tuple of base types." @@ -2827,8 +3054,8 @@ msgstr "" msgid "" "For dynamically created classes, the :c:data:`Py_tp_bases` :c:type:`slot " -"` can be used instead of the *bases* argument of :c:func:" -"`PyType_FromSpecWithBases`. The argument form is preferred." +"` can be used instead of the *bases* argument " +"of :c:func:`PyType_FromSpecWithBases`. The argument form is preferred." msgstr "" msgid "" @@ -2846,8 +3073,8 @@ msgid "" msgstr "" msgid "" -"This field is not inherited; it is calculated fresh by :c:func:" -"`PyType_Ready`." +"This field is not inherited; it is calculated fresh " +"by :c:func:`PyType_Ready`." msgstr "" msgid "Unused. Internal use only." @@ -2858,8 +3085,8 @@ msgid "" msgstr "" msgid "" -"To get a list of subclasses, call the Python method :py:meth:`~type." -"__subclasses__`." +"To get a list of subclasses, call the Python " +"method :py:meth:`~type.__subclasses__`." msgstr "" msgid "" @@ -2905,8 +3132,8 @@ msgstr "" msgid "" "Before Python automatically finalizes an object, some of the object's direct " "or indirect referents might have themselves been automatically finalized. " -"However, none of the referents will have been automatically cleared (:c:" -"member:`~PyTypeObject.tp_clear`) yet." +"However, none of the referents will have been automatically cleared " +"(:c:member:`~PyTypeObject.tp_clear`) yet." msgstr "" msgid "" @@ -2938,8 +3165,8 @@ msgstr "" msgid "" "The :c:member:`!tp_finalize` function can be called during shutdown, after " -"some global variables have been deleted. See the documentation of the :meth:" -"`~object.__del__` method for details." +"some global variables have been deleted. See the documentation of " +"the :meth:`~object.__del__` method for details." msgstr "" msgid "" @@ -2948,9 +3175,10 @@ msgstr "" msgid "" "Python might mark the object as *finalized*. Currently, Python always marks " -"objects whose type supports garbage collection (i.e., the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag is set in :c:member:`~PyTypeObject.tp_flags`) and " -"never marks other types of objects; this might change in a future version." +"objects whose type supports garbage collection (i.e., " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag is set " +"in :c:member:`~PyTypeObject.tp_flags`) and never marks other types of " +"objects; this might change in a future version." msgstr "" msgid "" @@ -2976,9 +3204,9 @@ msgstr "" msgid "" "*Automatic finalization* refers to any finalization performed by Python " -"except via calls to :c:func:`PyObject_CallFinalizer` or :c:func:" -"`PyObject_CallFinalizerFromDealloc`. No guarantees are made about when, if, " -"or how often an object is automatically finalized, except:" +"except via calls to :c:func:`PyObject_CallFinalizer` " +"or :c:func:`PyObject_CallFinalizerFromDealloc`. No guarantees are made " +"about when, if, or how often an object is automatically finalized, except:" msgstr "" msgid "" @@ -2990,10 +3218,10 @@ msgstr "" msgid "" "Python will not automatically finalize an object if finalizing it would not " "mark the object as *finalized*. Currently, this applies to objects whose " -"type does not support garbage collection, i.e., the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag is not set. Such objects can still be manually " -"finalized by calling :c:func:`PyObject_CallFinalizer` or :c:func:" -"`PyObject_CallFinalizerFromDealloc`." +"type does not support garbage collection, i.e., " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag is not set. Such objects can still " +"be manually finalized by calling :c:func:`PyObject_CallFinalizer` " +"or :c:func:`PyObject_CallFinalizerFromDealloc`." msgstr "" msgid "" @@ -3008,8 +3236,8 @@ msgstr "" msgid "" "If an object is a member of a :term:`cyclic isolate`, Python will not " -"automatically finalize it after automatically clearing (see :c:member:" -"`~PyTypeObject.tp_clear`) any other member." +"automatically finalize it after automatically clearing " +"(see :c:member:`~PyTypeObject.tp_clear`) any other member." msgstr "" msgid "" @@ -3019,30 +3247,32 @@ msgid "" msgstr "" msgid "" -"If Python is going to automatically clear an object (:c:member:" -"`~PyTypeObject.tp_clear`), it will automatically finalize the object first." +"If Python is going to automatically clear an object " +"(:c:member:`~PyTypeObject.tp_clear`), it will automatically finalize the " +"object first." msgstr "" msgid "" -"Python currently only automatically finalizes objects that are members of a :" -"term:`cyclic isolate`, but future versions might finalize objects regularly " -"before their destruction." +"Python currently only automatically finalizes objects that are members of " +"a :term:`cyclic isolate`, but future versions might finalize objects " +"regularly before their destruction." msgstr "" msgid "" -"To manually finalize an object, do not call this function directly; call :c:" -"func:`PyObject_CallFinalizer` or :c:func:`PyObject_CallFinalizerFromDealloc` " -"instead." +"To manually finalize an object, do not call this function directly; " +"call :c:func:`PyObject_CallFinalizer` " +"or :c:func:`PyObject_CallFinalizerFromDealloc` instead." msgstr "" msgid "" ":c:member:`~PyTypeObject.tp_finalize` should leave the current exception " "status unchanged. The recommended way to write a non-trivial finalizer is " -"to back up the exception at the beginning by calling :c:func:" -"`PyErr_GetRaisedException` and restore the exception at the end by calling :" -"c:func:`PyErr_SetRaisedException`. If an exception is encountered in the " -"middle of the finalizer, log and clear it with :c:func:" -"`PyErr_WriteUnraisable` or :c:func:`PyErr_FormatUnraisable`. For example::" +"to back up the exception at the beginning by " +"calling :c:func:`PyErr_GetRaisedException` and restore the exception at the " +"end by calling :c:func:`PyErr_SetRaisedException`. If an exception is " +"encountered in the middle of the finalizer, log and clear it " +"with :c:func:`PyErr_WriteUnraisable` or :c:func:`PyErr_FormatUnraisable`. " +"For example::" msgstr "" msgid "" @@ -3068,9 +3298,9 @@ msgid "" msgstr "" msgid "" -"Before version 3.8 it was necessary to set the :c:macro:" -"`Py_TPFLAGS_HAVE_FINALIZE` flags bit in order for this field to be used. " -"This is no longer required." +"Before version 3.8 it was necessary to set " +"the :c:macro:`Py_TPFLAGS_HAVE_FINALIZE` flags bit in order for this field to " +"be used. This is no longer required." msgstr "" msgid ":pep:`442`: \"Safe object finalization\"" @@ -3119,10 +3349,10 @@ msgstr "" msgid "" "Typically, ``tp_vectorcall`` is overridden to optimize this process for " -"specific :c:member:`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject." -"tp_init`. When doing this for user-subclassable types, note that both can be " -"overridden (using :py:func:`~object.__new__` and :py:func:`~object." -"__init__`, respectively)." +"specific :c:member:`~PyTypeObject.tp_new` " +"and :c:member:`~PyTypeObject.tp_init`. When doing this for user-subclassable " +"types, note that both can be overridden (using :py:func:`~object.__new__` " +"and :py:func:`~object.__init__`, respectively)." msgstr "" msgid "This field is never inherited." @@ -3138,9 +3368,9 @@ msgid "Static Types" msgstr "" msgid "" -"Traditionally, types defined in C code are *static*, that is, a static :c:" -"type:`PyTypeObject` structure is defined directly in code and initialized " -"using :c:func:`PyType_Ready`." +"Traditionally, types defined in C code are *static*, that is, a " +"static :c:type:`PyTypeObject` structure is defined directly in code and " +"initialized using :c:func:`PyType_Ready`." msgstr "" msgid "" @@ -3175,14 +3405,14 @@ msgstr "" msgid "" "An alternative to :ref:`static types ` is *heap-allocated " "types*, or *heap types* for short, which correspond closely to classes " -"created by Python's ``class`` statement. Heap types have the :c:macro:" -"`Py_TPFLAGS_HEAPTYPE` flag set." +"created by Python's ``class`` statement. Heap types have " +"the :c:macro:`Py_TPFLAGS_HEAPTYPE` flag set." msgstr "" msgid "" -"This is done by filling a :c:type:`PyType_Spec` structure and calling :c:" -"func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases`, :c:func:" -"`PyType_FromModuleAndSpec`, or :c:func:`PyType_FromMetaclass`." +"This is done by filling a :c:type:`PyType_Spec` structure and " +"calling :c:func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases`, :c:func:`PyType_FromModuleAndSpec`, " +"or :c:func:`PyType_FromMetaclass`." msgstr "" msgid "Number Object Structures" @@ -3266,22 +3496,23 @@ msgid "" msgstr "" msgid "" -"This function is used by :c:func:`PyMapping_Size` and :c:func:" -"`PyObject_Size`, and has the same signature. This slot may be set to " -"``NULL`` if the object has no defined length." +"This function is used by :c:func:`PyMapping_Size` " +"and :c:func:`PyObject_Size`, and has the same signature. This slot may be " +"set to ``NULL`` if the object has no defined length." msgstr "" msgid "" -"This function is used by :c:func:`PyObject_GetItem` and :c:func:" -"`PySequence_GetSlice`, and has the same signature as :c:func:`!" -"PyObject_GetItem`. This slot must be filled for the :c:func:" -"`PyMapping_Check` function to return ``1``, it can be ``NULL`` otherwise." +"This function is used by :c:func:`PyObject_GetItem` " +"and :c:func:`PySequence_GetSlice`, and has the same signature as :c:func:`!" +"PyObject_GetItem`. This slot must be filled for " +"the :c:func:`PyMapping_Check` function to return ``1``, it can be ``NULL`` " +"otherwise." msgstr "" msgid "" -"This function is used by :c:func:`PyObject_SetItem`, :c:func:" -"`PyObject_DelItem`, :c:func:`PySequence_SetSlice` and :c:func:" -"`PySequence_DelSlice`. It has the same signature as :c:func:`!" +"This function is used " +"by :c:func:`PyObject_SetItem`, :c:func:`PyObject_DelItem`, :c:func:`PySequence_SetSlice` " +"and :c:func:`PySequence_DelSlice`. It has the same signature as :c:func:`!" "PyObject_SetItem`, but *v* can also be set to ``NULL`` to delete an item. " "If this slot is ``NULL``, the object does not support item assignment and " "deletion." @@ -3296,10 +3527,10 @@ msgid "" msgstr "" msgid "" -"This function is used by :c:func:`PySequence_Size` and :c:func:" -"`PyObject_Size`, and has the same signature. It is also used for handling " -"negative indices via the :c:member:`~PySequenceMethods.sq_item` and the :c:" -"member:`~PySequenceMethods.sq_ass_item` slots." +"This function is used by :c:func:`PySequence_Size` " +"and :c:func:`PyObject_Size`, and has the same signature. It is also used " +"for handling negative indices via the :c:member:`~PySequenceMethods.sq_item` " +"and the :c:member:`~PySequenceMethods.sq_ass_item` slots." msgstr "" msgid "" @@ -3323,19 +3554,20 @@ msgid "" msgstr "" msgid "" -"Negative indexes are handled as follows: if the :c:member:" -"`~PySequenceMethods.sq_length` slot is filled, it is called and the sequence " -"length is used to compute a positive index which is passed to :c:member:" -"`~PySequenceMethods.sq_item`. If :c:member:`!sq_length` is ``NULL``, the " -"index is passed as is to the function." +"Negative indexes are handled as follows: if " +"the :c:member:`~PySequenceMethods.sq_length` slot is filled, it is called " +"and the sequence length is used to compute a positive index which is passed " +"to :c:member:`~PySequenceMethods.sq_item`. If :c:member:`!sq_length` is " +"``NULL``, the index is passed as is to the function." msgstr "" msgid "" "This function is used by :c:func:`PySequence_SetItem` and has the same " -"signature. It is also used by :c:func:`PyObject_SetItem` and :c:func:" -"`PyObject_DelItem`, after trying the item assignment and deletion via the :c:" -"member:`~PyMappingMethods.mp_ass_subscript` slot. This slot may be left to " -"``NULL`` if the object does not support item assignment and deletion." +"signature. It is also used by :c:func:`PyObject_SetItem` " +"and :c:func:`PyObject_DelItem`, after trying the item assignment and " +"deletion via the :c:member:`~PyMappingMethods.mp_ass_subscript` slot. This " +"slot may be left to ``NULL`` if the object does not support item assignment " +"and deletion." msgstr "" msgid "" @@ -3349,8 +3581,8 @@ msgid "" "signature. It should modify its first operand, and return it. This slot " "may be left to ``NULL``, in this case :c:func:`!PySequence_InPlaceConcat` " "will fall back to :c:func:`PySequence_Concat`. It is also used by the " -"augmented assignment ``+=``, after trying numeric in-place addition via the :" -"c:member:`~PyNumberMethods.nb_inplace_add` slot." +"augmented assignment ``+=``, after trying numeric in-place addition via " +"the :c:member:`~PyNumberMethods.nb_inplace_add` slot." msgstr "" msgid "" @@ -3384,8 +3616,8 @@ msgid "" msgstr "" msgid "" -"Check if the request can be met. If not, raise :exc:`BufferError`, set :c:" -"expr:`view->obj` to ``NULL`` and return ``-1``." +"Check if the request can be met. If not, raise :exc:`BufferError`, set " +"``view->obj`` to ``NULL`` and return ``-1``." msgstr "" msgid "Fill in the requested fields." @@ -3394,8 +3626,7 @@ msgstr "" msgid "Increment an internal counter for the number of exports." msgstr "" -msgid "" -"Set :c:expr:`view->obj` to *exporter* and increment :c:expr:`view->obj`." +msgid "Set ``view->obj`` to *exporter* and increment ``view->obj``." msgstr "" msgid "Return ``0``." @@ -3416,8 +3647,8 @@ msgid "" msgstr "" msgid "" -"For objects that support resizing or reallocation (such as :class:" -"`bytearray`), the export counter is checked atomically before such " +"For objects that support resizing or reallocation (such " +"as :class:`bytearray`), the export counter is checked atomically before such " "operations, and :exc:`BufferError` is raised if exports exist." msgstr "" @@ -3435,13 +3666,13 @@ msgid "" msgstr "" msgid "" -"Re-export: Each member of the tree acts as the exporting object and sets :c:" -"expr:`view->obj` to a new reference to itself." +"Re-export: Each member of the tree acts as the exporting object and sets " +"``view->obj`` to a new reference to itself." msgstr "" msgid "" "Redirect: The buffer request is redirected to the root object of the tree. " -"Here, :c:expr:`view->obj` will be a new reference to the root object." +"Here, ``view->obj`` will be a new reference to the root object." msgstr "" msgid "" @@ -3453,10 +3684,9 @@ msgstr "" msgid "" "All memory pointed to in the :c:type:`Py_buffer` structure belongs to the " -"exporter and must remain valid until there are no consumers left. :c:member:" -"`~Py_buffer.format`, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer." -"strides`, :c:member:`~Py_buffer.suboffsets` and :c:member:`~Py_buffer." -"internal` are read-only for the consumer." +"exporter and must remain valid until there are no consumers " +"left. :c:member:`~Py_buffer.format`, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer.strides`, :c:member:`~Py_buffer.suboffsets` " +"and :c:member:`~Py_buffer.internal` are read-only for the consumer." msgstr "" msgid "" @@ -3494,7 +3724,7 @@ msgstr "" msgid "" "Resource cleanup when the counter reaches zero must be done atomically, as " "the final release may race with concurrent releases from other threads and " -"dellocation must only happen once." +"deallocation must only happen once." msgstr "" msgid "" @@ -3505,7 +3735,7 @@ msgid "" msgstr "" msgid "" -"This function MUST NOT decrement :c:expr:`view->obj`, since that is done " +"This function MUST NOT decrement ``view->obj``, since that is done " "automatically in :c:func:`PyBuffer_Release` (this scheme is useful for " "breaking reference cycles)." msgstr "" @@ -3519,8 +3749,8 @@ msgid "Async Object Structures" msgstr "" msgid "" -"This structure holds pointers to the functions required to implement :term:" -"`awaitable` and :term:`asynchronous iterator` objects." +"This structure holds pointers to the functions required to " +"implement :term:`awaitable` and :term:`asynchronous iterator` objects." msgstr "" msgid "" @@ -3548,8 +3778,8 @@ msgid "PyObject *am_aiter(PyObject *self);" msgstr "" msgid "" -"Must return an :term:`asynchronous iterator` object. See :meth:`~object." -"__anext__` for details." +"Must return an :term:`asynchronous iterator` object. " +"See :meth:`~object.__anext__` for details." msgstr "" msgid "" @@ -3579,19 +3809,20 @@ msgid "" "The purpose of this function is to separate memory allocation from memory " "initialization. It should return a pointer to a block of memory of adequate " "length for the instance, suitably aligned, and initialized to zeros, but " -"with :c:member:`~PyObject.ob_refcnt` set to ``1`` and :c:member:`~PyObject." -"ob_type` set to the type argument. If the type's :c:member:`~PyTypeObject." -"tp_itemsize` is non-zero, the object's :c:member:`~PyVarObject.ob_size` " -"field should be initialized to *nitems* and the length of the allocated " -"memory block should be ``tp_basicsize + nitems*tp_itemsize``, rounded up to " -"a multiple of ``sizeof(void*)``; otherwise, *nitems* is not used and the " -"length of the block should be :c:member:`~PyTypeObject.tp_basicsize`." +"with :c:member:`~PyObject.ob_refcnt` set to ``1`` " +"and :c:member:`~PyObject.ob_type` set to the type argument. If the " +"type's :c:member:`~PyTypeObject.tp_itemsize` is non-zero, the " +"object's :c:member:`~PyVarObject.ob_size` field should be initialized to " +"*nitems* and the length of the allocated memory block should be " +"``tp_basicsize + nitems*tp_itemsize``, rounded up to a multiple of " +"``sizeof(void*)``; otherwise, *nitems* is not used and the length of the " +"block should be :c:member:`~PyTypeObject.tp_basicsize`." msgstr "" msgid "" "This function should not do any other instance initialization, not even to " -"allocate additional memory; that should be done by :c:member:`~PyTypeObject." -"tp_new`." +"allocate additional memory; that should be done " +"by :c:member:`~PyTypeObject.tp_new`." msgstr "" msgid "See :c:member:`~PyTypeObject.tp_free`." @@ -3749,8 +3980,8 @@ msgstr "" msgid "" "A str subclass that cannot be subclassed and cannot be called to create " -"instances (e.g. uses a separate factory func) using :c:macro:" -"`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag::" +"instances (e.g. uses a separate factory func) " +"using :c:macro:`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag::" msgstr "" msgid "" diff --git a/c-api/unicode.po b/c-api/unicode.po index 084431a522..98a375652f 100644 --- a/c-api/unicode.po +++ b/c-api/unicode.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -42,6 +42,13 @@ msgid "" "UTF-8 representation is created on demand and cached in the Unicode object." msgstr "" +msgid "" +"The internal buffer always includes an extra trailing null character for " +"compatibility with null terminated C strings. This extra character is not " +"counted in :c:func:`PyUnicode_GetLength` nor in the various *size* arguments " +"of the functions below." +msgstr "" + msgid "" "The :c:type:`Py_UNICODE` representation has been removed since Python 3.12 " "with deprecated APIs. See :pep:`623` for more information." @@ -112,8 +119,8 @@ msgstr "" msgid "" "Return a pointer to the canonical representation cast to UCS1, UCS2 or UCS4 " "integer types for direct character access. No checks are performed if the " -"canonical representation has the correct character size; use :c:func:" -"`PyUnicode_KIND` to select the right function." +"canonical representation has the correct character size; " +"use :c:func:`PyUnicode_KIND` to select the right function." msgstr "" msgid "Return values of the :c:func:`PyUnicode_KIND` macro." @@ -152,14 +159,19 @@ msgid "" msgstr "" msgid "" -"Read a code point from a canonical representation *data* (as obtained with :" -"c:func:`PyUnicode_DATA`). No checks or ready calls are performed." +"Read a code point from a canonical representation *data* (as obtained " +"with :c:func:`PyUnicode_DATA`). No checks are performed." +msgstr "" + +msgid "" +"Accept reading the trailing null character at " +"index :c:func:`PyUnicode_GetLength`." msgstr "" msgid "" "Read a character from a Unicode object *unicode*, which must be in the " -"\"canonical\" representation. This is less efficient than :c:func:" -"`PyUnicode_READ` if you do multiple consecutive reads." +"\"canonical\" representation. This is less efficient " +"than :c:func:`PyUnicode_READ` if you do multiple consecutive reads." msgstr "" msgid "" @@ -179,8 +191,8 @@ msgid "" msgstr "" msgid "" -"Return true if the string only contains ASCII characters. Equivalent to :py:" -"meth:`str.isascii`." +"Return true if the string only contains ASCII characters. Equivalent " +"to :py:meth:`str.isascii`." msgstr "" msgid "Unicode Character Properties" @@ -308,11 +320,11 @@ msgid "On error, set an exception and return ``NULL``." msgstr "" msgid "" -"After creation, the string can be filled by :c:func:`PyUnicode_WriteChar`, :" -"c:func:`PyUnicode_CopyCharacters`, :c:func:`PyUnicode_Fill`, :c:func:" -"`PyUnicode_WRITE` or similar. Since strings are supposed to be immutable, " -"take care to not “use” the result while it is being modified. In particular, " -"before it's filled with its final contents, a string:" +"After creation, the string can be filled " +"by :c:func:`PyUnicode_WriteChar`, :c:func:`PyUnicode_CopyCharacters`, :c:func:`PyUnicode_Fill`, :c:func:`PyUnicode_WRITE` " +"or similar. Since strings are supposed to be immutable, take care to not " +"“use” the result while it is being modified. In particular, before it's " +"filled with its final contents, a string:" msgstr "" msgid "must not be hashed," @@ -341,17 +353,24 @@ msgid "" msgstr "" msgid "" -"Create a new Unicode object with the given *kind* (possible values are :c:" -"macro:`PyUnicode_1BYTE_KIND` etc., as returned by :c:func:" -"`PyUnicode_KIND`). The *buffer* must point to an array of *size* units of " -"1, 2 or 4 bytes per character, as given by the kind." +"Create a new Unicode object with the given *kind* (possible values " +"are :c:macro:`PyUnicode_1BYTE_KIND` etc., as returned " +"by :c:func:`PyUnicode_KIND`). The *buffer* must point to an array of *size* " +"units of 1, 2 or 4 bytes per character, as given by the kind." msgstr "" msgid "" "If necessary, the input *buffer* is copied and transformed into the " -"canonical representation. For example, if the *buffer* is a UCS4 string (:c:" -"macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the UCS1 " -"range, it will be transformed into UCS1 (:c:macro:`PyUnicode_1BYTE_KIND`)." +"canonical representation. For example, if the *buffer* is a UCS4 string " +"(:c:macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the " +"UCS1 range, it will be transformed into UCS1 " +"(:c:macro:`PyUnicode_1BYTE_KIND`)." +msgstr "" + +msgid "" +"All characters must be in range [U+0000; U+10ffff]. If *kind* " +"is :c:macro:`PyUnicode_4BYTE_KIND` and the string contains invalid " +"characters, the behavior is undefined." msgstr "" msgid "" @@ -401,9 +420,9 @@ msgstr "" msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " -"actual width is given in the next argument, which must be of type :c:expr:" -"`int`, and the object to convert comes after the minimum field width and " -"optional precision." +"actual width is given in the next argument, which must be of " +"type :c:expr:`int`, and the object to convert comes after the minimum field " +"width and optional precision." msgstr "" msgid "" @@ -616,8 +635,8 @@ msgid "``T``" msgstr "``T``" msgid "" -"Get the fully qualified name of an object type; call :c:func:" -"`PyType_GetFullyQualifiedName`." +"Get the fully qualified name of an object type; " +"call :c:func:`PyType_GetFullyQualifiedName`." msgstr "" msgid "``#T``" @@ -635,8 +654,8 @@ msgid ":c:expr:`PyTypeObject*`" msgstr ":c:expr:`PyTypeObject*`" msgid "" -"Get the fully qualified name of a type; call :c:func:" -"`PyType_GetFullyQualifiedName`." +"Get the fully qualified name of a type; " +"call :c:func:`PyType_GetFullyQualifiedName`." msgstr "" msgid "``#N``" @@ -734,9 +753,9 @@ msgid "" msgstr "" msgid "" -"Append the string *right* to the end of *p_left*. *p_left* must point to a :" -"term:`strong reference` to a Unicode object; :c:func:`!PyUnicode_Append` " -"releases (\"steals\") this reference." +"Append the string *right* to the end of *p_left*. *p_left* must point to " +"a :term:`strong reference` to a Unicode object; :c:func:`!PyUnicode_Append` " +"releases (\":term:`steals `\") this reference." msgstr "" msgid "On error, set *\\*p_left* to ``NULL`` and set an exception." @@ -759,8 +778,8 @@ msgid "" msgstr "" msgid "" -"Return the name of the default string encoding, ``\"utf-8\"``. See :func:" -"`sys.getdefaultencoding`." +"Return the name of the default string encoding, ``\"utf-8\"``. " +"See :func:`sys.getdefaultencoding`." msgstr "" msgid "" @@ -774,6 +793,9 @@ msgstr "" msgid "On error, set an exception and return ``-1``." msgstr "" +msgid "The length does not count the trailing null character." +msgstr "" + msgid "" "Copy characters from one Unicode object into another. This function " "performs character conversion when necessary and falls back to :c:func:`!" @@ -807,8 +829,8 @@ msgid "" msgstr "" msgid "" -"Fill a string with a character: write *fill_char* into ``unicode[start:" -"start+length]``." +"Fill a string with a character: write *fill_char* into " +"``unicode[start:start+length]``." msgstr "" msgid "" @@ -817,7 +839,7 @@ msgid "" msgstr "" msgid "" -"Return the number of written character, or return ``-1`` and raise an " +"Return the number of written characters, or return ``-1`` and raise an " "exception on error." msgstr "" @@ -828,20 +850,25 @@ msgstr "" msgid "" "This function checks that *unicode* is a Unicode object, that the index is " -"not out of bounds, and that the object's reference count is one. See :c:func:" -"`PyUnicode_WRITE` for a version that skips these checks, making them your " -"responsibility." +"not out of bounds, and that the object's reference count is one. " +"See :c:func:`PyUnicode_WRITE` for a version that skips these checks, making " +"them your responsibility." msgstr "" msgid "" "Read a character from a string. This function checks that *unicode* is a " -"Unicode object and the index is not out of bounds, in contrast to :c:func:" -"`PyUnicode_READ_CHAR`, which performs no error checking." +"Unicode object and the index is not out of bounds, in contrast " +"to :c:func:`PyUnicode_READ_CHAR`, which performs no error checking." msgstr "" msgid "Return character on success, ``-1`` on error with an exception set." msgstr "" +msgid "" +"Do not accept reading the trailing null character at " +"index :c:func:`PyUnicode_GetLength`." +msgstr "" + msgid "" "Return a substring of *unicode*, from character index *start* (included) to " "character index *end* (excluded). Negative indices are not supported. On " @@ -856,10 +883,10 @@ msgid "" msgstr "" msgid "" -"Copy the string *unicode* into a new UCS4 buffer that is allocated using :c:" -"func:`PyMem_Malloc`. If this fails, ``NULL`` is returned with a :exc:" -"`MemoryError` set. The returned buffer always has an extra null code point " -"appended." +"Copy the string *unicode* into a new UCS4 buffer that is allocated " +"using :c:func:`PyMem_Malloc`. If this fails, ``NULL`` is returned with " +"a :exc:`MemoryError` set. The returned buffer always has an extra null code " +"point appended." msgstr "" msgid "Locale Encoding" @@ -879,8 +906,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from the :" -"term:`filesystem encoding and error handler`." +"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "This function ignores the :ref:`Python UTF-8 Mode `." @@ -891,9 +918,9 @@ msgstr "" msgid "" "The function now also uses the current locale encoding for the " -"``surrogateescape`` error handler, except on Android. Previously, :c:func:" -"`Py_DecodeLocale` was used for the ``surrogateescape``, and the current " -"locale encoding was used for ``strict``." +"``surrogateescape`` error handler, except on Android. " +"Previously, :c:func:`Py_DecodeLocale` was used for the ``surrogateescape``, " +"and the current locale encoding was used for ``strict``." msgstr "" msgid "" @@ -905,13 +932,13 @@ msgid "" "Encode a Unicode object to UTF-8 on Android and VxWorks, or to the current " "locale encoding on other platforms. The supported error handlers are " "``\"strict\"`` and ``\"surrogateescape\"`` (:pep:`383`). The encoder uses " -"``\"strict\"`` error handler if *errors* is ``NULL``. Return a :class:" -"`bytes` object. *unicode* cannot contain embedded null characters." +"``\"strict\"`` error handler if *errors* is ``NULL``. Return " +"a :class:`bytes` object. *unicode* cannot contain embedded null characters." msgstr "" msgid "" -"Use :c:func:`PyUnicode_EncodeFSDefault` to encode a string to the :term:" -"`filesystem encoding and error handler`." +"Use :c:func:`PyUnicode_EncodeFSDefault` to encode a string to " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "The :c:func:`Py_EncodeLocale` function." @@ -919,9 +946,9 @@ msgstr "" msgid "" "The function now also uses the current locale encoding for the " -"``surrogateescape`` error handler, except on Android. Previously, :c:func:" -"`Py_EncodeLocale` was used for the ``surrogateescape``, and the current " -"locale encoding was used for ``strict``." +"``surrogateescape`` error handler, except on Android. " +"Previously, :c:func:`Py_EncodeLocale` was used for the ``surrogateescape``, " +"and the current locale encoding was used for ``strict``." msgstr "" msgid "File System Encoding" @@ -940,8 +967,8 @@ msgstr "" msgid "" ":ref:`PyArg_Parse\\* converter `: encode :class:`str` objects " -"-- obtained directly or through the :class:`os.PathLike` interface -- to :" -"class:`bytes` using :c:func:`PyUnicode_EncodeFSDefault`; :class:`bytes` " +"-- obtained directly or through the :class:`os.PathLike` interface -- " +"to :class:`bytes` using :c:func:`PyUnicode_EncodeFSDefault`; :class:`bytes` " "objects are output as-is. *result* must be an address of a C variable of " "type :c:expr:`PyObject*` (or :c:expr:`PyBytesObject*`). On success, set the " "variable to a new :term:`strong reference` to a :ref:`bytes object " @@ -967,14 +994,15 @@ msgstr "" msgid "" ":ref:`PyArg_Parse\\* converter `: decode :class:`bytes` objects " "-- obtained either directly or indirectly through the :class:`os.PathLike` " -"interface -- to :class:`str` using :c:func:" -"`PyUnicode_DecodeFSDefaultAndSize`; :class:`str` objects are output as-is. " -"*result* must be an address of a C variable of type :c:expr:`PyObject*` (or :" -"c:expr:`PyUnicodeObject*`). On success, set the variable to a new :term:" -"`strong reference` to a :ref:`Unicode object ` which must be " -"released when it is no longer used and return a non-zero value (:c:macro:" -"`Py_CLEANUP_SUPPORTED`). Embedded null characters are not allowed in the " -"result. On failure, return ``0`` with an exception set." +"interface -- to :class:`str` " +"using :c:func:`PyUnicode_DecodeFSDefaultAndSize`; :class:`str` objects are " +"output as-is. *result* must be an address of a C variable of " +"type :c:expr:`PyObject*` (or :c:expr:`PyUnicodeObject*`). On success, set " +"the variable to a new :term:`strong reference` to a :ref:`Unicode object " +"` which must be released when it is no longer used and " +"return a non-zero value (:c:macro:`Py_CLEANUP_SUPPORTED`). Embedded null " +"characters are not allowed in the result. On failure, return ``0`` with an " +"exception set." msgstr "" msgid "" @@ -986,8 +1014,8 @@ msgid "Decode a string from the :term:`filesystem encoding and error handler`." msgstr "" msgid "" -"If you need to decode a string from the current locale encoding, use :c:func:" -"`PyUnicode_DecodeLocaleAndSize`." +"If you need to decode a string from the current locale encoding, " +"use :c:func:`PyUnicode_DecodeLocaleAndSize`." msgstr "" msgid "" @@ -1001,8 +1029,8 @@ msgid "" msgstr "" msgid "" -"If the string length is known, use :c:func:" -"`PyUnicode_DecodeFSDefaultAndSize`." +"If the string length is known, " +"use :c:func:`PyUnicode_DecodeFSDefaultAndSize`." msgstr "" msgid "" @@ -1012,8 +1040,8 @@ msgid "" msgstr "" msgid "" -"If you need to encode a string to the current locale encoding, use :c:func:" -"`PyUnicode_EncodeLocale`." +"If you need to encode a string to the current locale encoding, " +"use :c:func:`PyUnicode_EncodeLocale`." msgstr "" msgid "wchar_t Support" @@ -1032,8 +1060,8 @@ msgstr "" msgid "" "Copy the Unicode object contents into the :c:type:`wchar_t` buffer *wstr*. " "At most *size* :c:type:`wchar_t` characters are copied (excluding a possibly " -"trailing null termination character). Return the number of :c:type:" -"`wchar_t` characters copied or ``-1`` in case of an error." +"trailing null termination character). Return the number " +"of :c:type:`wchar_t` characters copied or ``-1`` in case of an error." msgstr "" msgid "" @@ -1043,9 +1071,9 @@ msgstr "" msgid "" "Note that the resulting :c:expr:`wchar_t*` string may or may not be null-" -"terminated. It is the responsibility of the caller to make sure that the :c:" -"expr:`wchar_t*` string is null-terminated in case this is required by the " -"application. Also, note that the :c:expr:`wchar_t*` string might contain " +"terminated. It is the responsibility of the caller to make sure that " +"the :c:expr:`wchar_t*` string is null-terminated in case this is required by " +"the application. Also, note that the :c:expr:`wchar_t*` string might contain " "null characters, which would cause the string to be truncated when used with " "most C functions." msgstr "" @@ -1056,8 +1084,9 @@ msgid "" "number of wide characters (excluding the trailing null termination " "character) into *\\*size*. Note that the resulting :c:type:`wchar_t` string " "might contain null characters, which would cause the string to be truncated " -"when used with most C functions. If *size* is ``NULL`` and the :c:expr:" -"`wchar_t*` string contains null characters a :exc:`ValueError` is raised." +"when used with most C functions. If *size* is ``NULL`` and " +"the :c:expr:`wchar_t*` string contains null characters a :exc:`ValueError` " +"is raised." msgstr "" msgid "" @@ -1186,7 +1215,7 @@ msgid "" "collected." msgstr "" -msgid "The return type is now ``const char *`` rather of ``char *``." +msgid "The return type is now ``const char *`` rather than ``char *``." msgstr "" msgid "This function is a part of the :ref:`limited API `." @@ -1200,8 +1229,8 @@ msgid "" "`_ embedded within *unicode*. " "As a result, strings containing null characters will remain in the returned " "string, which some C functions might interpret as the end of the string, " -"leading to truncation. If truncation is an issue, it is recommended to use :" -"c:func:`PyUnicode_AsUTF8AndSize` instead." +"leading to truncation. If truncation is an issue, it is recommended to " +"use :c:func:`PyUnicode_AsUTF8AndSize` instead." msgstr "" msgid "UTF-32 Codecs" @@ -1494,8 +1523,8 @@ msgstr "" msgid "" "Encode the Unicode object using the specified code page and return a Python " -"bytes object. Return ``NULL`` if an exception was raised by the codec. Use :" -"c:macro:`!CP_ACP` code page to get the MBCS encoder." +"bytes object. Return ``NULL`` if an exception was raised by the codec. " +"Use :c:macro:`!CP_ACP` code page to get the MBCS encoder." msgstr "" msgid "Methods and Slot Functions" @@ -1612,8 +1641,8 @@ msgid "" msgstr "" msgid "" -"This function returns ``-1`` upon failure, so one should call :c:func:" -"`PyErr_Occurred` to check for errors." +"This function returns ``-1`` upon failure, so one should " +"call :c:func:`PyErr_Occurred` to check for errors." msgstr "" msgid "The :c:func:`PyUnicode_Equal` function." @@ -1629,8 +1658,8 @@ msgid "Return ``0`` if *a* is not equal to *b*." msgstr "" msgid "" -"Set a :exc:`TypeError` exception and return ``-1`` if *a* or *b* is not a :" -"class:`str` object." +"Set a :exc:`TypeError` exception and return ``-1`` if *a* or *b* is not " +"a :class:`str` object." msgstr "" msgid "The function always succeeds if *a* and *b* are :class:`str` objects." @@ -1681,8 +1710,9 @@ msgid ":c:data:`Py_NotImplemented` in case the type combination is unknown" msgstr "" msgid "" -"Possible values for *op* are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:" -"`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, and :c:macro:`Py_LE`." +"Possible values for *op* " +"are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, " +"and :c:macro:`Py_LE`." msgstr "" msgid "" @@ -1703,11 +1733,11 @@ msgstr "" msgid "" "Intern the argument :c:expr:`*p_unicode` in place. The argument must be the " "address of a pointer variable pointing to a Python Unicode string object. " -"If there is an existing interned string that is the same as :c:expr:" -"`*p_unicode`, it sets :c:expr:`*p_unicode` to it (releasing the reference to " -"the old string object and creating a new :term:`strong reference` to the " -"interned string object), otherwise it leaves :c:expr:`*p_unicode` alone and " -"interns it." +"If there is an existing interned string that is the same " +"as :c:expr:`*p_unicode`, it sets :c:expr:`*p_unicode` to it (releasing the " +"reference to the old string object and creating a new :term:`strong " +"reference` to the interned string object), otherwise it " +"leaves :c:expr:`*p_unicode` alone and interns it." msgstr "" msgid "" @@ -1723,9 +1753,9 @@ msgid "" msgstr "" msgid "" -"Instances of subclasses of :py:class:`str` may not be interned, that is, :c:" -"expr:`PyUnicode_CheckExact(*p_unicode)` must be true. If it is not, then -- " -"as with any other error -- the argument is left unchanged." +"Instances of subclasses of :py:class:`str` may not be interned, that " +"is, :c:expr:`PyUnicode_CheckExact(*p_unicode)` must be true. If it is not, " +"then -- as with any other error -- the argument is left unchanged." msgstr "" msgid "" @@ -1734,8 +1764,9 @@ msgid "" msgstr "" msgid "" -"A combination of :c:func:`PyUnicode_FromString` and :c:func:" -"`PyUnicode_InternInPlace`, meant for statically allocated strings." +"A combination of :c:func:`PyUnicode_FromString` " +"and :c:func:`PyUnicode_InternInPlace`, meant for statically allocated " +"strings." msgstr "" msgid "" @@ -1748,8 +1779,8 @@ msgid "" "Python may keep a reference to the result, or make it :term:`immortal`, " "preventing it from being garbage-collected promptly. For interning an " "unbounded number of different strings, such as ones coming from user input, " -"prefer calling :c:func:`PyUnicode_FromString` and :c:func:" -"`PyUnicode_InternInPlace` directly." +"prefer calling :c:func:`PyUnicode_FromString` " +"and :c:func:`PyUnicode_InternInPlace` directly." msgstr "" msgid "" @@ -1769,8 +1800,8 @@ msgid "PyUnicodeWriter" msgstr "" msgid "" -"The :c:type:`PyUnicodeWriter` API can be used to create a Python :class:" -"`str` object." +"The :c:type:`PyUnicodeWriter` API can be used to create a " +"Python :class:`str` object." msgstr "" msgid "A Unicode writer instance." @@ -1781,6 +1812,11 @@ msgid "" "success, or :c:func:`PyUnicodeWriter_Discard` on error." msgstr "" +msgid "" +"The API is **not thread safe**. To share a writer with multiple threads, a " +"critical section or a lock is needed." +msgstr "" + msgid "Create a Unicode writer instance." msgstr "" @@ -1845,12 +1881,17 @@ msgid "" "``wcslen(str)`` to get the string length." msgstr "" -msgid "Writer the UCS4 string *str* into *writer*." +msgid "Write the UCS4 string *str* into *writer*." msgstr "" msgid "*size* is a number of UCS4 characters." msgstr "" +msgid "" +"All characters must be in range [U+0000; U+10ffff]. If the string contains " +"invalid characters, the behavior is undefined." +msgstr "" + msgid "" "Call :c:func:`PyObject_Str` on *obj* and write the output into *writer*." msgstr "" diff --git a/c-api/veryhigh.po b/c-api/veryhigh.po index 26fa6cbadd..249c3054a2 100644 --- a/c-api/veryhigh.po +++ b/c-api/veryhigh.po @@ -34,15 +34,16 @@ msgstr "" msgid "" "Several of these functions accept a start symbol from the grammar as a " -"parameter. The available start symbols are :const:`Py_eval_input`, :const:" -"`Py_file_input`, and :const:`Py_single_input`. These are described " -"following the functions which accept them as parameters." +"parameter. The available start symbols " +"are :const:`Py_eval_input`, :const:`Py_file_input`, " +"and :const:`Py_single_input`. These are described following the functions " +"which accept them as parameters." msgstr "" msgid "" "Note also that several of these functions take :c:expr:`FILE*` parameters. " -"One particular issue which needs to be handled carefully is that the :c:expr:" -"`FILE` structure for different C libraries can be different and " +"One particular issue which needs to be handled carefully is that " +"the :c:expr:`FILE` structure for different C libraries can be different and " "incompatible. Under Windows (at least), it is possible for dynamically " "linked extensions to actually use different libraries, so care should be " "taken that :c:expr:`FILE*` parameters are only passed to these functions if " @@ -88,12 +89,12 @@ msgstr "" msgid "" "If *fp* refers to a file associated with an interactive device (console or " -"terminal input or Unix pseudo-terminal), return the value of :c:func:" -"`PyRun_InteractiveLoop`, otherwise return the result of :c:func:" -"`PyRun_SimpleFile`. *filename* is decoded from the filesystem encoding (:" -"func:`sys.getfilesystemencoding`). If *filename* is ``NULL``, this function " -"uses ``\"???\"`` as the filename. If *closeit* is true, the file is closed " -"before ``PyRun_SimpleFileExFlags()`` returns." +"terminal input or Unix pseudo-terminal), return the value " +"of :c:func:`PyRun_InteractiveLoop`, otherwise return the result " +"of :c:func:`PyRun_SimpleFile`. *filename* is decoded from the filesystem " +"encoding (:func:`sys.getfilesystemencoding`). If *filename* is ``NULL``, " +"this function uses ``\"???\"`` as the filename. If *closeit* is true, the " +"file is closed before ``PyRun_SimpleFileExFlags()`` returns." msgstr "" msgid "" @@ -147,16 +148,16 @@ msgstr "" msgid "" "Read and execute a single statement from a file associated with an " "interactive device according to the *flags* argument. The user will be " -"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from the :" -"term:`filesystem encoding and error handler`." +"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "" "Returns ``0`` when the input was executed successfully, ``-1`` if there was " "an exception, or an error code from the :file:`errcode.h` include file " -"distributed as part of Python if there was a parse error. (Note that :file:" -"`errcode.h` is not included by :file:`Python.h`, so must be included " -"specifically if needed.)" +"distributed as part of Python if there was a parse error. (Note " +"that :file:`errcode.h` is not included by :file:`Python.h`, so must be " +"included specifically if needed.)" msgstr "" msgid "" @@ -191,14 +192,14 @@ msgid "" msgstr "" msgid "" -"The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:" -"func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred." +"The result must be a string allocated by :c:func:`PyMem_RawMalloc` " +"or :c:func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred." msgstr "" msgid "" -"The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:" -"`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :" -"c:func:`PyMem_Realloc`." +"The result must be allocated by :c:func:`PyMem_RawMalloc` " +"or :c:func:`PyMem_RawRealloc`, instead of being allocated " +"by :c:func:`PyMem_Malloc` or :c:func:`PyMem_Realloc`." msgstr "" msgid "" @@ -238,8 +239,8 @@ msgid "" "Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read " "from *fp* instead of an in-memory string. *filename* should be the name of " "the file, it is decoded from the :term:`filesystem encoding and error " -"handler`. If *closeit* is true, the file is closed before :c:func:" -"`PyRun_FileExFlags` returns." +"handler`. If *closeit* is true, the file is closed " +"before :c:func:`PyRun_FileExFlags` returns." msgstr "" msgid "" @@ -255,11 +256,12 @@ msgstr "" msgid "" "Parse and compile the Python source code in *str*, returning the resulting " "code object. The start token is given by *start*; this can be used to " -"constrain the code which can be compiled and should be :const:" -"`Py_eval_input`, :const:`Py_file_input`, or :const:`Py_single_input`. The " -"filename specified by *filename* is used to construct the code object and " -"may appear in tracebacks or :exc:`SyntaxError` exception messages. This " -"returns ``NULL`` if the code cannot be parsed or compiled." +"constrain the code which can be compiled and should " +"be :const:`Py_eval_input`, :const:`Py_file_input`, " +"or :const:`Py_single_input`. The filename specified by *filename* is used " +"to construct the code object and may appear in tracebacks " +"or :exc:`SyntaxError` exception messages. This returns ``NULL`` if the code " +"cannot be parsed or compiled." msgstr "" msgid "" @@ -290,8 +292,8 @@ msgid "" msgstr "" msgid "" -"Evaluate an execution frame. This is a simplified interface to :c:func:" -"`PyEval_EvalFrameEx`, for backward compatibility." +"Evaluate an execution frame. This is a simplified interface " +"to :c:func:`PyEval_EvalFrameEx`, for backward compatibility." msgstr "" msgid "" diff --git a/c-api/weakref.po b/c-api/weakref.po index 5f67eda155..ec7fba7dbd 100644 --- a/c-api/weakref.po +++ b/c-api/weakref.po @@ -132,6 +132,7 @@ msgid "" msgstr "" msgid "" -"In most circumstances, it's more appropriate to use :c:func:" -"`PyObject_ClearWeakRefs` to clear weakrefs instead of this function." +"In most circumstances, it's more appropriate to " +"use :c:func:`PyObject_ClearWeakRefs` to clear weakrefs instead of this " +"function." msgstr "" diff --git a/contents.po b/contents.po index 7491f3c992..4a81626e33 100644 --- a/contents.po +++ b/contents.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/copyright.po b/copyright.po index 31a4789b93..61d681b18a 100644 --- a/copyright.po +++ b/copyright.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po new file mode 100644 index 0000000000..5f6d3b9a21 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -0,0 +1,340 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Maciej Olko, 2026 +# Blessing Oluronbi, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Pending removal in Python 3.15" +msgstr "Oczekujące na usunięcie w Python 3.15" + +msgid "" +"The :c:func:`PyImport_ImportModuleNoBlock`: " +"Use :c:func:`PyImport_ImportModule` instead." +msgstr "" + +msgid "" +":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: " +"Use :c:func:`PyWeakref_GetRef` instead. The `pythoncapi-compat project " +"`__ can be used to " +"get :c:func:`PyWeakref_GetRef` on Python 3.12 and older." +msgstr "" + +msgid "" +":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: " +"Use :c:type:`wchar_t` instead." +msgstr "" + +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: Use :c:func:`PyCodec_Decode` instead." +msgstr "" +":c:func:`!PyUnicode_AsDecodedObject`: używaj w " +"zamian :c:func:`PyCodec_Decode`." + +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: Use :c:func:`PyCodec_Decode` instead; " +"Note that some codecs (for example, \"base64\") may return a type other " +"than :class:`str`, such as :class:`bytes`." +msgstr "" +":c:func:`!PyUnicode_AsDecodedUnicode`: używaj w " +"zamian :c:func:`PyCodec_Decode`; należy pamiętać, że niektóre kodeki (na " +"przykład „base64”) mogą zwracać typ inny niż :class:`str`, taki " +"jak :class:`bytes`." + +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: Use :c:func:`PyCodec_Encode` instead." +msgstr "" +":c:func:`!PyUnicode_AsEncodedObject`: używaj w " +"zamian :c:func:`PyCodec_Encode`." + +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: Use :c:func:`PyCodec_Encode` instead; " +"Note that some codecs (for example, \"base64\") may return a type other " +"than :class:`bytes`, such as :class:`str`." +msgstr "" +":c:func:`!PyUnicode_AsEncodedUnicode`: używaj w " +"zamian :c:func:`PyCodec_Encode`; zwróć uwagę, że niektóre kodeki (na " +"przykład „base64”) mogą zwracać typ inny niż :class:`bytes`, taki " +"jak :class:`str`." + +msgid "Python initialization functions, deprecated in Python 3.13:" +msgstr "Funkcje inicjalizacyjne języka Python, przestarzałe w Python 3.13:" + +msgid "" +":c:func:`Py_GetPath`: Use :c:func:`PyConfig_Get(\"module_search_paths\") " +"` (:data:`sys.path`) instead." +msgstr "" + +msgid "" +":c:func:`Py_GetPrefix`: Use :c:func:`PyConfig_Get(\"base_prefix\") " +"` (:data:`sys.base_prefix`) instead. " +"Use :c:func:`PyConfig_Get(\"prefix\") ` (:data:`sys.prefix`) " +"if :ref:`virtual environments ` need to be handled." +msgstr "" + +msgid "" +":c:func:`Py_GetExecPrefix`: Use :c:func:`PyConfig_Get(\"base_exec_prefix\") " +"` (:data:`sys.base_exec_prefix`) instead. " +"Use :c:func:`PyConfig_Get(\"exec_prefix\") ` " +"(:data:`sys.exec_prefix`) if :ref:`virtual environments ` need to " +"be handled." +msgstr "" + +msgid "" +":c:func:`Py_GetProgramFullPath`: Use :c:func:`PyConfig_Get(\"executable\") " +"` (:data:`sys.executable`) instead." +msgstr "" + +msgid "" +":c:func:`Py_GetProgramName`: Use :c:func:`PyConfig_Get(\"executable\") " +"` (:data:`sys.executable`) instead." +msgstr "" + +msgid "" +":c:func:`Py_GetPythonHome`: Use :c:func:`PyConfig_Get(\"home\") " +"` or the :envvar:`PYTHONHOME` environment variable instead." +msgstr "" + +msgid "" +"The `pythoncapi-compat project `__ can be used to get :c:func:`PyConfig_Get` on Python 3.13 and older." +msgstr "" +"Projektu `python api-compat `__ można użyć do uruchomienia :c:func:`PyConfig_Get` w Pythonie w wersji " +"3.13 i starszych." + +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" +"Funkcje do konfiguracji Pythona,inicjalizacja przestarzały w Python 3.11:" + +msgid ":c:func:`!PySys_SetArgvEx()`: Set :c:member:`PyConfig.argv` instead." +msgstr "" +":c:func:`!PySys_SetArgvEx()`: ustawiaj w zamian :c:member:`PyConfig.argv`." + +msgid ":c:func:`!PySys_SetArgv()`: Set :c:member:`PyConfig.argv` instead." +msgstr "" +":c:func:`!PySys_SetArgv()`: ustawiaj w zamian :c:member:`PyConfig.argv`." + +msgid "" +":c:func:`!Py_SetProgramName()`: Set :c:member:`PyConfig.program_name` " +"instead." +msgstr "" +":c:func:`!Py_SetProgramName()`: ustawiaj w " +"zamian :c:member:`PyConfig.program_name`." + +msgid ":c:func:`!Py_SetPythonHome()`: Set :c:member:`PyConfig.home` instead." +msgstr "" +" :c:func:`!Py_SetPythonHome()`: ustawiaj w zamian :c:member:`PyConfig.home`." + +msgid "" +":c:func:`PySys_ResetWarnOptions`: Clear :data:`sys.warnoptions` and :data:`!" +"warnings.filters` instead." +msgstr "" + +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used " +"with :c:type:`PyConfig` instead." +msgstr "" +"API :c:func:`Py_InitializeFromConfig` należy w zamian używać " +"z :c:type:`PyConfig`." + +msgid "Global configuration variables:" +msgstr "Globalne zmienne konfiguracyjne:" + +msgid "" +":c:var:`Py_DebugFlag`: Use :c:member:`PyConfig.parser_debug` " +"or :c:func:`PyConfig_Get(\"parser_debug\") ` instead." +msgstr "" +":c:var:`Py_DebugFlag`: używaj :c:member:`PyConfig.parser_debug` " +"lub :c:func:`PyConfig_Get(\"parser_debug\") ` w zamian." + +msgid "" +":c:var:`Py_VerboseFlag`: Use :c:member:`PyConfig.verbose` " +"or :c:func:`PyConfig_Get(\"verbose\") ` instead." +msgstr "" +":c:var:`Py_VerboseFlag` :używać :c:member:`PyConfig.verbose` " +"or :c:func:`PyConfig_Get(\"verbose\") ` zamiast." + +msgid "" +":c:var:`Py_QuietFlag`: Use :c:member:`PyConfig.quiet` " +"or :c:func:`PyConfig_Get(\"quiet\") ` instead." +msgstr "" +":c:var:`Py_QuietFlag` : Zamiast tego " +"użyj :c:member:`PyConfig.quiet`:c:func:`PyConfig_Get(\"quiet\") " +"'`' . `Zamiast" + +msgid "" +":c:var:`Py_InteractiveFlag`: Use :c:member:`PyConfig.interactive` " +"or :c:func:`PyConfig_Get(\"interactive\") ` instead." +msgstr "" +":c:var:`Py_InteractiveFlag` : używać :c:member:`PyConfig.interactive` " +"lub :c:func:`PyConfig_Get(\"interaktywny\") '`' " +" Zamiast." + +msgid "" +":c:var:`Py_InspectFlag`: Use :c:member:`PyConfig.inspect` " +"or :c:func:`PyConfig_Get(\"inspect\") ` instead." +msgstr "" +":c:var:`Py_InspectFlag` : " +"używać :c:member:`PyConfig.inspect` :c:func:`PyConfig_Get(\"inspect\") " +"` zamiast tego." + +msgid "" +":c:var:`Py_OptimizeFlag`: Use :c:member:`PyConfig.optimization_level` " +"or :c:func:`PyConfig_Get(\"optimization_level\") ` instead." +msgstr "" +":c:var:`Py_OptimizeFlag` Używać :c:member:`PyConfig.optimization_level` " +"lub :c:func:`PyConfig_Get(\"optimization_level\") ` zamiast " +"tego." + +msgid "" +":c:var:`Py_NoSiteFlag`: Use :c:member:`PyConfig.site_import` " +"or :c:func:`PyConfig_Get(\"site_import\") ` instead." +msgstr "" +":c:var:`Py_NoSiteFlag`: używaj :c:member:`PyConfig.site_import` " +"lub :c:func:`PyConfig_Get(\"site_import\") ` w zamian." + +msgid "" +":c:var:`Py_BytesWarningFlag`: Use :c:member:`PyConfig.bytes_warning` " +"or :c:func:`PyConfig_Get(\"bytes_warning\") ` instead." +msgstr "" +":c:var:`Py_BytesWarningFlag` : używać :c:member:`PyConfig.bytes_warning` " +"lub :c:func:`PyConfig_Get(\"bytes_warning\") zamiast tego." + +msgid "" +":c:var:`Py_FrozenFlag`: Use :c:member:`PyConfig.pathconfig_warnings` " +"or :c:func:`PyConfig_Get(\"pathconfig_warnings\") ` instead." +msgstr "" +":c:var:`Py_FrozenFlag` : używać :c:member:`PyConfig.pathconfig_warnings` " +"lub: :c:func:`PyConfig_Get(\"pathconfig_warnings\") '`' " +" Zamiast." + +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: Use :c:member:`PyConfig.use_environment` " +"or :c:func:`PyConfig_Get(\"use_environment\") ` instead." +msgstr "" +":c:var:`Py_IgnoreEnvironmentFlag` : " +"używać :c:member:`PyConfig.use_environment` " +"lub :c:func:`PyConfig_Get(\"use_environment\") '`' " +" zamiast tego." + +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: Use :c:member:`PyConfig.write_bytecode` " +"or :c:func:`PyConfig_Get(\"write_bytecode\") ` instead." +msgstr "" +" :c:var:`Py_DontWriteBytecodeFlag`: " +"używać :c:member:`PyConfig.write_bytecode` " +"lub :c:func:`PyConfig_Get(\"write_bytecode\") `zamiast lego." + +msgid "" +":c:var:`Py_NoUserSiteDirectory`: " +"Use :c:member:`PyConfig.user_site_directory` " +"or :c:func:`PyConfig_Get(\"user_site_directory\") ` instead." +msgstr "" +":c:var:`Py_NoUserSiteDirectory` : " +"używać :c:member:`PyConfig.user_site_directory` " +"lub :c:func:`PyConfig_Get(\"user_site_directory\") " +" '`'  zamiast tego." + +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: Use :c:member:`PyConfig.buffered_stdio` " +"or :c:func:`PyConfig_Get(\"buffered_stdio\") ` instead." +msgstr "" +":c:var:`Py_UnbufferedStdioFlag`: zastąp :c:member:`PyConfig.buffered_stdio` " +"lub :c:func:`PyConfig_Get(\"buffered_stdio\") `." + +msgid "" +":c:var:`Py_HashRandomizationFlag`: Use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` or :c:func:`PyConfig_Get(\"hash_seed\") " +"` instead." +msgstr "" +":c:var:`Py_HashRandomizationFlag` : " +"Używać :c:member:`PyConfig.use_hash_seed` I :c:member:`PyConfig.hash_seed` " +"or :c:func:`PyConfig_Get(\"hash_seed\") zamiast tego." + +msgid "" +":c:var:`Py_IsolatedFlag`: Use :c:member:`PyConfig.isolated` " +"or :c:func:`PyConfig_Get(\"isolated\") ` instead." +msgstr "" +":c:var:`Py_IsolatedFlag`:używać:c:member:`PyConfig.isolated` " +"lub :c:func:`PyConfig_Get '`'(\"isolated\") " +"`zamiast tego." + +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: " +"Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` " +"or :c:func:`PyConfig_Get(\"legacy_windows_fs_encoding\") ` " +"instead." +msgstr "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: " +"używać :c:member:`PyPreConfig.legacy_windows_fs_encoding` " +"lub :c:func:`PyConfig_Get(\"legacy_windows_fs_encoding\") '`' " +"`zamiast tego." + +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: " +"Use :c:member:`PyConfig.legacy_windows_stdio` " +"or :c:func:`PyConfig_Get(\"legacy_windows_stdio\") ` instead." +msgstr "" +":c:var:`Py_LegacyWindowsStdioFlag`: " +"zastąp :c:member:`PyConfig.legacy_windows_stdio` " +"lub :c:func:`PyConfig_Get(\"legacy_windows_stdio\") `." + +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`, :c:var:`!" +"Py_HasFileSystemDefaultEncoding`: " +"Use :c:member:`PyConfig.filesystem_encoding` " +"or :c:func:`PyConfig_Get(\"filesystem_encoding\") ` instead." +msgstr "" +":c:var:`!Py_FileSystemDefaultEncoding`,:c:var:`!" +"Py_HasFileSystemDefaultEncoding`: " +"używać :c:member:`PyConfig.filesystem_encoding`lub " +" '`' :c:func:`PyConfig_Get(\"filesystem_encoding\") " +"zamiast tego." + +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: " +"Use :c:member:`PyConfig.filesystem_errors` " +"or :c:func:`PyConfig_Get(\"filesystem_errors\") ` instead." +msgstr "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: " +"używać :c:member:`PyConfig.filesystem_errors` " +"lub :c:func:`PyConfig_Get(\"filesystem_errors\") `zamiast tego." + +msgid "" +":c:var:`!Py_UTF8Mode`: Use :c:member:`PyPreConfig.utf8_mode` " +"or :c:func:`PyConfig_Get(\"utf8_mode\") ` instead. " +"(see :c:func:`Py_PreInitialize`)" +msgstr "" +":c:var:`!Py_UTF8Mode`: używać :c:member:`PyPreConfig.utf8_mode` " +"lub :c:func:`PyConfig_Get(\"utf8_mode\") ` zamiast tego " +"(Widzieć:c:func:`Py_PreInitialize`)" + +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used " +"with :c:type:`PyConfig` to set these options. Or :c:func:`PyConfig_Get` can " +"be used to get these options at runtime." +msgstr "" +"The:c:func:`Py_InitializeFromConfig` API należy używać " +"z:c:type:`PyConfig`aby ustawić te opcje. Można:c:func:`PyConfig_Get` też " +"użyć tego polecenia, aby uzyskać te opcje w czasie wykonywania." diff --git a/deprecations/c-api-pending-removal-in-3.18.po b/deprecations/c-api-pending-removal-in-3.18.po index 848383e8b7..e345f41220 100644 --- a/deprecations/c-api-pending-removal-in-3.18.po +++ b/deprecations/c-api-pending-removal-in-3.18.po @@ -33,8 +33,8 @@ msgid ":c:func:`!_PyBytes_Join`: use :c:func:`PyBytes_Join`." msgstr "" msgid "" -":c:func:`!_PyDict_GetItemStringWithError`: use :c:func:" -"`PyDict_GetItemStringRef`." +":c:func:`!_PyDict_GetItemStringWithError`: " +"use :c:func:`PyDict_GetItemStringRef`." msgstr "" msgid ":c:func:`!_PyDict_Pop()`: :c:func:`PyDict_Pop`." @@ -44,13 +44,13 @@ msgid ":c:func:`!_PyLong_Sign()`: use :c:func:`PyLong_GetSign`." msgstr "" msgid "" -":c:func:`!_PyLong_FromDigits` and :c:func:`!_PyLong_New`: use :c:func:" -"`PyLongWriter_Create`." +":c:func:`!_PyLong_FromDigits` and :c:func:`!_PyLong_New`: " +"use :c:func:`PyLongWriter_Create`." msgstr "" msgid "" -":c:func:`!_PyThreadState_UncheckedGet`: use :c:func:" -"`PyThreadState_GetUnchecked`." +":c:func:`!_PyThreadState_UncheckedGet`: " +"use :c:func:`PyThreadState_GetUnchecked`." msgstr "" msgid ":c:func:`!_PyUnicode_AsString`: use :c:func:`PyUnicode_AsUTF8`." @@ -63,45 +63,49 @@ msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_Finish`: replace " -"``_PyUnicodeWriter_Finish(&writer)`` with :c:func:" -"`PyUnicodeWriter_Finish(writer) `." +"``_PyUnicodeWriter_Finish(&writer)`` " +"with :c:func:`PyUnicodeWriter_Finish(writer) `." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_Dealloc`: replace " -"``_PyUnicodeWriter_Dealloc(&writer)`` with :c:func:" -"`PyUnicodeWriter_Discard(writer) `." +"``_PyUnicodeWriter_Dealloc(&writer)`` " +"with :c:func:`PyUnicodeWriter_Discard(writer) `." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteChar`: replace " -"``_PyUnicodeWriter_WriteChar(&writer, ch)`` with :c:func:" -"`PyUnicodeWriter_WriteChar(writer, ch) `." +"``_PyUnicodeWriter_WriteChar(&writer, ch)`` " +"with :c:func:`PyUnicodeWriter_WriteChar(writer, ch) " +"`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteStr`: replace " -"``_PyUnicodeWriter_WriteStr(&writer, str)`` with :c:func:" -"`PyUnicodeWriter_WriteStr(writer, str) `." +"``_PyUnicodeWriter_WriteStr(&writer, str)`` " +"with :c:func:`PyUnicodeWriter_WriteStr(writer, str) " +"`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteSubstring`: replace " -"``_PyUnicodeWriter_WriteSubstring(&writer, str, start, end)`` with :c:func:" -"`PyUnicodeWriter_WriteSubstring(writer, str, start, end) " +"``_PyUnicodeWriter_WriteSubstring(&writer, str, start, end)`` " +"with :c:func:`PyUnicodeWriter_WriteSubstring(writer, str, start, end) " "`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteASCIIString`: replace " -"``_PyUnicodeWriter_WriteASCIIString(&writer, str)`` with :c:func:" -"`PyUnicodeWriter_WriteUTF8(writer, str) `." +"``_PyUnicodeWriter_WriteASCIIString(&writer, str)`` " +"with :c:func:`PyUnicodeWriter_WriteUTF8(writer, str) " +"`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteLatin1String`: replace " -"``_PyUnicodeWriter_WriteLatin1String(&writer, str)`` with :c:func:" -"`PyUnicodeWriter_WriteUTF8(writer, str) `." +"``_PyUnicodeWriter_WriteLatin1String(&writer, str)`` " +"with :c:func:`PyUnicodeWriter_WriteUTF8(writer, str) " +"`." msgstr "" msgid ":c:func:`!_PyUnicodeWriter_Prepare`: (no replacement)." diff --git a/deprecations/index.po b/deprecations/index.po index bea2279b9e..f92e38b6ee 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -4,16 +4,18 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,23 +29,24 @@ msgid "Deprecations" msgstr "Deprecjacje" msgid "Pending removal in Python 3.15" -msgstr "" +msgstr "Oczekujące na usunięcie w Python 3.15" msgid "The import system:" msgstr "" msgid "" -"Setting :attr:`~module.__cached__` on a module while failing to set :attr:" -"`__spec__.cached ` is deprecated. In " -"Python 3.15, :attr:`!__cached__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__cached__` on a module while failing to " +"set :attr:`__spec__.cached ` is " +"deprecated. In Python 3.15, :attr:`!__cached__` will cease to be set or take " +"into consideration by the import system or standard library. (:gh:`97879`)" msgstr "" msgid "" -"Setting :attr:`~module.__package__` on a module while failing to set :attr:" -"`__spec__.parent ` is deprecated. In " -"Python 3.15, :attr:`!__package__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__package__` on a module while failing to " +"set :attr:`__spec__.parent ` is " +"deprecated. In Python 3.15, :attr:`!__package__` will cease to be set or " +"take into consideration by the import system or standard library. " +"(:gh:`97879`)" msgstr "" msgid ":mod:`ctypes`:" @@ -74,23 +77,12 @@ msgstr ":mod:`importlib`:" msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" -msgid ":class:`locale`:" -msgstr ":class:`locale`:" - -msgid "" -"The :func:`~locale.getdefaultlocale` function has been deprecated since " -"Python 3.11. Its removal was originally planned for Python 3.13 (:gh:" -"`90817`), but has been postponed to Python 3.15. Use :func:`~locale." -"getlocale`, :func:`~locale.setlocale`, and :func:`~locale.getencoding` " -"instead. (Contributed by Hugo van Kemenade in :gh:`111187`.)" -msgstr "" - msgid ":mod:`pathlib`:" msgstr ":mod:`pathlib`:" msgid "" -":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. Use :" -"func:`os.path.isreserved` to detect reserved paths on Windows." +":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. " +"Use :func:`os.path.isreserved` to detect reserved paths on Windows." msgstr "" msgid ":mod:`platform`:" @@ -134,10 +126,10 @@ msgid ":mod:`typing`:" msgstr ":mod:`typing`:" msgid "" -"The undocumented keyword argument syntax for creating :class:`~typing." -"NamedTuple` classes (for example, ``Point = NamedTuple(\"Point\", x=int, " -"y=int)``) has been deprecated since Python 3.13. Use the class-based syntax " -"or the functional syntax instead." +"The undocumented keyword argument syntax for " +"creating :class:`~typing.NamedTuple` classes (for example, ``Point = " +"NamedTuple(\"Point\", x=int, y=int)``) has been deprecated since Python " +"3.13. Use the class-based syntax or the functional syntax instead." msgstr "" msgid "" @@ -149,7 +141,7 @@ msgid "" msgstr "" msgid "" -"The :func:`typing.no_type_check_decorator` decorator function has been " +"The :deco:`typing.no_type_check_decorator` decorator function has been " "deprecated since Python 3.13. After eight years in the :mod:`typing` module, " "it has yet to be supported by any major type checker." msgstr "" @@ -158,9 +150,10 @@ msgid ":mod:`wave`:" msgstr ":mod:`wave`:" msgid "" -"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, and :meth:`~wave." -"Wave_read.getmarkers` methods of the :class:`~wave.Wave_read` and :class:" -"`~wave.Wave_write` classes have been deprecated since Python 3.13." +"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, " +"and :meth:`~wave.Wave_read.getmarkers` methods of " +"the :class:`~wave.Wave_read` and :class:`~wave.Wave_write` classes have been " +"deprecated since Python 3.13." msgstr "" msgid ":mod:`zipimport`:" @@ -176,10 +169,10 @@ msgid "Pending removal in Python 3.16" msgstr "" msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader ` is deprecated. In " -"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." +"Setting :attr:`~module.__loader__` on a module while failing to " +"set :attr:`__spec__.loader ` is " +"deprecated. In Python 3.16, :attr:`!__loader__` will cease to be set or " +"taken into consideration by the import system or the standard library." msgstr "" msgid ":mod:`array`:" @@ -276,10 +269,10 @@ msgid ":mod:`mimetypes`:" msgstr ":mod:`mimetypes`:" msgid "" -"Valid extensions start with a '.' or are empty for :meth:`mimetypes." -"MimeTypes.add_type`. Undotted extensions are deprecated and will raise a :" -"exc:`ValueError` in Python 3.16. (Contributed by Hugo van Kemenade in :gh:" -"`75223`.)" +"Valid extensions start with a '.' or are empty " +"for :meth:`mimetypes.MimeTypes.add_type`. Undotted extensions are deprecated " +"and will raise a :exc:`ValueError` in Python 3.16. (Contributed by Hugo van " +"Kemenade in :gh:`75223`.)" msgstr "" msgid ":mod:`shutil`:" @@ -386,9 +379,9 @@ msgid "Pending removal in Python 3.19" msgstr "" msgid "" -"Implicitly switching to the MSVC-compatible struct layout by setting :attr:" -"`~ctypes.Structure._pack_` but not :attr:`~ctypes.Structure._layout_` on non-" -"Windows platforms." +"Implicitly switching to the MSVC-compatible struct layout by " +"setting :attr:`~ctypes.Structure._pack_` but " +"not :attr:`~ctypes.Structure._layout_` on non-Windows platforms." msgstr "" msgid "Pending removal in future versions" @@ -407,8 +400,8 @@ msgid "" msgstr "" msgid "" -"Passing the undocumented keyword argument *prefix_chars* to :meth:`~argparse." -"ArgumentParser.add_argument_group` is now deprecated." +"Passing the undocumented keyword argument *prefix_chars* " +"to :meth:`~argparse.ArgumentParser.add_argument_group` is now deprecated." msgstr "" msgid "The :class:`argparse.FileType` type converter is deprecated." @@ -425,10 +418,10 @@ msgid "" "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " "ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " "``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " -"if the numeric literal is immediately followed by one of keywords :keyword:" -"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" -"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " -"syntax error. (:gh:`87999`)" +"if the numeric literal is immediately followed by one of " +"keywords :keyword:`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :keyword:`is` " +"and :keyword:`or`. In a future release it will be changed to a syntax " +"error. (:gh:`87999`)" msgstr "" msgid "" @@ -438,33 +431,34 @@ msgid "" msgstr "" msgid "" -"Support for ``__float__()`` method returning a strict subclass of :class:" -"`float`: these methods will be required to return an instance of :class:" -"`float`." +"Support for ``__float__()`` method returning a strict subclass " +"of :class:`float`: these methods will be required to return an instance " +"of :class:`float`." msgstr "" msgid "" -"Support for ``__complex__()`` method returning a strict subclass of :class:" -"`complex`: these methods will be required to return an instance of :class:" -"`complex`." +"Support for ``__complex__()`` method returning a strict subclass " +"of :class:`complex`: these methods will be required to return an instance " +"of :class:`complex`." msgstr "" msgid "" -"Passing a complex number as the *real* or *imag* argument in the :func:" -"`complex` constructor is now deprecated; it should only be passed as a " -"single positional argument. (Contributed by Serhiy Storchaka in :gh:" -"`109218`.)" +"Passing a complex number as the *real* or *imag* argument in " +"the :func:`complex` constructor is now deprecated; it should only be passed " +"as a single positional argument. (Contributed by Serhiy Storchaka " +"in :gh:`109218`.)" msgstr "" msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " -"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." -"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +"are deprecated and replaced by :data:`calendar.JANUARY` " +"and :data:`calendar.FEBRUARY`. (Contributed by Prince Roshan " +"in :gh:`103636`.)" msgstr "" msgid "" -":mod:`codecs`: use :func:`open` instead of :func:`codecs.open`. (:gh:" -"`133038`)" +":mod:`codecs`: use :func:`open` instead of :func:`codecs.open`. " +"(:gh:`133038`)" msgstr "" msgid "" @@ -476,13 +470,13 @@ msgid ":mod:`datetime`:" msgstr ":mod:`datetime`:" msgid "" -":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." -"UTC)``." +":meth:`~datetime.datetime.utcnow`: use " +"``datetime.datetime.now(tz=datetime.UTC)``." msgstr "" msgid "" -":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." -"fromtimestamp(timestamp, tz=datetime.UTC)``." +":meth:`~datetime.datetime.utcfromtimestamp`: use " +"``datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" msgid ":mod:`gettext`: Plural value must be an integer." @@ -545,8 +539,8 @@ msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." msgstr "" msgid "" -":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" -"`!selected_npn_protocol` are deprecated: use ALPN instead." +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` " +"and :meth:`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" msgid "``ssl.OP_NO_SSL*`` options" @@ -583,21 +577,21 @@ msgid ":mod:`threading` methods:" msgstr "" msgid "" -":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." -"notify_all`." +":meth:`!threading.Condition.notifyAll`: " +"use :meth:`~threading.Condition.notify_all`." msgstr "" msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." msgstr "" msgid "" -":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" -"attr:`threading.Thread.daemon` attribute." +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: " +"use :attr:`threading.Thread.daemon` attribute." msgstr "" msgid "" -":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" -"attr:`threading.Thread.name` attribute." +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: " +"use :attr:`threading.Thread.name` attribute." msgstr "" msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." @@ -665,59 +659,71 @@ msgid "" msgstr "" msgid "" -":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." -"etree.ElementTree.Element` is deprecated. In a future release it will always " -"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " -"instead." +":mod:`xml.etree.ElementTree`: Testing the truth value of " +"an :class:`~xml.etree.ElementTree.Element` is deprecated. In a future " +"release it will always return ``True``. Prefer explicit ``len(elem)`` or " +"``elem is not None`` tests instead." msgstr "" msgid "" -":func:`sys._clear_type_cache` is deprecated: use :func:`sys." -"_clear_internal_caches` instead." +":func:`sys._clear_type_cache` is deprecated: " +"use :func:`sys._clear_internal_caches` instead." msgstr "" msgid "C API deprecations" msgstr "" msgid "" -"The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" -"`PyImport_ImportModule` instead." +"The :c:func:`PyImport_ImportModuleNoBlock`: " +"Use :c:func:`PyImport_ImportModule` instead." msgstr "" msgid "" -":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: Use :c:" -"func:`PyWeakref_GetRef` instead. The `pythoncapi-compat project `__ can be used to get :c:func:" -"`PyWeakref_GetRef` on Python 3.12 and older." +":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: " +"Use :c:func:`PyWeakref_GetRef` instead. The `pythoncapi-compat project " +"`__ can be used to " +"get :c:func:`PyWeakref_GetRef` on Python 3.12 and older." msgstr "" msgid "" -":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: Use :c:" -"type:`wchar_t` instead." +":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: " +"Use :c:type:`wchar_t` instead." msgstr "" msgid "" ":c:func:`!PyUnicode_AsDecodedObject`: Use :c:func:`PyCodec_Decode` instead." msgstr "" +":c:func:`!PyUnicode_AsDecodedObject`: używaj w " +"zamian :c:func:`PyCodec_Decode`." msgid "" ":c:func:`!PyUnicode_AsDecodedUnicode`: Use :c:func:`PyCodec_Decode` instead; " "Note that some codecs (for example, \"base64\") may return a type other " "than :class:`str`, such as :class:`bytes`." msgstr "" +":c:func:`!PyUnicode_AsDecodedUnicode`: używaj w " +"zamian :c:func:`PyCodec_Decode`; należy pamiętać, że niektóre kodeki (na " +"przykład „base64”) mogą zwracać typ inny niż :class:`str`, taki " +"jak :class:`bytes`." msgid "" ":c:func:`!PyUnicode_AsEncodedObject`: Use :c:func:`PyCodec_Encode` instead." msgstr "" +":c:func:`!PyUnicode_AsEncodedObject`: używaj w " +"zamian :c:func:`PyCodec_Encode`." msgid "" ":c:func:`!PyUnicode_AsEncodedUnicode`: Use :c:func:`PyCodec_Encode` instead; " "Note that some codecs (for example, \"base64\") may return a type other " "than :class:`bytes`, such as :class:`str`." msgstr "" +":c:func:`!PyUnicode_AsEncodedUnicode`: używaj w " +"zamian :c:func:`PyCodec_Encode`; zwróć uwagę, że niektóre kodeki (na " +"przykład „base64”) mogą zwracać typ inny niż :class:`bytes`, taki " +"jak :class:`str`." msgid "Python initialization functions, deprecated in Python 3.13:" -msgstr "" +msgstr "Funkcje inicjalizacyjne języka Python, przestarzałe w Python 3.13:" msgid "" ":c:func:`Py_GetPath`: Use :c:func:`PyConfig_Get(\"module_search_paths\") " @@ -726,16 +732,17 @@ msgstr "" msgid "" ":c:func:`Py_GetPrefix`: Use :c:func:`PyConfig_Get(\"base_prefix\") " -"` (:data:`sys.base_prefix`) instead. Use :c:func:" -"`PyConfig_Get(\"prefix\") ` (:data:`sys.prefix`) if :ref:" -"`virtual environments ` need to be handled." +"` (:data:`sys.base_prefix`) instead. " +"Use :c:func:`PyConfig_Get(\"prefix\") ` (:data:`sys.prefix`) " +"if :ref:`virtual environments ` need to be handled." msgstr "" msgid "" ":c:func:`Py_GetExecPrefix`: Use :c:func:`PyConfig_Get(\"base_exec_prefix\") " -"` (:data:`sys.base_exec_prefix`) instead. Use :c:func:" -"`PyConfig_Get(\"exec_prefix\") ` (:data:`sys.exec_prefix`) if :" -"ref:`virtual environments ` need to be handled." +"` (:data:`sys.base_exec_prefix`) instead. " +"Use :c:func:`PyConfig_Get(\"exec_prefix\") ` " +"(:data:`sys.exec_prefix`) if :ref:`virtual environments ` need to " +"be handled." msgstr "" msgid "" @@ -757,24 +764,33 @@ msgid "" "The `pythoncapi-compat project `__ can be used to get :c:func:`PyConfig_Get` on Python 3.13 and older." msgstr "" +"Projektu `python api-compat `__ można użyć do uruchomienia :c:func:`PyConfig_Get` w Pythonie w wersji " +"3.13 i starszych." msgid "" "Functions to configure Python's initialization, deprecated in Python 3.11:" msgstr "" +"Funkcje do konfiguracji Pythona,inicjalizacja przestarzały w Python 3.11:" msgid ":c:func:`!PySys_SetArgvEx()`: Set :c:member:`PyConfig.argv` instead." msgstr "" +":c:func:`!PySys_SetArgvEx()`: ustawiaj w zamian :c:member:`PyConfig.argv`." msgid ":c:func:`!PySys_SetArgv()`: Set :c:member:`PyConfig.argv` instead." msgstr "" +":c:func:`!PySys_SetArgv()`: ustawiaj w zamian :c:member:`PyConfig.argv`." msgid "" ":c:func:`!Py_SetProgramName()`: Set :c:member:`PyConfig.program_name` " "instead." msgstr "" +":c:func:`!Py_SetProgramName()`: ustawiaj w " +"zamian :c:member:`PyConfig.program_name`." msgid ":c:func:`!Py_SetPythonHome()`: Set :c:member:`PyConfig.home` instead." msgstr "" +" :c:func:`!Py_SetPythonHome()`: ustawiaj w zamian :c:member:`PyConfig.home`." msgid "" ":c:func:`PySys_ResetWarnOptions`: Clear :data:`sys.warnoptions` and :data:`!" @@ -782,126 +798,192 @@ msgid "" msgstr "" msgid "" -"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" -"`PyConfig` instead." +"The :c:func:`Py_InitializeFromConfig` API should be used " +"with :c:type:`PyConfig` instead." msgstr "" +"API :c:func:`Py_InitializeFromConfig` należy w zamian używać " +"z :c:type:`PyConfig`." msgid "Global configuration variables:" -msgstr "" +msgstr "Globalne zmienne konfiguracyjne:" msgid "" -":c:var:`Py_DebugFlag`: Use :c:member:`PyConfig.parser_debug` or :c:func:" -"`PyConfig_Get(\"parser_debug\") ` instead." +":c:var:`Py_DebugFlag`: Use :c:member:`PyConfig.parser_debug` " +"or :c:func:`PyConfig_Get(\"parser_debug\") ` instead." msgstr "" +":c:var:`Py_DebugFlag`: używaj :c:member:`PyConfig.parser_debug` " +"lub :c:func:`PyConfig_Get(\"parser_debug\") ` w zamian." msgid "" -":c:var:`Py_VerboseFlag`: Use :c:member:`PyConfig.verbose` or :c:func:" -"`PyConfig_Get(\"verbose\") ` instead." +":c:var:`Py_VerboseFlag`: Use :c:member:`PyConfig.verbose` " +"or :c:func:`PyConfig_Get(\"verbose\") ` instead." msgstr "" +":c:var:`Py_VerboseFlag` :używać :c:member:`PyConfig.verbose` " +"or :c:func:`PyConfig_Get(\"verbose\") ` zamiast." msgid "" -":c:var:`Py_QuietFlag`: Use :c:member:`PyConfig.quiet` or :c:func:" -"`PyConfig_Get(\"quiet\") ` instead." +":c:var:`Py_QuietFlag`: Use :c:member:`PyConfig.quiet` " +"or :c:func:`PyConfig_Get(\"quiet\") ` instead." msgstr "" +":c:var:`Py_QuietFlag` : Zamiast tego " +"użyj :c:member:`PyConfig.quiet`:c:func:`PyConfig_Get(\"quiet\") " +"'`' . `Zamiast" msgid "" -":c:var:`Py_InteractiveFlag`: Use :c:member:`PyConfig.interactive` or :c:func:" -"`PyConfig_Get(\"interactive\") ` instead." +":c:var:`Py_InteractiveFlag`: Use :c:member:`PyConfig.interactive` " +"or :c:func:`PyConfig_Get(\"interactive\") ` instead." msgstr "" +":c:var:`Py_InteractiveFlag` : używać :c:member:`PyConfig.interactive` " +"lub :c:func:`PyConfig_Get(\"interaktywny\") '`' " +" Zamiast." msgid "" -":c:var:`Py_InspectFlag`: Use :c:member:`PyConfig.inspect` or :c:func:" -"`PyConfig_Get(\"inspect\") ` instead." +":c:var:`Py_InspectFlag`: Use :c:member:`PyConfig.inspect` " +"or :c:func:`PyConfig_Get(\"inspect\") ` instead." msgstr "" +":c:var:`Py_InspectFlag` : " +"używać :c:member:`PyConfig.inspect` :c:func:`PyConfig_Get(\"inspect\") " +"` zamiast tego." msgid "" -":c:var:`Py_OptimizeFlag`: Use :c:member:`PyConfig.optimization_level` or :c:" -"func:`PyConfig_Get(\"optimization_level\") ` instead." +":c:var:`Py_OptimizeFlag`: Use :c:member:`PyConfig.optimization_level` " +"or :c:func:`PyConfig_Get(\"optimization_level\") ` instead." msgstr "" +":c:var:`Py_OptimizeFlag` Używać :c:member:`PyConfig.optimization_level` " +"lub :c:func:`PyConfig_Get(\"optimization_level\") ` zamiast " +"tego." msgid "" -":c:var:`Py_NoSiteFlag`: Use :c:member:`PyConfig.site_import` or :c:func:" -"`PyConfig_Get(\"site_import\") ` instead." +":c:var:`Py_NoSiteFlag`: Use :c:member:`PyConfig.site_import` " +"or :c:func:`PyConfig_Get(\"site_import\") ` instead." msgstr "" +":c:var:`Py_NoSiteFlag`: używaj :c:member:`PyConfig.site_import` " +"lub :c:func:`PyConfig_Get(\"site_import\") ` w zamian." msgid "" -":c:var:`Py_BytesWarningFlag`: Use :c:member:`PyConfig.bytes_warning` or :c:" -"func:`PyConfig_Get(\"bytes_warning\") ` instead." +":c:var:`Py_BytesWarningFlag`: Use :c:member:`PyConfig.bytes_warning` " +"or :c:func:`PyConfig_Get(\"bytes_warning\") ` instead." msgstr "" +":c:var:`Py_BytesWarningFlag` : używać :c:member:`PyConfig.bytes_warning` " +"lub :c:func:`PyConfig_Get(\"bytes_warning\") zamiast tego." msgid "" -":c:var:`Py_FrozenFlag`: Use :c:member:`PyConfig.pathconfig_warnings` or :c:" -"func:`PyConfig_Get(\"pathconfig_warnings\") ` instead." +":c:var:`Py_FrozenFlag`: Use :c:member:`PyConfig.pathconfig_warnings` " +"or :c:func:`PyConfig_Get(\"pathconfig_warnings\") ` instead." msgstr "" +":c:var:`Py_FrozenFlag` : używać :c:member:`PyConfig.pathconfig_warnings` " +"lub: :c:func:`PyConfig_Get(\"pathconfig_warnings\") '`' " +" Zamiast." msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: Use :c:member:`PyConfig.use_environment` " "or :c:func:`PyConfig_Get(\"use_environment\") ` instead." msgstr "" +":c:var:`Py_IgnoreEnvironmentFlag` : " +"używać :c:member:`PyConfig.use_environment` " +"lub :c:func:`PyConfig_Get(\"use_environment\") '`' " +" zamiast tego." msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: Use :c:member:`PyConfig.write_bytecode` " "or :c:func:`PyConfig_Get(\"write_bytecode\") ` instead." msgstr "" +" :c:var:`Py_DontWriteBytecodeFlag`: " +"używać :c:member:`PyConfig.write_bytecode` " +"lub :c:func:`PyConfig_Get(\"write_bytecode\") `zamiast lego." msgid "" -":c:var:`Py_NoUserSiteDirectory`: Use :c:member:`PyConfig." -"user_site_directory` or :c:func:`PyConfig_Get(\"user_site_directory\") " -"` instead." +":c:var:`Py_NoUserSiteDirectory`: " +"Use :c:member:`PyConfig.user_site_directory` " +"or :c:func:`PyConfig_Get(\"user_site_directory\") ` instead." msgstr "" +":c:var:`Py_NoUserSiteDirectory` : " +"używać :c:member:`PyConfig.user_site_directory` " +"lub :c:func:`PyConfig_Get(\"user_site_directory\") " +" '`'  zamiast tego." msgid "" -":c:var:`Py_UnbufferedStdioFlag`: Use :c:member:`PyConfig.buffered_stdio` or :" -"c:func:`PyConfig_Get(\"buffered_stdio\") ` instead." +":c:var:`Py_UnbufferedStdioFlag`: Use :c:member:`PyConfig.buffered_stdio` " +"or :c:func:`PyConfig_Get(\"buffered_stdio\") ` instead." msgstr "" +":c:var:`Py_UnbufferedStdioFlag`: zastąp :c:member:`PyConfig.buffered_stdio` " +"lub :c:func:`PyConfig_Get(\"buffered_stdio\") `." msgid "" ":c:var:`Py_HashRandomizationFlag`: Use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed` or :c:func:`PyConfig_Get(\"hash_seed\") " "` instead." msgstr "" +":c:var:`Py_HashRandomizationFlag` : " +"Używać :c:member:`PyConfig.use_hash_seed` I :c:member:`PyConfig.hash_seed` " +"or :c:func:`PyConfig_Get(\"hash_seed\") zamiast tego." msgid "" -":c:var:`Py_IsolatedFlag`: Use :c:member:`PyConfig.isolated` or :c:func:" -"`PyConfig_Get(\"isolated\") ` instead." +":c:var:`Py_IsolatedFlag`: Use :c:member:`PyConfig.isolated` " +"or :c:func:`PyConfig_Get(\"isolated\") ` instead." msgstr "" +":c:var:`Py_IsolatedFlag`:używać:c:member:`PyConfig.isolated` " +"lub :c:func:`PyConfig_Get '`'(\"isolated\") " +"`zamiast tego." msgid "" -":c:var:`Py_LegacyWindowsFSEncodingFlag`: Use :c:member:`PyPreConfig." -"legacy_windows_fs_encoding` or :c:func:" -"`PyConfig_Get(\"legacy_windows_fs_encoding\") ` instead." +":c:var:`Py_LegacyWindowsFSEncodingFlag`: " +"Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` " +"or :c:func:`PyConfig_Get(\"legacy_windows_fs_encoding\") ` " +"instead." msgstr "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: " +"używać :c:member:`PyPreConfig.legacy_windows_fs_encoding` " +"lub :c:func:`PyConfig_Get(\"legacy_windows_fs_encoding\") '`' " +"`zamiast tego." msgid "" -":c:var:`Py_LegacyWindowsStdioFlag`: Use :c:member:`PyConfig." -"legacy_windows_stdio` or :c:func:`PyConfig_Get(\"legacy_windows_stdio\") " -"` instead." +":c:var:`Py_LegacyWindowsStdioFlag`: " +"Use :c:member:`PyConfig.legacy_windows_stdio` " +"or :c:func:`PyConfig_Get(\"legacy_windows_stdio\") ` instead." msgstr "" +":c:var:`Py_LegacyWindowsStdioFlag`: " +"zastąp :c:member:`PyConfig.legacy_windows_stdio` " +"lub :c:func:`PyConfig_Get(\"legacy_windows_stdio\") `." msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`, :c:var:`!" -"Py_HasFileSystemDefaultEncoding`: Use :c:member:`PyConfig." -"filesystem_encoding` or :c:func:`PyConfig_Get(\"filesystem_encoding\") " -"` instead." +"Py_HasFileSystemDefaultEncoding`: " +"Use :c:member:`PyConfig.filesystem_encoding` " +"or :c:func:`PyConfig_Get(\"filesystem_encoding\") ` instead." msgstr "" +":c:var:`!Py_FileSystemDefaultEncoding`,:c:var:`!" +"Py_HasFileSystemDefaultEncoding`: " +"używać :c:member:`PyConfig.filesystem_encoding`lub " +" '`' :c:func:`PyConfig_Get(\"filesystem_encoding\") " +"zamiast tego." msgid "" -":c:var:`!Py_FileSystemDefaultEncodeErrors`: Use :c:member:`PyConfig." -"filesystem_errors` or :c:func:`PyConfig_Get(\"filesystem_errors\") " -"` instead." +":c:var:`!Py_FileSystemDefaultEncodeErrors`: " +"Use :c:member:`PyConfig.filesystem_errors` " +"or :c:func:`PyConfig_Get(\"filesystem_errors\") ` instead." msgstr "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: " +"używać :c:member:`PyConfig.filesystem_errors` " +"lub :c:func:`PyConfig_Get(\"filesystem_errors\") `zamiast tego." msgid "" -":c:var:`!Py_UTF8Mode`: Use :c:member:`PyPreConfig.utf8_mode` or :c:func:" -"`PyConfig_Get(\"utf8_mode\") ` instead. (see :c:func:" -"`Py_PreInitialize`)" +":c:var:`!Py_UTF8Mode`: Use :c:member:`PyPreConfig.utf8_mode` " +"or :c:func:`PyConfig_Get(\"utf8_mode\") ` instead. " +"(see :c:func:`Py_PreInitialize`)" msgstr "" +":c:var:`!Py_UTF8Mode`: używać :c:member:`PyPreConfig.utf8_mode` " +"lub :c:func:`PyConfig_Get(\"utf8_mode\") ` zamiast tego " +"(Widzieć:c:func:`Py_PreInitialize`)" msgid "" -"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" -"`PyConfig` to set these options. Or :c:func:`PyConfig_Get` can be used to " -"get these options at runtime." +"The :c:func:`Py_InitializeFromConfig` API should be used " +"with :c:type:`PyConfig` to set these options. Or :c:func:`PyConfig_Get` can " +"be used to get these options at runtime." msgstr "" +"The:c:func:`Py_InitializeFromConfig` API należy używać " +"z:c:type:`PyConfig`aby ustawić te opcje. Można:c:func:`PyConfig_Get` też " +"użyć tego polecenia, aby uzyskać te opcje w czasie wykonywania." msgid "" "The following private functions are deprecated and planned for removal in " @@ -912,8 +994,8 @@ msgid ":c:func:`!_PyBytes_Join`: use :c:func:`PyBytes_Join`." msgstr "" msgid "" -":c:func:`!_PyDict_GetItemStringWithError`: use :c:func:" -"`PyDict_GetItemStringRef`." +":c:func:`!_PyDict_GetItemStringWithError`: " +"use :c:func:`PyDict_GetItemStringRef`." msgstr "" msgid ":c:func:`!_PyDict_Pop()`: use :c:func:`PyDict_Pop`." @@ -923,13 +1005,13 @@ msgid ":c:func:`!_PyLong_Sign()`: use :c:func:`PyLong_GetSign`." msgstr "" msgid "" -":c:func:`!_PyLong_FromDigits` and :c:func:`!_PyLong_New`: use :c:func:" -"`PyLongWriter_Create`." +":c:func:`!_PyLong_FromDigits` and :c:func:`!_PyLong_New`: " +"use :c:func:`PyLongWriter_Create`." msgstr "" msgid "" -":c:func:`!_PyThreadState_UncheckedGet`: use :c:func:" -"`PyThreadState_GetUnchecked`." +":c:func:`!_PyThreadState_UncheckedGet`: " +"use :c:func:`PyThreadState_GetUnchecked`." msgstr "" msgid ":c:func:`!_PyUnicode_AsString`: use :c:func:`PyUnicode_AsUTF8`." @@ -942,45 +1024,50 @@ msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_Finish`: replace " -"``_PyUnicodeWriter_Finish(&writer)`` with :c:func:" -"`PyUnicodeWriter_Finish(writer) `." +"``_PyUnicodeWriter_Finish(&writer)`` " +"with :c:func:`PyUnicodeWriter_Finish(writer) `." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_Dealloc`: replace " -"``_PyUnicodeWriter_Dealloc(&writer)`` with :c:func:" -"`PyUnicodeWriter_Discard(writer) `." +"``_PyUnicodeWriter_Dealloc(&writer)`` " +"with :c:func:`PyUnicodeWriter_Discard(writer) `." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteChar`: replace " -"``_PyUnicodeWriter_WriteChar(&writer, ch)`` with :c:func:" -"`PyUnicodeWriter_WriteChar(writer, ch) `." +"``_PyUnicodeWriter_WriteChar(&writer, ch)`` " +"with :c:func:`PyUnicodeWriter_WriteChar(writer, ch) " +"`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteStr`: replace " -"``_PyUnicodeWriter_WriteStr(&writer, str)`` with :c:func:" -"`PyUnicodeWriter_WriteStr(writer, str) `." +"``_PyUnicodeWriter_WriteStr(&writer, str)`` " +"with :c:func:`PyUnicodeWriter_WriteStr(writer, str) " +"`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteSubstring`: replace " -"``_PyUnicodeWriter_WriteSubstring(&writer, str, start, end)`` with :c:func:" -"`PyUnicodeWriter_WriteSubstring(writer, str, start, end) " +"``_PyUnicodeWriter_WriteSubstring(&writer, str, start, end)`` " +"with :c:func:`PyUnicodeWriter_WriteSubstring(writer, str, start, end) " "`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteASCIIString`: replace " -"``_PyUnicodeWriter_WriteASCIIString(&writer, str)`` with :c:func:" -"`PyUnicodeWriter_WriteASCII(writer, str) `." +"``_PyUnicodeWriter_WriteASCIIString(&writer, str, size)`` " +"with :c:func:`PyUnicodeWriter_WriteASCII(writer, str, size) " +"`." msgstr "" msgid "" ":c:func:`!_PyUnicodeWriter_WriteLatin1String`: replace " -"``_PyUnicodeWriter_WriteLatin1String(&writer, str)`` with :c:func:" -"`PyUnicodeWriter_WriteUTF8(writer, str) `." +"``_PyUnicodeWriter_WriteLatin1String(&writer, str, size)`` by decoding the " +"string with :c:func:`PyUnicode_DecodeLatin1`, writing the result " +"with :c:func:`PyUnicodeWriter_WriteStr`, and releasing the result " +"with :c:func:`Py_DECREF`." msgstr "" msgid ":c:func:`!_PyUnicodeWriter_Prepare`: (no replacement)." @@ -1030,8 +1117,8 @@ msgid ":c:func:`PyOS_AfterFork`: Use :c:func:`PyOS_AfterFork_Child` instead." msgstr "" msgid "" -":c:func:`PySlice_GetIndicesEx`: Use :c:func:`PySlice_Unpack` and :c:func:" -"`PySlice_AdjustIndices` instead." +":c:func:`PySlice_GetIndicesEx`: Use :c:func:`PySlice_Unpack` " +"and :c:func:`PySlice_AdjustIndices` instead." msgstr "" msgid ":c:func:`PyUnicode_READY`: Unneeded since Python 3.12" diff --git a/deprecations/pending-removal-in-3.13.po b/deprecations/pending-removal-in-3.13.po index 87b0625226..639258d955 100644 --- a/deprecations/pending-removal-in-3.13.po +++ b/deprecations/pending-removal-in-3.13.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po index fba5edd1f1..43b8858b4e 100644 --- a/deprecations/pending-removal-in-3.14.po +++ b/deprecations/pending-removal-in-3.14.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -54,8 +54,8 @@ msgid ":class:`!ast.Ellipsis`" msgstr ":class:`!ast.Ellipsis`" msgid "" -"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" -"`90953`.)" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka " +"in :gh:`90953`.)" msgstr "" msgid ":mod:`asyncio`:" @@ -63,14 +63,15 @@ msgstr ":mod:`asyncio`:" msgid "" "The child watcher classes :class:`!asyncio.MultiLoopChildWatcher`, :class:`!" -"asyncio.FastChildWatcher`, :class:`!asyncio.AbstractChildWatcher` and :class:" -"`!asyncio.SafeChildWatcher` are deprecated and will be removed in Python " -"3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +"asyncio.FastChildWatcher`, :class:`!asyncio.AbstractChildWatcher` " +"and :class:`!asyncio.SafeChildWatcher` are deprecated and will be removed in " +"Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" msgid "" -":func:`!asyncio.set_child_watcher`, :func:`!asyncio.get_child_watcher`, :" -"meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`!" +":func:`!asyncio.set_child_watcher`, :func:`!" +"asyncio.get_child_watcher`, :meth:`!" +"asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`!" "asyncio.AbstractEventLoopPolicy.get_child_watcher` are deprecated and will " "be removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" @@ -83,8 +84,9 @@ msgid "" msgstr "" msgid "" -":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." -"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +":mod:`email`: Deprecated the *isdst* parameter " +"in :func:`email.utils.localtime`. (Contributed by Alan Williams " +"in :gh:`72346`.)" msgstr "" msgid ":mod:`importlib.abc` deprecated classes:" @@ -123,14 +125,15 @@ msgid "" "on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " "currently the default (:gh:`84559`). Adding a runtime warning about this was " "deemed too disruptive as the majority of code is not expected to care. Use " -"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." -"set_start_method` APIs to explicitly specify when your code *requires* " -"``'fork'``. See :ref:`multiprocessing-start-methods`." +"the :func:`~multiprocessing.get_context` " +"or :func:`~multiprocessing.set_start_method` APIs to explicitly specify when " +"your code *requires* ``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" -":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." -"PurePath.relative_to`: passing additional arguments is deprecated." +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` " +"and :meth:`~pathlib.PurePath.relative_to`: passing additional arguments is " +"deprecated." msgstr "" msgid "" @@ -155,13 +158,13 @@ msgid ":data:`!version` and :data:`!version_info`." msgstr "" msgid "" -":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" -"ref:`named placeholders ` are used and *parameters* is " -"a sequence instead of a :class:`dict`." +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` " +"if :ref:`named placeholders ` are used and " +"*parameters* is a sequence instead of a :class:`dict`." msgstr "" msgid "" ":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " -"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" -"`88168`.)" +"intended to be a public API. (Contributed by Gregory P. Smith " +"in :gh:`88168`.)" msgstr "" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index 800e2bf788..357ecd9f33 100644 --- a/deprecations/pending-removal-in-3.15.po +++ b/deprecations/pending-removal-in-3.15.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,23 +25,24 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Pending removal in Python 3.15" -msgstr "" +msgstr "Oczekujące na usunięcie w Python 3.15" msgid "The import system:" msgstr "" msgid "" -"Setting :attr:`~module.__cached__` on a module while failing to set :attr:" -"`__spec__.cached ` is deprecated. In " -"Python 3.15, :attr:`!__cached__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__cached__` on a module while failing to " +"set :attr:`__spec__.cached ` is " +"deprecated. In Python 3.15, :attr:`!__cached__` will cease to be set or take " +"into consideration by the import system or standard library. (:gh:`97879`)" msgstr "" msgid "" -"Setting :attr:`~module.__package__` on a module while failing to set :attr:" -"`__spec__.parent ` is deprecated. In " -"Python 3.15, :attr:`!__package__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__package__` on a module while failing to " +"set :attr:`__spec__.parent ` is " +"deprecated. In Python 3.15, :attr:`!__package__` will cease to be set or " +"take into consideration by the import system or standard library. " +"(:gh:`97879`)" msgstr "" msgid ":mod:`ctypes`:" @@ -71,23 +73,12 @@ msgstr ":mod:`importlib`:" msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" -msgid ":class:`locale`:" -msgstr ":class:`locale`:" - -msgid "" -"The :func:`~locale.getdefaultlocale` function has been deprecated since " -"Python 3.11. Its removal was originally planned for Python 3.13 (:gh:" -"`90817`), but has been postponed to Python 3.15. Use :func:`~locale." -"getlocale`, :func:`~locale.setlocale`, and :func:`~locale.getencoding` " -"instead. (Contributed by Hugo van Kemenade in :gh:`111187`.)" -msgstr "" - msgid ":mod:`pathlib`:" msgstr ":mod:`pathlib`:" msgid "" -":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. Use :" -"func:`os.path.isreserved` to detect reserved paths on Windows." +":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. " +"Use :func:`os.path.isreserved` to detect reserved paths on Windows." msgstr "" msgid ":mod:`platform`:" @@ -131,10 +122,10 @@ msgid ":mod:`typing`:" msgstr ":mod:`typing`:" msgid "" -"The undocumented keyword argument syntax for creating :class:`~typing." -"NamedTuple` classes (for example, ``Point = NamedTuple(\"Point\", x=int, " -"y=int)``) has been deprecated since Python 3.13. Use the class-based syntax " -"or the functional syntax instead." +"The undocumented keyword argument syntax for " +"creating :class:`~typing.NamedTuple` classes (for example, ``Point = " +"NamedTuple(\"Point\", x=int, y=int)``) has been deprecated since Python " +"3.13. Use the class-based syntax or the functional syntax instead." msgstr "" msgid "" @@ -146,7 +137,7 @@ msgid "" msgstr "" msgid "" -"The :func:`typing.no_type_check_decorator` decorator function has been " +"The :deco:`typing.no_type_check_decorator` decorator function has been " "deprecated since Python 3.13. After eight years in the :mod:`typing` module, " "it has yet to be supported by any major type checker." msgstr "" @@ -155,9 +146,10 @@ msgid ":mod:`wave`:" msgstr ":mod:`wave`:" msgid "" -"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, and :meth:`~wave." -"Wave_read.getmarkers` methods of the :class:`~wave.Wave_read` and :class:" -"`~wave.Wave_write` classes have been deprecated since Python 3.13." +"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, " +"and :meth:`~wave.Wave_read.getmarkers` methods of " +"the :class:`~wave.Wave_read` and :class:`~wave.Wave_write` classes have been " +"deprecated since Python 3.13." msgstr "" msgid ":mod:`zipimport`:" diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index cfabbb6229..f4ab9dbe78 100644 --- a/deprecations/pending-removal-in-3.16.po +++ b/deprecations/pending-removal-in-3.16.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,10 +30,10 @@ msgid "The import system:" msgstr "" msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader ` is deprecated. In " -"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." +"Setting :attr:`~module.__loader__` on a module while failing to " +"set :attr:`__spec__.loader ` is " +"deprecated. In Python 3.16, :attr:`!__loader__` will cease to be set or " +"taken into consideration by the import system or the standard library." msgstr "" msgid ":mod:`array`:" @@ -130,10 +130,10 @@ msgid ":mod:`mimetypes`:" msgstr ":mod:`mimetypes`:" msgid "" -"Valid extensions start with a '.' or are empty for :meth:`mimetypes." -"MimeTypes.add_type`. Undotted extensions are deprecated and will raise a :" -"exc:`ValueError` in Python 3.16. (Contributed by Hugo van Kemenade in :gh:" -"`75223`.)" +"Valid extensions start with a '.' or are empty " +"for :meth:`mimetypes.MimeTypes.add_type`. Undotted extensions are deprecated " +"and will raise a :exc:`ValueError` in Python 3.16. (Contributed by Hugo van " +"Kemenade in :gh:`75223`.)" msgstr "" msgid ":mod:`shutil`:" diff --git a/deprecations/pending-removal-in-3.17.po b/deprecations/pending-removal-in-3.17.po index bcdf7a65cf..97c6d8fada 100644 --- a/deprecations/pending-removal-in-3.17.po +++ b/deprecations/pending-removal-in-3.17.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/pending-removal-in-3.18.po b/deprecations/pending-removal-in-3.18.po index 57147a6af0..f8d41aff53 100644 --- a/deprecations/pending-removal-in-3.18.po +++ b/deprecations/pending-removal-in-3.18.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2026-01-07 14:20+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/pending-removal-in-3.19.po b/deprecations/pending-removal-in-3.19.po index 371ffd63a1..9f69cbbb28 100644 --- a/deprecations/pending-removal-in-3.19.po +++ b/deprecations/pending-removal-in-3.19.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,7 +30,7 @@ msgid ":mod:`ctypes`:" msgstr ":mod:`ctypes`:" msgid "" -"Implicitly switching to the MSVC-compatible struct layout by setting :attr:" -"`~ctypes.Structure._pack_` but not :attr:`~ctypes.Structure._layout_` on non-" -"Windows platforms." +"Implicitly switching to the MSVC-compatible struct layout by " +"setting :attr:`~ctypes.Structure._pack_` but " +"not :attr:`~ctypes.Structure._layout_` on non-Windows platforms." msgstr "" diff --git a/deprecations/pending-removal-in-future.po b/deprecations/pending-removal-in-future.po index b85df46b58..6bfcd759ab 100644 --- a/deprecations/pending-removal-in-future.po +++ b/deprecations/pending-removal-in-future.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,8 +39,8 @@ msgid "" msgstr "" msgid "" -"Passing the undocumented keyword argument *prefix_chars* to :meth:`~argparse." -"ArgumentParser.add_argument_group` is now deprecated." +"Passing the undocumented keyword argument *prefix_chars* " +"to :meth:`~argparse.ArgumentParser.add_argument_group` is now deprecated." msgstr "" msgid "The :class:`argparse.FileType` type converter is deprecated." @@ -60,10 +60,10 @@ msgid "" "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " "ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " "``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " -"if the numeric literal is immediately followed by one of keywords :keyword:" -"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" -"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " -"syntax error. (:gh:`87999`)" +"if the numeric literal is immediately followed by one of " +"keywords :keyword:`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :keyword:`is` " +"and :keyword:`or`. In a future release it will be changed to a syntax " +"error. (:gh:`87999`)" msgstr "" msgid "" @@ -73,33 +73,34 @@ msgid "" msgstr "" msgid "" -"Support for ``__float__()`` method returning a strict subclass of :class:" -"`float`: these methods will be required to return an instance of :class:" -"`float`." +"Support for ``__float__()`` method returning a strict subclass " +"of :class:`float`: these methods will be required to return an instance " +"of :class:`float`." msgstr "" msgid "" -"Support for ``__complex__()`` method returning a strict subclass of :class:" -"`complex`: these methods will be required to return an instance of :class:" -"`complex`." +"Support for ``__complex__()`` method returning a strict subclass " +"of :class:`complex`: these methods will be required to return an instance " +"of :class:`complex`." msgstr "" msgid "" -"Passing a complex number as the *real* or *imag* argument in the :func:" -"`complex` constructor is now deprecated; it should only be passed as a " -"single positional argument. (Contributed by Serhiy Storchaka in :gh:" -"`109218`.)" +"Passing a complex number as the *real* or *imag* argument in " +"the :func:`complex` constructor is now deprecated; it should only be passed " +"as a single positional argument. (Contributed by Serhiy Storchaka " +"in :gh:`109218`.)" msgstr "" msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " -"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." -"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +"are deprecated and replaced by :data:`calendar.JANUARY` " +"and :data:`calendar.FEBRUARY`. (Contributed by Prince Roshan " +"in :gh:`103636`.)" msgstr "" msgid "" -":mod:`codecs`: use :func:`open` instead of :func:`codecs.open`. (:gh:" -"`133038`)" +":mod:`codecs`: use :func:`open` instead of :func:`codecs.open`. " +"(:gh:`133038`)" msgstr "" msgid "" @@ -111,13 +112,13 @@ msgid ":mod:`datetime`:" msgstr ":mod:`datetime`:" msgid "" -":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." -"UTC)``." +":meth:`~datetime.datetime.utcnow`: use " +"``datetime.datetime.now(tz=datetime.UTC)``." msgstr "" msgid "" -":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." -"fromtimestamp(timestamp, tz=datetime.UTC)``." +":meth:`~datetime.datetime.utcfromtimestamp`: use " +"``datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" msgid ":mod:`gettext`: Plural value must be an integer." @@ -183,8 +184,8 @@ msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." msgstr "" msgid "" -":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" -"`!selected_npn_protocol` are deprecated: use ALPN instead." +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` " +"and :meth:`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" msgid "``ssl.OP_NO_SSL*`` options" @@ -221,21 +222,21 @@ msgid ":mod:`threading` methods:" msgstr "" msgid "" -":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." -"notify_all`." +":meth:`!threading.Condition.notifyAll`: " +"use :meth:`~threading.Condition.notify_all`." msgstr "" msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." msgstr "" msgid "" -":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" -"attr:`threading.Thread.daemon` attribute." +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: " +"use :attr:`threading.Thread.daemon` attribute." msgstr "" msgid "" -":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" -"attr:`threading.Thread.name` attribute." +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: " +"use :attr:`threading.Thread.name` attribute." msgstr "" msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." @@ -303,13 +304,13 @@ msgid "" msgstr "" msgid "" -":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." -"etree.ElementTree.Element` is deprecated. In a future release it will always " -"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " -"instead." +":mod:`xml.etree.ElementTree`: Testing the truth value of " +"an :class:`~xml.etree.ElementTree.Element` is deprecated. In a future " +"release it will always return ``True``. Prefer explicit ``len(elem)`` or " +"``elem is not None`` tests instead." msgstr "" msgid "" -":func:`sys._clear_type_cache` is deprecated: use :func:`sys." -"_clear_internal_caches` instead." +":func:`sys._clear_type_cache` is deprecated: " +"use :func:`sys._clear_internal_caches` instead." msgstr "" diff --git a/distributing/index.po b/distributing/index.po index 666abee7aa..e558e135cb 100644 --- a/distributing/index.po +++ b/distributing/index.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/building.po b/extending/building.po index 648d937094..a4417178fd 100644 --- a/extending/building.po +++ b/extending/building.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001 Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,130 +27,29 @@ msgid "Building C and C++ Extensions" msgstr "" msgid "" -"A C extension for CPython is a shared library (e.g. a ``.so`` file on Linux, " -"``.pyd`` on Windows), which exports an *initialization function*." +"A C extension for CPython is a shared library (for example, a ``.so`` file " +"on Linux, ``.pyd`` on Windows), which exports an *initialization function*." msgstr "" -msgid "" -"To be importable, the shared library must be available on :envvar:" -"`PYTHONPATH`, and must be named after the module name, with an appropriate " -"extension. When using distutils, the correct filename is generated " -"automatically." -msgstr "" - -msgid "The initialization function has the signature:" -msgstr "" - -msgid "" -"It returns either a fully initialized module, or a :c:type:`PyModuleDef` " -"instance. See :ref:`initializing-modules` for details." -msgstr "" - -msgid "" -"For modules with ASCII-only names, the function must be named " -"``PyInit_``, with ```` replaced by the name of the " -"module. When using :ref:`multi-phase-initialization`, non-ASCII module names " -"are allowed. In this case, the initialization function name is " -"``PyInitU_``, with ```` encoded using Python's " -"*punycode* encoding with hyphens replaced by underscores. In Python::" -msgstr "" - -msgid "" -"It is possible to export multiple modules from a single shared library by " -"defining multiple initialization functions. However, importing them requires " -"using symbolic links or a custom importer, because by default only the " -"function corresponding to the filename is found. See the *\"Multiple modules " -"in one library\"* section in :pep:`489` for details." -msgstr "" - -msgid "Building C and C++ Extensions with distutils" -msgstr "" - -msgid "" -"Extension modules can be built using distutils, which is included in " -"Python. Since distutils also supports creation of binary packages, users " -"don't necessarily need a compiler and distutils to install the extension." -msgstr "" - -msgid "" -"A distutils package contains a driver script, :file:`setup.py`. This is a " -"plain Python file, which, in the most simple case, could look like this:" -msgstr "" - -msgid "With this :file:`setup.py`, and a file :file:`demo.c`, running ::" -msgstr "" - -msgid "" -"will compile :file:`demo.c`, and produce an extension module named ``demo`` " -"in the :file:`build` directory. Depending on the system, the module file " -"will end up in a subdirectory :file:`build/lib.system`, and may have a name " -"like :file:`demo.so` or :file:`demo.pyd`." +msgid "See :ref:`extension-modules` for details." msgstr "" -msgid "" -"In the :file:`setup.py`, all execution is performed by calling the ``setup`` " -"function. This takes a variable number of keyword arguments, of which the " -"example above uses only a subset. Specifically, the example specifies meta-" -"information to build packages, and it specifies the contents of the " -"package. Normally, a package will contain additional modules, like Python " -"source modules, documentation, subpackages, etc. Please refer to the " -"distutils documentation in :ref:`distutils-index` to learn more about the " -"features of distutils; this section explains building extension modules only." -msgstr "" - -msgid "" -"It is common to pre-compute arguments to :func:`setup`, to better structure " -"the driver script. In the example above, the ``ext_modules`` argument to :" -"func:`~distutils.core.setup` is a list of extension modules, each of which " -"is an instance of the :class:`~distutils.extension.Extension`. In the " -"example, the instance defines an extension named ``demo`` which is build by " -"compiling a single source file, :file:`demo.c`." -msgstr "" - -msgid "" -"In many cases, building an extension is more complex, since additional " -"preprocessor defines and libraries may be needed. This is demonstrated in " -"the example below." -msgstr "" - -msgid "" -"In this example, :func:`~distutils.core.setup` is called with additional " -"meta-information, which is recommended when distribution packages have to be " -"built. For the extension itself, it specifies preprocessor defines, include " -"directories, library directories, and libraries. Depending on the compiler, " -"distutils passes this information in different ways to the compiler. For " -"example, on Unix, this may result in the compilation commands ::" -msgstr "" - -msgid "" -"These lines are for demonstration purposes only; distutils users should " -"trust that distutils gets the invocations right." -msgstr "" - -msgid "Distributing your extension modules" -msgstr "" - -msgid "" -"When an extension has been successfully built, there are three ways to use " -"it." -msgstr "" - -msgid "" -"End-users will typically want to install the module, they do so by running ::" -msgstr "" - -msgid "" -"Module maintainers should produce source packages; to do so, they run ::" +msgid "Building C and C++ Extensions with setuptools" msgstr "" msgid "" -"In some cases, additional files need to be included in a source " -"distribution; this is done through a :file:`MANIFEST.in` file; see :ref:" -"`manifest` for details." +"Building, packaging and distributing extension modules is best done with " +"third-party tools, and is out of scope of this document. One suitable tool " +"is Setuptools, whose documentation can be found at https://" +"setuptools.pypa.io/en/latest/setuptools.html." msgstr "" +"Kompilację, pakowanie i dystrybucję modułów rozszerzeń zewnętrzny wykonywać " +"za pomocą narzędzi firm trzecich, co wykracza poza zakres niniejszego " +"dokumentu. Jednym z odpowiednich narzędzi jest Setuptools, którego " +"dokumentację można znaleźć pod adresem https://setuptools.pypa.io/en/latest/" +"setuptools.html." msgid "" -"If the source distribution has been built successfully, maintainers can also " -"create binary distributions. Depending on the platform, one of the following " -"commands can be used to do so. ::" +"The :mod:`distutils` module, which was included in the standard library " +"until Python 3.12, is now maintained as part of Setuptools." msgstr "" diff --git a/extending/embedding.po b/extending/embedding.po index 89efaa9165..752b5efd85 100644 --- a/extending/embedding.po +++ b/extending/embedding.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -49,10 +49,10 @@ msgstr "" msgid "" "So if you are embedding Python, you are providing your own main program. " "One of the things this main program has to do is initialize the Python " -"interpreter. At the very least, you have to call the function :c:func:" -"`Py_Initialize`. There are optional calls to pass command line arguments to " -"Python. Then later you can call the interpreter from any part of the " -"application." +"interpreter. At the very least, you have to call the " +"function :c:func:`Py_Initialize`. There are optional calls to pass command " +"line arguments to Python. Then later you can call the interpreter from any " +"part of the application." msgstr "" msgid "" @@ -127,17 +127,17 @@ msgid "" msgstr "" msgid "" -"Setting :c:member:`PyConfig.program_name` should be called before :c:func:" -"`Py_InitializeFromConfig` to inform the interpreter about paths to Python " -"run-time libraries. Next, the Python interpreter is initialized with :c:" -"func:`Py_Initialize`, followed by the execution of a hard-coded Python " -"script that prints the date and time. Afterwards, the :c:func:" -"`Py_FinalizeEx` call shuts the interpreter down, followed by the end of the " -"program. In a real program, you may want to get the Python script from " -"another source, perhaps a text-editor routine, a file, or a database. " -"Getting the Python code from a file can better be done by using the :c:func:" -"`PyRun_SimpleFile` function, which saves you the trouble of allocating " -"memory space and loading the file contents." +"Setting :c:member:`PyConfig.program_name` should be called " +"before :c:func:`Py_InitializeFromConfig` to inform the interpreter about " +"paths to Python run-time libraries. Next, the Python interpreter is " +"initialized with :c:func:`Py_Initialize`, followed by the execution of a " +"hard-coded Python script that prints the date and time. Afterwards, " +"the :c:func:`Py_FinalizeEx` call shuts the interpreter down, followed by the " +"end of the program. In a real program, you may want to get the Python " +"script from another source, perhaps a text-editor routine, a file, or a " +"database. Getting the Python code from a file can better be done by using " +"the :c:func:`PyRun_SimpleFile` function, which saves you the trouble of " +"allocating memory space and loading the file contents." msgstr "" msgid "Beyond Very High Level Embedding: An overview" @@ -323,10 +323,10 @@ msgid "" msgstr "" msgid "" -"After initializing the interpreter, the script is loaded using :c:func:" -"`PyImport_Import`. This routine needs a Python string as its argument, " -"which is constructed using the :c:func:`PyUnicode_DecodeFSDefault` data " -"conversion routine. ::" +"After initializing the interpreter, the script is loaded " +"using :c:func:`PyImport_Import`. This routine needs a Python string as its " +"argument, which is constructed using the :c:func:`PyUnicode_DecodeFSDefault` " +"data conversion routine. ::" msgstr "" msgid "" @@ -340,11 +340,11 @@ msgid "" msgstr "" msgid "" -"Once the script is loaded, the name we're looking for is retrieved using :c:" -"func:`PyObject_GetAttrString`. If the name exists, and the object returned " -"is callable, you can safely assume that it is a function. The program then " -"proceeds by constructing a tuple of arguments as normal. The call to the " -"Python function is then made with::" +"Once the script is loaded, the name we're looking for is retrieved " +"using :c:func:`PyObject_GetAttrString`. If the name exists, and the object " +"returned is callable, you can safely assume that it is a function. The " +"program then proceeds by constructing a tuple of arguments as normal. The " +"call to the Python function is then made with::" msgstr "" msgid "pValue = PyObject_CallObject(pFunc, pArgs);" @@ -450,8 +450,8 @@ msgid "" msgstr "" msgid "" -"To find out the required compiler and linker flags, you can execute the :" -"file:`python{X.Y}-config` script which is generated as part of the " +"To find out the required compiler and linker flags, you can execute " +"the :file:`python{X.Y}-config` script which is generated as part of the " "installation process (a :file:`python3-config` script may also be " "available). This script has several options, of which the following will be " "directly useful to you:" @@ -478,12 +478,12 @@ msgstr "" msgid "" "$ /opt/bin/python3.11-config --ldflags --embed\n" -"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 -" -"lpthread -ldl -lutil -lm" +"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 " +"-lpthread -ldl -lutil -lm" msgstr "" "$ /opt/bin/python3.11-config --ldflags --embed\n" -"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 -" -"lpthread -ldl -lutil -lm" +"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 " +"-lpthread -ldl -lutil -lm" msgid "" "To avoid confusion between several Python installations (and especially " @@ -496,11 +496,11 @@ msgid "" "If this procedure doesn't work for you (it is not guaranteed to work for all " "Unix-like platforms; however, we welcome :ref:`bug reports `) you will have to read your system's documentation about dynamic " -"linking and/or examine Python's :file:`Makefile` (use :func:`sysconfig." -"get_makefile_filename` to find its location) and compilation options. In " -"this case, the :mod:`sysconfig` module is a useful tool to programmatically " -"extract the configuration values that you will want to combine together. " -"For example:" +"linking and/or examine Python's :file:`Makefile` " +"(use :func:`sysconfig.get_makefile_filename` to find its location) and " +"compilation options. In this case, the :mod:`sysconfig` module is a useful " +"tool to programmatically extract the configuration values that you will want " +"to combine together. For example:" msgstr "" msgid "" diff --git a/extending/extending.po b/extending/extending.po index cc13219684..21c99b85d2 100644 --- a/extending/extending.po +++ b/extending/extending.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -47,8 +47,8 @@ msgstr "" "Aby wspierać rozszerzenia, API Pythona (Application Programmers Interface) " "określa zbiór funkcji, makropoleceń i zmiennych, które dostarczają dostęp do " "większości aspektów systemu czasu-wykonania Pythona. API Pythona jest " -"załączane w źródłowym pliku C przez załączenie pliku nagłówkowego ``\"Python." -"h\"``." +"załączane w źródłowym pliku C przez załączenie pliku nagłówkowego " +"``\"Python.h\"``." msgid "" "The compilation of an extension module depends on its intended use as well " @@ -90,9 +90,9 @@ msgstr "" msgid "" "Begin by creating a file :file:`spammodule.c`. (Historically, if a module " -"is called ``spam``, the C file containing its implementation is called :file:" -"`spammodule.c`; if the module name is very long, like ``spammify``, the " -"module name can be just :file:`spammify.c`.)" +"is called ``spam``, the C file containing its implementation is " +"called :file:`spammodule.c`; if the module name is very long, like " +"``spammify``, the module name can be just :file:`spammify.c`.)" msgstr "" "Zaczynając od stworzenia pliku :file:`spammodule.c` (Historycznie, jeśli " "moduł był nazwany ``spam``, plik C zawierający jego wypełnienie jest " @@ -122,8 +122,8 @@ msgid "" "any standard headers are included." msgstr "" "Jako że Python może definiować pewne definicje preprocesora, które wpływają " -"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć plik :file:" -"`Python.h` przed jakimikolwiek standardowymi nagłówkami." +"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć " +"plik :file:`Python.h` przed jakimikolwiek standardowymi nagłówkami." msgid "" "``#define PY_SSIZE_T_CLEAN`` was used to indicate that ``Py_ssize_t`` should " @@ -289,18 +289,18 @@ msgstr "" msgid "" "Another useful function is :c:func:`PyErr_SetFromErrno`, which only takes an " "exception argument and constructs the associated value by inspection of the " -"global variable :c:data:`errno`. The most general function is :c:func:" -"`PyErr_SetObject`, which takes two object arguments, the exception and its " -"associated value. You don't need to :c:func:`Py_INCREF` the objects passed " -"to any of these functions." +"global variable :c:data:`errno`. The most general function " +"is :c:func:`PyErr_SetObject`, which takes two object arguments, the " +"exception and its associated value. You don't need to :c:func:`Py_INCREF` " +"the objects passed to any of these functions." msgstr "" msgid "" -"You can test non-destructively whether an exception has been set with :c:" -"func:`PyErr_Occurred`. This returns the current exception object, or " -"``NULL`` if no exception has occurred. You normally don't need to call :c:" -"func:`PyErr_Occurred` to see whether an error occurred in a function call, " -"since you should be able to tell from the return value." +"You can test non-destructively whether an exception has been set " +"with :c:func:`PyErr_Occurred`. This returns the current exception object, " +"or ``NULL`` if no exception has occurred. You normally don't need to " +"call :c:func:`PyErr_Occurred` to see whether an error occurred in a function " +"call, since you should be able to tell from the return value." msgstr "" msgid "" @@ -333,10 +333,11 @@ msgstr "" msgid "" "Every failing :c:func:`malloc` call must be turned into an exception --- the " -"direct caller of :c:func:`malloc` (or :c:func:`realloc`) must call :c:func:" -"`PyErr_NoMemory` and return a failure indicator itself. All the object-" -"creating functions (for example, :c:func:`PyLong_FromLong`) already do this, " -"so this note is only relevant to those who call :c:func:`malloc` directly." +"direct caller of :c:func:`malloc` (or :c:func:`realloc`) must " +"call :c:func:`PyErr_NoMemory` and return a failure indicator itself. All " +"the object-creating functions (for example, :c:func:`PyLong_FromLong`) " +"already do this, so this note is only relevant to those who " +"call :c:func:`malloc` directly." msgstr "" msgid "" @@ -347,8 +348,8 @@ msgid "" msgstr "" msgid "" -"Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` or :" -"c:func:`Py_DECREF` calls for objects you have already created) when you " +"Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` " +"or :c:func:`Py_DECREF` calls for objects you have already created) when you " "return an error indicator!" msgstr "" @@ -357,11 +358,12 @@ msgid "" "predeclared C objects corresponding to all built-in Python exceptions, such " "as :c:data:`PyExc_ZeroDivisionError`, which you can use directly. Of course, " "you should choose exceptions wisely --- don't use :c:data:`PyExc_TypeError` " -"to mean that a file couldn't be opened (that should probably be :c:data:" -"`PyExc_OSError`). If something's wrong with the argument list, the :c:func:" -"`PyArg_ParseTuple` function usually raises :c:data:`PyExc_TypeError`. If " -"you have an argument whose value must be in a particular range or must " -"satisfy other conditions, :c:data:`PyExc_ValueError` is appropriate." +"to mean that a file couldn't be opened (that should probably " +"be :c:data:`PyExc_OSError`). If something's wrong with the argument list, " +"the :c:func:`PyArg_ParseTuple` function usually " +"raises :c:data:`PyExc_TypeError`. If you have an argument whose value must " +"be in a particular range or must satisfy other " +"conditions, :c:data:`PyExc_ValueError` is appropriate." msgstr "" msgid "" @@ -374,8 +376,8 @@ msgid "static PyObject *SpamError = NULL;" msgstr "" msgid "" -"and initialize it by calling :c:func:`PyErr_NewException` in the module's :c:" -"data:`Py_mod_exec` function (:c:func:`!spam_module_exec`)::" +"and initialize it by calling :c:func:`PyErr_NewException` in the " +"module's :c:data:`Py_mod_exec` function (:c:func:`!spam_module_exec`)::" msgstr "" msgid "SpamError = PyErr_NewException(\"spam.error\", NULL, NULL);" @@ -517,8 +519,8 @@ msgstr "" msgid "" "Our :func:`!spam.system` function must return the value of :c:data:`!sts` as " -"a Python object. This is done using the function :c:func:" -"`PyLong_FromLong`. ::" +"a Python object. This is done using the " +"function :c:func:`PyLong_FromLong`. ::" msgstr "" msgid "return PyLong_FromLong(sts);" @@ -534,8 +536,8 @@ msgstr "" msgid "" "If you have a C function that returns no useful argument (a function " "returning :c:expr:`void`), the corresponding Python function must return " -"``None``. You need this idiom to do so (which is implemented by the :c:" -"macro:`Py_RETURN_NONE` macro)::" +"``None``. You need this idiom to do so (which is implemented by " +"the :c:macro:`Py_RETURN_NONE` macro)::" msgstr "" msgid "" @@ -577,8 +579,9 @@ msgstr "" msgid "" "When using only ``METH_VARARGS``, the function should expect the Python-" -"level parameters to be passed in as a tuple acceptable for parsing via :c:" -"func:`PyArg_ParseTuple`; more information on this function is provided below." +"level parameters to be passed in as a tuple acceptable for parsing " +"via :c:func:`PyArg_ParseTuple`; more information on this function is " +"provided below." msgstr "" msgid "" @@ -605,9 +608,9 @@ msgstr "" msgid "" "This structure, in turn, must be passed to the interpreter in the module's " -"initialization function. The initialization function must be named :c:func:" -"`!PyInit_name`, where *name* is the name of the module, and should be the " -"only non-\\ ``static`` item defined in the module file::" +"initialization function. The initialization function must be " +"named :c:func:`!PyInit_name`, where *name* is the name of the module, and " +"should be the only non-\\ ``static`` item defined in the module file::" msgstr "" msgid "" @@ -625,18 +628,19 @@ msgid "" msgstr "" msgid "" -":c:func:`!PyInit_spam` is called when each interpreter imports its module :" -"mod:`!spam` for the first time. (See below for comments about embedding " -"Python.) A pointer to the module definition must be returned via :c:func:" -"`PyModuleDef_Init`, so that the import machinery can create the module and " -"store it in ``sys.modules``." +":c:func:`!PyInit_spam` is called when each interpreter imports its " +"module :mod:`!spam` for the first time. (See below for comments about " +"embedding Python.) A pointer to the module definition must be returned " +"via :c:func:`PyModuleDef_Init`, so that the import machinery can create the " +"module and store it in ``sys.modules``." msgstr "" msgid "" "When embedding Python, the :c:func:`!PyInit_spam` function is not called " "automatically unless there's an entry in the :c:data:`PyImport_Inittab` " -"table. To add the module to the initialization table, use :c:func:" -"`PyImport_AppendInittab`, optionally followed by an import of the module::" +"table. To add the module to the initialization table, " +"use :c:func:`PyImport_AppendInittab`, optionally followed by an import of " +"the module::" msgstr "" msgid "" @@ -696,10 +700,10 @@ msgid "" "experience unintended side-effects on re-initialisation, for example when " "removing entries from ``sys.modules`` or importing compiled modules into " "multiple interpreters within a process (or following a :c:func:`fork` " -"without an intervening :c:func:`exec`). If module state is not yet fully :" -"ref:`isolated `, authors should consider marking " -"the module as having no support for subinterpreters (via :c:macro:" -"`Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED`)." +"without an intervening :c:func:`exec`). If module state is not yet " +"fully :ref:`isolated `, authors should consider " +"marking the module as having no support for subinterpreters " +"(via :c:macro:`Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED`)." msgstr "" msgid "" @@ -715,9 +719,10 @@ msgid "" "There are two more things to do before you can use your new extension: " "compiling and linking it with the Python system. If you use dynamic " "loading, the details may depend on the style of dynamic loading your system " -"uses; see the chapters about building extension modules (chapter :ref:" -"`building`) and additional information that pertains only to building on " -"Windows (chapter :ref:`building-on-windows`) for more information about this." +"uses; see the chapters about building extension modules " +"(chapter :ref:`building`) and additional information that pertains only to " +"building on Windows (chapter :ref:`building-on-windows`) for more " +"information about this." msgstr "" "Są jeszcze dwie rzeczy które trzeba zrobić zanim będzie można użyć nowego " "rozszerzenia: skompilowanie go i podłączenie z systemem Pythona. Jeśli " @@ -746,12 +751,12 @@ msgid "" "running ':program:`make` Makefile'. (This is necessary each time you change " "the :file:`Setup` file.)" msgstr "" -"i przebuduj program interpretujący przez uruchomienie programu :program:" -"`make` w katalogu głównym instalacji. Możesz także uruchomić program :" -"program:`make` w podkatalogu :file:`Modules/`, ale wtedy musisz najpierw " -"przebudować plik :file:`Makefile` tam przez uruchomienie programu :program:" -"`make` Makefile'. To jest konieczne za każdym razem gdy zmieniasz plik :file:" -"`Setup`.)" +"i przebuduj program interpretujący przez uruchomienie " +"programu :program:`make` w katalogu głównym instalacji. Możesz także " +"uruchomić program :program:`make` w podkatalogu :file:`Modules/`, ale wtedy " +"musisz najpierw przebudować plik :file:`Makefile` tam przez uruchomienie " +"programu :program:`make` Makefile'. To jest konieczne za każdym razem gdy " +"zmieniasz plik :file:`Setup`.)" msgid "" "If your module requires additional libraries to link with, these can be " @@ -785,18 +790,10 @@ msgstr "" msgid "" "Fortunately, the Python interpreter is easily called recursively, and there " -"is a standard interface to call a Python function. (I won't dwell on how to " -"call the Python parser with a particular string as input --- if you're " -"interested, have a look at the implementation of the :option:`-c` command " -"line option in :file:`Modules/main.c` from the Python source code.)" +"is a standard interface to call a Python function. (If you're interested in " +"how to call the Python parser with a particular string as input, " +"see :ref:`veryhigh`.)" msgstr "" -"Szczęśliwie, program interpretujący polecenia języka pytonowskiego jest " -"łatwo wywoływany rekursywnie i istnieje standardowy sprzęg aby wywołać " -"zadanie języka pytonowskiego. (Nie będę rozpisywał się o tym jak wywołać " -"czytnik języka pytonowskiego z konkretnym ciągiem znaków na wejściu --- " -"jeśli jesteś zainteresowany, spójrz na wypełnienie opcji :option:`-c` " -"wiersza polecenia w :file:`Modules/main.c` z kodu źródłowego języka " -"pytonowskiego.)" msgid "" "Calling a Python function is easy. First, the Python program must somehow " @@ -834,10 +831,10 @@ msgid "" msgstr "" msgid "" -"This function must be registered with the interpreter using the :c:macro:" -"`METH_VARARGS` flag; this is described in section :ref:`methodtable`. The :" -"c:func:`PyArg_ParseTuple` function and its arguments are documented in " -"section :ref:`parsetuple`." +"This function must be registered with the interpreter using " +"the :c:macro:`METH_VARARGS` flag; this is described in " +"section :ref:`methodtable`. The :c:func:`PyArg_ParseTuple` function and its " +"arguments are documented in section :ref:`parsetuple`." msgstr "" msgid "" @@ -848,14 +845,15 @@ msgid "" msgstr "" msgid "" -"Later, when it is time to call the function, you call the C function :c:func:" -"`PyObject_CallObject`. This function has two arguments, both pointers to " -"arbitrary Python objects: the Python function, and the argument list. The " -"argument list must always be a tuple object, whose length is the number of " -"arguments. To call the Python function with no arguments, pass in ``NULL``, " -"or an empty tuple; to call it with one argument, pass a singleton tuple. :c:" -"func:`Py_BuildValue` returns a tuple when its format string consists of zero " -"or more format codes between parentheses. For example::" +"Later, when it is time to call the function, you call the C " +"function :c:func:`PyObject_CallObject`. This function has two arguments, " +"both pointers to arbitrary Python objects: the Python function, and the " +"argument list. The argument list must always be a tuple object, whose " +"length is the number of arguments. To call the Python function with no " +"arguments, pass in ``NULL``, or an empty tuple; to call it with one " +"argument, pass a singleton tuple. :c:func:`Py_BuildValue` returns a tuple " +"when its format string consists of zero or more format codes between " +"parentheses. For example::" msgstr "" msgid "" @@ -875,8 +873,9 @@ msgid "" ":c:func:`PyObject_CallObject` returns a Python object pointer: this is the " "return value of the Python function. :c:func:`PyObject_CallObject` is " "\"reference-count-neutral\" with respect to its arguments. In the example a " -"new tuple was created to serve as the argument list, which is :c:func:" -"`Py_DECREF`\\ -ed immediately after the :c:func:`PyObject_CallObject` call." +"new tuple was created to serve as the argument list, which " +"is :c:func:`Py_DECREF`\\ -ed immediately after " +"the :c:func:`PyObject_CallObject` call." msgstr "" msgid "" @@ -935,9 +934,10 @@ msgid "" msgstr "" msgid "" -"You may also call a function with keyword arguments by using :c:func:" -"`PyObject_Call`, which supports arguments and keyword arguments. As in the " -"above example, we use :c:func:`Py_BuildValue` to construct the dictionary. ::" +"You may also call a function with keyword arguments by " +"using :c:func:`PyObject_Call`, which supports arguments and keyword " +"arguments. As in the above example, we use :c:func:`Py_BuildValue` to " +"construct the dictionary. ::" msgstr "" msgid "" @@ -1068,20 +1068,20 @@ msgid "" msgstr "" msgid "" -"The *arg* and *format* parameters are identical to those of the :c:func:" -"`PyArg_ParseTuple` function. The *kwdict* parameter is the dictionary of " -"keywords received as the third parameter from the Python runtime. The " -"*kwlist* parameter is a ``NULL``-terminated list of strings which identify " -"the parameters; the names are matched with the type information from " -"*format* from left to right. On success, :c:func:" -"`PyArg_ParseTupleAndKeywords` returns true, otherwise it returns false and " -"raises an appropriate exception." +"The *arg* and *format* parameters are identical to those of " +"the :c:func:`PyArg_ParseTuple` function. The *kwdict* parameter is the " +"dictionary of keywords received as the third parameter from the Python " +"runtime. The *kwlist* parameter is a ``NULL``-terminated list of strings " +"which identify the parameters; the names are matched with the type " +"information from *format* from left to right. On " +"success, :c:func:`PyArg_ParseTupleAndKeywords` returns true, otherwise it " +"returns false and raises an appropriate exception." msgstr "" msgid "" "Nested tuples cannot be parsed when using keyword arguments! Keyword " -"parameters passed in which are not present in the *kwlist* will cause :exc:" -"`TypeError` to be raised." +"parameters passed in which are not present in the *kwlist* will " +"cause :exc:`TypeError` to be raised." msgstr "" "Zagnieżdźone krotki nie mogą być wczytane gdy używane są parametry słów " "kluczowych! Parametry słów kluczowych przekazane do zadania które nie są " @@ -1159,10 +1159,10 @@ msgid "PyObject *Py_BuildValue(const char *format, ...);" msgstr "" msgid "" -"It recognizes a set of format units similar to the ones recognized by :c:" -"func:`PyArg_ParseTuple`, but the arguments (which are input to the function, " -"not output) must not be pointers, just values. It returns a new Python " -"object, suitable for returning from a C function called from Python." +"It recognizes a set of format units similar to the ones recognized " +"by :c:func:`PyArg_ParseTuple`, but the arguments (which are input to the " +"function, not output) must not be pointers, just values. It returns a new " +"Python object, suitable for returning from a C function called from Python." msgstr "" msgid "" @@ -1213,16 +1213,16 @@ msgstr "" msgid "" "Every block of memory allocated with :c:func:`malloc` should eventually be " -"returned to the pool of available memory by exactly one call to :c:func:" -"`free`. It is important to call :c:func:`free` at the right time. If a " -"block's address is forgotten but :c:func:`free` is not called for it, the " -"memory it occupies cannot be reused until the program terminates. This is " -"called a :dfn:`memory leak`. On the other hand, if a program calls :c:func:" -"`free` for a block and then continues to use the block, it creates a " -"conflict with reuse of the block through another :c:func:`malloc` call. " -"This is called :dfn:`using freed memory`. It has the same bad consequences " -"as referencing uninitialized data --- core dumps, wrong results, mysterious " -"crashes." +"returned to the pool of available memory by exactly one call " +"to :c:func:`free`. It is important to call :c:func:`free` at the right " +"time. If a block's address is forgotten but :c:func:`free` is not called " +"for it, the memory it occupies cannot be reused until the program " +"terminates. This is called a :dfn:`memory leak`. On the other hand, if a " +"program calls :c:func:`free` for a block and then continues to use the " +"block, it creates a conflict with reuse of the block through " +"another :c:func:`malloc` call. This is called :dfn:`using freed memory`. It " +"has the same bad consequences as referencing uninitialized data --- core " +"dumps, wrong results, mysterious crashes." msgstr "" msgid "" @@ -1268,7 +1268,7 @@ msgstr "" msgid "" "An alternative strategy is called :dfn:`automatic garbage collection`. " "(Sometimes, reference counting is also referred to as a garbage collection " -"strategy, hence my use of \"automatic\" to distinguish the two.) The big " +"strategy, hence the use of \"automatic\" to distinguish the two.) The big " "advantage of automatic garbage collection is that the user doesn't need to " "call :c:func:`free` explicitly. (Another claimed advantage is an " "improvement in speed or memory usage --- this is no hard fact however.) The " @@ -1306,9 +1306,9 @@ msgstr "" msgid "" "The cycle detector is able to detect garbage cycles and can reclaim them. " -"The :mod:`gc` module exposes a way to run the detector (the :func:`~gc." -"collect` function), as well as configuration interfaces and the ability to " -"disable the detector at runtime." +"The :mod:`gc` module exposes a way to run the detector " +"(the :func:`~gc.collect` function), as well as configuration interfaces and " +"the ability to disable the detector at runtime." msgstr "" msgid "Reference Counting in Python" @@ -1316,12 +1316,12 @@ msgstr "Zliczanie odniesień w języku pytonowskim" msgid "" "There are two macros, ``Py_INCREF(x)`` and ``Py_DECREF(x)``, which handle " -"the incrementing and decrementing of the reference count. :c:func:" -"`Py_DECREF` also frees the object when the count reaches zero. For " -"flexibility, it doesn't call :c:func:`free` directly --- rather, it makes a " -"call through a function pointer in the object's :dfn:`type object`. For " -"this purpose (and others), every object also contains a pointer to its type " -"object." +"the incrementing and decrementing of the reference " +"count. :c:func:`Py_DECREF` also frees the object when the count reaches " +"zero. For flexibility, it doesn't call :c:func:`free` directly --- rather, " +"it makes a call through a function pointer in the object's :dfn:`type " +"object`. For this purpose (and others), every object also contains a " +"pointer to its type object." msgstr "" msgid "" @@ -1363,11 +1363,11 @@ msgstr "" "pozbył się go." msgid "" -"A borrowed reference can be changed into an owned reference by calling :c:" -"func:`Py_INCREF`. This does not affect the status of the owner from which " -"the reference was borrowed --- it creates a new owned reference, and gives " -"full owner responsibilities (the new owner must dispose of the reference " -"properly, as well as the previous owner)." +"A borrowed reference can be changed into an owned reference by " +"calling :c:func:`Py_INCREF`. This does not affect the status of the owner " +"from which the reference was borrowed --- it creates a new owned reference, " +"and gives full owner responsibilities (the new owner must dispose of the " +"reference properly, as well as the previous owner)." msgstr "" msgid "Ownership Rules" @@ -1387,19 +1387,19 @@ msgid "" "the reference. In particular, all functions whose function it is to create " "a new object, such as :c:func:`PyLong_FromLong` and :c:func:`Py_BuildValue`, " "pass ownership to the receiver. Even if the object is not actually new, you " -"still receive ownership of a new reference to that object. For instance, :c:" -"func:`PyLong_FromLong` maintains a cache of popular values and can return a " -"reference to a cached item." +"still receive ownership of a new reference to that object. For " +"instance, :c:func:`PyLong_FromLong` maintains a cache of popular values and " +"can return a reference to a cached item." msgstr "" msgid "" "Many functions that extract objects from other objects also transfer " -"ownership with the reference, for instance :c:func:" -"`PyObject_GetAttrString`. The picture is less clear, here, however, since a " -"few common routines are exceptions: :c:func:`PyTuple_GetItem`, :c:func:" -"`PyList_GetItem`, :c:func:`PyDict_GetItem`, and :c:func:" -"`PyDict_GetItemString` all return references that you borrow from the tuple, " -"list or dictionary." +"ownership with the reference, for " +"instance :c:func:`PyObject_GetAttrString`. The picture is less clear, here, " +"however, since a few common routines are " +"exceptions: :c:func:`PyTuple_GetItem`, :c:func:`PyList_GetItem`, :c:func:`PyDict_GetItem`, " +"and :c:func:`PyDict_GetItemString` all return references that you borrow " +"from the tuple, list or dictionary." msgstr "" msgid "" @@ -1412,10 +1412,11 @@ msgid "" "When you pass an object reference into another function, in general, the " "function borrows the reference from you --- if it needs to store it, it will " "use :c:func:`Py_INCREF` to become an independent owner. There are exactly " -"two important exceptions to this rule: :c:func:`PyTuple_SetItem` and :c:func:" -"`PyList_SetItem`. These functions take over ownership of the item passed to " -"them --- even if they fail! (Note that :c:func:`PyDict_SetItem` and friends " -"don't take over ownership --- they are \"normal.\")" +"two important exceptions to this rule: :c:func:`PyTuple_SetItem` " +"and :c:func:`PyList_SetItem`. These functions take over ownership of the " +"item passed to them --- even if they fail! (Note " +"that :c:func:`PyDict_SetItem` and friends don't take over ownership --- they " +"are \"normal.\")" msgstr "" msgid "" @@ -1484,12 +1485,12 @@ msgid "" "defined a :meth:`!__del__` method. If this class instance has a reference " "count of 1, disposing of it will call its :meth:`!__del__` method. " "Internally, :c:func:`PyList_SetItem` calls :c:func:`Py_DECREF` on the " -"replaced item, which invokes replaced item's corresponding :c:member:" -"`~PyTypeObject.tp_dealloc` function. During deallocation, :c:member:" -"`~PyTypeObject.tp_dealloc` calls :c:member:`~PyTypeObject.tp_finalize`, " -"which is mapped to the :meth:`!__del__` method for class instances (see :pep:" -"`442`). This entire sequence happens synchronously within the :c:func:" -"`PyList_SetItem` call." +"replaced item, which invokes replaced item's " +"corresponding :c:member:`~PyTypeObject.tp_dealloc` function. During " +"deallocation, :c:member:`~PyTypeObject.tp_dealloc` " +"calls :c:member:`~PyTypeObject.tp_finalize`, which is mapped to the :meth:`!" +"__del__` method for class instances (see :pep:`442`). This entire sequence " +"happens synchronously within the :c:func:`PyList_SetItem` call." msgstr "" msgid "" @@ -1533,11 +1534,12 @@ msgid "" "threads. Normally, multiple threads in the Python interpreter can't get in " "each other's way, because there is a :term:`global lock ` protecting Python's entire object space. However, it is possible to " -"temporarily release this lock using the macro :c:macro:" -"`Py_BEGIN_ALLOW_THREADS`, and to re-acquire it using :c:macro:" -"`Py_END_ALLOW_THREADS`. This is common around blocking I/O calls, to let " -"other threads use the processor while waiting for the I/O to complete. " -"Obviously, the following function has the same problem as the previous one::" +"temporarily release this lock using the " +"macro :c:macro:`Py_BEGIN_ALLOW_THREADS`, and to re-acquire it " +"using :c:macro:`Py_END_ALLOW_THREADS`. This is common around blocking I/O " +"calls, to let other threads use the processor while waiting for the I/O to " +"complete. Obviously, the following function has the same problem as the " +"previous one::" msgstr "" msgid "" @@ -1574,8 +1576,8 @@ msgstr "" msgid "" "The macros :c:func:`Py_INCREF` and :c:func:`Py_DECREF` do not check for " -"``NULL`` pointers --- however, their variants :c:func:`Py_XINCREF` and :c:" -"func:`Py_XDECREF` do." +"``NULL`` pointers --- however, their variants :c:func:`Py_XINCREF` " +"and :c:func:`Py_XDECREF` do." msgstr "" msgid "" @@ -1812,9 +1814,9 @@ msgstr "" msgid "" "The ``#define`` is used to tell the header file that it is being included in " -"the exporting module, not a client module. Finally, the module's :c:data:" -"`mod_exec ` function must take care of initializing the C API " -"pointer array::" +"the exporting module, not a client module. Finally, the " +"module's :c:data:`mod_exec ` function must take care of " +"initializing the C API pointer array::" msgstr "" msgid "" @@ -1848,8 +1850,8 @@ msgid "" "The bulk of the work is in the header file :file:`spammodule.h`, which looks " "like this::" msgstr "" -"Większa część pracy jest wykonywana w pliku nagłówkowym :file:`spammodule." -"h`, który wygląda następująco::" +"Większa część pracy jest wykonywana w pliku " +"nagłówkowym :file:`spammodule.h`, który wygląda następująco::" msgid "" "#ifndef Py_SPAMMODULE_H\n" @@ -1903,9 +1905,10 @@ msgid "" msgstr "" msgid "" -"All that a client module must do in order to have access to the function :c:" -"func:`!PySpam_System` is to call the function (or rather macro) :c:func:`!" -"import_spam` in its :c:data:`mod_exec ` function::" +"All that a client module must do in order to have access to the " +"function :c:func:`!PySpam_System` is to call the function (or rather " +"macro) :c:func:`!import_spam` in its :c:data:`mod_exec ` " +"function::" msgstr "" msgid "" @@ -1935,22 +1938,16 @@ msgid "" "which is especially useful for memory allocation and deallocation of the " "pointer stored in a Capsule. The details are described in the Python/C API " "Reference Manual in the section :ref:`capsules` and in the implementation of " -"Capsules (files :file:`Include/pycapsule.h` and :file:`Objects/pycapsule.c` " -"in the Python source code distribution)." +"Capsules (files :file:`Include/pycapsule.h` and :file:`Objects/capsule.c` in " +"the Python source code distribution)." msgstr "" -"Ostatecznie warto wspomnieć, że kapsuły dają dodatkowe możliwości działania, " -"które są szczególnie użyteczne dla umieszczania i zabierania miejsca w " -"pamięci wskaźników zachowywanych w kapsule. Szczegóły są opisane w " -"podręczniku użytkownika API Python/C w rozdziale :ref:`capsules` i w " -"wypełnieniu programowym kapsuł (plików :file:`Include/pycapsule.h` i :file:" -"`Objects/pycapsule.c` w dystrybucji źródłowej kodu Pythona)." msgid "Footnotes" msgstr "Przypisy" msgid "" -"An interface for this function already exists in the standard module :mod:" -"`os` --- it was chosen as a simple and straightforward example." +"An interface for this function already exists in the standard " +"module :mod:`os` --- it was chosen as a simple and straightforward example." msgstr "" "sprzęg dla tego zadania już istnieje w standardowym module :mod:`os` --- " "został on wybrany jako prosty i przejrzysty przykład." diff --git a/extending/index.po b/extending/index.po index 985e229c3f..60f7dd27ac 100644 --- a/extending/index.po +++ b/extending/index.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -44,21 +44,17 @@ msgstr "" "dany system operacyjny wspiera tą funkcję." msgid "" -"This document assumes basic knowledge about Python. For an informal " -"introduction to the language, see :ref:`tutorial-index`. :ref:`reference-" -"index` gives a more formal definition of the language. :ref:`library-index` " -"documents the existing object types, functions and modules (both built-in " -"and written in Python) that give the language its wide application range." +"This document assumes basic knowledge about C and Python. For an informal " +"introduction to Python, see :ref:`tutorial-index`. :ref:`reference-index` " +"gives a more formal definition of the language. :ref:`builtins-index` " +"documents the built-in functions and object types, and :ref:`library-index` " +"documents the modules (both built-in and written in Python) that give the " +"language its wide application range." msgstr "" -"Ten dokument zawiera podstawową wiedzę o Pythonie. Z nieformalnym wstępem do " -"języka zapoznaj się z :ref:`tutorial-index`. :ref:`reference-index` zawiera " -"bardziej formalny opis języka. Dokumenty :ref:`library-index` zawierają " -"istniejące typy obiektów, funkcje i moduły (zarówno wbudowane jak i napisane " -"w Pythonie) dające językowi duże pole zastosowań." msgid "" -"For a detailed description of the whole Python/C API, see the separate :ref:" -"`c-api-index`." +"For a detailed description of the whole Python/C API, see the " +"separate :ref:`c-api-index`." msgstr "" "Aby zapoznać się z dokładną instrukcją dla Python/C API, spójrz na :ref:`c-" "api-index`." diff --git a/extending/newtypes.po b/extending/newtypes.po index 2228804169..d9199e4e3c 100644 --- a/extending/newtypes.po +++ b/extending/newtypes.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -135,6 +136,70 @@ msgid "" " uint16_t tp_versions_used;\n" "} PyTypeObject;\n" msgstr "" +"typedef struct _typeobject { PyObject_VAR_HEAD const char *tp_name; /* Do " +"drukowania, w formacie \".\" */ Py_ssize_t tp_basicsize, tp_itemsize; /* Do " +"alokacji */ /* Metody do implementacji standardowych operacji */ destruktor " +"tp_dealloc; Py_ssize_t tp_vectorcall_offset; getattrfunc tp_getattr; " +"setattrfunc tp_setattr; PyAsyncMethods *tp_as_async; /* dawniej znane jako " +"tp_compare (Python 2) lub tp_reserved (Python 3) */ reprfunc tp_repr; /* " +"Zestawy metod dla klas standardowych */ PyNumberMethods *tp_as_number; " +"PySequenceMethods *tp_as_sequence; PyMappingMethods *tp_as_mapping; /* " +"Więcej standardowych operacji (tutaj dla zgodności binarnej) */ hashfunc " +"tp_hash; ternaryfunc tp_call;reprfunc tp_str; getattrofunc tp_getattro; " +"setattrofunc tp_setattro; /* Funkcje umożliwiające dostęp do obiektu jako " +"bufora wejścia/wyjścia */ PyBufferProcs *tp_as_buffer; /* Flagi definiujące " +"obecność opcjonalnych/rozszerzonych funkcji */ unsigned long tp_flags; const " +"char *tp_doc; /* Ciąg dokumentacji */ /* Przypisane znaczenie w wersji 2.0 " +"*/ /* wywołanie funkcji dla wszystkich dostępnych obiektów */ traverseproc " +"tp_traverse; /* usunięcie odniesień do zawartych obiektów */ inquiry " +"tp_clear; /* Przypisane znaczenie w wersji 2.1 */ /* rozbudowane porównania " +"*/ richcmpfunc tp_richcompare;/* włączanie słabych odniesień */ Py_ssize_t " +"tp_weaklistoffset; /* Iteratory */ getiterfunc tp_iter; iternextfunc " +"tp_iternext; /* Deskryptor atrybutu i elementy podklas */ PyMethodDef " +"*tp_methods; PyMemberDef *tp_members; PyGetSetDef *tp_getset; // Silne " +"odwołanie do typu sterty, pożyczone odwołanie do typu statycznego " +"PyTypeObject *tp_base; PyObject *tp_dict; descrgetfunc tp_descr_get; " +"descrsetfunc tp_descr_set; Py_ssize_t tp_dictoffset; initproc tp_init; " +"allocfunc tp_alloc;\n" +"typedef struct _typeobject { PyObject_VAR_HEAD const char *tp_name; /* Do " +"wydruku, w formacie \".\" */ Py_ssize_t tp_basicsize, tp_itemsize; /* Do " +"alokacji */ /* Metody implementujące standardowe operacje */ destruktor " +"tp_dealloc; Py_ssize_t tp_vectorcall_offset; getattrfunc tp_getattr; " +"setattrfunc tp_setattr; PyAsyncMethods *tp_as_async; /* dawniej znane jako " +"tp_compare (Python 2) lub tp_reserved (Python 3) */ reprfunc tp_repr; /* " +"Zestawy metod dla klas standardowych */ PyNumberMethods *tp_as_number; " +"PySequenceMethods *tp_as_sequence; PyMappingMethods *tp_as_mapping; /* " +"'{'Więcej standardowych operacji (tutaj dla zgodności binarnej) */ hashfunc " +"tp_hash; ternaryfunc tp_call; reprfunc tp_str; getattrofunc tp_getattro; " +"setattrofunc tp_setattro; /* Funkcje umożliwiające dostęp do obiektu jako " +"bufora wejścia/wyjścia */ PyBufferProcs *tp_as_buffer; /* Flagi definiujące " +"obecność opcjonalnych/rozszerzonych funkcji */ unsigned long tp_flags; const " +"char *tp_doc; /* Ciąg dokumentacji */ /* Przypisane znaczenie w wersji 2.0 " +"*/ /* wywołanie funkcji dla wszystkich dostępnych obiektów */ traverseproc " +"tp_traverse; /* usunięcie odniesień do zawartych obiektów */ inquiry " +"tp_clear; /* Przypisane znaczenie w wersji 2.1 */ /* rozbudowane porównania " +"*/ richcmpfunc tp_richcompare; /* włączanie słabych odniesień */ Py_ssize_t " +"tp_weaklistoffset; /* Iteratory */ getiterfunc tp_iter; iternextfunc " +"tp_iternext; /* Deskryptor atrybutu i elementy podklas */ PyMethodDef " +"*tp_methods; PyMemberDef *tp_members; PyGetSetDef *tp_getset; // Silne " +"odwołanie do typu sterty, pożyczone odwołanie do typu statycznego " +"PyTypeObject *tp_base; PyObject *tp_dict; descrgetfunc tp_descr_get; " +"descrsetfunc tp_descr_set; Py_ssize_t tp_dictoffset; initproc tp_init; " +"allocfunc tp_alloc; newfunc tp_new; freefunc tp_free; /* Procedura niskiego " +"poziomu obsługi wolnej pamięci */ query tp_is_gc; /* Dla PyObject_IS_GC */ " +"PyObject *tp_bases; PyObject *tp_mro; /* kolejność rozwiązywania metod */ " +"PyObject *tp_cache; /* nie jest już używane */ void *tp_subclasses; /* dla " +"statycznych typów wbudowanych jest to indeks */ PyObject *tp_weaklist; /* " +"nie jest używany dla statycznych typów wbudowanych */ destruktor tp_del; /* " +"Atrybut typu znacznik wersji pamięci podręcznej. Dodano w wersji 2.6. * " +"Jeśli zero, pamięć podręczna jest nieprawidłowa i musi zostać zainicjowana. " +"*/ unsigned int tp_version_tag; destruktor tp_finalize; vectorcallfunc " +"tp_vectorcall; /* zestaw bitów, którego type-watchers interesują się tym " +"typem */ unsigned char tp_watched; /* Liczba użytych wartości " +"tp_version_tag. * Ustaw na _Py_ATTR_CACHE_UNUSED, jeśli pamięć podręczna " +"atrybutów jest * wyłączona dla tego typu (np. z powodu niestandardowych " +"wpisów MRO). * W przeciwnym razie ograniczone do MAX_VERSIONS_PER_CLASS " +"(zdefiniowane gdzie indziej). */ uint16_t tp_versions_used; PyTypeObject;\n" msgid "" "Now that's a *lot* of methods. Don't worry too much though -- if you have a " @@ -166,9 +231,9 @@ msgstr "" msgid "" "These fields tell the runtime how much memory to allocate when new objects " "of this type are created. Python has some built-in support for variable " -"length structures (think: strings, tuples) which is where the :c:member:" -"`~PyTypeObject.tp_itemsize` field comes in. This will be dealt with " -"later. ::" +"length structures (think: strings, tuples) which is where " +"the :c:member:`~PyTypeObject.tp_itemsize` field comes in. This will be " +"dealt with later. ::" msgstr "" msgid "const char *tp_doc;" @@ -212,8 +277,8 @@ msgid "" msgstr "" msgid "" -"If your type supports garbage collection, the destructor should call :c:func:" -"`PyObject_GC_UnTrack` before clearing any member fields::" +"If your type supports garbage collection, the destructor should " +"call :c:func:`PyObject_GC_UnTrack` before clearing any member fields::" msgstr "" msgid "" @@ -238,8 +303,8 @@ msgid "" "additional Python code to be executed may detect that an exception has been " "set. This can lead to misleading errors from the interpreter. The proper " "way to protect against this is to save a pending exception before performing " -"the unsafe action, and restoring it when done. This can be done using the :" -"c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` functions::" +"the unsafe action, and restoring it when done. This can be done using " +"the :c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` functions::" msgstr "" msgid "" @@ -274,14 +339,16 @@ msgstr "" msgid "" "There are limitations to what you can safely do in a deallocator function. " -"First, if your type supports garbage collection (using :c:member:" -"`~PyTypeObject.tp_traverse` and/or :c:member:`~PyTypeObject.tp_clear`), some " -"of the object's members can have been cleared or finalized by the time :c:" -"member:`~PyTypeObject.tp_dealloc` is called. Second, in :c:member:" -"`~PyTypeObject.tp_dealloc`, your object is in an unstable state: its " -"reference count is equal to zero. Any call to a non-trivial object or API " -"(as in the example above) might end up calling :c:member:`~PyTypeObject." -"tp_dealloc` again, causing a double free and a crash." +"First, if your type supports garbage collection " +"(using :c:member:`~PyTypeObject.tp_traverse` and/" +"or :c:member:`~PyTypeObject.tp_clear`), some of the object's members can " +"have been cleared or finalized by the " +"time :c:member:`~PyTypeObject.tp_dealloc` is called. Second, " +"in :c:member:`~PyTypeObject.tp_dealloc`, your object is in an unstable " +"state: its reference count is equal to zero. Any call to a non-trivial " +"object or API (as in the example above) might end up " +"calling :c:member:`~PyTypeObject.tp_dealloc` again, causing a double free " +"and a crash." msgstr "" msgid "" @@ -298,13 +365,14 @@ msgstr "Prezentacja Przedmiotów" msgid "" "In Python, there are two ways to generate a textual representation of an " -"object: the :func:`repr` function, and the :func:`str` function. (The :func:" -"`print` function just calls :func:`str`.) These handlers are both optional." +"object: the :func:`repr` function, and the :func:`str` function. " +"(The :func:`print` function just calls :func:`str`.) These handlers are " +"both optional." msgstr "" "W Pythonie istnieją dwa sposoby aby wygenerować tekstową reprezentację " -"przedmiotu: funkcja :func:`repr`, i funkcja :func:`str`. (Zadanie :func:" -"`print` po prostu wywołuje zadanie :func:`str`.) Ta zadania obsługi są oba " -"opcjonalne." +"przedmiotu: funkcja :func:`repr`, i funkcja :func:`str`. " +"(Zadanie :func:`print` po prostu wywołuje zadanie :func:`str`.) Ta zadania " +"obsługi są oba opcjonalne." msgid "" "reprfunc tp_repr;\n" @@ -329,18 +397,19 @@ msgstr "" msgid "" "If no :c:member:`~PyTypeObject.tp_repr` handler is specified, the " -"interpreter will supply a representation that uses the type's :c:member:" -"`~PyTypeObject.tp_name` and a uniquely identifying value for the object." +"interpreter will supply a representation that uses the " +"type's :c:member:`~PyTypeObject.tp_name` and a uniquely identifying value " +"for the object." msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_str` handler is to :func:`str` what the :c:" -"member:`~PyTypeObject.tp_repr` handler described above is to :func:`repr`; " -"that is, it is called when Python code calls :func:`str` on an instance of " -"your object. Its implementation is very similar to the :c:member:" -"`~PyTypeObject.tp_repr` function, but the resulting string is intended for " -"human consumption. If :c:member:`~PyTypeObject.tp_str` is not specified, " -"the :c:member:`~PyTypeObject.tp_repr` handler is used instead." +"The :c:member:`~PyTypeObject.tp_str` handler is to :func:`str` what " +"the :c:member:`~PyTypeObject.tp_repr` handler described above is " +"to :func:`repr`; that is, it is called when Python code calls :func:`str` on " +"an instance of your object. Its implementation is very similar to " +"the :c:member:`~PyTypeObject.tp_repr` function, but the resulting string is " +"intended for human consumption. If :c:member:`~PyTypeObject.tp_str` is not " +"specified, the :c:member:`~PyTypeObject.tp_repr` handler is used instead." msgstr "" msgid "Here is a simple example::" @@ -371,9 +440,10 @@ msgstr "" msgid "" "Python supports two pairs of attribute handlers; a type that supports " "attributes only needs to implement the functions for one pair. The " -"difference is that one pair takes the name of the attribute as a :c:expr:" -"`char\\*`, while the other accepts a :c:expr:`PyObject*`. Each type can use " -"whichever pair makes more sense for the implementation's convenience. ::" +"difference is that one pair takes the name of the attribute as " +"a :c:expr:`char\\*`, while the other accepts a :c:expr:`PyObject*`. Each " +"type can use whichever pair makes more sense for the implementation's " +"convenience. ::" msgstr "" msgid "" @@ -432,9 +502,10 @@ msgid "" "dictionary of the type object. Each descriptor controls access to one " "attribute of the instance object. Each of the tables is optional; if all " "three are ``NULL``, instances of the type will only have attributes that are " -"inherited from their base type, and should leave the :c:member:" -"`~PyTypeObject.tp_getattro` and :c:member:`~PyTypeObject.tp_setattro` fields " -"``NULL`` as well, allowing the base type to handle attributes." +"inherited from their base type, and should leave " +"the :c:member:`~PyTypeObject.tp_getattro` " +"and :c:member:`~PyTypeObject.tp_setattro` fields ``NULL`` as well, allowing " +"the base type to handle attributes." msgstr "" msgid "The tables are declared as three fields of the type object::" @@ -464,8 +535,8 @@ msgstr "" msgid "" "One entry should be defined for each method provided by the type; no entries " "are needed for methods inherited from a base type. One additional entry is " -"needed at the end; it is a sentinel that marks the end of the array. The :c:" -"member:`~PyMethodDef.ml_name` field of the sentinel must be ``NULL``." +"needed at the end; it is a sentinel that marks the end of the array. " +"The :c:member:`~PyMethodDef.ml_name` field of the sentinel must be ``NULL``." msgstr "" msgid "" @@ -483,7 +554,7 @@ msgid "" "typedef struct PyMemberDef {\n" " const char *name;\n" " int type;\n" -" int offset;\n" +" Py_ssize_t offset;\n" " int flags;\n" " const char *doc;\n" "} PyMemberDef;" @@ -494,10 +565,10 @@ msgid "" "added to the type which will be able to extract a value from the instance " "structure. The :c:member:`~PyMemberDef.type` field should contain a type " "code like :c:macro:`Py_T_INT` or :c:macro:`Py_T_DOUBLE`; the value will be " -"used to determine how to convert Python values to and from C values. The :c:" -"member:`~PyMemberDef.flags` field is used to store flags which control how " -"the attribute can be accessed: you can set it to :c:macro:`Py_READONLY` to " -"prevent Python code from setting it." +"used to determine how to convert Python values to and from C values. " +"The :c:member:`~PyMemberDef.flags` field is used to store flags which " +"control how the attribute can be accessed: you can set it " +"to :c:macro:`Py_READONLY` to prevent Python code from setting it." msgstr "" msgid "" @@ -505,8 +576,8 @@ msgid "" "table to build descriptors that are used at runtime is that any attribute " "defined this way can have an associated doc string simply by providing the " "text in the table. An application can use the introspection API to retrieve " -"the descriptor from the class object, and get the doc string using its :attr:" -"`~type.__doc__` attribute." +"the descriptor from the class object, and get the doc string using " +"its :attr:`~type.__doc__` attribute." msgstr "" msgid "" @@ -519,8 +590,8 @@ msgstr "Szczególne-dla-typu-przedmiotu zarządzanie właściwościami" msgid "" "For simplicity, only the :c:expr:`char\\*` version will be demonstrated " -"here; the type of the name parameter is the only difference between the :c:" -"expr:`char\\*` and :c:expr:`PyObject*` flavors of the interface. This " +"here; the type of the name parameter is the only difference between " +"the :c:expr:`char\\*` and :c:expr:`PyObject*` flavors of the interface. This " "example effectively does the same thing as the generic example above, but " "does not use the generic support added in Python 2.2. It explains how the " "handler functions are called, so that if you do need to extend their " @@ -553,12 +624,13 @@ msgid "" msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_setattr` handler is called when the :meth:" -"`~object.__setattr__` or :meth:`~object.__delattr__` method of a class " -"instance would be called. When an attribute should be deleted, the third " -"parameter will be ``NULL``. Here is an example that simply raises an " -"exception; if this were really all you wanted, the :c:member:`~PyTypeObject." -"tp_setattr` handler should be set to ``NULL``. ::" +"The :c:member:`~PyTypeObject.tp_setattr` handler is called when " +"the :meth:`~object.__setattr__` or :meth:`~object.__delattr__` method of a " +"class instance would be called. When an attribute should be deleted, the " +"third parameter will be ``NULL``. Here is an example that simply raises an " +"exception; if this were really all you wanted, " +"the :c:member:`~PyTypeObject.tp_setattr` handler should be set to " +"``NULL``. ::" msgstr "" msgid "" @@ -579,8 +651,8 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_richcompare` handler is called when " "comparisons are needed. It is analogous to the :ref:`rich comparison " -"methods `, like :meth:`!__lt__`, and also called by :c:func:" -"`PyObject_RichCompare` and :c:func:`PyObject_RichCompareBool`." +"methods `, like :meth:`!__lt__`, and also called " +"by :c:func:`PyObject_RichCompare` and :c:func:`PyObject_RichCompareBool`." msgstr "" msgid "" @@ -661,8 +733,8 @@ msgstr "" msgid "" "If you wish your object to be able to act like a number, a sequence, or a " "mapping object, then you place the address of a structure that implements " -"the C type :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, or :c:" -"type:`PyMappingMethods`, respectively. It is up to you to fill in this " +"the C type :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, " +"or :c:type:`PyMappingMethods`, respectively. It is up to you to fill in this " "structure with appropriate values. You can find examples of the use of each " "of these in the :file:`Objects` directory of the Python source " "distribution. ::" @@ -716,16 +788,17 @@ msgid "" msgstr "" msgid "" -"*args* is a tuple containing the arguments to the call. You can use :c:func:" -"`PyArg_ParseTuple` to extract the arguments." +"*args* is a tuple containing the arguments to the call. You can " +"use :c:func:`PyArg_ParseTuple` to extract the arguments." msgstr "" msgid "" "*kwds* is a dictionary of keyword arguments that were passed. If this is non-" -"``NULL`` and you support keyword arguments, use :c:func:" -"`PyArg_ParseTupleAndKeywords` to extract the arguments. If you do not want " -"to support keyword arguments and this is non-``NULL``, raise a :exc:" -"`TypeError` with a message saying that keyword arguments are not supported." +"``NULL`` and you support keyword arguments, " +"use :c:func:`PyArg_ParseTupleAndKeywords` to extract the arguments. If you " +"do not want to support keyword arguments and this is non-``NULL``, raise " +"a :exc:`TypeError` with a message saying that keyword arguments are not " +"supported." msgstr "" msgid "Here is a toy ``tp_call`` implementation::" @@ -763,15 +836,16 @@ msgid "" "take exactly one parameter, the instance for which they are being called, " "and return a new reference. In the case of an error, they should set an " "exception and return ``NULL``. :c:member:`~PyTypeObject.tp_iter` " -"corresponds to the Python :meth:`~object.__iter__` method, while :c:member:" -"`~PyTypeObject.tp_iternext` corresponds to the Python :meth:`~iterator." -"__next__` method." +"corresponds to the Python :meth:`~object.__iter__` method, " +"while :c:member:`~PyTypeObject.tp_iternext` corresponds to the " +"Python :meth:`~iterator.__next__` method." msgstr "" msgid "" -"Any :term:`iterable` object must implement the :c:member:`~PyTypeObject." -"tp_iter` handler, which must return an :term:`iterator` object. Here the " -"same guidelines apply as for Python classes:" +"Any :term:`iterable` object must implement " +"the :c:member:`~PyTypeObject.tp_iter` handler, which must return " +"an :term:`iterator` object. Here the same guidelines apply as for Python " +"classes:" msgstr "" msgid "" @@ -782,23 +856,26 @@ msgstr "" msgid "" "Objects which can only be iterated over once (usually due to side effects of " -"iteration, such as file objects) can implement :c:member:`~PyTypeObject." -"tp_iter` by returning a new reference to themselves -- and should also " -"therefore implement the :c:member:`~PyTypeObject.tp_iternext` handler." -msgstr "" - -msgid "" -"Any :term:`iterator` object should implement both :c:member:`~PyTypeObject." -"tp_iter` and :c:member:`~PyTypeObject.tp_iternext`. An iterator's :c:member:" -"`~PyTypeObject.tp_iter` handler should return a new reference to the " -"iterator. Its :c:member:`~PyTypeObject.tp_iternext` handler should return a " -"new reference to the next object in the iteration, if there is one. If the " -"iteration has reached the end, :c:member:`~PyTypeObject.tp_iternext` may " -"return ``NULL`` without setting an exception, or it may set :exc:" -"`StopIteration` *in addition* to returning ``NULL``; avoiding the exception " -"can yield slightly better performance. If an actual error occurs, :c:member:" -"`~PyTypeObject.tp_iternext` should always set an exception and return " -"``NULL``." +"iteration, such as file objects) can " +"implement :c:member:`~PyTypeObject.tp_iter` by returning a new reference to " +"themselves -- and should also therefore implement " +"the :c:member:`~PyTypeObject.tp_iternext` handler." +msgstr "" + +msgid "" +"Any :term:`iterator` object should implement " +"both :c:member:`~PyTypeObject.tp_iter` " +"and :c:member:`~PyTypeObject.tp_iternext`. An " +"iterator's :c:member:`~PyTypeObject.tp_iter` handler should return a new " +"reference to the iterator. Its :c:member:`~PyTypeObject.tp_iternext` " +"handler should return a new reference to the next object in the iteration, " +"if there is one. If the iteration has reached the " +"end, :c:member:`~PyTypeObject.tp_iternext` may return ``NULL`` without " +"setting an exception, or it may set :exc:`StopIteration` *in addition* to " +"returning ``NULL``; avoiding the exception can yield slightly better " +"performance. If an actual error " +"occurs, :c:member:`~PyTypeObject.tp_iternext` should always set an exception " +"and return ``NULL``." msgstr "" msgid "Weak Reference Support" diff --git a/extending/newtypes_tutorial.po b/extending/newtypes_tutorial.po index 75c98cebe5..4a53675848 100644 --- a/extending/newtypes_tutorial.po +++ b/extending/newtypes_tutorial.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,14 +38,14 @@ msgid "The Basics" msgstr "" msgid "" -"The :term:`CPython` runtime sees all Python objects as variables of type :c:" -"expr:`PyObject*`, which serves as a \"base type\" for all Python objects. " -"The :c:type:`PyObject` structure itself only contains the object's :term:" -"`reference count` and a pointer to the object's \"type object\". This is " -"where the action is; the type object determines which (C) functions get " -"called by the interpreter when, for instance, an attribute gets looked up on " -"an object, a method called, or it is multiplied by another object. These C " -"functions are called \"type methods\"." +"The :term:`CPython` runtime sees all Python objects as variables of " +"type :c:expr:`PyObject*`, which serves as a \"base type\" for all Python " +"objects. The :c:type:`PyObject` structure itself only contains the " +"object's :term:`reference count` and a pointer to the object's \"type " +"object\". This is where the action is; the type object determines which (C) " +"functions get called by the interpreter when, for instance, an attribute " +"gets looked up on an object, a method called, or it is multiplied by another " +"object. These C functions are called \"type methods\"." msgstr "" msgid "" @@ -62,8 +62,8 @@ msgstr "" msgid "" "What we're showing here is the traditional way of defining *static* " "extension types. It should be adequate for most uses. The C API also " -"allows defining heap-allocated extension types using the :c:func:" -"`PyType_FromSpec` function, which isn't covered in this tutorial." +"allows defining heap-allocated extension types using " +"the :c:func:`PyType_FromSpec` function, which isn't covered in this tutorial." msgstr "" msgid "" @@ -244,9 +244,10 @@ msgstr "" msgid "" "Note that the name is a dotted name that includes both the module name and " "the name of the type within the module. The module in this case is :mod:`!" -"custom` and the type is :class:`!Custom`, so we set the type name to :class:" -"`!custom.Custom`. Using the real dotted import path is important to make " -"your type compatible with the :mod:`pydoc` and :mod:`pickle` modules. ::" +"custom` and the type is :class:`!Custom`, so we set the type name " +"to :class:`!custom.Custom`. Using the real dotted import path is important " +"to make your type compatible with the :mod:`pydoc` and :mod:`pickle` " +"modules. ::" msgstr "" msgid "" @@ -255,9 +256,9 @@ msgid "" msgstr "" msgid "" -"This is so that Python knows how much memory to allocate when creating new :" -"class:`!Custom` instances. :c:member:`~PyTypeObject.tp_itemsize` is only " -"used for variable-sized objects and should otherwise be zero." +"This is so that Python knows how much memory to allocate when creating " +"new :class:`!Custom` instances. :c:member:`~PyTypeObject.tp_itemsize` is " +"only used for variable-sized objects and should otherwise be zero." msgstr "" msgid "" @@ -293,19 +294,19 @@ msgid ".tp_doc = PyDoc_STR(\"Custom objects\")," msgstr "" msgid "" -"To enable object creation, we have to provide a :c:member:`~PyTypeObject." -"tp_new` handler. This is the equivalent of the Python method :meth:`~object." -"__new__`, but has to be specified explicitly. In this case, we can just use " -"the default implementation provided by the API function :c:func:" -"`PyType_GenericNew`. ::" +"To enable object creation, we have to provide " +"a :c:member:`~PyTypeObject.tp_new` handler. This is the equivalent of the " +"Python method :meth:`~object.__new__`, but has to be specified explicitly. " +"In this case, we can just use the default implementation provided by the API " +"function :c:func:`PyType_GenericNew`. ::" msgstr "" msgid ".tp_new = PyType_GenericNew," msgstr "" msgid "" -"Everything else in the file should be familiar, except for some code in :c:" -"func:`!custom_module_exec`::" +"Everything else in the file should be familiar, except for some code " +"in :c:func:`!custom_module_exec`::" msgstr "" msgid "" @@ -327,8 +328,8 @@ msgid "" msgstr "" msgid "" -"This adds the type to the module dictionary. This allows us to create :" -"class:`!Custom` instances by calling the :class:`!Custom` class:" +"This adds the type to the module dictionary. This allows us to " +"create :class:`!Custom` instances by calling the :class:`!Custom` class:" msgstr "" msgid "" @@ -581,13 +582,13 @@ msgid ".tp_dealloc = Custom_dealloc," msgstr "" msgid "" -"This method first clears the reference counts of the two Python attributes. :" -"c:func:`Py_XDECREF` correctly handles the case where its argument is " -"``NULL`` (which might happen here if ``tp_new`` failed midway). It then " -"calls the :c:member:`~PyTypeObject.tp_free` member of the object's type " -"(computed by ``Py_TYPE(self)``) to free the object's memory. Note that the " -"object's type might not be :class:`!CustomType`, because the object may be " -"an instance of a subclass." +"This method first clears the reference counts of the two Python " +"attributes. :c:func:`Py_XDECREF` correctly handles the case where its " +"argument is ``NULL`` (which might happen here if ``tp_new`` failed midway). " +"It then calls the :c:member:`~PyTypeObject.tp_free` member of the object's " +"type (computed by ``Py_TYPE(self)``) to free the object's memory. Note that " +"the object's type might not be :class:`!CustomType`, because the object may " +"be an instance of a subclass." msgstr "" msgid "" @@ -657,12 +658,13 @@ msgstr "" msgid "" "The ``tp_new`` handler is responsible for creating (as opposed to " -"initializing) objects of the type. It is exposed in Python as the :meth:" -"`~object.__new__` method. It is not required to define a ``tp_new`` member, " -"and indeed many extension types will simply reuse :c:func:" -"`PyType_GenericNew` as done in the first version of the :class:`!Custom` " -"type above. In this case, we use the ``tp_new`` handler to initialize the " -"``first`` and ``last`` attributes to non-``NULL`` default values." +"initializing) objects of the type. It is exposed in Python as " +"the :meth:`~object.__new__` method. It is not required to define a " +"``tp_new`` member, and indeed many extension types will simply " +"reuse :c:func:`PyType_GenericNew` as done in the first version of " +"the :class:`!Custom` type above. In this case, we use the ``tp_new`` " +"handler to initialize the ``first`` and ``last`` attributes to non-``NULL`` " +"default values." msgstr "" msgid "" @@ -670,8 +672,8 @@ msgid "" "``CustomType``, if a subclass is instantiated) and any arguments passed when " "the type was called, and is expected to return the instance created. " "``tp_new`` handlers always accept positional and keyword arguments, but they " -"often ignore the arguments, leaving the argument handling to initializer (a." -"k.a. ``tp_init`` in C or ``__init__`` in Python) methods." +"often ignore the arguments, leaving the argument handling to initializer " +"(a.k.a. ``tp_init`` in C or ``__init__`` in Python) methods." msgstr "" msgid "" @@ -688,8 +690,9 @@ msgid "self = (CustomObject *) type->tp_alloc(type, 0);" msgstr "" msgid "" -"Since memory allocation may fail, we must check the :c:member:`~PyTypeObject." -"tp_alloc` result against ``NULL`` before proceeding." +"Since memory allocation may fail, we must check " +"the :c:member:`~PyTypeObject.tp_alloc` result against ``NULL`` before " +"proceeding." msgstr "" msgid "" @@ -701,14 +704,15 @@ msgstr "" msgid "" "If you are creating a co-operative :c:member:`~PyTypeObject.tp_new` (one " -"that calls a base type's :c:member:`~PyTypeObject.tp_new` or :meth:`~object." -"__new__`), you must *not* try to determine what method to call using method " -"resolution order at runtime. Always statically determine what type you are " -"going to call, and call its :c:member:`~PyTypeObject.tp_new` directly, or " -"via ``type->tp_base->tp_new``. If you do not do this, Python subclasses of " -"your type that also inherit from other Python-defined classes may not work " -"correctly. (Specifically, you may not be able to create instances of such " -"subclasses without getting a :exc:`TypeError`.)" +"that calls a base type's :c:member:`~PyTypeObject.tp_new` " +"or :meth:`~object.__new__`), you must *not* try to determine what method to " +"call using method resolution order at runtime. Always statically determine " +"what type you are going to call, and call " +"its :c:member:`~PyTypeObject.tp_new` directly, or via ``type->tp_base-" +">tp_new``. If you do not do this, Python subclasses of your type that also " +"inherit from other Python-defined classes may not work correctly. " +"(Specifically, you may not be able to create instances of such subclasses " +"without getting a :exc:`TypeError`.)" msgstr "" msgid "" @@ -752,10 +756,10 @@ msgid ".tp_init = Custom_init," msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_init` slot is exposed in Python as the :meth:" -"`~object.__init__` method. It is used to initialize an object after it's " -"created. Initializers always accept positional and keyword arguments, and " -"they should return either ``0`` on success or ``-1`` on error." +"The :c:member:`~PyTypeObject.tp_init` slot is exposed in Python as " +"the :meth:`~object.__init__` method. It is used to initialize an object " +"after it's created. Initializers always accept positional and keyword " +"arguments, and they should return either ``0`` on success or ``-1`` on error." msgstr "" msgid "" @@ -795,15 +799,15 @@ msgid "when we absolutely know that the reference count is greater than 1;" msgstr "" msgid "" -"when we know that deallocation of the object [#]_ will neither detach the :" -"term:`thread state ` nor cause any calls back into " -"our type's code;" +"when we know that deallocation of the object [#]_ will neither detach " +"the :term:`thread state ` nor cause any calls back " +"into our type's code;" msgstr "" msgid "" -"when decrementing a reference count in a :c:member:`~PyTypeObject." -"tp_dealloc` handler on a type which doesn't support cyclic garbage " -"collection [#]_." +"when decrementing a reference count in " +"a :c:member:`~PyTypeObject.tp_dealloc` handler on a type which doesn't " +"support cyclic garbage collection [#]_." msgstr "" msgid "" @@ -869,12 +873,12 @@ msgid "" msgstr "" msgid "" -"The method is implemented as a C function that takes a :class:`!Custom` (or :" -"class:`!Custom` subclass) instance as the first argument. Methods always " -"take an instance as the first argument. Methods often take positional and " -"keyword arguments as well, but in this case we don't take any and don't need " -"to accept a positional argument tuple or keyword argument dictionary. This " -"method is equivalent to the Python method:" +"The method is implemented as a C function that takes a :class:`!Custom` " +"(or :class:`!Custom` subclass) instance as the first argument. Methods " +"always take an instance as the first argument. Methods often take positional " +"and keyword arguments as well, but in this case we don't take any and don't " +"need to accept a positional argument tuple or keyword argument dictionary. " +"This method is equivalent to the Python method:" msgstr "" msgid "" @@ -885,11 +889,11 @@ msgstr "" " return \"%s %s\" % (self.first, self.last)" msgid "" -"Note that we have to check for the possibility that our :attr:`!first` and :" -"attr:`!last` members are ``NULL``. This is because they can be deleted, in " -"which case they are set to ``NULL``. It would be better to prevent deletion " -"of these attributes and to restrict the attribute values to be strings. " -"We'll see how to do that in the next section." +"Note that we have to check for the possibility that our :attr:`!first` " +"and :attr:`!last` members are ``NULL``. This is because they can be " +"deleted, in which case they are set to ``NULL``. It would be better to " +"prevent deletion of these attributes and to restrict the attribute values to " +"be strings. We'll see how to do that in the next section." msgstr "" msgid "" @@ -953,9 +957,9 @@ msgstr "" msgid "" "In this section, we'll provide finer control over how the :attr:`!first` " "and :attr:`!last` attributes are set in the :class:`!Custom` example. In the " -"previous version of our module, the instance variables :attr:`!first` and :" -"attr:`!last` could be set to non-string values or even deleted. We want to " -"make sure that these attributes always contain strings." +"previous version of our module, the instance variables :attr:`!first` " +"and :attr:`!last` could be set to non-string values or even deleted. We want " +"to make sure that these attributes always contain strings." msgstr "" msgid "" @@ -1318,9 +1322,10 @@ msgstr "" msgid "" "In the second version of the :class:`!Custom` example, we allowed any kind " "of object to be stored in the :attr:`!first` or :attr:`!last` attributes " -"[#]_. Besides, in the second and third versions, we allowed subclassing :" -"class:`!Custom`, and subclasses may add arbitrary attributes. For any of " -"those two reasons, :class:`!Custom` objects can participate in cycles:" +"[#]_. Besides, in the second and third versions, we allowed " +"subclassing :class:`!Custom`, and subclasses may add arbitrary attributes. " +"For any of those two reasons, :class:`!Custom` objects can participate in " +"cycles:" msgstr "" msgid "" @@ -1582,11 +1587,11 @@ msgid "" msgstr "" msgid "" -"For each subobject that can participate in cycles, we need to call the :c:" -"func:`!visit` function, which is passed to the traversal method. The :c:func:" -"`!visit` function takes as arguments the subobject and the extra argument " -"*arg* passed to the traversal method. It returns an integer value that must " -"be returned if it is non-zero." +"For each subobject that can participate in cycles, we need to call " +"the :c:func:`!visit` function, which is passed to the traversal method. " +"The :c:func:`!visit` function takes as arguments the subobject and the extra " +"argument *arg* passed to the traversal method. It returns an integer value " +"that must be returned if it is non-zero." msgstr "" msgid "" @@ -1647,9 +1652,9 @@ msgid "" msgstr "" msgid "" -"Nevertheless, it is much easier and less error-prone to always use :c:func:" -"`Py_CLEAR` when deleting an attribute. Don't try to micro-optimize at the " -"expense of robustness!" +"Nevertheless, it is much easier and less error-prone to always " +"use :c:func:`Py_CLEAR` when deleting an attribute. Don't try to micro-" +"optimize at the expense of robustness!" msgstr "" msgid "" @@ -1657,8 +1662,8 @@ msgid "" "attributes. It means the circular GC can be triggered inside the function. " "Since the GC assumes reference count is not zero, we need to untrack the " "object from the GC by calling :c:func:`PyObject_GC_UnTrack` before clearing " -"members. Here is our reimplemented deallocator using :c:func:" -"`PyObject_GC_UnTrack` and ``Custom_clear``::" +"members. Here is our reimplemented deallocator " +"using :c:func:`PyObject_GC_UnTrack` and ``Custom_clear``::" msgstr "" msgid "" @@ -1680,9 +1685,10 @@ msgid "" msgstr "" msgid "" -"That's pretty much it. If we had written custom :c:member:`~PyTypeObject." -"tp_alloc` or :c:member:`~PyTypeObject.tp_free` handlers, we'd need to modify " -"them for cyclic garbage collection. Most extensions will use the versions " +"That's pretty much it. If we had written " +"custom :c:member:`~PyTypeObject.tp_alloc` " +"or :c:member:`~PyTypeObject.tp_free` handlers, we'd need to modify them for " +"cyclic garbage collection. Most extensions will use the versions " "automatically provided." msgstr "" @@ -1849,18 +1855,20 @@ msgid "" msgstr "" msgid "" -"This pattern is important when writing a type with custom :c:member:" -"`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_dealloc` members. " +"This pattern is important when writing a type with " +"custom :c:member:`~PyTypeObject.tp_new` " +"and :c:member:`~PyTypeObject.tp_dealloc` members. " "The :c:member:`~PyTypeObject.tp_new` handler should not actually create the " "memory for the object with its :c:member:`~PyTypeObject.tp_alloc`, but let " "the base class handle it by calling its own :c:member:`~PyTypeObject.tp_new`." msgstr "" msgid "" -"The :c:type:`PyTypeObject` struct supports a :c:member:`~PyTypeObject." -"tp_base` specifying the type's concrete base class. Due to cross-platform " -"compiler issues, you can't fill that field directly with a reference to :c:" -"type:`PyList_Type`; it should be done in the :c:data:`Py_mod_exec` function::" +"The :c:type:`PyTypeObject` struct supports " +"a :c:member:`~PyTypeObject.tp_base` specifying the type's concrete base " +"class. Due to cross-platform compiler issues, you can't fill that field " +"directly with a reference to :c:type:`PyList_Type`; it should be done in " +"the :c:data:`Py_mod_exec` function::" msgstr "" msgid "" @@ -1882,11 +1890,11 @@ msgid "" msgstr "" msgid "" -"Before calling :c:func:`PyType_Ready`, the type structure must have the :c:" -"member:`~PyTypeObject.tp_base` slot filled in. When we are deriving an " -"existing type, it is not necessary to fill out the :c:member:`~PyTypeObject." -"tp_alloc` slot with :c:func:`PyType_GenericNew` -- the allocation function " -"from the base type will be inherited." +"Before calling :c:func:`PyType_Ready`, the type structure must have " +"the :c:member:`~PyTypeObject.tp_base` slot filled in. When we are deriving " +"an existing type, it is not necessary to fill out " +"the :c:member:`~PyTypeObject.tp_alloc` slot with :c:func:`PyType_GenericNew` " +"-- the allocation function from the base type will be inherited." msgstr "" msgid "" diff --git a/extending/windows.po b/extending/windows.po index dd2c8a1b51..6dbe1f895a 100644 --- a/extending/windows.po +++ b/extending/windows.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -103,15 +103,15 @@ msgstr "" msgid "" "In Windows, there are two types of library, a static library and an import " -"library (both called :file:`.lib`). A static library is like a Unix :file:`." -"a` file; it contains code to be included as necessary. An import library is " -"basically used only to reassure the linker that a certain identifier is " -"legal, and will be present in the program when the DLL is loaded. So the " -"linker uses the information from the import library to build the lookup " -"table for using identifiers that are not included in the DLL. When an " -"application or a DLL is linked, an import library may be generated, which " -"will need to be used for all future DLLs that depend on the symbols in the " -"application or DLL." +"library (both called :file:`.lib`). A static library is like a " +"Unix :file:`.a` file; it contains code to be included as necessary. An " +"import library is basically used only to reassure the linker that a certain " +"identifier is legal, and will be present in the program when the DLL is " +"loaded. So the linker uses the information from the import library to build " +"the lookup table for using identifiers that are not included in the DLL. " +"When an application or a DLL is linked, an import library may be generated, " +"which will need to be used for all future DLLs that depend on the symbols in " +"the application or DLL." msgstr "" msgid "" @@ -119,9 +119,10 @@ msgid "" "share another block of code A. On Unix, you would *not* pass :file:`A.a` to " "the linker for :file:`B.so` and :file:`C.so`; that would cause it to be " "included twice, so that B and C would each have their own copy. In Windows, " -"building :file:`A.dll` will also build :file:`A.lib`. You *do* pass :file:" -"`A.lib` to the linker for B and C. :file:`A.lib` does not contain code; it " -"just contains information which will be used at runtime to access A's code." +"building :file:`A.dll` will also build :file:`A.lib`. You *do* " +"pass :file:`A.lib` to the linker for B and C. :file:`A.lib` does not " +"contain code; it just contains information which will be used at runtime to " +"access A's code." msgstr "" msgid "" @@ -149,11 +150,11 @@ msgid "" msgstr "" msgid "" -"By default, inclusion of :file:`PC/pyconfig.h` directly or via :file:`Python." -"h` triggers an implicit, configure-aware link with the library. The header " -"file chooses :file:`pythonXY_d.lib` for Debug, :file:`pythonXY.lib` for " -"Release, and :file:`pythonX.lib` for Release with the :ref:`Limited API " -"` enabled." +"By default, inclusion of :file:`PC/pyconfig.h` directly or " +"via :file:`Python.h` triggers an implicit, configure-aware link with the " +"library. The header file chooses :file:`pythonXY_d.lib` for " +"Debug, :file:`pythonXY.lib` for Release, and :file:`pythonX.lib` for Release " +"with the :ref:`Limited API ` enabled." msgstr "" msgid "" @@ -174,14 +175,14 @@ msgid "" msgstr "" msgid "" -"The second command created :file:`ni.dll` (and :file:`.obj` and :file:`." -"lib`), which knows how to find the necessary functions from spam, and also " -"from the Python executable." +"The second command created :file:`ni.dll` (and :file:`.obj` " +"and :file:`.lib`), which knows how to find the necessary functions from " +"spam, and also from the Python executable." msgstr "" msgid "" -"Manually by defining :c:macro:`Py_NO_LINK_LIB` macro before including :file:" -"`Python.h`. You must pass :file:`pythonXY.lib` to the linker." +"Manually by defining :c:macro:`Py_NO_LINK_LIB` macro before " +"including :file:`Python.h`. You must pass :file:`pythonXY.lib` to the linker." msgstr "" msgid "" diff --git a/faq/design.po b/faq/design.po index 5d276de4ad..7ed9e7089b 100644 --- a/faq/design.po +++ b/faq/design.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -132,12 +132,13 @@ msgstr "" "liczbami zmiennoprzecinkowymi." msgid "" -"The :class:`float` type in CPython uses a C ``double`` for storage. A :" -"class:`float` object's value is stored in binary floating-point with a fixed " -"precision (typically 53 bits) and Python uses C operations, which in turn " -"rely on the hardware implementation in the processor, to perform floating-" -"point operations. This means that as far as floating-point operations are " -"concerned, Python behaves like many popular languages including C and Java." +"The :class:`float` type in CPython uses a C ``double`` for storage. " +"A :class:`float` object's value is stored in binary floating-point with a " +"fixed precision (typically 53 bits) and Python uses C operations, which in " +"turn rely on the hardware implementation in the processor, to perform " +"floating-point operations. This means that as far as floating-point " +"operations are concerned, Python behaves like many popular languages " +"including C and Java." msgstr "" "Typ :class:`float` w CPython używa ``double`` z C do przechowywania. Wartość " "obiektu :class:`float` jest przechowywana w binarnej liczbie " @@ -302,12 +303,12 @@ msgstr "" msgid "" "(b) When I read code that says len(x) I *know* that it is asking for the " "length of something. This tells me two things: the result is an integer, and " -"the argument is some kind of container. To the contrary, when I read x." -"len(), I have to already know that x is some kind of container implementing " -"an interface or inheriting from a class that has a standard len(). Witness " -"the confusion we occasionally have when a class that is not implementing a " -"mapping has a get() or keys() method, or something that isn't a file has a " -"write() method." +"the argument is some kind of container. To the contrary, when I read " +"x.len(), I have to already know that x is some kind of container " +"implementing an interface or inheriting from a class that has a standard " +"len(). Witness the confusion we occasionally have when a class that is not " +"implementing a mapping has a get() or keys() method, or something that isn't " +"a file has a write() method." msgstr "" msgid "https://mail.python.org/pipermail/python-3000/2006-November/004643.html" @@ -348,8 +349,9 @@ msgstr "" msgid "" "The second objection is typically cast as: \"I am really telling a sequence " "to join its members together with a string constant\". Sadly, you aren't. " -"For some reason there seems to be much less difficulty with having :meth:" -"`~str.split` as a string method, since in that case it is easy to see that ::" +"For some reason there seems to be much less difficulty with " +"having :meth:`~str.split` as a string method, since in that case it is easy " +"to see that ::" msgstr "" msgid "\"1, 2, 4, 8, 16\".split(\", \")" @@ -410,8 +412,10 @@ msgid "" "In general, structured switch statements execute one block of code when an " "expression has a particular value or set of values. Since Python 3.10 one " "can easily match literal values, or constants within a namespace, with a " -"``match ... case`` statement. An older alternative is a sequence of ``if... " -"elif... elif... else``." +"``match ... case`` statement. See :ref:`the specification ` " +"and :ref:`the tutorial ` for more information " +"about :keyword:`match` statements. An older alternative is a sequence of " +"``if... elif... elif... else``." msgstr "" msgid "" @@ -430,8 +434,8 @@ msgid "" msgstr "" msgid "" -"For calling methods on objects, you can simplify yet further by using the :" -"func:`getattr` built-in to retrieve methods with a particular name::" +"For calling methods on objects, you can simplify yet further by using " +"the :func:`getattr` built-in to retrieve methods with a particular name::" msgstr "" msgid "" @@ -609,10 +613,10 @@ msgstr "" msgid "" "Lists, on the other hand, are more like arrays in other languages. They " "tend to hold a varying number of objects all of which have the same type and " -"which are operated on one-by-one. For example, :func:`os.listdir('.') ` returns a list of strings representing the files in the current " -"directory. Functions which operate on this output would generally not break " -"if you added another file or two to the directory." +"which are operated on one-by-one. For example, :func:`os.listdir('.') " +"` returns a list of strings representing the files in the " +"current directory. Functions which operate on this output would generally " +"not break if you added another file or two to the directory." msgstr "" msgid "" @@ -645,6 +649,10 @@ msgid "" "the next few times don't require an actual resize." msgstr "" +msgid "" +"See :ref:`time-complexity` for the costs of the various list operations." +msgstr "" + msgid "How are dictionaries implemented in CPython?" msgstr "" @@ -667,6 +675,11 @@ msgid "" "O notation -- to retrieve a key." msgstr "" +msgid "" +"See :ref:`time-complexity` for the costs of the various dictionary " +"operations." +msgstr "" + msgid "Why must dictionary keys be immutable?" msgstr "" @@ -705,8 +718,8 @@ msgstr "" msgid "" "would raise a :exc:`KeyError` exception because the id of the ``[1, 2]`` " "used in the second line differs from that in the first line. In other " -"words, dictionary keys should be compared using ``==``, not using :keyword:" -"`is`." +"words, dictionary keys should be compared using ``==``, not " +"using :keyword:`is`." msgstr "" msgid "" @@ -766,11 +779,11 @@ msgid "" msgstr "" msgid "" -"Furthermore it must always be the case that if ``o1 == o2`` (ie ``o1." -"__eq__(o2) is True``) then ``hash(o1) == hash(o2)`` (ie, ``o1.__hash__() == " -"o2.__hash__()``), regardless of whether the object is in a dictionary or " -"not. If you fail to meet these restrictions dictionaries and other hash " -"based structures will misbehave." +"Furthermore it must always be the case that if ``o1 == o2`` (ie " +"``o1.__eq__(o2) is True``) then ``hash(o1) == hash(o2)`` (ie, " +"``o1.__hash__() == o2.__hash__()``), regardless of whether the object is in " +"a dictionary or not. If you fail to meet these restrictions dictionaries " +"and other hash based structures will misbehave." msgstr "" msgid "" @@ -817,10 +830,10 @@ msgstr "" msgid "" "Python 2.6 adds an :mod:`abc` module that lets you define Abstract Base " "Classes (ABCs). You can then use :func:`isinstance` and :func:`issubclass` " -"to check whether an instance or a class implements a particular ABC. The :" -"mod:`collections.abc` module defines a set of useful ABCs such as :class:" -"`~collections.abc.Iterable`, :class:`~collections.abc.Container`, and :class:" -"`~collections.abc.MutableMapping`." +"to check whether an instance or a class implements a particular ABC. " +"The :mod:`collections.abc` module defines a set of useful ABCs such " +"as :class:`~collections.abc.Iterable`, :class:`~collections.abc.Container`, " +"and :class:`~collections.abc.MutableMapping`." msgstr "" msgid "" @@ -833,10 +846,10 @@ msgid "" "as a module interface specification and a set of examples. Many Python " "modules can be run as a script to provide a simple \"self test.\" Even " "modules which use complex external interfaces can often be tested in " -"isolation using trivial \"stub\" emulations of the external interface. The :" -"mod:`doctest` and :mod:`unittest` modules or third-party test frameworks can " -"be used to construct exhaustive test suites that exercise every line of code " -"in a module." +"isolation using trivial \"stub\" emulations of the external interface. " +"The :mod:`doctest` and :mod:`unittest` modules or third-party test " +"frameworks can be used to construct exhaustive test suites that exercise " +"every line of code in a module." msgstr "" msgid "" @@ -866,9 +879,9 @@ msgid "" "\"spaghetti\" code that was hard to understand and revise. In a high-level " "language, it is also unneeded as long as there are ways to branch (in " "Python, with :keyword:`if` statements and :keyword:`or`, :keyword:`and`, " -"and :keyword:`if`/:keyword:`else` expressions) and loop (with :keyword:" -"`while` and :keyword:`for` statements, possibly containing :keyword:" -"`continue` and :keyword:`break`)." +"and :keyword:`if`/:keyword:`else` expressions) and loop " +"(with :keyword:`while` and :keyword:`for` statements, possibly " +"containing :keyword:`continue` and :keyword:`break`)." msgstr "" msgid "" @@ -1021,9 +1034,9 @@ msgstr "" msgid "" "For technical reasons, a generator used directly as a context manager would " "not work correctly. When, as is most common, a generator is used as an " -"iterator run to completion, no closing is needed. When it is, wrap it as :" -"func:`contextlib.closing(generator) ` in the :keyword:" -"`with` statement." +"iterator run to completion, no closing is needed. When it is, wrap it " +"as :func:`contextlib.closing(generator) ` in " +"the :keyword:`with` statement." msgstr "" msgid "Why are colons required for the if/while/def/class statements?" diff --git a/faq/extending.po b/faq/extending.po index 201eaf8c67..0322b2c0ba 100644 --- a/faq/extending.po +++ b/faq/extending.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -34,8 +34,8 @@ msgstr "" msgid "" "Yes, you can create built-in modules containing functions, variables, " -"exceptions and even new types in C. This is explained in the document :ref:" -"`extending-index`." +"exceptions and even new types in C. This is explained in the " +"document :ref:`extending-index`." msgstr "" msgid "Most intermediate or advanced Python books will also cover this topic." @@ -45,10 +45,10 @@ msgid "Can I create my own functions in C++?" msgstr "" msgid "" -"Yes, using the C compatibility features found in C++. Place ``extern " -"\"C\" { ... }`` around the Python include files and put ``extern \"C\"`` " -"before each function that is going to be called by the Python interpreter. " -"Global or static C++ objects with constructors are probably not a good idea." +"Yes, using the C compatibility features found in C++. Place ``extern \"C\" " +"{ ... }`` around the Python include files and put ``extern \"C\"`` before " +"each function that is going to be called by the Python interpreter. Global " +"or static C++ objects with constructors are probably not a good idea." msgstr "" msgid "Writing C is hard; are there any alternatives?" @@ -68,9 +68,9 @@ msgid "" "The highest-level function to do this is :c:func:`PyRun_SimpleString` which " "takes a single string argument to be executed in the context of the module " "``__main__`` and returns ``0`` for success and ``-1`` when an exception " -"occurred (including :exc:`SyntaxError`). If you want more control, use :c:" -"func:`PyRun_String`; see the source for :c:func:`PyRun_SimpleString` in " -"``Python/pythonrun.c``." +"occurred (including :exc:`SyntaxError`). If you want more control, " +"use :c:func:`PyRun_String`; see the source for :c:func:`PyRun_SimpleString` " +"in ``Python/pythonrun.c``." msgstr "" msgid "How can I evaluate an arbitrary Python expression from C?" @@ -88,21 +88,21 @@ msgstr "" msgid "" "That depends on the object's type. If it's a tuple, :c:func:`PyTuple_Size` " "returns its length and :c:func:`PyTuple_GetItem` returns the item at a " -"specified index. Lists have similar functions, :c:func:`PyList_Size` and :c:" -"func:`PyList_GetItem`." +"specified index. Lists have similar functions, :c:func:`PyList_Size` " +"and :c:func:`PyList_GetItem`." msgstr "" msgid "" -"For bytes, :c:func:`PyBytes_Size` returns its length and :c:func:" -"`PyBytes_AsStringAndSize` provides a pointer to its value and its length. " -"Note that Python bytes objects may contain null bytes so C's :c:func:`!" -"strlen` should not be used." +"For bytes, :c:func:`PyBytes_Size` returns its length " +"and :c:func:`PyBytes_AsStringAndSize` provides a pointer to its value and " +"its length. Note that Python bytes objects may contain null bytes so " +"C's :c:func:`!strlen` should not be used." msgstr "" msgid "" "To test the type of an object, first make sure it isn't ``NULL``, and then " -"use :c:func:`PyBytes_Check`, :c:func:`PyTuple_Check`, :c:func:" -"`PyList_Check`, etc." +"use :c:func:`PyBytes_Check`, :c:func:`PyTuple_Check`, :c:func:`PyList_Check`, " +"etc." msgstr "" msgid "" @@ -219,11 +219,11 @@ msgid "module = PyImport_ImportModule(\"\");" msgstr "" msgid "" -"If the module hasn't been imported yet (i.e. it is not yet present in :data:" -"`sys.modules`), this initializes the module; otherwise it simply returns the " -"value of ``sys.modules[\"\"]``. Note that it doesn't enter the " -"module into any namespace -- it only ensures it has been initialized and is " -"stored in :data:`sys.modules`." +"If the module hasn't been imported yet (i.e. it is not yet present " +"in :data:`sys.modules`), this initializes the module; otherwise it simply " +"returns the value of ``sys.modules[\"\"]``. Note that it " +"doesn't enter the module into any namespace -- it only ensures it has been " +"initialized and is stored in :data:`sys.modules`." msgstr "" msgid "" @@ -344,12 +344,12 @@ msgid "" msgstr "" msgid "" -"Yes, you can inherit from built-in classes such as :class:`int`, :class:" -"`list`, :class:`dict`, etc." +"Yes, you can inherit from built-in classes such " +"as :class:`int`, :class:`list`, :class:`dict`, etc." msgstr "" msgid "" -"The Boost Python Library (BPL, https://www.boost.org/libs/python/doc/index." -"html) provides a way of doing this from C++ (i.e. you can inherit from an " -"extension class written in C++ using the BPL)." +"The Boost Python Library (BPL, https://www.boost.org/libs/python/doc/" +"index.html) provides a way of doing this from C++ (i.e. you can inherit from " +"an extension class written in C++ using the BPL)." msgstr "" diff --git a/faq/general.po b/faq/general.po index 630f63cb45..3fe526081b 100644 --- a/faq/general.po +++ b/faq/general.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -67,8 +67,8 @@ msgstr "" msgid "" "Donations to the PSF are tax-exempt in the US. If you use Python and find " -"it helpful, please contribute via `the PSF donation page `_." +"it helpful, please contribute via `the PSF donation page `_." msgstr "" msgid "Are there copyright restrictions on the use of Python?" @@ -294,15 +294,16 @@ msgid "" "There is a newsgroup, :newsgroup:`comp.lang.python`, and a mailing list, " "`python-list `_. The " "newsgroup and mailing list are gatewayed into each other -- if you can read " -"news it's unnecessary to subscribe to the mailing list. :newsgroup:`comp." -"lang.python` is high-traffic, receiving hundreds of postings every day, and " -"Usenet readers are often more able to cope with this volume." +"news it's unnecessary to subscribe to the mailing " +"list. :newsgroup:`comp.lang.python` is high-traffic, receiving hundreds of " +"postings every day, and Usenet readers are often more able to cope with this " +"volume." msgstr "" msgid "" -"Announcements of new software releases and events can be found in comp.lang." -"python.announce, a low-traffic moderated list that receives about five " -"postings per day. It's available as `the python-announce mailing list " +"Announcements of new software releases and events can be found in " +"comp.lang.python.announce, a low-traffic moderated list that receives about " +"five postings per day. It's available as `the python-announce mailing list " "`_." msgstr "" @@ -316,9 +317,9 @@ msgstr "" msgid "" "Alpha and beta releases are available from https://www.python.org/" -"downloads/. All releases are announced on the comp.lang.python and comp." -"lang.python.announce newsgroups and on the Python home page at https://www." -"python.org/; an RSS feed of news is available." +"downloads/. All releases are announced on the comp.lang.python and " +"comp.lang.python.announce newsgroups and on the Python home page at https://" +"www.python.org/; an RSS feed of news is available." msgstr "" msgid "" @@ -330,8 +331,8 @@ msgid "How do I submit bug reports and patches for Python?" msgstr "" msgid "" -"To report a bug or submit a patch, use the issue tracker at https://github." -"com/python/cpython/issues." +"To report a bug or submit a patch, use the issue tracker at https://" +"github.com/python/cpython/issues." msgstr "" msgid "" @@ -374,8 +375,8 @@ msgstr "" msgid "" "The Python project's infrastructure is located all over the world and is " -"managed by the Python Infrastructure Team. Details `here `__." +"managed by the Python Infrastructure Team. Details `here `__." msgstr "" msgid "Why is it called Python?" @@ -383,8 +384,8 @@ msgstr "" msgid "" "When he began implementing Python, Guido van Rossum was also reading the " -"published scripts from `\"Monty Python's Flying Circus\" `__, a BBC comedy series from the 1970s. " +"published scripts from `\"Monty Python's Flying Circus\" `__, a BBC comedy series from the 1970s. " "Van Rossum thought he needed a name that was short, unique, and slightly " "mysterious, so he decided to call the language Python." msgstr "" @@ -447,18 +448,18 @@ msgstr "" msgid "" "See https://www.python.org/about/success for a list of projects that use " -"Python. Consulting the proceedings for `past Python conferences `_ will reveal contributions from many " +"Python. Consulting the proceedings for `past Python conferences `_ will reveal contributions from many " "different companies and organizations." msgstr "" msgid "" "High-profile Python projects include `the Mailman mailing list manager " -"`_ and `the Zope application server `_. Several Linux distributions, most notably `Red Hat `_, have written part or all of their installer and system " -"administration software in Python. Companies that use Python internally " -"include Google, Yahoo, and Lucasfilm Ltd." +"`_ and `the Zope application server `_. Several Linux distributions, most notably `Red Hat " +"`_, have written part or all of their installer and " +"system administration software in Python. Companies that use Python " +"internally include Google, Yahoo, and Lucasfilm Ltd." msgstr "" msgid "What new developments are expected for Python in the future?" @@ -473,8 +474,8 @@ msgid "" msgstr "" msgid "" -"New development is discussed on `the python-dev mailing list `_." +"New development is discussed on `the python-dev mailing list `_." msgstr "" msgid "Is it reasonable to propose incompatible changes to Python?" diff --git a/faq/gui.po b/faq/gui.po index ac12664416..383f4c1ab0 100644 --- a/faq/gui.po +++ b/faq/gui.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,8 +40,9 @@ msgid "" "widget set, called :ref:`tkinter `. This is probably the easiest " "to install (since it comes included with most `binary distributions `_ of Python) and use. For more info about Tk, " -"including pointers to the source, see the `Tcl/Tk home page `_. Tcl/Tk is fully portable to the macOS, Windows, and Unix platforms." +"including pointers to the source, see the `Tcl/Tk home page `_. Tcl/Tk is fully portable to the macOS, Windows, and Unix " +"platforms." msgstr "" "Standardowe kompilacje Pythona zawierają obiektowy interfejs do zestawu " "widżetów Tcl/Tk, zwany :ref:`tkinter `. Jest to prawdopodobnie " diff --git a/faq/index.po b/faq/index.po index 948361da5c..815082839a 100644 --- a/faq/index.po +++ b/faq/index.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/installed.po b/faq/installed.po index 7df571c55a..1b9f4a6508 100644 --- a/faq/installed.po +++ b/faq/installed.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/library.po b/faq/library.po index 321aa8a653..c240aa0b2f 100644 --- a/faq/library.po +++ b/faq/library.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -42,8 +42,8 @@ msgid "" msgstr "" msgid "" -"For third-party packages, search the `Python Package Index `_ or try `Google `_ or another web search " +"For third-party packages, search the `Python Package Index `_ or try `Google `_ or another web search " "engine. Searching for \"Python\" plus a keyword or two for your topic of " "interest will usually find something helpful." msgstr "" @@ -54,9 +54,9 @@ msgstr "" msgid "" "If you can't find a source file for a module it may be a built-in or " "dynamically loaded module implemented in C, C++ or other compiled language. " -"In this case you may not have the source file or it may be something like :" -"file:`mathmodule.c`, somewhere in a C source directory (not on the Python " -"Path)." +"In this case you may not have the source file or it may be something " +"like :file:`mathmodule.c`, somewhere in a C source directory (not on the " +"Python Path)." msgstr "" msgid "There are (at least) three kinds of modules in Python:" @@ -343,10 +343,10 @@ msgstr "" msgid "" "Instead of trying to guess a good delay value for :func:`time.sleep`, it's " -"better to use some kind of semaphore mechanism. One idea is to use the :mod:" -"`queue` module to create a queue object, let each thread append a token to " -"the queue when it finishes, and let the main thread read as many tokens from " -"the queue as there are threads." +"better to use some kind of semaphore mechanism. One idea is to use " +"the :mod:`queue` module to create a queue object, let each thread append a " +"token to the queue when it finishes, and let the main thread read as many " +"tokens from the queue as there are threads." msgstr "" msgid "How do I parcel out work among a bunch of worker threads?" @@ -427,8 +427,8 @@ msgid "" msgstr "" msgid "" -"Consult the module's documentation for more details; the :class:`~queue." -"Queue` class provides a featureful interface." +"Consult the module's documentation for more details; " +"the :class:`~queue.Queue` class provides a featureful interface." msgstr "" msgid "What kinds of global value mutation are thread-safe?" @@ -480,10 +480,10 @@ msgid "" msgstr "" msgid "" -"Operations that replace other objects may invoke those other objects' :meth:" -"`~object.__del__` method when their reference count reaches zero, and that " -"can affect things. This is especially true for the mass updates to " -"dictionaries and lists. When in doubt, use a mutex!" +"Operations that replace other objects may invoke those other " +"objects' :meth:`~object.__del__` method when their reference count reaches " +"zero, and that can affect things. This is especially true for the mass " +"updates to dictionaries and lists. When in doubt, use a mutex!" msgstr "" msgid "Can't we get rid of the Global Interpreter Lock?" @@ -535,8 +535,8 @@ msgid "" "Judicious use of C extensions will also help; if you use a C extension to " "perform a time-consuming task, the extension can release the GIL while the " "thread of execution is in the C code and allow other threads to get some " -"work done. Some standard library modules such as :mod:`zlib` and :mod:" -"`hashlib` already do this." +"work done. Some standard library modules such as :mod:`zlib` " +"and :mod:`hashlib` already do this." msgstr "" msgid "" @@ -557,8 +557,9 @@ msgstr "Jak usunąć plik? (i inne plikowe pytania…)" msgid "" "Use ``os.remove(filename)`` or ``os.unlink(filename)``; for documentation, " -"see the :mod:`os` module. The two functions are identical; :func:`~os." -"unlink` is simply the name of the Unix system call for this function." +"see the :mod:`os` module. The two functions are " +"identical; :func:`~os.unlink` is simply the name of the Unix system call for " +"this function." msgstr "" msgid "" @@ -575,14 +576,14 @@ msgstr "" msgid "" "To truncate a file, open it using ``f = open(filename, \"rb+\")``, and use " "``f.truncate(offset)``; offset defaults to the current seek position. " -"There's also ``os.ftruncate(fd, offset)`` for files opened with :func:`os." -"open`, where *fd* is the file descriptor (a small integer)." +"There's also ``os.ftruncate(fd, offset)`` for files opened " +"with :func:`os.open`, where *fd* is the file descriptor (a small integer)." msgstr "" msgid "" "The :mod:`shutil` module also contains a number of functions to work on " -"files including :func:`~shutil.copyfile`, :func:`~shutil.copytree`, and :" -"func:`~shutil.rmtree`." +"files including :func:`~shutil.copyfile`, :func:`~shutil.copytree`, " +"and :func:`~shutil.rmtree`." msgstr "" msgid "How do I copy a file?" @@ -602,9 +603,9 @@ msgid "How do I read (or write) binary data?" msgstr "" msgid "" -"To read or write complex binary data formats, it's best to use the :mod:" -"`struct` module. It allows you to take a string containing binary data " -"(usually numbers) and convert it to Python objects; and vice versa." +"To read or write complex binary data formats, it's best to use " +"the :mod:`struct` module. It allows you to take a string containing binary " +"data (usually numbers) and convert it to Python objects; and vice versa." msgstr "" msgid "" @@ -645,8 +646,8 @@ msgid "" ":func:`os.read` is a low-level function which takes a file descriptor, a " "small integer representing the opened file. :func:`os.popen` creates a high-" "level file object, the same type returned by the built-in :func:`open` " -"function. Thus, to read *n* bytes from a pipe *p* created with :func:`os." -"popen`, you need to use ``p.read(n)``." +"function. Thus, to read *n* bytes from a pipe *p* created " +"with :func:`os.popen`, you need to use ``p.read(n)``." msgstr "" msgid "How do I access the serial (RS232) port?" @@ -799,10 +800,10 @@ msgstr "" msgid "" "You can use the :meth:`~socket.socket.connect_ex` method to avoid creating " -"an exception. It will just return the errno value. To poll, you can call :" -"meth:`~socket.socket.connect_ex` again later -- ``0`` or ``errno.EISCONN`` " -"indicate that you're connected -- or you can pass this socket to :meth:" -"`select.select` to check if it's writable." +"an exception. It will just return the errno value. To poll, you can " +"call :meth:`~socket.socket.connect_ex` again later -- ``0`` or " +"``errno.EISCONN`` indicate that you're connected -- or you can pass this " +"socket to :meth:`select.select` to check if it's writable." msgstr "" msgid "" @@ -823,9 +824,9 @@ msgstr "Tak" msgid "" "Interfaces to disk-based hashes such as :mod:`DBM ` and :mod:`GDBM " -"` are also included with standard Python. There is also the :mod:" -"`sqlite3` module, which provides a lightweight disk-based relational " -"database." +"` are also included with standard Python. There is also " +"the :mod:`sqlite3` module, which provides a lightweight disk-based " +"relational database." msgstr "" msgid "" @@ -839,8 +840,8 @@ msgstr "" msgid "" "The :mod:`pickle` library module solves this in a very general way (though " -"you still can't store things like open files, sockets or windows), and the :" -"mod:`shelve` library module uses pickle and (g)dbm to create persistent " +"you still can't store things like open files, sockets or windows), and " +"the :mod:`shelve` library module uses pickle and (g)dbm to create persistent " "mappings containing arbitrary Python objects." msgstr "" diff --git a/faq/programming.po b/faq/programming.po index c056c87d60..86f2b6bb96 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -4,16 +4,18 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,19 +32,23 @@ msgid "Contents" msgstr "Zawartość" msgid "General questions" -msgstr "" +msgstr "Pytania ogólne" msgid "" "Is there a source code-level debugger with breakpoints and single-stepping?" msgstr "" +"Czy istnieje debugger na poziomie kodu źródłowego z punktami przerwania i " +"wykonywaniem krok po kroku?" msgid "Yes." msgstr "Tak" msgid "" -"Several debuggers for Python are described below, and the built-in function :" -"func:`breakpoint` allows you to drop into any of them." +"Several debuggers for Python are described below, and the built-in " +"function :func:`breakpoint` allows you to drop into any of them." msgstr "" +"Poniżej opisano kilka narzędzi do debugowania w Pythonie, a wbudowana " +"funkcja :func:`breakpoint` pozwala przejść do dowolnego z nich." msgid "" "The pdb module is a simple but adequate console-mode debugger for Python. It " @@ -50,12 +56,19 @@ msgid "" "Library Reference Manual `. You can also write your own debugger by " "using the code for pdb as an example." msgstr "" +"Moduł :mod:`pdb` jest prostym, ale wystarczającym debuggerem działającym w " +"trybie konsolowym dla języka Python. Jest częścią standardowej biblioteki " +"Pythona i jest :mod:`udokumentowany `. Możesz również napisać własny " +"debugger, wykorzystując kod modułu :mod:`pdb` jako przykład." msgid "" "The IDLE interactive development environment, which is part of the standard " "Python distribution (normally available as :mod:`idlelib`), includes a " "graphical debugger." msgstr "" +"Interaktywne środowisko programistyczne IDLE, które jest częścią " +"standardowej dystrybucji Pythona (zwykle dostępnej jako :mod:`idlelib`), " +"zawiera graficzny debugger." msgid "" "PythonWin is a Python IDE that includes a GUI debugger based on pdb. The " @@ -65,41 +78,62 @@ msgid "" "the `ActivePython `_ " "distribution." msgstr "" +"PythonWin to zintegrowane środowisko programistyczne Pythona, które zawiera " +"debugger interfejsu graficznego oparty na pdb. Debugger PythonWin koloruje " +"punkty przerwania i oferuje kilka ciekawych funkcji, takich jak debugowanie " +"programów spoza PythonWin. PythonWin jest dostępny jako część projektu " +"`pywin32 `_ oraz jako część dystrybucji " +"`ActivePython `_." msgid "" "`Eric `_ is an IDE built on PyQt and " "the Scintilla editing component." msgstr "" +"`Eric `_ to zintegrowane środowisko " +"programistyczne zbudowane na bazie PyQt i komponentu edycyjnego Scintilla." msgid "" "`trepan3k `_ is a gdb-like " "debugger." msgstr "" +"`trepan3k `_ jest debuggerem typu " +"gdb." msgid "" "`Visual Studio Code `_ is an IDE with " "debugging tools that integrates with version-control software." msgstr "" +"`Visual Studio Code `_ to zintegrowane " +"środowisko programistyczne z narzędziami do debugowania, które integruje się " +"z oprogramowaniem do kontroli wersji." msgid "" "There are a number of commercial Python IDEs that include graphical " "debuggers. They include:" msgstr "" +"Istnieje wiele komercyjnych środowisk IDE dla Pythona, które zawierają " +"graficzne debugery. Należą do nich:" msgid "`Wing IDE `_" -msgstr "" +msgstr "`Wing IDE `_" msgid "`PyCharm `_" msgstr "`PyCharm `_" msgid "Are there tools to help find bugs or perform static analysis?" msgstr "" +"Czy istnieją narzędzia pomocne w znajdowaniu błędów lub wykonywaniu analizy " +"statycznej?" msgid "" -"`Ruff `__, `Pylint `__ and `Pyflakes `__ do basic " -"checking that will help you catch bugs sooner." +"`Ruff `__, `Pylint `__ and `Pyflakes `__ do basic checking that will help you catch bugs sooner." msgstr "" +"`Ruff `__, `Pylint `__ i `Pyflakes `__ wykonują podstawowe sprawdzanie, które pomoże Ci szybciej " +"wychwycić błędy." msgid "" "Static type checkers such as `mypy `__, `ty `__ can check type hints in Python source " "code." msgstr "" +"Statyczne narzędzia do sprawdzania typów, takie jak `mypy `__, `ty `__ , `Pyrefly `__ i `pytype `__ mogą " +"sprawdzać wskazówki dotyczące typów w kodzie źródłowym Pythona." msgid "How can I create a stand-alone binary from a Python script?" -msgstr "" +msgstr "Jak mogę utworzyć samodzielny plik binarny ze skryptu Pythona?" msgid "" "You don't need the ability to compile Python to C code if all you want is a " @@ -118,6 +156,12 @@ msgid "" "determine the set of modules required by a program and bind these modules " "together with a Python binary to produce a single executable." msgstr "" +"Nie potrzebujesz umiejętności kompilowania Pythona do kodu C, jeśli " +"potrzebujesz jedynie samodzielnego programu, który użytkownicy mogą pobrać i " +"uruchomić bez konieczności wcześniejszej instalacji dystrybucji Pythona. " +"Istnieje wiele narzędzi, które określają zestaw modułów wymaganych przez " +"program i łączą te moduły za pomocą pliku binarnego Pythona w celu " +"utworzenia pojedynczego pliku wykonywalnego." msgid "" "One is to use the freeze tool, which is included in the Python source tree " @@ -125,6 +169,11 @@ msgid "" "C compiler you can embed all your modules into a new program, which is then " "linked with the standard Python modules." msgstr "" +"Jednym z nich jest użycie narzędzia freeze, które jest zawarte w drzewie " +"źródłowym Pythona jako :source:`Tools/freeze`. Konwertuje ono kod bajtowy " +"Pythona na tablice C; za pomocą kompilatora C można osadzić wszystkie moduły " +"w nowym programie, który następnie jest łączony ze standardowymi modułami " +"Pythona." msgid "" "It works by scanning your source recursively for import statements (in both " @@ -137,51 +186,72 @@ msgid "" "rest of the Python interpreter to form a self-contained binary which acts " "exactly like your script." msgstr "" +"It works by scanning your source recursively for import statements (in both " +"forms) and looking for the modules in the standard Python path as well as in " +"the source directory (for built-in modules). It then turns the bytecode for " +"modules written in Python into C code (array initializers that can be turned " +"into code objects using the marshal module) and creates a custom-made config " +"file that only contains those built-in modules which are actually used in " +"the program. It then compiles the generated C code and links it with the " +"rest of the Python interpreter to form a self-contained binary which acts " +"exactly like your script." msgid "" "The following packages can help with the creation of console and GUI " "executables:" msgstr "" +"Poniższe pakiety mogą pomóc w tworzeniu plików wykonywalnych konsoli i " +"interfejsu graficznego:" msgid "`Nuitka `_ (Cross-platform)" -msgstr "" +msgstr "`Nuitka `_ (wieloplatformowy)" msgid "`PyInstaller `_ (Cross-platform)" -msgstr "" +msgstr "`PyInstaller `_ (wieloplatformowy)" msgid "" "`PyOxidizer `_ (Cross-platform)" msgstr "" +"`PyOxidizer `_ " +"(wieloplatformowy)" msgid "" "`cx_Freeze `_ (Cross-platform)" msgstr "" +"`cx_Freeze `_ (wieloplatformowy)" msgid "`py2app `_ (macOS only)" -msgstr "" +msgstr "`py2app `_ (tylko macOS)" msgid "`py2exe `_ (Windows only)" -msgstr "" +msgstr "`py2exe `_ (tylko Windows)" msgid "Are there coding standards or a style guide for Python programs?" msgstr "" +"Czy istnieją standardy kodowania lub przewodnik stylistyczny dla programów " +"Pythona?" msgid "" "Yes. The coding style required for standard library modules is documented " "as :pep:`8`." msgstr "" +"Tak. Styl kodowania wymagany dla modułów biblioteki standardowej jest " +"udokumentowany jako :pep:`8`." msgid "Core language" -msgstr "" +msgstr "Język podstawowy" msgid "Why am I getting an UnboundLocalError when the variable has a value?" -msgstr "" +msgstr "Dlaczego otrzymuję błąd UnboundLocalError, skoro zmienna ma wartość?" msgid "" "It can be a surprise to get the :exc:`UnboundLocalError` in previously " "working code when it is modified by adding an assignment statement somewhere " "in the body of a function." msgstr "" +"Można się zdziwić otrzymując :exc:`UnboundLocalError` w kodzie, który " +"wcześniej działał, kiedy został zmodyfikowany przez dodanie instrukcji " +"przypisania w dowolnym miejscu ciała funkcji." msgid "This code:" msgstr "Ten kod:" @@ -190,7 +260,7 @@ msgid "works, but this code:" msgstr "działa, ale ten kod:" msgid "results in an :exc:`!UnboundLocalError`:" -msgstr "" +msgstr "skutkuje :exc:`!UnboundLocalError`:" msgid "" "This is because when you make an assignment to a variable in a scope, that " @@ -200,25 +270,38 @@ msgid "" "Consequently when the earlier ``print(x)`` attempts to print the " "uninitialized local variable and an error results." msgstr "" +"Dzieje się tak, ponieważ po przypisanie zmiennej w zakresie, zmienna ta " +"staje się lokalna w tym zakresie i przesłania każdą zmienną o podobnej " +"nazwie w zakresie zewnętrznym. Ponieważ ostatnie polecenie w foo przypisuje " +"nową wartość zmiennej ``x``, kompilator rozpoznaje ją jako zmienna lokalna. " +"W rezultacie ``print(x)``, gdy poprzednia instrukcja próbuje wydrukować " +"niezainicjowaną zmienna lokalna, pojawia się błąd." msgid "" "In the example above you can access the outer scope variable by declaring it " "global:" msgstr "" +"W powyższym przykładzie możesz uzyskać dostęp do zmiennej zakresu " +"zewnętrznego, deklarując ją jako globalną:" msgid "" "This explicit declaration is required in order to remind you that (unlike " "the superficially analogous situation with class and instance variables) you " "are actually modifying the value of the variable in the outer scope:" msgstr "" +"Ta wyraźna deklaracja jest wymagana, aby przypomnieć, że (w przeciwieństwie " +"do pozornie analogicznej sytuacji ze zmiennymi klasowymi i instancja) w " +"rzeczywistości modyfikujesz wartość zmiennej w zakresie zewnętrznym:" msgid "" "You can do a similar thing in a nested scope using the :keyword:`nonlocal` " "keyword:" msgstr "" +"Można wykonać podobną czynność w zakresie zagnieżdżonym, używając " +"słowa :keyword:`nonlocal` kluczowego:" msgid "What are the rules for local and global variables in Python?" -msgstr "" +msgstr "Jakie są zasady dotyczące zmiennych lokalnych i globalnych w Pythona?" msgid "" "In Python, variables that are only referenced inside a function are " @@ -226,6 +309,10 @@ msgid "" "function's body, it's assumed to be a local unless explicitly declared as " "global." msgstr "" +"W Pythona zmienne, do których odwołuje się tylko funkcja, są domyślnie " +"globalne. Jeśli zmiennej zostanie przypisana wartość w dowolnym miejscu w " +"ciele funkcja, przyjmuje się, że jest lokalna, chyba że zostanie jawnie " +"zadeklarowana jako globalna." msgid "" "Though a bit surprising at first, a moment's consideration explains this. " @@ -236,16 +323,28 @@ msgid "" "a component of an imported module. This clutter would defeat the usefulness " "of the ``global`` declaration for identifying side-effects." msgstr "" +"Choć na początku może to być nieco zaskakujące, chwila namysłu wyjaśnia " +"sprawę. Z jednej strony, wymaganie :keyword:`global` dla przypisanych " +"zmiennych chroni przed niezamierzonymi efektami ubocznymi. Z drugiej strony, " +"gdyby ``global`` było wymagane dla wszystkich odwołań globalnych, " +"używalibyśmy ``global`` go cały czas. Trzeba by deklarować jako globalne " +"każde odwołanie do funkcja wbudowany(-a) lub do komponentu importowanego " +"moduł. Ten bałagan zniweczyłby użyteczność deklaracji w ``global`` " +"identyfikowaniu efektów ubocznych." msgid "" "Why do lambdas defined in a loop with different values all return the same " "result?" msgstr "" +"Dlaczego wyrażenia lambda zdefiniowane w pętli z różnymi wartości zwracać " +"ten sam wynik?" msgid "" "Assume you use a for loop to define a few different lambdas (or even plain " "functions), for example::" msgstr "" +"Załóżmy, że używasz pętli for do zdefiniowania kilku różnych lambd (lub " +"nawet zwykłych funkcja), na przykład:" msgid "" ">>> squares = []\n" @@ -262,6 +361,9 @@ msgid "" "``1``, ``4``, ``9``, and ``16``. However, when you actually try you will " "see that they all return ``16``::" msgstr "" +"Daje to listę zawierającą 5 wyrażeń lambda obliczających ``x**2``. Można by " +"się spodziewać, że po wywołaniu zwrócą odpowiednio ``0``, ``1``, ``4``, " +"``9`` i ``16``. Jednak po próbie zobaczysz, że wszystkie zwrócą ``16``::" msgid "" ">>> squares[2]()\n" @@ -282,6 +384,12 @@ msgid "" "by changing the value of ``x`` and see how the results of the lambdas " "change::" msgstr "" +"Dzieje się tak ``x`` ponieważ zmienna nie jest lokalna dla wyrażeń lambda, " +"lecz zdefiniowana w zakresie zewnętrznym i jest dostępna podczas wywołania " +"funkcja lambda, a nie podczas jej definiowania. Na końcu pętli wartość " +"zmiennej wynosi ``x````4``, więc wszystkie funkcje zwracać ``4**2`` teraz " +"``16`` czyli . Możesz to również sprawdzić, zmieniając wartość zmiennej i " +"zobaczyć ``x`` jak zmieniają się wyniki wyrażeń lambda:" msgid "" ">>> x = 8\n" @@ -296,6 +404,8 @@ msgid "" "In order to avoid this, you need to save the values in variables local to " "the lambdas, so that they don't rely on the value of the global ``x``::" msgstr "" +"Aby tego uniknąć, należy zapisać wartości w zmiennych lokalnych dla lambd, " +"aby nie były one zależne od wartości zmiennej globalnej ``x``::" msgid "" ">>> squares = []\n" @@ -313,6 +423,11 @@ msgid "" "the first lambda, ``1`` in the second, ``2`` in the third, and so on. " "Therefore each lambda will now return the correct result::" msgstr "" +"Tutaj, ``n=x`` tworzy nową zmienną ``n`` lokalną dla lambdy i oblicza ją " +"podczas definiowania lambdy, tak aby miała tę samą wartość ``x`` co w danym " +"punkcie pętli. Oznacza to, że wartość ``n`` będzie ``0`` w pierwszej " +"lambdzie, ``1`` w drugiej, ``2`` w trzeciej itd. W związku z tym każda " +"lambda będzie zwracać teraz poprawny wynik:" msgid "" ">>> squares[2]()\n" @@ -329,9 +444,11 @@ msgid "" "Note that this behaviour is not peculiar to lambdas, but applies to regular " "functions too." msgstr "" +"Należy pamiętać, że takie zachowanie nie jest specyficzne dla wyrażeń " +"lambda, ale ma zastosowanie także do zwykłych funkcje." msgid "How do I share global variables across modules?" -msgstr "" +msgstr "Jak udostępniać zmienne globalne pomiędzy moduły?" msgid "" "The canonical way to share information across modules within a single " @@ -341,12 +458,18 @@ msgid "" "each module, any changes made to the module object get reflected " "everywhere. For example:" msgstr "" +"Kanonicznym sposobem udostępniania informacji między modułami w ramach " +"jednego programu jest utworzenie specjalnego moduł (często nazywanego config " +"lub cfg). Wystarczy zaimportować moduł config do wszystkich moduły " +"aplikacji; moduł staje się wówczas dostępny jako nazwa globalna. Ponieważ " +"istnieje tylko jedna instancja każdego moduł, wszelkie zmiany wprowadzone w " +"obiekcie moduł są odzwierciedlane wszędzie. Na przykład:" msgid "config.py::" msgstr "config.py::" msgid "x = 0 # Default value of the 'x' configuration setting" -msgstr "" +msgstr "x = 0 # Wartość domyślny ustawienia konfiguracji „x”" msgid "mod.py::" msgstr "mod.py::" @@ -369,15 +492,20 @@ msgid "" "Note that using a module is also the basis for implementing the singleton " "design pattern, for the same reason." msgstr "" +"Należy pamiętać, że używanie moduł jest również podstawą implementacji " +"wzorca projektowego singleton, z tego samego powodu." msgid "What are the \"best practices\" for using import in a module?" -msgstr "" +msgstr "Jakie są „najlepsze praktyki” dotyczące używania import w module?" msgid "" "In general, don't use ``from modulename import *``. Doing so clutters the " "importer's namespace, and makes it much harder for linters to detect " "undefined names." msgstr "" +"Ogólnie rzecz biorąc, nie należy używać ``from modulename import *``. " +"Powoduje to zaśmiecanie przestrzeni nazw importującego modułu i znacznie " +"utrudnia narzędziom lintującym wykrywanie niezdefiniowanych nazw." msgid "" "Import modules at the top of a file. Doing so makes it clear what other " @@ -385,14 +513,21 @@ msgid "" "is in scope. Using one import per line makes it easy to add and delete " "module imports, but using multiple imports per line uses less screen space." msgstr "" +"Importuj moduły na początku pliku. Dzięki temu jasno widać, jakich innych " +"modułów wymaga Twój kod, i unika się wątpliwości, czy nazwa modułu znajduje " +"się w zakresie. Używanie jednego importu w wierszu ułatwia dodawanie i " +"usuwanie importów modułów, natomiast używanie wielu importów w jednym " +"wierszu zajmuje mniej miejsca na ekranie." msgid "It's good practice if you import modules in the following order:" -msgstr "" +msgstr "Dobrą praktyką jest importowanie modułów w następującej kolejności:" msgid "" -"standard library modules -- such as :mod:`sys`, :mod:`os`, :mod:`argparse`, :" -"mod:`re`" +"standard library modules -- such " +"as :mod:`sys`, :mod:`os`, :mod:`argparse`, :mod:`re`" msgstr "" +"moduł biblioteka standardowa— takie jak 1:mod:sys, 2:mod:os, 3:mod:argparse, " +"4:mod:re" msgid "" "third-party library modules (anything installed in Python's site-packages " @@ -506,6 +641,12 @@ msgid "" "value is requested again. This is called \"memoizing\", and can be " "implemented like this::" msgstr "" +"funkcjaTa funkcjonalność może być przydatna. Gdy masz funkcja, której " +"obliczenia są czasochłonne, często stosowaną techniką jest buforowanie " +"cache’owanie parametr oraz wyników każdego wywołania funkcja i zwracać " +"zapisanego wartości wyniku wartości, jeśli ta sama wartości zostanie " +"ponownie zażądana. Nazywa się to „memoizacją” i można to zaimplementować w " +"następujący sposób::" msgid "" "# Callers can only provide two parameters and optionally pass _cache by " @@ -519,15 +660,24 @@ msgid "" " _cache[(arg1, arg2)] = result # Store result in the cache\n" " return result" msgstr "" +"# Wywołujący mogą przekazać tylko dwa parametr oraz opcjonalnie _cache jako " +"argument nazwany def expensive(arg1, arg2, *, _cache={}): if (arg1, arg2) in " +"_cache: zwracać _cache[(arg1, arg2)] # Oblicz wartość result = ... # " +"kosztowne obliczenia _cache[(arg1, arg2)] = result # Zapisz wynik w pamięci " +"podręcznej zwracać result" msgid "" "You could use a global variable containing a dictionary instead of the " "default value; it's a matter of taste." msgstr "" +"Można użyć zmiennej globalnej zawierającej słownik zamiast wartości " +"domyślny; jest to kwestia gustu." msgid "" "How can I pass optional or keyword parameters from one function to another?" msgstr "" +"Jak można przekazać opcjonalny parametr lub argumenty nazwane z jednej " +"funkcja do innej funkcji?" msgid "" "Collect the arguments using the ``*`` and ``**`` specifiers in the " @@ -543,6 +693,8 @@ msgid "" " ...\n" " g(x, *args, **kwargs)" msgstr "" +"def f(x, *args, **kwargs):...kwargs['width'] = '14.3c'...g(x, *args, " +"**kwargs)" msgid "What is the difference between arguments and parameters?" msgstr "Jaka jest różnica pomiędzy argumentami a parametrami?" @@ -550,15 +702,15 @@ msgstr "Jaka jest różnica pomiędzy argumentami a parametrami?" msgid "" ":term:`Parameters ` are defined by the names that appear in a " "function definition, whereas :term:`arguments ` are the values " -"actually passed to a function when calling it. Parameters define what :term:" -"`kind of arguments ` a function can accept. For example, given " -"the function definition::" +"actually passed to a function when calling it. Parameters define " +"what :term:`kind of arguments ` a function can accept. For " +"example, given the function definition::" msgstr "" msgid "" "def func(foo, bar=None, **kwargs):\n" " pass" -msgstr "" +msgstr "def func(foo, bar=None, **kwargs):pass" msgid "" "*foo*, *bar* and *kwargs* are parameters of ``func``. However, when calling " @@ -566,16 +718,16 @@ msgid "" msgstr "" msgid "func(42, bar=314, extra=somevar)" -msgstr "" +msgstr "func(42, bar=314, extra=somevar)" msgid "the values ``42``, ``314``, and ``somevar`` are arguments." msgstr "" msgid "Why did changing list 'y' also change list 'x'?" -msgstr "" +msgstr "Dlaczego zmiana listy „y” spowodowała również zmianę listy „x”?" msgid "If you wrote code like::" -msgstr "" +msgstr "Jeśli napisałeś kod taki jak::" msgid "" ">>> x = []\n" @@ -599,7 +751,7 @@ msgid "" msgstr "" msgid "There are two factors that produce this result:" -msgstr "" +msgstr "Na ten wynik składają się dwa czynniki:" msgid "" "Variables are simply names that refer to objects. Doing ``y = x`` doesn't " @@ -611,6 +763,7 @@ msgstr "" msgid "" "Lists are :term:`mutable`, which means that you can change their content." msgstr "" +"Listy są :term:`mutowalny`, co oznacza, że można zmieniać ich zawartość." msgid "" "After the call to :meth:`~sequence.append`, the content of the mutable " @@ -630,6 +783,8 @@ msgid "" ">>> y\n" "5" msgstr "" +">>> x = 5 # inty są niemutowalny>>> y = x>>> x = x + 1 # 5 nie może być " +"zmienione, tworzymy nowy obiekt>>> x6>>> y5" msgid "" "we can see that in this case ``x`` and ``y`` are not equal anymore. This is " @@ -660,21 +815,31 @@ msgid "" "mutates ``a_list``, whereas ``some_tuple += (1, 2, 3)`` and ``some_int += " "1`` create new objects)." msgstr "" +"Jednak istnieje jedna klasa operacji, w której ta sama operacja może " +"zachowanie się różnie w zależności od typu: operatory przypisanie " +"rozszerzone. Na przykład ``+=`` modyfikuje listy, ale nie krotki lub liczby " +"całkowite (``a_list += [1, 2, 3]`` jest ekwiwalentem ``a_list.extend([1, 2, " +"3])`` i modyfikuje ``a_list``, natomiast ``some_tuple += (1, 2, 3)`` oraz " +"``some_int += 1`` tworzą nowe obiekty)." msgid "In other words:" msgstr "Innymi słowami:" msgid "" -"If we have a mutable object (such as :class:`list`, :class:`dict`, :class:" -"`set`), we can use some specific operations to mutate it and all the " -"variables that refer to it will see the change." +"If we have a mutable object (such " +"as :class:`list`, :class:`dict`, :class:`set`), we can use some specific " +"operations to mutate it and all the variables that refer to it will see the " +"change." msgstr "" +"Jeśli mamy obiekt mutowalny (taki jak 1 :class:`list`, 2 :class:`dict`, " +"3 :class:`set`), możemy wykonać na nim określone operacje modyfikujące, a " +"wszystkie zmienne, które się do niego odnoszą, zobaczą tę zmianę." msgid "" -"If we have an immutable object (such as :class:`str`, :class:`int`, :class:" -"`tuple`), all the variables that refer to it will always see the same value, " -"but operations that transform that value into a new value always return a " -"new object." +"If we have an immutable object (such " +"as :class:`str`, :class:`int`, :class:`tuple`), all the variables that refer " +"to it will always see the same value, but operations that transform that " +"value into a new value always return a new object." msgstr "" msgid "" @@ -853,8 +1018,8 @@ msgid "" msgstr "" msgid "" -"Some objects can be copied more easily. Dictionaries have a :meth:`~dict." -"copy` method::" +"Some objects can be copied more easily. Dictionaries have " +"a :meth:`~dict.copy` method::" msgstr "" msgid "newdict = olddict.copy()" @@ -1143,8 +1308,8 @@ msgid "How do I get int literal attribute instead of SyntaxError?" msgstr "" msgid "" -"Trying to lookup an ``int`` literal attribute in the normal manner gives a :" -"exc:`SyntaxError` because the period is seen as a decimal point::" +"Trying to lookup an ``int`` literal attribute in the normal manner gives " +"a :exc:`SyntaxError` because the period is seen as a decimal point::" msgstr "" msgid "" @@ -1351,10 +1516,10 @@ msgstr "" msgid "" "For simple input parsing, the easiest approach is usually to split the line " "into whitespace-delimited words using the :meth:`~str.split` method of " -"string objects and then convert decimal strings to numeric values using :" -"func:`int` or :func:`float`. :meth:`!split` supports an optional \"sep\" " -"parameter which is useful if the line uses something other than whitespace " -"as a separator." +"string objects and then convert decimal strings to numeric values " +"using :func:`int` or :func:`float`. :meth:`!split` supports an optional " +"\"sep\" parameter which is useful if the line uses something other than " +"whitespace as a separator." msgstr "" msgid "" @@ -1491,9 +1656,9 @@ msgid "" "When the standard library provides a primitive for doing something, it is " "likely (although not guaranteed) to be faster than any alternative you may " "come up with. This is doubly true for primitives written in C, such as " -"builtins and some extension types. For example, be sure to use either the :" -"meth:`list.sort` built-in method or the related :func:`sorted` function to " -"do sorting (and see the :ref:`sortinghowto` for examples of moderately " +"builtins and some extension types. For example, be sure to use either " +"the :meth:`list.sort` built-in method or the related :func:`sorted` function " +"to do sorting (and see the :ref:`sortinghowto` for examples of moderately " "advanced usage)." msgstr "" @@ -1528,7 +1693,8 @@ msgid "" ":class:`str` and :class:`bytes` objects are immutable, therefore " "concatenating many strings together is inefficient as each concatenation " "creates a new object. In the general case, the total runtime cost is " -"quadratic in the total string length." +"quadratic in the total string length. See :ref:`time-complexity` for more " +"information." msgstr "" msgid "" @@ -1642,8 +1808,8 @@ msgid "" msgstr "" msgid "" -"If all elements of the list may be used as set keys (that is, they are all :" -"term:`hashable`) this is often faster::" +"If all elements of the list may be used as set keys (that is, they are " +"all :term:`hashable`) this is often faster::" msgstr "" msgid "mylist = list(set(mylist))" @@ -1777,8 +1943,8 @@ msgid "How do I apply a method or function to a sequence of objects?" msgstr "" msgid "" -"To call a method or function and accumulate the return values in a list, a :" -"term:`list comprehension` is an elegant solution::" +"To call a method or function and accumulate the return values in a list, " +"a :term:`list comprehension` is an elegant solution::" msgstr "" msgid "" @@ -1897,8 +2063,8 @@ msgid "" "augmented assignment is executed, and its return value is what gets used in " "the assignment statement; and (b) for lists, :meth:`!__iadd__` is equivalent " "to calling :meth:`~sequence.extend` on the list and returning the list. " -"That's why we say that for lists, ``+=`` is a \"shorthand\" for :meth:`list." -"extend`::" +"That's why we say that for lists, ``+=`` is a \"shorthand\" " +"for :meth:`list.extend`::" msgstr "" msgid "" @@ -2003,8 +2169,8 @@ msgid "What is a method?" msgstr "Co to jest metoda?" msgid "" -"A method is a function on some object ``x`` that you normally call as ``x." -"name(arguments...)``. Methods are defined as functions inside the class " +"A method is a function on some object ``x`` that you normally call as " +"``x.name(arguments...)``. Methods are defined as functions inside the class " "definition::" msgstr "" @@ -2042,8 +2208,8 @@ msgid "" msgstr "" msgid "" -"Note that :func:`isinstance` also checks for virtual inheritance from an :" -"term:`abstract base class`. So, the test will return ``True`` for a " +"Note that :func:`isinstance` also checks for virtual inheritance from " +"an :term:`abstract base class`. So, the test will return ``True`` for a " "registered class even if hasn't directly or indirectly inherited from it. " "To test for \"true inheritance\", scan the :term:`method resolution order` " "(MRO) of the class:" @@ -2146,18 +2312,18 @@ msgstr "" msgid "" "Here the ``UpperOut`` class redefines the ``write()`` method to convert the " -"argument string to uppercase before calling the underlying ``self._outfile." -"write()`` method. All other methods are delegated to the underlying ``self." -"_outfile`` object. The delegation is accomplished via the :meth:`~object." -"__getattr__` method; consult :ref:`the language reference ` for more information about controlling attribute access." +"argument string to uppercase before calling the underlying " +"``self._outfile.write()`` method. All other methods are delegated to the " +"underlying ``self._outfile`` object. The delegation is accomplished via " +"the :meth:`~object.__getattr__` method; consult :ref:`the language reference " +"` for more information about controlling attribute access." msgstr "" msgid "" "Note that for more general cases delegation can get trickier. When " -"attributes must be set as well as retrieved, the class must define a :meth:" -"`~object.__setattr__` method too, and it must do so carefully. The basic " -"implementation of :meth:`!__setattr__` is roughly equivalent to the " +"attributes must be set as well as retrieved, the class must define " +"a :meth:`~object.__setattr__` method too, and it must do so carefully. The " +"basic implementation of :meth:`!__setattr__` is roughly equivalent to the " "following::" msgstr "" @@ -2170,8 +2336,9 @@ msgid "" msgstr "" msgid "" -"Many :meth:`~object.__setattr__` implementations call :meth:`!object." -"__setattr__` to set an attribute on self without causing infinite recursion::" +"Many :meth:`~object.__setattr__` implementations call :meth:`!" +"object.__setattr__` to set an attribute on self without causing infinite " +"recursion::" msgstr "" msgid "" @@ -2182,8 +2349,8 @@ msgid "" msgstr "" msgid "" -"Alternatively, it is possible to set attributes by inserting entries into :" -"attr:`self.__dict__ ` directly." +"Alternatively, it is possible to set attributes by inserting entries " +"into :attr:`self.__dict__ ` directly." msgstr "" msgid "" @@ -2380,8 +2547,8 @@ msgid "" "The :ref:`private name mangling specifications ` for " "details and special cases." msgstr "" -"Szczegółowe informacje i przypadki specjalne znajdują się w specyfikacji :" -"ref:`private name mangling `." +"Szczegółowe informacje i przypadki specjalne znajdują się w " +"specyfikacji :ref:`private name mangling `." msgid "My class defines __del__ but it is not called when I delete the object." msgstr "" @@ -2390,9 +2557,9 @@ msgid "There are several possible reasons for this." msgstr "" msgid "" -"The :keyword:`del` statement does not necessarily call :meth:`~object." -"__del__` -- it simply decrements the object's reference count, and if this " -"reaches zero :meth:`!__del__` is called." +"The :keyword:`del` statement does not necessarily " +"call :meth:`~object.__del__` -- it simply decrements the object's reference " +"count, and if this reaches zero :meth:`!__del__` is called." msgstr "" msgid "" @@ -2400,12 +2567,12 @@ msgid "" "each child has a parent reference and each parent has a list of children) " "the reference counts will never go back to zero. Once in a while Python " "runs an algorithm to detect such cycles, but the garbage collector might run " -"some time after the last reference to your data structure vanishes, so your :" -"meth:`!__del__` method may be called at an inconvenient and random time. " -"This is inconvenient if you're trying to reproduce a problem. Worse, the " -"order in which object's :meth:`!__del__` methods are executed is arbitrary. " -"You can run :func:`gc.collect` to force a collection, but there *are* " -"pathological cases where objects will never be collected." +"some time after the last reference to your data structure vanishes, so " +"your :meth:`!__del__` method may be called at an inconvenient and random " +"time. This is inconvenient if you're trying to reproduce a problem. Worse, " +"the order in which object's :meth:`!__del__` methods are executed is " +"arbitrary. You can run :func:`gc.collect` to force a collection, but there " +"*are* pathological cases where objects will never be collected." msgstr "" msgid "" @@ -2567,8 +2734,8 @@ msgid "" msgstr "" msgid "" -"For example, here is the implementation of :meth:`!collections.abc.Sequence." -"__contains__`::" +"For example, here is the implementation of :meth:`!" +"collections.abc.Sequence.__contains__`::" msgstr "" msgid "" @@ -2636,9 +2803,10 @@ msgid "How do I cache method calls?" msgstr "" msgid "" -"The two principal tools for caching methods are :func:`functools." -"cached_property` and :func:`functools.lru_cache`. The former stores results " -"at the instance level and the latter at the class level." +"The two principal tools for caching methods " +"are :deco:`functools.cached_property` and :deco:`functools.lru_cache`. The " +"former stores results at the instance level and the latter at the class " +"level." msgstr "" msgid "" @@ -2701,8 +2869,9 @@ msgstr "" msgid "" "To make the ``lru_cache`` approach work when the *station_id* is mutable, " -"the class needs to define the :meth:`~object.__eq__` and :meth:`~object." -"__hash__` methods so that the cache can detect relevant attribute updates::" +"the class needs to define the :meth:`~object.__eq__` " +"and :meth:`~object.__hash__` methods so that the cache can detect relevant " +"attribute updates::" msgstr "" msgid "" @@ -2760,18 +2929,18 @@ msgid "" msgstr "" msgid "" -"Running Python on a top-level script is not considered an import and no ``." -"pyc`` will be created. For example, if you have a top-level module ``foo." -"py`` that imports another module ``xyz.py``, when you run ``foo`` (by typing " -"``python foo.py`` as a shell command), a ``.pyc`` will be created for " +"Running Python on a top-level script is not considered an import and no " +"``.pyc`` will be created. For example, if you have a top-level module " +"``foo.py`` that imports another module ``xyz.py``, when you run ``foo`` (by " +"typing ``python foo.py`` as a shell command), a ``.pyc`` will be created for " "``xyz`` because ``xyz`` is imported, but no ``.pyc`` file will be created " "for ``foo`` since ``foo.py`` isn't being imported." msgstr "" msgid "" -"If you need to create a ``.pyc`` file for ``foo`` -- that is, to create a ``." -"pyc`` file for a module that is not imported -- you can, using the :mod:" -"`py_compile` and :mod:`compileall` modules." +"If you need to create a ``.pyc`` file for ``foo`` -- that is, to create a " +"``.pyc`` file for a module that is not imported -- you can, using " +"the :mod:`py_compile` and :mod:`compileall` modules." msgstr "" msgid "" @@ -2889,11 +3058,11 @@ msgid "There are (at least) three possible workarounds for this problem." msgstr "" msgid "" -"Guido van Rossum recommends avoiding all uses of ``from import ..." -"``, and placing all code inside functions. Initializations of global " -"variables and class variables should use constants or built-in functions " -"only. This means everything from an imported module is referenced as " -"``.``." +"Guido van Rossum recommends avoiding all uses of ``from " +"import ...``, and placing all code inside functions. Initializations of " +"global variables and class variables should use constants or built-in " +"functions only. This means everything from an imported module is referenced " +"as ``.``." msgstr "" msgid "" diff --git a/faq/windows.po b/faq/windows.po index ecc38e7e9a..0779e8a53f 100644 --- a/faq/windows.po +++ b/faq/windows.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -118,19 +118,19 @@ msgstr "" msgid "" "Many people use the interactive mode as a convenient yet highly programmable " -"calculator. When you want to end your interactive Python session, call the :" -"func:`exit` function or hold the :kbd:`Ctrl` key down while you enter a :kbd:" -"`Z`, then hit the \":kbd:`Enter`\" key to get back to your Windows command " -"prompt." +"calculator. When you want to end your interactive Python session, call " +"the :func:`exit` function or hold the :kbd:`Ctrl` key down while you enter " +"a :kbd:`Z`, then hit the \":kbd:`Enter`\" key to get back to your Windows " +"command prompt." msgstr "" msgid "" -"You may also find that you have a Start-menu entry such as :menuselection:" -"`Start --> Programs --> Python 3.x --> Python (command line)` that results " -"in you seeing the ``>>>`` prompt in a new window. If so, the window will " -"disappear after you call the :func:`exit` function or enter the :kbd:`Ctrl-" -"Z` character; Windows is running a single \"python\" command in the window, " -"and closes it when you terminate the interpreter." +"You may also find that you have a Start-menu entry such " +"as :menuselection:`Start --> Programs --> Python 3.x --> Python (command " +"line)` that results in you seeing the ``>>>`` prompt in a new window. If " +"so, the window will disappear after you call the :func:`exit` function or " +"enter the :kbd:`Ctrl-Z` character; Windows is running a single \"python\" " +"command in the window, and closes it when you terminate the interpreter." msgstr "" msgid "" @@ -234,9 +234,10 @@ msgstr "" msgid "" "Do **not** build Python into your .exe file directly. On Windows, Python " "must be a DLL to handle importing modules that are themselves DLL's. (This " -"is the first key undocumented fact.) Instead, link to :file:`python{NN}." -"dll`; it is typically installed in ``C:\\Windows\\System``. *NN* is the " -"Python version, a number such as \"33\" for Python 3.3." +"is the first key undocumented fact.) Instead, link " +"to :file:`python{NN}.dll`; it is typically installed in ``C:" +"\\Windows\\System``. *NN* is the Python version, a number such as \"33\" " +"for Python 3.3." msgstr "" msgid "" @@ -359,16 +360,16 @@ msgstr "" msgid "" "Under any editor, mixing tabs and spaces is a bad idea. MSVC is no " -"different in this respect, and is easily configured to use spaces: Take :" -"menuselection:`Tools --> Options --> Tabs`, and for file type \"Default\" " -"set \"Tab size\" and \"Indent size\" to 4, and select the \"Insert spaces\" " -"radio button." +"different in this respect, and is easily configured to use spaces: " +"Take :menuselection:`Tools --> Options --> Tabs`, and for file type " +"\"Default\" set \"Tab size\" and \"Indent size\" to 4, and select the " +"\"Insert spaces\" radio button." msgstr "" msgid "" "Python raises :exc:`IndentationError` or :exc:`TabError` if mixed tabs and " -"spaces are causing problems in leading whitespace. You may also run the :mod:" -"`tabnanny` module to check a directory tree in batch mode." +"spaces are causing problems in leading whitespace. You may also run " +"the :mod:`tabnanny` module to check a directory tree in batch mode." msgstr "" msgid "How do I check for a keypress without blocking?" diff --git a/glossary.po b/glossary.po index 7b8ddd9c3b..6d580be7ef 100644 --- a/glossary.po +++ b/glossary.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,6 +34,9 @@ msgid "" "The default Python prompt of the :term:`interactive` shell. Often seen for " "code examples which can be executed interactively in the interpreter." msgstr "" +"Domyślny znak zachęty powłoki :term:`interaktywnej ` w języku " +"Python. Często spotykane w przypadku przykładów kodu, które mogą być " +"wykonywane w interpreterze." msgid "``...``" msgstr "``...``" @@ -46,10 +50,14 @@ msgid "" "right delimiters (parentheses, square brackets, curly braces or triple " "quotes), or after specifying a decorator." msgstr "" +"Domyślnego znaku zachęty powłoki :term:`interaktywnej ` Pythona " +"przy wpisywaniu kodu wciętego bloku, wewnątrz pary odpowiadających sobie " +"ograniczników (nawiasów, nawiasów kwadratowych, nawiasów klamrowych lub " +"potrójnych cudzysłowów) lub po użyciu dekoratora." msgid "" "The three dots form of the :ref:`Ellipsis ` object." -msgstr "" +msgstr "Formy obiektu :ref:`Ellipsis `." msgid "abstract base class" msgstr "abstrakcyjna klasa bazowa" @@ -59,23 +67,36 @@ msgid "" "define interfaces when other techniques like :func:`hasattr` would be clumsy " "or subtly wrong (for example with :ref:`magic methods `). " "ABCs introduce virtual subclasses, which are classes that don't inherit from " -"a class but are still recognized by :func:`isinstance` and :func:" -"`issubclass`; see the :mod:`abc` module documentation. Python comes with " -"many built-in ABCs for data structures (in the :mod:`collections.abc` " -"module), numbers (in the :mod:`numbers` module), streams (in the :mod:`io` " -"module), import finders and loaders (in the :mod:`importlib.abc` module). " -"You can create your own ABCs with the :mod:`abc` module." -msgstr "" +"a class but are still recognized by :func:`isinstance` " +"and :func:`issubclass`; see the :mod:`abc` module documentation. Python " +"comes with many built-in ABCs for data structures (in " +"the :mod:`collections.abc` module), numbers (in the :mod:`numbers` module), " +"streams (in the :mod:`io` module), import finders and loaders (in " +"the :mod:`importlib.abc` module). You can create your own ABCs with " +"the :mod:`abc` module." +msgstr "" +"Abstrakcyjne klasy bazowe uzupełniają :term:`duck-typing`, oferując sposób " +"definiowania interfejsów w sytuacjach, gdy inne techniki, takie " +"jak :func:`hasattr`, byłyby nieporęczne lub nieco błędne (na przykład w " +"przypadku :ref:`magicznych metod ` ). Abstrakcyjne klasy " +"bazowe wprowadzają wirtualne podklasy, czyli klasy, które nie dziedziczą po " +"żadnej klasie, ale są nadal rozpoznawane przez :func:`isinstance` " +"i :func:`issubclass`; zobacz dokumentację modułu :mod:`abc`. Python zawiera " +"wiele wbudowanych abstrakcyjnych klas bazowych dla struktur danych (w " +"module :mod:`collections.abc`), liczb (w module :mod:`numbers`), strumieni " +"(w module :mod:`io`), wyszukiwarek i loaderów importów (w " +"module :mod:`importlib.abc`). Możesz stworzyć własną abstrakcyjną klasę " +"bazową za pomocą modułu :mod:`abc`." msgid "annotate function" msgstr "" msgid "" -"A function that can be called to retrieve the :term:`annotations " -"` of an object. This function is accessible as the :attr:" -"`~object.__annotate__` attribute of functions, classes, and modules. " -"Annotate functions are a subset of :term:`evaluate functions `." +"A callable that can be called to retrieve the :term:`annotations " +"` of an object. Annotate functions are usually :term:`functions " +"`, automatically generated as the :attr:`~object.__annotate__` " +"attribute of functions, classes, and modules. Annotate functions are a " +"subset of :term:`evaluate functions `." msgstr "" msgid "annotation" @@ -96,9 +117,10 @@ msgid "" msgstr "" msgid "" -"See :term:`variable annotation`, :term:`function annotation`, :pep:`484`, :" -"pep:`526`, and :pep:`649`, which describe this functionality. Also see :ref:" -"`annotations-howto` for best practices on working with annotations." +"See :term:`variable annotation`, :term:`function " +"annotation`, :pep:`484`, :pep:`526`, and :pep:`649`, which describe this " +"functionality. Also see :ref:`annotations-howto` for best practices on " +"working with annotations." msgstr "" msgid "argument" @@ -151,24 +173,29 @@ msgstr "" msgid "" "An object which controls the environment seen in an :keyword:`async with` " -"statement by defining :meth:`~object.__aenter__` and :meth:`~object." -"__aexit__` methods. Introduced by :pep:`492`." +"statement by defining :meth:`~object.__aenter__` " +"and :meth:`~object.__aexit__` methods. Introduced by :pep:`492`." msgstr "" msgid "asynchronous generator" msgstr "" msgid "" -"A function which returns an :term:`asynchronous generator iterator`. It " -"looks like a coroutine function defined with :keyword:`async def` except " -"that it contains :keyword:`yield` expressions for producing a series of " -"values usable in an :keyword:`async for` loop." +"Informally used to mean either an :term:`asynchronous generator function` or " +"an :term:`asynchronous generator iterator`, depending on context. The " +"formal terms :term:`asynchronous generator function` and :term:`asynchronous " +"generator iterator` are uncommon in practice; \"asynchronous generator\" " +"alone is almost always sufficient." +msgstr "" + +msgid "asynchronous generator function" msgstr "" msgid "" -"Usually refers to an asynchronous generator function, but may refer to an " -"*asynchronous generator iterator* in some contexts. In cases where the " -"intended meaning isn't clear, using the full terms avoids ambiguity." +"A function which returns an :term:`asynchronous generator iterator`. It " +"looks like a coroutine function defined with :keyword:`async def` except " +"that it contains :keyword:`yield` expressions for producing a series of " +"values usable in an :keyword:`async for` loop. See :pep:`525`." msgstr "" msgid "" @@ -179,14 +206,14 @@ msgstr "" msgid "asynchronous generator iterator" msgstr "" -msgid "An object created by an :term:`asynchronous generator` function." +msgid "An object created by an :term:`asynchronous generator function`." msgstr "" msgid "" -"This is an :term:`asynchronous iterator` which when called using the :meth:" -"`~object.__anext__` method returns an awaitable object which will execute " -"the body of the asynchronous generator function until the next :keyword:" -"`yield` expression." +"This is an :term:`asynchronous iterator` which when called using " +"the :meth:`~object.__anext__` method returns an awaitable object which will " +"execute the body of the asynchronous generator function until the " +"next :keyword:`yield` expression." msgstr "" msgid "" @@ -210,11 +237,12 @@ msgid "asynchronous iterator" msgstr "" msgid "" -"An object that implements the :meth:`~object.__aiter__` and :meth:`~object." -"__anext__` methods. :meth:`~object.__anext__` must return an :term:" -"`awaitable` object. :keyword:`async for` resolves the awaitables returned by " -"an asynchronous iterator's :meth:`~object.__anext__` method until it raises " -"a :exc:`StopAsyncIteration` exception. Introduced by :pep:`492`." +"An object that implements the :meth:`~object.__aiter__` " +"and :meth:`~object.__anext__` methods. :meth:`~object.__anext__` must " +"return an :term:`awaitable` object. :keyword:`async for` resolves the " +"awaitables returned by an asynchronous iterator's :meth:`~object.__anext__` " +"method until it raises a :exc:`StopAsyncIteration` exception. Introduced " +"by :pep:`492`." msgstr "" msgid "atomic operation" @@ -268,27 +296,27 @@ msgstr "" msgid "" "It is possible to give an object an attribute whose name is not an " -"identifier as defined by :ref:`identifiers`, for example using :func:" -"`setattr`, if the object allows it. Such an attribute will not be accessible " -"using a dotted expression, and would instead need to be retrieved with :func:" -"`getattr`." +"identifier as defined by :ref:`identifiers`, for example " +"using :func:`setattr`, if the object allows it. Such an attribute will not " +"be accessible using a dotted expression, and would instead need to be " +"retrieved with :func:`getattr`." msgstr "" msgid "awaitable" msgstr "" msgid "" -"An object that can be used in an :keyword:`await` expression. Can be a :" -"term:`coroutine` or an object with an :meth:`~object.__await__` method. See " -"also :pep:`492`." +"An object that can be used in an :keyword:`await` expression. Can be " +"a :term:`coroutine` or an object with an :meth:`~object.__await__` method. " +"See also :pep:`492`." msgstr "" msgid "BDFL" msgstr "BDFL" msgid "" -"Benevolent Dictator For Life, a.k.a. `Guido van Rossum `_, Python's creator." +"Benevolent Dictator For Life, a.k.a. `Guido van Rossum `_, Python's creator." msgstr "" msgid "binary file" @@ -297,14 +325,14 @@ msgstr "plik binarny" msgid "" "A :term:`file object` able to read and write :term:`bytes-like objects " "`. Examples of binary files are files opened in binary " -"mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer `, :data:`sys.stdout.buffer `, and instances of :class:`io." -"BytesIO` and :class:`gzip.GzipFile`." +"mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer " +"`, :data:`sys.stdout.buffer `, and instances " +"of :class:`io.BytesIO` and :class:`gzip.GzipFile`." msgstr "" msgid "" -"See also :term:`text file` for a file object able to read and write :class:" -"`str` objects." +"See also :term:`text file` for a file object able to read and " +"write :class:`str` objects." msgstr "" msgid "borrowed reference" @@ -320,8 +348,8 @@ msgstr "" msgid "" "Calling :c:func:`Py_INCREF` on the :term:`borrowed reference` is recommended " "to convert it to a :term:`strong reference` in-place, except when the object " -"cannot be destroyed before the last usage of the borrowed reference. The :c:" -"func:`Py_NewRef` function can be used to create a new :term:`strong " +"cannot be destroyed before the last usage of the borrowed reference. " +"The :c:func:`Py_NewRef` function can be used to create a new :term:`strong " "reference`." msgstr "" @@ -329,20 +357,20 @@ msgid "bytes-like object" msgstr "" msgid "" -"An object that supports the :ref:`bufferobjects` and can export a C-:term:" -"`contiguous` buffer. This includes all :class:`bytes`, :class:`bytearray`, " -"and :class:`array.array` objects, as well as many common :class:`memoryview` " -"objects. Bytes-like objects can be used for various operations that work " -"with binary data; these include compression, saving to a binary file, and " -"sending over a socket." +"An object that supports the :ref:`bufferobjects` and can export a " +"C-:term:`contiguous` buffer. This includes " +"all :class:`bytes`, :class:`bytearray`, and :class:`array.array` objects, as " +"well as many common :class:`memoryview` objects. Bytes-like objects can be " +"used for various operations that work with binary data; these include " +"compression, saving to a binary file, and sending over a socket." msgstr "" msgid "" "Some operations need the binary data to be mutable. The documentation often " "refers to these as \"read-write bytes-like objects\". Example mutable " -"buffer objects include :class:`bytearray` and a :class:`memoryview` of a :" -"class:`bytearray`. Other operations require the binary data to be stored in " -"immutable objects (\"read-only bytes-like objects\"); examples of these " +"buffer objects include :class:`bytearray` and a :class:`memoryview` of " +"a :class:`bytearray`. Other operations require the binary data to be stored " +"in immutable objects (\"read-only bytes-like objects\"); examples of these " "include :class:`bytes` and a :class:`memoryview` of a :class:`bytes` object." msgstr "" @@ -361,8 +389,8 @@ msgid "" msgstr "" msgid "" -"A list of bytecode instructions can be found in the documentation for :ref:" -"`the dis module `." +"A list of bytecode instructions can be found in the documentation " +"for :ref:`the dis module `." msgstr "" msgid "callable" @@ -412,9 +440,9 @@ msgstr "" msgid "" "A :term:`free variable` referenced from a :term:`nested scope` that is " "defined in an outer scope rather than being resolved at runtime from the " -"globals or builtin namespaces. May be explicitly defined with the :keyword:" -"`nonlocal` keyword to allow write access, or implicitly defined if the " -"variable is only being read." +"globals or builtin namespaces. May be explicitly defined with " +"the :keyword:`nonlocal` keyword to allow write access, or implicitly defined " +"if the variable is only being read." msgstr "" msgid "" @@ -500,9 +528,10 @@ msgid "" msgstr "" msgid "" -"The collection of key­value bindings associated with a particular :class:" -"`contextvars.Context` object and accessed via :class:`~contextvars." -"ContextVar` objects. Also see :term:`context variable`." +"The collection of key­value bindings associated with a " +"particular :class:`contextvars.Context` object and accessed " +"via :class:`~contextvars.ContextVar` objects. Also see :term:`context " +"variable`." msgstr "" msgid "" @@ -522,8 +551,8 @@ msgstr "" msgid "" "An object which implements the :term:`context management protocol` and " -"controls the environment seen in a :keyword:`with` statement. See :pep:" -"`343`." +"controls the environment seen in a :keyword:`with` statement. " +"See :pep:`343`." msgstr "" msgid "context variable" @@ -564,9 +593,9 @@ msgstr "" msgid "" "A function which returns a :term:`coroutine` object. A coroutine function " -"may be defined with the :keyword:`async def` statement, and may contain :" -"keyword:`await`, :keyword:`async for`, and :keyword:`async with` keywords. " -"These were introduced by :pep:`492`." +"may be defined with the :keyword:`async def` statement, and may " +"contain :keyword:`await`, :keyword:`async for`, and :keyword:`async with` " +"keywords. These were introduced by :pep:`492`." msgstr "" msgid "CPython" @@ -586,9 +615,9 @@ msgid "" "The :term:`context` (:class:`contextvars.Context` object) that is currently " "used by :class:`~contextvars.ContextVar` objects to access (get or set) the " "values of :term:`context variables `. Each thread has its " -"own current context. Frameworks for executing asynchronous tasks (see :mod:" -"`asyncio`) associate each task with a context which becomes the current " -"context whenever the task starts or resumes execution." +"own current context. Frameworks for executing asynchronous tasks " +"(see :mod:`asyncio`) associate each task with a context which becomes the " +"current context whenever the task starts or resumes execution." msgstr "" msgid "cyclic isolate" @@ -608,9 +637,9 @@ msgstr "" msgid "" "A situation where multiple threads access the same memory location " "concurrently, at least one of the accesses is a write, and the threads do " -"not use any synchronization to control their access. Data races lead to :" -"term:`non-deterministic` behavior and can cause data corruption. Proper use " -"of :term:`locks ` and other :term:`synchronization primitives " +"not use any synchronization to control their access. Data races lead " +"to :term:`non-deterministic` behavior and can cause data corruption. Proper " +"use of :term:`locks ` and other :term:`synchronization primitives " "` prevents data races. Note that data races can " "only happen in native code, but that :term:`native code` might be exposed in " "a Python API. See also :term:`race condition` and :term:`thread-safe`." @@ -626,9 +655,9 @@ msgid "" "and waits for lock 2, while thread B holds lock 2 and waits for lock 1, both " "threads will wait indefinitely. In Python this often arises from acquiring " "multiple locks in conflicting orders or from circular join/await " -"dependencies. Deadlocks can be avoided by always acquiring multiple :term:" -"`locks ` in a consistent order. See also :term:`lock` and :term:" -"`reentrant`." +"dependencies. Deadlocks can be avoided by always acquiring " +"multiple :term:`locks ` in a consistent order. See also :term:`lock` " +"and :term:`reentrant`." msgstr "" msgid "decorator" @@ -637,7 +666,7 @@ msgstr "dekorator" msgid "" "A function returning another function, usually applied as a function " "transformation using the ``@wrapper`` syntax. Common examples for " -"decorators are :func:`classmethod` and :func:`staticmethod`." +"decorators are :deco:`classmethod` and :deco:`staticmethod`." msgstr "" msgid "" @@ -665,15 +694,16 @@ msgid "descriptor" msgstr "deskryptor" msgid "" -"Any object which defines the methods :meth:`~object.__get__`, :meth:`~object." -"__set__`, or :meth:`~object.__delete__`. When a class attribute is a " -"descriptor, its special binding behavior is triggered upon attribute " -"lookup. Normally, using *a.b* to get, set or delete an attribute looks up " -"the object named *b* in the class dictionary for *a*, but if *b* is a " -"descriptor, the respective descriptor method gets called. Understanding " -"descriptors is a key to a deep understanding of Python because they are the " -"basis for many features including functions, methods, properties, class " -"methods, static methods, and reference to super classes." +"Any object which defines the " +"methods :meth:`~object.__get__`, :meth:`~object.__set__`, " +"or :meth:`~object.__delete__`. When a class attribute is a descriptor, its " +"special binding behavior is triggered upon attribute lookup. Normally, " +"using *a.b* to get, set or delete an attribute looks up the object named *b* " +"in the class dictionary for *a*, but if *b* is a descriptor, the respective " +"descriptor method gets called. Understanding descriptors is a key to a deep " +"understanding of Python because they are the basis for many features " +"including functions, methods, properties, class methods, static methods, and " +"reference to super classes." msgstr "" msgid "" @@ -704,11 +734,11 @@ msgid "dictionary view" msgstr "" msgid "" -"The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and :meth:" -"`dict.items` are called dictionary views. They provide a dynamic view on the " -"dictionary’s entries, which means that when the dictionary changes, the view " -"reflects these changes. To force the dictionary view to become a full list " -"use ``list(dictview)``. See :ref:`dict-views`." +"The objects returned from :meth:`dict.keys`, :meth:`dict.values`, " +"and :meth:`dict.items` are called dictionary views. They provide a dynamic " +"view on the dictionary’s entries, which means that when the dictionary " +"changes, the view reflects these changes. To force the dictionary view to " +"become a full list use ``list(dictview)``. See :ref:`dict-views`." msgstr "" msgid "docstring" @@ -731,18 +761,18 @@ msgid "" "called or used (\"If it looks like a duck and quacks like a duck, it must be " "a duck.\") By emphasizing interfaces rather than specific types, well-" "designed code improves its flexibility by allowing polymorphic " -"substitution. Duck-typing avoids tests using :func:`type` or :func:" -"`isinstance`. (Note, however, that duck-typing can be complemented with :" -"term:`abstract base classes `.) Instead, it typically " -"employs :func:`hasattr` tests or :term:`EAFP` programming." +"substitution. Duck-typing avoids tests using :func:`type` " +"or :func:`isinstance`. (Note, however, that duck-typing can be complemented " +"with :term:`abstract base classes `.) Instead, it " +"typically employs :func:`hasattr` tests or :term:`EAFP` programming." msgstr "" msgid "dunder" msgstr "" msgid "" -"An informal short-hand for \"double underscore\", used when talking about a :" -"term:`special method`. For example, ``__init__`` is often pronounced " +"An informal short-hand for \"double underscore\", used when talking about " +"a :term:`special method`. For example, ``__init__`` is often pronounced " "\"dunder init\"." msgstr "" @@ -767,17 +797,27 @@ msgid "" "statement." msgstr "" +msgid "exhausted" +msgstr "" + +msgid "" +"An :term:`iterator` that has produced all of its values is said to " +"be :dfn:`exhausted`. Further attempts to get the next value (for example, " +"calls to :func:`next`) raise :exc:`StopIteration` " +"(or :exc:`StopAsyncIteration` in the case of an :term:`asynchronous " +"iterator`)." +msgstr "" + msgid "expression" msgstr "wyrażenie" msgid "" "A piece of syntax which can be evaluated to some value. In other words, an " "expression is an accumulation of expression elements like literals, names, " -"attribute access, operators or function calls which all return a value. In " -"contrast to many other languages, not all language constructs are " -"expressions. There are also :term:`statement`\\s which cannot be used as " -"expressions, such as :keyword:`while`. Assignments are also statements, not " -"expressions." +"attribute access, operators or function calls which all return a value. Not " +"all language constructs are expressions. There are " +"also :term:`statement`\\s which cannot be used as expressions, such " +"as :keyword:`while`. Assignments are also statements, not expressions." msgstr "" msgid "extension module" @@ -841,16 +881,16 @@ msgid "" msgstr "" msgid "" -"The :func:`sys.getfilesystemencoding` and :func:`sys." -"getfilesystemencodeerrors` functions can be used to get the filesystem " -"encoding and error handler." +"The :func:`sys.getfilesystemencoding` " +"and :func:`sys.getfilesystemencodeerrors` functions can be used to get the " +"filesystem encoding and error handler." msgstr "" msgid "" "The :term:`filesystem encoding and error handler` are configured at Python " -"startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig." -"filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :" -"c:type:`PyConfig`." +"startup by the :c:func:`PyConfig_Read` function: " +"see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid "See also the :term:`locale encoding`." @@ -890,8 +930,8 @@ msgstr "" msgid "" "A threading model where multiple threads can run Python bytecode " -"simultaneously within the same interpreter. This is in contrast to the :" -"term:`global interpreter lock` which allows only one thread to execute " +"simultaneously within the same interpreter. This is in contrast to " +"the :term:`global interpreter lock` which allows only one thread to execute " "Python bytecode at a time. See :pep:`703`." msgstr "" @@ -924,8 +964,8 @@ msgstr "funkcja" msgid "" "A series of statements which returns some value to a caller. It can also be " "passed zero or more :term:`arguments ` which may be used in the " -"execution of the body. See also :term:`parameter`, :term:`method`, and the :" -"ref:`function` section." +"execution of the body. See also :term:`parameter`, :term:`method`, and " +"the :ref:`function` section." msgstr "" msgid "function annotation" @@ -960,8 +1000,8 @@ msgstr "__future__" msgid "" "A :ref:`future statement `, ``from __future__ import ``, " "directs the compiler to compile the current module using syntax or semantics " -"that will become standard in a future release of Python. The :mod:" -"`__future__` module documents the possible values of *feature*. By " +"that will become standard in a future release of Python. " +"The :mod:`__future__` module documents the possible values of *feature*. By " "importing this module and evaluating its variables, you can see when a new " "feature was first added to the language and when it will (or did) become the " "default::" @@ -990,29 +1030,42 @@ msgid "generator" msgstr "generator" msgid "" -"A function which returns a :term:`generator iterator`. It looks like a " -"normal function except that it contains :keyword:`yield` expressions for " -"producing a series of values usable in a for-loop or that can be retrieved " -"one at a time with the :func:`next` function." +"Informally used to mean either a :term:`generator function` or " +"a :term:`generator iterator`, depending on context. The formal " +"terms :term:`generator function` and :term:`generator iterator` are uncommon " +"in practice; \"generator\" alone is almost always sufficient." +msgstr "" + +msgid "generator function" msgstr "" msgid "" -"Usually refers to a generator function, but may refer to a *generator " -"iterator* in some contexts. In cases where the intended meaning isn't " -"clear, using the full terms avoids ambiguity." +"A function which returns a :term:`generator` object. It looks like a normal " +"function except that it contains :keyword:`yield` expressions for producing " +"a series of values usable in a :keyword:`for`\\-loop or that can be " +"retrieved one at a time with the :func:`next` function. See :ref:`yieldexpr`." msgstr "" msgid "generator iterator" msgstr "" -msgid "An object created by a :term:`generator` function." +msgid "" +"An object created by a :term:`generator function` or a :term:`generator " +"expression`." msgstr "" msgid "" "Each :keyword:`yield` temporarily suspends processing, remembering the " -"execution state (including local variables and pending try-statements). " -"When the *generator iterator* resumes, it picks up where it left off (in " -"contrast to functions which start fresh on every invocation)." +"execution state (including local variables and pending try-statements). When " +"the *generator iterator* resumes, it picks up where it left off (in contrast " +"to functions which start fresh on every invocation)." +msgstr "" + +msgid "" +"Generator iterators also implement the :meth:`~generator.send` method to " +"send a value into the suspended generator, and the :meth:`~generator.throw` " +"method to raise an exception at the point where the generator was paused. " +"See :ref:`generator-methods`." msgstr "" msgid "generator expression" @@ -1040,8 +1093,8 @@ msgid "" msgstr "" msgid "" -"See also the :term:`single dispatch` glossary entry, the :func:`functools." -"singledispatch` decorator, and :pep:`443`." +"See also the :term:`single dispatch` glossary entry, " +"the :deco:`functools.singledispatch` decorator, and :pep:`443`." msgstr "" msgid "generic type" @@ -1049,13 +1102,14 @@ msgstr "" msgid "" "A :term:`type` that can be parameterized; typically a :ref:`container " -"class` such as :class:`list` or :class:`dict`. Used for :" -"term:`type hints ` and :term:`annotations `." +"class` such as :class:`list` or :class:`dict`. Used " +"for :term:`type hints ` and :term:`annotations `." msgstr "" msgid "" -"For more details, see :ref:`generic alias types`, :pep:" -"`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` module." +"For more details, see :ref:`generic alias types`, :pep:`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` " +"module." msgstr "" msgid "GIL" @@ -1086,17 +1140,15 @@ msgstr "" msgid "" "As of Python 3.13, the GIL can be disabled using the :option:`--disable-gil` " -"build configuration. After building Python with this option, code must be " -"run with :option:`-X gil=0 <-X>` or after setting the :envvar:`PYTHON_GIL=0 " -"` environment variable. This feature enables improved " -"performance for multi-threaded applications and makes it easier to use multi-" -"core CPUs efficiently. For more details, see :pep:`703`." +"build configuration. This feature enables improved performance for multi-" +"threaded applications and makes it easier to use multi-core CPUs " +"efficiently. For more details, see :pep:`703`." msgstr "" msgid "" "In prior versions of Python's C API, a function might declare that it " -"requires the GIL to be held in order to use it. This refers to having an :" -"term:`attached thread state`." +"requires the GIL to be held in order to use it. This refers to having " +"an :term:`attached thread state`." msgstr "" msgid "global state" @@ -1106,8 +1158,9 @@ msgid "" "Data that is accessible throughout a program, such as module-level " "variables, class variables, or C static variables in :term:`extension " "modules `. In multi-threaded programs, global state " -"shared between threads typically requires synchronization to avoid :term:" -"`race conditions ` and :term:`data races `." +"shared between threads typically requires synchronization to " +"avoid :term:`race conditions ` and :term:`data races `." msgstr "" msgid "hash-based pyc" @@ -1156,8 +1209,8 @@ msgid "immortal" msgstr "nieśmiertelne" msgid "" -"*Immortal objects* are a CPython implementation detail introduced in :pep:" -"`683`." +"*Immortal objects* are a CPython implementation detail introduced " +"in :pep:`683`." msgstr "" msgid "" @@ -1167,8 +1220,8 @@ msgid "" msgstr "" msgid "" -"Immortal objects can be identified via :func:`sys._is_immortal`, or via :c:" -"func:`PyUnstable_IsImmortal` in the C API." +"Immortal objects can be identified via :func:`sys._is_immortal`, or " +"via :c:func:`PyUnstable_IsImmortal` in the C API." msgstr "" msgid "immutable" @@ -1206,16 +1259,16 @@ msgid "importer" msgstr "importer" msgid "" -"An object that both finds and loads a module; both a :term:`finder` and :" -"term:`loader` object." +"An object that both finds and loads a module; both a :term:`finder` " +"and :term:`loader` object." msgstr "" msgid "index" msgstr "" msgid "" -"A numeric value that represents the position of an element in a :term:" -"`sequence`." +"A numeric value that represents the position of an element in " +"a :term:`sequence`." msgstr "" msgid "" @@ -1261,12 +1314,12 @@ msgstr "" msgid "" "When asked to shut down, the Python interpreter enters a special phase where " "it gradually releases all allocated resources, such as modules and various " -"critical internal structures. It also makes several calls to the :term:" -"`garbage collector `. This can trigger the execution of " -"code in user-defined destructors or weakref callbacks. Code executed during " -"the shutdown phase can encounter various exceptions as the resources it " -"relies on may not function anymore (common examples are library modules or " -"the warnings machinery)." +"critical internal structures. It also makes several calls to " +"the :term:`garbage collector `. This can trigger the " +"execution of code in user-defined destructors or weakref callbacks. Code " +"executed during the shutdown phase can encounter various exceptions as the " +"resources it relies on may not function anymore (common examples are library " +"modules or the warnings machinery)." msgstr "" msgid "" @@ -1280,60 +1333,63 @@ msgstr "" msgid "" "An object capable of returning its members one at a time. Examples of " "iterables include all sequence types (such as :class:`list`, :class:`str`, " -"and :class:`tuple`) and some non-sequence types like :class:`dict`, :term:" -"`file objects `, and objects of any classes you define with an :" -"meth:`~object.__iter__` method or with a :meth:`~object.__getitem__` method " -"that implements :term:`sequence` semantics." +"and :class:`tuple`) and some non-sequence types " +"like :class:`dict`, :term:`file objects `, and objects of any " +"classes you define with an :meth:`~object.__iter__` method or with " +"a :meth:`~object.__getitem__` method that implements :term:`sequence` " +"semantics." msgstr "" msgid "" "Iterables can be used in a :keyword:`for` loop and in many other places " "where a sequence is needed (:func:`zip`, :func:`map`, ...). When an " -"iterable object is passed as an argument to the built-in function :func:" -"`iter`, it returns an iterator for the object. This iterator is good for " -"one pass over the set of values. When using iterables, it is usually not " -"necessary to call :func:`iter` or deal with iterator objects yourself. The :" -"keyword:`for` statement does that automatically for you, creating a " -"temporary unnamed variable to hold the iterator for the duration of the " -"loop. See also :term:`iterator`, :term:`sequence`, and :term:`generator`." +"iterable object is passed as an argument to the built-in " +"function :func:`iter`, it returns an iterator for the object. This iterator " +"is good for one pass over the set of values. When using iterables, it is " +"usually not necessary to call :func:`iter` or deal with iterator objects " +"yourself. The :keyword:`for` statement does that automatically for you, " +"creating a temporary unnamed variable to hold the iterator for the duration " +"of the loop. See also :term:`iterator`, :term:`sequence`, " +"and :term:`generator`." msgstr "" msgid "iterator" msgstr "iterator" msgid "" -"An object representing a stream of data. Repeated calls to the iterator's :" -"meth:`~iterator.__next__` method (or passing it to the built-in function :" -"func:`next`) return successive items in the stream. When no more data are " -"available a :exc:`StopIteration` exception is raised instead. At this " -"point, the iterator object is exhausted and any further calls to its :meth:`!" -"__next__` method just raise :exc:`StopIteration` again. Iterators are " -"required to have an :meth:`~iterator.__iter__` method that returns the " -"iterator object itself so every iterator is also iterable and may be used in " -"most places where other iterables are accepted. One notable exception is " -"code which attempts multiple iteration passes. A container object (such as " -"a :class:`list`) produces a fresh new iterator each time you pass it to the :" -"func:`iter` function or use it in a :keyword:`for` loop. Attempting this " -"with an iterator will just return the same exhausted iterator object used in " -"the previous iteration pass, making it appear like an empty container." +"An object representing a stream of data. Repeated calls to the " +"iterator's :meth:`~iterator.__next__` method (or passing it to the built-in " +"function :func:`next`) return successive items in the stream. When no more " +"data are available a :exc:`StopIteration` exception is raised instead. At " +"this point, the iterator object is :term:`exhausted` and any further calls " +"to its :meth:`!__next__` method just raise :exc:`StopIteration` again. " +"Iterators are required to have an :meth:`~iterator.__iter__` method that " +"returns the iterator object itself so every iterator is also iterable and " +"may be used in most places where other iterables are accepted. One notable " +"exception is code which attempts multiple iteration passes. A container " +"object (such as a :class:`list`) produces a fresh new iterator each time you " +"pass it to the :func:`iter` function or use it in a :keyword:`for` loop. " +"Attempting this with an iterator will just return the same exhausted " +"iterator object used in the previous iteration pass, making it appear like " +"an empty container." msgstr "" msgid "More information can be found in :ref:`typeiter`." msgstr "" msgid "" -"CPython does not consistently apply the requirement that an iterator define :" -"meth:`~iterator.__iter__`. And also please note that :term:`free-threaded " -"` CPython does not guarantee :term:`thread-safe` behavior of " -"iterator operations." +"CPython does not consistently apply the requirement that an iterator " +"define :meth:`~iterator.__iter__`. And also please note that :term:`free-" +"threaded ` CPython does not guarantee :term:`thread-safe` " +"behavior of iterator operations." msgstr "" msgid "key" msgstr "" msgid "" -"A value that identifies an entry in a :term:`mapping`. See also :term:" -"`subscript`." +"A value that identifies an entry in a :term:`mapping`. See " +"also :term:`subscript`." msgstr "" msgid "key function" @@ -1347,19 +1403,20 @@ msgstr "" msgid "" "A number of tools in Python accept key functions to control how elements are " -"ordered or grouped. They include :func:`min`, :func:`max`, :func:`sorted`, :" -"meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq." -"nlargest`, and :func:`itertools.groupby`." +"ordered or grouped. They " +"include :func:`min`, :func:`max`, :func:`sorted`, :meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq.nlargest`, " +"and :func:`itertools.groupby`." msgstr "" msgid "" -"There are several ways to create a key function. For example. the :meth:" -"`str.casefold` method can serve as a key function for case insensitive " -"sorts. Alternatively, a key function can be built from a :keyword:`lambda` " -"expression such as ``lambda r: (r[0], r[2])``. Also, :func:`operator." -"attrgetter`, :func:`operator.itemgetter`, and :func:`operator.methodcaller` " -"are three key function constructors. See the :ref:`Sorting HOW TO " -"` for examples of how to create and use key functions." +"There are several ways to create a key function. For example. " +"the :meth:`str.casefold` method can serve as a key function for case " +"insensitive sorts. Alternatively, a key function can be built from " +"a :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. " +"Also, :func:`operator.attrgetter`, :func:`operator.itemgetter`, " +"and :func:`operator.methodcaller` are three key function constructors. See " +"the :ref:`Sorting HOW TO ` for examples of how to create and " +"use key functions." msgstr "" msgid "keyword argument" @@ -1388,12 +1445,12 @@ msgid "" msgstr "" msgid "" -"In a multi-threaded environment, the LBYL approach can risk introducing a :" -"term:`race condition` between \"the looking\" and \"the leaping\". For " +"In a multi-threaded environment, the LBYL approach can risk introducing " +"a :term:`race condition` between \"the looking\" and \"the leaping\". For " "example, the code, ``if key in mapping: return mapping[key]`` can fail if " "another thread removes *key* from *mapping* after the test, but before the " -"lookup. This issue can be solved with :term:`locks ` or by using the :" -"term:`EAFP` approach. See also :term:`thread-safe`." +"lookup. This issue can be solved with :term:`locks ` or by using " +"the :term:`EAFP` approach. See also :term:`thread-safe`." msgstr "" msgid "lexical analyzer" @@ -1408,7 +1465,7 @@ msgstr "lista" msgid "" "A built-in Python :term:`sequence`. Despite its name it is more akin to an " "array in other languages than to a linked list since access to elements is " -"*O*\\ (1)." +"*O*\\ (1). See :ref:`time-complexity`." msgstr "" msgid "list comprehension" @@ -1430,13 +1487,13 @@ msgid "" "access a shared resource. A thread must acquire a lock before accessing the " "protected resource and release it afterward. If a thread attempts to " "acquire a lock that is already held by another thread, it will block until " -"the lock becomes available. Python's :mod:`threading` module provides :" -"class:`~threading.Lock` (a basic lock) and :class:`~threading.RLock` (a :" -"term:`reentrant` lock). Locks are used to prevent :term:`race conditions " -"` and ensure :term:`thread-safe` access to shared data. " -"Alternative design patterns to locks exist such as queues, producer/consumer " -"patterns, and thread-local state. See also :term:`deadlock`, and :term:" -"`reentrant`." +"the lock becomes available. Python's :mod:`threading` module " +"provides :class:`~threading.Lock` (a basic lock) " +"and :class:`~threading.RLock` (a :term:`reentrant` lock). Locks are used to " +"prevent :term:`race conditions ` and ensure :term:`thread-" +"safe` access to shared data. Alternative design patterns to locks exist " +"such as queues, producer/consumer patterns, and thread-local state. See " +"also :term:`deadlock`, and :term:`reentrant`." msgstr "" msgid "lock-free" @@ -1457,10 +1514,10 @@ msgid "loader" msgstr "ładowarka" msgid "" -"An object that loads a module. It must define the :meth:`!exec_module` and :" -"meth:`!create_module` methods to implement the :class:`~importlib.abc." -"Loader` interface. A loader is typically returned by a :term:`finder`. See " -"also:" +"An object that loads a module. It must define the :meth:`!exec_module` " +"and :meth:`!create_module` methods to implement " +"the :class:`~importlib.abc.Loader` interface. A loader is typically returned " +"by a :term:`finder`. See also:" msgstr "" msgid ":ref:`finders-and-loaders`" @@ -1476,8 +1533,9 @@ msgid "locale encoding" msgstr "" msgid "" -"On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:" -"`locale.setlocale(locale.LC_CTYPE, new_locale) `." +"On Unix, it is the encoding of the LC_CTYPE locale. It can be set " +"with :func:`locale.setlocale(locale.LC_CTYPE, new_locale) " +"`." msgstr "" msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." @@ -1504,11 +1562,11 @@ msgstr "" msgid "" "A container object that supports arbitrary key lookups and implements the " -"methods specified in the :class:`collections.abc.Mapping` or :class:" -"`collections.abc.MutableMapping` :ref:`abstract base classes `. Examples include :class:`dict`, :class:" -"`collections.defaultdict`, :class:`collections.OrderedDict` and :class:" -"`collections.Counter`." +"methods specified in the :class:`collections.abc.Mapping` " +"or :class:`collections.abc.MutableMapping` :ref:`abstract base classes " +"`. Examples " +"include :class:`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict` " +"and :class:`collections.Counter`." msgstr "" msgid "meta path finder" @@ -1549,8 +1607,8 @@ msgstr "metoda" msgid "" "A function which is defined inside a class body. If called as an attribute " "of an instance of that class, the method will get the instance object as its " -"first :term:`argument` (which is usually called ``self``). See :term:" -"`function` and :term:`nested scope`." +"first :term:`argument` (which is usually called ``self``). " +"See :term:`function` and :term:`nested scope`." msgstr "" msgid "method resolution order" @@ -1612,9 +1670,9 @@ msgid "" msgstr "" msgid "" -"Several built-in types are named tuples, including the values returned by :" -"func:`time.localtime` and :func:`os.stat`. Another example is :data:`sys." -"float_info`::" +"Several built-in types are named tuples, including the values returned " +"by :func:`time.localtime` and :func:`os.stat`. Another example " +"is :data:`sys.float_info`::" msgstr "" msgid "" @@ -1630,10 +1688,11 @@ msgid "" "Some named tuples are built-in types (such as the above examples). " "Alternatively, a named tuple can be created from a regular class definition " "that inherits from :class:`tuple` and that defines named fields. Such a " -"class can be written by hand, or it can be created by inheriting :class:" -"`typing.NamedTuple`, or with the factory function :func:`collections." -"namedtuple`. The latter techniques also add some extra methods that may not " -"be found in hand-written or built-in named tuples." +"class can be written by hand, or it can be created by " +"inheriting :class:`typing.NamedTuple`, or with the factory " +"function :func:`collections.namedtuple`. The latter techniques also add " +"some extra methods that may not be found in hand-written or built-in named " +"tuples." msgstr "" msgid "namespace" @@ -1643,12 +1702,13 @@ msgid "" "The place where a variable is stored. Namespaces are implemented as " "dictionaries. There are the local, global and built-in namespaces as well " "as nested namespaces in objects (in methods). Namespaces support modularity " -"by preventing naming conflicts. For instance, the functions :func:`builtins." -"open <.open>` and :func:`os.open` are distinguished by their namespaces. " -"Namespaces also aid readability and maintainability by making it clear which " -"module implements a function. For instance, writing :func:`random.seed` or :" -"func:`itertools.islice` makes it clear that those functions are implemented " -"by the :mod:`random` and :mod:`itertools` modules, respectively." +"by preventing naming conflicts. For instance, the " +"functions :func:`builtins.open <.open>` and :func:`os.open` are " +"distinguished by their namespaces. Namespaces also aid readability and " +"maintainability by making it clear which module implements a function. For " +"instance, writing :func:`random.seed` or :func:`itertools.islice` makes it " +"clear that those functions are implemented by the :mod:`random` " +"and :mod:`itertools` modules, respectively." msgstr "" msgid "namespace package" @@ -1702,8 +1762,9 @@ msgstr "" msgid "" "Old name for the flavor of classes now used for all class objects. In " "earlier Python versions, only new-style classes could use Python's newer, " -"versatile features like :attr:`~object.__slots__`, descriptors, properties, :" -"meth:`~object.__getattribute__`, class methods, and static methods." +"versatile features like :attr:`~object.__slots__`, descriptors, " +"properties, :meth:`~object.__getattribute__`, class methods, and static " +"methods." msgstr "" msgid "non-deterministic" @@ -1845,8 +1906,8 @@ msgstr "" msgid "" "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the " "difference between arguments and parameters `, " -"the :class:`inspect.Parameter` class, the :ref:`function` section, and :pep:" -"`362`." +"the :class:`inspect.Parameter` class, the :ref:`function` section, " +"and :pep:`362`." msgstr "" msgid "per-object lock" @@ -1874,9 +1935,9 @@ msgid "path entry finder" msgstr "" msgid "" -"A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. a :" -"term:`path entry hook`) which knows how to locate modules given a :term:" -"`path entry`." +"A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. " +"a :term:`path entry hook`) which knows how to locate modules given " +"a :term:`path entry`." msgstr "" msgid "" @@ -1905,14 +1966,14 @@ msgid "path-like object" msgstr "" msgid "" -"An object representing a file system path. A path-like object is either a :" -"class:`str` or :class:`bytes` object representing a path, or an object " -"implementing the :class:`os.PathLike` protocol. An object that supports the :" -"class:`os.PathLike` protocol can be converted to a :class:`str` or :class:" -"`bytes` file system path by calling the :func:`os.fspath` function; :func:" -"`os.fsdecode` and :func:`os.fsencode` can be used to guarantee a :class:" -"`str` or :class:`bytes` result instead, respectively. Introduced by :pep:" -"`519`." +"An object representing a file system path. A path-like object is either " +"a :class:`str` or :class:`bytes` object representing a path, or an object " +"implementing the :class:`os.PathLike` protocol. An object that supports " +"the :class:`os.PathLike` protocol can be converted to a :class:`str` " +"or :class:`bytes` file system path by calling the :func:`os.fspath` " +"function; :func:`os.fsdecode` and :func:`os.fsencode` can be used to " +"guarantee a :class:`str` or :class:`bytes` result instead, respectively. " +"Introduced by :pep:`519`." msgstr "" msgid "PEP" @@ -2049,8 +2110,8 @@ msgstr "" msgid "" "When used to refer to modules, the *fully qualified name* means the entire " -"dotted path to the module, including any parent packages, e.g. ``email.mime." -"text``::" +"dotted path to the module, including any parent packages, e.g. " +"``email.mime.text``::" msgstr "" msgid "" @@ -2070,10 +2131,11 @@ msgid "" "or ordering of events, particularly in multi-threaded programs. Race " "conditions can lead to :term:`non-deterministic` behavior and bugs that are " "difficult to reproduce. A :term:`data race` is a specific type of race " -"condition involving unsynchronized access to shared memory. The :term:" -"`LBYL` coding style is particularly susceptible to race conditions in multi-" -"threaded code. Using :term:`locks ` and other :term:`synchronization " -"primitives ` helps prevent race conditions." +"condition involving unsynchronized access to shared memory. " +"The :term:`LBYL` coding style is particularly susceptible to race conditions " +"in multi-threaded code. Using :term:`locks ` and " +"other :term:`synchronization primitives ` helps " +"prevent race conditions." msgstr "" msgid "reference count" @@ -2099,8 +2161,8 @@ msgid "regular package" msgstr "" msgid "" -"A traditional :term:`package`, such as a directory containing an ``__init__." -"py`` file." +"A traditional :term:`package`, such as a directory containing an " +"``__init__.py`` file." msgstr "" msgid "See also :term:`namespace package`." @@ -2111,8 +2173,8 @@ msgstr "" msgid "" "A property of a function or :term:`lock` that allows it to be called or " -"acquired multiple times by the same thread without causing errors or a :term:" -"`deadlock`." +"acquired multiple times by the same thread without causing errors or " +"a :term:`deadlock`." msgstr "" msgid "" @@ -2137,8 +2199,8 @@ msgid "REPL" msgstr "REPL" msgid "" -"An acronym for the \"read–eval–print loop\", another name for the :term:" -"`interactive` interpreter shell." +"An acronym for the \"read–eval–print loop\", another name for " +"the :term:`interactive` interpreter shell." msgstr "" msgid "__slots__" @@ -2157,23 +2219,24 @@ msgstr "sekwencja" msgid "" "An :term:`iterable` which supports efficient element access using integer " -"indices via the :meth:`~object.__getitem__` special method and defines a :" -"meth:`~object.__len__` method that returns the length of the sequence. Some " -"built-in sequence types are :class:`list`, :class:`str`, :class:`tuple`, " -"and :class:`bytes`. Note that :class:`dict` also supports :meth:`~object." -"__getitem__` and :meth:`!__len__`, but is considered a mapping rather than a " -"sequence because the lookups use arbitrary :term:`hashable` keys rather than " -"integers." +"indices via the :meth:`~object.__getitem__` special method and defines " +"a :meth:`~object.__len__` method that returns the length of the sequence. " +"Some built-in sequence types " +"are :class:`list`, :class:`str`, :class:`tuple`, and :class:`bytes`. Note " +"that :class:`dict` also supports :meth:`~object.__getitem__` and :meth:`!" +"__len__`, but is considered a mapping rather than a sequence because the " +"lookups use arbitrary :term:`hashable` keys rather than integers." msgstr "" msgid "" "The :class:`collections.abc.Sequence` abstract base class defines a much " -"richer interface that goes beyond just :meth:`~object.__getitem__` and :meth:" -"`~object.__len__`, adding :meth:`~sequence.count`, :meth:`~sequence.index`, :" -"meth:`~object.__contains__`, and :meth:`~object.__reversed__`. Types that " -"implement this expanded interface can be registered explicitly using :func:" -"`~abc.ABCMeta.register`. For more documentation on sequence methods " -"generally, see :ref:`Common Sequence Operations `." +"richer interface that goes beyond just :meth:`~object.__getitem__` " +"and :meth:`~object.__len__`, " +"adding :meth:`~sequence.count`, :meth:`~sequence.index`, :meth:`~object.__contains__`, " +"and :meth:`~object.__reversed__`. Types that implement this expanded " +"interface can be registered explicitly using :func:`~abc.ABCMeta.register`. " +"For more documentation on sequence methods generally, see :ref:`Common " +"Sequence Operations `." msgstr "" msgid "set comprehension" @@ -2182,8 +2245,8 @@ msgstr "" msgid "" "A compact way to process all or part of the elements in an iterable and " "return a set with the results. ``results = {c for c in 'abracadabra' if c " -"not in 'abc'}`` generates the set of strings ``{'r', 'd'}``. See :ref:" -"`comprehensions`." +"not in 'abc'}`` generates the set of strings ``{'r', 'd'}``. " +"See :ref:`comprehensions`." msgstr "" msgid "single dispatch" @@ -2198,8 +2261,8 @@ msgid "slice" msgstr "" msgid "" -"An object of type :class:`slice`, used to describe a portion of a :term:" -"`sequence`. A slice object is created when using the :ref:`slicing " +"An object of type :class:`slice`, used to describe a portion of " +"a :term:`sequence`. A slice object is created when using the :ref:`slicing " "` form of :ref:`subscript notation `, with colons " "inside square brackets, such as in ``variable_name[1:3:5]``." msgstr "" @@ -2229,19 +2292,19 @@ msgstr "" msgid "" "A method that is called implicitly by Python to execute a certain operation " "on a type, such as addition. Such methods have names starting and ending " -"with double underscores. Special methods are documented in :ref:" -"`specialnames`." +"with double underscores. Special methods are documented " +"in :ref:`specialnames`." msgstr "" msgid "standard library" msgstr "" msgid "" -"The collection of :term:`packages `, :term:`modules ` and :" -"term:`extension modules ` distributed as a part of the " -"official Python interpreter package. The exact membership of the collection " -"may vary based on platform, available system libraries, or other criteria. " -"Documentation can be found at :ref:`library-index`." +"The collection of :term:`packages `, :term:`modules ` " +"and :term:`extension modules ` distributed as a part of " +"the official Python interpreter package. The exact membership of the " +"collection may vary based on platform, available system libraries, or other " +"criteria. Documentation can be found at :ref:`library-index`." msgstr "" msgid "" @@ -2254,8 +2317,8 @@ msgstr "instrukcja" msgid "" "A statement is part of a suite (a \"block\" of code). A statement is either " -"an :term:`expression` or one of several constructs with a keyword, such as :" -"keyword:`if`, :keyword:`while` or :keyword:`for`." +"an :term:`expression` or one of several constructs with a keyword, such " +"as :keyword:`if`, :keyword:`while` or :keyword:`for`." msgstr "" msgid "static type checker" @@ -2263,8 +2326,8 @@ msgstr "" msgid "" "An external tool that reads Python code and analyzes it, looking for issues " -"such as incorrect types. See also :term:`type hints ` and the :" -"mod:`typing` module." +"such as incorrect types. See also :term:`type hints ` and " +"the :mod:`typing` module." msgstr "" msgid "stdlib" @@ -2273,14 +2336,27 @@ msgstr "" msgid "An abbreviation of :term:`standard library`." msgstr "" +msgid "steal" +msgstr "" + +msgid "" +"In Python's C API, \"*stealing*\" an argument means that ownership of the " +"argument is transferred to the called function. The caller must not use that " +"reference after the call. Generally, functions that \"steal\" an argument do " +"so even if they fail." +msgstr "" + +msgid "See :ref:`api-refcountdetails` for a full explanation." +msgstr "" + msgid "strong reference" msgstr "" msgid "" "In Python's C API, a strong reference is a reference to an object which is " "owned by the code holding the reference. The strong reference is taken by " -"calling :c:func:`Py_INCREF` when the reference is created and released with :" -"c:func:`Py_DECREF` when the reference is deleted." +"calling :c:func:`Py_INCREF` when the reference is created and released " +"with :c:func:`Py_DECREF` when the reference is deleted." msgstr "" msgid "" @@ -2300,8 +2376,8 @@ msgid "" "The expression in square brackets of a :ref:`subscription expression " "`, for example, the ``3`` in ``items[3]``. Usually used to " "select an element of a container. Also called a :term:`key` when " -"subscripting a :term:`mapping`, or an :term:`index` when subscripting a :" -"term:`sequence`." +"subscripting a :term:`mapping`, or an :term:`index` when subscripting " +"a :term:`sequence`." msgstr "" msgid "synchronization primitive" @@ -2311,13 +2387,11 @@ msgid "" "A basic building block for coordinating (synchronizing) the execution of " "multiple threads to ensure :term:`thread-safe` access to shared resources. " "Python's :mod:`threading` module provides several synchronization primitives " -"including :class:`~threading.Lock`, :class:`~threading.RLock`, :class:" -"`~threading.Semaphore`, :class:`~threading.Condition`, :class:`~threading." -"Event`, and :class:`~threading.Barrier`. Additionally, the :mod:`queue` " -"module provides multi-producer, multi-consumer queues that are especially " -"useful in multithreaded programs. These primitives help prevent :term:`race " -"conditions ` and coordinate thread execution. See also :" -"term:`lock`." +"including :class:`~threading.Lock`, :class:`~threading.RLock`, :class:`~threading.Semaphore`, :class:`~threading.Condition`, :class:`~threading.Event`, " +"and :class:`~threading.Barrier`. Additionally, the :mod:`queue` module " +"provides multi-producer, multi-consumer queues that are especially useful in " +"multithreaded programs. These primitives help prevent :term:`race conditions " +"` and coordinate thread execution. See also :term:`lock`." msgstr "" msgid "t-string" @@ -2357,21 +2431,23 @@ msgstr "plik tekstowy" msgid "" "A :term:`file object` able to read and write :class:`str` objects. Often, a " -"text file actually accesses a byte-oriented datastream and handles the :term:" -"`text encoding` automatically. Examples of text files are files opened in " -"text mode (``'r'`` or ``'w'``), :data:`sys.stdin`, :data:`sys.stdout`, and " -"instances of :class:`io.StringIO`." +"text file actually accesses a byte-oriented datastream and handles " +"the :term:`text encoding` automatically. Examples of text files are files " +"opened in text mode (``'r'`` or " +"``'w'``), :data:`sys.stdin`, :data:`sys.stdout`, and instances " +"of :class:`io.StringIO`." msgstr "" -":term:`Obiekt pliku ` może odczytywać i zapisywać obiekty :" -"class:`str`. Często plik tekstowy faktycznie uzyskuje dostęp do strumienia " -"danych zorientowanego na bajty i automatycznie obsługuje :term:`kodowanie " -"tekstu `. Przykładami plików tekstowych są pliki otwierane w " -"trybie tekstowym (``'r'`` lub ``'w'``), :data:`sys.stdin`, :data:`sys." -"stdout` i instancje :class:`io.StringIO`." +":term:`Obiekt pliku ` może odczytywać i zapisywać " +"obiekty :class:`str`. Często plik tekstowy faktycznie uzyskuje dostęp do " +"strumienia danych zorientowanego na bajty i automatycznie " +"obsługuje :term:`kodowanie tekstu `. Przykładami plików " +"tekstowych są pliki otwierane w trybie tekstowym (``'r'`` lub " +"``'w'``), :data:`sys.stdin`, :data:`sys.stdout` i " +"instancje :class:`io.StringIO`." msgid "" -"See also :term:`binary file` for a file object able to read and write :term:" -"`bytes-like objects `." +"See also :term:`binary file` for a file object able to read and " +"write :term:`bytes-like objects `." msgstr "" msgid "thread state" @@ -2413,15 +2489,15 @@ msgstr "" msgid "" "A module, function, or class that behaves correctly when used by multiple " -"threads concurrently. Thread-safe code uses appropriate :term:" -"`synchronization primitives ` like :term:`locks " -"` to protect shared mutable state, or is designed to avoid shared " -"mutable state entirely. In the :term:`free-threaded ` " -"build, built-in types like :class:`dict`, :class:`list`, and :class:`set` " -"use internal locking to make many operations thread-safe, although thread " -"safety is not necessarily guaranteed. Code that is not thread-safe may " -"experience :term:`race conditions ` and :term:`data races " -"` when used in multi-threaded programs." +"threads concurrently. Thread-safe code uses " +"appropriate :term:`synchronization primitives ` " +"like :term:`locks ` to protect shared mutable state, or is designed to " +"avoid shared mutable state entirely. In the :term:`free-threaded ` build, built-in types like :class:`dict`, :class:`list`, " +"and :class:`set` use internal locking to make many operations thread-safe, " +"although thread safety is not necessarily guaranteed. Code that is not " +"thread-safe may experience :term:`race conditions ` " +"and :term:`data races ` when used in multi-threaded programs." msgstr "" msgid "token" @@ -2434,8 +2510,8 @@ msgid "" msgstr "" msgid "" -"The :mod:`tokenize` module exposes Python's lexical analyzer. The :mod:" -"`token` module contains information on the various types of tokens." +"The :mod:`tokenize` module exposes Python's lexical analyzer. " +"The :mod:`token` module contains information on the various types of tokens." msgstr "" msgid "triple-quoted string" @@ -2456,8 +2532,9 @@ msgstr "typ" msgid "" "The type of a Python object determines what kind of object it is; every " -"object has a type. An object's type is accessible as its :attr:`~object." -"__class__` attribute or can be retrieved with ``type(obj)``." +"object has a type. An object's type is accessible as " +"its :attr:`~object.__class__` attribute or can be retrieved with " +"``type(obj)``." msgstr "" msgid "type alias" @@ -2516,8 +2593,8 @@ msgid "" "A manner of interpreting text streams in which all of the following are " "recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the " "Windows convention ``'\\r\\n'``, and the old Macintosh convention " -"``'\\r'``. See :pep:`278` and :pep:`3116`, as well as :func:`bytes." -"splitlines` for an additional use." +"``'\\r'``. See :pep:`278` and :pep:`3116`, as well " +"as :func:`bytes.splitlines` for an additional use." msgstr "" msgid "variable annotation" diff --git a/howto/a-conceptual-overview-of-asyncio.po b/howto/a-conceptual-overview-of-asyncio.po new file mode 100644 index 0000000000..18128eba73 --- /dev/null +++ b/howto/a-conceptual-overview-of-asyncio.po @@ -0,0 +1,731 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Maciej Olko, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "A Conceptual Overview of :mod:`!asyncio`" +msgstr "" + +msgid "" +"This :ref:`HOWTO ` article seeks to help you build a sturdy mental " +"model of how :mod:`asyncio` fundamentally works, helping you understand the " +"how and why behind the recommended patterns." +msgstr "" +"Ten :ref:`przewodnik` ma na celu pomóc Ci zbudować solidny model " +"mentalny :mod:`asyncio` dotyczący działania fundamentów, pomagając Ci " +"zrozumieć, w jaki sposób i dlaczego działają zalecane wzorce." + +msgid "" +"You might be curious about some key :mod:`!asyncio` concepts. By the end of " +"this article, you'll be able to comfortably answer these questions:" +msgstr "" +"Być może ciekawią Cię pewne kluczowe koncepcje :mod:`!asyncio`. Pod koniec " +"tego artykułu będziesz w stanie bez problemu odpowiedzieć na te pytania:" + +msgid "What's happening behind the scenes when an object is awaited?" +msgstr "" + +msgid "" +"How does :mod:`!asyncio` differentiate between a task which doesn't need CPU " +"time (such as a network request or file read) as opposed to a task that does " +"(such as computing n-factorial)?" +msgstr "" + +msgid "" +"How to write an asynchronous variant of an operation, such as an async sleep " +"or database request." +msgstr "" + +msgid "" +"The `guide `_ that inspired this HOWTO article, by Alexander Nordin." +msgstr "" + +msgid "" +"This in-depth `YouTube tutorial series `_ on ``asyncio`` " +"created by Python core team member, Łukasz Langa." +msgstr "" + +msgid "" +"`500 Lines or Less: A Web Crawler With asyncio Coroutines `_ by A. " +"Jesse Jiryu Davis and Guido van Rossum." +msgstr "" + +msgid "A conceptual overview part 1: the high-level" +msgstr "" + +msgid "" +"In part 1, we'll cover the main, high-level building blocks of :mod:`!" +"asyncio`: the event loop, coroutine functions, coroutine objects, tasks, and " +"``await``." +msgstr "" + +msgid "Event Loop" +msgstr "" + +msgid "" +"Everything in :mod:`!asyncio` happens relative to the event loop. It's the " +"star of the show. It's like an orchestra conductor. It's behind the scenes " +"managing resources. Some power is explicitly granted to it, but a lot of its " +"ability to get things done comes from the respect and cooperation of its " +"worker bees." +msgstr "" + +msgid "" +"In more technical terms, the event loop contains a collection of jobs to be " +"run. Some jobs are added directly by you, and some indirectly by :mod:`!" +"asyncio`. The event loop takes a job from its backlog of work and invokes it " +"(or \"gives it control\"), similar to calling a function, and then that job " +"runs. Once it pauses or completes, it returns control to the event loop. The " +"event loop will then select another job from its pool and invoke it. You can " +"*roughly* think of the collection of jobs as a queue: jobs are added and " +"then processed one at a time, generally (but not always) in order. This " +"process repeats indefinitely, with the event loop cycling endlessly onwards. " +"If there are no more jobs pending execution, the event loop is smart enough " +"to rest and avoid needlessly wasting CPU cycles, and will come back when " +"there's more work to be done." +msgstr "" + +msgid "" +"Effective execution relies on jobs sharing well and cooperating; a greedy " +"job could hog control and leave the other jobs to starve, rendering the " +"overall event loop approach rather useless." +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"# This creates an event loop and indefinitely cycles through\n" +"# its collection of jobs.\n" +"event_loop = asyncio.new_event_loop()\n" +"event_loop.run_forever()" +msgstr "" + +msgid "Asynchronous functions and coroutines" +msgstr "" + +msgid "This is a basic, boring Python function::" +msgstr "" + +msgid "" +"def hello_printer():\n" +" print(\n" +" \"Hi, I am a lowly, simple printer, though I have all I \"\n" +" \"need in life -- \\nfresh paper and my dearly beloved octopus \"\n" +" \"partner in crime.\"\n" +" )" +msgstr "" + +msgid "Calling a regular function invokes its logic or body::" +msgstr "" + +msgid "" +">>> hello_printer()\n" +"Hi, I am a lowly, simple printer, though I have all I need in life --\n" +"fresh paper and my dearly beloved octopus partner in crime." +msgstr "" + +msgid "" +"The :ref:`async def `, as opposed to just a plain ``def``, makes " +"this an asynchronous function (or \"coroutine function\"). Calling it " +"creates and returns a :ref:`coroutine ` object." +msgstr "" + +msgid "" +"async def loudmouth_penguin(magic_number: int):\n" +" print(\n" +" \"I am a super special talking penguin. Far cooler than that printer. " +"\"\n" +" f\"By the way, my lucky number is: {magic_number}.\"\n" +" )" +msgstr "" + +msgid "" +"Calling the async function, ``loudmouth_penguin``, does not execute the " +"print statement; instead, it creates a coroutine object::" +msgstr "" + +msgid "" +">>> loudmouth_penguin(magic_number=3)\n" +"" +msgstr "" + +msgid "" +"The terms \"coroutine function\" and \"coroutine object\" are often " +"conflated as coroutine. That can be confusing! In this article, coroutine " +"specifically refers to a coroutine object, or more precisely, an instance " +"of :class:`types.CoroutineType` (native coroutine). Note that coroutines can " +"also exist as instances of :class:`collections.abc.Coroutine` -- a " +"distinction that matters for type checking." +msgstr "" + +msgid "" +"A coroutine represents the function's body or logic. A coroutine has to be " +"explicitly started; again, merely creating the coroutine does not start it. " +"Notably, the coroutine can be paused and resumed at various points within " +"the function's body. That pausing and resuming ability is what allows for " +"asynchronous behavior!" +msgstr "" + +msgid "" +"Coroutines and coroutine functions were built by leveraging the " +"functionality of :term:`generators ` " +"and :term:`generator functions `. Recall, a generator function is " +"a function that :keyword:`yield`\\s, like this one::" +msgstr "" + +msgid "" +"def get_random_number():\n" +" # This would be a bad random number generator!\n" +" print(\"Hi\")\n" +" yield 1\n" +" print(\"Hello\")\n" +" yield 7\n" +" print(\"Howdy\")\n" +" yield 4\n" +" ..." +msgstr "" + +msgid "" +"Similar to a coroutine function, calling a generator function does not run " +"it. Instead, it creates a generator object::" +msgstr "" + +msgid "" +">>> get_random_number()\n" +"" +msgstr "" + +msgid "" +"You can proceed to the next ``yield`` of a generator by using the built-in " +"function :func:`next`. In other words, the generator runs, then pauses. For " +"example::" +msgstr "" + +msgid "" +">>> generator = get_random_number()\n" +">>> next(generator)\n" +"Hi\n" +"1\n" +">>> next(generator)\n" +"Hello\n" +"7" +msgstr "" + +msgid "Tasks" +msgstr "" + +msgid "" +"Roughly speaking, :ref:`tasks ` are coroutines (not " +"coroutine functions) tied to an event loop. A task also maintains a list of " +"callback functions whose importance will become clear in a moment when we " +"discuss :keyword:`await`. The recommended way to create tasks is " +"via :func:`asyncio.create_task`." +msgstr "" + +msgid "" +"Creating a task automatically schedules it for execution (by adding a " +"callback to run it in the event loop's to-do list, that is, collection of " +"jobs)." +msgstr "" + +msgid "" +":mod:`!asyncio` automatically associates tasks with the event loop for you. " +"This automatic association was purposely designed into :mod:`!asyncio` for " +"the sake of simplicity. Without it, you'd have to keep track of the event " +"loop object and pass it to any coroutine function that wants to create " +"tasks, adding redundant clutter to your code." +msgstr "" + +msgid "" +"coroutine = loudmouth_penguin(magic_number=5)\n" +"# This creates a Task object and schedules its execution via the event " +"loop.\n" +"task = asyncio.create_task(coroutine)" +msgstr "" + +msgid "" +"Earlier, we manually created the event loop and set it to run forever. In " +"practice, it's recommended to use (and common to see) :func:`asyncio.run`, " +"which takes care of managing the event loop and ensuring the provided " +"coroutine finishes before advancing. For example, many async programs follow " +"this setup::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def main():\n" +" # Perform all sorts of wacky, wild asynchronous things...\n" +" ...\n" +"\n" +"if __name__ == \"__main__\":\n" +" asyncio.run(main())\n" +" # The program will not reach the following print statement until the\n" +" # coroutine main() finishes.\n" +" print(\"coroutine main() is done!\")" +msgstr "" + +msgid "" +"It's important to be aware that the task itself is not added to the event " +"loop, only a callback to the task is. This matters if the task object you " +"created is garbage collected before it's called by the event loop. For " +"example, consider this program:" +msgstr "" + +msgid "" +"async def hello():\n" +" print(\"hello!\")\n" +"\n" +"async def main():\n" +" asyncio.create_task(hello())\n" +" # Other asynchronous instructions which run for a while\n" +" # and cede control to the event loop...\n" +" ...\n" +"\n" +"asyncio.run(main())" +msgstr "" + +msgid "" +"Because there's no reference to the task object created on line 5, it " +"*might* be garbage collected before the event loop invokes it. Later " +"instructions in the coroutine ``main()`` hand control back to the event loop " +"so it can invoke other jobs. When the event loop eventually tries to run the " +"task, it might fail and discover the task object does not exist! This can " +"also happen even if a coroutine keeps a reference to a task but completes " +"before that task finishes. When the coroutine exits, local variables go out " +"of scope and may be subject to garbage collection. In practice, ``asyncio`` " +"and Python's garbage collector work pretty hard to ensure this sort of thing " +"doesn't happen. But that's no reason to be reckless!" +msgstr "" + +msgid "await" +msgstr "" + +msgid "" +":keyword:`await` is a Python keyword that's commonly used in one of two " +"different ways::" +msgstr "" + +msgid "" +"await task\n" +"await coroutine" +msgstr "" + +msgid "" +"In a crucial way, the behavior of ``await`` depends on the type of object " +"being awaited." +msgstr "" + +msgid "" +"Awaiting a task will cede control from the current task or coroutine to the " +"event loop. In the process of relinquishing control, a few important things " +"happen. We'll use the following code example to illustrate::" +msgstr "" + +msgid "" +"async def plant_a_tree():\n" +" dig_the_hole_task = asyncio.create_task(dig_the_hole())\n" +" await dig_the_hole_task\n" +"\n" +" # Other instructions associated with planting a tree.\n" +" ..." +msgstr "" + +msgid "" +"In this example, imagine the event loop has passed control to the start of " +"the coroutine ``plant_a_tree()``. As seen above, the coroutine creates a " +"task and then awaits it. The ``await dig_the_hole_task`` instruction adds a " +"callback (which will resume ``plant_a_tree()``) to the ``dig_the_hole_task`` " +"object's list of callbacks. And then, the instruction cedes control to the " +"event loop. Some time later, the event loop will pass control to " +"``dig_the_hole_task`` and the task will finish whatever it needs to do. Once " +"the task finishes, it will add its various callbacks to the event loop, in " +"this case, a call to resume ``plant_a_tree()``." +msgstr "" + +msgid "" +"Generally speaking, when the awaited task finishes (``dig_the_hole_task``), " +"the original task or coroutine (``plant_a_tree()``) is added back to the " +"event loop's to-do list to be resumed." +msgstr "" + +msgid "" +"This is a basic, yet reliable mental model. In practice, the control " +"handoffs are slightly more complex, but not by much. In part 2, we'll walk " +"through the details that make this possible." +msgstr "" + +msgid "" +"**Unlike tasks, awaiting a coroutine does not hand control back to the event " +"loop!** Wrapping a coroutine in a task first, then awaiting that would cede " +"control. The behavior of ``await coroutine`` is effectively the same as " +"invoking a regular, synchronous Python function. Consider this program::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def coro_a():\n" +" print(\"I am coro_a(). Hi!\")\n" +"\n" +"async def coro_b():\n" +" print(\"I am coro_b(). I sure hope no one hogs the event loop...\")\n" +"\n" +"async def main():\n" +" task_b = asyncio.create_task(coro_b())\n" +" num_repeats = 3\n" +" for _ in range(num_repeats):\n" +" await coro_a()\n" +" await task_b\n" +"\n" +"asyncio.run(main())" +msgstr "" + +msgid "" +"The first statement in the coroutine ``main()`` creates ``task_b`` and " +"schedules it for execution via the event loop. Then, ``coro_a()`` is " +"repeatedly awaited. Control never cedes to the event loop, which is why we " +"see the output of all three ``coro_a()`` invocations before ``coro_b()``'s " +"output:" +msgstr "" + +msgid "" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!\n" +"I am coro_b(). I sure hope no one hogs the event loop..." +msgstr "" + +msgid "" +"If we change ``await coro_a()`` to ``await asyncio.create_task(coro_a())``, " +"the behavior changes. The coroutine ``main()`` cedes control to the event " +"loop with that statement. The event loop then proceeds through its backlog " +"of work, calling ``task_b`` and then the task which wraps ``coro_a()`` " +"before resuming the coroutine ``main()``." +msgstr "" + +msgid "" +"I am coro_b(). I sure hope no one hogs the event loop...\n" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!" +msgstr "" + +msgid "" +"This behavior of ``await coroutine`` can trip a lot of people up! That " +"example highlights how using only ``await coroutine`` could unintentionally " +"hog control from other tasks and effectively stall the event " +"loop. :func:`asyncio.run` can help you detect such occurrences via the " +"``debug=True`` flag, which enables :ref:`debug mode `. " +"Among other things, it will log any coroutines that monopolize execution for " +"100ms or longer." +msgstr "" + +msgid "" +"The design intentionally trades off some conceptual clarity around usage of " +"``await`` for improved performance. Each time a task is awaited, control " +"needs to be passed all the way up the call stack to the event loop. That " +"might sound minor, but in a large program with many ``await`` statements and " +"a deep call stack, that overhead can add up to a meaningful performance drag." +msgstr "" + +msgid "A conceptual overview part 2: the nuts and bolts" +msgstr "" + +msgid "" +"Part 2 goes into detail on the mechanisms :mod:`!asyncio` uses to manage " +"control flow. This is where the magic happens. You'll come away from this " +"section knowing what ``await`` does behind the scenes and how to make your " +"own asynchronous operators." +msgstr "" + +msgid "The inner workings of coroutines" +msgstr "" + +msgid ":mod:`!asyncio` leverages four components to pass around control." +msgstr "" + +msgid "" +":meth:`coroutine.send(arg) ` is the method used to start or " +"resume a coroutine. If the coroutine was paused and is now being resumed, " +"the argument ``arg`` will be sent in as the return value of the ``yield`` " +"statement which originally paused it. If the coroutine is being used for the " +"first time (as opposed to being resumed), ``arg`` must be ``None``." +msgstr "" + +msgid "" +"class Rock:\n" +" def __await__(self):\n" +" value_sent_in = yield 7\n" +" print(f\"Rock.__await__ resuming with value: {value_sent_in}.\")\n" +" return value_sent_in\n" +"\n" +"async def main():\n" +" print(\"Beginning coroutine main().\")\n" +" rock = Rock()\n" +" print(\"Awaiting rock...\")\n" +" value_from_rock = await rock\n" +" print(f\"Coroutine received value: {value_from_rock} from rock.\")\n" +" return 23\n" +"\n" +"coroutine = main()\n" +"intermediate_result = coroutine.send(None)\n" +"print(f\"Coroutine paused and returned intermediate value: " +"{intermediate_result}.\")\n" +"\n" +"print(f\"Resuming coroutine and sending in value: 42.\")\n" +"try:\n" +" coroutine.send(42)\n" +"except StopIteration as e:\n" +" returned_value = e.value\n" +"print(f\"Coroutine main() finished and provided value: {returned_value}.\")" +msgstr "" + +msgid "" +":ref:`yield `, as usual, pauses execution and returns control to " +"the caller. In the example above, the ``yield``, on line 3, is called by " +"``... = await rock`` on line 11. More broadly speaking, ``await`` calls " +"the :meth:`~object.__await__` method of the given object. ``await`` also " +"does one more very special thing: it propagates (or \"passes along\") any " +"``yield``\\ s it receives up the call chain. In this case, that's back to " +"``... = coroutine.send(None)`` on line 16." +msgstr "" + +msgid "" +"The coroutine is resumed via the ``coroutine.send(42)`` call on line 21. The " +"coroutine picks back up from where it ``yield``\\ ed (or paused) on line 3 " +"and executes the remaining statements in its body. When a coroutine " +"finishes, it raises a :exc:`StopIteration` exception with the return value " +"attached in the :attr:`~StopIteration.value` attribute." +msgstr "" + +msgid "That snippet produces this output:" +msgstr "" + +msgid "" +"Beginning coroutine main().\n" +"Awaiting rock...\n" +"Coroutine paused and returned intermediate value: 7.\n" +"Resuming coroutine and sending in value: 42.\n" +"Rock.__await__ resuming with value: 42.\n" +"Coroutine received value: 42 from rock.\n" +"Coroutine main() finished and provided value: 23." +msgstr "" + +msgid "" +"It's worth pausing for a moment here and making sure you followed the " +"various ways that control flow and values were passed. A lot of important " +"ideas were covered and it's worth ensuring your understanding is firm." +msgstr "" + +msgid "" +"The only way to yield (or effectively cede control) from a coroutine is to " +"``await`` an object that ``yield``\\ s in its ``__await__`` method. That " +"might sound odd to you. You might be thinking:" +msgstr "" + +msgid "" +"1. What about a ``yield`` directly within the coroutine function? The " +"coroutine function becomes an :ref:`async generator function `, a different beast entirely." +msgstr "" + +msgid "" +"2. What about a :ref:`yield from ` within the coroutine function " +"to a (plain) generator? That causes the error: ``SyntaxError: yield from not " +"allowed in a coroutine.`` This was intentionally designed for the sake of " +"simplicity -- mandating only one way of using coroutines. Initially " +"``yield`` was barred as well, but was re-accepted to allow for async " +"generators. Despite that, ``yield from`` and ``await`` effectively do the " +"same thing." +msgstr "" + +msgid "Futures" +msgstr "" + +msgid "" +"A :ref:`future ` is an object meant to represent a " +"computation's status and result. The term is a nod to the idea of something " +"still to come or not yet happened, and the object is a way to keep an eye on " +"that something." +msgstr "" + +msgid "" +"A future has a few important attributes. One is its state, which can be " +"either \"pending\", \"cancelled\", or \"done\". Another is its result, which " +"is set when the state transitions to done. Unlike a coroutine, a future does " +"not represent the actual computation to be done; instead, it represents the " +"status and result of that computation, kind of like a status light (red, " +"yellow, or green) or indicator." +msgstr "" + +msgid "" +":class:`asyncio.Task` subclasses :class:`asyncio.Future` in order to gain " +"these various capabilities. The prior section said tasks store a list of " +"callbacks, which wasn't entirely accurate. It's actually the ``Future`` " +"class that implements this logic, which ``Task`` inherits." +msgstr "" + +msgid "" +"Futures may also be used directly (not via tasks). Tasks mark themselves as " +"done when their coroutine is complete. Futures are much more versatile and " +"will be marked as done when you say so. In this way, they're the flexible " +"interface for you to make your own conditions for waiting and resuming." +msgstr "" + +msgid "A homemade asyncio.sleep" +msgstr "" + +msgid "" +"We'll go through an example of how you could leverage a future to create " +"your own variant of asynchronous sleep (``async_sleep``) which " +"mimics :func:`asyncio.sleep`." +msgstr "" + +msgid "" +"This snippet registers a few tasks with the event loop and then awaits the " +"task created by ``asyncio.create_task``, which wraps the ``async_sleep(3)`` " +"coroutine. We want that task to finish only after three seconds have " +"elapsed, but without preventing other tasks from running." +msgstr "" + +msgid "" +"async def other_work():\n" +" print(\"I like work. Work work.\")\n" +"\n" +"async def main():\n" +" # Add a few other tasks to the event loop, so there's something\n" +" # to do while asynchronously sleeping.\n" +" work_tasks = [\n" +" asyncio.create_task(other_work()),\n" +" asyncio.create_task(other_work()),\n" +" asyncio.create_task(other_work())\n" +" ]\n" +" print(\n" +" \"Beginning asynchronous sleep at time: \"\n" +" f\"{datetime.datetime.now().strftime(\"%H:%M:%S\")}.\"\n" +" )\n" +" await asyncio.create_task(async_sleep(3))\n" +" print(\n" +" \"Done asynchronous sleep at time: \"\n" +" f\"{datetime.datetime.now().strftime(\"%H:%M:%S\")}.\"\n" +" )\n" +" # asyncio.gather effectively awaits each task in the collection.\n" +" await asyncio.gather(*work_tasks)" +msgstr "" + +msgid "" +"Below, we use a future to enable custom control over when that task will be " +"marked as done. If :meth:`future.set_result() ` " +"(the method responsible for marking that future as done) is never called, " +"then this task will never finish. We've also enlisted the help of another " +"task, which we'll see in a moment, that will monitor how much time has " +"elapsed and, accordingly, call ``future.set_result()``." +msgstr "" + +msgid "" +"async def async_sleep(seconds: float):\n" +" future = asyncio.Future()\n" +" time_to_wake = time.time() + seconds\n" +" # Add the watcher-task to the event loop.\n" +" watcher_task = asyncio.create_task(_sleep_watcher(future, " +"time_to_wake))\n" +" # Block until the future is marked as done.\n" +" await future" +msgstr "" + +msgid "" +"Below, we use a rather bare ``YieldToEventLoop()`` object to ``yield`` from " +"its ``__await__`` method, ceding control to the event loop. This is " +"effectively the same as calling ``asyncio.sleep(0)``, but this approach " +"offers more clarity, not to mention it's somewhat cheating to use " +"``asyncio.sleep`` when showcasing how to implement it!" +msgstr "" + +msgid "" +"As usual, the event loop cycles through its tasks, giving them control and " +"receiving control back when they pause or finish. The ``watcher_task``, " +"which runs the coroutine ``_sleep_watcher(...)``, will be invoked once per " +"full cycle of the event loop. On each resumption, it'll check the time and " +"if not enough has elapsed, then it'll pause once again and hand control back " +"to the event loop. Once enough time has elapsed, ``_sleep_watcher(...)`` " +"marks the future as done and completes by exiting its infinite ``while`` " +"loop. Given this helper task is only invoked once per cycle of the event " +"loop, you'd be correct to note that this asynchronous sleep will sleep *at " +"least* three seconds, rather than exactly three seconds. Note this is also " +"true of ``asyncio.sleep``." +msgstr "" + +msgid "" +"class YieldToEventLoop:\n" +" def __await__(self):\n" +" yield\n" +"\n" +"async def _sleep_watcher(future, time_to_wake):\n" +" while True:\n" +" if time.time() >= time_to_wake:\n" +" # This marks the future as done.\n" +" future.set_result(None)\n" +" break\n" +" else:\n" +" await YieldToEventLoop()" +msgstr "" + +msgid "Here is the full program's output:" +msgstr "" + +msgid "" +"$ python custom-async-sleep.py\n" +"Beginning asynchronous sleep at time: 14:52:22.\n" +"I like work. Work work.\n" +"I like work. Work work.\n" +"I like work. Work work.\n" +"Done asynchronous sleep at time: 14:52:25." +msgstr "" + +msgid "" +"You might feel this implementation of asynchronous sleep was unnecessarily " +"convoluted. And, well, it was. The example was meant to showcase the " +"versatility of futures with a simple example that could be mimicked for more " +"complex needs. For reference, you could implement it without futures, like " +"so::" +msgstr "" + +msgid "" +"async def simpler_async_sleep(seconds):\n" +" time_to_wake = time.time() + seconds\n" +" while True:\n" +" if time.time() >= time_to_wake:\n" +" return\n" +" else:\n" +" await YieldToEventLoop()" +msgstr "" + +msgid "" +"But that's all for now. Hopefully you're ready to more confidently dive into " +"some async programming or check out advanced topics in the :mod:`rest of the " +"documentation `." +msgstr "" diff --git a/howto/annotations.po b/howto/annotations.po index d757894f31..690dbd7687 100644 --- a/howto/annotations.po +++ b/howto/annotations.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Ciarbin , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Ciarbin , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -41,6 +42,10 @@ msgid "" "``__annotations__`` on Python objects, we encourage you to follow the " "guidelines described below." msgstr "" +"Ten dokument ma na celu przedstawienie najlepszych praktyk dotyczących pracy " +"ze słownikami adnotacji. Jeśli piszesz kod w języku Python, który analizuje " +"``__annotations__`` na obiektach tego języka, zachęcamy do stosowania się do " +"wytycznych opisanych poniżej." msgid "" "The document is organized into four sections: best practices for accessing " @@ -53,44 +58,45 @@ msgstr "" msgid "" "Note that this document is specifically about working with " "``__annotations__``, not uses *for* annotations. If you're looking for " -"information on how to use \"type hints\" in your code, please see the :mod:" -"`typing` module." +"information on how to use \"type hints\" in your code, please see " +"the :mod:`typing` module." msgstr "" msgid "Accessing The Annotations Dict Of An Object In Python 3.10 And Newer" msgstr "" msgid "" -"Python 3.10 adds a new function to the standard library: :func:`inspect." -"get_annotations`. In Python versions 3.10 through 3.13, calling this " -"function is the best practice for accessing the annotations dict of any " -"object that supports annotations. This function can also \"un-stringize\" " -"stringized annotations for you." +"Python 3.10 adds a new function to the standard " +"library: :func:`inspect.get_annotations`. In Python versions 3.10 through " +"3.13, calling this function is the best practice for accessing the " +"annotations dict of any object that supports annotations. This function can " +"also \"un-stringize\" stringized annotations for you." msgstr "" msgid "" "In Python 3.14, there is a new :mod:`annotationlib` module with " -"functionality for working with annotations. This includes a :func:" -"`annotationlib.get_annotations` function, which supersedes :func:`inspect." -"get_annotations`." +"functionality for working with annotations. This includes " +"a :func:`annotationlib.get_annotations` function, which " +"supersedes :func:`inspect.get_annotations`." msgstr "" msgid "" "If for some reason :func:`inspect.get_annotations` isn't viable for your use " "case, you may access the ``__annotations__`` data member manually. Best " -"practice for this changed in Python 3.10 as well: as of Python 3.10, ``o." -"__annotations__`` is guaranteed to *always* work on Python functions, " +"practice for this changed in Python 3.10 as well: as of Python 3.10, " +"``o.__annotations__`` is guaranteed to *always* work on Python functions, " "classes, and modules. If you're certain the object you're examining is one " "of these three *specific* objects, you may simply use ``o.__annotations__`` " "to get at the object's annotations dict." msgstr "" msgid "" -"However, other types of callables--for example, callables created by :func:" -"`functools.partial`--may not have an ``__annotations__`` attribute defined. " -"When accessing the ``__annotations__`` of a possibly unknown object, best " -"practice in Python versions 3.10 and newer is to call :func:`getattr` with " -"three arguments, for example ``getattr(o, '__annotations__', None)``." +"However, other types of callables--for example, callables created " +"by :func:`functools.partial`--may not have an ``__annotations__`` attribute " +"defined. When accessing the ``__annotations__`` of a possibly unknown " +"object, best practice in Python versions 3.10 and newer is to " +"call :func:`getattr` with three arguments, for example ``getattr(o, " +"'__annotations__', None)``." msgstr "" msgid "" @@ -163,14 +169,14 @@ msgstr "" msgid "" "After running this code, ``ann`` should be either a dictionary or ``None``. " -"You're encouraged to double-check the type of ``ann`` using :func:" -"`isinstance` before further examination." +"You're encouraged to double-check the type of ``ann`` " +"using :func:`isinstance` before further examination." msgstr "" msgid "" -"Note that some exotic or malformed type objects may not have a :attr:`~type." -"__dict__` attribute, so for extra safety you may also wish to use :func:" -"`getattr` to access :attr:`!__dict__`." +"Note that some exotic or malformed type objects may not have " +"a :attr:`~type.__dict__` attribute, so for extra safety you may also wish to " +"use :func:`getattr` to access :attr:`!__dict__`." msgstr "" msgid "Manually Un-Stringizing Stringized Annotations" @@ -184,10 +190,11 @@ msgid "" msgstr "" msgid "" -"If you're using Python 3.9 or older, or if for some reason you can't use :" -"func:`inspect.get_annotations`, you'll need to duplicate its logic. You're " -"encouraged to examine the implementation of :func:`inspect.get_annotations` " -"in the current Python version and follow a similar approach." +"If you're using Python 3.9 or older, or if for some reason you can't " +"use :func:`inspect.get_annotations`, you'll need to duplicate its logic. " +"You're encouraged to examine the implementation " +"of :func:`inspect.get_annotations` in the current Python version and follow " +"a similar approach." msgstr "" msgid "" @@ -196,26 +203,27 @@ msgid "" msgstr "" msgid "" -"If ``o`` is a module, use ``o.__dict__`` as the ``globals`` when calling :" -"func:`eval`." +"If ``o`` is a module, use ``o.__dict__`` as the ``globals`` when " +"calling :func:`eval`." msgstr "" msgid "" "If ``o`` is a class, use ``sys.modules[o.__module__].__dict__`` as the " -"``globals``, and ``dict(vars(o))`` as the ``locals``, when calling :func:" -"`eval`." +"``globals``, and ``dict(vars(o))`` as the ``locals``, when " +"calling :func:`eval`." msgstr "" msgid "" -"If ``o`` is a wrapped callable using :func:`functools.update_wrapper`, :func:" -"`functools.wraps`, or :func:`functools.partial`, iteratively unwrap it by " -"accessing either ``o.__wrapped__`` or ``o.func`` as appropriate, until you " -"have found the root unwrapped function." +"If ``o`` is a wrapped callable " +"using :func:`functools.update_wrapper`, :deco:`functools.wraps`, " +"or :func:`functools.partial`, iteratively unwrap it by accessing either " +"``o.__wrapped__`` or ``o.func`` as appropriate, until you have found the " +"root unwrapped function." msgstr "" msgid "" -"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ ` as the globals when calling :func:`eval`." +"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ " +"` as the globals when calling :func:`eval`." msgstr "" msgid "" @@ -232,8 +240,8 @@ msgid "" msgstr "" msgid "" -"Definitions that aren't needed at runtime, only imported when :const:`typing." -"TYPE_CHECKING` is true." +"Definitions that aren't needed at runtime, only imported " +"when :const:`typing.TYPE_CHECKING` is true." msgstr "" msgid "" @@ -258,8 +266,8 @@ msgstr "" msgid "" "You should avoid accessing ``__annotations__`` directly on any object. " -"Instead, use :func:`annotationlib.get_annotations` (Python 3.14+) or :func:" -"`inspect.get_annotations` (Python 3.10+)." +"Instead, use :func:`annotationlib.get_annotations` (Python 3.14+) " +"or :func:`inspect.get_annotations` (Python 3.10+)." msgstr "" msgid "" @@ -326,17 +334,18 @@ msgstr "" msgid "" "If you use a class with a custom metaclass and access ``__annotations__`` on " "the class, you may observe unexpected behavior; see :pep:`749 <749#pep749-" -"metaclasses>` for some examples. You can avoid these quirks by using :func:" -"`annotationlib.get_annotations` on Python 3.14+ or :func:`inspect." -"get_annotations` on Python 3.10+. On earlier versions of Python, you can " -"avoid these bugs by accessing the annotations from the class's :attr:`~type." -"__dict__` (for example, ``cls.__dict__.get('__annotations__', None)``)." +"metaclasses>` for some examples. You can avoid these quirks by " +"using :func:`annotationlib.get_annotations` on Python 3.14+ " +"or :func:`inspect.get_annotations` on Python 3.10+. On earlier versions of " +"Python, you can avoid these bugs by accessing the annotations from the " +"class's :attr:`~type.__dict__` (for example, " +"``cls.__dict__.get('__annotations__', None)``)." msgstr "" msgid "" "In some versions of Python, instances of classes may have an " "``__annotations__`` attribute. However, this is not supported functionality. " "If you need the annotations of an instance, you can use :func:`type` to " -"access its class (for example, ``annotationlib." -"get_annotations(type(myinstance))`` on Python 3.14+)." +"access its class (for example, " +"``annotationlib.get_annotations(type(myinstance))`` on Python 3.14+)." msgstr "" diff --git a/howto/argparse-optparse.po b/howto/argparse-optparse.po index 0364b664ba..965d848ac4 100644 --- a/howto/argparse-optparse.po +++ b/howto/argparse-optparse.po @@ -73,37 +73,37 @@ msgid "" msgstr "" msgid "" -"For applications that do choose to migrate from :mod:`optparse` to :mod:" -"`argparse`, the following suggestions should be helpful:" +"For applications that do choose to migrate from :mod:`optparse` " +"to :mod:`argparse`, the following suggestions should be helpful:" msgstr "" msgid "" -"Replace all :meth:`optparse.OptionParser.add_option` calls with :meth:" -"`ArgumentParser.add_argument` calls." +"Replace all :meth:`optparse.OptionParser.add_option` calls " +"with :meth:`ArgumentParser.add_argument` calls." msgstr "" -"Замініть усі виклики :meth:`optparse.OptionParser.add_option` на виклики :" -"meth:`ArgumentParser.add_argument`." +"Замініть усі виклики :meth:`optparse.OptionParser.add_option` на " +"виклики :meth:`ArgumentParser.add_argument`." msgid "" -"Replace ``(options, args) = parser.parse_args()`` with ``args = parser." -"parse_args()`` and add additional :meth:`ArgumentParser.add_argument` calls " -"for the positional arguments. Keep in mind that what was previously called " -"``options``, now in the :mod:`argparse` context is called ``args``." +"Replace ``(options, args) = parser.parse_args()`` with ``args = " +"parser.parse_args()`` and add additional :meth:`ArgumentParser.add_argument` " +"calls for the positional arguments. Keep in mind that what was previously " +"called ``options``, now in the :mod:`argparse` context is called ``args``." msgstr "" -"Замініть ``(options, args) = parser.parse_args()`` на ``args = parser." -"parse_args()`` і додайте додаткові виклики :meth:`ArgumentParser." -"add_argument` для позиційних аргументів. Майте на увазі, що те, що раніше " -"називалося ``options``, тепер у контексті :mod:`argparse` називається " -"``args``." +"Замініть ``(options, args) = parser.parse_args()`` на ``args = " +"parser.parse_args()`` і додайте додаткові " +"виклики :meth:`ArgumentParser.add_argument` для позиційних аргументів. Майте " +"на увазі, що те, що раніше називалося ``options``, тепер у " +"контексті :mod:`argparse` називається ``args``." msgid "" -"Replace :meth:`optparse.OptionParser.disable_interspersed_args` by using :" -"meth:`~ArgumentParser.parse_intermixed_args` instead of :meth:" -"`~ArgumentParser.parse_args`." +"Replace :meth:`optparse.OptionParser.disable_interspersed_args` by " +"using :meth:`~ArgumentParser.parse_intermixed_args` instead " +"of :meth:`~ArgumentParser.parse_args`." msgstr "" "Замініть :meth:`optparse.OptionParser.disable_interspersed_args` на " -"використання :meth:`~ArgumentParser.parse_intermixed_args` замість :meth:" -"`~ArgumentParser.parse_args`." +"використання :meth:`~ArgumentParser.parse_intermixed_args` " +"замість :meth:`~ArgumentParser.parse_args`." msgid "" "Replace callback actions and the ``callback_*`` keyword arguments with " @@ -120,11 +120,13 @@ msgstr "" "об’єктами типу (наприклад, int, float, complex тощо)." msgid "" -"Replace :class:`optparse.Values` with :class:`Namespace` and :exc:`optparse." -"OptionError` and :exc:`optparse.OptionValueError` with :exc:`ArgumentError`." +"Replace :class:`optparse.Values` with :class:`Namespace` " +"and :exc:`optparse.OptionError` and :exc:`optparse.OptionValueError` " +"with :exc:`ArgumentError`." msgstr "" -"Замініть :class:`optparse.Values` на :class:`Namespace` і :exc:`optparse." -"OptionError` і :exc:`optparse.OptionValueError` на :exc:`ArgumentError`." +"Замініть :class:`optparse.Values` на :class:`Namespace` " +"і :exc:`optparse.OptionError` і :exc:`optparse.OptionValueError` " +"на :exc:`ArgumentError`." msgid "" "Replace strings with implicit arguments such as ``%default`` or ``%prog`` " @@ -140,5 +142,6 @@ msgid "" "``parser.add_argument('--version', action='version', version='')``." msgstr "" -"Замініть аргумент ``version`` конструктора OptionParser на виклик ``parser." -"add_argument('--version', action='version', version=' ')``." +"Замініть аргумент ``version`` конструктора OptionParser на виклик " +"``parser.add_argument('--version', action='version', version=' " +"')``." diff --git a/howto/argparse.po b/howto/argparse.po index cbe0c29f66..e1493f7c48 100644 --- a/howto/argparse.po +++ b/howto/argparse.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -322,8 +322,8 @@ msgstr "" msgid "" "That didn't go so well. That's because :mod:`argparse` treats the options we " -"give it as strings, unless we tell it otherwise. So, let's tell :mod:" -"`argparse` to treat that input as an integer::" +"give it as strings, unless we tell it otherwise. So, let's " +"tell :mod:`argparse` to treat that input as an integer::" msgstr "" msgid "" @@ -399,8 +399,8 @@ msgid "" "To show that the option is actually optional, there is no error when running " "the program without it. Note that by default, if an optional argument isn't " "used, the relevant variable, in this case ``args.verbosity``, is given " -"``None`` as a value, which is the reason it fails the truth test of the :" -"keyword:`if` statement." +"``None`` as a value, which is the reason it fails the truth test of " +"the :keyword:`if` statement." msgstr "" msgid "The help message is a bit different." @@ -771,8 +771,8 @@ msgid "" "We've just introduced yet another keyword, ``default``. We've set it to " "``0`` in order to make it comparable to the other int values. Remember that " "by default, if an optional argument isn't specified, it gets the ``None`` " -"value, and that cannot be compared to an int value (hence the :exc:" -"`TypeError` exception)." +"value, and that cannot be compared to an int value (hence " +"the :exc:`TypeError` exception)." msgstr "" msgid "And:" @@ -901,12 +901,13 @@ msgid "Conflicting options" msgstr "" msgid "" -"So far, we have been working with two methods of an :class:`argparse." -"ArgumentParser` instance. Let's introduce a third one, :meth:" -"`~ArgumentParser.add_mutually_exclusive_group`. It allows for us to specify " -"options that conflict with each other. Let's also change the rest of the " -"program so that the new functionality makes more sense: we'll introduce the " -"``--quiet`` option, which will be the opposite of the ``--verbose`` one::" +"So far, we have been working with two methods of " +"an :class:`argparse.ArgumentParser` instance. Let's introduce a third " +"one, :meth:`~ArgumentParser.add_mutually_exclusive_group`. It allows for us " +"to specify options that conflict with each other. Let's also change the rest " +"of the program so that the new functionality makes more sense: we'll " +"introduce the ``--quiet`` option, which will be the opposite of the ``--" +"verbose`` one::" msgstr "" msgid "" @@ -1022,9 +1023,9 @@ msgid "" msgstr "" msgid "" -"In order to translate these strings, they must first be extracted into a ``." -"po`` file. For example, using `Babel `__, run this " -"command:" +"In order to translate these strings, they must first be extracted into a " +"``.po`` file. For example, using `Babel `__, run " +"this command:" msgstr "" msgid "$ pybabel extract -o messages.po /usr/lib/python3.12/argparse.py" @@ -1053,8 +1054,8 @@ msgid "" msgstr "" msgid "" -"To translate your own strings in the :mod:`argparse` output, use :mod:" -"`gettext`." +"To translate your own strings in the :mod:`argparse` output, " +"use :mod:`gettext`." msgstr "" msgid "Custom type converters" diff --git a/howto/clinic.po b/howto/clinic.po index 05da9fe4f3..6e53c74f62 100644 --- a/howto/clinic.po +++ b/howto/clinic.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/curses.po b/howto/curses.po index 42bc5bc346..ce1f2f6c08 100644 --- a/howto/curses.po +++ b/howto/curses.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -92,8 +92,9 @@ msgid "" msgstr "" msgid "" -"The Windows version of Python doesn't include the :mod:`curses` module. A " -"ported version called :pypi:`UniCurses` is available." +"The Windows version of Python doesn't include the :mod:`curses` module. The " +"third-party :pypi:`windows-curses` package provides the same interface on " +"Windows." msgstr "" msgid "The Python curses module" @@ -155,9 +156,9 @@ msgid "" "Terminals usually return special keys, such as the cursor keys or navigation " "keys such as Page Up and Home, as a multibyte escape sequence. While you " "could write your application to expect such sequences and process them " -"accordingly, curses can do it for you, returning a special value such as :" -"const:`curses.KEY_LEFT`. To get curses to do the job, you'll have to enable " -"keypad mode. ::" +"accordingly, curses can do it for you, returning a special value such " +"as :const:`curses.KEY_LEFT`. To get curses to do the job, you'll have to " +"enable keypad mode. ::" msgstr "" msgid "stdscr.keypad(True)" @@ -175,9 +176,9 @@ msgid "" msgstr "" msgid "" -"to reverse the curses-friendly terminal settings. Then call the :func:" -"`~curses.endwin` function to restore the terminal to its original operating " -"mode. ::" +"to reverse the curses-friendly terminal settings. Then call " +"the :func:`~curses.endwin` function to restore the terminal to its original " +"operating mode. ::" msgstr "" msgid "curses.endwin()" @@ -219,11 +220,11 @@ msgid "" "initializations described above, also initializing colors if color support " "is present. :func:`!wrapper` then runs your provided callable. Once the " "callable returns, :func:`!wrapper` will restore the original state of the " -"terminal. The callable is called inside a :keyword:`try`...\\ :keyword:" -"`except` that catches exceptions, restores the state of the terminal, and " -"then re-raises the exception. Therefore your terminal won't be left in a " -"funny state on exception and you'll be able to read the exception's message " -"and traceback." +"terminal. The callable is called inside a :keyword:`try`..." +"\\ :keyword:`except` that catches exceptions, restores the state of the " +"terminal, and then re-raises the exception. Therefore your terminal won't " +"be left in a funny state on exception and you'll be able to read the " +"exception's message and traceback." msgstr "" msgid "Windows and Pads" @@ -239,9 +240,9 @@ msgid "" "The ``stdscr`` object returned by the :func:`~curses.initscr` function is a " "window object that covers the entire screen. Many programs may need only " "this single window, but you might wish to divide the screen into smaller " -"windows, in order to redraw or clear them separately. The :func:`~curses." -"newwin` function creates a new window of a given size, returning the new " -"window object. ::" +"windows, in order to redraw or clear them separately. " +"The :func:`~curses.newwin` function creates a new window of a given size, " +"returning the new window object. ::" msgstr "" msgid "" @@ -260,24 +261,25 @@ msgid "" msgstr "" msgid "" -"Your application can determine the size of the screen by using the :data:" -"`curses.LINES` and :data:`curses.COLS` variables to obtain the *y* and *x* " -"sizes. Legal coordinates will then extend from ``(0,0)`` to ``(curses.LINES " -"- 1, curses.COLS - 1)``." +"Your application can determine the size of the screen by using " +"the :data:`curses.LINES` and :data:`curses.COLS` variables to obtain the *y* " +"and *x* sizes. Legal coordinates will then extend from ``(0,0)`` to " +"``(curses.LINES - 1, curses.COLS - 1)``." msgstr "" msgid "" "When you call a method to display or erase text, the effect doesn't " -"immediately show up on the display. Instead you must call the :meth:" -"`~curses.window.refresh` method of window objects to update the screen." +"immediately show up on the display. Instead you must call " +"the :meth:`~curses.window.refresh` method of window objects to update the " +"screen." msgstr "" msgid "" "This is because curses was originally written with slow 300-baud terminal " "connections in mind; with these terminals, minimizing the time required to " "redraw the screen was very important. Instead curses accumulates changes to " -"the screen and displays them in the most efficient manner when you call :" -"meth:`!refresh`. For example, if your program displays some text in a " +"the screen and displays them in the most efficient manner when you " +"call :meth:`!refresh`. For example, if your program displays some text in a " "window and then clears the window, there's no need to send the original text " "because they're never visible." msgstr "" @@ -361,9 +363,9 @@ msgstr "" msgid "" "Fortunately the Python interface hides all these details. ``stdscr`` is a " -"window object like any other, and methods such as :meth:`~curses.window." -"addstr` accept multiple argument forms. Usually there are four different " -"forms." +"window object like any other, and methods such " +"as :meth:`~curses.window.addstr` accept multiple argument forms. Usually " +"there are four different forms." msgstr "" msgid "Form" @@ -409,9 +411,10 @@ msgstr "" msgid "" "The :meth:`~curses.window.addstr` method takes a Python string or bytestring " "as the value to be displayed. The contents of bytestrings are sent to the " -"terminal as-is. Strings are encoded to bytes using the value of the " -"window's :attr:`~window.encoding` attribute; this defaults to the default " -"system encoding as returned by :func:`locale.getencoding`." +"terminal as-is. On a build without wide-character support strings are " +"encoded using the value of the window's :attr:`~window.encoding` attribute; " +"this defaults to the default system encoding as returned " +"by :func:`locale.getencoding`." msgstr "" msgid "" @@ -420,10 +423,10 @@ msgid "" msgstr "" msgid "" -"Constants are provided for extension characters; these constants are " -"integers greater than 255. For example, :const:`ACS_PLMINUS` is a +/- " -"symbol, and :const:`ACS_ULCORNER` is the upper left corner of a box (handy " -"for drawing borders). You can also use the appropriate Unicode character." +"Constants are provided for the characters of the terminal's alternate " +"character set. For example, :const:`ACS_PLMINUS` is a +/- symbol, " +"and :const:`ACS_ULCORNER` is the upper left corner of a box (handy for " +"drawing borders). You can also use the appropriate Unicode character." msgstr "" msgid "" @@ -438,11 +441,10 @@ msgstr "" msgid "" "If your application doesn't need a blinking cursor at all, you can call " -"``curs_set(False)`` to make it invisible. For compatibility with older " -"curses versions, there's a ``leaveok(bool)`` function that's a synonym for :" -"func:`~curses.curs_set`. When *bool* is true, the curses library will " -"attempt to suppress the flashing cursor, and you won't need to worry about " -"leaving it in odd locations." +"``curs_set(False)`` to make it invisible. The window " +"method :meth:`~curses.window.leaveok` does something different: when its " +"argument is true, curses leaves the cursor wherever the last update put it, " +"instead of moving it back to the window's cursor position." msgstr "" msgid "Attributes and Color" @@ -534,10 +536,10 @@ msgstr "" msgid "" "The curses library maintains a finite number of color pairs, containing a " "foreground (or text) color and a background color. You can get the " -"attribute value corresponding to a color pair with the :func:`~curses." -"color_pair` function; this can be bitwise-OR'ed with other attributes such " -"as :const:`A_REVERSE`, but again, such combinations are not guaranteed to " -"work on all terminals." +"attribute value corresponding to a color pair with " +"the :func:`~curses.color_pair` function; this can be bitwise-OR'ed with " +"other attributes such as :const:`A_REVERSE`, but again, such combinations " +"are not guaranteed to work on all terminals." msgstr "" msgid "An example, which displays a line of text using color pair 1::" @@ -557,10 +559,10 @@ msgstr "" msgid "" "Colors are numbered, and :func:`start_color` initializes 8 basic colors when " -"it activates color mode. They are: 0:black, 1:red, 2:green, 3:yellow, 4:" -"blue, 5:magenta, 6:cyan, and 7:white. The :mod:`curses` module defines " -"named constants for each of these colors: :const:`curses.COLOR_BLACK`, :" -"const:`curses.COLOR_RED`, and so forth." +"it activates color mode. They are: 0:black, 1:red, 2:green, 3:yellow, " +"4:blue, 5:magenta, 6:cyan, and 7:white. The :mod:`curses` module defines " +"named constants for each of these " +"colors: :const:`curses.COLOR_BLACK`, :const:`curses.COLOR_RED`, and so forth." msgstr "" msgid "" @@ -585,64 +587,70 @@ msgid "" "given RGB value. This lets you change color 1, which is usually red, to " "purple or blue or any other color you like. Unfortunately, the Linux " "console doesn't support this, so I'm unable to try it out, and can't provide " -"any examples. You can check if your terminal can do this by calling :func:" -"`~curses.can_change_color`, which returns ``True`` if the capability is " -"there. If you're lucky enough to have such a talented terminal, consult " -"your system's man pages for more information." +"any examples. You can check if your terminal can do this by " +"calling :func:`~curses.can_change_color`, which returns ``True`` if the " +"capability is there. If you're lucky enough to have such a talented " +"terminal, consult your system's man pages for more information." msgstr "" msgid "User Input" msgstr "" msgid "" -"The C curses library offers only very simple input mechanisms. Python's :mod:" -"`curses` module adds a basic text-input widget. (Other libraries such as :" -"pypi:`Urwid` have more extensive collections of widgets.)" +"The C curses library offers only very simple input mechanisms. " +"Python's :mod:`curses` module adds a basic text-input widget. (Other " +"libraries such as :pypi:`Urwid` have more extensive collections of widgets.)" msgstr "" -msgid "There are two methods for getting input from a window:" +msgid "There are three methods for getting input from a window:" msgstr "" msgid "" -":meth:`~curses.window.getch` refreshes the screen and then waits for the " +":meth:`~curses.window.get_wch` refreshes the screen and then waits for the " "user to hit a key, displaying the key if :func:`~curses.echo` has been " "called earlier. You can optionally specify a coordinate to which the cursor " "should be moved before pausing." msgstr "" msgid "" -":meth:`~curses.window.getkey` does the same thing but converts the integer " -"to a string. Individual characters are returned as 1-character strings, and " -"special keys such as function keys return longer strings containing a key " -"name such as ``KEY_UP`` or ``^G``." +":meth:`~curses.window.getch` does the same thing but returns the code of the " +"key instead of a character. With ncurses this is a single byte of the key's " +"encoding in the current locale, so a character encoded with several bytes " +"takes several calls, one byte per call." msgstr "" msgid "" -"It's possible to not wait for the user using the :meth:`~curses.window." -"nodelay` window method. After ``nodelay(True)``, :meth:`!getch` and :meth:`!" -"getkey` for the window become non-blocking. To signal that no input is " -"ready, :meth:`!getch` returns ``curses.ERR`` (a value of -1) and :meth:`!" -"getkey` raises an exception. There's also a :func:`~curses.halfdelay` " -"function, which can be used to (in effect) set a timer on each :meth:`!" -"getch`; if no input becomes available within a specified delay (measured in " -"tenths of a second), curses raises an exception." +":meth:`~curses.window.getkey` does the same as :meth:`!getch` but returns a " +"string: an ordinary key as a 1-character string, and a special key as its " +"name, such as ``KEY_UP``." msgstr "" msgid "" -"The :meth:`!getch` method returns an integer; if it's between 0 and 255, it " -"represents the ASCII code of the key pressed. Values greater than 255 are " -"special keys such as Page Up, Home, or the cursor keys. You can compare the " -"value returned to constants such as :const:`curses.KEY_PPAGE`, :const:" -"`curses.KEY_HOME`, or :const:`curses.KEY_LEFT`. The main loop of your " -"program may look something like this::" +"It's possible to not wait for the user using " +"the :meth:`~curses.window.nodelay` window method. After ``nodelay(True)``, " +"the reads for the window become non-blocking. To signal that no input is " +"ready, :meth:`!get_wch` and :meth:`!getkey` raise an exception, and :meth:`!" +"getch` returns ``-1``. There's also a :func:`~curses.halfdelay` function, " +"which can be used to (in effect) set a timer on each read; if no input " +"becomes available within a specified delay (measured in tenths of a second), " +"the read fails the same way." +msgstr "" + +msgid "" +"Special keys such as Page Up, Home, or the cursor keys are returned by all " +"three as one of the :ref:`KEY_* constants `, all " +"larger than 255. You can compare the value returned to constants such " +"as :const:`curses.KEY_PPAGE`, :const:`curses.KEY_HOME`, " +"or :const:`curses.KEY_LEFT`. The main loop of your program may look " +"something like this::" msgstr "" msgid "" "while True:\n" -" c = stdscr.getch()\n" -" if c == ord('p'):\n" +" c = stdscr.get_wch()\n" +" if c == 'p':\n" " PrintDocument()\n" -" elif c == ord('q'):\n" +" elif c == 'q':\n" " break # Exit the while loop\n" " elif c == curses.KEY_HOME:\n" " x = y = 0" @@ -658,25 +666,27 @@ msgid "" msgstr "" msgid "" -"There's also a method to retrieve an entire string, :meth:`~curses.window." -"getstr`. It isn't used very often, because its functionality is quite " -"limited; the only editing keys available are the backspace key and the Enter " -"key, which terminates the string. It can optionally be limited to a fixed " -"number of characters. ::" +"There's also a method to retrieve an entire " +"line, :meth:`~curses.window.getstr`. It isn't used very often, because its " +"functionality is quite limited; the only editing keys available are the " +"erase and kill characters, and the Enter key, which terminates the line. It " +"returns a bytes object, and can optionally be limited to a fixed number of " +"bytes. ::" msgstr "" msgid "" "curses.echo() # Enable echoing of characters\n" "\n" -"# Get a 15-character string, with the cursor on the top line\n" +"# Get a line of at most 15 bytes, with the cursor on the top line\n" "s = stdscr.getstr(0,0, 15)" msgstr "" msgid "" "The :mod:`curses.textpad` module supplies a text box that supports an Emacs-" -"like set of keybindings. Various methods of the :class:`~curses.textpad." -"Textbox` class support editing with input validation and gathering the edit " -"results either with or without trailing spaces. Here's an example::" +"like set of keybindings. Various methods of " +"the :class:`~curses.textpad.Textbox` class support editing with input " +"validation and gathering the edit results either with or without trailing " +"spaces. Here's an example::" msgstr "" msgid "" @@ -717,8 +727,8 @@ msgid "" "If you're in doubt about the detailed behavior of the curses functions, " "consult the manual pages for your curses implementation, whether it's " "ncurses or a proprietary Unix vendor's. The manual pages will document any " -"quirks, and provide complete lists of all the functions, attributes, and :" -"ref:`ACS_\\* ` characters available to you." +"quirks, and provide complete lists of all the functions, attributes, " +"and :ref:`ACS_\\* ` characters available to you." msgstr "" msgid "" @@ -726,8 +736,8 @@ msgid "" "Python interface. Often this isn't because they're difficult to implement, " "but because no one has needed them yet. Also, Python doesn't yet support " "the menu library associated with ncurses. Patches adding support for these " -"would be welcome; see `the Python Developer's Guide `_ to learn more about submitting patches to Python." +"would be welcome; see `the Python Developer's Guide `_ to learn more about submitting patches to Python." msgstr "" msgid "" diff --git a/howto/descriptor.po b/howto/descriptor.po index e519a96da2..0c9e731752 100644 --- a/howto/descriptor.po +++ b/howto/descriptor.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -68,8 +68,9 @@ msgstr "" msgid "" "The last section has pure Python equivalents for built-in descriptors that " "are written in C. Read this if you're curious about how functions turn into " -"bound methods or about the implementation of common tools like :func:" -"`classmethod`, :func:`staticmethod`, :func:`property`, and :term:`__slots__`." +"bound methods or about the implementation of common tools " +"like :deco:`classmethod`, :deco:`staticmethod`, :deco:`property`, " +"and :term:`__slots__`." msgstr "" msgid "Primer" @@ -199,8 +200,9 @@ msgid "" "A popular use for descriptors is managing access to instance data. The " "descriptor is assigned to a public attribute in the class dictionary while " "the actual data is stored as a private attribute in the instance " -"dictionary. The descriptor's :meth:`~object.__get__` and :meth:`~object." -"__set__` methods are triggered when the public attribute is accessed." +"dictionary. The descriptor's :meth:`~object.__get__` " +"and :meth:`~object.__set__` methods are triggered when the public attribute " +"is accessed." msgstr "" msgid "" @@ -328,9 +330,10 @@ msgid "" msgstr "" msgid "" -"An interactive session shows that the :class:`!Person` class has called :" -"meth:`~object.__set_name__` so that the field names would be recorded. Here " -"we call :func:`vars` to look up the descriptor without triggering it:" +"An interactive session shows that the :class:`!Person` class has " +"called :meth:`~object.__set_name__` so that the field names would be " +"recorded. Here we call :func:`vars` to look up the descriptor without " +"triggering it:" msgstr "" msgid "" @@ -370,8 +373,9 @@ msgid "Closing thoughts" msgstr "" msgid "" -"A :term:`descriptor` is what we call any object that defines :meth:`~object." -"__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`." +"A :term:`descriptor` is what we call any object that " +"defines :meth:`~object.__get__`, :meth:`~object.__set__`, " +"or :meth:`~object.__delete__`." msgstr "" msgid "" @@ -405,9 +409,9 @@ msgstr "" msgid "" "Descriptors are used throughout the language. It is how functions turn into " -"bound methods. Common tools like :func:`classmethod`, :func:" -"`staticmethod`, :func:`property`, and :func:`functools.cached_property` are " -"all implemented as descriptors." +"bound methods. Common tools " +"like :deco:`classmethod`, :deco:`staticmethod`, :deco:`property`, " +"and :deco:`functools.cached_property` are all implemented as descriptors." msgstr "" msgid "Complete Practical Example" @@ -469,9 +473,9 @@ msgid "" msgstr "" msgid "" -":class:`!Number` verifies that a value is either an :class:`int` or :class:" -"`float`. Optionally, it verifies that a value is between a given minimum or " -"maximum." +":class:`!Number` verifies that a value is either an :class:`int` " +"or :class:`float`. Optionally, it verifies that a value is between a given " +"minimum or maximum." msgstr "" msgid "" @@ -610,9 +614,10 @@ msgstr "" msgid "" "In general, a descriptor is an attribute value that has one of the methods " -"in the descriptor protocol. Those methods are :meth:`~object.__get__`, :" -"meth:`~object.__set__`, and :meth:`~object.__delete__`. If any of those " -"methods are defined for an attribute, it is said to be a :term:`descriptor`." +"in the descriptor protocol. Those methods " +"are :meth:`~object.__get__`, :meth:`~object.__set__`, " +"and :meth:`~object.__delete__`. If any of those methods are defined for an " +"attribute, it is said to be a :term:`descriptor`." msgstr "" msgid "" @@ -628,10 +633,10 @@ msgstr "" msgid "" "Descriptors are a powerful, general purpose protocol. They are the " -"mechanism behind properties, methods, static methods, class methods, and :" -"func:`super`. They are used throughout Python itself. Descriptors simplify " -"the underlying C code and offer a flexible set of new tools for everyday " -"Python programs." +"mechanism behind properties, methods, static methods, class methods, " +"and :func:`super`. They are used throughout Python itself. Descriptors " +"simplify the underlying C code and offer a flexible set of new tools for " +"everyday Python programs." msgstr "" msgid "Descriptor protocol" @@ -654,9 +659,9 @@ msgstr "" msgid "" "If an object defines :meth:`~object.__set__` or :meth:`~object.__delete__`, " -"it is considered a data descriptor. Descriptors that only define :meth:" -"`~object.__get__` are called non-data descriptors (they are often used for " -"methods but other uses are possible)." +"it is considered a data descriptor. Descriptors that only " +"define :meth:`~object.__get__` are called non-data descriptors (they are " +"often used for methods but other uses are possible)." msgstr "" msgid "" @@ -669,17 +674,18 @@ msgstr "" msgid "" "To make a read-only data descriptor, define both :meth:`~object.__get__` " -"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising an :exc:" -"`AttributeError` when called. Defining the :meth:`~object.__set__` method " -"with an exception raising placeholder is enough to make it a data descriptor." +"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising " +"an :exc:`AttributeError` when called. Defining the :meth:`~object.__set__` " +"method with an exception raising placeholder is enough to make it a data " +"descriptor." msgstr "" msgid "Overview of descriptor invocation" msgstr "" msgid "" -"A descriptor can be called directly with ``desc.__get__(obj)`` or ``desc." -"__get__(None, cls)``." +"A descriptor can be called directly with ``desc.__get__(obj)`` or " +"``desc.__get__(None, cls)``." msgstr "" msgid "" @@ -710,8 +716,8 @@ msgid "" msgstr "" msgid "" -"If a descriptor is found for ``a.x``, then it is invoked with: ``desc." -"__get__(a, type(a))``." +"If a descriptor is found for ``a.x``, then it is invoked with: " +"``desc.__get__(a, type(a))``." msgstr "" msgid "" @@ -748,17 +754,18 @@ msgid "" msgstr "" msgid "" -"Note, there is no :meth:`~object.__getattr__` hook in the :meth:`~object." -"__getattribute__` code. That is why calling :meth:`~object." -"__getattribute__` directly or with ``super().__getattribute__`` will bypass :" -"meth:`~object.__getattr__` entirely." +"Note, there is no :meth:`~object.__getattr__` hook in " +"the :meth:`~object.__getattribute__` code. That is why " +"calling :meth:`~object.__getattribute__` directly or with " +"``super().__getattribute__`` will bypass :meth:`~object.__getattr__` " +"entirely." msgstr "" msgid "" "Instead, it is the dot operator and the :func:`getattr` function that are " -"responsible for invoking :meth:`~object.__getattr__` whenever :meth:`~object." -"__getattribute__` raises an :exc:`AttributeError`. Their logic is " -"encapsulated in a helper function:" +"responsible for invoking :meth:`~object.__getattr__` " +"whenever :meth:`~object.__getattribute__` raises an :exc:`AttributeError`. " +"Their logic is encapsulated in a helper function:" msgstr "" msgid "" @@ -776,38 +783,39 @@ msgid "Invocation from a class" msgstr "" msgid "" -"The logic for a dotted lookup such as ``A.x`` is in :meth:`!type." -"__getattribute__`. The steps are similar to those for :meth:`!object." -"__getattribute__` but the instance dictionary lookup is replaced by a search " -"through the class's :term:`method resolution order`." +"The logic for a dotted lookup such as ``A.x`` is in :meth:`!" +"type.__getattribute__`. The steps are similar to those for :meth:`!" +"object.__getattribute__` but the instance dictionary lookup is replaced by a " +"search through the class's :term:`method resolution order`." msgstr "" msgid "If a descriptor is found, it is invoked with ``desc.__get__(None, A)``." msgstr "" msgid "" -"The full C implementation can be found in :c:func:`!type_getattro` and :c:" -"func:`!_PyType_Lookup` in :source:`Objects/typeobject.c`." +"The full C implementation can be found in :c:func:`!type_getattro` " +"and :c:func:`!_PyType_Lookup` in :source:`Objects/typeobject.c`." msgstr "" msgid "Invocation from super" msgstr "" msgid "" -"The logic for super's dotted lookup is in the :meth:`~object." -"__getattribute__` method for object returned by :func:`super`." +"The logic for super's dotted lookup is in " +"the :meth:`~object.__getattribute__` method for object returned " +"by :func:`super`." msgstr "" msgid "" -"A dotted lookup such as ``super(A, obj).m`` searches ``obj.__class__." -"__mro__`` for the base class ``B`` immediately following ``A`` and then " -"returns ``B.__dict__['m'].__get__(obj, A)``. If not a descriptor, ``m`` is " -"returned unchanged." +"A dotted lookup such as ``super(A, obj).m`` searches " +"``obj.__class__.__mro__`` for the base class ``B`` immediately following " +"``A`` and then returns ``B.__dict__['m'].__get__(obj, A)``. If not a " +"descriptor, ``m`` is returned unchanged." msgstr "" msgid "" -"The full C implementation can be found in :c:func:`!super_getattro` in :" -"source:`Objects/typeobject.c`. A pure Python equivalent can be found in " +"The full C implementation can be found in :c:func:`!super_getattro` " +"in :source:`Objects/typeobject.c`. A pure Python equivalent can be found in " "`Guido's Tutorial `_." msgstr "" @@ -816,9 +824,9 @@ msgid "Summary of invocation logic" msgstr "" msgid "" -"The mechanism for descriptors is embedded in the :meth:`~object." -"__getattribute__` methods for :class:`object`, :class:`type`, and :func:" -"`super`." +"The mechanism for descriptors is embedded in " +"the :meth:`~object.__getattribute__` methods " +"for :class:`object`, :class:`type`, and :func:`super`." msgstr "" msgid "The important points to remember are:" @@ -828,8 +836,8 @@ msgid "Descriptors are invoked by the :meth:`~object.__getattribute__` method." msgstr "" msgid "" -"Classes inherit this machinery from :class:`object`, :class:`type`, or :func:" -"`super`." +"Classes inherit this machinery from :class:`object`, :class:`type`, " +"or :func:`super`." msgstr "" msgid "" @@ -878,8 +886,8 @@ msgstr "" msgid "" "The following code is a simplified skeleton showing how data descriptors " -"could be used to implement an `object relational mapping `_." +"could be used to implement an `object relational mapping `_." msgstr "" msgid "" @@ -906,9 +914,9 @@ msgid "" msgstr "" msgid "" -"We can use the :class:`!Field` class to define `models `_ that describe the schema for each table in a " -"database:" +"We can use the :class:`!Field` class to define `models `_ that describe the schema for each " +"table in a database:" msgstr "" msgid "" @@ -1124,10 +1132,10 @@ msgid "" msgstr "" msgid "" -"To support automatic creation of methods, functions include the :meth:" -"`~object.__get__` method for binding methods during attribute access. This " -"means that functions are non-data descriptors that return bound methods " -"during dotted lookup from an instance. Here's how it works:" +"To support automatic creation of methods, functions include " +"the :meth:`~object.__get__` method for binding methods during attribute " +"access. This means that functions are non-data descriptors that return " +"bound methods during dotted lookup from an instance. Here's how it works:" msgstr "" msgid "" @@ -1167,8 +1175,9 @@ msgstr "" "'D.f'" msgid "" -"Accessing the function through the class dictionary does not invoke :meth:" -"`~object.__get__`. Instead, it just returns the underlying function object::" +"Accessing the function through the class dictionary does not " +"invoke :meth:`~object.__get__`. Instead, it just returns the underlying " +"function object::" msgstr "" msgid "" @@ -1278,10 +1287,10 @@ msgstr "" msgid "" "Static methods return the underlying function without changes. Calling " -"either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into ``object." -"__getattribute__(c, \"f\")`` or ``object.__getattribute__(C, \"f\")``. As a " -"result, the function becomes identically accessible from either an object or " -"a class." +"either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into " +"``object.__getattribute__(c, \"f\")`` or ``object.__getattribute__(C, " +"\"f\")``. As a result, the function becomes identically accessible from " +"either an object or a class." msgstr "" msgid "" @@ -1324,8 +1333,8 @@ msgstr "" "30" msgid "" -"Using the non-data descriptor protocol, a pure Python version of :func:" -"`staticmethod` would look like this:" +"Using the non-data descriptor protocol, a pure Python version " +"of :deco:`staticmethod` would look like this:" msgstr "" msgid "" @@ -1353,8 +1362,8 @@ msgid "" "The :func:`functools.update_wrapper` call adds a ``__wrapped__`` attribute " "that refers to the underlying function. Also it carries forward the " "attributes necessary to make the wrapper look like the wrapped function, " -"including :attr:`~function.__name__`, :attr:`~function.__qualname__`, and :" -"attr:`~function.__doc__`." +"including :attr:`~function.__name__`, :attr:`~function.__qualname__`, " +"and :attr:`~function.__doc__`." msgstr "" msgid "Class methods" @@ -1415,8 +1424,8 @@ msgid "" msgstr "" msgid "" -"Using the non-data descriptor protocol, a pure Python version of :func:" -"`classmethod` would look like this:" +"Using the non-data descriptor protocol, a pure Python version " +"of :deco:`classmethod` would look like this:" msgstr "" msgid "" @@ -1439,9 +1448,9 @@ msgid "" "The :func:`functools.update_wrapper` call in ``ClassMethod`` adds a " "``__wrapped__`` attribute that refers to the underlying function. Also it " "carries forward the attributes necessary to make the wrapper look like the " -"wrapped function: :attr:`~function.__name__`, :attr:`~function." -"__qualname__`, :attr:`~function.__doc__`, and :attr:`~function." -"__annotations__`." +"wrapped " +"function: :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__`, " +"and :attr:`~function.__annotations__`." msgstr "" msgid "Member objects and __slots__" @@ -1522,7 +1531,7 @@ msgid "" msgstr "" msgid "" -"5. Blocks tools like :func:`functools.cached_property` which require an " +"5. Blocks tools like :deco:`functools.cached_property` which require an " "instance dictionary to function correctly:" msgstr "" diff --git a/howto/enum.po b/howto/enum.po index 3a0b409792..fad9584271 100644 --- a/howto/enum.po +++ b/howto/enum.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -255,8 +255,8 @@ msgstr "" msgid "" ">>> chores_for_ethan = {\n" -"... 'feed the cat': Weekday.MONDAY | Weekday.WEDNESDAY | Weekday." -"FRIDAY,\n" +"... 'feed the cat': Weekday.MONDAY | Weekday.WEDNESDAY | " +"Weekday.FRIDAY,\n" "... 'do the dishes': Weekday.TUESDAY | Weekday.THURSDAY,\n" "... 'answer SO questions': Weekday.SATURDAY,\n" "... }" @@ -297,8 +297,8 @@ msgid "Programmatic access to enumeration members and their attributes" msgstr "" msgid "" -"Sometimes it's useful to access members in enumerations programmatically (i." -"e. situations where ``Color.RED`` won't do because the exact color is not " +"Sometimes it's useful to access members in enumerations programmatically " +"(i.e. situations where ``Color.RED`` won't do because the exact color is not " "known at program-writing time). ``Enum`` allows such access::" msgstr "" @@ -394,7 +394,7 @@ msgstr "" msgid "" "By default, enumerations allow multiple names as aliases for the same value. " -"When this behavior isn't desired, you can use the :func:`unique` decorator::" +"When this behavior isn't desired, you can use the :deco:`unique` decorator::" msgstr "" msgid "" @@ -464,9 +464,9 @@ msgid "" ">>> list(Shape)\n" "[, , ]\n" ">>> list(Weekday)\n" -"[, , , , , , ]" +"[, , , " +", , , " +"]" msgstr "" msgid "" @@ -618,22 +618,23 @@ msgid "" "The rules for what is allowed are as follows: names that start and end with " "a single underscore are reserved by enum and cannot be used; all other " "attributes defined within an enumeration will become members of this " -"enumeration, with the exception of special methods (:meth:`~object." -"__str__`, :meth:`~object.__add__`, etc.), descriptors (methods are also " -"descriptors), and variable names listed in :attr:`~Enum._ignore_`." +"enumeration, with the exception of special methods " +"(:meth:`~object.__str__`, :meth:`~object.__add__`, etc.), descriptors " +"(methods are also descriptors), and variable names listed " +"in :attr:`~Enum._ignore_`." msgstr "" msgid "" -"Note: if your enumeration defines :meth:`~object.__new__` and/or :meth:" -"`~object.__init__`, any value(s) given to the enum member will be passed " -"into those methods. See `Planet`_ for an example." +"Note: if your enumeration defines :meth:`~object.__new__` and/" +"or :meth:`~object.__init__`, any value(s) given to the enum member will be " +"passed into those methods. See `Planet`_ for an example." msgstr "" msgid "" "The :meth:`~object.__new__` method, if defined, is used during creation of " "the Enum members; it is then replaced by Enum's :meth:`~object.__new__` " -"which is used after class creation for lookup of existing members. See :ref:" -"`new-vs-init` for more details." +"which is used after class creation for lookup of existing members. " +"See :ref:`new-vs-init` for more details." msgstr "" msgid "Restricted Enum subclassing" @@ -689,8 +690,8 @@ msgid "Dataclass support" msgstr "" msgid "" -"When inheriting from a :class:`~dataclasses.dataclass`, the :meth:`~Enum." -"__repr__` omits the inherited class' name. For example::" +"When inheriting from a :class:`~dataclasses.dataclass`, " +"the :meth:`~Enum.__repr__` omits the inherited class' name. For example::" msgstr "" msgid "" @@ -720,7 +721,7 @@ msgid "" msgstr "" msgid "" -"Adding :func:`~dataclasses.dataclass` decorator to :class:`Enum` and its " +"Adding :deco:`~dataclasses.dataclass` decorator to :class:`Enum` and its " "subclasses is not supported. It will not raise any errors, but it will " "produce very strange results at runtime, such as members being equal to each " "other::" @@ -763,9 +764,10 @@ msgid "" msgstr "" msgid "" -"It is possible to modify how enum members are pickled/unpickled by defining :" -"meth:`~object.__reduce_ex__` in the enumeration class. The default method " -"is by-value, but enums with complicated values may want to use by-name::" +"It is possible to modify how enum members are pickled/unpickled by " +"defining :meth:`~object.__reduce_ex__` in the enumeration class. The " +"default method is by-value, but enums with complicated values may want to " +"use by-name::" msgstr "" msgid "" @@ -848,10 +850,10 @@ msgid "" msgstr "" msgid "" -"The new pickle protocol 4 also, in some circumstances, relies on :attr:" -"`~type.__qualname__` being set to the location where pickle will be able to " -"find the class. For example, if the class was made available in class " -"SomeData in the global scope::" +"The new pickle protocol 4 also, in some circumstances, relies " +"on :attr:`~type.__qualname__` being set to the location where pickle will be " +"able to find the class. For example, if the class was made available in " +"class SomeData in the global scope::" msgstr "" msgid "" @@ -925,10 +927,10 @@ msgid "IntEnum" msgstr "" msgid "" -"The first variation of :class:`Enum` that is provided is also a subclass of :" -"class:`int`. Members of an :class:`IntEnum` can be compared to integers; by " -"extension, integer enumerations of different types can also be compared to " -"each other::" +"The first variation of :class:`Enum` that is provided is also a subclass " +"of :class:`int`. Members of an :class:`IntEnum` can be compared to " +"integers; by extension, integer enumerations of different types can also be " +"compared to each other::" msgstr "" msgid "" @@ -997,9 +999,9 @@ msgid "" "The next variation of :class:`Enum` provided, :class:`IntFlag`, is also " "based on :class:`int`. The difference being :class:`IntFlag` members can be " "combined using the bitwise operators (&, \\|, ^, ~) and the result is still " -"an :class:`IntFlag` member, if possible. Like :class:`IntEnum`, :class:" -"`IntFlag` members are also integers and can be used wherever an :class:`int` " -"is used." +"an :class:`IntFlag` member, if possible. " +"Like :class:`IntEnum`, :class:`IntFlag` members are also integers and can be " +"used wherever an :class:`int` is used." msgstr "" msgid "" @@ -1056,8 +1058,8 @@ msgstr "" msgid "" "Another important difference between :class:`IntFlag` and :class:`Enum` is " -"that if no flags are set (the value is 0), its boolean evaluation is :data:" -"`False`::" +"that if no flags are set (the value is 0), its boolean evaluation " +"is :data:`False`::" msgstr "" msgid "" @@ -1116,10 +1118,10 @@ msgstr "" msgid "" "The last variation is :class:`Flag`. Like :class:`IntFlag`, :class:`Flag` " -"members can be combined using the bitwise operators (&, \\|, ^, ~). Unlike :" -"class:`IntFlag`, they cannot be combined with, nor compared against, any " -"other :class:`Flag` enumeration, nor :class:`int`. While it is possible to " -"specify the values directly it is recommended to use :class:`auto` as the " +"members can be combined using the bitwise operators (&, \\|, ^, ~). " +"Unlike :class:`IntFlag`, they cannot be combined with, nor compared against, " +"any other :class:`Flag` enumeration, nor :class:`int`. While it is possible " +"to specify the values directly it is recommended to use :class:`auto` as the " "value and let :class:`Flag` select an appropriate value." msgstr "" @@ -1191,10 +1193,10 @@ msgid "" "For the majority of new code, :class:`Enum` and :class:`Flag` are strongly " "recommended, since :class:`IntEnum` and :class:`IntFlag` break some semantic " "promises of an enumeration (by being comparable to integers, and thus by " -"transitivity to other unrelated enumerations). :class:`IntEnum` and :class:" -"`IntFlag` should be used only in cases where :class:`Enum` and :class:`Flag` " -"will not do; for example, when integer constants are replaced with " -"enumerations, or for interoperability with other systems." +"transitivity to other unrelated enumerations). :class:`IntEnum` " +"and :class:`IntFlag` should be used only in cases where :class:`Enum` " +"and :class:`Flag` will not do; for example, when integer constants are " +"replaced with enumerations, or for interoperability with other systems." msgstr "" msgid "Others" @@ -1212,30 +1214,30 @@ msgstr "" msgid "" "This demonstrates how similar derived enumerations can be defined; for " -"example a :class:`!FloatEnum` that mixes in :class:`float` instead of :class:" -"`int`." +"example a :class:`!FloatEnum` that mixes in :class:`float` instead " +"of :class:`int`." msgstr "" msgid "Some rules:" msgstr "" msgid "" -"When subclassing :class:`Enum`, mix-in types must appear before the :class:" -"`Enum` class itself in the sequence of bases, as in the :class:`IntEnum` " -"example above." +"When subclassing :class:`Enum`, mix-in types must appear before " +"the :class:`Enum` class itself in the sequence of bases, as in " +"the :class:`IntEnum` example above." msgstr "" msgid "" -"Mix-in types must be subclassable. For example, :class:`bool` and :class:" -"`range` are not subclassable and will throw an error during Enum creation if " -"used as the mix-in type." +"Mix-in types must be subclassable. For example, :class:`bool` " +"and :class:`range` are not subclassable and will throw an error during Enum " +"creation if used as the mix-in type." msgstr "" msgid "" "While :class:`Enum` can have members of any type, once you mix in an " -"additional type, all the members must have values of that type, e.g. :class:" -"`int` above. This restriction does not apply to mix-ins which only add " -"methods and don't specify another type." +"additional type, all the members must have values of that type, " +"e.g. :class:`int` above. This restriction does not apply to mix-ins which " +"only add methods and don't specify another type." msgstr "" msgid "" @@ -1245,27 +1247,27 @@ msgid "" msgstr "" msgid "" -"A ``data type`` is a mixin that defines :meth:`~object.__new__`, or a :class:" -"`~dataclasses.dataclass`" +"A ``data type`` is a mixin that defines :meth:`~object.__new__`, or " +"a :class:`~dataclasses.dataclass`" msgstr "" msgid "" -"%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` class's :meth:" -"`~object.__str__` and :meth:`~object.__repr__` respectively; other codes " -"(such as ``%i`` or ``%h`` for IntEnum) treat the enum member as its mixed-in " -"type." +"%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` " +"class's :meth:`~object.__str__` and :meth:`~object.__repr__` respectively; " +"other codes (such as ``%i`` or ``%h`` for IntEnum) treat the enum member as " +"its mixed-in type." msgstr "" msgid "" -":ref:`Formatted string literals `, :meth:`str.format`, and :func:" -"`format` will use the enum's :meth:`~object.__str__` method." +":ref:`Formatted string literals `, :meth:`str.format`, " +"and :func:`format` will use the enum's :meth:`~object.__str__` method." msgstr "" msgid "" "Because :class:`IntEnum`, :class:`IntFlag`, and :class:`StrEnum` are " -"designed to be drop-in replacements for existing constants, their :meth:" -"`~object.__str__` method has been reset to their data types' :meth:`~object." -"__str__` method." +"designed to be drop-in replacements for existing constants, " +"their :meth:`~object.__str__` method has been reset to their data " +"types' :meth:`~object.__str__` method." msgstr "" msgid "When to use :meth:`~object.__new__` vs. :meth:`~object.__init__`" @@ -1274,8 +1276,8 @@ msgstr "" msgid "" ":meth:`~object.__new__` must be used whenever you want to customize the " "actual value of the :class:`Enum` member. Any other modifications may go in " -"either :meth:`~object.__new__` or :meth:`~object.__init__`, with :meth:" -"`~object.__init__` being preferred." +"either :meth:`~object.__new__` or :meth:`~object.__init__`, " +"with :meth:`~object.__init__` being preferred." msgstr "" msgid "" @@ -1319,8 +1321,8 @@ msgid "Supported ``__dunder__`` and ``_sunder_`` names" msgstr "" msgid "" -"The supported ``__dunder__`` and ``_sunder_`` names can be found in the :ref:" -"`Enum API documentation `." +"The supported ``__dunder__`` and ``_sunder_`` names can be found in " +"the :ref:`Enum API documentation `." msgstr "" msgid "_Private__names" @@ -1364,11 +1366,11 @@ msgid "Boolean value of ``Enum`` classes and members" msgstr "" msgid "" -"Enum classes that are mixed with non-:class:`Enum` types (such as :class:" -"`int`, :class:`str`, etc.) are evaluated according to the mixed-in type's " -"rules; otherwise, all members evaluate as :data:`True`. To make your own " -"enum's boolean evaluation depend on the member's value add the following to " -"your class::" +"Enum classes that are mixed with non-:class:`Enum` types (such " +"as :class:`int`, :class:`str`, etc.) are evaluated according to the mixed-in " +"type's rules; otherwise, all members evaluate as :data:`True`. To make your " +"own enum's boolean evaluation depend on the member's value add the following " +"to your class::" msgstr "" msgid "" @@ -1562,30 +1564,30 @@ msgstr "" msgid "" "The default for Flag is ``STRICT``, the default for ``IntFlag`` is " -"``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see ``ssl." -"Options`` for an example of when ``KEEP`` is needed)." +"``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see " +"``ssl.Options`` for an example of when ``KEEP`` is needed)." msgstr "" msgid "How are Enums and Flags different?" msgstr "" msgid "" -"Enums have a custom metaclass that affects many aspects of both derived :" -"class:`Enum` classes and their instances (members)." +"Enums have a custom metaclass that affects many aspects of both " +"derived :class:`Enum` classes and their instances (members)." msgstr "" msgid "Enum Classes" msgstr "" msgid "" -"The :class:`EnumType` metaclass is responsible for providing the :meth:" -"`~object.__contains__`, :meth:`~object.__dir__`, :meth:`~object.__iter__` " +"The :class:`EnumType` metaclass is responsible for providing " +"the :meth:`~object.__contains__`, :meth:`~object.__dir__`, :meth:`~object.__iter__` " "and other methods that allow one to do things with an :class:`Enum` class " "that fail on a typical class, such as ``list(Color)`` or ``some_enum_var in " "Color``. :class:`EnumType` is responsible for ensuring that various other " -"methods on the final :class:`Enum` class are correct (such as :meth:`~object." -"__new__`, :meth:`~object.__getnewargs__`, :meth:`~object.__str__` and :meth:" -"`~object.__repr__`)." +"methods on the final :class:`Enum` class are correct (such " +"as :meth:`~object.__new__`, :meth:`~object.__getnewargs__`, :meth:`~object.__str__` " +"and :meth:`~object.__repr__`)." msgstr "" msgid "Flag Classes" @@ -1594,8 +1596,8 @@ msgstr "" msgid "" "Flags have an expanded view of aliasing: to be canonical, the value of a " "flag needs to be a power-of-two value, and not a duplicate name. So, in " -"addition to the :class:`Enum` definition of alias, a flag with no value (a.k." -"a. ``0``) or with more than one power-of-two value (e.g. ``3``) is " +"addition to the :class:`Enum` definition of alias, a flag with no value " +"(a.k.a. ``0``) or with more than one power-of-two value (e.g. ``3``) is " "considered an alias." msgstr "" @@ -1603,11 +1605,11 @@ msgid "Enum Members (aka instances)" msgstr "" msgid "" -"The most interesting thing about enum members is that they are singletons. :" -"class:`EnumType` creates them all while it is creating the enum class " -"itself, and then puts a custom :meth:`~object.__new__` in place to ensure " -"that no new ones are ever instantiated by returning only the existing member " -"instances." +"The most interesting thing about enum members is that they are " +"singletons. :class:`EnumType` creates them all while it is creating the enum " +"class itself, and then puts a custom :meth:`~object.__new__` in place to " +"ensure that no new ones are ever instantiated by returning only the existing " +"member instances." msgstr "" msgid "Flag Members" @@ -1656,10 +1658,11 @@ msgid "Enum Cookbook" msgstr "" msgid "" -"While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, and :" -"class:`IntFlag` are expected to cover the majority of use-cases, they cannot " -"cover them all. Here are recipes for some different types of enumerations " -"that can be used directly, or as examples for creating one's own." +"While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, " +"and :class:`IntFlag` are expected to cover the majority of use-cases, they " +"cannot cover them all. Here are recipes for some different types of " +"enumerations that can be used directly, or as examples for creating one's " +"own." msgstr "" msgid "Omitting values" @@ -1723,8 +1726,8 @@ msgid "" msgstr "" msgid "" -"This is also a good example of why you might want to write your own :meth:" -"`~object.__repr__`::" +"This is also a good example of why you might want to write your " +"own :meth:`~object.__repr__`::" msgstr "" msgid "" @@ -1978,11 +1981,11 @@ msgid "" "... Period['day_%d' % i] = i\n" "...\n" ">>> list(Period)[:2]\n" -"[, ]\n" +"[, ]\n" ">>> list(Period)[-2:]\n" -"[, ]" +"[, ]" msgstr "" msgid "Subclassing EnumType" diff --git a/howto/free-threading-extensions.po b/howto/free-threading-extensions.po index 621d0cb9a6..062b791867 100644 --- a/howto/free-threading-extensions.po +++ b/howto/free-threading-extensions.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,9 +27,9 @@ msgid "C API Extension Support for Free Threading" msgstr "" msgid "" -"Starting with the 3.13 release, CPython has support for running with the :" -"term:`global interpreter lock` (GIL) disabled in a configuration called :" -"term:`free threading`. This document describes how to adapt C API " +"Starting with the 3.13 release, CPython has support for running with " +"the :term:`global interpreter lock` (GIL) disabled in a configuration " +"called :term:`free threading`. This document describes how to adapt C API " "extensions to support free threading." msgstr "" @@ -75,10 +75,10 @@ msgid "Multi-Phase Initialization" msgstr "" msgid "" -"Extensions that use multi-phase initialization (i.e., :c:func:" -"`PyModuleDef_Init`) should add a :c:data:`Py_mod_gil` slot in the module " -"definition. If your extension supports older versions of CPython, you " -"should guard the slot with a :c:data:`PY_VERSION_HEX` check." +"Extensions that use multi-phase initialization " +"(i.e., :c:func:`PyModuleDef_Init`) should add a :c:data:`Py_mod_gil` slot in " +"the module definition. If your extension supports older versions of " +"CPython, you should guard the slot with a :c:data:`PY_VERSION_HEX` check." msgstr "" msgid "" @@ -101,11 +101,12 @@ msgid "Single-Phase Initialization" msgstr "" msgid "" -"Extensions that use single-phase initialization (i.e., :c:func:" -"`PyModule_Create`) should call :c:func:`PyUnstable_Module_SetGIL` to " -"indicate that they support running with the GIL disabled. The function is " -"only defined in the free-threaded build, so you should guard the call with " -"``#ifdef Py_GIL_DISABLED`` to avoid compilation errors in the regular build." +"Extensions that use single-phase initialization " +"(i.e., :c:func:`PyModule_Create`) should " +"call :c:func:`PyUnstable_Module_SetGIL` to indicate that they support " +"running with the GIL disabled. The function is only defined in the free-" +"threaded build, so you should guard the call with ``#ifdef Py_GIL_DISABLED`` " +"to avoid compilation errors in the regular build." msgstr "" msgid "" @@ -140,11 +141,12 @@ msgid "" msgstr "" msgid "" -"**Macros**: Accessor macros like :c:macro:`PyList_GET_ITEM`, :c:macro:" -"`PyList_SET_ITEM`, and macros like :c:macro:`PySequence_Fast_GET_SIZE` that " -"use the object returned by :c:func:`PySequence_Fast` do not perform any " -"error checking or locking. These macros are not thread-safe if the container " -"object may be modified concurrently." +"**Macros**: Accessor macros " +"like :c:macro:`PyList_GET_ITEM`, :c:macro:`PyList_SET_ITEM`, and macros " +"like :c:macro:`PySequence_Fast_GET_SIZE` that use the object returned " +"by :c:func:`PySequence_Fast` do not perform any error checking or locking. " +"These macros are not thread-safe if the container object may be modified " +"concurrently." msgstr "" msgid "" @@ -158,10 +160,10 @@ msgid "Container Thread Safety" msgstr "" msgid "" -"Containers like :c:struct:`PyListObject`, :c:struct:`PyDictObject`, and :c:" -"struct:`PySetObject` perform internal locking in the free-threaded build. " -"For example, the :c:func:`PyList_Append` will lock the list before appending " -"an item." +"Containers like :c:struct:`PyListObject`, :c:struct:`PyDictObject`, " +"and :c:struct:`PySetObject` perform internal locking in the free-threaded " +"build. For example, the :c:func:`PyList_Append` will lock the list before " +"appending an item." msgstr "" msgid "``PyDict_Next``" @@ -190,8 +192,8 @@ msgstr "" msgid "" "Some C API functions return :term:`borrowed references `. These APIs are not thread-safe if the containing object is " -"modified concurrently. For example, it's not safe to use :c:func:" -"`PyList_GetItem` if the list may be modified concurrently." +"modified concurrently. For example, it's not safe to " +"use :c:func:`PyList_GetItem` if the list may be modified concurrently." msgstr "" msgid "" @@ -263,13 +265,13 @@ msgid ":c:func:`PyCell_Get`" msgstr ":c:func:`PyCell_Get`" msgid "" -"Not all APIs that return borrowed references are problematic. For example, :" -"c:func:`PyTuple_GetItem` is safe because tuples are immutable. Similarly, " -"not all uses of the above APIs are problematic. For example, :c:func:" -"`PyDict_GetItem` is often used for parsing keyword argument dictionaries in " -"function calls; those keyword argument dictionaries are effectively private " -"(not accessible by other threads), so using borrowed references in that " -"context is safe." +"Not all APIs that return borrowed references are problematic. For " +"example, :c:func:`PyTuple_GetItem` is safe because tuples are immutable. " +"Similarly, not all uses of the above APIs are problematic. For " +"example, :c:func:`PyDict_GetItem` is often used for parsing keyword argument " +"dictionaries in function calls; those keyword argument dictionaries are " +"effectively private (not accessible by other threads), so using borrowed " +"references in that context is safe." msgstr "" msgid "" @@ -282,18 +284,20 @@ msgid "Memory Allocation APIs" msgstr "" msgid "" -"Python's memory management C API provides functions in three different :ref:" -"`allocation domains `: \"raw\", \"mem\", and \"object\". " -"For thread-safety, the free-threaded build requires that only Python objects " -"are allocated using the object domain, and that all Python objects are " -"allocated using that domain. This differs from the prior Python versions, " -"where this was only a best practice and not a hard requirement." +"Python's memory management C API provides functions in three " +"different :ref:`allocation domains `: \"raw\", \"mem\", " +"and \"object\". For thread-safety, the free-threaded build requires that " +"only Python objects are allocated using the object domain, and that all " +"Python objects are allocated using that domain. This differs from the prior " +"Python versions, where this was only a best practice and not a hard " +"requirement." msgstr "" msgid "" "Search for uses of :c:func:`PyObject_Malloc` in your extension and check " -"that the allocated memory is used for Python objects. Use :c:func:" -"`PyMem_Malloc` to allocate buffers instead of :c:func:`PyObject_Malloc`." +"that the allocated memory is used for Python objects. " +"Use :c:func:`PyMem_Malloc` to allocate buffers instead " +"of :c:func:`PyObject_Malloc`." msgstr "" msgid "Thread State and GIL APIs" @@ -322,10 +326,10 @@ msgid "" msgstr "" msgid "" -"You should continue to call :c:func:`PyEval_SaveThread` or :c:macro:" -"`Py_BEGIN_ALLOW_THREADS` around blocking operations, such as I/O or lock " -"acquisitions, to allow other threads to run the :term:`cyclic garbage " -"collector `." +"You should continue to call :c:func:`PyEval_SaveThread` " +"or :c:macro:`Py_BEGIN_ALLOW_THREADS` around blocking operations, such as I/O " +"or lock acquisitions, to allow other threads to run the :term:`cyclic " +"garbage collector `." msgstr "" msgid "Protecting Internal Extension State" @@ -368,9 +372,9 @@ msgid "" "Conceptually, critical sections act as a deadlock avoidance layer built on " "top of simple mutexes. Each thread maintains a stack of active critical " "sections. When a thread needs to acquire a lock associated with a critical " -"section (e.g., implicitly when calling a thread-safe C API function like :c:" -"func:`PyDict_SetItem`, or explicitly using macros), it attempts to acquire " -"the underlying mutex." +"section (e.g., implicitly when calling a thread-safe C API function " +"like :c:func:`PyDict_SetItem`, or explicitly using macros), it attempts to " +"acquire the underlying mutex." msgstr "" msgid "Using Critical Sections" @@ -385,8 +389,9 @@ msgid "" msgstr "" msgid "" -":c:macro:`Py_BEGIN_CRITICAL_SECTION2` and :c:macro:" -"`Py_END_CRITICAL_SECTION2` - For locking two objects simultaneously" +":c:macro:`Py_BEGIN_CRITICAL_SECTION2` " +"and :c:macro:`Py_END_CRITICAL_SECTION2` - For locking two objects " +"simultaneously" msgstr "" msgid "" diff --git a/howto/free-threading-python.po b/howto/free-threading-python.po index 3af6a51a45..b128fb3383 100644 --- a/howto/free-threading-python.po +++ b/howto/free-threading-python.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-21 15:07+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -78,9 +78,9 @@ msgstr "" msgid "" "To check if the current interpreter supports free-threading, :option:`python " -"-VV <-V>` and :data:`sys.version` contain \"free-threading build\". The new :" -"func:`sys._is_gil_enabled` function can be used to check whether the GIL is " -"actually disabled in the running process." +"-VV <-V>` and :data:`sys.version` contain \"free-threading build\". The " +"new :func:`sys._is_gil_enabled` function can be used to check whether the " +"GIL is actually disabled in the running process." msgstr "" msgid "" @@ -124,10 +124,8 @@ msgid "" "behavior at the Python level to the default GIL-enabled build. Built-in " "types like :class:`dict`, :class:`list`, and :class:`set` use internal locks " "to protect against concurrent modifications in ways that behave similarly to " -"the GIL. However, Python has not historically guaranteed specific behavior " -"for concurrent modifications to these built-in types, so this should be " -"treated as a description of the current implementation, not a guarantee of " -"current or future behavior." +"the GIL. See :ref:`threadsafety` for the guarantees provided by built-in " +"types." msgstr "" msgid "" @@ -205,23 +203,188 @@ msgid "Context variables" msgstr "" msgid "" -"In the free-threaded build, the flag :data:`~sys.flags." -"thread_inherit_context` is set to true by default which causes threads " -"created with :class:`threading.Thread` to start with a copy of the :class:" -"`~contextvars.Context()` of the caller of :meth:`~threading.Thread.start`. " -"In the default GIL-enabled build, the flag defaults to false so threads " -"start with an empty :class:`~contextvars.Context()`." +"In the free-threaded build, the " +"flag :data:`~sys.flags.thread_inherit_context` is set to true by default " +"which causes threads created with :class:`threading.Thread` to start with a " +"copy of the :class:`~contextvars.Context()` of the caller " +"of :meth:`~threading.Thread.start`. In the default GIL-enabled build, the " +"flag defaults to false so threads start with an " +"empty :class:`~contextvars.Context()`." msgstr "" msgid "Warning filters" msgstr "" msgid "" -"In the free-threaded build, the flag :data:`~sys.flags." -"context_aware_warnings` is set to true by default. In the default GIL-" -"enabled build, the flag defaults to false. If the flag is true then the :" -"class:`warnings.catch_warnings` context manager uses a context variable for " -"warning filters. If the flag is false then :class:`~warnings." -"catch_warnings` modifies the global filters list, which is not thread-safe. " -"See the :mod:`warnings` module for more details." +"In the free-threaded build, the " +"flag :data:`~sys.flags.context_aware_warnings` is set to true by default. " +"In the default GIL-enabled build, the flag defaults to false. If the flag " +"is true then the :class:`warnings.catch_warnings` context manager uses a " +"context variable for warning filters. If the flag is false " +"then :class:`~warnings.catch_warnings` modifies the global filters list, " +"which is not thread-safe. See the :mod:`warnings` module for more details." +msgstr "" + +msgid "Increased memory usage" +msgstr "" + +msgid "" +"The free-threaded build will typically use more memory compared to the " +"default build. There are multiple reasons for this, mostly due to design " +"decisions." +msgstr "" + +msgid "All interned strings are immortal" +msgstr "" + +msgid "" +"For modern Python versions (since version 2.3), interning a string (e.g. " +"with :func:`sys.intern`) does not cause it to become immortal. Instead, if " +"the last reference to that string disappears, it will be removed from the " +"interned string table. This is not the case for the free-threaded build and " +"any interned string will become immortal, surviving until interpreter " +"shutdown." +msgstr "" + +msgid "Non-GC objects have a larger object header" +msgstr "" + +msgid "" +"The free-threaded build uses a different :c:type:`PyObject` structure. " +"Instead of having the GC related information allocated before " +"the :c:type:`PyObject` structure, like in the default build, the GC related " +"info is part of the normal object header. For example, on the AMD64 " +"platform, ``None`` uses 32 bytes on the free-threaded build vs 16 bytes for " +"the default build. GC objects (such as dicts and lists) are the same size " +"for both builds since the free-threaded build does not use additional space " +"for the GC info." +msgstr "" + +msgid "QSBR can delay freeing of memory" +msgstr "" + +msgid "" +"In order to safely implement lock-free data structures, a safe memory " +"reclamation (SMR) scheme is used, known as quiescent state-based reclamation " +"(QSBR). This means that the memory backing data structures allowing lock-" +"free access will use QSBR, which defers the free operation, rather than " +"immediately freeing the memory. Two examples of these data structures are " +"the list object and the dictionary keys object. See ``InternalDocs/" +"qsbr.md`` in the CPython source tree for more details on how QSBR is " +"implemented. Running :func:`gc.collect` should cause all memory being held " +"by QSBR to be actually freed. Note that even when QSBR frees the memory, " +"the underlying memory allocator may not immediately return that memory to " +"the OS and so the resident set size (RSS) of the process might not decrease." +msgstr "" + +msgid "mimalloc allocator vs pymalloc" +msgstr "" + +msgid "" +"The default build will normally use the \"pymalloc\" memory allocator for " +"small allocations (512 bytes or smaller). The free-threaded build does not " +"use pymalloc and allocates all Python objects using the \"mimalloc\" " +"allocator. The pymalloc allocator has the following properties that help " +"keep memory usage low: small per-allocated-block overhead, effective memory " +"fragmentation prevention, and quick return of free memory to the operating " +"system. The mimalloc allocator does quite well in these respects as well " +"but can have some more overhead." +msgstr "" + +msgid "" +"In the free-threaded build, mimalloc manages memory in a number of separate " +"heaps (currently four). For example, all GC supporting objects are " +"allocated from their own heap. Using separate heaps means that free memory " +"in one heap cannot be used for an allocation that uses another heap. Also, " +"some heaps are configured to use QSBR (quiescent-state based reclamation) " +"when freeing the memory that backs up the heap (known as \"pages\" in " +"mimalloc terminology). The use of QSBR creates a delay between all memory " +"blocks for a page being freed and the memory page being released, either for " +"new allocations or back to the OS." +msgstr "" + +msgid "" +"The mimalloc allocator also defers returning freed memory back to the OS. " +"You can reduce that delay by setting the environment variable :envvar:`!" +"MIMALLOC_PURGE_DELAY` to ``0``. Note that this will likely reduce the " +"performance of the allocator." +msgstr "" + +msgid "Free-threaded reference counting can cause objects to live longer" +msgstr "" + +msgid "" +"In the default build, when an object's reference count reaches zero, it is " +"normally deallocated. The free-threaded build uses \"biased reference " +"counting\", with a fast-path for objects \"owned\" by the current thread and " +"a slow path for other objects. See :pep:`703` for additional details. Any " +"time an object's reference count ends up in a \"queued\" state, deallocation " +"can be deferred. The queued state is cleared from the \"eval breaker\" " +"section of the bytecode evaluator." +msgstr "" + +msgid "" +"The free-threaded build also allows a different mode of reference counting, " +"known as \"deferred reference counting\". This mode is enabled by setting a " +"flag on a per-object basis. Deferred reference counting is enabled for the " +"following types:" +msgstr "" + +msgid "module objects" +msgstr "" + +msgid "module top-level functions" +msgstr "" + +msgid "class methods defined in the class scope" +msgstr "" + +msgid "descriptor objects" +msgstr "" + +msgid "thread-local objects, created by :class:`threading.local`" +msgstr "" + +msgid "" +"When deferred reference counting is enabled, references from Python function " +"stacks are not added to the reference count. This scheme reduces the " +"overhead of reference counting, especially for objects used from multiple " +"threads. Because the stack references are not counted, objects with deferred " +"reference counting are not immediately freed when their internal reference " +"count goes to zero. Instead, they are examined by the next GC run and, if " +"no stack references to them are found, they are freed. This means these " +"objects are freed by the GC and not when their reference count goes to zero, " +"as is typical." +msgstr "" + +msgid "Per-thread reference counting can delay freeing objects" +msgstr "" + +msgid "" +"To avoid contention on the reference count fields of frequently shared " +"objects, the free-threaded build also uses \"per-thread reference counting\" " +"for a few selected object types. Rather than updating a single shared " +"reference count, each thread maintains its own local reference count array, " +"indexed by a unique id assigned to the object. The true reference count is " +"only computed by summing the per-thread counts when the object's local count " +"drops to zero. Per-thread reference counting is currently used for:" +msgstr "" + +msgid "heap type objects (classes created in Python)" +msgstr "" + +msgid "code objects" +msgstr "" + +msgid "the ``__dict__`` of module objects" +msgstr "" + +msgid "" +"Because the per-thread counts must be merged back to the object before it " +"can be deallocated, objects using per-thread reference counting are " +"typically freed later than they would be in the default build. In " +"particular, such an object is usually not freed until the thread that " +"referenced it reaches a safe point (for example, in the \"eval breaker\" " +"section of the bytecode evaluator) or exits. Running :func:`gc.collect` " +"will merge the per-thread counts and allow these objects to be freed." msgstr "" diff --git a/howto/functional.po b/howto/functional.po index d0371dd494..8cdd51d022 100644 --- a/howto/functional.po +++ b/howto/functional.po @@ -4,16 +4,18 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Ciarbin , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,7 +26,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Functional Programming HOWTO" -msgstr "" +msgstr "Poradnik programowania funkcyjnego" msgid "Author" msgstr "Autor" @@ -41,10 +43,15 @@ msgstr "0.32" msgid "" "In this document, we'll take a tour of Python's features suitable for " "implementing programs in a functional style. After an introduction to the " -"concepts of functional programming, we'll look at language features such as :" -"term:`iterator`\\s and :term:`generator`\\s and relevant library modules " +"concepts of functional programming, we'll look at language features such " +"as :term:`iterator`\\s and :term:`generator`\\s and relevant library modules " "such as :mod:`itertools` and :mod:`functools`." msgstr "" +"W niniejszym dokumencie omówimy elementy języka Python, które nadają się do " +"tworzenia programów w stylu funkcyjnym. Po wprowadzeniu do koncepcji " +"programowania funkcyjnego przyjrzymy się takim elementom języka, " +"jak :term:`iterator`\\s i :term:`generator`\\s, a także odpowiednim modułom " +"bibliotecznym, takim jak :mod:`itertools` i :mod:`functools`." msgid "Introduction" msgstr "Wprowadzenie" @@ -54,16 +61,25 @@ msgid "" "just interested in learning about Python language features, skip to the next " "section on :ref:`functional-howto-iterators`." msgstr "" +"W tej sekcji wyjaśniono podstawowe pojęcia programowania funkcyjnego; jeśli " +"chcesz po prostu zapoznać się z elementami języka Python, przejdź do " +"następnej sekcji poświęconej :ref:`functional-howto-iterators`." msgid "" "Programming languages support decomposing problems in several different ways:" msgstr "" +"Języki programowania umożliwiają rozkładanie problemów na czynniki pierwsze " +"na kilka różnych sposobów:" msgid "" "Most programming languages are **procedural**: programs are lists of " "instructions that tell the computer what to do with the program's input. C, " "Pascal, and even Unix shells are procedural languages." msgstr "" +"Większość języków programowania ma charakter **proceduralny**: programy są " +"listami instrukcji, które wskazują komputerowi, co ma zrobić z danymi " +"wejściowymi programu. Języki C, Pascal, a nawet powłoki systemu Unix są " +"językami proceduralnymi." msgid "" "In **declarative** languages, you write a specification that describes the " @@ -73,6 +89,13 @@ msgid "" "to retrieve, and the SQL engine decides whether to scan tables or use " "indexes, which subclauses should be performed first, etc." msgstr "" +"W językach **deklaratywnych** pisze się specyfikację opisującą problem, " +"który ma zostać rozwiązany, a implementacja języka sama ustala, jak " +"efektywnie przeprowadzić obliczenia. SQL jest językiem deklaratywnym, który " +"najprawdopodobniej znasz najlepiej; zapytanie SQL opisuje zbiór danych, " +"który chcesz pobrać, a silnik SQL decyduje, czy przeszukiwać tabele, czy " +"korzystać z indeksów, które podklauzule należy wykonać w pierwszej " +"kolejności itp." msgid "" "**Object-oriented** programs manipulate collections of objects. Objects " @@ -81,6 +104,11 @@ msgid "" "and Python are languages that support object-oriented programming, but don't " "force the use of object-oriented features." msgstr "" +"Programy **obiektowe** operują na zbiorach obiektów. Obiekty posiadają stan " +"wewnętrzny oraz metody, które w jakiś sposób sprawdzają lub modyfikują ten " +"stan. Smalltalk i Java to języki obiektowe. C++ i Python to języki, które " +"obsługują programowanie obiektowe, ale nie wymuszają stosowania funkcji " +"obiektowych." msgid "" "**Functional** programming decomposes a problem into a set of functions. " @@ -89,6 +117,11 @@ msgid "" "known functional languages include the ML family (Standard ML, OCaml, and " "other variants) and Haskell." msgstr "" +"Programowanie **funkcyjne** polega na rozłożeniu problemu na zbiór funkcji. " +"W idealnym przypadku funkcje przyjmują jedynie dane wejściowe i generują " +"wyniki, nie posiadając żadnego stanu wewnętrznego, który wpływałby na wynik " +"generowany dla danego wejścia. Do dobrze znanych języków funkcyjnych należą " +"języki z rodziny ML (Standard ML, OCaml i inne warianty) oraz Haskell." msgid "" "The designers of some computer languages choose to emphasize one particular " @@ -101,6 +134,15 @@ msgid "" "GUI might be object-oriented while the processing logic is procedural or " "functional, for example." msgstr "" +"Twórcy niektórych języków programowania decydują się na podkreślenie jednego " +"konkretnego podejścia do programowania. Często utrudnia to pisanie programów " +"wykorzystujących inne podejście. Inne języki są językami " +"wieloparadygmatycznymi, które obsługują kilka różnych podejść. Lisp, C++ i " +"Python są językami wieloparadygmatycznymi; we wszystkich tych językach można " +"pisać programy lub biblioteki, które są w dużej mierze proceduralne, " +"obiektowe lub funkcyjne. W dużym programie różne sekcje mogą być napisane z " +"wykorzystaniem różnych podejść; na przykład interfejs graficzny może być " +"obiektowy, podczas gdy logika przetwarzania jest proceduralna lub funkcyjna." msgid "" "In a functional program, input flows through a set of functions. Each " @@ -316,9 +358,10 @@ msgid "" "iterator argument and will return the largest or smallest element. The " "``\"in\"`` and ``\"not in\"`` operators also support iterators: ``X in " "iterator`` is true if X is found in the stream returned by the iterator. " -"You'll run into obvious problems if the iterator is infinite; :func:`max`, :" -"func:`min` will never return, and if the element X never appears in the " -"stream, the ``\"in\"`` and ``\"not in\"`` operators won't return either." +"You'll run into obvious problems if the iterator is " +"infinite; :func:`max`, :func:`min` will never return, and if the element X " +"never appears in the stream, the ``\"in\"`` and ``\"not in\"`` operators " +"won't return either." msgstr "" msgid "" @@ -373,8 +416,9 @@ msgstr "" msgid "" "Applying :func:`iter` to a dictionary always loops over the keys, but " "dictionaries have methods that return other iterators. If you want to " -"iterate over values or key/value pairs, you can explicitly call the :meth:" -"`~dict.values` or :meth:`~dict.items` methods to get an appropriate iterator." +"iterate over values or key/value pairs, you can explicitly call " +"the :meth:`~dict.values` or :meth:`~dict.items` methods to get an " +"appropriate iterator." msgstr "" msgid "" @@ -655,9 +699,9 @@ msgid "" msgstr "" msgid "" -"In Python 2.5 there's a simple way to pass values into a generator. :keyword:" -"`yield` became an expression, returning a value that can be assigned to a " -"variable or otherwise operated on::" +"In Python 2.5 there's a simple way to pass values into a " +"generator. :keyword:`yield` became an expression, returning a value that can " +"be assigned to a variable or otherwise operated on::" msgstr "" msgid "val = (yield i)" @@ -681,8 +725,9 @@ msgstr "" msgid "" "Values are sent into a generator by calling its :meth:`send(value) " "` method. This method resumes the generator's code and the " -"``yield`` expression returns the specified value. If the regular :meth:" -"`~generator.__next__` method is called, the ``yield`` returns ``None``." +"``yield`` expression returns the specified value. If the " +"regular :meth:`~generator.__next__` method is called, the ``yield`` returns " +"``None``." msgstr "" msgid "" @@ -726,17 +771,17 @@ msgstr "" msgid "" ":meth:`~generator.close` sends a :exc:`GeneratorExit` exception to the " "generator to terminate the iteration. On receiving this exception, the " -"generator's code must either raise :exc:`GeneratorExit` or :exc:" -"`StopIteration`; catching the exception and doing anything else is illegal " -"and will trigger a :exc:`RuntimeError`. :meth:`~generator.close` will also " -"be called by Python's garbage collector when the generator is garbage-" -"collected." +"generator's code must either raise :exc:`GeneratorExit` " +"or :exc:`StopIteration`; catching the exception and doing anything else is " +"illegal and will trigger a :exc:`RuntimeError`. :meth:`~generator.close` " +"will also be called by Python's garbage collector when the generator is " +"garbage-collected." msgstr "" msgid "" "If you need to run cleanup code when a :exc:`GeneratorExit` occurs, I " -"suggest using a ``try: ... finally:`` suite instead of catching :exc:" -"`GeneratorExit`." +"suggest using a ``try: ... finally:`` suite instead of " +"catching :exc:`GeneratorExit`." msgstr "" msgid "" @@ -753,7 +798,7 @@ msgid "" msgstr "" msgid "Built-in functions" -msgstr "" +msgstr "Wbudowane funkcje" msgid "" "Let's look in more detail at built-in functions often used with iterators." @@ -765,11 +810,9 @@ msgid "" msgstr "" msgid "" -":func:`map(f, iterA, iterB, ...) ` returns an iterator over the sequence" -msgstr "" - -msgid "" -"``f(iterA[0], iterB[0]), f(iterA[1], iterB[1]), f(iterA[2], iterB[2]), ...``." +":func:`map(f, iterA, iterB, ...) ` returns an iterator over the " +"sequence ``f(iterA[0], iterB[0]), f(iterA[1], iterB[1]), f(iterA[2], " +"iterB[2]), ...``." msgstr "" msgid "You can of course achieve the same effect with a list comprehension." @@ -853,10 +896,10 @@ msgid "" msgstr "" msgid "" -"It doesn't construct an in-memory list and exhaust all the input iterators " -"before returning; instead tuples are constructed and returned only if " -"they're requested. (The technical term for this behaviour is `lazy " -"evaluation `__.)" +"It doesn't construct an in-memory list and :term:`exhaust ` all " +"the input iterators before returning; instead tuples are constructed and " +"returned only if they're requested. (The technical term for this behaviour " +"is `lazy evaluation `__.)" msgstr "" msgid "" @@ -948,7 +991,7 @@ msgid "" ":func:`itertools.chain(iterA, iterB, ...) ` takes an " "arbitrary number of iterables as input, and returns all the elements of the " "first iterator, then all the elements of the second, and so on, until all of " -"the iterables have been exhausted. ::" +"the iterables have been :term:`exhausted`. ::" msgstr "" msgid "" @@ -1000,10 +1043,11 @@ msgstr "" msgid "" "The :mod:`operator` module contains a set of functions corresponding to " -"Python's operators. Some examples are :func:`operator.add(a, b) ` (adds two values), :func:`operator.ne(a, b) ` (same as " -"``a != b``), and :func:`operator.attrgetter('id') ` " -"(returns a callable that fetches the ``.id`` attribute)." +"Python's operators. Some examples are :func:`operator.add(a, b) " +"` (adds two values), :func:`operator.ne(a, b) ` " +"(same as ``a != b``), and :func:`operator.attrgetter('id') " +"` (returns a callable that fetches the ``.id`` " +"attribute)." msgstr "" msgid "" @@ -1074,7 +1118,7 @@ msgid "" ":func:`itertools.compress(data, selectors) ` takes two " "iterators and returns only those elements of *data* for which the " "corresponding element of *selectors* is true, stopping whenever either one " -"is exhausted::" +"is :term:`exhausted`::" msgstr "" msgid "" @@ -1107,9 +1151,10 @@ msgstr "" msgid "" "The elements within each tuple remain in the same order as *iterable* " "returned them. For example, the number 1 is always before 2, 3, 4, or 5 in " -"the examples above. A similar function, :func:`itertools." -"permutations(iterable, r=None) `, removes this " -"constraint on the order, returning all possible arrangements of length *r*::" +"the examples above. A similar " +"function, :func:`itertools.permutations(iterable, r=None) " +"`, removes this constraint on the order, returning " +"all possible arrangements of length *r*::" msgstr "" msgid "" @@ -1148,11 +1193,11 @@ msgid "" msgstr "" msgid "" -"The :func:`itertools.combinations_with_replacement(iterable, r) ` function relaxes a different constraint: " -"elements can be repeated within a single tuple. Conceptually an element is " -"selected for the first position of each tuple and then is replaced before " -"the second element is selected. ::" +"The :func:`itertools.combinations_with_replacement(iterable, r) " +"` function relaxes a different " +"constraint: elements can be repeated within a single tuple. Conceptually an " +"element is selected for the first position of each tuple and then is " +"replaced before the second element is selected. ::" msgstr "" msgid "" @@ -1218,8 +1263,8 @@ msgstr "" msgid "" "The :mod:`functools` module contains some higher-order functions. A **higher-" "order function** takes one or more functions as input and returns a new " -"function. The most useful tool in this module is the :func:`functools." -"partial` function." +"function. The most useful tool in this module is " +"the :func:`functools.partial` function." msgstr "" msgid "" @@ -1257,14 +1302,15 @@ msgid "" ":func:`functools.reduce(func, iter, [initial_value]) ` " "cumulatively performs an operation on all the iterable's elements and, " "therefore, can't be applied to infinite iterables. *func* must be a function " -"that takes two elements and returns a single value. :func:`functools." -"reduce` takes the first two elements A and B returned by the iterator and " -"calculates ``func(A, B)``. It then requests the third element, C, " -"calculates ``func(func(A, B), C)``, combines this result with the fourth " -"element returned, and continues until the iterable is exhausted. If the " -"iterable returns no values at all, a :exc:`TypeError` exception is raised. " -"If the initial value is supplied, it's used as a starting point and " -"``func(initial_value, A)`` is the first calculation. ::" +"that takes two elements and returns a single " +"value. :func:`functools.reduce` takes the first two elements A and B " +"returned by the iterator and calculates ``func(A, B)``. It then requests " +"the third element, C, calculates ``func(func(A, B), C)``, combines this " +"result with the fourth element returned, and continues until the iterable " +"is :term:`exhausted`. If the iterable returns no values at all, " +"a :exc:`TypeError` exception is raised. If the initial value is supplied, " +"it's used as a starting point and ``func(initial_value, A)`` is the first " +"calculation. ::" msgstr "" msgid "" @@ -1274,7 +1320,7 @@ msgid "" ">>> functools.reduce(operator.concat, [])\n" "Traceback (most recent call last):\n" " ...\n" -"TypeError: reduce() of empty sequence with no initial value\n" +"TypeError: reduce() of empty iterable with no initial value\n" ">>> functools.reduce(operator.mul, [1, 2, 3], 1)\n" "6\n" ">>> functools.reduce(operator.mul, [], 1)\n" @@ -1304,10 +1350,11 @@ msgid "" msgstr "" msgid "" -"A related function is :func:`itertools.accumulate(iterable, func=operator." -"add) `. It performs the same calculation, but instead " -"of returning only the final result, :func:`~itertools.accumulate` returns an " -"iterator that also yields each partial result::" +"A related function is :func:`itertools.accumulate(iterable, " +"func=operator.add) `. It performs the same " +"calculation, but instead of returning only the final " +"result, :func:`~itertools.accumulate` returns an iterator that also yields " +"each partial result::" msgstr "" msgid "" diff --git a/howto/gdb_helpers.po b/howto/gdb_helpers.po index 9b40b85b36..47b5bd7a57 100644 --- a/howto/gdb_helpers.po +++ b/howto/gdb_helpers.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -54,8 +54,8 @@ msgstr "" msgid "" "This document assumes that you are familiar with the basics of GDB and the " -"CPython C API. It consolidates guidance from the `devguide `_ and the `Python wiki `_ and the `Python wiki `_." msgstr "" @@ -296,8 +296,8 @@ msgid "" msgstr "" msgid "" -"Again, the implementation details can be revealed with a cast to :c:expr:" -"`PyUnicodeObject *`::" +"Again, the implementation details can be revealed with a cast " +"to :c:expr:`PyUnicodeObject *`::" msgstr "" msgid "" @@ -408,9 +408,9 @@ msgid "" "9 0 1 0 0 0 3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 " "0 0 4 5', 'gsd.impossible_hints': 0, 'timer.__absolute_start_time__': , 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], dialog=, saved_game_model=, sudoku_maker=, 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=, 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], dialog=, saved_game_model=, sudoku_maker=, 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=, 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], dialog=, saved_game_model=, sudoku_maker=, 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=, 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], dialog=, saved_game_model=, sudoku_maker=, 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker= (), throwflag=0) at Python/ceval." -"c:2665\n" +"test/regrtest.py, line 1548, in (), throwflag=0) at Python/" +"ceval.c:2665\n" "2665 x = call_function(&sp, oparg);\n" "(gdb) py-list\n" "1543 # Run the tests in a context manager that temporary changes the " diff --git a/howto/index.po b/howto/index.po index f4b708fb99..4370587c17 100644 --- a/howto/index.po +++ b/howto/index.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Ciarbin , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Ciarbin , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,12 +33,16 @@ msgid "" "effort to foster documentation that's more detailed than the Python Library " "Reference." msgstr "" +"Poradniki dotyczące języka Python to dokumenty, które dogłębnie omawiają " +"konkretny temat. Zbiór ten, wzorowany na kolekcji poradników HOWTO w ramach " +"projektu Linux Documentation Project, stanowi próbę stworzenia dokumentacji " +"bardziej szczegółowej niż dokumentacja biblioteki standardowej Pythona." msgid "General:" -msgstr "" +msgstr "Ogólne:" msgid ":ref:`a-conceptual-overview-of-asyncio`" -msgstr "" +msgstr ":ref:`a-conceptual-overview-of-asyncio`" msgid ":ref:`annotations-howto`" msgstr ":ref:`annotations-howto`" @@ -76,7 +81,7 @@ msgid ":ref:`urllib-howto`" msgstr ":ref:`urllib-howto`" msgid "Advanced development:" -msgstr "" +msgstr "Tematy bardziej zaawansowane:" msgid ":ref:`curses-howto`" msgstr ":ref:`curses-howto`" @@ -103,7 +108,7 @@ msgid ":ref:`cporting-howto`" msgstr ":ref:`cporting-howto`" msgid "Debugging and profiling:" -msgstr "" +msgstr "Debugowanie i profilowanie:" msgid ":ref:`gdb`" msgstr ":ref:`gdb`" diff --git a/howto/instrumentation.po b/howto/instrumentation.po index 78296a9247..59acaafefd 100644 --- a/howto/instrumentation.po +++ b/howto/instrumentation.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -350,8 +350,9 @@ msgid "should instead read:" msgstr "" msgid "" -"probe process(\"python\").library(\"libpython3.6dm.so.1.0\")." -"mark(\"function__entry\") {" +"probe " +"process(\"python\").library(\"libpython3.6dm.so.1.0\").mark(\"function__entry\") " +"{" msgstr "" msgid "(assuming a :ref:`debug build ` of CPython 3.6)" @@ -528,8 +529,8 @@ msgid "" " lineno = $arg3;\n" " frameptr = $arg4\n" "}\n" -"probe python.function.return = process(\"python\")." -"mark(\"function__return\")\n" +"probe python.function.return = " +"process(\"python\").mark(\"function__return\")\n" "{\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" diff --git a/howto/ipaddress.po b/howto/ipaddress.po index aeab614912..df5231206e 100644 --- a/howto/ipaddress.po +++ b/howto/ipaddress.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -127,8 +127,8 @@ msgid "Defining Networks" msgstr "" msgid "" -"Host addresses are usually grouped together into IP networks, so :mod:" -"`ipaddress` provides a way to create, inspect and manipulate network " +"Host addresses are usually grouped together into IP networks, " +"so :mod:`ipaddress` provides a way to create, inspect and manipulate network " "definitions. IP network objects are constructed from strings that define the " "range of host addresses that are part of that network. The simplest form for " "that information is a \"network address/network prefix\" pair, where the " @@ -208,11 +208,11 @@ msgid "" "network, neither the address nor the network classes are sufficient. " "Notation like ``192.0.2.1/24`` is commonly used by network engineers and the " "people who write tools for firewalls and routers as shorthand for \"the host " -"``192.0.2.1`` on the network ``192.0.2.0/24``\", Accordingly, :mod:" -"`ipaddress` provides a set of hybrid classes that associate an address with " -"a particular network. The interface for creation is identical to that for " -"defining network objects, except that the address portion isn't constrained " -"to being a network address." +"``192.0.2.1`` on the network ``192.0.2.0/24``\", " +"Accordingly, :mod:`ipaddress` provides a set of hybrid classes that " +"associate an address with a particular network. The interface for creation " +"is identical to that for defining network objects, except that the address " +"portion isn't constrained to being a network address." msgstr "" msgid "" @@ -225,8 +225,8 @@ msgstr "" msgid "" "You've gone to the trouble of creating an IPv(4|6)(Address|Network|" -"Interface) object, so you probably want to get information about it. :mod:" -"`ipaddress` tries to make doing this easy and intuitive." +"Interface) object, so you probably want to get information about " +"it. :mod:`ipaddress` tries to make doing this easy and intuitive." msgstr "" msgid "Extracting the IP version::" @@ -420,9 +420,9 @@ msgstr "" msgid "" "To support use cases where it is useful to have access to this additional " -"detail, the individual class constructors actually raise the :exc:" -"`ValueError` subclasses :exc:`ipaddress.AddressValueError` and :exc:" -"`ipaddress.NetmaskValueError` to indicate exactly which part of the " +"detail, the individual class constructors actually raise " +"the :exc:`ValueError` subclasses :exc:`ipaddress.AddressValueError` " +"and :exc:`ipaddress.NetmaskValueError` to indicate exactly which part of the " "definition failed to parse correctly." msgstr "" diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 720fe309e7..01ba962cde 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -71,8 +71,8 @@ msgid "" msgstr "" msgid "" -"in parallel, managing \"sub-interpreters\" using :c:func:" -"`Py_NewInterpreter`/:c:func:`Py_EndInterpreter`." +"in parallel, managing \"sub-interpreters\" " +"using :c:func:`Py_NewInterpreter`/:c:func:`Py_EndInterpreter`." msgstr "" msgid "" @@ -271,8 +271,9 @@ msgstr "" msgid "" "An example of a module with per-module state is currently available as " -"`xxlimited `__; example module initialization shown at the bottom of the file." +"`xxlimited `__; example module initialization shown at the bottom of the " +"file." msgstr "" msgid "Opt-Out: Limiting to One Module Object per Process" @@ -397,8 +398,8 @@ msgid "" msgstr "" msgid "" -"Unlike static types, heap type objects are mutable by default. Use the :c:" -"macro:`Py_TPFLAGS_IMMUTABLETYPE` flag to prevent mutability." +"Unlike static types, heap type objects are mutable by default. Use " +"the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag to prevent mutability." msgstr "" msgid "" @@ -412,8 +413,8 @@ msgstr "" msgid "" "Heap types can be created by filling a :c:struct:`PyType_Spec` structure, a " -"description or \"blueprint\" of a class, and calling :c:func:" -"`PyType_FromModuleAndSpec` to construct a new class object." +"description or \"blueprint\" of a class, and " +"calling :c:func:`PyType_FromModuleAndSpec` to construct a new class object." msgstr "" msgid "" @@ -450,8 +451,8 @@ msgid "" msgstr "" msgid "" -"Please refer to the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` and :c:" -"member:`~PyTypeObject.tp_traverse` for additional considerations." +"Please refer to the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` " +"and :c:member:`~PyTypeObject.tp_traverse` for additional considerations." msgstr "" msgid "" @@ -488,18 +489,18 @@ msgid ":c:macro:`PY_VERSION_HEX`, if not using the stable ABI, or" msgstr "" msgid "" -":py:data:`sys.version_info` (via :c:func:`PySys_GetObject` and :c:func:" -"`PyArg_ParseTuple`)." +":py:data:`sys.version_info` (via :c:func:`PySys_GetObject` " +"and :c:func:`PyArg_ParseTuple`)." msgstr "" msgid "Delegating ``tp_traverse``" msgstr "" msgid "" -"If your traverse function delegates to the :c:member:`~PyTypeObject." -"tp_traverse` of its base class (or another type), ensure that " -"``Py_TYPE(self)`` is visited only once. Note that only heap type are " -"expected to visit the type in ``tp_traverse``." +"If your traverse function delegates to " +"the :c:member:`~PyTypeObject.tp_traverse` of its base class (or another " +"type), ensure that ``Py_TYPE(self)`` is visited only once. Note that only " +"heap type are expected to visit the type in ``tp_traverse``." msgstr "" msgid "For example, if your traverse function includes::" @@ -522,8 +523,8 @@ msgid "" msgstr "" msgid "" -"It is not necessary to handle the type's reference count in :c:member:" -"`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_clear`." +"It is not necessary to handle the type's reference count " +"in :c:member:`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_clear`." msgstr "" msgid "Defining ``tp_dealloc``" @@ -566,8 +567,8 @@ msgid "Not overriding ``tp_free``" msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_free` slot of a heap type must be set to :c:" -"func:`PyObject_GC_Del`. This is the default; do not override it." +"The :c:member:`~PyTypeObject.tp_free` slot of a heap type must be set " +"to :c:func:`PyObject_GC_Del`. This is the default; do not override it." msgstr "" msgid "Avoiding ``PyObject_New``" @@ -593,8 +594,8 @@ msgid "" msgstr "" msgid "" -"If the above is not possible (e.g. inside a custom ``tp_alloc``), call :c:" -"func:`PyObject_GC_New` or :c:func:`PyObject_GC_NewVar`::" +"If the above is not possible (e.g. inside a custom ``tp_alloc``), " +"call :c:func:`PyObject_GC_New` or :c:func:`PyObject_GC_NewVar`::" msgstr "" msgid "" @@ -647,8 +648,8 @@ msgid "" msgstr "" msgid "" -"The following Python code can illustrate the concept. ``Base." -"get_defining_class`` returns ``Base`` even if ``type(self) == Sub``:" +"The following Python code can illustrate the concept. " +"``Base.get_defining_class`` returns ``Base`` even if ``type(self) == Sub``:" msgstr "" msgid "" @@ -664,10 +665,10 @@ msgid "" msgstr "" msgid "" -"For a method to get its \"defining class\", it must use the :ref:" -"`METH_METHOD | METH_FASTCALL | METH_KEYWORDS ` :c:type:`calling convention ` and the " -"corresponding :c:type:`PyCMethod` signature::" +"For a method to get its \"defining class\", it must use " +"the :ref:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS ` :c:type:`calling convention ` and " +"the corresponding :c:type:`PyCMethod` signature::" msgstr "" msgid "" @@ -720,18 +721,19 @@ msgid "This is new in Python 3.11." msgstr "" msgid "" -"Slot methods—the fast C equivalents for special methods, such as :c:member:" -"`~PyNumberMethods.nb_add` for :py:attr:`~object.__add__` or :c:member:" -"`~PyTypeObject.tp_new` for initialization—have a very simple API that " -"doesn't allow passing in the defining class, unlike with :c:type:" -"`PyCMethod`. The same goes for getters and setters defined with :c:type:" -"`PyGetSetDef`." +"Slot methods—the fast C equivalents for special methods, such " +"as :c:member:`~PyNumberMethods.nb_add` for :py:attr:`~object.__add__` " +"or :c:member:`~PyTypeObject.tp_new` for initialization—have a very simple " +"API that doesn't allow passing in the defining class, unlike " +"with :c:type:`PyCMethod`. The same goes for getters and setters defined " +"with :c:type:`PyGetSetDef`." msgstr "" msgid "" -"To access the module state in these cases, use the :c:func:" -"`PyType_GetModuleByDef` function, and pass in the module definition. Once " -"you have the module, call :c:func:`PyModule_GetState` to get the state::" +"To access the module state in these cases, use " +"the :c:func:`PyType_GetModuleByDef` function, and pass in the module " +"definition. Once you have the module, call :c:func:`PyModule_GetState` to " +"get the state::" msgstr "" msgid "" @@ -765,11 +767,11 @@ msgid "" msgstr "" msgid "" -"Usually this is not an issue, because types created with :c:func:" -"`PyType_FromModuleAndSpec`, and their instances, hold a reference to the " -"module. However, you must be careful in reference counting when you " -"reference module state from other places, such as callbacks for external " -"libraries." +"Usually this is not an issue, because types created " +"with :c:func:`PyType_FromModuleAndSpec`, and their instances, hold a " +"reference to the module. However, you must be careful in reference counting " +"when you reference module state from other places, such as callbacks for " +"external libraries." msgstr "" msgid "Open Issues" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index ce64b4953f..77c2ce779c 100644 --- a/howto/logging-cookbook.po +++ b/howto/logging-cookbook.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -66,8 +66,8 @@ msgid "" "ch = logging.StreamHandler()\n" "ch.setLevel(logging.ERROR)\n" "# create formatter and add it to the handlers\n" -"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - " -"%(message)s')\n" +"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %" +"(message)s')\n" "fh.setFormatter(formatter)\n" "ch.setFormatter(formatter)\n" "# add the handlers to the logger\n" @@ -96,8 +96,8 @@ msgid "" "\n" "class Auxiliary:\n" " def __init__(self):\n" -" self.logger = logging.getLogger('spam_application.auxiliary." -"Auxiliary')\n" +" self.logger = " +"logging.getLogger('spam_application.auxiliary.Auxiliary')\n" " self.logger.info('creating an instance of Auxiliary')\n" "\n" " def do_something(self):\n" @@ -154,8 +154,8 @@ msgid "" " time.sleep(0.5)\n" "\n" "def main():\n" -" logging.basicConfig(level=logging.DEBUG, format='%(relativeCreated)6d " -"%(threadName)s %(message)s')\n" +" logging.basicConfig(level=logging.DEBUG, format='%(relativeCreated)6d %" +"(threadName)s %(message)s')\n" " info = {'stop': False}\n" " thread = threading.Thread(target=worker, args=(info,))\n" " thread.start()\n" @@ -226,8 +226,8 @@ msgid "" "ch = logging.StreamHandler()\n" "ch.setLevel(logging.ERROR)\n" "# create formatter and add it to the handlers\n" -"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - " -"%(message)s')\n" +"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %" +"(message)s')\n" "ch.setFormatter(formatter)\n" "fh.setFormatter(formatter)\n" "# add the handlers to logger\n" @@ -275,8 +275,8 @@ msgid "" "\n" "# set up logging to file - see previous section for more details\n" "logging.basicConfig(level=logging.DEBUG,\n" -" format='%(asctime)s %(name)-12s %(levelname)-8s " -"%(message)s',\n" +" format='%(asctime)s %(name)-12s %(levelname)-8s %" +"(message)s',\n" " datefmt='%m-%d %H:%M',\n" " filename='/tmp/myapp.log',\n" " filemode='w')\n" @@ -463,9 +463,9 @@ msgid "" "a function which only returns ``True`` if the level of the passed in record " "is at or below the specified level. Note that in this example I have defined " "the ``filter_maker`` in a test script ``main.py`` that I run from the " -"command line, so its module will be ``__main__`` - hence the ``__main__." -"filter_maker`` in the filter configuration. You will need to change that if " -"you define it in a different module." +"command line, so its module will be ``__main__`` - hence the " +"``__main__.filter_maker`` in the filter configuration. You will need to " +"change that if you define it in a different module." msgstr "" msgid "With the filter added, we can run ``main.py``, which in full is:" @@ -642,13 +642,13 @@ msgid "" msgstr "" msgid "" -"A common culprit which demonstrates sluggish behaviour is the :class:" -"`SMTPHandler`: sending emails can take a long time, for a number of reasons " -"outside the developer's control (for example, a poorly performing mail or " -"network infrastructure). But almost any network-based handler can block: " -"Even a :class:`SocketHandler` operation may do a DNS query under the hood " -"which is too slow (and this query can be deep in the socket library code, " -"below the Python layer, and outside your control)." +"A common culprit which demonstrates sluggish behaviour is " +"the :class:`SMTPHandler`: sending emails can take a long time, for a number " +"of reasons outside the developer's control (for example, a poorly performing " +"mail or network infrastructure). But almost any network-based handler can " +"block: Even a :class:`SocketHandler` operation may do a DNS query under the " +"hood which is too slow (and this query can be deep in the socket library " +"code, below the Python layer, and outside your control)." msgstr "" msgid "" @@ -666,12 +666,12 @@ msgstr "" msgid "" "The second part of the solution is :class:`QueueListener`, which has been " -"designed as the counterpart to :class:`QueueHandler`. A :class:" -"`QueueListener` is very simple: it's passed a queue and some handlers, and " -"it fires up an internal thread which listens to its queue for LogRecords " -"sent from ``QueueHandlers`` (or any other source of ``LogRecords``, for that " -"matter). The ``LogRecords`` are removed from the queue and passed to the " -"handlers for processing." +"designed as the counterpart to :class:`QueueHandler`. " +"A :class:`QueueListener` is very simple: it's passed a queue and some " +"handlers, and it fires up an internal thread which listens to its queue for " +"LogRecords sent from ``QueueHandlers`` (or any other source of " +"``LogRecords``, for that matter). The ``LogRecords`` are removed from the " +"queue and passed to the handlers for processing." msgstr "" msgid "" @@ -713,10 +713,10 @@ msgid "" "Although the earlier discussion wasn't specifically talking about async " "code, but rather about slow logging handlers, it should be noted that when " "logging from async code, network and even file handlers could lead to " -"problems (blocking the event loop) because some logging is done from :mod:" -"`asyncio` internals. It might be best, if any async code is used in an " -"application, to use the above approach for logging, so that any blocking " -"code runs only in the ``QueueListener`` thread." +"problems (blocking the event loop) because some logging is done " +"from :mod:`asyncio` internals. It might be best, if any async code is used " +"in an application, to use the above approach for logging, so that any " +"blocking code runs only in the ``QueueListener`` thread." msgstr "" msgid "" @@ -731,8 +731,8 @@ msgid "" msgstr "" msgid "" -"The :class:`QueueListener` can be started (and stopped) via the :keyword:" -"`with` statement. For example:" +"The :class:`QueueListener` can be started (and stopped) via " +"the :keyword:`with` statement. For example:" msgstr "" msgid "" @@ -749,8 +749,8 @@ msgstr "" msgid "" "Let's say you want to send logging events across a network, and handle them " -"at the receiving end. A simple way of doing this is attaching a :class:" -"`SocketHandler` instance to the root logger at the sending end::" +"at the receiving end. A simple way of doing this is attaching " +"a :class:`SocketHandler` instance to the root logger at the sending end::" msgstr "" msgid "" @@ -781,8 +781,8 @@ msgid "" msgstr "" msgid "" -"At the receiving end, you can set up a receiver using the :mod:" -"`socketserver` module. Here is a basic working example::" +"At the receiving end, you can set up a receiver using " +"the :mod:`socketserver` module. Here is a basic working example::" msgstr "" msgid "" @@ -865,8 +865,8 @@ msgid "" "\n" "def main():\n" " logging.basicConfig(\n" -" format='%(relativeCreated)5d %(name)-15s %(levelname)-8s " -"%(message)s')\n" +" format='%(relativeCreated)5d %(name)-15s %(levelname)-8s %" +"(message)s')\n" " tcpserver = LogRecordSocketReceiver()\n" " print('About to start TCP server...')\n" " tcpserver.serve_until_stopped()\n" @@ -975,8 +975,8 @@ msgid "To test these files, do the following in a POSIX environment:" msgstr "" msgid "" -"Download `the Gist `__ as a ZIP archive using the :" -"guilabel:`Download ZIP` button." +"Download `the Gist `__ as a ZIP archive using " +"the :guilabel:`Download ZIP` button." msgstr "" msgid "Unzip the above files from the archive into a scratch directory." @@ -1048,8 +1048,8 @@ msgid "" "is not a good idea because these instances are not garbage collected. While " "this is not a problem in practice, when the number of :class:`Logger` " "instances is dependent on the level of granularity you want to use in " -"logging an application, it could be hard to manage if the number of :class:" -"`Logger` instances becomes effectively unbounded." +"logging an application, it could be hard to manage if the number " +"of :class:`Logger` instances becomes effectively unbounded." msgstr "" msgid "Using LoggerAdapters to impart contextual information" @@ -1058,21 +1058,21 @@ msgstr "" msgid "" "An easy way in which you can pass contextual information to be output along " "with logging event information is to use the :class:`LoggerAdapter` class. " -"This class is designed to look like a :class:`Logger`, so that you can call :" -"meth:`debug`, :meth:`info`, :meth:`warning`, :meth:`error`, :meth:" -"`exception`, :meth:`critical` and :meth:`log`. These methods have the same " -"signatures as their counterparts in :class:`Logger`, so you can use the two " -"types of instances interchangeably." +"This class is designed to look like a :class:`Logger`, so that you can " +"call :meth:`debug`, :meth:`info`, :meth:`warning`, :meth:`error`, :meth:`exception`, :meth:`critical` " +"and :meth:`log`. These methods have the same signatures as their " +"counterparts in :class:`Logger`, so you can use the two types of instances " +"interchangeably." msgstr "" msgid "" -"When you create an instance of :class:`LoggerAdapter`, you pass it a :class:" -"`Logger` instance and a dict-like object which contains your contextual " -"information. When you call one of the logging methods on an instance of :" -"class:`LoggerAdapter`, it delegates the call to the underlying instance of :" -"class:`Logger` passed to its constructor, and arranges to pass the " -"contextual information in the delegated call. Here's a snippet from the code " -"of :class:`LoggerAdapter`::" +"When you create an instance of :class:`LoggerAdapter`, you pass it " +"a :class:`Logger` instance and a dict-like object which contains your " +"contextual information. When you call one of the logging methods on an " +"instance of :class:`LoggerAdapter`, it delegates the call to the underlying " +"instance of :class:`Logger` passed to its constructor, and arranges to pass " +"the contextual information in the delegated call. Here's a snippet from the " +"code of :class:`LoggerAdapter`::" msgstr "" msgid "" @@ -1103,8 +1103,9 @@ msgid "" "use customized strings with your :class:`Formatter` instances which know " "about the keys of the dict-like object. If you need a different method, e.g. " "if you want to prepend or append the contextual information to the message " -"string, you just need to subclass :class:`LoggerAdapter` and override :meth:" -"`~LoggerAdapter.process` to do what you need. Here is a simple example::" +"string, you just need to subclass :class:`LoggerAdapter` and " +"override :meth:`~LoggerAdapter.process` to do what you need. Here is a " +"simple example::" msgstr "" msgid "" @@ -1145,22 +1146,22 @@ msgid "Using Filters to impart contextual information" msgstr "" msgid "" -"You can also add contextual information to log output using a user-defined :" -"class:`Filter`. ``Filter`` instances are allowed to modify the " +"You can also add contextual information to log output using a user-" +"defined :class:`Filter`. ``Filter`` instances are allowed to modify the " "``LogRecords`` passed to them, including adding additional attributes which " -"can then be output using a suitable format string, or if needed a custom :" -"class:`Formatter`." +"can then be output using a suitable format string, or if needed a " +"custom :class:`Formatter`." msgstr "" msgid "" "For example in a web application, the request being processed (or at least, " -"the interesting parts of it) can be stored in a threadlocal (:class:" -"`threading.local`) variable, and then accessed from a ``Filter`` to add, " -"say, information from the request - say, the remote IP address and remote " -"user's username - to the ``LogRecord``, using the attribute names 'ip' and " -"'user' as in the ``LoggerAdapter`` example above. In that case, the same " -"format string can be used to get similar output to that shown above. Here's " -"an example script::" +"the interesting parts of it) can be stored in a threadlocal " +"(:class:`threading.local`) variable, and then accessed from a ``Filter`` to " +"add, say, information from the request - say, the remote IP address and " +"remote user's username - to the ``LogRecord``, using the attribute names " +"'ip' and 'user' as in the ``LoggerAdapter`` example above. In that case, the " +"same format string can be used to get similar output to that shown above. " +"Here's an example script::" msgstr "" msgid "" @@ -1307,8 +1308,8 @@ msgid "" "\n" "# A dummy set of requests which will be used in the simulation - we'll just " "pick\n" -"# from this list randomly. Note that all GET requests are from 192.168.2." -"XXX\n" +"# from this list randomly. Note that all GET requests are from " +"192.168.2.XXX\n" "# addresses, whereas POST requests are from 192.16.3.XXX addresses. Three " "users\n" "# are represented in the sample requests.\n" @@ -1326,8 +1327,8 @@ msgid "" "information\n" "# such as HTTP method, client IP and username\n" "\n" -"formatter = logging.Formatter('%(threadName)-11s %(appName)s %(name)-9s " -"%(user)-6s %(ip)s %(method)-4s %(message)s')\n" +"formatter = logging.Formatter('%(threadName)-11s %(appName)s %(name)-9s %" +"(user)-6s %(ip)s %(method)-4s %(message)s')\n" "\n" "# Create our context variables. These will be filled at the start of " "request\n" @@ -1541,17 +1542,18 @@ msgid "" "this is to have all the processes log to a :class:`~handlers.SocketHandler`, " "and have a separate process which implements a socket server which reads " "from the socket and logs to file. (If you prefer, you can dedicate one " -"thread in one of the existing processes to perform this function.) :ref:" -"`This section ` documents this approach in more detail and " -"includes a working socket receiver which can be used as a starting point for " -"you to adapt in your own applications." +"thread in one of the existing processes to perform this " +"function.) :ref:`This section ` documents this approach in " +"more detail and includes a working socket receiver which can be used as a " +"starting point for you to adapt in your own applications." msgstr "" msgid "" -"You could also write your own handler which uses the :class:" -"`~multiprocessing.Lock` class from the :mod:`multiprocessing` module to " -"serialize access to the file from your processes. The stdlib :class:" -"`FileHandler` and subclasses do not make use of :mod:`multiprocessing`." +"You could also write your own handler which uses " +"the :class:`~multiprocessing.Lock` class from the :mod:`multiprocessing` " +"module to serialize access to the file from your processes. The " +"stdlib :class:`FileHandler` and subclasses do not make use " +"of :mod:`multiprocessing`." msgstr "" msgid "" @@ -1600,8 +1602,8 @@ msgid "" "def listener_configurer():\n" " root = logging.getLogger()\n" " h = logging.handlers.RotatingFileHandler('mptest.log', 'a', 300, 10)\n" -" f = logging.Formatter('%(asctime)s %(processName)-10s %(name)s " -"%(levelname)-8s %(message)s')\n" +" f = logging.Formatter('%(asctime)s %(processName)-10s %(name)s %" +"(levelname)-8s %(message)s')\n" " h.setFormatter(f)\n" " root.addHandler(h)\n" "\n" @@ -1731,8 +1733,8 @@ msgid "" " 'formatters': {\n" " 'detailed': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(asctime)s %(name)-15s %(levelname)-8s " -"%(processName)-10s %(message)s'\n" +" 'format': '%(asctime)s %(name)-15s %(levelname)-8s %" +"(processName)-10s %(message)s'\n" " }\n" " },\n" " 'handlers': {\n" @@ -1825,8 +1827,8 @@ msgstr "" " 'formatters': {\n" " 'detailed': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(asctime)s %(name)-15s %(levelname)-8s " -"%(processName)-10s %(message)s'\n" +" 'format': '%(asctime)s %(name)-15s %(levelname)-8s %" +"(processName)-10s %(message)s'\n" " }\n" " },\n" " 'handlers': {\n" @@ -2019,9 +2021,9 @@ msgstr "" msgid "" "When logging was added to the Python standard library, the only way of " "formatting messages with variable content was to use the %-formatting " -"method. Since then, Python has gained two new formatting approaches: :class:" -"`string.Template` (added in Python 2.4) and :meth:`str.format` (added in " -"Python 2.6)." +"method. Since then, Python has gained two new formatting " +"approaches: :class:`string.Template` (added in Python 2.4) " +"and :meth:`str.format` (added in Python 2.6)." msgstr "" msgid "" @@ -2031,9 +2033,9 @@ msgid "" "``'%'``, but other possible values are ``'{'`` and ``'$'``, which correspond " "to the other two formatting styles. Backwards compatibility is maintained by " "default (as you would expect), but by explicitly specifying a style " -"parameter, you get the ability to specify format strings which work with :" -"meth:`str.format` or :class:`string.Template`. Here's an example console " -"session to show the possibilities:" +"parameter, you get the ability to specify format strings which work " +"with :meth:`str.format` or :class:`string.Template`. Here's an example " +"console session to show the possibilities:" msgstr "" msgid "" @@ -2079,12 +2081,12 @@ msgid "" "logging call (e.g. the ``exc_info`` keyword parameter to indicate that " "traceback information should be logged, or the ``extra`` keyword parameter " "to indicate additional contextual information to be added to the log). So " -"you cannot directly make logging calls using :meth:`str.format` or :class:" -"`string.Template` syntax, because internally the logging package uses %-" -"formatting to merge the format string and the variable arguments. There " -"would be no changing this while preserving backward compatibility, since all " -"logging calls which are out there in existing code will be using %-format " -"strings." +"you cannot directly make logging calls using :meth:`str.format` " +"or :class:`string.Template` syntax, because internally the logging package " +"uses %-formatting to merge the format string and the variable arguments. " +"There would be no changing this while preserving backward compatibility, " +"since all logging calls which are out there in existing code will be using %-" +"format strings." msgstr "" msgid "" @@ -2208,10 +2210,10 @@ msgstr "" msgid "" "Every logging event is represented by a :class:`LogRecord` instance. When an " -"event is logged and not filtered out by a logger's level, a :class:" -"`LogRecord` is created, populated with information about the event and then " -"passed to the handlers for that logger (and its ancestors, up to and " -"including the logger where further propagation up the hierarchy is " +"event is logged and not filtered out by a logger's level, " +"a :class:`LogRecord` is created, populated with information about the event " +"and then passed to the handlers for that logger (and its ancestors, up to " +"and including the logger where further propagation up the hierarchy is " "disabled). Before Python 3.2, there were only two places where this creation " "was done:" msgstr "" @@ -2225,19 +2227,20 @@ msgid "" ":func:`makeLogRecord`, which is called with a dictionary containing " "attributes to be added to the LogRecord. This is typically invoked when a " "suitable dictionary has been received over the network (e.g. in pickle form " -"via a :class:`~handlers.SocketHandler`, or in JSON form via an :class:" -"`~handlers.HTTPHandler`)." +"via a :class:`~handlers.SocketHandler`, or in JSON form via " +"an :class:`~handlers.HTTPHandler`)." msgstr "" msgid "" -"This has usually meant that if you need to do anything special with a :class:" -"`LogRecord`, you've had to do one of the following." +"This has usually meant that if you need to do anything special with " +"a :class:`LogRecord`, you've had to do one of the following." msgstr "" msgid "" -"Create your own :class:`Logger` subclass, which overrides :meth:`Logger." -"makeRecord`, and set it using :func:`~logging.setLoggerClass` before any " -"loggers that you care about are instantiated." +"Create your own :class:`Logger` subclass, which " +"overrides :meth:`Logger.makeRecord`, and set it " +"using :func:`~logging.setLoggerClass` before any loggers that you care about " +"are instantiated." msgstr "" msgid "" @@ -2276,10 +2279,10 @@ msgstr "" msgid "" "In Python 3.2 and later, :class:`~logging.LogRecord` creation is done " "through a factory, which you can specify. The factory is just a callable you " -"can set with :func:`~logging.setLogRecordFactory`, and interrogate with :" -"func:`~logging.getLogRecordFactory`. The factory is invoked with the same " -"signature as the :class:`~logging.LogRecord` constructor, as :class:" -"`LogRecord` is the default setting for the factory." +"can set with :func:`~logging.setLogRecordFactory`, and interrogate " +"with :func:`~logging.getLogRecordFactory`. The factory is invoked with the " +"same signature as the :class:`~logging.LogRecord` constructor, " +"as :class:`LogRecord` is the default setting for the factory." msgstr "" msgid "" @@ -2385,10 +2388,10 @@ msgstr "" msgid "" "In a similar way to the above section, we can implement a listener and " -"handler using :pypi:`pynng`, which is a Python binding to `NNG `_, billed as a spiritual successor to ZeroMQ. The following " -"snippets illustrate -- you can test them in an environment which has " -"``pynng`` installed. Just for variety, we present the listener first." +"handler using :pypi:`pynng`, which is a Python binding to `NNG `_, billed as a spiritual successor to ZeroMQ. The " +"following snippets illustrate -- you can test them in an environment which " +"has ``pynng`` installed. Just for variety, we present the listener first." msgstr "" msgid "" @@ -2406,7 +2409,7 @@ msgid "" "class NNGSocketListener(logging.handlers.QueueListener):\n" "\n" " def __init__(self, uri, /, *handlers, **kwargs):\n" -" # Have a timeout for interruptability, and open a\n" +" # Have a timeout for interruptibility, and open a\n" " # subscriber socket\n" " socket = pynng.Sub0(listen=uri, recv_timeout=500)\n" " # The b'' subscription matches all topics\n" @@ -2484,8 +2487,8 @@ msgid "" "# Make sure the process ID is in the output\n" "logging.basicConfig(level=logging.DEBUG,\n" " handlers=[logging.StreamHandler(), handler],\n" -" format='%(levelname)-8s %(name)10s %(process)6s " -"%(message)s')\n" +" format='%(levelname)-8s %(name)10s %(process)6s %" +"(message)s')\n" "levels = (logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR,\n" " logging.CRITICAL)\n" "logger_names = ('myapp', 'myapp.lib1', 'myapp.lib2')\n" @@ -2571,8 +2574,8 @@ msgstr "" msgid "" "Below is an example of a logging configuration dictionary - it's taken from " "the `documentation on the Django project `_. This dictionary is passed to :" -"func:`~config.dictConfig` to put the configuration into effect::" +"stable/topics/logging/#configuring-logging>`_. This dictionary is passed " +"to :func:`~config.dictConfig` to put the configuration into effect::" msgstr "" msgid "" @@ -2857,13 +2860,13 @@ msgid "" " 'formatters': {\n" " 'detailed': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(asctime)s %(name)-15s %(levelname)-8s " -"%(processName)-10s %(message)s'\n" +" 'format': '%(asctime)s %(name)-15s %(levelname)-8s %" +"(processName)-10s %(message)s'\n" " },\n" " 'simple': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(name)-15s %(levelname)-8s %(processName)-10s " -"%(message)s'\n" +" 'format': '%(name)-15s %(levelname)-8s %(processName)-10s %" +"(message)s'\n" " }\n" " },\n" " 'handlers': {\n" @@ -2962,8 +2965,9 @@ msgid "" msgstr "" msgid "" -"Attach a :class:`~logging.Formatter` instance to your :class:`~logging." -"handlers.SysLogHandler` instance, with a format string such as::" +"Attach a :class:`~logging.Formatter` instance to " +"your :class:`~logging.handlers.SysLogHandler` instance, with a format string " +"such as::" msgstr "" msgid "'ASCII section\\ufeffUnicode section'" @@ -3106,8 +3110,9 @@ msgid "" msgstr "" msgid "" -"You can then specify, in a logging configuration passed to :func:" -"`dictConfig`, that a logging handler be created by calling this function::" +"You can then specify, in a logging configuration passed " +"to :func:`dictConfig`, that a logging handler be created by calling this " +"function::" msgstr "" msgid "" @@ -3205,11 +3210,11 @@ msgid "" msgstr "" msgid "" -"Note that this example uses Python 3.3 because that's where :func:`shutil." -"chown` makes an appearance. This approach should work with any Python " -"version that supports :func:`dictConfig` - namely, Python 2.7, 3.2 or later. " -"With pre-3.3 versions, you would need to implement the actual ownership " -"change using e.g. :func:`os.chown`." +"Note that this example uses Python 3.3 because that's " +"where :func:`shutil.chown` makes an appearance. This approach should work " +"with any Python version that supports :func:`dictConfig` - namely, Python " +"2.7, 3.2 or later. With pre-3.3 versions, you would need to implement the " +"actual ownership change using e.g. :func:`os.chown`." msgstr "" msgid "" @@ -3265,11 +3270,12 @@ msgid "" "call (e.g. the ``exc_info`` keyword parameter to indicate that traceback " "information should be logged, or the ``extra`` keyword parameter to indicate " "additional contextual information to be added to the log). So you cannot " -"directly make logging calls using :meth:`str.format` or :class:`string." -"Template` syntax, because internally the logging package uses %-formatting " -"to merge the format string and the variable arguments. There would be no " -"changing this while preserving backward compatibility, since all logging " -"calls which are out there in existing code will be using %-format strings." +"directly make logging calls using :meth:`str.format` " +"or :class:`string.Template` syntax, because internally the logging package " +"uses %-formatting to merge the format string and the variable arguments. " +"There would be no changing this while preserving backward compatibility, " +"since all logging calls which are out there in existing code will be using %-" +"format strings." msgstr "" msgid "" @@ -3304,8 +3310,8 @@ msgid "" msgstr "" msgid "" -"Refer to the reference documentation on :func:`setLogRecordFactory` and :" -"class:`LogRecord` for more information." +"Refer to the reference documentation on :func:`setLogRecordFactory` " +"and :class:`LogRecord` for more information." msgstr "" msgid "Using custom message objects" @@ -3313,11 +3319,11 @@ msgstr "" msgid "" "There is another, perhaps simpler way that you can use {}- and $- formatting " -"to construct your individual log messages. You may recall (from :ref:" -"`arbitrary-object-messages`) that when logging you can use an arbitrary " -"object as a message format string, and that the logging package will call :" -"func:`str` on that object to get the actual format string. Consider the " -"following two classes::" +"to construct your individual log messages. You may recall " +"(from :ref:`arbitrary-object-messages`) that when logging you can use an " +"arbitrary object as a message format string, and that the logging package " +"will call :func:`str` on that object to get the actual format string. " +"Consider the following two classes::" msgstr "" msgid "" @@ -3331,8 +3337,8 @@ msgid "" msgstr "" msgid "" -"Examples of this approach are given below. Firstly, formatting with :meth:" -"`str.format`::" +"Examples of this approach are given below. Firstly, formatting " +"with :meth:`str.format`::" msgstr "" msgid "" @@ -3378,13 +3384,13 @@ msgid "" "it might not be obvious at first glance how to do it (hence this recipe). " "Since :class:`~logging.Filter` is the only filter class included in the " "standard library, and it is unlikely to cater to many requirements (it's " -"only there as a base class), you will typically need to define your own :" -"class:`~logging.Filter` subclass with an overridden :meth:`~logging.Filter." -"filter` method. To do this, specify the ``()`` key in the configuration " -"dictionary for the filter, specifying a callable which will be used to " -"create the filter (a class is the most obvious, but you can provide any " -"callable which returns a :class:`~logging.Filter` instance). Here is a " -"complete example::" +"only there as a base class), you will typically need to define your " +"own :class:`~logging.Filter` subclass with an " +"overridden :meth:`~logging.Filter.filter` method. To do this, specify the " +"``()`` key in the configuration dictionary for the filter, specifying a " +"callable which will be used to create the filter (a class is the most " +"obvious, but you can provide any callable which returns " +"a :class:`~logging.Filter` instance). Here is a complete example::" msgstr "" msgid "" @@ -3535,14 +3541,14 @@ msgid "" "rendered in an audible rather than a visible format. This is easy to do if " "you have text-to-speech (TTS) functionality available in your system, even " "if it doesn't have a Python binding. Most TTS systems have a command line " -"program you can run, and this can be invoked from a handler using :mod:" -"`subprocess`. It's assumed here that TTS command line programs won't expect " -"to interact with users or take a long time to complete, and that the " -"frequency of logged messages will be not so high as to swamp the user with " -"messages, and that it's acceptable to have the messages spoken one at a time " -"rather than concurrently, The example implementation below waits for one " -"message to be spoken before the next is processed, and this might cause " -"other handlers to be kept waiting. Here is a short example showing the " +"program you can run, and this can be invoked from a handler " +"using :mod:`subprocess`. It's assumed here that TTS command line programs " +"won't expect to interact with users or take a long time to complete, and " +"that the frequency of logged messages will be not so high as to swamp the " +"user with messages, and that it's acceptable to have the messages spoken one " +"at a time rather than concurrently, The example implementation below waits " +"for one message to be spoken before the next is processed, and this might " +"cause other handlers to be kept waiting. Here is a short example showing the " "approach, which assumes that the ``espeak`` TTS package is available::" msgstr "" @@ -3626,9 +3632,9 @@ msgid "" "parameter and attaches a memory handler for the duration of the call to the " "decorated function. The decorator can be additionally parameterised using a " "target handler, a level at which flushing should occur, and a capacity for " -"the buffer (number of records buffered). These default to a :class:`~logging." -"StreamHandler` which writes to ``sys.stderr``, ``logging.ERROR`` and ``100`` " -"respectively." +"the buffer (number of records buffered). These default to " +"a :class:`~logging.StreamHandler` which writes to ``sys.stderr``, " +"``logging.ERROR`` and ``100`` respectively." msgstr "" msgid "Here's the script::" @@ -3750,12 +3756,13 @@ msgstr "" msgid "" "To illustrate how you can send log messages via email, so that a set number " -"of messages are sent per email, you can subclass :class:`~logging.handlers." -"BufferingHandler`. In the following example, which you can adapt to suit " -"your specific needs, a simple test harness is provided which allows you to " -"run the script with command line arguments specifying what you typically " -"need to send things via SMTP. (Run the downloaded script with the ``-h`` " -"argument to see the required and optional arguments.)" +"of messages are sent per email, you can " +"subclass :class:`~logging.handlers.BufferingHandler`. In the following " +"example, which you can adapt to suit your specific needs, a simple test " +"harness is provided which allows you to run the script with command line " +"arguments specifying what you typically need to send things via SMTP. (Run " +"the downloaded script with the ``-h`` argument to see the required and " +"optional arguments.)" msgstr "" msgid "" @@ -3777,8 +3784,8 @@ msgid "" " toaddrs = [toaddrs]\n" " self.toaddrs = toaddrs\n" " self.subject = subject\n" -" self.setFormatter(logging.Formatter(\"%(asctime)s %(levelname)-5s " -"%(message)s\"))\n" +" self.setFormatter(logging.Formatter(\"%(asctime)s %(levelname)-5s %" +"(message)s\"))\n" "\n" " def flush(self):\n" " if len(self.buffer) > 0:\n" @@ -3849,10 +3856,10 @@ msgid "" msgstr "" msgid "" -"and you can then use the ``UTCFormatter`` in your code instead of :class:" -"`~logging.Formatter`. If you want to do that via configuration, you can use " -"the :func:`~logging.config.dictConfig` API with an approach illustrated by " -"the following complete example::" +"and you can then use the ``UTCFormatter`` in your code instead " +"of :class:`~logging.Formatter`. If you want to do that via configuration, " +"you can use the :func:`~logging.config.dictConfig` API with an approach " +"illustrated by the following complete example::" msgstr "" msgid "" @@ -4057,8 +4064,8 @@ msgid "" "Suppose we have a command-line application whose job is to stop, start or " "restart some services. This could be organised for the purposes of " "illustration as a file ``app.py`` that is the main script for the " -"application, with individual commands implemented in ``start.py``, ``stop." -"py`` and ``restart.py``. Suppose further that we want to control the " +"application, with individual commands implemented in ``start.py``, " +"``stop.py`` and ``restart.py``. Suppose further that we want to control the " "verbosity of the application via a command-line argument, defaulting to " "``logging.INFO``. Here's one way that ``app.py`` could be written::" msgstr "" @@ -4097,8 +4104,8 @@ msgid "" " mod = importlib.import_module(options.command)\n" " cmd = getattr(mod, 'command')\n" " except (ImportError, AttributeError):\n" -" print('Unable to find the code for command \\'%s\\'' % options." -"command)\n" +" print('Unable to find the code for command \\'%s\\'' % " +"options.command)\n" " return 1\n" " # Could get fancy here and load configuration from file or dictionary\n" " logging.basicConfig(level=options.log_level,\n" @@ -4234,8 +4241,8 @@ msgstr "" msgid "" "A question that comes up from time to time is about how to log to a GUI " "application. The `Qt `_ framework is a popular cross-" -"platform UI framework with Python bindings using :pypi:`PySide2` or :pypi:" -"`PyQt5` libraries." +"platform UI framework with Python bindings using :pypi:`PySide2` " +"or :pypi:`PyQt5` libraries." msgstr "" msgid "" @@ -4441,8 +4448,8 @@ msgid "" " self.start_thread()\n" " self.work_button.clicked.connect(self.worker.start)\n" " # Once started, the button should be disabled\n" -" self.work_button.clicked.connect(lambda : self.work_button." -"setEnabled(False))\n" +" self.work_button.clicked.connect(lambda : " +"self.work_button.setEnabled(False))\n" "\n" " def start_thread(self):\n" " self.worker = Worker()\n" @@ -4517,8 +4524,9 @@ msgid "" "default to use the older :rfc:`3164`, which hails from 2001. When " "``logging`` was added to Python in 2003, it supported the earlier (and only " "existing) protocol at the time. Since RFC 5424 came out, as there has not " -"been widespread deployment of it in syslog servers, the :class:`~logging." -"handlers.SysLogHandler` functionality has not been updated." +"been widespread deployment of it in syslog servers, " +"the :class:`~logging.handlers.SysLogHandler` functionality has not been " +"updated." msgstr "" msgid "" @@ -4599,7 +4607,7 @@ msgid "" "You'll need to be familiar with RFC 5424 to fully understand the above code, " "and it may be that you have slightly different needs (e.g. for how you pass " "structural data to the log). Nevertheless, the above should be adaptable to " -"your speciric needs. With the above handler, you'd pass structured data " +"your specific needs. With the above handler, you'd pass structured data " "using something like this::" msgstr "" @@ -4669,8 +4677,8 @@ msgid "" msgstr "" msgid "" -"You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys." -"stderr`` by doing something like this:" +"You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and " +"``sys.stderr`` by doing something like this:" msgstr "" msgid "" @@ -4682,9 +4690,9 @@ msgstr "" msgid "" "You should do this *after* configuring logging for your needs. In the above " -"example, the :func:`~logging.basicConfig` call does this (using the ``sys." -"stderr`` value *before* it is overwritten by a ``LoggerWriter`` instance). " -"Then, you'd get this kind of result:" +"example, the :func:`~logging.basicConfig` call does this (using the " +"``sys.stderr`` value *before* it is overwritten by a ``LoggerWriter`` " +"instance). Then, you'd get this kind of result:" msgstr "" msgid "" @@ -4701,9 +4709,9 @@ msgstr "" ">>>" msgid "" -"Of course, the examples above show output according to the format used by :" -"func:`~logging.basicConfig`, but you can use a different formatter when you " -"configure logging." +"Of course, the examples above show output according to the format used " +"by :func:`~logging.basicConfig`, but you can use a different formatter when " +"you configure logging." msgstr "" msgid "" @@ -4827,8 +4835,8 @@ msgid "" " pass\n" "\n" "if __name__ == '__main__':\n" -" logging.basicConfig(level=logging.DEBUG, format='%(asctime)s " -"%(levelname)-9s %(message)s',\n" +" logging.basicConfig(level=logging.DEBUG, format='%(asctime)s %" +"(levelname)-9s %(message)s',\n" " handlers = [StreamHandler()])\n" " logger.debug('Single line')\n" " logger.debug('Multiple lines:\\nfool me once ...')\n" @@ -4851,9 +4859,9 @@ msgid "" msgstr "" msgid "" -"If, on the other hand, you are concerned about `log injection `_, you can use a formatter which " -"escapes newlines, as per the following example:" +"If, on the other hand, you are concerned about `log injection `_, you can use a formatter " +"which escapes newlines, as per the following example:" msgstr "" msgid "" @@ -4868,8 +4876,8 @@ msgid "" "\n" "if __name__ == '__main__':\n" " h = logging.StreamHandler()\n" -" h.setFormatter(EscapingFormatter('%(asctime)s %(levelname)-9s " -"%(message)s'))\n" +" h.setFormatter(EscapingFormatter('%(asctime)s %(levelname)-9s %" +"(message)s'))\n" " logging.basicConfig(level=logging.DEBUG, handlers = [h])\n" " logger.debug('Single line')\n" " logger.debug('Multiple lines:\\nfool me once ...')\n" diff --git a/howto/logging.po b/howto/logging.po index e98ba69385..0afb6aaca0 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -55,8 +55,8 @@ msgstr "" msgid "" "You can access logging functionality by creating a logger via ``logger = " -"logging.getLogger(__name__)``, and then calling the logger's :meth:`~Logger." -"debug`, :meth:`~Logger.info`, :meth:`~Logger.warning`, :meth:`~Logger.error` " +"logging.getLogger(__name__)``, and then calling the " +"logger's :meth:`~Logger.debug`, :meth:`~Logger.info`, :meth:`~Logger.warning`, :meth:`~Logger.error` " "and :meth:`~Logger.critical` methods. To determine when to use logging, and " "to see which logger methods to use when, see the table below. It states, for " "each of a set of common tasks, the best tool to use for that task." @@ -110,8 +110,8 @@ msgid "" msgstr "" msgid "" -"A logger's :meth:`~Logger.error`, :meth:`~Logger.exception` or :meth:" -"`~Logger.critical` method as appropriate for the specific error and " +"A logger's :meth:`~Logger.error`, :meth:`~Logger.exception` " +"or :meth:`~Logger.critical` method as appropriate for the specific error and " "application domain" msgstr "" @@ -198,8 +198,8 @@ msgstr "" msgid "" "printed out on the console. The ``INFO`` message doesn't appear because the " "default level is ``WARNING``. The printed message includes the indication of " -"the level and the description of the event provided in the logging call, i." -"e. 'Watch out!'. The actual output can be formatted quite flexibly if you " +"the level and the description of the event provided in the logging call, " +"i.e. 'Watch out!'. The actual output can be formatted quite flexibly if you " "need that; formatting options will also be explained later." msgstr "" @@ -227,8 +227,8 @@ msgstr "" msgid "" "import logging\n" "logger = logging.getLogger(__name__)\n" -"logging.basicConfig(filename='example.log', encoding='utf-8', level=logging." -"DEBUG)\n" +"logging.basicConfig(filename='example.log', encoding='utf-8', " +"level=logging.DEBUG)\n" "logger.debug('This message should go to the log file')\n" "logger.info('So should this')\n" "logger.warning('And this, too')\n" @@ -306,8 +306,8 @@ msgid "" msgstr "" msgid "" -"logging.basicConfig(filename='example.log', filemode='w', level=logging." -"DEBUG)" +"logging.basicConfig(filename='example.log', filemode='w', " +"level=logging.DEBUG)" msgstr "" msgid "" @@ -353,8 +353,8 @@ msgstr "" msgid "" "import logging\n" -"logging.basicConfig(format='%(levelname)s:%(message)s', level=logging." -"DEBUG)\n" +"logging.basicConfig(format='%(levelname)s:%(message)s', " +"level=logging.DEBUG)\n" "logging.debug('This message should appear on the console')\n" "logging.info('So should this')\n" "logging.warning('And this, too')" @@ -399,9 +399,9 @@ msgid "2010-12-12 11:41:42,612 is when this event was logged." msgstr "" msgid "" -"The default format for date/time display (shown above) is like ISO8601 or :" -"rfc:`3339`. If you need more control over the formatting of the date/time, " -"provide a *datefmt* argument to ``basicConfig``, as in this example::" +"The default format for date/time display (shown above) is like ISO8601 " +"or :rfc:`3339`. If you need more control over the formatting of the date/" +"time, provide a *datefmt* argument to ``basicConfig``, as in this example::" msgstr "" msgid "" @@ -418,8 +418,8 @@ msgid "12/12/2010 11:46:36 AM is when this event was logged." msgstr "" msgid "" -"The format of the *datefmt* argument is the same as supported by :func:`time." -"strftime`." +"The format of the *datefmt* argument is the same as supported " +"by :func:`time.strftime`." msgstr "" msgid "Next Steps" @@ -501,10 +501,11 @@ msgstr "" msgid "" "The root of the hierarchy of loggers is called the root logger. That's the " -"logger used by the functions :func:`debug`, :func:`info`, :func:`warning`, :" -"func:`error` and :func:`critical`, which just call the same-named method of " -"the root logger. The functions and the methods have the same signatures. The " -"root logger's name is printed as 'root' in the logged output." +"logger used by the " +"functions :func:`debug`, :func:`info`, :func:`warning`, :func:`error` " +"and :func:`critical`, which just call the same-named method of the root " +"logger. The functions and the methods have the same signatures. The root " +"logger's name is printed as 'root' in the logged output." msgstr "" msgid "" @@ -520,12 +521,12 @@ msgstr "" msgid "" "By default, no destination is set for any logging messages. You can specify " "a destination (such as console or file) by using :func:`basicConfig` as in " -"the tutorial examples. If you call the functions :func:`debug`, :func:" -"`info`, :func:`warning`, :func:`error` and :func:`critical`, they will check " -"to see if no destination is set; and if one is not set, they will set a " -"destination of the console (``sys.stderr``) and a default format for the " -"displayed message before delegating to the root logger to do the actual " -"message output." +"the tutorial examples. If you call the " +"functions :func:`debug`, :func:`info`, :func:`warning`, :func:`error` " +"and :func:`critical`, they will check to see if no destination is set; and " +"if one is not set, they will set a destination of the console " +"(``sys.stderr``) and a default format for the displayed message before " +"delegating to the root logger to do the actual message output." msgstr "" msgid "The default format set by :func:`basicConfig` for messages is:" @@ -598,21 +599,22 @@ msgid "" msgstr "" msgid "" -":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:" -"`Logger.error`, and :meth:`Logger.critical` all create log records with a " -"message and a level that corresponds to their respective method names. The " -"message is actually a format string, which may contain the standard string " -"substitution syntax of ``%s``, ``%d``, ``%f``, and so on. The rest of their " -"arguments is a list of objects that correspond with the substitution fields " -"in the message. With regard to ``**kwargs``, the logging methods care only " -"about a keyword of ``exc_info`` and use it to determine whether to log " -"exception information." +":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:`Logger.error`, " +"and :meth:`Logger.critical` all create log records with a message and a " +"level that corresponds to their respective method names. The message is " +"actually a format string, which may contain the standard string substitution " +"syntax of ``%s``, ``%d``, ``%f``, and so on. The rest of their arguments is " +"a list of objects that correspond with the substitution fields in the " +"message. With regard to ``**kwargs``, the logging methods care only about a " +"keyword of ``exc_info`` and use it to determine whether to log exception " +"information." msgstr "" msgid "" -":meth:`Logger.exception` creates a log message similar to :meth:`Logger." -"error`. The difference is that :meth:`Logger.exception` dumps a stack trace " -"along with it. Call this method only from an exception handler." +":meth:`Logger.exception` creates a log message similar " +"to :meth:`Logger.error`. The difference is that :meth:`Logger.exception` " +"dumps a stack trace along with it. Call this method only from an exception " +"handler." msgstr "" msgid "" @@ -670,8 +672,8 @@ msgstr "" msgid "" "The standard library includes quite a few handler types (see :ref:`useful-" -"handlers`); the tutorials use mainly :class:`StreamHandler` and :class:" -"`FileHandler` in its examples." +"handlers`); the tutorials use mainly :class:`StreamHandler` " +"and :class:`FileHandler` in its examples." msgstr "" msgid "" @@ -701,10 +703,10 @@ msgid "" msgstr "" msgid "" -"Application code should not directly instantiate and use instances of :class:" -"`Handler`. Instead, the :class:`Handler` class is a base class that defines " -"the interface that all handlers should have and establishes some default " -"behavior that child classes can use (or override)." +"Application code should not directly instantiate and use instances " +"of :class:`Handler`. Instead, the :class:`Handler` class is a base class " +"that defines the interface that all handlers should have and establishes " +"some default behavior that child classes can use (or override)." msgstr "" msgid "Formatters" @@ -735,8 +737,8 @@ msgstr "" msgid "" "If the ``style`` is ``'%'``, the message format string uses ``%()s`` styled string substitution; the possible keys are documented in :" -"ref:`logrecord-attributes`. If the style is ``'{'``, the message format " +"key>)s`` styled string substitution; the possible keys are documented " +"in :ref:`logrecord-attributes`. If the style is ``'{'``, the message format " "string is assumed to be compatible with :meth:`str.format` (using keyword " "arguments), while if the style is ``'$'`` then the message format string " "should conform to what is expected by :meth:`string.Template.substitute`." @@ -781,8 +783,8 @@ msgid "" msgstr "" msgid "" -"Creating a dictionary of configuration information and passing it to the :" -"func:`dictConfig` function." +"Creating a dictionary of configuration information and passing it to " +"the :func:`dictConfig` function." msgstr "" msgid "" @@ -803,8 +805,8 @@ msgid "" "ch.setLevel(logging.DEBUG)\n" "\n" "# create formatter\n" -"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - " -"%(message)s')\n" +"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %" +"(message)s')\n" "\n" "# add formatter to ch\n" "ch.setFormatter(formatter)\n" @@ -929,11 +931,11 @@ msgstr "" msgid "" "Note that the class names referenced in config files need to be either " "relative to the logging module, or absolute values which can be resolved " -"using normal import mechanisms. Thus, you could use either :class:`~logging." -"handlers.WatchedFileHandler` (relative to the logging module) or ``mypackage." -"mymodule.MyHandler`` (for a class defined in package ``mypackage`` and " -"module ``mymodule``, where ``mypackage`` is available on the Python import " -"path)." +"using normal import mechanisms. Thus, you could use " +"either :class:`~logging.handlers.WatchedFileHandler` (relative to the " +"logging module) or ``mypackage.mymodule.MyHandler`` (for a class defined in " +"package ``mypackage`` and module ``mymodule``, where ``mypackage`` is " +"available on the Python import path)." msgstr "" msgid "" @@ -991,10 +993,10 @@ msgid "" msgstr "" msgid "" -"The event is output using a 'handler of last resort', stored in :data:" -"`lastResort`. This internal handler is not associated with any logger, and " -"acts like a :class:`~logging.StreamHandler` which writes the event " -"description message to the current value of ``sys.stderr`` (therefore " +"The event is output using a 'handler of last resort', stored " +"in :data:`lastResort`. This internal handler is not associated with any " +"logger, and acts like a :class:`~logging.StreamHandler` which writes the " +"event description message to the current value of ``sys.stderr`` (therefore " "respecting any redirections which may be in effect). No formatting is done " "on the message - just the bare event description message is printed. The " "handler's level is set to ``WARNING``, so all events at this and greater " @@ -1043,13 +1045,13 @@ msgid "" msgstr "" msgid "" -"A do-nothing handler is included in the logging package: :class:`~logging." -"NullHandler` (since Python 3.1). An instance of this handler could be added " -"to the top-level logger of the logging namespace used by the library (*if* " -"you want to prevent your library's logged events being output to ``sys." -"stderr`` in the absence of logging configuration). If all logging by a " -"library *foo* is done using loggers with names matching 'foo.x', 'foo.x.y', " -"etc. then the code::" +"A do-nothing handler is included in the logging " +"package: :class:`~logging.NullHandler` (since Python 3.1). An instance of " +"this handler could be added to the top-level logger of the logging namespace " +"used by the library (*if* you want to prevent your library's logged events " +"being output to ``sys.stderr`` in the absence of logging configuration). If " +"all logging by a library *foo* is done using loggers with names matching " +"'foo.x', 'foo.x.y', etc. then the code::" msgstr "" msgid "" @@ -1073,13 +1075,14 @@ msgid "" msgstr "" msgid "" -"It is strongly advised that you *do not add any handlers other than* :class:" -"`~logging.NullHandler` *to your library's loggers*. This is because the " -"configuration of handlers is the prerogative of the application developer " -"who uses your library. The application developer knows their target audience " -"and what handlers are most appropriate for their application: if you add " -"handlers 'under the hood', you might well interfere with their ability to " -"carry out unit tests and deliver logs which suit their requirements." +"It is strongly advised that you *do not add any handlers other " +"than* :class:`~logging.NullHandler` *to your library's loggers*. This is " +"because the configuration of handlers is the prerogative of the application " +"developer who uses your library. The application developer knows their " +"target audience and what handlers are most appropriate for their " +"application: if you add handlers 'under the hood', you might well interfere " +"with their ability to carry out unit tests and deliver logs which suit their " +"requirements." msgstr "" msgid "Logging Levels" @@ -1128,33 +1131,33 @@ msgstr "" msgid "" "Logging messages are encoded as instances of the :class:`~logging.LogRecord` " -"class. When a logger decides to actually log an event, a :class:`~logging." -"LogRecord` instance is created from the logging message." +"class. When a logger decides to actually log an event, " +"a :class:`~logging.LogRecord` instance is created from the logging message." msgstr "" msgid "" -"Logging messages are subjected to a dispatch mechanism through the use of :" -"dfn:`handlers`, which are instances of subclasses of the :class:`Handler` " -"class. Handlers are responsible for ensuring that a logged message (in the " -"form of a :class:`LogRecord`) ends up in a particular location (or set of " -"locations) which is useful for the target audience for that message (such as " -"end users, support desk staff, system administrators, developers). Handlers " -"are passed :class:`LogRecord` instances intended for particular " -"destinations. Each logger can have zero, one or more handlers associated " -"with it (via the :meth:`~Logger.addHandler` method of :class:`Logger`). In " -"addition to any handlers directly associated with a logger, *all handlers " -"associated with all ancestors of the logger* are called to dispatch the " -"message (unless the *propagate* flag for a logger is set to a false value, " -"at which point the passing to ancestor handlers stops)." +"Logging messages are subjected to a dispatch mechanism through the use " +"of :dfn:`handlers`, which are instances of subclasses of " +"the :class:`Handler` class. Handlers are responsible for ensuring that a " +"logged message (in the form of a :class:`LogRecord`) ends up in a particular " +"location (or set of locations) which is useful for the target audience for " +"that message (such as end users, support desk staff, system administrators, " +"developers). Handlers are passed :class:`LogRecord` instances intended for " +"particular destinations. Each logger can have zero, one or more handlers " +"associated with it (via the :meth:`~Logger.addHandler` method " +"of :class:`Logger`). In addition to any handlers directly associated with a " +"logger, *all handlers associated with all ancestors of the logger* are " +"called to dispatch the message (unless the *propagate* flag for a logger is " +"set to a false value, at which point the passing to ancestor handlers stops)." msgstr "" msgid "" "Just as for loggers, handlers can have levels associated with them. A " "handler's level acts as a filter in the same way as a logger's level does. " -"If a handler decides to actually dispatch an event, the :meth:`~Handler." -"emit` method is used to send the message to its destination. Most user-" -"defined subclasses of :class:`Handler` will need to override this :meth:" -"`~Handler.emit`." +"If a handler decides to actually dispatch an event, " +"the :meth:`~Handler.emit` method is used to send the message to its " +"destination. Most user-defined subclasses of :class:`Handler` will need to " +"override this :meth:`~Handler.emit`." msgstr "" msgid "Custom Levels" @@ -1191,8 +1194,8 @@ msgstr "" msgid "" ":class:`~handlers.BaseRotatingHandler` is the base class for handlers that " "rotate log files at a certain point. It is not meant to be instantiated " -"directly. Instead, use :class:`~handlers.RotatingFileHandler` or :class:" -"`~handlers.TimedRotatingFileHandler`." +"directly. Instead, use :class:`~handlers.RotatingFileHandler` " +"or :class:`~handlers.TimedRotatingFileHandler`." msgstr "" msgid "" @@ -1226,8 +1229,8 @@ msgid "" msgstr "" msgid "" -":class:`~handlers.NTEventLogHandler` instances send messages to a Windows " -"NT/2000/XP event log." +":class:`~handlers.NTEventLogHandler` instances send messages to a Windows NT/" +"2000/XP event log." msgstr "" msgid "" @@ -1274,25 +1277,25 @@ msgid "" msgstr "" msgid "" -"Logged messages are formatted for presentation through instances of the :" -"class:`Formatter` class. They are initialized with a format string suitable " -"for use with the % operator and a dictionary." +"Logged messages are formatted for presentation through instances of " +"the :class:`Formatter` class. They are initialized with a format string " +"suitable for use with the % operator and a dictionary." msgstr "" msgid "" -"For formatting multiple messages in a batch, instances of :class:" -"`BufferingFormatter` can be used. In addition to the format string (which is " -"applied to each message in the batch), there is provision for header and " -"trailer format strings." +"For formatting multiple messages in a batch, instances " +"of :class:`BufferingFormatter` can be used. In addition to the format string " +"(which is applied to each message in the batch), there is provision for " +"header and trailer format strings." msgstr "" msgid "" "When filtering based on logger level and/or handler level is not enough, " -"instances of :class:`Filter` can be added to both :class:`Logger` and :class:" -"`Handler` instances (through their :meth:`~Handler.addFilter` method). " -"Before deciding to process a message further, both loggers and handlers " -"consult all their filters for permission. If any filter returns a false " -"value, the message is not processed further." +"instances of :class:`Filter` can be added to both :class:`Logger` " +"and :class:`Handler` instances (through their :meth:`~Handler.addFilter` " +"method). Before deciding to process a message further, both loggers and " +"handlers consult all their filters for permission. If any filter returns a " +"false value, the message is not processed further." msgstr "" msgid "" @@ -1314,15 +1317,15 @@ msgstr "" msgid "" ":class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never " "swallowed. Other exceptions which occur during the :meth:`~Handler.emit` " -"method of a :class:`Handler` subclass are passed to its :meth:`~Handler." -"handleError` method." +"method of a :class:`Handler` subclass are passed to " +"its :meth:`~Handler.handleError` method." msgstr "" msgid "" -"The default implementation of :meth:`~Handler.handleError` in :class:" -"`Handler` checks to see if a module-level variable, :data:`raiseExceptions`, " -"is set. If set, a traceback is printed to :data:`sys.stderr`. If not set, " -"the exception is swallowed." +"The default implementation of :meth:`~Handler.handleError` " +"in :class:`Handler` checks to see if a module-level " +"variable, :data:`raiseExceptions`, is set. If set, a traceback is printed " +"to :data:`sys.stderr`. If not set, the exception is swallowed." msgstr "" msgid "" @@ -1338,12 +1341,12 @@ msgstr "" msgid "" "In the preceding sections and examples, it has been assumed that the message " "passed when logging the event is a string. However, this is not the only " -"possibility. You can pass an arbitrary object as a message, and its :meth:" -"`~object.__str__` method will be called when the logging system needs to " -"convert it to a string representation. In fact, if you want to, you can " -"avoid computing a string representation altogether - for example, the :class:" -"`~handlers.SocketHandler` emits an event by pickling it and sending it over " -"the wire." +"possibility. You can pass an arbitrary object as a message, and " +"its :meth:`~object.__str__` method will be called when the logging system " +"needs to convert it to a string representation. In fact, if you want to, you " +"can avoid computing a string representation altogether - for example, " +"the :class:`~handlers.SocketHandler` emits an event by pickling it and " +"sending it over the wire." msgstr "" msgid "Optimization" @@ -1353,10 +1356,10 @@ msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " "expensive, and you may want to avoid doing it if the logger will just throw " -"away your event. To decide what to do, you can call the :meth:`~Logger." -"isEnabledFor` method which takes a level argument and returns true if the " -"event would be created by the Logger for that level of call. You can write " -"code like this::" +"away your event. To decide what to do, you can call " +"the :meth:`~Logger.isEnabledFor` method which takes a level argument and " +"returns true if the event would be created by the Logger for that level of " +"call. You can write code like this::" msgstr "" msgid "" @@ -1398,9 +1401,10 @@ msgid "Information about where calls were made from." msgstr "" msgid "" -"Set ``logging._srcfile`` to ``None``. This avoids calling :func:`sys." -"_getframe`, which may help to speed up your code in environments like PyPy " -"(which can't speed up code that uses :func:`sys._getframe`)." +"Set ``logging._srcfile`` to ``None``. This avoids " +"calling :func:`sys._getframe`, which may help to speed up your code in " +"environments like PyPy (which can't speed up code that " +"uses :func:`sys._getframe`)." msgstr "" msgid "Threading information." diff --git a/howto/mro.po b/howto/mro.po index 89d7d6a966..dbdfa99bd2 100644 --- a/howto/mro.po +++ b/howto/mro.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,7 +32,7 @@ msgid "" "in Python 2.3, but it is still used in later versions -- including Python 3." msgstr "" -msgid "By `Michele Simionato `__." +msgid "By `Michele Simionato `__." msgstr "" msgid "Abstract" @@ -262,9 +262,9 @@ msgid "" "tail of any of the other lists, then add it to the linearization of C and " "remove it from the lists in the merge, otherwise look at the head of the " "next list and take it, if it is a good head. Then repeat the operation " -"until all the class are removed or it is impossible to find good heads. In " -"this case, it is impossible to construct the merge, Python 2.3 will refuse " -"to create the class C and will raise an exception.*" +"until all the classes are removed or it is impossible to find good heads. " +"In this case, it is impossible to construct the merge, Python 2.3 will " +"refuse to create the class C and will raise an exception.*" msgstr "" msgid "" @@ -383,9 +383,9 @@ msgid "" msgstr "" msgid "" -"The only difference with the previous example is the change B(D,E) --> B(E," -"D); however even such a little modification completely changes the ordering " -"of the hierarchy:" +"The only difference with the previous example is the change B(D,E) --> " +"B(E,D); however even such a little modification completely changes the " +"ordering of the hierarchy:" msgstr "" msgid "" @@ -431,7 +431,7 @@ msgid "" msgstr "" msgid "" -"L[O] = 0\n" +"L[O] = O\n" "L[X] = X O\n" "L[Y] = Y O\n" "L[A] = A X Y O\n" @@ -488,8 +488,8 @@ msgstr "" msgid "" "We see that class G inherits from F and E, with F *before* E: therefore we " -"would expect the attribute *G.remember2buy* to be inherited by *F." -"remember2buy* and not by *E.remember2buy*: nevertheless Python 2.2 gives" +"would expect the attribute *G.remember2buy* to be inherited by " +"*F.remember2buy* and not by *E.remember2buy*: nevertheless Python 2.2 gives" msgstr "" msgid "" @@ -780,8 +780,8 @@ msgid "" msgstr "" msgid "" -"The paper *A Monotonic Superclass Linearization for Dylan*: https://doi." -"org/10.1145/236337.236343" +"The paper *A Monotonic Superclass Linearization for Dylan*: https://doi.org/" +"10.1145/236337.236343" msgstr "" msgid "" diff --git a/howto/perf_profiling.po b/howto/perf_profiling.po index d81857a5c0..d5beeb4998 100644 --- a/howto/perf_profiling.po +++ b/howto/perf_profiling.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -227,8 +227,8 @@ msgstr "" msgid "" "``perf`` profiling support can be enabled either from the start using the " "environment variable :envvar:`PYTHONPERFSUPPORT` or the :option:`-X perf <-" -"X>` option, or dynamically using :func:`sys.activate_stack_trampoline` and :" -"func:`sys.deactivate_stack_trampoline`." +"X>` option, or dynamically using :func:`sys.activate_stack_trampoline` " +"and :func:`sys.deactivate_stack_trampoline`." msgstr "" msgid "" @@ -240,8 +240,8 @@ msgid "Example, using the environment variable::" msgstr "" msgid "" -"$ PYTHONPERFSUPPORT=1 perf record -F 9999 -g -o perf.data python my_script." -"py\n" +"$ PYTHONPERFSUPPORT=1 perf record -F 9999 -g -o perf.data python " +"my_script.py\n" "$ perf report -g -i perf.data" msgstr "" @@ -312,9 +312,9 @@ msgid "" msgstr "" msgid "" -"To enable this mode, you can use the environment variable :envvar:" -"`PYTHON_PERF_JIT_SUPPORT` or the :option:`-X perf_jit <-X>` option, which " -"will enable the JIT mode for the ``perf`` profiler." +"To enable this mode, you can use the environment " +"variable :envvar:`PYTHON_PERF_JIT_SUPPORT` or the :option:`-X perf_jit <-X>` " +"option, which will enable the JIT mode for the ``perf`` profiler." msgstr "" msgid "" @@ -337,8 +337,8 @@ msgid "" msgstr "" msgid "" -"$ perf record -F 9999 -g -k 1 --call-graph dwarf -o perf.data python -" -"Xperf_jit my_script.py\n" +"$ perf record -F 9999 -g -k 1 --call-graph dwarf -o perf.data python " +"-Xperf_jit my_script.py\n" "$ perf inject -i perf.data --jit --output perf.jit.data\n" "$ perf report -g -i perf.jit.data" msgstr "" @@ -387,8 +387,8 @@ msgid "" msgstr "" msgid "" -"$ perf record -F 9999 -g -k 1 --call-graph dwarf,65528 -o perf.data python -" -"Xperf_jit my_script.py" +"$ perf record -F 9999 -g -k 1 --call-graph dwarf,65528 -o perf.data python " +"-Xperf_jit my_script.py" msgstr "" msgid "Different compilation flags can significantly impact stack sizes:" diff --git a/howto/pyporting.po b/howto/pyporting.po index efa4d962aa..a75b0f3e57 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -50,8 +50,8 @@ msgstr "" msgid "" "Since Python 3.11 the original porting guide was discontinued. You can find " -"the old guide in the `archive `_." +"the old guide in the `archive `_." msgstr "" msgid "Third-party guides" diff --git a/howto/regex.po b/howto/regex.po index f71a1b1c45..428fff3d9e 100644 --- a/howto/regex.po +++ b/howto/regex.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -102,12 +102,12 @@ msgid "" msgstr "" msgid "" -"There are exceptions to this rule; some characters are special :dfn:" -"`metacharacters`, and don't match themselves. Instead, they signal that " -"some out-of-the-ordinary thing should be matched, or they affect other " -"portions of the RE by repeating them or changing their meaning. Much of " -"this document is devoted to discussing various metacharacters and what they " -"do." +"There are exceptions to this rule; some characters are " +"special :dfn:`metacharacters`, and don't match themselves. Instead, they " +"signal that some out-of-the-ordinary thing should be matched, or they affect " +"other portions of the RE by repeating them or changing their meaning. Much " +"of this document is devoted to discussing various metacharacters and what " +"they do." msgstr "" msgid "" @@ -137,12 +137,12 @@ msgid "" msgstr "" msgid "" -"You can match the characters not listed within the class by :dfn:" -"`complementing` the set. This is indicated by including a ``'^'`` as the " -"first character of the class. For example, ``[^5]`` will match any character " -"except ``'5'``. If the caret appears elsewhere in a character class, it " -"does not have special meaning. For example: ``[5^]`` will match either a " -"``'5'`` or a ``'^'``." +"You can match the characters not listed within the class " +"by :dfn:`complementing` the set. This is indicated by including a ``'^'`` " +"as the first character of the class. For example, ``[^5]`` will match any " +"character except ``'5'``. If the caret appears elsewhere in a character " +"class, it does not have special meaning. For example: ``[5^]`` will match " +"either a ``'5'`` or a ``'^'``." msgstr "" msgid "" @@ -164,10 +164,10 @@ msgid "" "Let's take an example: ``\\w`` matches any alphanumeric character. If the " "regex pattern is expressed in bytes, this is equivalent to the class ``[a-zA-" "Z0-9_]``. If the regex pattern is a string, ``\\w`` will match all the " -"characters marked as letters in the Unicode database provided by the :mod:" -"`unicodedata` module. You can use the more restricted definition of ``\\w`` " -"in a string pattern by supplying the :const:`re.ASCII` flag when compiling " -"the regular expression." +"characters marked as letters in the Unicode database provided by " +"the :mod:`unicodedata` module. You can use the more restricted definition " +"of ``\\w`` in a string pattern by supplying the :const:`re.ASCII` flag when " +"compiling the regular expression." msgstr "" msgid "" @@ -232,9 +232,9 @@ msgstr "" msgid "" "The final metacharacter in this section is ``.``. It matches anything " -"except a newline character, and there's an alternate mode (:const:`re." -"DOTALL`) where it will match even a newline. ``.`` is often used where you " -"want to match \"any character\"." +"except a newline character, and there's an alternate mode " +"(:const:`re.DOTALL`) where it will match even a newline. ``.`` is often " +"used where you want to match \"any character\"." msgstr "" msgid "Repeating things" @@ -445,8 +445,8 @@ msgid "" "and no special syntax was created for expressing them. (There are " "applications that don't need REs at all, so there's no need to bloat the " "language specification by including them.) Instead, the :mod:`re` module is " -"simply a C extension module included with Python, just like the :mod:" -"`socket` or :mod:`zlib` modules." +"simply a C extension module included with Python, just like " +"the :mod:`socket` or :mod:`zlib` modules." msgstr "" msgid "" @@ -518,10 +518,10 @@ msgstr "" msgid "" "In addition, special escape sequences that are valid in regular expressions, " -"but not valid as Python string literals, now result in a :exc:" -"`SyntaxWarning` and will eventually become a :exc:`SyntaxError`, which means " -"the sequences will be invalid if raw string notation or escaping the " -"backslashes isn't used." +"but not valid as Python string literals, now result in " +"a :exc:`SyntaxWarning` and will eventually become a :exc:`SyntaxError`, " +"which means the sequences will be invalid if raw string notation or escaping " +"the backslashes isn't used." msgstr "" msgid "Regular String" @@ -583,8 +583,8 @@ msgid "``finditer()``" msgstr "``finditer()``" msgid "" -"Find all substrings where the RE matches, and return them as an :term:" -"`iterator`." +"Find all substrings where the RE matches, and return them as " +"an :term:`iterator`." msgstr "" msgid "" @@ -696,11 +696,11 @@ msgstr "" "(0, 5)" msgid "" -":meth:`~re.Match.group` returns the substring that was matched by the RE. :" -"meth:`~re.Match.start` and :meth:`~re.Match.end` return the starting and " -"ending index of the match. :meth:`~re.Match.span` returns both start and end " -"indexes in a single tuple. Since the :meth:`~re.Pattern.match` method only " -"checks if the RE matches at the start of a string, :meth:`!start` will " +":meth:`~re.Match.group` returns the substring that was matched by the " +"RE. :meth:`~re.Match.start` and :meth:`~re.Match.end` return the starting " +"and ending index of the match. :meth:`~re.Match.span` returns both start and " +"end indexes in a single tuple. Since the :meth:`~re.Pattern.match` method " +"only checks if the RE matches at the start of a string, :meth:`!start` will " "always be zero. However, the :meth:`~re.Pattern.search` method of patterns " "scans through the string, so the match may not start at zero in that " "case. ::" @@ -733,8 +733,8 @@ msgid "" msgstr "" msgid "" -"Two pattern methods return all of the matches for a pattern. :meth:`~re." -"Pattern.findall` returns a list of matching strings::" +"Two pattern methods return all of the matches for a " +"pattern. :meth:`~re.Pattern.findall` returns a list of matching strings::" msgstr "" msgid "" @@ -754,8 +754,8 @@ msgstr "" msgid "" ":meth:`~re.Pattern.findall` has to create the entire list before it can be " "returned as the result. The :meth:`~re.Pattern.finditer` method returns a " -"sequence of :ref:`match object ` instances as an :term:" -"`iterator`::" +"sequence of :ref:`match object ` instances as " +"an :term:`iterator`::" msgstr "" msgid "" @@ -774,12 +774,12 @@ msgid "Module-level functions" msgstr "" msgid "" -"You don't have to create a pattern object and call its methods; the :mod:" -"`re` module also provides top-level functions called :func:`~re.match`, :" -"func:`~re.search`, :func:`~re.findall`, :func:`~re.sub`, and so forth. " -"These functions take the same arguments as the corresponding pattern method " -"with the RE string added as the first argument, and still return either " -"``None`` or a :ref:`match object ` instance. ::" +"You don't have to create a pattern object and call its methods; " +"the :mod:`re` module also provides top-level functions " +"called :func:`~re.match`, :func:`~re.search`, :func:`~re.findall`, :func:`~re.sub`, " +"and so forth. These functions take the same arguments as the corresponding " +"pattern method with the RE string added as the first argument, and still " +"return either ``None`` or a :ref:`match object ` instance. ::" msgstr "" msgid "" @@ -809,12 +809,12 @@ msgstr "" msgid "" "Compilation flags let you modify some aspects of how regular expressions " "work. Flags are available in the :mod:`re` module under two names, a long " -"name such as :const:`IGNORECASE` and a short, one-letter form such as :const:" -"`I`. (If you're familiar with Perl's pattern modifiers, the one-letter " -"forms use the same letters; the short form of :const:`re.VERBOSE` is :const:" -"`re.X`, for example.) Multiple flags can be specified by bitwise OR-ing " -"them; ``re.I | re.M`` sets both the :const:`I` and :const:`M` flags, for " -"example." +"name such as :const:`IGNORECASE` and a short, one-letter form such " +"as :const:`I`. (If you're familiar with Perl's pattern modifiers, the one-" +"letter forms use the same letters; the short form of :const:`re.VERBOSE` " +"is :const:`re.X`, for example.) Multiple flags can be specified by bitwise " +"OR-ing them; ``re.I | re.M`` sets both the :const:`I` and :const:`M` flags, " +"for example." msgstr "" msgid "" @@ -873,13 +873,13 @@ msgid "" "letters, too. Full Unicode matching also works unless the :const:`ASCII` " "flag is used to disable non-ASCII matches. When the Unicode patterns ``[a-" "z]`` or ``[A-Z]`` are used in combination with the :const:`IGNORECASE` flag, " -"they will match the 52 ASCII letters and 4 additional non-ASCII letters: " -"'İ' (U+0130, Latin capital letter I with dot above), 'ı' (U+0131, Latin " -"small letter dotless i), 'ſ' (U+017F, Latin small letter long s) and " -"'K' (U+212A, Kelvin sign). ``Spam`` will match ``'Spam'``, ``'spam'``, " -"``'spAM'``, or ``'ſpam'`` (the latter is matched only in Unicode mode). This " -"lowercasing doesn't take the current locale into account; it will if you " -"also set the :const:`LOCALE` flag." +"they will match the 52 ASCII letters and 4 additional non-ASCII letters: 'İ' " +"(U+0130, Latin capital letter I with dot above), 'ı' (U+0131, Latin small " +"letter dotless i), 'ſ' (U+017F, Latin small letter long s) and 'K' (U+212A, " +"Kelvin sign). ``Spam`` will match ``'Spam'``, ``'spam'``, ``'spAM'``, or " +"``'ſpam'`` (the latter is matched only in Unicode mode). This lowercasing " +"doesn't take the current locale into account; it will if you also set " +"the :const:`LOCALE` flag." msgstr "" msgid "" @@ -1027,9 +1027,9 @@ msgstr "``^``" msgid "" "Matches at the beginning of lines. Unless the :const:`MULTILINE` flag has " -"been set, this will only match at the beginning of the string. In :const:" -"`MULTILINE` mode, this also matches immediately after each newline within " -"the string." +"been set, this will only match at the beginning of the string. " +"In :const:`MULTILINE` mode, this also matches immediately after each newline " +"within the string." msgstr "" msgid "" @@ -1209,12 +1209,12 @@ msgstr "" msgid "" "Groups indicated with ``'('``, ``')'`` also capture the starting and ending " "index of the text that they match; this can be retrieved by passing an " -"argument to :meth:`~re.Match.group`, :meth:`~re.Match.start`, :meth:`~re." -"Match.end`, and :meth:`~re.Match.span`. Groups are numbered starting with " -"0. Group 0 is always present; it's the whole RE, so :ref:`match object " -"` methods all have group 0 as their default argument. Later " -"we'll see how to express groups that don't capture the span of text that " -"they match. ::" +"argument " +"to :meth:`~re.Match.group`, :meth:`~re.Match.start`, :meth:`~re.Match.end`, " +"and :meth:`~re.Match.span`. Groups are numbered starting with 0. Group 0 " +"is always present; it's the whole RE, so :ref:`match object ` " +"methods all have group 0 as their default argument. Later we'll see how to " +"express groups that don't capture the span of text that they match. ::" msgstr "" msgid "" @@ -1413,8 +1413,8 @@ msgid "" msgstr "" msgid "" -"Additionally, you can retrieve named groups as a dictionary with :meth:`~re." -"Match.groupdict`::" +"Additionally, you can retrieve named groups as a dictionary " +"with :meth:`~re.Match.groupdict`::" msgstr "" msgid "" @@ -1428,8 +1428,8 @@ msgstr "" msgid "" "Named groups are handy because they let you use easily remembered names, " -"instead of having to remember numbers. Here's an example RE from the :mod:" -"`imaplib` module::" +"instead of having to remember numbers. Here's an example RE from " +"the :mod:`imaplib` module::" msgstr "" msgid "" @@ -1458,8 +1458,8 @@ msgid "" "name instead of the number. This is another Python extension: ``(?P=name)`` " "indicates that the contents of the group called *name* should again be " "matched at the current point. The regular expression for finding doubled " -"words, ``\\b(\\w+)\\s+\\1\\b`` can also be written as ``\\b(?" -"P\\w+)\\s+(?P=word)\\b``::" +"words, ``\\b(\\w+)\\s+\\1\\b`` can also be written as ``\\b(?P\\w+)\\s+" +"(?P=word)\\b``::" msgstr "" msgid "" @@ -1543,10 +1543,10 @@ msgid "" "The expression gets messier when you try to patch up the first solution by " "requiring one of the following cases to match: the first character of the " "extension isn't ``b``; the second character isn't ``a``; or the third " -"character isn't ``t``. This accepts ``foo.bar`` and rejects ``autoexec." -"bat``, but it requires a three-letter extension and won't accept a filename " -"with a two-letter extension such as ``sendmail.cf``. We'll complicate the " -"pattern again in an effort to fix it." +"character isn't ``t``. This accepts ``foo.bar`` and rejects " +"``autoexec.bat``, but it requires a three-letter extension and won't accept " +"a filename with a two-letter extension such as ``sendmail.cf``. We'll " +"complicate the pattern again in an effort to fix it." msgstr "" msgid "``.*[.]([^b].?.?|.[^a]?.?|..?[^t]?)$``" @@ -1841,13 +1841,13 @@ msgstr "" msgid "" "Sometimes using the :mod:`re` module is a mistake. If you're matching a " -"fixed string, or a single character class, and you're not using any :mod:" -"`re` features such as the :const:`~re.IGNORECASE` flag, then the full power " -"of regular expressions may not be required. Strings have several methods for " -"performing operations with fixed strings and they're usually much faster, " -"because the implementation is a single small C loop that's been optimized " -"for the purpose, instead of the large, more generalized regular expression " -"engine." +"fixed string, or a single character class, and you're not using " +"any :mod:`re` features such as the :const:`~re.IGNORECASE` flag, then the " +"full power of regular expressions may not be required. Strings have several " +"methods for performing operations with fixed strings and they're usually " +"much faster, because the implementation is a single small C loop that's been " +"optimized for the purpose, instead of the large, more generalized regular " +"expression engine." msgstr "" msgid "" @@ -1858,8 +1858,8 @@ msgid "" "turning ``swordfish`` into ``sdeedfish``, but the naive RE ``word`` would " "have done that, too. (To avoid performing the substitution on parts of " "words, the pattern would have to be ``\\bword\\b``, in order to require that " -"``word`` have a word boundary on either side. This takes the job beyond :" -"meth:`!replace`'s abilities.)" +"``word`` have a word boundary on either side. This takes the job " +"beyond :meth:`!replace`'s abilities.)" msgstr "" msgid "" @@ -1915,14 +1915,15 @@ msgstr "" "(2, 7)" msgid "" -"Sometimes you'll be tempted to keep using :func:`re.match`, and just add ``." -"*`` to the front of your RE. Resist this temptation and use :func:`re." -"search` instead. The regular expression compiler does some analysis of REs " -"in order to speed up the process of looking for a match. One such analysis " -"figures out what the first character of a match must be; for example, a " -"pattern starting with ``Crow`` must match starting with a ``'C'``. The " -"analysis lets the engine quickly scan through the string looking for the " -"starting character, only trying the full match if a ``'C'`` is found." +"Sometimes you'll be tempted to keep using :func:`re.match`, and just add " +"``.*`` to the front of your RE. Resist this temptation and " +"use :func:`re.search` instead. The regular expression compiler does some " +"analysis of REs in order to speed up the process of looking for a match. " +"One such analysis figures out what the first character of a match must be; " +"for example, a pattern starting with ``Crow`` must match starting with a " +"``'C'``. The analysis lets the engine quickly scan through the string " +"looking for the starting character, only trying the full match if a ``'C'`` " +"is found." msgstr "" msgid "" diff --git a/howto/remote_debugging.po b/howto/remote_debugging.po index 14dcbf14f1..bcf7cd4c05 100644 --- a/howto/remote_debugging.po +++ b/howto/remote_debugging.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-21 15:07+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,8 +32,8 @@ msgid "" msgstr "" msgid "" -"Most platforms require elevated privileges to attach to another Python " -"process." +"Attaching to another Python process may require additional permissions or " +"configuration, depending on the platform." msgstr "" msgid "Disabling remote debugging" @@ -47,7 +47,7 @@ msgid "" "before starting the interpreter." msgstr "" -msgid "Use the :option:`-X disable_remote_debug` command-line option." +msgid "Use the :option:`-X disable-remote-debug` command-line option." msgstr "" msgid "Compile Python with the :option:`--without-remote-debug` build flag." @@ -57,56 +57,120 @@ msgid "Permission requirements" msgstr "" msgid "" -"Attaching to a running Python process for remote debugging requires elevated " -"privileges on most platforms. The specific requirements and troubleshooting " -"steps depend on your operating system:" +"Attaching to a running Python process for remote debugging requires special " +"configuration on most platforms. The specific requirements and " +"troubleshooting steps depend on your operating system:" msgstr "" msgid "Linux" msgstr "" msgid "" -"The tracer process must have the ``CAP_SYS_PTRACE`` capability or equivalent " -"privileges. You can only trace processes you own and can signal. Tracing may " -"fail if the process is already being traced, or if it is running with set-" -"user-ID or set-group-ID. Security modules like Yama may further restrict " -"tracing." +"In general, you can debug your own processes, but there are several common " +"configurations that may disable this. Some Linux distributions enable " +"**ptrace restrictions**, aka \"Yama,\" as a form of system hardening. Recent " +"versions of the ``setpriv`` command (util-linux 2.41, released June 2025) " +"let you loosen ptrace restrictions on a per-process basis:" msgstr "" -msgid "To temporarily relax ptrace restrictions (until reboot), run:" +msgid "``setpriv --ptracer any python3``" +msgstr "" + +msgid "" +"(This is configured on the process *being debugged*.) You can also turn off " +"ptrace restrictions for all processes until reboot with:" msgstr "" msgid "``echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope``" msgstr "" +msgid "This can also be configured persistently, usually in ``/etc/sysctl.d``." +msgstr "" + msgid "" "Disabling ``ptrace_scope`` reduces system hardening and should only be done " -"in trusted environments." +"in low-security environments." +msgstr "" + +msgid "" +"It is also possible that the ``ptrace`` system call is disabled because of a " +"security filter. In particular, this was common with older versions of some " +"container software. Docker 19.03 or newer (released 2019) and containerd " +"1.6.7 or newer (released 2022) will automatically allow usage of the " +"``ptrace`` system call inside containers, when running on Linux kernel 4.8 " +"or higher. If you cannot upgrade to these versions, you can create your " +"container with an option like ``--security-opt seccomp=unconfined`` to " +"disable the system call security filter for that container. This weakens the " +"container's isolation and should only be done in low-security environments." msgstr "" msgid "" -"If running inside a container, use ``--cap-add=SYS_PTRACE`` or ``--" -"privileged``, and run as root if needed." +"If you need to trace a process that you *do not* own, you will need " +"superuser access or equivalent. This also applies to processes that have " +"changed their security credentials, e.g., set-user-ID or set-group-ID " +"processes (though this is unusual for Python). Try running the debugging " +"command with ``sudo -E``." msgstr "" -msgid "Try re-running the command with elevated privileges:" +msgid "" +"The ``CAP_SYS_PTRACE`` capability is equivalent to superuser access, in that " +"it allows debugging *any* process, not just your own. You may see advice on " +"the internet suggesting using it to work around ptrace restrictions or " +"system call filters. This may work in practice, as would ``sudo``, but this " +"gives the debugging process much more access than it needs and should only " +"be done in low-security environments." msgstr "" -msgid "``sudo -E !!``" +msgid "" +"Finally, note that a process can only have one tracer at a time. If you have " +"already attached to a Python process under ``strace``, ``gdb``, etc., you " +"won't be able to simultaneously use remote debugging. (Superuser access " +"cannot get around this restriction.)" msgstr "" msgid "macOS" msgstr "macOS" +msgid "By default, macOS disables the ability to debug other processes." +msgstr "" + +msgid "" +"You can modify your Python binary to opt in to being debugged by giving it " +"an **ad-hoc code signature** with an **entitlement** enabling it to be " +"debugged. (An ad-hoc \"signature\" is just a configuration without any " +"actual cryptographic signature or a need for a certificate or anything else " +"such as an Apple developer program membership.)" +msgstr "" + +msgid "" +"The following commands will create a file ``get-task-allow.plist`` with the " +"necessary entitlement and add it to the Python binary:" +msgstr "" + +msgid "" +"echo '{\"com.apple.security.get-task-allow\": true}' | plutil -convert xml1 " +"-o get-task-allow.plist -\n" +"codesign --sign - --entitlements get-task-allow.plist path/to/bin/python3" +msgstr "" + +msgid "" +"where ``path/to/bin/python3`` is the path to your Python binary, which you " +"can find by e.g. running ``which python3`` or evaluating " +"``sys.base_executable`` at the Python REPL. (These instructions are for a " +"non-framework build of Python. Framework builds may need to be configured " +"differently.)" +msgstr "" + msgid "" -"To attach to another process, you typically need to run your debugging tool " -"with elevated privileges. This can be done by using ``sudo`` or running as " -"root." +"You should then be able to debug your own Python processes started with that " +"binary." msgstr "" msgid "" -"Even when attaching to processes you own, macOS may block debugging unless " -"the debugger is run with root privileges due to system security restrictions." +"Alternatively, much as with Linux, processes with superuser privileges e.g. " +"``sudo`` are not subject to this check and can debug any user's process on " +"the system (though there are additional checks on specific binaries, such as " +"OS-provided commands, due to System Integrity Protection)." msgstr "" msgid "Windows" @@ -244,8 +308,8 @@ msgid "" msgstr "" msgid "" -"Parse the ELF section headers in the binary to get the offset of the ``." -"PyRuntime`` section." +"Parse the ELF section headers in the binary to get the offset of the " +"``.PyRuntime`` section." msgstr "" msgid "" @@ -407,9 +471,9 @@ msgid "" msgstr "" msgid "" -"Identify the module corresponding to :file:`python.exe` or :file:`python{XY}." -"dll`, where ``X`` and ``Y`` are the major and minor version numbers of the " -"Python version, and record its base address." +"Identify the module corresponding to :file:`python.exe` " +"or :file:`python{XY}.dll`, where ``X`` and ``Y`` are the major and minor " +"version numbers of the Python version, and record its base address." msgstr "" msgid "" @@ -925,7 +989,7 @@ msgstr "" msgid "" "The environment variable :envvar:`PYTHON_DISABLE_REMOTE_DEBUG` (and the " -"equivalent :option:`-X disable_remote_debug` flag) allows operators to " +"equivalent :option:`-X disable-remote-debug` flag) allows operators to " "disable the in-process side of the protocol as a **defence-in-depth** " "measure. This may be useful in hardened or sandboxed deployment " "environments where no debugging or profiling of the process is expected and " diff --git a/howto/sockets.po b/howto/sockets.po index f1af66934c..9ec0c22d5f 100644 --- a/howto/sockets.po +++ b/howto/sockets.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,7 +46,7 @@ msgid "" msgstr "" msgid "Sockets" -msgstr "" +msgstr "Sockety" msgid "" "I'm only going to talk about INET (i.e. IPv4) sockets, but they account for " @@ -123,11 +124,11 @@ msgstr "" msgid "" "A couple things to notice: we used ``socket.gethostname()`` so that the " -"socket would be visible to the outside world. If we had used ``s." -"bind(('localhost', 80))`` or ``s.bind(('127.0.0.1', 80))`` we would still " -"have a \"server\" socket, but one that was only visible within the same " -"machine. ``s.bind(('', 80))`` specifies that the socket is reachable by any " -"address the machine happens to have." +"socket would be visible to the outside world. If we had used " +"``s.bind(('localhost', 80))`` or ``s.bind(('127.0.0.1', 80))`` we would " +"still have a \"server\" socket, but one that was only visible within the " +"same machine. ``s.bind(('', 80))`` specifies that the socket is reachable " +"by any address the machine happens to have." msgstr "" msgid "" diff --git a/howto/sorting.po b/howto/sorting.po index fad78141a4..c291f3f60d 100644 --- a/howto/sorting.po +++ b/howto/sorting.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -86,15 +86,16 @@ msgid "Key Functions" msgstr "" msgid "" -"The :meth:`list.sort` method and the functions :func:`sorted`, :func:`min`, :" -"func:`max`, :func:`heapq.nsmallest`, and :func:`heapq.nlargest` have a *key* " -"parameter to specify a function (or other callable) to be called on each " -"list element prior to making comparisons." +"The :meth:`list.sort` method and the " +"functions :func:`sorted`, :func:`min`, :func:`max`, :func:`heapq.nsmallest`, " +"and :func:`heapq.nlargest` have a *key* parameter to specify a function (or " +"other callable) to be called on each list element prior to making " +"comparisons." msgstr "" msgid "" -"For example, here's a case-insensitive string comparison using :meth:`str." -"casefold`:" +"For example, here's a case-insensitive string comparison " +"using :meth:`str.casefold`:" msgstr "" msgid "" @@ -149,8 +150,8 @@ msgstr "" msgid "" "Objects with named attributes can be made by a regular class as shown above, " -"or they can be instances of :class:`~dataclasses.dataclass` or a :term:" -"`named tuple`." +"or they can be instances of :class:`~dataclasses.dataclass` or " +"a :term:`named tuple`." msgstr "" msgid "Operator Module Functions and Partial Function Evaluation" @@ -159,8 +160,9 @@ msgstr "" msgid "" "The :term:`key function` patterns shown above are very common, so Python " "provides convenience functions to make accessor functions easier and faster. " -"The :mod:`operator` module has :func:`~operator.itemgetter`, :func:" -"`~operator.attrgetter`, and a :func:`~operator.methodcaller` function." +"The :mod:`operator` module " +"has :func:`~operator.itemgetter`, :func:`~operator.attrgetter`, and " +"a :func:`~operator.methodcaller` function." msgstr "" msgid "Using those functions, the above examples become simpler and faster:" @@ -338,9 +340,9 @@ msgid "" msgstr "" msgid "" -"Another name for this idiom is `Schwartzian transform `_\\, after Randal L. Schwartz, who " -"popularized it among Perl programmers." +"Another name for this idiom is `Schwartzian transform `_\\, after Randal L. Schwartz, " +"who popularized it among Perl programmers." msgstr "" msgid "" @@ -372,9 +374,9 @@ msgid "" msgstr "" msgid "" -"To accommodate those situations, Python provides :class:`functools." -"cmp_to_key` to wrap the comparison function to make it usable as a key " -"function::" +"To accommodate those situations, Python " +"provides :class:`functools.cmp_to_key` to wrap the comparison function to " +"make it usable as a key function::" msgstr "" msgid "sorted(words, key=cmp_to_key(strcoll)) # locale-aware sort order" @@ -462,9 +464,9 @@ msgid "Odds and Ends" msgstr "Przypadki losowe" msgid "" -"For locale aware sorting, use :func:`locale.strxfrm` for a key function or :" -"func:`locale.strcoll` for a comparison function. This is necessary because " -"\"alphabetical\" sort orderings can vary across cultures even if the " +"For locale aware sorting, use :func:`locale.strxfrm` for a key function " +"or :func:`locale.strcoll` for a comparison function. This is necessary " +"because \"alphabetical\" sort orderings can vary across cultures even if the " "underlying alphabet is the same." msgstr "" @@ -487,8 +489,8 @@ msgstr "" msgid "" "The sort routines use ``<`` when making comparisons between two objects. So, " -"it is easy to add a standard sort order to a class by defining an :meth:" -"`~object.__lt__` method:" +"it is easy to add a standard sort order to a class by defining " +"an :meth:`~object.__lt__` method:" msgstr "" msgid "" @@ -498,10 +500,10 @@ msgid "" msgstr "" msgid "" -"However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :" -"meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for " +"However, note that ``<`` can fall back to using :meth:`~object.__gt__` " +"if :meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for " "details on the mechanics). To avoid surprises, :pep:`8` recommends that all " -"six comparison methods be implemented. The :func:`~functools.total_ordering` " +"six comparison methods be implemented. The :deco:`~functools.total_ordering` " "decorator is provided to make that task easier." msgstr "" diff --git a/howto/timerfd.po b/howto/timerfd.po index 1eaf9c650c..b629e19f69 100644 --- a/howto/timerfd.po +++ b/howto/timerfd.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -181,8 +181,8 @@ msgid "" " conn = None\n" " elif fd in fds:\n" " print(f\"Reading timer {fd}\")\n" -" count = int.from_bytes(os.read(fd, 8), byteorder=sys." -"byteorder)\n" +" count = int.from_bytes(os.read(fd, 8), " +"byteorder=sys.byteorder)\n" " print(f\"Timer {fds.index(fd) + 1} expired {count} " "times\")\n" " else:\n" @@ -266,8 +266,8 @@ msgid "" " conn = None\n" " elif fd in fds:\n" " print(f\"Reading timer {fd}\")\n" -" count = int.from_bytes(os.read(fd, 8), byteorder=sys." -"byteorder)\n" +" count = int.from_bytes(os.read(fd, 8), " +"byteorder=sys.byteorder)\n" " print(f\"Timer {fds.index(fd) + 1} expired {count} times\")\n" " else:\n" " print(f\"Unknown file descriptor {fd}\")\n" diff --git a/howto/unicode.po b/howto/unicode.po index 11c1896a21..a1244ad7b6 100644 --- a/howto/unicode.po +++ b/howto/unicode.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -74,10 +74,10 @@ msgstr "" msgid "" "The Unicode standard describes how characters are represented by **code " "points**. A code point value is an integer in the range 0 to 0x10FFFF " -"(about 1.1 million values, the `actual number assigned `_ is less than that). In the standard and in " -"this document, a code point is written using the notation ``U+265E`` to mean " -"the character with value ``0x265e`` (9,822 in decimal)." +"(about 1.1 million values, the `actual number assigned `_ is less than that). In the " +"standard and in this document, a code point is written using the notation " +"``U+265E`` to mean the character with value ``0x265e`` (9,822 in decimal)." msgstr "" msgid "" @@ -249,8 +249,8 @@ msgid "" msgstr "" msgid "" -"Another `good introductory article `_ was " "written by Joel Spolsky. If this introduction didn't make things clear to " "you, you should try reading this alternate article before continuing." @@ -387,10 +387,10 @@ msgid "" msgstr "" msgid "" -"The *errors* parameter is the same as the parameter of the :meth:`~bytes." -"decode` method but supports a few more possible handlers. As well as " -"``'strict'``, ``'ignore'``, and ``'replace'`` (which in this case inserts a " -"question mark instead of the unencodable character), there is also " +"The *errors* parameter is the same as the parameter of " +"the :meth:`~bytes.decode` method but supports a few more possible handlers. " +"As well as ``'strict'``, ``'ignore'``, and ``'replace'`` (which in this case " +"inserts a question mark instead of the unencodable character), there is also " "``'xmlcharrefreplace'`` (inserts an XML character reference), " "``backslashreplace`` (inserts a ``\\uNNNN`` escape sequence) and " "``namereplace`` (inserts a ``\\N{...}`` escape sequence)." @@ -540,9 +540,9 @@ msgid "" "subcategories. To take the codes from the above output, ``'Ll'`` means " "'Letter, lowercase', ``'No'`` means \"Number, other\", ``'Mn'`` is \"Mark, " "nonspacing\", and ``'So'`` is \"Symbol, other\". See `the General Category " -"Values section of the Unicode Character Database documentation `_ for a list of category " -"codes." +"Values section of the Unicode Character Database documentation `_ for a list of " +"category codes." msgstr "" msgid "Comparing Strings" @@ -575,12 +575,12 @@ msgstr "" "'gürzenichstrasse'" msgid "" -"A second tool is the :mod:`unicodedata` module's :func:`~unicodedata." -"normalize` function that converts strings to one of several normal forms, " -"where letters followed by a combining character are replaced with single " -"characters. :func:`~unicodedata.normalize` can be used to perform string " -"comparisons that won't falsely report inequality if two strings use " -"combining characters differently:" +"A second tool is the :mod:`unicodedata` " +"module's :func:`~unicodedata.normalize` function that converts strings to " +"one of several normal forms, where letters followed by a combining character " +"are replaced with single characters. :func:`~unicodedata.normalize` can be " +"used to perform string comparisons that won't falsely report inequality if " +"two strings use combining characters differently:" msgstr "" msgid "" @@ -685,8 +685,9 @@ msgid "Some good alternative discussions of Python's Unicode support are:" msgstr "" msgid "" -"`Processing Text Files in Python 3 `_, by Nick Coghlan." +"`Processing Text Files in Python 3 `_, " +"by Nick Coghlan." msgstr "" msgid "" @@ -695,8 +696,8 @@ msgid "" msgstr "" msgid "" -"The :class:`str` type is described in the Python library reference at :ref:" -"`textseq`." +"The :class:`str` type is described in the Python library reference " +"at :ref:`textseq`." msgstr "" msgid "The documentation for the :mod:`unicodedata` module." @@ -758,8 +759,8 @@ msgid "" "object that assumes the file's contents are in a specified encoding and " "accepts Unicode parameters for methods such as :meth:`~io.TextIOBase.read` " "and :meth:`~io.TextIOBase.write`. This works through :func:`open`\\'s " -"*encoding* and *errors* parameters which are interpreted just like those in :" -"meth:`str.encode` and :meth:`bytes.decode`." +"*encoding* and *errors* parameters which are interpreted just like those " +"in :meth:`str.encode` and :meth:`bytes.decode`." msgstr "" msgid "Reading Unicode from a file is therefore simple::" @@ -971,8 +972,8 @@ msgid "" msgstr "" msgid "" -"One section of `Mastering Python 3 Input/Output `_, a PyCon 2010 talk by David " +"One section of `Mastering Python 3 Input/Output `_, a PyCon 2010 talk by David " "Beazley, discusses text processing and binary data handling." msgstr "" diff --git a/howto/urllib2.po b/howto/urllib2.po index 328b97ca3c..ac36fe5d5c 100644 --- a/howto/urllib2.po +++ b/howto/urllib2.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -41,8 +41,8 @@ msgid "" msgstr "" msgid "" -"`Basic Authentication `__" +"`Basic Authentication `__" msgstr "" msgid "A tutorial on *Basic Authentication*, with examples in Python." @@ -90,8 +90,8 @@ msgstr "" msgid "" "If you wish to retrieve a resource via URL and store it in a temporary " -"location, you can do so via the :func:`shutil.copyfileobj` and :func:" -"`tempfile.NamedTemporaryFile` functions::" +"location, you can do so via the :func:`shutil.copyfileobj` " +"and :func:`tempfile.NamedTemporaryFile` functions::" msgstr "" msgid "" @@ -269,13 +269,13 @@ msgstr "Obsługa wyjątków" msgid "" "*urlopen* raises :exc:`~urllib.error.URLError` when it cannot handle a " -"response (though as usual with Python APIs, built-in exceptions such as :exc:" -"`ValueError`, :exc:`TypeError` etc. may also be raised)." +"response (though as usual with Python APIs, built-in exceptions such " +"as :exc:`ValueError`, :exc:`TypeError` etc. may also be raised)." msgstr "" msgid "" -":exc:`~urllib.error.HTTPError` is the subclass of :exc:`~urllib.error." -"URLError` raised in the specific case of HTTP URLs." +":exc:`~urllib.error.HTTPError` is the subclass " +"of :exc:`~urllib.error.URLError` raised in the specific case of HTTP URLs." msgstr "" msgid "The exception classes are exported from the :mod:`urllib.error` module." @@ -312,9 +312,9 @@ msgid "" "request. The default handlers will handle some of these responses for you " "(for example, if the response is a \"redirection\" that requests the client " "fetch the document from a different URL, urllib will handle that for you). " -"For those it can't handle, urlopen will raise an :exc:`~urllib.error." -"HTTPError`. Typical errors include '404' (page not found), '403' (request " -"forbidden), and '401' (authentication required)." +"For those it can't handle, urlopen will raise " +"an :exc:`~urllib.error.HTTPError`. Typical errors include '404' (page not " +"found), '403' (request forbidden), and '401' (authentication required)." msgstr "" msgid "" @@ -384,8 +384,8 @@ msgid "" "...\n" "404\n" "b'\\n\\n\\n\\n\\n\\nPage Not Found\\n\n" " ..." @@ -395,9 +395,9 @@ msgid "Wrapping it Up" msgstr "" msgid "" -"So if you want to be prepared for :exc:`~urllib.error.HTTPError` *or* :exc:" -"`~urllib.error.URLError` there are two basic approaches. I prefer the second " -"approach." +"So if you want to be prepared for :exc:`~urllib.error.HTTPError` " +"*or* :exc:`~urllib.error.URLError` there are two basic approaches. I prefer " +"the second approach." msgstr "" msgid "Number 1" @@ -462,8 +462,8 @@ msgstr "" msgid "" "**info** - this returns a dictionary-like object that describes the page " -"fetched, particularly the headers sent by the server. It is currently an :" -"class:`http.client.HTTPMessage` instance." +"fetched, particularly the headers sent by the server. It is currently " +"an :class:`http.client.HTTPMessage` instance." msgstr "" msgid "" @@ -493,8 +493,8 @@ msgid "" msgstr "" msgid "" -"To create an opener, instantiate an ``OpenerDirector``, and then call ``." -"add_handler(some_handler_instance)`` repeatedly." +"To create an opener, instantiate an ``OpenerDirector``, and then call " +"``.add_handler(some_handler_instance)`` repeatedly." msgstr "" msgid "" @@ -633,8 +633,8 @@ msgstr "" msgid "" "Currently ``urllib.request`` *does not* support fetching of ``https`` " -"locations through a proxy. However, this can be enabled by extending urllib." -"request as shown in the recipe [#]_." +"locations through a proxy. However, this can be enabled by extending " +"urllib.request as shown in the recipe [#]_." msgstr "" msgid "" @@ -654,9 +654,9 @@ msgid "" "As of Python 2.3 you can specify how long a socket should wait for a " "response before timing out. This can be useful in applications which have to " "fetch web pages. By default the socket module has *no timeout* and can hang. " -"Currently, the socket timeout is not exposed at the http.client or urllib." -"request levels. However, you can set the default timeout globally for all " -"sockets using ::" +"Currently, the socket timeout is not exposed at the http.client or " +"urllib.request levels. However, you can set the default timeout globally for " +"all sockets using ::" msgstr "" msgid "" diff --git a/improve-page-nojs.po b/improve-page-nojs.po index d7368abb2a..7fb18be264 100644 --- a/improve-page-nojs.po +++ b/improve-page-nojs.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# Mariusz Krzaczkowski, 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2026-02-19 14:44+0000\n" -"Last-Translator: Mariusz Krzaczkowski, 2026\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,6 +37,9 @@ msgid "" "documentation, open an issue or edit the page in `translation's repository " "`_ instead." msgstr "" +"Jeśli błąd lub propozycja ulepszenia dotyczy tłumaczenia tej dokumentacji, " +"prosimy o zgłoszenie problemu lub edycję strony w `repozytorium tłumaczenia " +"`_." msgid "You have a few ways to ask questions or suggest changes:" msgstr "Masz kilka sposobów, aby zadać pytania lub zaproponować zmiany:" @@ -46,9 +50,17 @@ msgid "" "Documentation topic `_." msgstr "" +"Możesz rozpocząć dyskusję na temat tej strony na forum dyskusyjnym Pythona. " +"Ten link pozwoli utworzyć nowy wątek w kategorii „Dokumentacja”: `Nowy wątek " +"dotyczący dokumentacji `_." msgid "" "You can open an issue on the Python GitHub issue tracker. This link will " -"create a new issue with the \"docs\" label: `New docs issue `_." +"create a new issue with the \"docs\" label: `New docs issue `_." msgstr "" +"Możesz utworzyć zgłoszenie w systemie śledzenia zgłoszeń Pythona na " +"GitHubie. Ten link pozwoli utworzyć nowe zgłoszenie z etykietą „docs”: `Nowe " +"zgłoszenie dotyczące dokumentacji `_." diff --git a/improve-page.po b/improve-page.po index bb0ccffd86..10b8c1cff9 100644 --- a/improve-page.po +++ b/improve-page.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# Mariusz Krzaczkowski, 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2026-02-19 14:44+0000\n" -"Last-Translator: Mariusz Krzaczkowski, 2026\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,6 +46,9 @@ msgid "" "documentation, open an issue or edit the page in `translation's repository " "`_ instead." msgstr "" +"Jeśli błąd lub propozycja ulepszenia dotyczy tłumaczenia tej dokumentacji, " +"prosimy o zgłoszenie problemu lub edycję strony w `repozytorium tłumaczenia " +"`_." msgid "You have a few ways to ask questions or suggest changes:" msgstr "Masz kilka sposobów, aby zadać pytania lub zaproponować zmiany:" @@ -56,17 +60,31 @@ msgid "" "category=documentation&title=Question+about+page+" "%22PAGETITLE%22&body=About+the+page+at+PAGEURL%3A>`_." msgstr "" +"Możesz rozpocząć dyskusję na temat tej strony na forum dyskusyjnym Pythona. " +"Ten link pozwoli utworzyć wątek z gotowym tekstem: `Question about page " +"\"PAGETITLE\" `_." msgid "" "You can open an issue on the Python GitHub issue tracker. This link will " "create a new pre-populated issue: `Docs: problem with page \"PAGETITLE\" " -"`_." msgstr "" +"Możesz utworzyć zgłoszenie w systemie śledzenia zgłoszeń Pythona na " +"platformie GitHub. Ten link pozwoli utworzyć nowe, wstępnie wypełnione " +"zgłoszenie: `Docs: problem with page \"PAGETITLE\" ``_." msgid "" "You can `edit the page on GitHub `_ to open a pull request and begin the " "contribution process." msgstr "" +"Możesz `edytować stronę na GitHubie `_, aby utworzyć pull request i rozpocząć " +"współpracę." diff --git a/installing/index.po b/installing/index.po index 81f1c7b751..96ff7d40e8 100644 --- a/installing/index.po +++ b/installing/index.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,6 +32,10 @@ msgid "" "supporting community of contributors and users that also make their software " "available for other Python developers to use under open-source license terms." msgstr "" +"Python, jako popularny projekt open source, cieszy się aktywnym wsparciem " +"społeczności współtwórców i użytkowników, którzy udostępniają tworzone przez " +"siebie oprogramowanie innym deweloperom Pythona w ramach licencji open " +"source." msgid "" "This allows Python users to share and collaborate effectively, benefiting " @@ -70,6 +75,8 @@ msgid "" ":program:`pip` is the preferred installer program. It is included by default " "with the Python binary installers." msgstr "" +":program:`pip` jest preferowanym instalatorem. Jest domyślnie dołączony do " +"instalatorów binarnych." msgid "" "A *virtual environment* is a semi-isolated Python environment that allows " @@ -83,16 +90,22 @@ msgid "" "``venv`` is the standard tool for creating virtual environments. It defaults " "to installing :program:`pip` into all created virtual environments." msgstr "" +"``venv`` jest standardowym narzędziem do tworzenia środowisk wirtualnych. " +"Domyślnie instaluje :program:`pip` we wszystkich tworzonych środowiskach " +"wirtualnych." msgid "" "``virtualenv`` is a third-party alternative (and predecessor) to ``venv``." -msgstr "" +msgstr "``virtualenv`` jest zewnętrzną alternatywą (i poprzednikiem) ``venv``." msgid "" "The `Python Package Index (PyPI) `__ is a public " "repository of open source licensed packages made available for use by other " "Python users." msgstr "" +"`Python Package Index (PyPI) `__ jest publicznym " +"repozytorium paczek z licencją open-source, udostępnionych do wykorzystania " +"przez innych użytkowników Pythona." msgid "" "The `Python Packaging Authority `__ is the group of " @@ -101,6 +114,11 @@ msgid "" "file format standards. They maintain a variety of tools, documentation, and " "issue trackers on `GitHub `__." msgstr "" +"`Python Packaging Authority `__ to grupa programistów " +"i autorów dokumentacji odpowiedzialnych za utrzymanie i ewolucję " +"standardowych narzędzi do pakowania oraz powiązanych metadanych i standardów " +"formatu plików. Utrzymują oni różne narzędzia, dokumentację i repozytoria " +"zgłoszeń na `GitHub `__." msgid "" "The use of ``venv`` is now recommended for creating virtual environments." @@ -116,17 +134,21 @@ msgstr "" "`__" msgid "Basic usage" -msgstr "" +msgstr "Podstawowe użycie" msgid "" "The standard packaging tools are all designed to be used from the command " "line." msgstr "" +"Wszystkie standardowe narzędzia do pakowania są przeznaczone do użycia z " +"wiersza poleceń." msgid "" "The following command will install the latest version of a module and its " "dependencies from PyPI::" msgstr "" +"Poniższa komenda pozwoli zainstalować najnowszą wersję modułu wraz z jej " +"zależnościami z PyPI::" msgid "python -m pip install SomePackage" msgstr "python -m pip install JakisPakiet" @@ -135,12 +157,18 @@ msgid "" "For POSIX users (including macOS and Linux users), the examples in this " "guide assume the use of a :term:`virtual environment`." msgstr "" +"W przypadku użytkowników systemu POSIX (w tym użytkowników systemów macOS i " +"Linux) przykłady zawarte w niniejszym przewodniku zakładają korzystanie " +"z :term:`środowiska wirtualnego `." msgid "" "For Windows users, the examples in this guide assume that the option to " "adjust the system PATH environment variable was selected when installing " "Python." msgstr "" +"W przypadku użytkowników systemu Windows przykłady zawarte w niniejszym " +"przewodniku zakładają, że podczas instalacji Pythona wybrano opcję " +"dostosowania systemowej zmiennej środowiskowej PATH." msgid "" "It's also possible to specify an exact or minimum version directly on the " @@ -148,6 +176,10 @@ msgid "" "other special character which get interpreted by shell, the package name and " "the version should be enclosed within double quotes::" msgstr "" +"Można również podać dokładną lub minimalną wersję bezpośrednio w wierszu " +"poleceń. W przypadku stosowania operatorów porównania, takich jak ``>``, " +"``<`` lub innych znaków specjalnych, które są interpretowane przez powłokę, " +"nazwa pakietu oraz wersja powinny być ujęte w podwójne cudzysłowy::" msgid "" "python -m pip install SomePackage==1.0.4 # specific version\n" @@ -161,15 +193,21 @@ msgid "" "it again will have no effect. Upgrading existing modules must be requested " "explicitly::" msgstr "" +"Zazwyczaj, jeśli odpowiedni moduł jest już zainstalowany, próba ponownej " +"instalacji nie przyniesie żadnego efektu. Aby zaktualizować istniejący " +"moduł, należy wyraźnie zgłosić taką prośbę::" msgid "python -m pip install --upgrade SomePackage" msgstr "Python -m pip install --upgrade JakisPakiet" msgid "" "More information and resources regarding :program:`pip` and its capabilities " -"can be found in the `Python Packaging User Guide `__." +"can be found in the `Python Packaging User Guide `__." msgstr "" +"Więcej informacji i materiałów dotyczących pakietu :program:`pip` oraz jego " +"możliwości można znaleźć w `Podręczniku użytkownika packagingu Pythona " +"`__." msgid "" "Creation of virtual environments is done through the :mod:`venv` module. " @@ -181,6 +219,8 @@ msgid "" "`Python Packaging User Guide: Installing Python Distribution Packages " "`__" msgstr "" +"`Python Packaging User Guide: Installing Python Distribution Packages " +"`__" msgid "How do I ...?" msgstr "Jak ...?" @@ -195,9 +235,12 @@ msgid "" "Passing the ``--user`` option to ``python -m pip install`` will install a " "package just for the current user, rather than for all users of the system." msgstr "" +"Przekazanie opcji ``--user`` do polecenia ``python -m pip install`` " +"zainstaluje pakiet wyłącznie dla bieżącego użytkownika, a nie dla wszystkich " +"użytkowników systemu." msgid "... install scientific Python packages?" -msgstr "" +msgstr "... zainstalować naukowe pakiety Pythona?" msgid "" "A number of scientific Python packages have complex binary dependencies, and " @@ -206,44 +249,62 @@ msgid "" "packaging.python.org/science/>`__ rather than attempting to install them " "with :program:`pip`." msgstr "" +"Wiele pakietów naukowych Pythona charakteryzuje się złożonymi zależnościami " +"między plikami binarnymi i obecnie nie da się ich łatwo zainstalować " +"bezpośrednio za pomocą :program:`pip`. Użytkownikom często łatwiej będzie " +"zainstalować te pakiety pakiet `innymi metodami `__, zamiast próbować zainstalować je za " +"pomocą :program:`pip`." msgid "" "`Python Packaging User Guide: Installing Scientific Packages `__" msgstr "" +"`Python Packaging User Guide: Installing Scientific Packages `__" msgid "... work with multiple versions of Python installed in parallel?" -msgstr "" +msgstr "... pracować z wieloma wersjami Pythona zainstalowanymi równolegle?" msgid "" "On Linux, macOS, and other POSIX systems, use the versioned Python commands " -"in combination with the ``-m`` switch to run the appropriate copy of :" -"program:`pip`::" +"in combination with the ``-m`` switch to run the appropriate copy " +"of :program:`pip`::" msgstr "" +"W systemach Linux, macOS i innych systemach zgodnych z POSIX należy używać " +"wersjonowanych komend Pythona w połączeniu z opcją ``-m``, aby uruchomić " +"odpowiednią kopię :program:`pip`::" msgid "" "python3 -m pip install SomePackage # default Python 3\n" "python3.14 -m pip install SomePackage # specifically Python 3.14" msgstr "" +"python3 -m pip install JakisPakiet # domyślny Python 3\n" +"python3.14 -m pip install JakisPakiet # konkretnie Python 3.14" msgid "Appropriately versioned :program:`pip` commands may also be available." msgstr "" +"Dostępne mogą być również odpowiednio wersjonowane komendy :program:`pip`." msgid "" "On Windows, use the :program:`py` Python launcher in combination with the ``-" "m`` switch::" msgstr "" +"W systemie Windows należy użyć programu uruchamiającego :program:`py` w " +"połączeniu z opcją ``-m``::" msgid "" "py -3 -m pip install SomePackage # default Python 3\n" "py -3.14 -m pip install SomePackage # specifically Python 3.14" msgstr "" +"py -3 -m pip install JakisPakiet # domyślny Python 3\n" +"py -3.14 -m pip install JakisPakiet # konkretnie Python 3.14" msgid "Common installation issues" msgstr "" msgid "Installing into the system Python on Linux" -msgstr "" +msgstr "Instalacja w Pythonie systemowym w systemie Linux" msgid "" "On Linux systems, a Python installation will typically be included as part " @@ -252,11 +313,19 @@ msgid "" "package manager and other components of the system if a component is " "unexpectedly upgraded using :program:`pip`." msgstr "" +"W systemach Linux instalacja Pythona jest zazwyczaj zawarta w dystrybucji. " +"Instalacja w ramach tej instalacji Python wymaga uprawnień administratora " +"(root) do systemu i może zakłócić działanie systemowego menedżera pakietów " +"oraz innych komponentów systemu, jeśli któryś z nich zostanie nieoczekiwanie " +"zaktualizowany za pomocą :program:`pip`." msgid "" "On such systems, it is often better to use a virtual environment or a per-" "user installation when installing packages with :program:`pip`." msgstr "" +"W takich systemach często lepiej jest skorzystać z instalacji do środowiska " +"wirtualnego lub instalacji dla użytkownika podczas instalowania pakietów za " +"pomocą :program:`pip`." msgid "Pip not installed" msgstr "" @@ -265,14 +334,16 @@ msgid "" "It is possible that :program:`pip` does not get installed by default. One " "potential fix is::" msgstr "" +"Możliwe, że :program:`pip` nie zostanie zainstalowany domyślnie. Jednym z " +"możliwych rozwiązań jest::" msgid "python -m ensurepip --default-pip" -msgstr "" +msgstr "python -m ensurepip --default-pip" msgid "" -"There are also additional resources for `installing pip `__." +"There are also additional resources for `installing pip `__." msgstr "" msgid "Installing binary extensions" @@ -283,6 +354,9 @@ msgid "" "being expected to compile extension modules from source as part of the " "installation process." msgstr "" +"Python kiedyś opierał się w dużej mierze na dystrybucji opartej na kodzie " +"źródłowym, a od użytkowników końcowych oczekiwano, że w ramach instalacji " +"skompilują moduł rozszerzenia z kodu źródłowego." msgid "" "With the introduction of the binary wheel format, and the ability to publish " @@ -290,15 +364,25 @@ msgid "" "regularly able to install pre-built extensions rather than needing to build " "them themselves." msgstr "" +"Wraz z wprowadzeniem binarnego formatu wheel oraz możliwością publikowania " +"wheeli za pośrednictwem PyPI problem ten staje się coraz mniej dotkliwy, " +"ponieważ użytkownicy coraz częściej mogą instalować gotowe rozszerzenia, " +"zamiast kompilować je samodzielnie." msgid "" -"Some of the solutions for installing `scientific software `__ that are not yet available as pre-built wheel files " -"may also help with obtaining other binary extensions without needing to " -"build them locally." +"Some of the solutions for installing `scientific software `__ that are not yet available as pre-built " +"wheel files may also help with obtaining other binary extensions without " +"needing to build them locally." msgstr "" +"Niektóre rozwiązania dotyczące instalacji `oprogramowania naukowego `__, które nie są jeszcze dostępne w postaci " +"gotowych plików wheel, mogą również pomóc w uzyskaniu innych rozszerzeń " +"binarnych bez konieczności kompilowania ich lokalnie." msgid "" -"`Python Packaging User Guide: Binary Extensions `__" +"`Python Packaging User Guide: Binary Extensions `__" msgstr "" +"` Python Packaging User Guide: Rozszerzenia binarne `__" diff --git a/library/__future__.po b/library/__future__.po index 95b4db5134..bef927c2aa 100644 --- a/library/__future__.po +++ b/library/__future__.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,10 +30,11 @@ msgid "**Source code:** :source:`Lib/__future__.py`" msgstr "**Kod źródłowy:** :source:`Lib/__future__.py`" msgid "" -"Imports of the form ``from __future__ import feature`` are called :ref:" -"`future statements `. These are special-cased by the Python compiler " -"to allow the use of new Python features in modules containing the future " -"statement before the release in which the feature becomes standard." +"Imports of the form ``from __future__ import feature`` are " +"called :ref:`future statements `. These are special-cased by the " +"Python compiler to allow the use of new Python features in modules " +"containing the future statement before the release in which the feature " +"becomes standard." msgstr "" msgid "" @@ -202,15 +203,15 @@ msgstr "" msgid "" "*CompilerFlag* is the (bitfield) flag that should be passed in the fourth " "argument to the built-in function :func:`compile` to enable the feature in " -"dynamically compiled code. This flag is stored in the :attr:`_Feature." -"compiler_flag` attribute on :class:`_Feature` instances." +"dynamically compiled code. This flag is stored in " +"the :attr:`_Feature.compiler_flag` attribute on :class:`_Feature` instances." msgstr "" msgid "" "``from __future__ import annotations`` was previously scheduled to become " "mandatory in Python 3.10, but the change was delayed and ultimately " -"canceled. This feature will eventually be deprecated and removed. See :pep:" -"`649` and :pep:`749`." +"canceled. This feature will eventually be deprecated and removed. " +"See :pep:`649` and :pep:`749`." msgstr "" msgid ":ref:`future`" diff --git a/library/__main__.po b/library/__main__.po index 3b3a860a8c..bca8fbb522 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -42,8 +42,8 @@ msgstr "" msgid "" "Both of these mechanisms are related to Python modules; how users interact " "with them and how they interact with each other. They are explained in " -"detail below. If you're new to Python modules, see the tutorial section :" -"ref:`tut-modules` for an introduction." +"detail below. If you're new to Python modules, see the tutorial " +"section :ref:`tut-modules` for an introduction." msgstr "" msgid "``__name__ == '__main__'``" @@ -118,8 +118,8 @@ msgstr "" "Hello, world!" msgid "" -"the Python module or package passed to the Python interpreter with the :" -"option:`-m` argument:" +"the Python module or package passed to the Python interpreter with " +"the :option:`-m` argument:" msgstr "" msgid "" @@ -252,9 +252,9 @@ msgstr "" msgid "" "Since the call to ``main`` is wrapped in :func:`sys.exit`, the expectation " -"is that your function will return some value acceptable as an input to :func:" -"`sys.exit`; typically, an integer or ``None`` (which is implicitly returned " -"if your function does not have a return statement)." +"is that your function will return some value acceptable as an input " +"to :func:`sys.exit`; typically, an integer or ``None`` (which is implicitly " +"returned if your function does not have a return statement)." msgstr "" msgid "" @@ -268,8 +268,8 @@ msgid "" "In particular, be careful about returning strings from your ``main`` " "function. :func:`sys.exit` will interpret a string argument as a failure " "message, so your program will have an exit code of ``1``, indicating " -"failure, and the string will be written to :data:`sys.stderr`. The ``echo." -"py`` example from earlier exemplifies using the ``sys.exit(main())`` " +"failure, and the string will be written to :data:`sys.stderr`. The " +"``echo.py`` example from earlier exemplifies using the ``sys.exit(main())`` " "convention." msgstr "" @@ -351,8 +351,8 @@ msgstr "" "'asyncio.__main__'" msgid "" -"This won't work for ``__main__.py`` files in the root directory of a ``." -"zip`` file though. Hence, for consistency, a minimal ``__main__.py`` " +"This won't work for ``__main__.py`` files in the root directory of a " +"``.zip`` file though. Hence, for consistency, a minimal ``__main__.py`` " "without a ``__name__`` check is preferred." msgstr "" @@ -483,6 +483,6 @@ msgid "" msgstr "" msgid "" -"The ``__main__`` scope is used in the implementation of :mod:`pdb` and :mod:" -"`rlcompleter`." +"The ``__main__`` scope is used in the implementation of :mod:`pdb` " +"and :mod:`rlcompleter`." msgstr "" diff --git a/library/_thread.po b/library/_thread.po index a44176a3ca..4aa8e01a50 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -47,9 +47,6 @@ msgstr "" msgid "This is now a synonym of the built-in :exc:`RuntimeError`." msgstr "" -msgid "This is the type of lock objects." -msgstr "" - msgid "" "Start a new thread and return its identifier. The thread executes the " "function *function* with the argument list *args* (which must be a tuple). " @@ -60,10 +57,11 @@ msgid "When the function returns, the thread silently exits." msgstr "" msgid "" -"When the function terminates with an unhandled exception, :func:`sys." -"unraisablehook` is called to handle the exception. The *object* attribute of " -"the hook argument is *function*. By default, a stack trace is printed and " -"then the thread exits (but other threads continue to run)." +"When the function terminates with an unhandled " +"exception, :func:`sys.unraisablehook` is called to handle the exception. The " +"*object* attribute of the hook argument is *function*. By default, a stack " +"trace is printed and then the thread exits (but other threads continue to " +"run)." msgstr "" msgid "" @@ -91,8 +89,9 @@ msgid "" msgstr "" msgid "" -"If the given signal isn't handled by Python (it was set to :const:`signal." -"SIG_DFL` or :const:`signal.SIG_IGN`), this function does nothing." +"If the given signal isn't handled by Python (it was set " +"to :const:`signal.SIG_DFL` or :const:`signal.SIG_IGN`), this function does " +"nothing." msgstr "" msgid "The *signum* argument is added to customize the signal number." @@ -140,9 +139,9 @@ msgid "" "*size* argument specifies the stack size to be used for subsequently created " "threads, and must be 0 (use platform or configured default) or a positive " "integer value of at least 32,768 (32 KiB). If *size* is not specified, 0 is " -"used. If changing the thread stack size is unsupported, a :exc:" -"`RuntimeError` is raised. If the specified stack size is invalid, a :exc:" -"`ValueError` is raised and the stack size is unmodified. 32 KiB is " +"used. If changing the thread stack size is unsupported, " +"a :exc:`RuntimeError` is raised. If the specified stack size is invalid, " +"a :exc:`ValueError` is raised and the stack size is unmodified. 32 KiB is " "currently the minimum supported stack size value to guarantee sufficient " "stack space for the interpreter itself. Note that some platforms may have " "particular restrictions on values for the stack size, such as requiring a " @@ -162,6 +161,9 @@ msgid "" "raise an :exc:`OverflowError`." msgstr "" +msgid "This is the type of lock objects." +msgstr "" + msgid "Lock objects have the following methods:" msgstr "" @@ -211,8 +213,8 @@ msgid "" msgstr "" msgid "" -"In addition to these methods, lock objects can also be used via the :keyword:" -"`with` statement, e.g.::" +"In addition to these methods, lock objects can also be used via " +"the :keyword:`with` statement, e.g.::" msgstr "" msgid "" @@ -239,8 +241,9 @@ msgstr "" msgid "" "When the main thread exits, it is system defined whether the other threads " -"survive. On most systems, they are killed without executing :keyword:" -"`try` ... :keyword:`finally` clauses or executing object destructors." +"survive. On most systems, they are killed without " +"executing :keyword:`try` ... :keyword:`finally` clauses or executing object " +"destructors." msgstr "" msgid "light-weight processes" diff --git a/library/abc.po b/library/abc.po index ad26c41c4f..08bca0f240 100644 --- a/library/abc.po +++ b/library/abc.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,16 +32,17 @@ msgstr "**Kod źródłowy:**. :source:`Lib/abc.py`" msgid "" "This module provides the infrastructure for defining :term:`abstract base " "classes ` (ABCs) in Python, as outlined in :pep:`3119`; " -"see the PEP for why this was added to Python. (See also :pep:`3141` and the :" -"mod:`numbers` module regarding a type hierarchy for numbers based on ABCs.)" +"see the PEP for why this was added to Python. (See also :pep:`3141` and " +"the :mod:`numbers` module regarding a type hierarchy for numbers based on " +"ABCs.)" msgstr "" msgid "" "The :mod:`collections` module has some concrete classes that derive from " -"ABCs; these can, of course, be further derived. In addition, the :mod:" -"`collections.abc` submodule has some ABCs that can be used to test whether a " -"class or instance provides a particular interface, for example, if it is :" -"term:`hashable` or if it is a :term:`mapping`." +"ABCs; these can, of course, be further derived. In addition, " +"the :mod:`collections.abc` submodule has some ABCs that can be used to test " +"whether a class or instance provides a particular interface, for example, if " +"it is :term:`hashable` or if it is a :term:`mapping`." msgstr "" msgid "" @@ -99,12 +100,12 @@ msgstr "" "(nawet wbudowane uogólnienia) i niezwiązane abstrakcyjne uogólnienia " "podstawowe jako \"sztuczne podrzędne uogólnienia\" -- te uogólnienia i " "pochodne po nich będą uznawane za podrzędne uogólnienia rejestrowanego " -"uogólnienia podstawowego abstrakcyjnego przez wbudowane zadanie :func:" -"`issubclass`, ale rejestrowanie abstrakcyjnego uogólnienia bazowego nie " -"pokaże się w ich sposobie rozwiązywania sposobów postępowania (w skr. MRO - " -"z ang. - Method Resolution Order) ani też wypełnienia sposobów postępowania " -"określone przez rejestrowanie abstrakcyjnych bazowych uogólnień nie będą " -"wywoływalne (nawet nie przez użycie :func:`super`). [#]_" +"uogólnienia podstawowego abstrakcyjnego przez wbudowane " +"zadanie :func:`issubclass`, ale rejestrowanie abstrakcyjnego uogólnienia " +"bazowego nie pokaże się w ich sposobie rozwiązywania sposobów postępowania " +"(w skr. MRO - z ang. - Method Resolution Order) ani też wypełnienia sposobów " +"postępowania określone przez rejestrowanie abstrakcyjnych bazowych uogólnień " +"nie będą wywoływalne (nawet nie przez użycie :func:`super`). [#]_" msgid "" "Classes created with a metaclass of :class:`!ABCMeta` have the following " @@ -133,8 +134,8 @@ msgid "Returns the registered subclass, to allow usage as a class decorator." msgstr "" msgid "" -"To detect calls to :meth:`!register`, you can use the :func:" -"`get_cache_token` function." +"To detect calls to :meth:`!register`, you can use " +"the :func:`get_cache_token` function." msgstr "" msgid "You can also override this method in an abstract base class:" @@ -149,8 +150,8 @@ msgid "" "Check whether *subclass* is considered a subclass of this ABC. This means " "that you can customize the behavior of :func:`issubclass` further without " "the need to call :meth:`register` on every class you want to consider a " -"subclass of the ABC. (This class method is called from the :meth:`~type." -"__subclasscheck__` method of the ABC.)" +"subclass of the ABC. (This class method is called from " +"the :meth:`~type.__subclasscheck__` method of the ABC.)" msgstr "" msgid "" @@ -197,18 +198,18 @@ msgid "" msgstr "" msgid "" -"The ABC ``MyIterable`` defines the standard iterable method, :meth:`~object." -"__iter__`, as an abstract method. The implementation given here can still " -"be called from subclasses. The :meth:`!get_iterator` method is also part of " -"the ``MyIterable`` abstract base class, but it does not have to be " -"overridden in non-abstract derived classes." +"The ABC ``MyIterable`` defines the standard iterable " +"method, :meth:`~object.__iter__`, as an abstract method. The implementation " +"given here can still be called from subclasses. The :meth:`!get_iterator` " +"method is also part of the ``MyIterable`` abstract base class, but it does " +"not have to be overridden in non-abstract derived classes." msgstr "" msgid "" "The :meth:`__subclasshook__` class method defined here says that any class " "that has an :meth:`~object.__iter__` method in its :attr:`~object.__dict__` " -"(or in that of one of its base classes, accessed via the :attr:`~type." -"__mro__` list) is considered a ``MyIterable`` too." +"(or in that of one of its base classes, accessed via " +"the :attr:`~type.__mro__` list) is considered a ``MyIterable`` too." msgstr "" msgid "" @@ -231,21 +232,21 @@ msgid "" "or is derived from it. A class that has a metaclass derived from :class:`!" "ABCMeta` cannot be instantiated unless all of its abstract methods and " "properties are overridden. The abstract methods can be called using any of " -"the normal 'super' call mechanisms. :func:`!abstractmethod` may be used to " +"the normal 'super' call mechanisms. :deco:`!abstractmethod` may be used to " "declare abstract methods for properties and descriptors." msgstr "" msgid "" "Dynamically adding abstract methods to a class, or attempting to modify the " "abstraction status of a method or class once it is created, are only " -"supported using the :func:`update_abstractmethods` function. The :func:`!" +"supported using the :func:`update_abstractmethods` function. The :deco:`!" "abstractmethod` only affects subclasses derived using regular inheritance; " "\"virtual subclasses\" registered with the ABC's :meth:`~ABCMeta.register` " "method are not affected." msgstr "" msgid "" -"When :func:`!abstractmethod` is applied in combination with other method " +"When :deco:`!abstractmethod` is applied in combination with other method " "descriptors, it should be applied as the innermost decorator, as shown in " "the following usage examples::" msgstr "" @@ -287,7 +288,7 @@ msgid "" "the descriptor must identify itself as abstract using :attr:`!" "__isabstractmethod__`. In general, this attribute should be ``True`` if any " "of the methods used to compose the descriptor are abstract. For example, " -"Python's built-in :class:`property` does the equivalent of::" +"Python's built-in :deco:`property` does the equivalent of::" msgstr "" msgid "" @@ -308,26 +309,26 @@ msgid "" msgstr "" "W przeciwieństwie do abstrakcyjnych sposobów postępowania Javy, te " "abstrakcyjne sposoby postępowania mogą mieć swoje wypełnienie. To " -"wypełnienie może być wzywane przez mechanizm odwołań do zadania :func:" -"`super`, z uogólnienia które przesłania taki sposób postępowania. To może " -"być użyteczne jako punkt końcowy super-wywołania w ramach udogodnienia które " -"używa współpracującego wielokrotnego-dziedziczenia." +"wypełnienie może być wzywane przez mechanizm odwołań do " +"zadania :func:`super`, z uogólnienia które przesłania taki sposób " +"postępowania. To może być użyteczne jako punkt końcowy super-wywołania w " +"ramach udogodnienia które używa współpracującego wielokrotnego-dziedziczenia." msgid "The :mod:`!abc` module also supports the following legacy decorators:" msgstr "" msgid "" -"It is now possible to use :class:`classmethod` with :func:`abstractmethod`, " +"It is now possible to use :deco:`classmethod` with :deco:`abstractmethod`, " "making this decorator redundant." msgstr "" msgid "" -"A subclass of the built-in :func:`classmethod`, indicating an abstract " -"classmethod. Otherwise it is similar to :func:`abstractmethod`." +"A subclass of the built-in :class:`classmethod`, indicating an abstract " +"classmethod. Otherwise it is similar to :deco:`abstractmethod`." msgstr "" msgid "" -"This special case is deprecated, as the :func:`classmethod` decorator is now " +"This special case is deprecated, as the :deco:`classmethod` decorator is now " "correctly identified as abstract when applied to an abstract method::" msgstr "" @@ -340,17 +341,17 @@ msgid "" msgstr "" msgid "" -"It is now possible to use :class:`staticmethod` with :func:`abstractmethod`, " +"It is now possible to use :deco:`staticmethod` with :deco:`abstractmethod`, " "making this decorator redundant." msgstr "" msgid "" -"A subclass of the built-in :func:`staticmethod`, indicating an abstract " -"staticmethod. Otherwise it is similar to :func:`abstractmethod`." +"A subclass of the built-in :class:`staticmethod`, indicating an abstract " +"staticmethod. Otherwise it is similar to :deco:`abstractmethod`." msgstr "" msgid "" -"This special case is deprecated, as the :func:`staticmethod` decorator is " +"This special case is deprecated, as the :deco:`staticmethod` decorator is " "now correctly identified as abstract when applied to an abstract method::" msgstr "" @@ -363,19 +364,19 @@ msgid "" msgstr "" msgid "" -"It is now possible to use :class:`property`, :meth:`property.getter`, :meth:" -"`property.setter` and :meth:`property.deleter` with :func:`abstractmethod`, " -"making this decorator redundant." +"It is now possible to " +"use :deco:`property`, :deco:`property.getter`, :deco:`property.setter` " +"and :deco:`property.deleter` with :deco:`abstractmethod`, making this " +"decorator redundant." msgstr "" msgid "" -"A subclass of the built-in :func:`property`, indicating an abstract property." +"A subclass of the built-in :class:`property`, indicating an abstract " +"property." msgstr "" -"Podrzędne uogólnienie wbudowanego zadania :func:`property` wskazujące " -"abstrakcyjną właściwość." msgid "" -"This special case is deprecated, as the :func:`property` decorator is now " +"This special case is deprecated, as the :deco:`property` decorator is now " "correctly identified as abstract when applied to an abstract method::" msgstr "" diff --git a/library/annotationlib.po b/library/annotationlib.po index bfa2084e22..891e149000 100644 --- a/library/annotationlib.po +++ b/library/annotationlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-21 15:07+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-13 20:58+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,8 +30,9 @@ msgid "**Source code:** :source:`Lib/annotationlib.py`" msgstr "**Kod źródłowy:** :source:`Lib/annotationlib.py`" msgid "" -"The :mod:`!annotationlib` module provides tools for introspecting :term:" -"`annotations ` on modules, classes, and functions." +"The :mod:`!annotationlib` module provides tools for " +"introspecting :term:`annotations ` on modules, classes, and " +"functions." msgstr "" msgid "" @@ -43,8 +44,8 @@ msgid "" msgstr "" msgid "" -"This module supports retrieving annotations in three main formats (see :" -"class:`Format`), each of which works best for different use cases:" +"This module supports retrieving annotations in three main formats " +"(see :class:`Format`), each of which works best for different use cases:" msgstr "" msgid "" @@ -71,9 +72,10 @@ msgid "" "annotations. Given a function, class, or module, it returns an annotations " "dictionary in the requested format. This module also provides functionality " "for working directly with the :term:`annotate function` that is used to " -"evaluate annotations, such as :func:`get_annotate_from_class_namespace` and :" -"func:`call_annotate_function`, as well as the :func:`call_evaluate_function` " -"function for working with :term:`evaluate functions `." +"evaluate annotations, such as :func:`get_annotate_from_class_namespace` " +"and :func:`call_annotate_function`, as well as " +"the :func:`call_evaluate_function` function for working with :term:`evaluate " +"functions `." msgstr "" msgid "" @@ -86,8 +88,8 @@ msgid "" msgstr "" msgid "" -":pep:`749` expanded on various aspects of :pep:`649` and introduced the :mod:" -"`!annotationlib` module." +":pep:`749` expanded on various aspects of :pep:`649` and introduced " +"the :mod:`!annotationlib` module." msgstr "" msgid "" @@ -110,9 +112,9 @@ msgid "" msgstr "" msgid "" -"*Stock semantics* (default in Python 3.0 through 3.13; see :pep:`3107` and :" -"pep:`526`): Annotations are evaluated eagerly, as they are encountered in " -"the source code." +"*Stock semantics* (default in Python 3.0 through 3.13; see :pep:`3107` " +"and :pep:`526`): Annotations are evaluated eagerly, as they are encountered " +"in the source code." msgstr "" msgid "" @@ -122,8 +124,9 @@ msgid "" msgstr "" msgid "" -"*Deferred evaluation* (default in Python 3.14 and newer; see :pep:`649` and :" -"pep:`749`): Annotations are evaluated lazily, only when they are accessed." +"*Deferred evaluation* (default in Python 3.14 and newer; see :pep:`649` " +"and :pep:`749`): Annotations are evaluated lazily, only when they are " +"accessed." msgstr "" msgid "As an example, consider the following program::" @@ -142,9 +145,9 @@ msgid "This will behave as follows:" msgstr "" msgid "" -"Under stock semantics (Python 3.13 and earlier), it will throw a :exc:" -"`NameError` at the line where ``func`` is defined, because ``Cls`` is an " -"undefined name at that point." +"Under stock semantics (Python 3.13 and earlier), it will throw " +"a :exc:`NameError` at the line where ``func`` is defined, because ``Cls`` is " +"an undefined name at that point." msgstr "" msgid "" @@ -193,10 +196,11 @@ msgstr "" msgid "" "Special value used to signal that an annotate function is being evaluated in " "a special environment with fake globals. When passed this value, annotate " -"functions should either return the same value as for the :attr:`Format." -"VALUE` format, or raise :exc:`NotImplementedError` to signal that they do " -"not support execution in this environment. This format is only used " -"internally and should not be passed to the functions in this module." +"functions should either return the same value as for " +"the :attr:`Format.VALUE` format, or raise :exc:`NotImplementedError` to " +"signal that they do not support execution in this environment. This format " +"is only used internally and should not be passed to the functions in this " +"module." msgstr "" msgid "" @@ -226,9 +230,9 @@ msgid "" msgstr "" msgid "" -"A string containing the code that was evaluated to produce the :class:" -"`~ForwardRef`. The string may not be exactly equivalent to the original " -"source." +"A string containing the code that was evaluated to produce " +"the :class:`~ForwardRef`. The string may not be exactly equivalent to the " +"original source." msgstr "" msgid "Evaluate the forward reference, returning its value." @@ -244,8 +248,9 @@ msgid "" "example, if the forward reference object contains the code " "``list[undefined]``, where ``undefined`` is a name that is not defined, " "evaluating it with the :attr:`~Format.FORWARDREF` format will return " -"``list[ForwardRef('undefined')]``. If the *format* argument is :attr:" -"`~Format.STRING`, the method will return :attr:`~ForwardRef.__forward_arg__`." +"``list[ForwardRef('undefined')]``. If the *format* argument " +"is :attr:`~Format.STRING`, the method will " +"return :attr:`~ForwardRef.__forward_arg__`." msgstr "" msgid "" @@ -257,15 +262,15 @@ msgstr "" msgid "" "The *globals*, *locals*, and *type_params* parameters provide a more precise " -"mechanism for influencing the names that are available when the :class:" -"`~ForwardRef` is evaluated. *globals* and *locals* are passed to :func:" -"`eval`, representing the global and local namespaces in which the name is " -"evaluated. The *type_params* parameter is relevant for objects created using " -"the native syntax for :ref:`generic classes ` and :ref:" -"`functions `. It is a tuple of :ref:`type parameters " -"` that are in scope while the forward reference is being " -"evaluated. For example, if evaluating a :class:`~ForwardRef` retrieved from " -"an annotation found in the class namespace of a generic class ``C``, " +"mechanism for influencing the names that are available when " +"the :class:`~ForwardRef` is evaluated. *globals* and *locals* are passed " +"to :func:`eval`, representing the global and local namespaces in which the " +"name is evaluated. The *type_params* parameter is relevant for objects " +"created using the native syntax for :ref:`generic classes ` " +"and :ref:`functions `. It is a tuple of :ref:`type " +"parameters ` that are in scope while the forward reference is " +"being evaluated. For example, if evaluating a :class:`~ForwardRef` retrieved " +"from an annotation found in the class namespace of a generic class ``C``, " "*type_params* should be set to ``C.__type_params__``." msgstr "" @@ -279,9 +284,9 @@ msgid "" msgstr "" msgid "" -"If no *owner*, *globals*, *locals*, or *type_params* are provided and the :" -"class:`~ForwardRef` does not contain information about its origin, empty " -"globals and locals dictionaries are used." +"If no *owner*, *globals*, *locals*, or *type_params* are provided and " +"the :class:`~ForwardRef` does not contain information about its origin, " +"empty globals and locals dictionaries are used." msgstr "" msgid "Functions" @@ -296,8 +301,8 @@ msgid "" msgstr "" msgid "" -"For example, this is used to implement the :attr:`~Format.STRING` for :class:" -"`typing.TypedDict` classes created through the functional syntax:" +"For example, this is used to implement the :attr:`~Format.STRING` format " +"for :class:`typing.TypedDict` classes created through the functional syntax:" msgstr "" msgid "" @@ -315,12 +320,12 @@ msgstr "" msgid "" "This helper function is required because annotate functions generated by the " -"compiler for functions, classes, and modules only support the :attr:`~Format." -"VALUE` format when called directly. To support other formats, this function " -"calls the annotate function in a special environment that allows it to " -"produce annotations in the other formats. This is a useful building block " -"when implementing functionality that needs to partially evaluate annotations " -"while a class is being constructed." +"compiler for functions, classes, and modules only support " +"the :attr:`~Format.VALUE` format when called directly. To support other " +"formats, this function calls the annotate function in a special environment " +"that allows it to produce annotations in the other formats. This is a useful " +"building block when implementing functionality that needs to partially " +"evaluate annotations while a class is being constructed." msgstr "" msgid "" @@ -407,9 +412,9 @@ msgid "Compute the annotations dict for an object." msgstr "" msgid "" -"*obj* may be a callable, class, module, or other object with :attr:`~object." -"__annotate__` or :attr:`~object.__annotations__` attributes. Passing any " -"other object raises :exc:`TypeError`." +"*obj* may be a callable, class, module, or other object " +"with :attr:`~object.__annotate__` or :attr:`~object.__annotations__` " +"attributes. Passing any other object raises :exc:`TypeError`." msgstr "" msgid "" @@ -426,33 +431,34 @@ msgstr "" msgid "" "FORWARDREF: If :attr:`!object.__annotations__` exists and can be evaluated " "successfully, it is used; otherwise, the :attr:`!object.__annotate__` " -"function is called. If it does not exist either, :attr:`!object." -"__annotations__` is tried again and any error from accessing it is re-raised." +"function is called. If it does not exist either, :attr:`!" +"object.__annotations__` is tried again and any error from accessing it is re-" +"raised." msgstr "" msgid "" -"When calling :attr:`!object.__annotate__` it is first called with :attr:" -"`~Format.FORWARDREF`. If this is not implemented, it will then check if :" -"attr:`~Format.VALUE_WITH_FAKE_GLOBALS` is supported and use that in the fake " -"globals environment. If neither of these formats are supported, it will fall " -"back to using :attr:`~Format.VALUE`. If :attr:`~Format.VALUE` fails, the " -"error from this call will be raised." +"When calling :attr:`!object.__annotate__` it is first called " +"with :attr:`~Format.FORWARDREF`. If this is not implemented, it will then " +"check if :attr:`~Format.VALUE_WITH_FAKE_GLOBALS` is supported and use that " +"in the fake globals environment. If neither of these formats are supported, " +"it will fall back to using :attr:`~Format.VALUE`. If :attr:`~Format.VALUE` " +"fails, the error from this call will be raised." msgstr "" msgid "" "STRING: If :attr:`!object.__annotate__` exists, it is called first; " -"otherwise, :attr:`!object.__annotations__` is used and stringified using :" -"func:`annotations_to_string`." +"otherwise, :attr:`!object.__annotations__` is used and stringified " +"using :func:`annotations_to_string`." msgstr "" msgid "" -"When calling :attr:`!object.__annotate__` it is first called with :attr:" -"`~Format.STRING`. If this is not implemented, it will then check if :attr:" -"`~Format.VALUE_WITH_FAKE_GLOBALS` is supported and use that in the fake " -"globals environment. If neither of these formats are supported, it will fall " -"back to using :attr:`~Format.VALUE` with the result converted using :func:" -"`annotations_to_string`. If :attr:`~Format.VALUE` fails, the error from this " -"call will be raised." +"When calling :attr:`!object.__annotate__` it is first called " +"with :attr:`~Format.STRING`. If this is not implemented, it will then check " +"if :attr:`~Format.VALUE_WITH_FAKE_GLOBALS` is supported and use that in the " +"fake globals environment. If neither of these formats are supported, it will " +"fall back to using :attr:`~Format.VALUE` with the result converted " +"using :func:`annotations_to_string`. If :attr:`~Format.VALUE` fails, the " +"error from this call will be raised." msgstr "" msgid "" @@ -495,9 +501,9 @@ msgstr "" msgid "" "If eval_str is true, :func:`eval` is called on values of type :class:`!str`. " -"(Note that :func:`!get_annotations` doesn't catch exceptions; if :func:" -"`eval` raises an exception, it will unwind the stack past the :func:`!" -"get_annotations` call.)" +"(Note that :func:`!get_annotations` doesn't catch exceptions; " +"if :func:`eval` raises an exception, it will unwind the stack past " +"the :func:`!get_annotations` call.)" msgstr "" msgid "" @@ -516,15 +522,16 @@ msgid "If *obj* is a module, *globals* defaults to ``obj.__dict__``." msgstr "" msgid "" -"If *obj* is a class, *globals* defaults to ``sys.modules[obj.__module__]." -"__dict__`` and *locals* defaults to the *obj* class namespace." +"If *obj* is a class, *globals* defaults to " +"``sys.modules[obj.__module__].__dict__`` and *locals* defaults to the *obj* " +"class namespace." msgstr "" msgid "" "If *obj* is a callable, *globals* defaults to :attr:`obj.__globals__ " -"`, although if *obj* is a wrapped function (using :" -"func:`functools.update_wrapper`) or a :class:`functools.partial` object, it " -"is unwrapped until a non-wrapped function is found." +"`, although if *obj* is a wrapped function " +"(using :func:`functools.update_wrapper`) or a :class:`functools.partial` " +"object, it is unwrapped until a non-wrapped function is found." msgstr "" msgid "" @@ -541,9 +548,9 @@ msgid "" msgstr "" msgid "" -"Convert an arbitrary Python value to a format suitable for use by the :attr:" -"`~Format.STRING` format. This calls :func:`repr` for most objects, but has " -"special handling for some objects, such as type objects." +"Convert an arbitrary Python value to a format suitable for use by " +"the :attr:`~Format.STRING` format. This calls :func:`repr` for most objects, " +"but has special handling for some objects, such as type objects." msgstr "" msgid "" @@ -580,8 +587,9 @@ msgid "" msgstr "" msgid "" -"Below is an example of a metaclass that filters out all :class:`typing." -"ClassVar` annotations from the class and puts them in a separate attribute:" +"Below is an example of a metaclass that filters out " +"all :class:`typing.ClassVar` annotations from the class and puts them in a " +"separate attribute:" msgstr "" msgid "" @@ -634,6 +642,106 @@ msgid "" " return typ" msgstr "" +msgid "Creating a custom callable annotate function" +msgstr "" + +msgid "" +"Custom :term:`annotate functions ` may be literal " +"functions like those automatically generated for functions, classes, and " +"modules. Or, they may wish to utilise the encapsulation provided by classes, " +"in which case any :term:`callable` can be used as an :term:`annotate " +"function`." +msgstr "" + +msgid "" +"To provide the :attr:`~Format.VALUE`, :attr:`~Format.STRING`, " +"or :attr:`~Format.FORWARDREF` formats directly, an :term:`annotate function` " +"must provide the following attribute:" +msgstr "" + +msgid "" +"A callable ``__call__`` with signature ``__call__(format, /) -> dict``, that " +"does not raise a :exc:`NotImplementedError` when called with a supported " +"format." +msgstr "" + +msgid "" +"To provide the :attr:`~Format.VALUE_WITH_FAKE_GLOBALS` format, which is used " +"to automatically generate :attr:`~Format.STRING` " +"or :attr:`~Format.FORWARDREF` if they are not supported " +"directly, :term:`annotate functions ` must provide the " +"following attributes:" +msgstr "" + +msgid "" +"A callable ``__call__`` with signature ``__call__(format, /) -> dict``, that " +"does not raise a :exc:`NotImplementedError` when called " +"with :attr:`~Format.VALUE_WITH_FAKE_GLOBALS`." +msgstr "" + +msgid "" +"A :ref:`code object ` ``__code__`` containing the compiled " +"code for the annotate function." +msgstr "" + +msgid "" +"Optional: A tuple of the function's positional defaults ``__kwdefaults__``, " +"if the function represented by ``__code__`` uses any positional defaults." +msgstr "" + +msgid "" +"Optional: A dict of the function's keyword defaults ``__defaults__``, if the " +"function represented by ``__code__`` uses any keyword defaults." +msgstr "" + +msgid "Optional: All other :ref:`function attributes `." +msgstr "" + +msgid "" +"class Annotate:\n" +" called_formats = []\n" +"\n" +" def __call__(self, format=None, /, *, _self=None):\n" +" # When called with fake globals, `_self` will be the\n" +" # actual self value, and `self` will be the format.\n" +" if _self is not None:\n" +" self, format = _self, self\n" +"\n" +" self.called_formats.append(format)\n" +" if format <= 2: # VALUE or VALUE_WITH_FAKE_GLOBALS\n" +" return {\"x\": MyType}\n" +" raise NotImplementedError\n" +"\n" +" __code__ = __call__.__code__\n" +" __defaults__ = (None,)\n" +" __kwdefaults__ = property(lambda self: dict(_self=self))\n" +"\n" +" __globals__ = {}\n" +" __builtins__ = {}\n" +" __closure__ = None" +msgstr "" + +msgid "This can then be called with:" +msgstr "" + +msgid "" +">>> from annotationlib import call_annotate_function, Format\n" +">>> call_annotate_function(Annotate(), format=Format.STRING)\n" +"{'x': 'MyType'}" +msgstr "" + +msgid "Or used as the annotate function for an object:" +msgstr "" + +msgid "" +">>> from annotationlib import get_annotations, Format\n" +">>> class C:\n" +"... pass\n" +">>> C.__annotate__ = Annotate()\n" +">>> get_annotations(Annotate(), format=Format.STRING)\n" +"{'x': 'MyType'}" +msgstr "" + msgid "Limitations of the ``STRING`` format" msgstr "" @@ -659,8 +767,8 @@ msgid "" msgstr "" msgid "" -">>> def f(x: (1).__class__.__base__.__subclasses__()[-1].__init__." -"__builtins__[\"print\"](\"Hello world\")): pass\n" +">>> def f(x: (1).__class__.__base__.__subclasses__()" +"[-1].__init__.__builtins__[\"print\"](\"Hello world\")): pass\n" "...\n" ">>> annotationlib.get_annotations(f, format=annotationlib.Format.STRING)\n" "Hello world\n" @@ -690,8 +798,8 @@ msgid ":class:`ast.UnaryOp`" msgstr ":class:`ast.UnaryOp`" msgid "" -":class:`ast.Invert` (``~``), :class:`ast.UAdd` (``+``), and :class:`ast." -"USub` (``-``) are supported" +":class:`ast.Invert` (``~``), :class:`ast.UAdd` (``+``), " +"and :class:`ast.USub` (``-``) are supported" msgstr "" msgid ":class:`ast.Not` (``not``) is not supported" @@ -807,11 +915,11 @@ msgstr "" msgid "" "The :attr:`~Format.FORWARDREF` format aims to produce real values as much as " -"possible, with anything that cannot be resolved replaced with :class:" -"`ForwardRef` objects. It is affected by broadly the same Limitations as the :" -"attr:`~Format.STRING` format: annotations that perform operations on " -"literals or that use unsupported expression types may raise exceptions when " -"evaluated using the :attr:`~Format.FORWARDREF` format." +"possible, with anything that cannot be resolved replaced " +"with :class:`ForwardRef` objects. It is affected by broadly the same " +"Limitations as the :attr:`~Format.STRING` format: annotations that perform " +"operations on literals or that use unsupported expression types may raise " +"exceptions when evaluated using the :attr:`~Format.FORWARDREF` format." msgstr "" msgid "Below are a few examples of the behavior with unsupported expressions:" @@ -838,14 +946,14 @@ msgstr "" msgid "" "Much of the functionality in this module involves executing code related to " -"annotations, which can then do arbitrary things. For example, :func:" -"`get_annotations` may call an arbitrary :term:`annotate function`, and :meth:" -"`ForwardRef.evaluate` may call :func:`eval` on an arbitrary string. Code " -"contained in an annotation might make arbitrary system calls, enter an " -"infinite loop, or perform any other operation. This is also true for any " -"access of the :attr:`~object.__annotations__` attribute, and for various " -"functions in the :mod:`typing` module that work with annotations, such as :" -"func:`typing.get_type_hints`." +"annotations, which can then do arbitrary things. For " +"example, :func:`get_annotations` may call an arbitrary :term:`annotate " +"function`, and :meth:`ForwardRef.evaluate` may call :func:`eval` on an " +"arbitrary string. Code contained in an annotation might make arbitrary " +"system calls, enter an infinite loop, or perform any other operation. This " +"is also true for any access of the :attr:`~object.__annotations__` " +"attribute, and for various functions in the :mod:`typing` module that work " +"with annotations, such as :func:`typing.get_type_hints`." msgstr "" msgid "" diff --git a/library/archiving.po b/library/archiving.po index 88e663b454..6cf9c4557a 100644 --- a/library/archiving.po +++ b/library/archiving.po @@ -29,6 +29,6 @@ msgstr "" msgid "" "The modules described in this chapter support data compression with the " "zlib, gzip, bzip2 and lzma algorithms, and the creation of ZIP- and tar-" -"format archives. See also :ref:`archiving-operations` provided by the :mod:" -"`shutil` module." +"format archives. See also :ref:`archiving-operations` provided by " +"the :mod:`shutil` module." msgstr "" diff --git a/library/argparse.po b/library/argparse.po index d41e7ac0e3..0840ac1000 100644 --- a/library/argparse.po +++ b/library/argparse.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Rafael Fontenelle , 2025 +# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: Rafael Fontenelle , 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -49,15 +49,15 @@ msgstr "Tutorial" msgid "" "This page contains the API reference information. For a more gentle " -"introduction to Python command-line parsing, have a look at the :ref:" -"`argparse tutorial `." +"introduction to Python command-line parsing, have a look at " +"the :ref:`argparse tutorial `." msgstr "" msgid "" "The :mod:`!argparse` module makes it easy to write user-friendly command-" "line interfaces. The program defines what arguments it requires, and :mod:`!" -"argparse` will figure out how to parse those out of :data:`sys.argv`. The :" -"mod:`!argparse` module also automatically generates help and usage " +"argparse` will figure out how to parse those out of :data:`sys.argv`. " +"The :mod:`!argparse` module also automatically generates help and usage " "messages. The module will also issue errors when users give the program " "invalid arguments." msgstr "" @@ -100,8 +100,8 @@ msgid "" msgstr "" msgid "" -"If you're looking for a guide about how to upgrade :mod:`optparse` code to :" -"mod:`!argparse`, see :ref:`Upgrading Optparse Code `." msgstr "" @@ -198,8 +198,8 @@ msgstr "" msgid "The following sections describe how each of these are used." msgstr "" -msgid "prog" -msgstr "" +msgid "``prog``" +msgstr "``prog``" msgid "" "By default, :class:`ArgumentParser` calculates the name of the program to " @@ -259,7 +259,7 @@ msgid "" "executed, rather than always being ``os.path.basename(sys.argv[0])``." msgstr "" -msgid "usage" +msgid "``usage``" msgstr "" msgid "" @@ -291,14 +291,14 @@ msgstr "" msgid "" "When a custom usage message is specified for the main parser, you may also " -"want to consider passing the ``prog`` argument to :meth:`~ArgumentParser." -"add_subparsers` or the ``prog`` and the ``usage`` arguments to :meth:" -"`~_SubParsersAction.add_parser`, to ensure consistent command prefixes and " -"usage information across subparsers." +"want to consider passing the ``prog`` argument " +"to :meth:`~ArgumentParser.add_subparsers` or the ``prog`` and the ``usage`` " +"arguments to :meth:`~_SubParsersAction.add_parser`, to ensure consistent " +"command prefixes and usage information across subparsers." msgstr "" -msgid "description" -msgstr "" +msgid "``description``" +msgstr "``opis``" msgid "" "Most calls to the :class:`ArgumentParser` constructor will use the " @@ -313,7 +313,7 @@ msgid "" "given space. To change this behavior, see the formatter_class_ argument." msgstr "" -msgid "epilog" +msgid "``epilog``" msgstr "" msgid "" @@ -343,17 +343,17 @@ msgid "" "argument to :class:`ArgumentParser`." msgstr "" -msgid "parents" +msgid "``parents``" msgstr "" msgid "" "Sometimes, several parsers share a common set of arguments. Rather than " "repeating the definitions of these arguments, a single parser with all the " -"shared arguments and passed to ``parents=`` argument to :class:" -"`ArgumentParser` can be used. The ``parents=`` argument takes a list of :" -"class:`ArgumentParser` objects, collects all the positional and optional " -"actions from them, and adds these actions to the :class:`ArgumentParser` " -"object being constructed::" +"shared arguments and passed to ``parents=`` argument " +"to :class:`ArgumentParser` can be used. The ``parents=`` argument takes a " +"list of :class:`ArgumentParser` objects, collects all the positional and " +"optional actions from them, and adds these actions to " +"the :class:`ArgumentParser` object being constructed::" msgstr "" msgid "" @@ -383,8 +383,8 @@ msgid "" "not be reflected in the child." msgstr "" -msgid "formatter_class" -msgstr "formatter_class" +msgid "``formatter_class``" +msgstr "" msgid "" ":class:`ArgumentParser` objects allow the help formatting to be customized " @@ -394,9 +394,9 @@ msgstr "" msgid "" ":class:`RawDescriptionHelpFormatter` and :class:`RawTextHelpFormatter` give " -"more control over how textual descriptions are displayed. By default, :class:" -"`ArgumentParser` objects line-wrap the description_ and epilog_ texts in " -"command-line help messages::" +"more control over how textual descriptions are displayed. By " +"default, :class:`ArgumentParser` objects line-wrap the description_ and " +"epilog_ texts in command-line help messages::" msgstr "" msgid "" @@ -504,7 +504,7 @@ msgid "" " --foo int" msgstr "" -msgid "prefix_chars" +msgid "``prefix_chars``" msgstr "" msgid "" @@ -528,7 +528,7 @@ msgid "" "disallowed." msgstr "" -msgid "fromfile_prefix_chars" +msgid "``fromfile_prefix_chars``" msgstr "" msgid "" @@ -551,18 +551,17 @@ msgid "" msgstr "" msgid "" -"Arguments read from a file must be one per line by default (but see also :" -"meth:`~ArgumentParser.convert_arg_line_to_args`) and are treated as if they " -"were in the same place as the original file referencing argument on the " +"Arguments read from a file must be one per line by default (but see " +"also :meth:`~ArgumentParser.convert_arg_line_to_args`) and are treated as if " +"they were in the same place as the original file referencing argument on the " "command line. So in the example above, the expression ``['-f', 'foo', " "'@args.txt']`` is considered equivalent to the expression ``['-f', 'foo', '-" "f', 'bar']``." msgstr "" msgid "" -"Empty lines are treated as empty strings (``''``), which are allowed as " -"values but not as arguments. Empty lines that are read as arguments will " -"result in an \"unrecognized arguments\" error." +"Each line is treated as a single argument, so an empty line is read as an " +"empty string (``''``)." msgstr "" msgid "" @@ -577,24 +576,25 @@ msgstr "" msgid "" ":class:`ArgumentParser` changed encoding and errors to read arguments files " -"from default (e.g. :func:`locale.getpreferredencoding(False) ` and ``\"strict\"``) to the :term:`filesystem encoding " -"and error handler`. Arguments file should be encoded in UTF-8 instead of " -"ANSI Codepage on Windows." +"from default (e.g. :func:`locale.getpreferredencoding(False) " +"` and ``\"strict\"``) to the :term:`filesystem " +"encoding and error handler`. Arguments file should be encoded in UTF-8 " +"instead of ANSI Codepage on Windows." msgstr "" -msgid "argument_default" -msgstr "argument_default" +msgid "``argument_default``" +msgstr "" msgid "" -"Generally, argument defaults are specified either by passing a default to :" -"meth:`~ArgumentParser.add_argument` or by calling the :meth:`~ArgumentParser." -"set_defaults` methods with a specific set of name-value pairs. Sometimes " -"however, it may be useful to specify a single parser-wide default for " -"arguments. This can be accomplished by passing the ``argument_default=`` " -"keyword argument to :class:`ArgumentParser`. For example, to globally " -"suppress attribute creation on :meth:`~ArgumentParser.parse_args` calls, we " -"supply ``argument_default=SUPPRESS``::" +"Generally, argument defaults are specified either by passing a default " +"to :meth:`~ArgumentParser.add_argument` or by calling " +"the :meth:`~ArgumentParser.set_defaults` methods with a specific set of name-" +"value pairs. Sometimes however, it may be useful to specify a single parser-" +"wide default for arguments. This can be accomplished by passing the " +"``argument_default=`` keyword argument to :class:`ArgumentParser`. For " +"example, to globally suppress attribute creation " +"on :meth:`~ArgumentParser.parse_args` calls, we supply " +"``argument_default=SUPPRESS``::" msgstr "" msgid "" @@ -607,13 +607,13 @@ msgid "" "Namespace()" msgstr "" -msgid "allow_abbrev" +msgid "``allow_abbrev``" msgstr "" msgid "" -"Normally, when you pass an argument list to the :meth:`~ArgumentParser." -"parse_args` method of an :class:`ArgumentParser`, it :ref:`recognizes " -"abbreviations ` of long options." +"Normally, when you pass an argument list to " +"the :meth:`~ArgumentParser.parse_args` method of an :class:`ArgumentParser`, " +"it :ref:`recognizes abbreviations ` of long options." msgstr "" msgid "This feature can be disabled by setting ``allow_abbrev`` to ``False``::" @@ -628,7 +628,7 @@ msgid "" "PROG: error: unrecognized arguments: --foon" msgstr "" -msgid "conflict_handler" +msgid "``conflict_handler``" msgstr "" msgid "" @@ -675,7 +675,7 @@ msgid "" "option string was overridden." msgstr "" -msgid "add_help" +msgid "``add_help``" msgstr "" msgid "" @@ -686,8 +686,8 @@ msgstr "" msgid "" "Occasionally, it may be useful to disable the addition of this help option. " -"This can be achieved by passing ``False`` as the ``add_help=`` argument to :" -"class:`ArgumentParser`::" +"This can be achieved by passing ``False`` as the ``add_help=`` argument " +"to :class:`ArgumentParser`::" msgstr "" msgid "" @@ -716,13 +716,14 @@ msgid "" " +h, ++help show this help message and exit" msgstr "" -msgid "exit_on_error" +msgid "``exit_on_error``" msgstr "" msgid "" -"Normally, when you pass an invalid argument list to the :meth:" -"`~ArgumentParser.parse_args` method of an :class:`ArgumentParser`, it will " -"print a *message* to :data:`sys.stderr` and exit with a status code of 2." +"Normally, when you pass an invalid argument list to " +"the :meth:`~ArgumentParser.parse_args` method of an :class:`ArgumentParser`, " +"it will print a *message* to :data:`sys.stderr` and exit with a status code " +"of 2." msgstr "" msgid "" @@ -744,7 +745,7 @@ msgid "" "Catching an argumentError" msgstr "" -msgid "suggest_on_error" +msgid "``suggest_on_error``" msgstr "" msgid "" @@ -782,7 +783,7 @@ msgid "" ">>> parser.suggest_on_error = True" msgstr "" -msgid "color" +msgid "``color``" msgstr "" msgid "" @@ -864,8 +865,8 @@ msgid "metavar_ - A name for the argument in usage messages." msgstr "" msgid "" -"dest_ - The name of the attribute to be added to the object returned by :" -"meth:`parse_args`." +"dest_ - The name of the attribute to be added to the object returned " +"by :meth:`parse_args`." msgstr "" msgid "deprecated_ - Whether or not use of the argument is deprecated." @@ -874,15 +875,15 @@ msgstr "" msgid "The method returns an :class:`Action` object representing the argument." msgstr "" -msgid "name or flags" +msgid "``name`` or ``flags``" msgstr "" msgid "" "The :meth:`~ArgumentParser.add_argument` method must know whether an " "optional argument, like ``-f`` or ``--foo``, or a positional argument, like " -"a list of filenames, is expected. The first arguments passed to :meth:" -"`~ArgumentParser.add_argument` must therefore be either a series of flags, " -"or a simple argument name." +"a list of filenames, is expected. The first arguments passed " +"to :meth:`~ArgumentParser.add_argument` must therefore be either a series of " +"flags, or a simple argument name." msgstr "" msgid "For example, an optional argument could be created like::" @@ -938,7 +939,7 @@ msgid "" " --foo-bar FOO-BAR" msgstr "" -msgid "action" +msgid "``action``" msgstr "" msgid "" @@ -988,6 +989,11 @@ msgid "" "Namespace(foo=True, bar=False, baz=True)" msgstr "" +msgid "" +"These defaults apply when the options are absent. They can be overridden by " +"default_ or argument_default_." +msgstr "" + msgid "" "``'append'`` - This appends each argument value to a list. It is useful for " "allowing an option to be specified multiple times. If the default value is a " @@ -1053,7 +1059,10 @@ msgstr "" ">>> parser.parse_args(['-vvv'])\n" "Namespace(verbose=3)" -msgid "Note, the *default* will be ``None`` unless explicitly set to *0*." +msgid "" +"Unless explicitly set, the *default* will be ``None``. If the default value " +"is a non-zero number, the count starts from that number rather than from " +"zero." msgstr "" msgid "" @@ -1064,9 +1073,9 @@ msgid "" msgstr "" msgid "" -"``'version'`` - This expects a ``version=`` keyword argument in the :meth:" -"`~ArgumentParser.add_argument` call, and prints version information and " -"exits when invoked::" +"``'version'`` - This expects a ``version=`` keyword argument in " +"the :meth:`~ArgumentParser.add_argument` call, and prints version " +"information and exits when invoked::" msgstr "" msgid "" @@ -1120,7 +1129,7 @@ msgstr "" msgid "For more details, see :class:`Action`." msgstr "" -msgid "nargs" +msgid "``nargs``" msgstr "" msgid "" @@ -1227,7 +1236,7 @@ msgid "" "``'store_const'``) set ``nargs=0``." msgstr "" -msgid "const" +msgid "``const``" msgstr "" msgid "" @@ -1240,10 +1249,11 @@ msgstr "" msgid "" "When :meth:`~ArgumentParser.add_argument` is called with " "``action='store_const'`` or ``action='append_const'``. These actions add " -"the ``const`` value to one of the attributes of the object returned by :meth:" -"`~ArgumentParser.parse_args`. See the action_ description for examples. If " -"``const`` is not provided to :meth:`~ArgumentParser.add_argument`, it will " -"receive a default value of ``None``." +"the ``const`` value to one of the attributes of the object returned " +"by :meth:`~ArgumentParser.parse_args`. See the action_ description for " +"examples. If ``const`` is not provided " +"to :meth:`~ArgumentParser.add_argument`, it will receive a default value of " +"``None``." msgstr "" msgid "" @@ -1260,16 +1270,14 @@ msgid "" "``action='store_const'``." msgstr "" -msgid "default" +msgid "``default``" msgstr "" msgid "" "All optional arguments and some positional arguments may be omitted at the " -"command line. The ``default`` keyword argument of :meth:`~ArgumentParser." -"add_argument`, whose value defaults to ``None``, specifies what value should " -"be used if the command-line argument is not present. For optional arguments, " -"the ``default`` value is used when the option string was not present at the " -"command line::" +"command line. The ``default`` keyword argument " +"of :meth:`~ArgumentParser.add_argument` specifies what value should be used " +"if the command-line argument is not present. For example::" msgstr "" msgid "" @@ -1281,6 +1289,13 @@ msgid "" "Namespace(foo=42)" msgstr "" +msgid "" +"If ``default`` is omitted, :meth:`~ArgumentParser.add_argument` uses a value " +"previously set for the dest_ with :meth:`~ArgumentParser.set_defaults`, or " +"otherwise a non-``None`` argument_default_. If neither is set, the action's " +"own default is used." +msgstr "" + msgid "" "If the target namespace already has an attribute set, the action *default* " "will not overwrite it::" @@ -1300,8 +1315,9 @@ msgstr "" msgid "" "If the ``default`` value is a string, the parser parses the value as if it " "were a command-line argument. In particular, the parser applies any type_ " -"conversion argument, if provided, before setting the attribute on the :class:" -"`Namespace` return value. Otherwise, the parser uses the value as is::" +"conversion argument, if provided, before setting the attribute on " +"the :class:`Namespace` return value. Otherwise, the parser uses the value " +"as is::" msgstr "" msgid "" @@ -1326,6 +1342,12 @@ msgid "" "Namespace(foo=42)" msgstr "" +msgid "" +"Because ``nargs='*'`` gathers any supplied values into a list, an absent " +"positional argument yields an empty list (``[]``). Only a non-``None`` " +"*default* overrides this (so ``default=None`` still gives ``[]``)." +msgstr "" + msgid "" "For required_ arguments, the ``default`` value is ignored. For example, this " "applies to positional arguments with nargs_ values other than ``?`` or " @@ -1346,8 +1368,8 @@ msgid "" "Namespace(foo='1')" msgstr "" -msgid "type" -msgstr "typ" +msgid "``type``" +msgstr "" msgid "" "By default, the parser reads command-line arguments in as simple strings. " @@ -1365,9 +1387,9 @@ msgstr "" msgid "" "The argument to ``type`` can be a callable that accepts a single string or " "the name of a registered type (see :meth:`~ArgumentParser.register`) If the " -"function raises :exc:`ArgumentTypeError`, :exc:`TypeError`, or :exc:" -"`ValueError`, the exception is caught and a nicely formatted error message " -"is displayed. Other exception types are not handled." +"function raises :exc:`ArgumentTypeError`, :exc:`TypeError`, " +"or :exc:`ValueError`, the exception is caught and a nicely formatted error " +"message is displayed. Other exception types are not handled." msgstr "" msgid "Common built-in types and functions can be used as type converters:" @@ -1425,9 +1447,9 @@ msgstr "" msgid "" "For example, JSON or YAML conversions have complex error cases that require " -"better reporting than can be given by the ``type`` keyword. A :exc:`~json." -"JSONDecodeError` would not be well formatted and a :exc:`FileNotFoundError` " -"exception would not be handled at all." +"better reporting than can be given by the ``type`` keyword. " +"A :exc:`~json.JSONDecodeError` would not be well formatted and " +"a :exc:`FileNotFoundError` exception would not be handled at all." msgstr "" msgid "" @@ -1444,7 +1466,7 @@ msgid "" "using the choices_ keyword instead." msgstr "" -msgid "choices" +msgid "``choices``" msgstr "" msgid "" @@ -1495,7 +1517,7 @@ msgid "" "are many choices), just specify an explicit metavar_." msgstr "" -msgid "required" +msgid "``required``" msgstr "" msgid "" @@ -1516,9 +1538,9 @@ msgid "" msgstr "" msgid "" -"As the example shows, if an option is marked as ``required``, :meth:" -"`~ArgumentParser.parse_args` will report an error if that option is not " -"present at the command line." +"As the example shows, if an option is marked as " +"``required``, :meth:`~ArgumentParser.parse_args` will report an error if " +"that option is not present at the command line." msgstr "" msgid "" @@ -1526,8 +1548,8 @@ msgid "" "*options* to be *optional*, and thus they should be avoided when possible." msgstr "" -msgid "help" -msgstr "pomoc" +msgid "``help``" +msgstr "" msgid "" "The ``help`` value is a string containing a brief description of the " @@ -1540,8 +1562,8 @@ msgid "" "The ``help`` strings can include various format specifiers to avoid " "repetition of things like the program name or the argument default_. The " "available specifiers include the program name, ``%(prog)s`` and most keyword " -"arguments to :meth:`~ArgumentParser.add_argument`, e.g. ``%(default)s``, " -"``%(type)s``, etc.::" +"arguments to :meth:`~ArgumentParser.add_argument`, e.g. ``%(default)s``, ``%" +"(type)s``, etc.::" msgstr "" msgid "" @@ -1578,7 +1600,7 @@ msgid "" " -h, --help show this help message and exit" msgstr "" -msgid "metavar" +msgid "``metavar``" msgstr "" msgid "" @@ -1654,16 +1676,16 @@ msgid "" " --foo bar baz" msgstr "" -msgid "dest" +msgid "``dest``" msgstr "" msgid "" "Most :class:`ArgumentParser` actions add some value as an attribute of the " "object returned by :meth:`~ArgumentParser.parse_args`. The name of this " -"attribute is determined by the ``dest`` keyword argument of :meth:" -"`~ArgumentParser.add_argument`. For positional argument actions, ``dest`` " -"is normally supplied as the first argument to :meth:`~ArgumentParser." -"add_argument`::" +"attribute is determined by the ``dest`` keyword argument " +"of :meth:`~ArgumentParser.add_argument`. For positional argument actions, " +"``dest`` is normally supplied as the first argument " +"to :meth:`~ArgumentParser.add_argument`::" msgstr "" msgid "" @@ -1712,7 +1734,15 @@ msgstr "" ">>> parser.parse_args('--foo XXX'.split())\n" "Namespace(bar='XXX')" -msgid "deprecated" +msgid "" +"Multiple arguments may share the same ``dest``. By default, the value from " +"the last such argument given on the command line wins. Use " +"``action='append'`` to collect values from all of them into a list instead. " +"For conflicting *option strings* rather than ``dest`` names, see " +"conflict_handler_." +msgstr "" + +msgid "``deprecated``" msgstr "" msgid "" @@ -1742,16 +1772,16 @@ msgstr "" msgid "" ":class:`!Action` classes implement the Action API, a callable which returns " "a callable which processes arguments from the command-line. Any object which " -"follows this API may be passed as the ``action`` parameter to :meth:" -"`~ArgumentParser.add_argument`." +"follows this API may be passed as the ``action`` parameter " +"to :meth:`~ArgumentParser.add_argument`." msgstr "" msgid "" ":class:`!Action` objects are used by an :class:`ArgumentParser` to represent " "the information needed to parse a single argument from one or more strings " "from the command line. The :class:`!Action` class must accept the two " -"positional arguments plus any keyword arguments passed to :meth:" -"`ArgumentParser.add_argument` except for the ``action`` itself." +"positional arguments plus any keyword arguments passed " +"to :meth:`ArgumentParser.add_argument` except for the ``action`` itself." msgstr "" msgid "" @@ -1772,15 +1802,15 @@ msgid "" msgstr "" msgid "" -"*namespace* - The :class:`Namespace` object that will be returned by :meth:" -"`~ArgumentParser.parse_args`. Most actions add an attribute to this object " -"using :func:`setattr`." +"*namespace* - The :class:`Namespace` object that will be returned " +"by :meth:`~ArgumentParser.parse_args`. Most actions add an attribute to " +"this object using :func:`setattr`." msgstr "" msgid "" "*values* - The associated command-line arguments, with any type conversions " -"applied. Type conversions are specified with the type_ keyword argument to :" -"meth:`~ArgumentParser.add_argument`." +"applied. Type conversions are specified with the type_ keyword argument " +"to :meth:`~ArgumentParser.add_argument`." msgstr "" msgid "" @@ -1837,13 +1867,13 @@ msgid "" msgstr "" msgid "" -"args_ - List of strings to parse. The default is taken from :data:`sys." -"argv`." +"args_ - List of strings to parse. The default is taken " +"from :data:`sys.argv`." msgstr "" msgid "" -"namespace_ - An object to take the attributes. The default is a new empty :" -"class:`Namespace` object." +"namespace_ - An object to take the attributes. The default is a new " +"empty :class:`Namespace` object." msgstr "" msgid "Option value syntax" @@ -1927,12 +1957,12 @@ msgid "" ">>> # invalid option\n" ">>> parser.parse_args(['--bar'])\n" "usage: PROG [-h] [--foo FOO] [bar]\n" -"PROG: error: no such option: --bar\n" +"PROG: error: unrecognized arguments: --bar\n" "\n" ">>> # wrong number of arguments\n" ">>> parser.parse_args(['spam', 'badger'])\n" "usage: PROG [-h] [--foo FOO] [bar]\n" -"PROG: error: extra arguments found: badger" +"PROG: error: unrecognized arguments: badger" msgstr "" msgid "Arguments containing ``-``" @@ -1973,7 +2003,7 @@ msgid "" ">>> # negative number options present, so -2 is an option\n" ">>> parser.parse_args(['-2'])\n" "usage: PROG [-h] [-1 ONE] [foo]\n" -"PROG: error: no such option: -2\n" +"PROG: error: unrecognized arguments: -2\n" "\n" ">>> # negative number options present, so both -1s are options\n" ">>> parser.parse_args(['-1', '-1'])\n" @@ -2000,6 +2030,12 @@ msgid "" "ambiguous-arguments>` for more details." msgstr "" +msgid "" +"Negative-number matching was expanded to include numbers in scientific " +"notation (``-2.5e-6``), numbers containing underscores (``-1_234.5``), and " +"complex numbers (``-1.2e-3j``)." +msgstr "" + msgid "Argument abbreviations (prefix matching)" msgstr "" @@ -2102,13 +2138,14 @@ msgid "" "example, the ``svn`` program can invoke subcommands like ``svn checkout``, " "``svn update``, and ``svn commit``. Splitting up functionality this way can " "be a particularly good idea when a program performs several different " -"functions which require different kinds of command-line arguments. :class:" -"`ArgumentParser` supports the creation of such subcommands with the :meth:`!" -"add_subparsers` method. The :meth:`!add_subparsers` method is normally " -"called with no arguments and returns a special action object. This object " -"has a single method, :meth:`~_SubParsersAction.add_parser`, which takes a " -"command name and any :class:`!ArgumentParser` constructor arguments, and " -"returns an :class:`!ArgumentParser` object that can be modified as usual." +"functions which require different kinds of command-line " +"arguments. :class:`ArgumentParser` supports the creation of such subcommands " +"with the :meth:`!add_subparsers` method. The :meth:`!add_subparsers` method " +"is normally called with no arguments and returns a special action object. " +"This object has a single method, :meth:`~_SubParsersAction.add_parser`, " +"which takes a command name and any :class:`!ArgumentParser` constructor " +"arguments, and returns an :class:`!ArgumentParser` object that can be " +"modified as usual." msgstr "" msgid "Description of parameters:" @@ -2193,6 +2230,13 @@ msgid "" "``baz`` attributes are present." msgstr "" +msgid "" +"If a subparser defines an argument with the same ``dest`` as the parent " +"parser, the two share a single namespace attribute, so the parent's value " +"won't be retained. Users should give them distinct ``dest`` values to keep " +"both." +msgstr "" + msgid "" "Similarly, when a help message is requested from a subparser, only the help " "for that particular parser will be printed. The help message will not " @@ -2351,10 +2395,10 @@ msgstr "" msgid "" "The :class:`FileType` factory creates objects that can be passed to the type " -"argument of :meth:`ArgumentParser.add_argument`. Arguments that have :class:" -"`FileType` objects as their type will open command-line arguments as files " -"with the requested modes, buffer sizes, encodings and error handling (see " -"the :func:`open` function for more details)::" +"argument of :meth:`ArgumentParser.add_argument`. Arguments that " +"have :class:`FileType` objects as their type will open command-line " +"arguments as files with the requested modes, buffer sizes, encodings and " +"error handling (see the :func:`open` function for more details)::" msgstr "" msgid "" @@ -2421,12 +2465,12 @@ msgstr "" msgid "" "The :meth:`add_argument_group` method returns an argument group object which " -"has an :meth:`~ArgumentParser.add_argument` method just like a regular :" -"class:`ArgumentParser`. When an argument is added to the group, the parser " -"treats it just like a normal argument, but displays the argument in a " -"separate group for help messages. The :meth:`!add_argument_group` method " -"accepts *title* and *description* arguments which can be used to customize " -"this display::" +"has an :meth:`~ArgumentParser.add_argument` method just like a " +"regular :class:`ArgumentParser`. When an argument is added to the group, " +"the parser treats it just like a normal argument, but displays the argument " +"in a separate group for help messages. The :meth:`!add_argument_group` " +"method accepts *title* and *description* arguments which can be used to " +"customize this display::" msgstr "" msgid "" @@ -2452,9 +2496,9 @@ msgstr "" msgid "" "The optional, keyword-only parameters argument_default_ and " "conflict_handler_ allow for finer-grained control of the behavior of the " -"argument group. These parameters have the same meaning as in the :class:" -"`ArgumentParser` constructor, but apply specifically to the argument group " -"rather than the entire parser." +"argument group. These parameters have the same meaning as in " +"the :class:`ArgumentParser` constructor, but apply specifically to the " +"argument group rather than the entire parser." msgstr "" msgid "" @@ -2517,9 +2561,10 @@ msgstr "" msgid "" "Note that currently mutually exclusive argument groups do not support the " -"*title* and *description* arguments of :meth:`~ArgumentParser." -"add_argument_group`. However, a mutually exclusive group can be added to an " -"argument group that has a title and description. For example::" +"*title* and *description* arguments " +"of :meth:`~ArgumentParser.add_argument_group`. However, a mutually exclusive " +"group can be added to an argument group that has a title and description. " +"For example::" msgstr "" msgid "" @@ -2552,9 +2597,9 @@ msgid "Parser defaults" msgstr "" msgid "" -"Most of the time, the attributes of the object returned by :meth:" -"`parse_args` will be fully determined by inspecting the command-line " -"arguments and the argument actions. :meth:`set_defaults` allows some " +"Most of the time, the attributes of the object returned " +"by :meth:`parse_args` will be fully determined by inspecting the command-" +"line arguments and the argument actions. :meth:`set_defaults` allows some " "additional attributes that are determined without any inspection of the " "command line to be added::" msgstr "" @@ -2568,10 +2613,10 @@ msgid "" msgstr "" msgid "" -"Note that defaults can be set at both the parser level using :meth:" -"`set_defaults` and at the argument level using :meth:`add_argument`. If both " -"are called for the same argument, the last default set for an argument is " -"used::" +"Note that defaults can be set at both the parser level " +"using :meth:`set_defaults` and at the argument level " +"using :meth:`add_argument`. If both are called for the same argument, the " +"last default set for an argument is used::" msgstr "" msgid "" @@ -2594,8 +2639,9 @@ msgid "" msgstr "" msgid "" -"Get the default value for a namespace attribute, as set by either :meth:" -"`~ArgumentParser.add_argument` or by :meth:`~ArgumentParser.set_defaults`::" +"Get the default value for a namespace attribute, as set by " +"either :meth:`~ArgumentParser.add_argument` or " +"by :meth:`~ArgumentParser.set_defaults`::" msgstr "" msgid "" @@ -2636,8 +2682,8 @@ msgid "" msgstr "" msgid "" -"Return a string containing a brief description of how the :class:" -"`ArgumentParser` should be invoked on the command line." +"Return a string containing a brief description of how " +"the :class:`ArgumentParser` should be invoked on the command line." msgstr "" msgid "" @@ -2671,10 +2717,10 @@ msgid "" msgstr "" msgid "" -":ref:`Prefix matching ` rules apply to :meth:" -"`~ArgumentParser.parse_known_args`. The parser may consume an option even if " -"it's just a prefix of one of its known options, instead of leaving it in the " -"remaining arguments list." +":ref:`Prefix matching ` rules apply " +"to :meth:`~ArgumentParser.parse_known_args`. The parser may consume an " +"option even if it's just a prefix of one of its known options, instead of " +"leaving it in the remaining arguments list." msgstr "" msgid "Customizing file parsing" @@ -2704,6 +2750,11 @@ msgid "" " return arg_line.split()" msgstr "" +msgid "" +"Note that with this override an argument can no longer contain spaces, since " +"each space-separated word becomes a separate argument." +msgstr "" + msgid "Exiting methods" msgstr "" @@ -2722,8 +2773,8 @@ msgid "" msgstr "" msgid "" -"This method prints a usage message, including the *message*, to :data:`sys." -"stderr` and terminates the program with a status code of 2." +"This method prints a usage message, including the *message*, " +"to :data:`sys.stderr` and terminates the program with a status code of 2." msgstr "" msgid "Intermixed parsing" @@ -2744,10 +2795,11 @@ msgid "" msgstr "" msgid "" -"The following example shows the difference between :meth:`~ArgumentParser." -"parse_known_args` and :meth:`~ArgumentParser.parse_intermixed_args`: the " -"former returns ``['2', '3']`` as unparsed arguments, while the latter " -"collects all the positionals into ``rest``. ::" +"The following example shows the difference " +"between :meth:`~ArgumentParser.parse_known_args` " +"and :meth:`~ArgumentParser.parse_intermixed_args`: the former returns " +"``['2', '3']`` as unparsed arguments, while the latter collects all the " +"positionals into ``rest``. ::" msgstr "" msgid "" diff --git a/library/array.po b/library/array.po index 5227032533..c2a5055c6d 100644 --- a/library/array.po +++ b/library/array.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -176,8 +176,9 @@ msgstr "" msgid "" "The :ref:`ctypes ` and :ref:`struct ` modules, as well as third-party modules like `numpy `__, use similar -- but slightly different -- type codes." +"numpy.org/doc/stable/reference/" +"arrays.interface.html#object.__array_interface__>`__, use similar -- but " +"slightly different -- type codes." msgstr "" msgid "" @@ -197,9 +198,9 @@ msgstr "Moduł definiuje następujący typ:" msgid "" "A new array whose items are restricted by *typecode*, and initialized from " -"the optional *initializer* value, which must be a :class:`bytes` or :class:" -"`bytearray` object, a Unicode string, or iterable over elements of the " -"appropriate type." +"the optional *initializer* value, which must be a :class:`bytes` " +"or :class:`bytearray` object, a Unicode string, or iterable over elements of " +"the appropriate type." msgstr "" msgid "" @@ -211,12 +212,16 @@ msgid "" msgstr "" msgid "" -"Array objects support the ordinary :ref:`mutable ` :term:" -"`sequence` operations of indexing, slicing, concatenation, and " -"multiplication. When using slice assignment, the assigned value must be an " -"array object with the same type code; in all other cases, :exc:`TypeError` " -"is raised. Array objects also implement the buffer interface, and may be " -"used wherever :term:`bytes-like objects ` are supported." +"Array objects support the ordinary :ref:`mutable ` :term:`sequence` operations of indexing, slicing, concatenation, " +"and multiplication. When using slice assignment, the assigned value must be " +"an array object with the same type code; in all other " +"cases, :exc:`TypeError` is raised. Array objects also implement the buffer " +"interface, and may be used wherever :term:`bytes-like objects ` are supported." +msgstr "" + +msgid "Arrays are :ref:`generic ` over the type of their contents." msgstr "" msgid "" @@ -262,9 +267,9 @@ msgstr "" msgid "" "\"Byteswap\" all items of the array. This is only supported for values " -"which are 1, 2, 4, or 8 bytes in size; for other types of values, :exc:" -"`RuntimeError` is raised. It is useful when reading data from a file " -"written on a machine with a different byte order." +"which are 1, 2, 4, or 8 bytes in size; for other types of " +"values, :exc:`RuntimeError` is raised. It is useful when reading data from " +"a file written on a machine with a different byte order." msgstr "" "Zmienia kolejność bajtów wszystkich elementów tablicy. Wspierane tylko dla " "wartości których rozmiar to 1, 2, 4, lub 8 bajtów; dla innych typów wartości " @@ -276,9 +281,10 @@ msgstr "" msgid "" "Append items from *iterable* to the end of the array. If *iterable* is " -"another array, it must have *exactly* the same type code; if not, :exc:" -"`TypeError` will be raised. If *iterable* is not an array, it must be " -"iterable and its elements must be the right type to be appended to the array." +"another array, it must have *exactly* the same type code; if " +"not, :exc:`TypeError` will be raised. If *iterable* is not an array, it " +"must be iterable and its elements must be the right type to be appended to " +"the array." msgstr "" "Przyklej elementy z przedmiotu *iterowalnego* na koniec tablicy. Jeśli " "*iterowalny* jest kolejną tablicą, musi mieć *dokładnie* ten sam typ kodu; " @@ -288,8 +294,8 @@ msgstr "" msgid "" "Appends items from the :term:`bytes-like object`, interpreting its content " -"as an array of machine values (as if it had been read from a file using the :" -"meth:`fromfile` method)." +"as an array of machine values (as if it had been read from a file using " +"the :meth:`fromfile` method)." msgstr "" msgid ":meth:`!fromstring` is renamed to :meth:`frombytes` for clarity." @@ -297,14 +303,14 @@ msgstr "" msgid "" "Read *n* items (as machine values) from the :term:`file object` *f* and " -"append them to the end of the array. If less than *n* items are available, :" -"exc:`EOFError` is raised, but the items that were available are still " -"inserted into the array." +"append them to the end of the array. If less than *n* items are " +"available, :exc:`EOFError` is raised, but the items that were available are " +"still inserted into the array." msgstr "" msgid "" -"Append items from the list. This is equivalent to ``for x in list: a." -"append(x)`` except that if there is a type error, the array is unchanged." +"Append items from the list. This is equivalent to ``for x in list: " +"a.append(x)`` except that if there is a type error, the array is unchanged." msgstr "" "Doklej elementy z listy. To jest równoważne z ``for x in list: a.append(x)`` " "z wyjątkiem tego, że jeśli wystąpi błąd typu, tablica pozostanie " @@ -320,8 +326,8 @@ msgstr "" msgid "" "Return the smallest *i* such that *i* is the index of the first occurrence " "of *value* in the array. The optional arguments *start* and *stop* can be " -"specified to search for *value* within a subsection of the array. Raise :" -"exc:`ValueError` if *value* is not found." +"specified to search for *value* within a subsection of the array. " +"Raise :exc:`ValueError` if *value* is not found." msgstr "" msgid "Added optional *start* and *stop* parameters." @@ -367,8 +373,9 @@ msgstr "Zamień tabelę na zwykłą listę o tych samych elementach." msgid "" "Convert the array to a Unicode string. The array must have a type ``'u'`` " -"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use ``array.tobytes()." -"decode(enc)`` to obtain a Unicode string from an array of some other type." +"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use " +"``array.tobytes().decode(enc)`` to obtain a Unicode string from an array of " +"some other type." msgstr "" msgid "" diff --git a/library/ast.po b/library/ast.po index 48ba3380b7..c613360973 100644 --- a/library/ast.po +++ b/library/ast.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -37,12 +37,12 @@ msgid "" msgstr "" msgid "" -"An abstract syntax tree can be generated by passing :data:`ast." -"PyCF_ONLY_AST` as a flag to the :func:`compile` built-in function, or using " -"the :func:`parse` helper provided in this module. The result will be a tree " -"of objects whose classes all inherit from :class:`ast.AST`. An abstract " -"syntax tree can be compiled into a Python code object using the built-in :" -"func:`compile` function." +"An abstract syntax tree can be generated by " +"passing :data:`ast.PyCF_ONLY_AST` as a flag to the :func:`compile` built-in " +"function, or using the :func:`parse` helper provided in this module. The " +"result will be a tree of objects whose classes all inherit " +"from :class:`ast.AST`. An abstract syntax tree can be compiled into a " +"Python code object using the built-in :func:`compile` function." msgstr "" msgid "Abstract grammar" @@ -232,9 +232,9 @@ msgstr "" msgid "" "This is the base of all AST node classes. The actual node classes are " -"derived from the :file:`Parser/Python.asdl` file, which is reproduced :ref:" -"`above `. They are defined in the :mod:`!_ast` C module " -"and re-exported in :mod:`!ast`." +"derived from the :file:`Parser/Python.asdl` file, which is " +"reproduced :ref:`above `. They are defined in the :mod:`!" +"_ast` C module and re-exported in :mod:`!ast`." msgstr "" msgid "" @@ -281,14 +281,14 @@ msgstr "" "| None}" msgid "" -"Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses have :attr:" -"`lineno`, :attr:`col_offset`, :attr:`end_lineno`, and :attr:`end_col_offset` " -"attributes. The :attr:`lineno` and :attr:`end_lineno` are the first and " -"last line numbers of source text span (1-indexed so the first line is line " -"1) and the :attr:`col_offset` and :attr:`end_col_offset` are the " -"corresponding UTF-8 byte offsets of the first and last tokens that generated " -"the node. The UTF-8 offset is recorded because the parser uses UTF-8 " -"internally." +"Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses " +"have :attr:`lineno`, :attr:`col_offset`, :attr:`end_lineno`, " +"and :attr:`end_col_offset` attributes. The :attr:`lineno` " +"and :attr:`end_lineno` are the first and last line numbers of source text " +"span (1-indexed so the first line is line 1) and the :attr:`col_offset` " +"and :attr:`end_col_offset` are the corresponding UTF-8 byte offsets of the " +"first and last tokens that generated the node. The UTF-8 offset is recorded " +"because the parser uses UTF-8 internally." msgstr "" msgid "" @@ -326,8 +326,8 @@ msgid "" "If a field that is optional in the grammar is omitted from the constructor, " "it defaults to ``None``. If a list field is omitted, it defaults to the " "empty list. If a field of type :class:`!ast.expr_context` is omitted, it " -"defaults to :class:`Load() `. If any other field is omitted, a :" -"exc:`DeprecationWarning` is raised and the AST node will not have this " +"defaults to :class:`Load() `. If any other field is omitted, " +"a :exc:`DeprecationWarning` is raised and the AST node will not have this " "field. In Python 3.15, this condition will raise an error." msgstr "" @@ -342,9 +342,9 @@ msgstr "" msgid "" "AST node constructors were changed to provide sensible defaults for omitted " "fields: optional fields now default to ``None``, list fields default to an " -"empty list, and fields of type :class:`!ast.expr_context` default to :class:" -"`Load() `. Previously, omitted attributes would not exist on " -"constructed nodes (accessing them raised :exc:`AttributeError`)." +"empty list, and fields of type :class:`!ast.expr_context` default " +"to :class:`Load() `. Previously, omitted attributes would not " +"exist on constructed nodes (accessing them raised :exc:`AttributeError`)." msgstr "" msgid "" @@ -353,11 +353,11 @@ msgid "" msgstr "" msgid "" -"Previous versions of Python provided the AST classes :class:`!ast.Num`, :" -"class:`!ast.Str`, :class:`!ast.Bytes`, :class:`!ast.NameConstant` and :class:" -"`!ast.Ellipsis`, which were deprecated in Python 3.8. These classes were " -"removed in Python 3.14, and their functionality has been replaced with :" -"class:`ast.Constant`." +"Previous versions of Python provided the AST classes :class:`!" +"ast.Num`, :class:`!ast.Str`, :class:`!ast.Bytes`, :class:`!ast.NameConstant` " +"and :class:`!ast.Ellipsis`, which were deprecated in Python 3.8. These " +"classes were removed in Python 3.14, and their functionality has been " +"replaced with :class:`ast.Constant`." msgstr "" msgid "" @@ -376,8 +376,9 @@ msgstr "" msgid "" "The descriptions of the specific node classes displayed here were initially " -"adapted from the fantastic `Green Tree Snakes `__ project and all its contributors." +"adapted from the fantastic `Green Tree Snakes `__ project and all its " +"contributors." msgstr "" msgid "Root nodes" @@ -495,9 +496,9 @@ msgstr "" msgid "" "A constant value. The ``value`` attribute of the ``Constant`` literal " "contains the Python object it represents. The values represented can be " -"instances of :class:`str`, :class:`bytes`, :class:`int`, :class:`float`, :" -"class:`complex`, and :class:`bool`, and the constants :data:`None` and :data:" -"`Ellipsis`." +"instances " +"of :class:`str`, :class:`bytes`, :class:`int`, :class:`float`, :class:`complex`, " +"and :class:`bool`, and the constants :data:`None` and :data:`Ellipsis`." msgstr "" msgid "" @@ -548,8 +549,8 @@ msgid "" msgstr "" msgid "" -"An f-string, comprising a series of :class:`FormattedValue` and :class:" -"`Constant` nodes." +"An f-string, comprising a series of :class:`FormattedValue` " +"and :class:`Constant` nodes." msgstr "" msgid "" @@ -575,9 +576,9 @@ msgid "" msgstr "" msgid "" -"Node representing a template string literal, comprising a series of :class:" -"`Interpolation` and :class:`Constant` nodes. These nodes may be any order, " -"and do not need to be interleaved." +"Node representing a template string literal, comprising a series " +"of :class:`Interpolation` and :class:`Constant` nodes. These nodes may be " +"any order, and do not need to be interleaved." msgstr "" msgid "" @@ -748,9 +749,9 @@ msgid "" msgstr "" msgid "" -"A ``*var`` variable reference. ``value`` holds the variable, typically a :" -"class:`Name` node. This type must be used when building a :class:`Call` node " -"with ``*args``." +"A ``*var`` variable reference. ``value`` holds the variable, typically " +"a :class:`Name` node. This type must be used when building a :class:`Call` " +"node with ``*args``." msgstr "" msgid "" @@ -775,9 +776,9 @@ msgstr "" msgid "" "When an expression, such as a function call, appears as a statement by " "itself with its return value not used or stored, it is wrapped in this " -"container. ``value`` holds one of the other nodes in this section, a :class:" -"`Constant`, a :class:`Name`, a :class:`Lambda`, a :class:`Yield` or :class:" -"`YieldFrom` node." +"container. ``value`` holds one of the other nodes in this section, " +"a :class:`Constant`, a :class:`Name`, a :class:`Lambda`, a :class:`Yield` " +"or :class:`YieldFrom` node." msgstr "" msgid "" @@ -889,8 +890,8 @@ msgid "Comparison operator tokens." msgstr "" msgid "" -"A function call. ``func`` is the function, which will often be a :class:" -"`Name` or :class:`Attribute` object. Of the arguments:" +"A function call. ``func`` is the function, which will often be " +"a :class:`Name` or :class:`Attribute` object. Of the arguments:" msgstr "" msgid "``args`` holds a list of the arguments passed by position." @@ -945,10 +946,10 @@ msgid "" msgstr "" msgid "" -"Attribute access, e.g. ``d.keys``. ``value`` is a node, typically a :class:" -"`Name`. ``attr`` is a bare string giving the name of the attribute, and " -"``ctx`` is :class:`Load`, :class:`Store` or :class:`Del` according to how " -"the attribute is acted on." +"Attribute access, e.g. ``d.keys``. ``value`` is a node, typically " +"a :class:`Name`. ``attr`` is a bare string giving the name of the attribute, " +"and ``ctx`` is :class:`Load`, :class:`Store` or :class:`Del` according to " +"how the attribute is acted on." msgstr "" msgid "" @@ -968,9 +969,9 @@ msgstr "" msgid "" "A named expression. This AST node is produced by the assignment expressions " -"operator (also known as the walrus operator). As opposed to the :class:" -"`Assign` node in which the first argument can be multiple nodes, in this " -"case both ``target`` and ``value`` must be single nodes." +"operator (also known as the walrus operator). As opposed to " +"the :class:`Assign` node in which the first argument can be multiple nodes, " +"in this case both ``target`` and ``value`` must be single nodes." msgstr "" msgid "" @@ -991,9 +992,10 @@ msgstr "" msgid "" "A subscript, such as ``l[1]``. ``value`` is the subscripted object (usually " -"sequence or mapping). ``slice`` is an index, slice or key. It can be a :" -"class:`Tuple` and contain a :class:`Slice`. ``ctx`` is :class:`Load`, :class:" -"`Store` or :class:`Del` according to the action performed with the subscript." +"sequence or mapping). ``slice`` is an index, slice or key. It can be " +"a :class:`Tuple` and contain a :class:`Slice`. ``ctx`` " +"is :class:`Load`, :class:`Store` or :class:`Del` according to the action " +"performed with the subscript." msgstr "" msgid "" @@ -1207,16 +1209,16 @@ msgstr "" msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " "a :class:`Name`, an :class:`Attribute` or a :class:`Subscript`. " -"``annotation`` is the annotation, such as a :class:`Constant` or :class:" -"`Name` node. ``value`` is a single optional node." +"``annotation`` is the annotation, such as a :class:`Constant` " +"or :class:`Name` node. ``value`` is a single optional node." msgstr "" msgid "" "``simple`` is always either 0 (indicating a \"complex\" target) or 1 " -"(indicating a \"simple\" target). A \"simple\" target consists solely of a :" -"class:`Name` node that does not appear between parentheses; all other " -"targets are considered complex. Only simple targets appear in the :attr:" -"`~object.__annotations__` dictionary of modules and classes." +"(indicating a \"simple\" target). A \"simple\" target consists solely of " +"a :class:`Name` node that does not appear between parentheses; all other " +"targets are considered complex. Only simple targets appear in " +"the :attr:`~object.__annotations__` dictionary of modules and classes." msgstr "" msgid "" @@ -1333,8 +1335,8 @@ msgstr "" " msg=Name(id='y', ctx=Load()))])" msgid "" -"Represents a ``del`` statement. ``targets`` is a list of nodes, such as :" -"class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." +"Represents a ``del`` statement. ``targets`` is a list of nodes, such " +"as :class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." msgstr "" msgid "" @@ -1364,9 +1366,9 @@ msgstr "" msgid "" "A :ref:`type alias ` created through the :keyword:`type` " -"statement. ``name`` is the name of the alias, ``type_params`` is a list of :" -"ref:`type parameters `, and ``value`` is the value of the " -"type alias." +"statement. ``name`` is the name of the alias, ``type_params`` is a list " +"of :ref:`type parameters `, and ``value`` is the value of " +"the type alias." msgstr "" msgid "" @@ -1460,8 +1462,8 @@ msgid "" msgstr "" msgid "" -"An ``if`` statement. ``test`` holds a single node, such as a :class:" -"`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." +"An ``if`` statement. ``test`` holds a single node, such as " +"a :class:`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." msgstr "" msgid "" @@ -1499,9 +1501,9 @@ msgstr "" msgid "" "A ``for`` loop. ``target`` holds the variable(s) the loop assigns to, as a " -"single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` or :" -"class:`Subscript` node. ``iter`` holds the item to be looped over, again as " -"a single node. ``body`` and ``orelse`` contain lists of nodes to execute. " +"single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` " +"or :class:`Subscript` node. ``iter`` holds the item to be looped over, again " +"as a single node. ``body`` and ``orelse`` contain lists of nodes to execute. " "Those in ``orelse`` are executed if the loop finishes normally, rather than " "via a ``break`` statement." msgstr "" @@ -1628,7 +1630,7 @@ msgstr "" msgid "" "``try`` blocks which are followed by ``except*`` clauses. The attributes are " "the same as for :class:`Try` but the :class:`ExceptHandler` nodes in " -"``handlers`` are interpreted as ``except*`` blocks rather then ``except``." +"``handlers`` are interpreted as ``except*`` blocks rather than ``except``." msgstr "" msgid "" @@ -1690,9 +1692,9 @@ msgstr "" msgid "" "A single context manager in a ``with`` block. ``context_expr`` is the " -"context manager, often a :class:`Call` node. ``optional_vars`` is a :class:" -"`Name`, :class:`Tuple` or :class:`List` for the ``as foo`` part, or ``None`` " -"if that isn't used." +"context manager, often a :class:`Call` node. ``optional_vars`` is " +"a :class:`Name`, :class:`Tuple` or :class:`List` for the ``as foo`` part, or " +"``None`` if that isn't used." msgstr "" msgid "" @@ -1730,8 +1732,8 @@ msgstr "" msgid "" "A single case pattern in a ``match`` statement. ``pattern`` contains the " -"match pattern that the subject will be matched against. Note that the :class:" -"`AST` nodes produced for patterns differ from those produced for " +"match pattern that the subject will be matched against. Note that " +"the :class:`AST` nodes produced for patterns differ from those produced for " "expressions, even when they share the same syntax." msgstr "" @@ -2132,10 +2134,10 @@ msgstr "" msgid "" "A :class:`typing.TypeVar`. ``name`` is the name of the type variable. " -"``bound`` is the bound or constraints, if any. If ``bound`` is a :class:" -"`Tuple`, it represents constraints; otherwise it represents the bound. " -"``default_value`` is the default value; if the :class:`!TypeVar` has no " -"default, this attribute will be set to ``None``." +"``bound`` is the bound or constraints, if any. If ``bound`` is " +"a :class:`Tuple`, it represents constraints; otherwise it represents the " +"bound. ``default_value`` is the default value; if the :class:`!TypeVar` has " +"no default, this attribute will be set to ``None``." msgstr "" msgid "" @@ -2408,8 +2410,8 @@ msgstr "" msgid "" "``keywords`` is a list of :class:`.keyword` nodes, principally for " -"'metaclass'. Other keywords will be passed to the metaclass, as per :pep:" -"`3115`." +"'metaclass'. Other keywords will be passed to the metaclass, as " +"per :pep:`3115`." msgstr "" msgid "" @@ -2449,8 +2451,8 @@ msgid "Async and await" msgstr "" msgid "" -"An ``async def`` function definition. Has the same fields as :class:" -"`FunctionDef`." +"An ``async def`` function definition. Has the same fields " +"as :class:`FunctionDef`." msgstr "" msgid "" @@ -2482,11 +2484,11 @@ msgid "" msgstr "" msgid "" -"When a string is parsed by :func:`ast.parse`, operator nodes (subclasses of :" -"class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast." -"boolop` and :class:`ast.expr_context`) on the returned tree will be " -"singletons. Changes to one will be reflected in all other occurrences of the " -"same value (for example, :class:`ast.Add`)." +"When a string is parsed by :func:`ast.parse`, operator nodes (subclasses " +"of :class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast.boolop` " +"and :class:`ast.expr_context`) on the returned tree will be singletons. " +"Changes to one will be reflected in all other occurrences of the same value " +"(for example, :class:`ast.Add`)." msgstr "" msgid ":mod:`!ast` helpers" @@ -2500,15 +2502,15 @@ msgstr "" msgid "" "Parse the source into an AST node. Equivalent to ``compile(source, " "filename, mode, flags=FLAGS_VALUE, optimize=optimize)``, where " -"``FLAGS_VALUE`` is ``ast.PyCF_ONLY_AST`` if ``optimize <= 0`` and ``ast." -"PyCF_OPTIMIZED_AST`` otherwise." +"``FLAGS_VALUE`` is ``ast.PyCF_ONLY_AST`` if ``optimize <= 0`` and " +"``ast.PyCF_OPTIMIZED_AST`` otherwise." msgstr "" msgid "" "If ``type_comments=True`` is given, the parser is modified to check and " "return type comments as specified by :pep:`484` and :pep:`526`. This is " -"equivalent to adding :data:`ast.PyCF_TYPE_COMMENTS` to the flags passed to :" -"func:`compile`. This will report syntax errors for misplaced type " +"equivalent to adding :data:`ast.PyCF_TYPE_COMMENTS` to the flags passed " +"to :func:`compile`. This will report syntax errors for misplaced type " "comments. Without this flag, type comments will be ignored, and the " "``type_comment`` field on selected AST nodes will always be ``None``. In " "addition, the locations of ``# type: ignore`` comments will be returned as " @@ -2518,8 +2520,8 @@ msgstr "" msgid "" "In addition, if ``mode`` is ``'func_type'``, the input syntax is modified to " -"correspond to :pep:`484` \"signature type comments\", e.g. ``(str, int) -> " -"List[str]``." +"correspond to :pep:`484` \"signature type comments\", for example ``(str, " +"int) -> List[str]``." msgstr "" msgid "" @@ -2567,8 +2569,8 @@ msgstr "" msgid "" "Unparse an :class:`ast.AST` object and generate a string with code that " -"would produce an equivalent :class:`ast.AST` object if parsed back with :" -"func:`ast.parse`." +"would produce an equivalent :class:`ast.AST` object if parsed back " +"with :func:`ast.parse`." msgstr "" msgid "" @@ -2578,8 +2580,8 @@ msgid "" msgstr "" msgid "" -"Trying to unparse a highly complex expression would result with :exc:" -"`RecursionError`." +"Trying to unparse a highly complex expression would result " +"with :exc:`RecursionError`." msgstr "" msgid "" @@ -2612,8 +2614,9 @@ msgid "" msgstr "" msgid "" -"It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:" -"`MemoryError` and :exc:`RecursionError` depending on the malformed input." +"It can " +"raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:`MemoryError` " +"and :exc:`RecursionError` depending on the malformed input." msgstr "" msgid "Now allows bytes and set literals." @@ -2626,10 +2629,10 @@ msgid "For string inputs, leading spaces and tabs are now stripped." msgstr "" msgid "" -"Return the docstring of the given *node* (which must be a :class:" -"`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, or :class:" -"`Module` node), or ``None`` if it has no docstring. If *clean* is true, " -"clean up the docstring's indentation with :func:`inspect.cleandoc`." +"Return the docstring of the given *node* (which must be " +"a :class:`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, " +"or :class:`Module` node), or ``None`` if it has no docstring. If *clean* is " +"true, clean up the docstring's indentation with :func:`inspect.cleandoc`." msgstr "" msgid ":class:`AsyncFunctionDef` is now supported." @@ -2637,9 +2640,9 @@ msgstr "" msgid "" "Get source code segment of the *source* that generated *node*. If some " -"location information (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :" -"attr:`~ast.AST.col_offset`, or :attr:`~ast.AST.end_col_offset`) is missing, " -"return ``None``." +"location information " +"(:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :attr:`~ast.AST.col_offset`, " +"or :attr:`~ast.AST.end_col_offset`) is missing, return ``None``." msgstr "" msgid "" @@ -2648,12 +2651,12 @@ msgid "" msgstr "" msgid "" -"When you compile a node tree with :func:`compile`, the compiler expects :" -"attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes for every " -"node that supports them. This is rather tedious to fill in for generated " -"nodes, so this helper adds these attributes recursively where not already " -"set, by setting them to the values of the parent node. It works recursively " -"starting at *node*." +"When you compile a node tree with :func:`compile`, the compiler " +"expects :attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes " +"for every node that supports them. This is rather tedious to fill in for " +"generated nodes, so this helper adds these attributes recursively where not " +"already set, by setting them to the values of the parent node. It works " +"recursively starting at *node*." msgstr "" msgid "" @@ -2663,9 +2666,10 @@ msgid "" msgstr "" msgid "" -"Copy source location (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :" -"attr:`~ast.AST.end_lineno`, and :attr:`~ast.AST.end_col_offset`) from " -"*old_node* to *new_node* if possible, and return *new_node*." +"Copy source location " +"(:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :attr:`~ast.AST.end_lineno`, " +"and :attr:`~ast.AST.end_col_offset`) from *old_node* to *new_node* if " +"possible, and return *new_node*." msgstr "" msgid "" @@ -2696,9 +2700,9 @@ msgid "" msgstr "" msgid "" -"Visit a node. The default implementation calls the method called :samp:" -"`self.visit_{classname}` where *classname* is the name of the node class, " -"or :meth:`generic_visit` if that method doesn't exist." +"Visit a node. The default implementation calls the method " +"called :samp:`self.visit_{classname}` where *classname* is the name of the " +"node class, or :meth:`generic_visit` if that method doesn't exist." msgstr "" msgid "This visitor calls :meth:`visit` on all children of the node." @@ -2714,15 +2718,15 @@ msgstr "" msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " -"during traversal. For this a special visitor exists (:class:" -"`NodeTransformer`) that allows modifications." +"during traversal. For this a special visitor exists " +"(:class:`NodeTransformer`) that allows modifications." msgstr "" msgid "" -"Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!visit_Bytes`, :meth:" -"`!visit_NameConstant` and :meth:`!visit_Ellipsis` will not be called in " -"Python 3.14+. Add the :meth:`visit_Constant` method instead to handle all " -"constant nodes." +"Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!" +"visit_Bytes`, :meth:`!visit_NameConstant` and :meth:`!visit_Ellipsis` will " +"not be called in Python 3.14+. Add the :meth:`visit_Constant` method " +"instead to handle all constant nodes." msgstr "" msgid "" @@ -2756,8 +2760,8 @@ msgstr "" msgid "" "Keep in mind that if the node you're operating on has child nodes you must " -"either transform the child nodes yourself or call the :meth:`~ast." -"NodeVisitor.generic_visit` method for the node first." +"either transform the child nodes yourself or call " +"the :meth:`~ast.NodeVisitor.generic_visit` method for the node first." msgstr "" msgid "" @@ -2768,9 +2772,9 @@ msgstr "" msgid "" "If :class:`NodeTransformer` introduces new nodes (that weren't part of " -"original tree) without giving them location information (such as :attr:`~ast." -"AST.lineno`), :func:`fix_missing_locations` should be called with the new " -"sub-tree to recalculate the location information::" +"original tree) without giving them location information (such " +"as :attr:`~ast.AST.lineno`), :func:`fix_missing_locations` should be called " +"with the new sub-tree to recalculate the location information::" msgstr "" msgid "" @@ -2871,8 +2875,8 @@ msgid "" msgstr "" msgid "" -"The returned AST is optimized according to the *optimize* argument in :func:" -"`compile` or :func:`ast.parse`." +"The returned AST is optimized according to the *optimize* argument " +"in :func:`compile` or :func:`ast.parse`." msgstr "" msgid "" @@ -2898,8 +2902,8 @@ msgid "Show the help message and exit." msgstr "" msgid "" -"Specify what kind of code must be compiled, like the *mode* argument in :" -"func:`parse`." +"Specify what kind of code must be compiled, like the *mode* argument " +"in :func:`parse`." msgstr "" msgid "Don't parse type comments." diff --git a/library/asyncio-api-index.po b/library/asyncio-api-index.po index 2509c79394..359c66f092 100644 --- a/library/asyncio-api-index.po +++ b/library/asyncio-api-index.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-dev.po b/library/asyncio-dev.po index 64f62896f6..e8275f226c 100644 --- a/library/asyncio-dev.po +++ b/library/asyncio-dev.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -62,9 +62,9 @@ msgid "In addition to enabling the debug mode, consider also:" msgstr "" msgid "" -"setting the log level of the :ref:`asyncio logger ` to :py:" -"const:`logging.DEBUG`, for example the following snippet of code can be run " -"at startup of the application::" +"setting the log level of the :ref:`asyncio logger ` " +"to :py:const:`logging.DEBUG`, for example the following snippet of code can " +"be run at startup of the application::" msgstr "" msgid "logging.basicConfig(level=logging.DEBUG)" @@ -80,9 +80,9 @@ msgid "When the debug mode is enabled:" msgstr "" msgid "" -"Many non-threadsafe asyncio APIs (such as :meth:`loop.call_soon` and :meth:" -"`loop.call_at` methods) raise an exception if they are called from a wrong " -"thread." +"Many non-threadsafe asyncio APIs (such as :meth:`loop.call_soon` " +"and :meth:`loop.call_at` methods) raise an exception if they are called from " +"a wrong thread." msgstr "" msgid "" @@ -91,9 +91,9 @@ msgid "" msgstr "" msgid "" -"Callbacks taking longer than 100 milliseconds are logged. The :attr:`loop." -"slow_callback_duration` attribute can be used to set the minimum execution " -"duration in seconds that is considered \"slow\"." +"Callbacks taking longer than 100 milliseconds are logged. " +"The :attr:`loop.slow_callback_duration` attribute can be used to set the " +"minimum execution duration in seconds that is considered \"slow\"." msgstr "" msgid "Concurrency and Multithreading" @@ -108,8 +108,8 @@ msgid "" msgstr "" msgid "" -"To schedule a :term:`callback` from another OS thread, the :meth:`loop." -"call_soon_threadsafe` method should be used. Example::" +"To schedule a :term:`callback` from another OS thread, " +"the :meth:`loop.call_soon_threadsafe` method should be used. Example::" msgstr "" msgid "loop.call_soon_threadsafe(callback, *args)" @@ -126,9 +126,9 @@ msgid "loop.call_soon_threadsafe(fut.cancel)" msgstr "" msgid "" -"To schedule a coroutine object from a different OS thread, the :func:" -"`run_coroutine_threadsafe` function should be used. It returns a :class:" -"`concurrent.futures.Future` to access the result::" +"To schedule a coroutine object from a different OS thread, " +"the :func:`run_coroutine_threadsafe` function should be used. It returns " +"a :class:`concurrent.futures.Future` to access the result::" msgstr "" msgid "" @@ -146,21 +146,22 @@ msgid "To handle signals the event loop must be run in the main thread." msgstr "" msgid "" -"The :meth:`loop.run_in_executor` method can be used with a :class:" -"`concurrent.futures.ThreadPoolExecutor` or :class:`~concurrent.futures." -"InterpreterPoolExecutor` to execute blocking code in a different OS thread " -"without blocking the OS thread that the event loop runs in." +"The :meth:`loop.run_in_executor` method can be used with " +"a :class:`concurrent.futures.ThreadPoolExecutor` " +"or :class:`~concurrent.futures.InterpreterPoolExecutor` to execute blocking " +"code in a different OS thread without blocking the OS thread that the event " +"loop runs in." msgstr "" msgid "" "There is currently no way to schedule coroutines or callbacks directly from " -"a different process (such as one started with :mod:`multiprocessing`). The :" -"ref:`asyncio-event-loop-methods` section lists APIs that can read from pipes " -"and watch file descriptors without blocking the event loop. In addition, " -"asyncio's :ref:`Subprocess ` APIs provide a way to start " -"a process and communicate with it from the event loop. Lastly, the " -"aforementioned :meth:`loop.run_in_executor` method can also be used with a :" -"class:`concurrent.futures.ProcessPoolExecutor` to execute code in a " +"a different process (such as one started with :mod:`multiprocessing`). " +"The :ref:`asyncio-event-loop-methods` section lists APIs that can read from " +"pipes and watch file descriptors without blocking the event loop. In " +"addition, asyncio's :ref:`Subprocess ` APIs provide a " +"way to start a process and communicate with it from the event loop. Lastly, " +"the aforementioned :meth:`loop.run_in_executor` method can also be used with " +"a :class:`concurrent.futures.ProcessPoolExecutor` to execute code in a " "different process." msgstr "" @@ -198,8 +199,8 @@ msgstr "" msgid "" "Network logging can block the event loop. It is recommended to use a " -"separate thread for handling logs or use non-blocking IO. For example, see :" -"ref:`blocking-handlers`." +"separate thread for handling logs or use non-blocking IO. For example, " +"see :ref:`blocking-handlers`." msgstr "" msgid "Detect never-awaited coroutines" @@ -207,8 +208,8 @@ msgstr "" msgid "" "When a coroutine function is called, but not awaited (e.g. ``coro()`` " -"instead of ``await coro()``) or the coroutine is not scheduled with :meth:" -"`asyncio.create_task`, asyncio will emit a :exc:`RuntimeWarning`::" +"instead of ``await coro()``) or the coroutine is not scheduled " +"with :meth:`asyncio.create_task`, asyncio will emit a :exc:`RuntimeWarning`::" msgstr "" msgid "" @@ -248,8 +249,8 @@ msgid "" msgstr "" msgid "" -"The usual fix is to either await the coroutine or call the :meth:`asyncio." -"create_task` function::" +"The usual fix is to either await the coroutine or call " +"the :meth:`asyncio.create_task` function::" msgstr "" msgid "" @@ -340,8 +341,9 @@ msgid "" msgstr "" msgid "" -"To avoid this, explicitly close the generator by calling its :meth:`~agen." -"aclose` method, or use the :func:`contextlib.aclosing` context manager::" +"To avoid this, explicitly close the generator by calling " +"its :meth:`~agen.aclose` method, or use the :func:`contextlib.aclosing` " +"context manager::" msgstr "" msgid "" @@ -381,7 +383,7 @@ msgid "" " try:\n" " yield 2\n" " finally:\n" -" await asyncio.sleep(0.1) # immitate some async work\n" +" await asyncio.sleep(0.1) # imitate some async work\n" " work_done = True\n" "\n" "\n" @@ -524,9 +526,10 @@ msgid "Avoid concurrent iteration and closure of the same generator" msgstr "" msgid "" -"Async generators may be reentered while another :meth:`~agen.__anext__` / :" -"meth:`~agen.athrow` / :meth:`~agen.aclose` call is in progress. This may " -"lead to an inconsistent state of the async generator and can cause errors." +"Async generators may be reentered while " +"another :meth:`~agen.__anext__` / :meth:`~agen.athrow` / :meth:`~agen.aclose` " +"call is in progress. This may lead to an inconsistent state of the async " +"generator and can cause errors." msgstr "" msgid "Let's consider the following example::" diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po index 87d6d32025..e5186845ad 100644 --- a/library/asyncio-eventloop.po +++ b/library/asyncio-eventloop.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -98,8 +98,8 @@ msgstr "" msgid "" "The :mod:`!asyncio` policy system is deprecated and will be removed in " "Python 3.16; from there on, this function will return the current running " -"event loop if present else it will return the loop set by :func:" -"`set_event_loop`." +"event loop if present else it will return the loop set " +"by :func:`set_event_loop`." msgstr "" msgid "Set *loop* as the current event loop for the current OS thread." @@ -126,9 +126,9 @@ msgid "" msgstr "" msgid "" -"The `Callback Handles`_ section documents the :class:`Handle` and :class:" -"`TimerHandle` instances which are returned from scheduling methods such as :" -"meth:`loop.call_soon` and :meth:`loop.call_later`;" +"The `Callback Handles`_ section documents the :class:`Handle` " +"and :class:`TimerHandle` instances which are returned from scheduling " +"methods such as :meth:`loop.call_soon` and :meth:`loop.call_later`;" msgstr "" msgid "" @@ -137,8 +137,8 @@ msgid "" msgstr "" msgid "" -"The `Event Loop Implementations`_ section documents the :class:" -"`SelectorEventLoop` and :class:`ProactorEventLoop` classes;" +"The `Event Loop Implementations`_ section documents " +"the :class:`SelectorEventLoop` and :class:`ProactorEventLoop` classes;" msgstr "" msgid "" @@ -236,8 +236,8 @@ msgstr "" msgid "" "Schedule the closure of the default executor and wait for it to join all of " "the threads in the :class:`~concurrent.futures.ThreadPoolExecutor`. Once " -"this method has been called, using the default executor with :meth:`loop." -"run_in_executor` will raise a :exc:`RuntimeError`." +"this method has been called, using the default executor " +"with :meth:`loop.run_in_executor` will raise a :exc:`RuntimeError`." msgstr "" msgid "" @@ -279,9 +279,9 @@ msgid "" msgstr "" msgid "" -"The optional keyword-only *context* argument specifies a custom :class:" -"`contextvars.Context` for the *callback* to run in. Callbacks use the " -"current context when no *context* is provided." +"The optional keyword-only *context* argument specifies a " +"custom :class:`contextvars.Context` for the *callback* to run in. Callbacks " +"use the current context when no *context* is provided." msgstr "" msgid "Unlike :meth:`call_soon_threadsafe`, this method is not thread-safe." @@ -360,15 +360,15 @@ msgid "" msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *callback* to run in. The current " -"context is used when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *callback* to run in. The " +"current context is used when no *context* is provided." msgstr "" msgid "" "For performance, callbacks scheduled with :meth:`loop.call_later` may run up " -"to one clock-resolution early (see ``time.get_clock_info('monotonic')." -"resolution``)." +"to one clock-resolution early (see " +"``time.get_clock_info('monotonic').resolution``)." msgstr "" msgid "" @@ -386,8 +386,8 @@ msgstr "" msgid "" "For performance, callbacks scheduled with :meth:`loop.call_at` may run up to " -"one clock-resolution early (see ``time.get_clock_info('monotonic')." -"resolution``)." +"one clock-resolution early (see " +"``time.get_clock_info('monotonic').resolution``)." msgstr "" msgid "" @@ -422,14 +422,14 @@ msgid "" msgstr "" msgid "" -"Schedule the execution of :ref:`coroutine ` *coro*. Return a :" -"class:`Task` object." +"Schedule the execution of :ref:`coroutine ` *coro*. Return " +"a :class:`Task` object." msgstr "" msgid "" "Third-party event loops can use their own subclass of :class:`Task` for " -"interoperability. In this case, the result type is a subclass of :class:" -"`Task`." +"interoperability. In this case, the result type is a subclass " +"of :class:`Task`." msgstr "" msgid "" @@ -444,16 +444,16 @@ msgid "" msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *coro* to run in. The current context " -"copy is created when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *coro* to run in. The current " +"context copy is created when no *context* is provided." msgstr "" msgid "" "An optional keyword-only *eager_start* argument allows specifying if the " "task should execute eagerly during the call to create_task, or be scheduled " -"later. If *eager_start* is not passed the mode set by :meth:`loop." -"set_task_factory` will be used." +"later. If *eager_start* is not passed the mode set " +"by :meth:`loop.set_task_factory` will be used." msgstr "" msgid "Added the *name* parameter." @@ -514,9 +514,9 @@ msgid "" msgstr "" msgid "" -"The socket family can be either :py:const:`~socket.AF_INET` or :py:const:" -"`~socket.AF_INET6` depending on *host* (or the *family* argument, if " -"provided)." +"The socket family can be either :py:const:`~socket.AF_INET` " +"or :py:const:`~socket.AF_INET6` depending on *host* (or the *family* " +"argument, if provided)." msgstr "" msgid "The socket type will be :py:const:`~socket.SOCK_STREAM`." @@ -541,13 +541,13 @@ msgid "" msgstr "" msgid "" -"*protocol_factory* is called without arguments and is expected to return a :" -"ref:`protocol ` instance." +"*protocol_factory* is called without arguments and is expected to return " +"a :ref:`protocol ` instance." msgstr "" msgid "" -"The protocol instance is coupled with the transport by calling its :meth:" -"`~BaseProtocol.connection_made` method." +"The protocol instance is coupled with the transport by calling " +"its :meth:`~BaseProtocol.connection_made` method." msgstr "" msgid "A ``(transport, protocol)`` tuple is returned on success." @@ -563,9 +563,9 @@ msgstr "" msgid "" "*ssl*: if given and not false, a SSL/TLS transport is created (by default a " "plain TCP transport is created). If *ssl* is a :class:`ssl.SSLContext` " -"object, this context is used to create the transport; if *ssl* is :const:" -"`True`, a default context returned from :func:`ssl.create_default_context` " -"is used." +"object, this context is used to create the transport; if *ssl* " +"is :const:`True`, a default context returned " +"from :func:`ssl.create_default_context` is used." msgstr "" msgid ":ref:`SSL/TLS security considerations `" @@ -608,16 +608,16 @@ msgid "" msgstr "" msgid "" -"*sock*, if given, should be an existing, already connected :class:`socket." -"socket` object to be used by the transport. If *sock* is given, none of " -"*host*, *port*, *family*, *proto*, *flags*, *happy_eyeballs_delay*, " -"*interleave* and *local_addr* should be specified." +"*sock*, if given, should be an existing, already " +"connected :class:`socket.socket` object to be used by the transport. If " +"*sock* is given, none of *host*, *port*, *family*, *proto*, *flags*, " +"*happy_eyeballs_delay*, *interleave* and *local_addr* should be specified." msgstr "" msgid "" "The *sock* argument transfers ownership of the socket to the transport " -"created. To close the socket, call the transport's :meth:`~asyncio." -"BaseTransport.close` method." +"created. To close the socket, call the " +"transport's :meth:`~asyncio.BaseTransport.close` method." msgstr "" msgid "" @@ -680,6 +680,11 @@ msgstr "" msgid "*all_errors* was added." msgstr "" +msgid "" +"Raises a ``ValueError`` if ``ssl.check_hostname`` is ``True`` and " +"``server_hostname`` is not supplied." +msgstr "" + msgid "" "The :func:`open_connection` function is a high-level alternative API. It " "returns a pair of (:class:`StreamReader`, :class:`StreamWriter`) that can be " @@ -690,9 +695,10 @@ msgid "Create a datagram connection." msgstr "" msgid "" -"The socket family can be either :py:const:`~socket.AF_INET`, :py:const:" -"`~socket.AF_INET6`, or :py:const:`~socket.AF_UNIX`, depending on *host* (or " -"the *family* argument, if provided)." +"The socket family can be " +"either :py:const:`~socket.AF_INET`, :py:const:`~socket.AF_INET6`, " +"or :py:const:`~socket.AF_UNIX`, depending on *host* (or the *family* " +"argument, if provided)." msgstr "" msgid "The socket type will be :py:const:`~socket.SOCK_DGRAM`." @@ -708,13 +714,14 @@ msgstr "" msgid "" "*local_addr*, if given, is a ``(local_host, local_port)`` tuple used to bind " -"the socket locally. The *local_host* and *local_port* are looked up using :" -"meth:`getaddrinfo`." +"the socket locally. The *local_host* and *local_port* are looked up " +"using :meth:`getaddrinfo`." msgstr "" msgid "" -"On Windows, when using the proactor event loop with ``local_addr=None``, an :" -"exc:`OSError` with :attr:`!errno.WSAEINVAL` will be raised when running it." +"On Windows, when using the proactor event loop with ``local_addr=None``, " +"an :exc:`OSError` with :attr:`!errno.WSAEINVAL` will be raised when running " +"it." msgstr "" msgid "" @@ -746,13 +753,14 @@ msgstr "" msgid "" "*sock* can optionally be specified in order to use a preexisting, already " "connected, :class:`socket.socket` object to be used by the transport. If " -"specified, *local_addr* and *remote_addr* should be omitted (must be :const:" -"`None`)." +"specified, *local_addr* and *remote_addr* should be omitted (must " +"be :const:`None`)." msgstr "" msgid "" -"See :ref:`UDP echo client protocol ` and :" -"ref:`UDP echo server protocol ` examples." +"See :ref:`UDP echo client protocol ` " +"and :ref:`UDP echo server protocol ` " +"examples." msgstr "" msgid "" @@ -764,9 +772,10 @@ msgid "Added support for Windows." msgstr "Dodane wsparcie dla Windowsa." msgid "" -"The *reuse_address* parameter is no longer supported, as using :ref:`socket." -"SO_REUSEADDR ` poses a significant security concern " -"for UDP. Explicitly passing ``reuse_address=True`` will raise an exception." +"The *reuse_address* parameter is no longer supported, as " +"using :ref:`socket.SO_REUSEADDR ` poses a significant " +"security concern for UDP. Explicitly passing ``reuse_address=True`` will " +"raise an exception." msgstr "" msgid "" @@ -791,14 +800,15 @@ msgid "Create a Unix connection." msgstr "" msgid "" -"The socket family will be :py:const:`~socket.AF_UNIX`; socket type will be :" -"py:const:`~socket.SOCK_STREAM`." +"The socket family will be :py:const:`~socket.AF_UNIX`; socket type will " +"be :py:const:`~socket.SOCK_STREAM`." msgstr "" msgid "" "*path* is the name of a Unix domain socket and is required, unless a *sock* " -"parameter is specified. Abstract Unix sockets, :class:`str`, :class:" -"`bytes`, and :class:`~pathlib.Path` paths are supported." +"parameter is specified. Abstract Unix " +"sockets, :class:`str`, :class:`bytes`, and :class:`~pathlib.Path` paths are " +"supported." msgstr "" msgid "" @@ -857,9 +867,10 @@ msgid "" msgstr "" msgid "" -"*family* can be set to either :const:`socket.AF_INET` or :const:`~socket." -"AF_INET6` to force the socket to use IPv4 or IPv6. If not set, the *family* " -"will be determined from host name (defaults to :const:`~socket.AF_UNSPEC`)." +"*family* can be set to either :const:`socket.AF_INET` " +"or :const:`~socket.AF_INET6` to force the socket to use IPv4 or IPv6. If not " +"set, the *family* will be determined from host name (defaults " +"to :const:`~socket.AF_UNSPEC`)." msgstr "" msgid "*flags* is a bitmask for :meth:`getaddrinfo`." @@ -876,8 +887,8 @@ msgid "" msgstr "" msgid "" -"*backlog* is the maximum number of queued connections passed to :meth:" -"`~socket.socket.listen` (defaults to 100)." +"*backlog* is the maximum number of queued connections passed " +"to :meth:`~socket.socket.listen` (defaults to 100)." msgstr "" msgid "" @@ -934,8 +945,8 @@ msgid "" msgstr "" msgid "" -"Similar to :meth:`loop.create_server` but works with the :py:const:`~socket." -"AF_UNIX` socket family." +"Similar to :meth:`loop.create_server` but works with " +"the :py:const:`~socket.AF_UNIX` socket family." msgstr "" msgid "" @@ -1050,8 +1061,8 @@ msgid "" msgstr "" msgid "" -"*transport* and *protocol* instances that methods like :meth:`~loop." -"create_server` and :meth:`~loop.create_connection` return." +"*transport* and *protocol* instances that methods " +"like :meth:`~loop.create_server` and :meth:`~loop.create_connection` return." msgstr "" msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`." @@ -1110,16 +1121,16 @@ msgid "Working with socket objects directly" msgstr "" msgid "" -"In general, protocol implementations that use transport-based APIs such as :" -"meth:`loop.create_connection` and :meth:`loop.create_server` are faster than " -"implementations that work with sockets directly. However, there are some use " -"cases when performance is not critical, and working with :class:`~socket." -"socket` objects directly is more convenient." +"In general, protocol implementations that use transport-based APIs such " +"as :meth:`loop.create_connection` and :meth:`loop.create_server` are faster " +"than implementations that work with sockets directly. However, there are " +"some use cases when performance is not critical, and working " +"with :class:`~socket.socket` objects directly is more convenient." msgstr "" msgid "" -"Receive up to *nbytes* from *sock*. Asynchronous version of :meth:`socket." -"recv() `." +"Receive up to *nbytes* from *sock*. Asynchronous version " +"of :meth:`socket.recv() `." msgstr "" msgid "Return the received data as a bytes object." @@ -1135,16 +1146,16 @@ msgid "" msgstr "" msgid "" -"Receive data from *sock* into the *buf* buffer. Modeled after the blocking :" -"meth:`socket.recv_into() ` method." +"Receive data from *sock* into the *buf* buffer. Modeled after the " +"blocking :meth:`socket.recv_into() ` method." msgstr "" msgid "Return the number of bytes written to the buffer." msgstr "" msgid "" -"Receive a datagram of up to *bufsize* from *sock*. Asynchronous version of :" -"meth:`socket.recvfrom() `." +"Receive a datagram of up to *bufsize* from *sock*. Asynchronous version " +"of :meth:`socket.recvfrom() `." msgstr "" msgid "Return a tuple of (received data, remote address)." @@ -1159,8 +1170,8 @@ msgid "Return a tuple of (number of bytes received, remote address)." msgstr "" msgid "" -"Send *data* to the *sock* socket. Asynchronous version of :meth:`socket." -"sendall() `." +"Send *data* to the *sock* socket. Asynchronous version " +"of :meth:`socket.sendall() `." msgstr "" msgid "" @@ -1178,8 +1189,8 @@ msgid "" msgstr "" msgid "" -"Send a datagram from *sock* to *address*. Asynchronous version of :meth:" -"`socket.sendto() `." +"Send a datagram from *sock* to *address*. Asynchronous version " +"of :meth:`socket.sendto() `." msgstr "" msgid "Return the number of bytes sent." @@ -1193,10 +1204,23 @@ msgid "" msgstr "" msgid "" -"``address`` no longer needs to be resolved. ``sock_connect`` will try to " -"check if the *address* is already resolved by calling :func:`socket." -"inet_pton`. If not, :meth:`loop.getaddrinfo` will be used to resolve the " -"*address*." +"With :class:`SelectorEventLoop`, *address* does not need to be resolved: " +"for :const:`~socket.AF_INET` and :const:`~socket.AF_INET6` sockets, " +"``sock_connect`` first checks whether *address* is already resolved by " +"calling :func:`socket.inet_pton`, and uses :meth:`loop.getaddrinfo` to " +"resolve it if it is not." +msgstr "" + +msgid "" +":class:`ProactorEventLoop`, the default event loop on Windows, does not " +"resolve *address*. The host must already be a numeric IP address; passing a " +"host name raises :exc:`OSError`. Resolve the address " +"with :meth:`loop.getaddrinfo` first, or use :meth:`loop.create_connection`, " +"which resolves the address on every platform." +msgstr "" + +msgid "" +"With :class:`SelectorEventLoop`, ``address`` no longer needs to be resolved." msgstr "" msgid "" @@ -1229,8 +1253,8 @@ msgid "" msgstr "" msgid "" -"*sock* must be a non-blocking :const:`socket.SOCK_STREAM` :class:`~socket." -"socket`." +"*sock* must be a non-" +"blocking :const:`socket.SOCK_STREAM` :class:`~socket.socket`." msgstr "" msgid "*file* must be a regular file object open in binary mode." @@ -1267,9 +1291,9 @@ msgstr "" msgid "" "Both *getaddrinfo* and *getnameinfo* methods were always documented to " -"return a coroutine, but prior to Python 3.7 they were, in fact, returning :" -"class:`asyncio.Future` objects. Starting with Python 3.7 both methods are " -"coroutines." +"return a coroutine, but prior to Python 3.7 they were, in fact, " +"returning :class:`asyncio.Future` objects. Starting with Python 3.7 both " +"methods are coroutines." msgstr "" msgid "Working with pipes" @@ -1278,13 +1302,15 @@ msgstr "" msgid "Register the read end of *pipe* in the event loop." msgstr "" -msgid "*pipe* is a :term:`file-like object `." +msgid "" +"*pipe* is a :term:`file-like object `. See :ref:`Supported " +"pipe objects ` for the objects supported as *pipe*." msgstr "" msgid "" -"Return pair ``(transport, protocol)``, where *transport* supports the :class:" -"`ReadTransport` interface and *protocol* is an object instantiated by the " -"*protocol_factory*." +"Return pair ``(transport, protocol)``, where *transport* supports " +"the :class:`ReadTransport` interface and *protocol* is an object " +"instantiated by the *protocol_factory*." msgstr "" msgid "" @@ -1295,13 +1321,48 @@ msgstr "" msgid "Register the write end of *pipe* in the event loop." msgstr "" -msgid "*pipe* is :term:`file-like object `." +msgid "" +"Return pair ``(transport, protocol)``, where *transport* " +"supports :class:`WriteTransport` interface and *protocol* is an object " +"instantiated by the *protocol_factory*." +msgstr "" + +msgid "Supported pipe objects" +msgstr "" + +msgid "" +"These methods only work with objects the operating system can poll for " +"readiness or perform overlapped I/O on. Regular files on disk are **not** " +"supported on any platform. There is no asynchronous file I/O in asyncio; " +"use :meth:`loop.run_in_executor` to read and write regular files without " +"blocking the event loop." msgstr "" msgid "" -"Return pair ``(transport, protocol)``, where *transport* supports :class:" -"`WriteTransport` interface and *protocol* is an object instantiated by the " -"*protocol_factory*." +"On Unix, with :class:`SelectorEventLoop`, *pipe* must wrap one of the " +"following:" +msgstr "" + +msgid "" +"a pipe, such as an end of an :func:`os.pipe` pair or a FIFO created " +"with :func:`os.mkfifo`;" +msgstr "" + +msgid "a socket;" +msgstr "" + +msgid "a character device, such as a terminal." +msgstr "" + +msgid "" +"On Windows, where only :class:`ProactorEventLoop` implements these methods, " +"*pipe* must wrap a handle opened for overlapped I/O (that is, created with " +"the ``FILE_FLAG_OVERLAPPED`` flag), since the handle has to be associated " +"with an I/O completion port. Handles that were not opened for overlapped I/" +"O are rejected. In particular, the standard streams " +"(:data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`), console " +"handles, and the pipes created by :func:`os.pipe` are **not** opened for " +"overlapped I/O and therefore cannot be used with these methods." msgstr "" msgid "" @@ -1436,14 +1497,14 @@ msgstr "" msgid "" "Set *executor* as the default executor used by :meth:`run_in_executor`. " -"*executor* must be an instance of :class:`~concurrent.futures." -"ThreadPoolExecutor`, which includes :class:`~concurrent.futures." -"InterpreterPoolExecutor`." +"*executor* must be an instance " +"of :class:`~concurrent.futures.ThreadPoolExecutor`, which " +"includes :class:`~concurrent.futures.InterpreterPoolExecutor`." msgstr "" msgid "" -"*executor* must be an instance of :class:`~concurrent.futures." -"ThreadPoolExecutor`." +"*executor* must be an instance " +"of :class:`~concurrent.futures.ThreadPoolExecutor`." msgstr "" msgid "Error handling API" @@ -1464,9 +1525,9 @@ msgid "" msgstr "" msgid "" -"If the handler is called on behalf of a :class:`~asyncio.Task` or :class:" -"`~asyncio.Handle`, it is run in the :class:`contextvars.Context` of that " -"task or callback handle." +"If the handler is called on behalf of a :class:`~asyncio.Task` " +"or :class:`~asyncio.Handle`, it is run in the :class:`contextvars.Context` " +"of that task or callback handle." msgstr "" msgid "" @@ -1489,8 +1550,8 @@ msgid "" msgstr "" msgid "" -"*context* parameter has the same meaning as in :meth:" -"`call_exception_handler`." +"*context* parameter has the same meaning as " +"in :meth:`call_exception_handler`." msgstr "" msgid "Call the current event loop exception handler." @@ -1531,10 +1592,8 @@ msgstr "" msgid "'handle_traceback' (optional): Traceback of the handle;" msgstr "" -msgid "'asyncgen' (optional): Asynchronous generator that caused" -msgstr "" - -msgid "the exception." +msgid "" +"'asyncgen' (optional): Asynchronous generator that caused the exception." msgstr "" msgid "" @@ -1549,8 +1608,9 @@ msgid "Get the debug mode (:class:`bool`) of the event loop." msgstr "" msgid "" -"The default value is ``True`` if the environment variable :envvar:" -"`PYTHONASYNCIODEBUG` is set to a non-empty string, ``False`` otherwise." +"The default value is ``True`` if the environment " +"variable :envvar:`PYTHONASYNCIODEBUG` is set to a non-empty string, " +"``False`` otherwise." msgstr "" msgid "Set the debug mode of the event loop." @@ -1584,8 +1644,9 @@ msgstr "" msgid "" "On Windows, the default event loop :class:`ProactorEventLoop` supports " -"subprocesses, whereas :class:`SelectorEventLoop` does not. See :ref:" -"`Subprocess Support on Windows ` for details." +"subprocesses, whereas :class:`SelectorEventLoop` does not. " +"See :ref:`Subprocess Support on Windows ` for " +"details." msgstr "" msgid "" @@ -1617,8 +1678,8 @@ msgid "" msgstr "" msgid "" -"The *protocol_factory* must be a callable returning a subclass of the :class:" -"`asyncio.SubprocessProtocol` class." +"The *protocol_factory* must be a callable returning a subclass of " +"the :class:`asyncio.SubprocessProtocol` class." msgstr "" msgid "Other parameters:" @@ -1646,8 +1707,8 @@ msgid "" msgstr "" msgid "" -"the :const:`subprocess.DEVNULL` constant which indicates that the special :" -"data:`os.devnull` file will be used" +"the :const:`subprocess.DEVNULL` constant which indicates that the " +"special :data:`os.devnull` file will be used" msgstr "" msgid "*stdout* can be any of these:" @@ -1675,9 +1736,9 @@ msgstr "" msgid "" "If a file-like object passed as *stdin*, *stdout* or *stderr* represents a " -"pipe, then the other side of this pipe should be registered with :meth:" -"`~loop.connect_write_pipe` or :meth:`~loop.connect_read_pipe` for use with " -"the event loop." +"pipe, then the other side of this pipe should be registered " +"with :meth:`~loop.connect_write_pipe` or :meth:`~loop.connect_read_pipe` for " +"use with the event loop." msgstr "" msgid "" @@ -1697,8 +1758,8 @@ msgid "" msgstr "" msgid "" -"Create a subprocess from *cmd*, which can be a :class:`str` or a :class:" -"`bytes` string encoded to the :ref:`filesystem encoding `, using the platform's \"shell\" syntax." msgstr "" @@ -1708,8 +1769,8 @@ msgid "" msgstr "" msgid "" -"The *protocol_factory* must be a callable returning a subclass of the :class:" -"`SubprocessProtocol` class." +"The *protocol_factory* must be a callable returning a subclass of " +"the :class:`SubprocessProtocol` class." msgstr "" msgid "" @@ -1736,8 +1797,8 @@ msgid "Callback handles" msgstr "" msgid "" -"A callback wrapper object returned by :meth:`loop.call_soon`, :meth:`loop." -"call_soon_threadsafe`." +"A callback wrapper object returned " +"by :meth:`loop.call_soon`, :meth:`loop.call_soon_threadsafe`." msgstr "" msgid "" @@ -1753,8 +1814,8 @@ msgid "Return ``True`` if the callback was cancelled." msgstr "" msgid "" -"A callback wrapper object returned by :meth:`loop.call_later`, and :meth:" -"`loop.call_at`." +"A callback wrapper object returned by :meth:`loop.call_later`, " +"and :meth:`loop.call_at`." msgstr "" msgid "This class is a subclass of :class:`Handle`." @@ -1764,17 +1825,17 @@ msgid "Return a scheduled callback time as :class:`float` seconds." msgstr "" msgid "" -"The time is an absolute timestamp, using the same time reference as :meth:" -"`loop.time`." +"The time is an absolute timestamp, using the same time reference " +"as :meth:`loop.time`." msgstr "" msgid "Server objects" msgstr "" msgid "" -"Server objects are created by :meth:`loop.create_server`, :meth:`loop." -"create_unix_server`, :func:`start_server`, and :func:`start_unix_server` " -"functions." +"Server objects are created " +"by :meth:`loop.create_server`, :meth:`loop.create_unix_server`, :func:`start_server`, " +"and :func:`start_unix_server` functions." msgstr "" msgid "Do not instantiate the :class:`Server` class directly." @@ -1895,6 +1956,12 @@ msgid "" "have finished." msgstr "" +msgid "" +"``wait_closed()`` now waits until the server is closed and all active " +"connections have finished. Previously, it returned immediately if the " +"server was already closed, even if connections were still active." +msgstr "" + msgid "" "List of socket-like objects, ``asyncio.trsock.TransportSocket``, which the " "server is listening on." @@ -1909,8 +1976,8 @@ msgid "Event loop implementations" msgstr "" msgid "" -"asyncio ships with two different event loop implementations: :class:" -"`SelectorEventLoop` and :class:`ProactorEventLoop`." +"asyncio ships with two different event loop " +"implementations: :class:`SelectorEventLoop` and :class:`ProactorEventLoop`." msgstr "" msgid "By default asyncio is configured to use :class:`EventLoop`." @@ -1934,8 +2001,8 @@ msgid "" "async def main():\n" " ...\n" "\n" -"loop_factory = lambda: asyncio.SelectorEventLoop(selectors." -"SelectSelector())\n" +"loop_factory = lambda: " +"asyncio.SelectorEventLoop(selectors.SelectSelector())\n" "asyncio.run(main(), loop_factory=loop_factory)" msgstr "" @@ -1950,13 +2017,13 @@ msgid "" msgstr "" msgid "" -"An alias to the most efficient available subclass of :class:" -"`AbstractEventLoop` for the given platform." +"An alias to the most efficient available subclass " +"of :class:`AbstractEventLoop` for the given platform." msgstr "" msgid "" -"It is an alias to :class:`SelectorEventLoop` on Unix and :class:" -"`ProactorEventLoop` on Windows." +"It is an alias to :class:`SelectorEventLoop` on Unix " +"and :class:`ProactorEventLoop` on Windows." msgstr "" msgid "Abstract base class for asyncio-compliant event loops." @@ -1967,14 +2034,27 @@ msgid "" "alternative implementation of ``AbstractEventLoop`` should have defined." msgstr "" +msgid "" +"A base class that partially implements :class:`AbstractEventLoop` to " +"simplify writing custom event loops." +msgstr "" + +msgid "" +"It provides default implementations of many :class:`AbstractEventLoop` " +"methods, so subclasses have fewer methods to implement themselves. In " +"return, a subclass is expected to implement a number of internal, protected " +"methods. See :ref:`writing_custom_event_loop` for more information." +msgstr "" + msgid "Examples" msgstr "Przykłady" msgid "" "Note that all examples in this section **purposefully** show how to use the " -"low-level event loop APIs, such as :meth:`loop.run_forever` and :meth:`loop." -"call_soon`. Modern asyncio applications rarely need to be written this way; " -"consider using the high-level functions like :func:`asyncio.run`." +"low-level event loop APIs, such as :meth:`loop.run_forever` " +"and :meth:`loop.call_soon`. Modern asyncio applications rarely need to be " +"written this way; consider using the high-level functions " +"like :func:`asyncio.run`." msgstr "" msgid "Hello World with call_soon()" @@ -2052,8 +2132,8 @@ msgid "Watch a file descriptor for read events" msgstr "" msgid "" -"Wait until a file descriptor received some data using the :meth:`loop." -"add_reader` method and then close the event loop::" +"Wait until a file descriptor received some data using " +"the :meth:`loop.add_reader` method and then close the event loop::" msgstr "" msgid "" @@ -2108,8 +2188,9 @@ msgid "(This ``signal`` example only works on Unix.)" msgstr "" msgid "" -"Register handlers for signals :const:`~signal.SIGINT` and :const:`~signal." -"SIGTERM` using the :meth:`loop.add_signal_handler` method::" +"Register handlers for signals :const:`~signal.SIGINT` " +"and :const:`~signal.SIGTERM` using the :meth:`loop.add_signal_handler` " +"method::" msgstr "" msgid "" diff --git a/library/asyncio-exceptions.po b/library/asyncio-exceptions.po index ec0d7921c3..74ef8ae2e2 100644 --- a/library/asyncio-exceptions.po +++ b/library/asyncio-exceptions.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-extending.po b/library/asyncio-extending.po index 1876f7a005..39652502e0 100644 --- a/library/asyncio-extending.po +++ b/library/asyncio-extending.po @@ -66,8 +66,9 @@ msgstr "" msgid "" ":class:`asyncio.Future` and :class:`asyncio.Task` should be never created " -"directly, please use corresponding :meth:`loop.create_future` and :meth:" -"`loop.create_task`, or :func:`asyncio.create_task` factories instead." +"directly, please use corresponding :meth:`loop.create_future` " +"and :meth:`loop.create_task`, or :func:`asyncio.create_task` factories " +"instead." msgstr "" msgid "" @@ -101,8 +102,8 @@ msgstr "" msgid "" "A third party task implementation should call the following functions to " -"keep a task visible by :func:`asyncio.get_tasks` and :func:`asyncio." -"current_task`:" +"keep a task visible by :func:`asyncio.get_tasks` " +"and :func:`asyncio.current_task`:" msgstr "" msgid "Register a new *task* as managed by *asyncio*." @@ -121,14 +122,14 @@ msgid "Switch the current task to the *task* argument." msgstr "" msgid "" -"Call the function just before executing a portion of embedded *coroutine* (:" -"meth:`coroutine.send` or :meth:`coroutine.throw`)." +"Call the function just before executing a portion of embedded *coroutine* " +"(:meth:`coroutine.send` or :meth:`coroutine.throw`)." msgstr "" msgid "Switch the current task back from *task* to ``None``." msgstr "" msgid "" -"Call the function just after :meth:`coroutine.send` or :meth:`coroutine." -"throw` execution." +"Call the function just after :meth:`coroutine.send` " +"or :meth:`coroutine.throw` execution." msgstr "" diff --git a/library/asyncio-future.po b/library/asyncio-future.po index a36a9eb597..5c0ed24fb2 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -62,14 +62,14 @@ msgid "" msgstr "" msgid "" -"a :class:`Task` object wrapping *obj*, if *obj* is a coroutine (:func:" -"`iscoroutine` is used for the test); in this case the coroutine will be " -"scheduled by ``ensure_future()``." +"a :class:`Task` object wrapping *obj*, if *obj* is a coroutine " +"(:func:`iscoroutine` is used for the test); in this case the coroutine will " +"be scheduled by ``ensure_future()``." msgstr "" msgid "" -"a :class:`Task` object that would await on *obj*, if *obj* is an awaitable (:" -"func:`inspect.isawaitable` is used for the test.)" +"a :class:`Task` object that would await on *obj*, if *obj* is an awaitable " +"(:func:`inspect.isawaitable` is used for the test.)" msgstr "" msgid "If *obj* is neither of the above a :exc:`TypeError` is raised." @@ -95,8 +95,8 @@ msgid "" msgstr "" msgid "" -"Wrap a :class:`concurrent.futures.Future` object in a :class:`asyncio." -"Future` object." +"Wrap a :class:`concurrent.futures.Future` object in " +"a :class:`asyncio.Future` object." msgstr "" msgid "" @@ -126,9 +126,13 @@ msgstr "" msgid "" "The rule of thumb is to never expose Future objects in user-facing APIs, and " -"the recommended way to create a Future object is to call :meth:`loop." -"create_future`. This way alternative event loop implementations can inject " -"their own optimized implementations of a Future object." +"the recommended way to create a Future object is to " +"call :meth:`loop.create_future`. This way alternative event loop " +"implementations can inject their own optimized implementations of a Future " +"object." +msgstr "" + +msgid "Futures are :ref:`generic ` over the type of their results." msgstr "" msgid "Added support for the :mod:`contextvars` module." @@ -148,18 +152,18 @@ msgid "" msgstr "" msgid "" -"If the Future is *done* and has an exception set by the :meth:" -"`set_exception` method, this method raises the exception." +"If the Future is *done* and has an exception set by " +"the :meth:`set_exception` method, this method raises the exception." msgstr "" msgid "" -"If the Future has been *cancelled*, this method raises a :exc:" -"`CancelledError` exception." +"If the Future has been *cancelled*, this method raises " +"a :exc:`CancelledError` exception." msgstr "" msgid "" -"If the Future's result isn't yet available, this method raises an :exc:" -"`InvalidStateError` exception." +"If the Future's result isn't yet available, this method raises " +"an :exc:`InvalidStateError` exception." msgstr "" msgid "Mark the Future as *done* and set its result." @@ -205,14 +209,14 @@ msgid "" msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *callback* to run in. The current " -"context is used when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *callback* to run in. The " +"current context is used when no *context* is provided." msgstr "" msgid "" -":func:`functools.partial` can be used to pass parameters to the callback, e." -"g.::" +":func:`functools.partial` can be used to pass parameters to the callback, " +"e.g.::" msgstr "" msgid "" @@ -244,8 +248,9 @@ msgid "" msgstr "" msgid "" -"The optional string argument *msg* is passed as the argument to the :exc:" -"`CancelledError` exception raised when a cancelled Future is awaited." +"The optional string argument *msg* is passed as the argument to " +"the :exc:`CancelledError` exception raised when a cancelled Future is " +"awaited." msgstr "" msgid "Added the *msg* parameter." @@ -260,8 +265,8 @@ msgid "" msgstr "" msgid "" -"If the Future isn't *done* yet, this method raises an :exc:" -"`InvalidStateError` exception." +"If the Future isn't *done* yet, this method raises " +"an :exc:`InvalidStateError` exception." msgstr "" msgid "Return the event loop the Future object is bound to." @@ -318,8 +323,8 @@ msgid "" msgstr "" msgid "" -":meth:`asyncio.Future.result` and :meth:`asyncio.Future.exception` raise an :" -"exc:`InvalidStateError` exception when the Future is not *done*." +":meth:`asyncio.Future.result` and :meth:`asyncio.Future.exception` raise " +"an :exc:`InvalidStateError` exception when the Future is not *done*." msgstr "" msgid "" @@ -333,6 +338,6 @@ msgid "" msgstr "" msgid "" -":meth:`asyncio.Future.cancel` accepts an optional ``msg`` argument, but :" -"meth:`concurrent.futures.Future.cancel` does not." +":meth:`asyncio.Future.cancel` accepts an optional ``msg`` argument, " +"but :meth:`concurrent.futures.Future.cancel` does not." msgstr "" diff --git a/library/asyncio-graph.po b/library/asyncio-graph.po index ae34e2aca9..49ae1fc26f 100644 --- a/library/asyncio-graph.po +++ b/library/asyncio-graph.po @@ -37,8 +37,8 @@ msgid "" msgstr "" msgid "" -"Print the async call graph for the current task or the provided :class:" -"`Task` or :class:`Future`." +"Print the async call graph for the current task or the " +"provided :class:`Task` or :class:`Future`." msgstr "" msgid "" @@ -68,8 +68,8 @@ msgid "" msgstr "" msgid "" -"If *file* is omitted or ``None``, the function will print to :data:`sys." -"stdout`." +"If *file* is omitted or ``None``, the function will print " +"to :data:`sys.stdout`." msgstr "" msgid "**Example:**" @@ -111,8 +111,8 @@ msgid "" msgstr "" msgid "" -"Capture the async call graph for the current task or the provided :class:" -"`Task` or :class:`Future`." +"Capture the async call graph for the current task or the " +"provided :class:`Task` or :class:`Future`." msgstr "" msgid "" @@ -152,19 +152,20 @@ msgstr "" msgid "" "To introspect an async call graph asyncio requires cooperation from control " "flow structures, such as :func:`shield` or :class:`TaskGroup`. Any time an " -"intermediate :class:`Future` object with low-level APIs like :meth:`Future." -"add_done_callback() ` is involved, the " -"following two functions should be used to inform asyncio about how exactly " -"such intermediate future objects are connected with the tasks they wrap or " -"control." +"intermediate :class:`Future` object with low-level APIs " +"like :meth:`Future.add_done_callback() ` " +"is involved, the following two functions should be used to inform asyncio " +"about how exactly such intermediate future objects are connected with the " +"tasks they wrap or control." msgstr "" msgid "Record that *future* is awaited on by *waiter*." msgstr "" msgid "" -"Both *future* and *waiter* must be instances of :class:`Future` or :class:" -"`Task` or their subclasses, otherwise the call would have no effect." +"Both *future* and *waiter* must be instances of :class:`Future` " +"or :class:`Task` or their subclasses, otherwise the call would have no " +"effect." msgstr "" msgid "" diff --git a/library/asyncio-llapi-index.po b/library/asyncio-llapi-index.po index 44a4a81b3d..d7f34fcc8c 100644 --- a/library/asyncio-llapi-index.po +++ b/library/asyncio-llapi-index.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -284,7 +285,7 @@ msgid "Wrap a write end of a pipe into a ``(transport, protocol)`` pair." msgstr "" msgid "Sockets" -msgstr "" +msgstr "Sockety" msgid "``await`` :meth:`loop.sock_recv`" msgstr "``await`` :meth:`loop.sock_recv`" @@ -488,8 +489,9 @@ msgstr "" msgid "" "Transports that can receive data (TCP and Unix connections, pipes, etc). " -"Returned from methods like :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.connect_read_pipe`, etc:" +"Returned from methods " +"like :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.connect_read_pipe`, " +"etc:" msgstr "" msgid "Read Transports" @@ -515,8 +517,9 @@ msgstr "" msgid "" "Transports that can Send data (TCP and Unix connections, pipes, etc). " -"Returned from methods like :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.connect_write_pipe`, etc:" +"Returned from methods " +"like :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.connect_write_pipe`, " +"etc:" msgstr "" msgid "Write Transports" @@ -553,29 +556,29 @@ msgid "Close the transport immediately." msgstr "" msgid "" -":meth:`transport.get_write_buffer_size() `" +":meth:`transport.get_write_buffer_size() " +"`" msgstr "" -":meth:`transport.get_write_buffer_size() `" +":meth:`transport.get_write_buffer_size() " +"`" msgid "Return the current size of the output buffer." msgstr "" msgid "" -":meth:`transport.get_write_buffer_limits() `" +":meth:`transport.get_write_buffer_limits() " +"`" msgstr "" msgid "Return high and low water marks for write flow control." msgstr "" msgid "" -":meth:`transport.set_write_buffer_limits() `" +":meth:`transport.set_write_buffer_limits() " +"`" msgstr "" -":meth:`transport.set_write_buffer_limits() `" +":meth:`transport.set_write_buffer_limits() " +"`" msgid "Set new high and low water marks for write flow control." msgstr "" @@ -596,8 +599,8 @@ msgid ":meth:`transport.abort() `" msgstr ":meth:`transport.abort() `" msgid "" -"Low-level transport abstraction over subprocesses. Returned by :meth:`loop." -"subprocess_exec` and :meth:`loop.subprocess_shell`:" +"Low-level transport abstraction over subprocesses. Returned " +"by :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell`:" msgstr "" msgid "Subprocess Transports" @@ -610,11 +613,11 @@ msgid "Return the subprocess process id." msgstr "" msgid "" -":meth:`transport.get_pipe_transport() `" +":meth:`transport.get_pipe_transport() " +"`" msgstr "" -":meth:`transport.get_pipe_transport() `" +":meth:`transport.get_pipe_transport() " +"`" msgid "" "Return the transport for the requested communication pipe (*stdin*, " @@ -758,18 +761,18 @@ msgstr "" "``callback`` :meth:`process_exited() `" msgid "" -"Called when the child process has exited. It can be called before :meth:" -"`~SubprocessProtocol.pipe_data_received` and :meth:`~SubprocessProtocol." -"pipe_connection_lost` methods." +"Called when the child process has exited. It can be called " +"before :meth:`~SubprocessProtocol.pipe_data_received` " +"and :meth:`~SubprocessProtocol.pipe_connection_lost` methods." msgstr "" msgid "Event Loop Policies" msgstr "" msgid "" -"Policies is a low-level mechanism to alter the behavior of functions like :" -"func:`asyncio.get_event_loop`. See also the main :ref:`policies section " -"` for more details." +"Policies is a low-level mechanism to alter the behavior of functions " +"like :func:`asyncio.get_event_loop`. See also the main :ref:`policies " +"section ` for more details." msgstr "" msgid "Accessing Policies" diff --git a/library/asyncio-platforms.po b/library/asyncio-platforms.po index f1c90e759b..e27580ade2 100644 --- a/library/asyncio-platforms.po +++ b/library/asyncio-platforms.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,6 +40,12 @@ msgid "" "monitor file I/O." msgstr "" +msgid "" +":meth:`loop.connect_read_pipe` and :meth:`loop.connect_write_pipe` cannot be " +"used with regular files. See :ref:`Supported pipe objects ` for the objects that are accepted on each platform." +msgstr "" + msgid "Windows" msgstr "Windows" @@ -80,14 +86,14 @@ msgid "" msgstr "" msgid "" -"Pipes are not supported, so the :meth:`loop.connect_read_pipe` and :meth:" -"`loop.connect_write_pipe` methods are not implemented." +"Pipes are not supported, so the :meth:`loop.connect_read_pipe` " +"and :meth:`loop.connect_write_pipe` methods are not implemented." msgstr "" msgid "" -":ref:`Subprocesses ` are not supported, i.e. :meth:`loop." -"subprocess_exec` and :meth:`loop.subprocess_shell` methods are not " -"implemented." +":ref:`Subprocesses ` are not supported, " +"i.e. :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell` methods " +"are not implemented." msgstr "" msgid ":class:`ProactorEventLoop` has the following limitations:" @@ -98,6 +104,12 @@ msgid "" "supported." msgstr "" +msgid "" +":meth:`loop.connect_read_pipe` and :meth:`loop.connect_write_pipe` only " +"accept a handle opened for overlapped I/O. See :ref:`Supported pipe objects " +"` for which objects are supported." +msgstr "" + msgid "" "The resolution of the monotonic clock on Windows is usually around 15.6 " "milliseconds. The best resolution is 0.5 milliseconds. The resolution " @@ -123,11 +135,12 @@ msgid "macOS <= 10.8" msgstr "" msgid "" -"On macOS 10.6, 10.7 and 10.8, the default event loop uses :class:`selectors." -"KqueueSelector`, which does not support character devices on these " -"versions. The :class:`SelectorEventLoop` can be manually configured to use :" -"class:`~selectors.SelectSelector` or :class:`~selectors.PollSelector` to " -"support character devices on these older versions of macOS. Example::" +"On macOS 10.6, 10.7 and 10.8, the default event loop " +"uses :class:`selectors.KqueueSelector`, which does not support character " +"devices on these versions. The :class:`SelectorEventLoop` can be manually " +"configured to use :class:`~selectors.SelectSelector` " +"or :class:`~selectors.PollSelector` to support character devices on these " +"older versions of macOS. Example::" msgstr "" msgid "" diff --git a/library/asyncio-policy.po b/library/asyncio-policy.po index 92dfbc3ae5..05ef254ec1 100644 --- a/library/asyncio-policy.po +++ b/library/asyncio-policy.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,17 +28,18 @@ msgstr "" msgid "" "Policies are deprecated and will be removed in Python 3.16. Users are " -"encouraged to use the :func:`asyncio.run` function or the :class:`asyncio." -"Runner` with *loop_factory* to use the desired loop implementation." +"encouraged to use the :func:`asyncio.run` function or " +"the :class:`asyncio.Runner` with *loop_factory* to use the desired loop " +"implementation." msgstr "" msgid "" -"An event loop policy is a global object used to get and set the current :ref:" -"`event loop `, as well as create new event loops. The " -"default policy can be :ref:`replaced ` with :ref:" -"`built-in alternatives ` to use different event loop " -"implementations, or substituted by a :ref:`custom policy ` that can override these behaviors." +"An event loop policy is a global object used to get and set the " +"current :ref:`event loop `, as well as create new event " +"loops. The default policy can be :ref:`replaced ` " +"with :ref:`built-in alternatives ` to use different " +"event loop implementations, or substituted by a :ref:`custom policy ` that can override these behaviors." msgstr "" msgid "" @@ -48,13 +49,14 @@ msgid "" msgstr "" msgid "" -"Custom event loop policies can control the behavior of :func:" -"`get_event_loop`, :func:`set_event_loop`, and :func:`new_event_loop`." +"Custom event loop policies can control the behavior " +"of :func:`get_event_loop`, :func:`set_event_loop`, " +"and :func:`new_event_loop`." msgstr "" msgid "" -"Policy objects should implement the APIs defined in the :class:" -"`AbstractEventLoopPolicy` abstract base class." +"Policy objects should implement the APIs defined in " +"the :class:`AbstractEventLoopPolicy` abstract base class." msgstr "" msgid "Getting and Setting the Policy" @@ -119,8 +121,8 @@ msgid "asyncio ships with the following built-in policies:" msgstr "" msgid "" -"The default asyncio policy. Uses :class:`SelectorEventLoop` on Unix and :" -"class:`ProactorEventLoop` on Windows." +"The default asyncio policy. Uses :class:`SelectorEventLoop` on Unix " +"and :class:`ProactorEventLoop` on Windows." msgstr "" msgid "" @@ -168,9 +170,9 @@ msgid "Custom Policies" msgstr "" msgid "" -"To implement a new event loop policy, it is recommended to subclass :class:" -"`DefaultEventLoopPolicy` and override the methods for which custom behavior " -"is wanted, e.g.::" +"To implement a new event loop policy, it is recommended to " +"subclass :class:`DefaultEventLoopPolicy` and override the methods for which " +"custom behavior is wanted, e.g.::" msgstr "" msgid "" diff --git a/library/asyncio-protocol.po b/library/asyncio-protocol.po index 537fcb105b..016fe3a22d 100644 --- a/library/asyncio-protocol.po +++ b/library/asyncio-protocol.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -71,11 +71,11 @@ msgid "" msgstr "" msgid "" -"Most of connection oriented event loop methods (such as :meth:`loop." -"create_connection`) usually accept a *protocol_factory* argument used to " -"create a *Protocol* object for an accepted connection, represented by a " -"*Transport* object. Such methods usually return a tuple of ``(transport, " -"protocol)``." +"Most of connection oriented event loop methods (such " +"as :meth:`loop.create_connection`) usually accept a *protocol_factory* " +"argument used to create a *Protocol* object for an accepted connection, " +"represented by a *Transport* object. Such methods usually return a tuple of " +"``(transport, protocol)``." msgstr "" msgid "Contents" @@ -85,15 +85,15 @@ msgid "This documentation page contains the following sections:" msgstr "" msgid "" -"The `Transports`_ section documents asyncio :class:`BaseTransport`, :class:" -"`ReadTransport`, :class:`WriteTransport`, :class:`Transport`, :class:" -"`DatagramTransport`, and :class:`SubprocessTransport` classes." +"The `Transports`_ section documents " +"asyncio :class:`BaseTransport`, :class:`ReadTransport`, :class:`WriteTransport`, :class:`Transport`, :class:`DatagramTransport`, " +"and :class:`SubprocessTransport` classes." msgstr "" msgid "" -"The `Protocols`_ section documents asyncio :class:`BaseProtocol`, :class:" -"`Protocol`, :class:`BufferedProtocol`, :class:`DatagramProtocol`, and :class:" -"`SubprocessProtocol` classes." +"The `Protocols`_ section documents " +"asyncio :class:`BaseProtocol`, :class:`Protocol`, :class:`BufferedProtocol`, :class:`DatagramProtocol`, " +"and :class:`SubprocessProtocol` classes." msgstr "" msgid "" @@ -138,18 +138,18 @@ msgid "A base transport for write-only connections." msgstr "" msgid "" -"Instances of the *WriteTransport* class are returned from the :meth:`loop." -"connect_write_pipe` event loop method and are also used by subprocess-" -"related methods like :meth:`loop.subprocess_exec`." +"Instances of the *WriteTransport* class are returned from " +"the :meth:`loop.connect_write_pipe` event loop method and are also used by " +"subprocess-related methods like :meth:`loop.subprocess_exec`." msgstr "" msgid "A base transport for read-only connections." msgstr "" msgid "" -"Instances of the *ReadTransport* class are returned from the :meth:`loop." -"connect_read_pipe` event loop method and are also used by subprocess-related " -"methods like :meth:`loop.subprocess_exec`." +"Instances of the *ReadTransport* class are returned from " +"the :meth:`loop.connect_read_pipe` event loop method and are also used by " +"subprocess-related methods like :meth:`loop.subprocess_exec`." msgstr "" msgid "" @@ -164,8 +164,8 @@ msgstr "" msgid "" "Instances of the *Transport* class are returned from or used by event loop " -"methods like :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.create_server`, :meth:`loop.sendfile`, " +"methods " +"like :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.create_server`, :meth:`loop.sendfile`, " "etc." msgstr "" @@ -173,8 +173,8 @@ msgid "A transport for datagram (UDP) connections." msgstr "" msgid "" -"Instances of the *DatagramTransport* class are returned from the :meth:`loop." -"create_datagram_endpoint` event loop method." +"Instances of the *DatagramTransport* class are returned from " +"the :meth:`loop.create_datagram_endpoint` event loop method." msgstr "" msgid "" @@ -244,8 +244,8 @@ msgid "``'socket'``: :class:`socket.socket` instance" msgstr "" msgid "" -"``'sockname'``: the socket's own address, result of :meth:`socket.socket." -"getsockname`" +"``'sockname'``: the socket's own address, result " +"of :meth:`socket.socket.getsockname`" msgstr "" msgid "SSL socket:" @@ -253,8 +253,8 @@ msgstr "" msgid "" "``'compression'``: the compression algorithm being used as a string, or " -"``None`` if the connection isn't compressed; result of :meth:`ssl.SSLSocket." -"compression`" +"``None`` if the connection isn't compressed; result " +"of :meth:`ssl.SSLSocket.compression`" msgstr "" msgid "" @@ -336,8 +336,8 @@ msgid "" msgstr "" msgid "" -"Return :const:`True` if the transport supports :meth:`~WriteTransport." -"write_eof`, :const:`False` if not." +"Return :const:`True` if the transport " +"supports :meth:`~WriteTransport.write_eof`, :const:`False` if not." msgstr "" msgid "Return the current size of the output buffer used by the transport." @@ -355,18 +355,18 @@ msgid "Set the *high* and *low* watermarks for write flow control." msgstr "" msgid "" -"These two values (measured in number of bytes) control when the protocol's :" -"meth:`protocol.pause_writing() ` and :meth:" -"`protocol.resume_writing() ` methods are " -"called. If specified, the low watermark must be less than or equal to the " -"high watermark. Neither *high* nor *low* can be negative." +"These two values (measured in number of bytes) control when the " +"protocol's :meth:`protocol.pause_writing() ` " +"and :meth:`protocol.resume_writing() ` methods " +"are called. If specified, the low watermark must be less than or equal to " +"the high watermark. Neither *high* nor *low* can be negative." msgstr "" msgid "" ":meth:`~BaseProtocol.pause_writing` is called when the buffer size becomes " -"greater than or equal to the *high* value. If writing has been paused, :meth:" -"`~BaseProtocol.resume_writing` is called when the buffer size becomes less " -"than or equal to the *low* value." +"greater than or equal to the *high* value. If writing has been " +"paused, :meth:`~BaseProtocol.resume_writing` is called when the buffer size " +"becomes less than or equal to the *low* value." msgstr "" msgid "" @@ -374,10 +374,10 @@ msgid "" "given, the low watermark defaults to an implementation-specific value less " "than or equal to the high watermark. Setting *high* to zero forces *low* to " "zero as well, and causes :meth:`~BaseProtocol.pause_writing` to be called " -"whenever the buffer becomes non-empty. Setting *low* to zero causes :meth:" -"`~BaseProtocol.resume_writing` to be called only once the buffer is empty. " -"Use of zero for either limit is generally sub-optimal as it reduces " -"opportunities for doing I/O and computation concurrently." +"whenever the buffer becomes non-empty. Setting *low* to zero " +"causes :meth:`~BaseProtocol.resume_writing` to be called only once the " +"buffer is empty. Use of zero for either limit is generally sub-optimal as it " +"reduces opportunities for doing I/O and computation concurrently." msgstr "" msgid "Use :meth:`~WriteTransport.get_write_buffer_limits` to get the limits." @@ -441,18 +441,18 @@ msgid "" msgstr "" msgid "" -"``0``: writable streaming transport of the standard input (*stdin*), or :" -"const:`None` if the subprocess was not created with ``stdin=PIPE``" +"``0``: writable streaming transport of the standard input (*stdin*), " +"or :const:`None` if the subprocess was not created with ``stdin=PIPE``" msgstr "" msgid "" -"``1``: readable streaming transport of the standard output (*stdout*), or :" -"const:`None` if the subprocess was not created with ``stdout=PIPE``" +"``1``: readable streaming transport of the standard output (*stdout*), " +"or :const:`None` if the subprocess was not created with ``stdout=PIPE``" msgstr "" msgid "" -"``2``: readable streaming transport of the standard error (*stderr*), or :" -"const:`None` if the subprocess was not created with ``stderr=PIPE``" +"``2``: readable streaming transport of the standard error (*stderr*), " +"or :const:`None` if the subprocess was not created with ``stderr=PIPE``" msgstr "" msgid "other *fd*: :const:`None`" @@ -476,8 +476,8 @@ msgid "See also :meth:`subprocess.Popen.kill`." msgstr "" msgid "" -"Send the *signal* number to the subprocess, as in :meth:`subprocess.Popen." -"send_signal`." +"Send the *signal* number to the subprocess, as " +"in :meth:`subprocess.Popen.send_signal`." msgstr "" msgid "Stop the subprocess." @@ -594,8 +594,9 @@ msgid "Called when the transport's buffer drains below the low watermark." msgstr "" msgid "" -"If the buffer size equals the high watermark, :meth:`~BaseProtocol." -"pause_writing` is not called: the buffer size must go strictly over." +"If the buffer size equals the high " +"watermark, :meth:`~BaseProtocol.pause_writing` is not called: the buffer " +"size must go strictly over." msgstr "" msgid "" @@ -608,11 +609,10 @@ msgid "Streaming Protocols" msgstr "" msgid "" -"Event methods, such as :meth:`loop.create_server`, :meth:`loop." -"create_unix_server`, :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.connect_accepted_socket`, :meth:`loop." -"connect_read_pipe`, and :meth:`loop.connect_write_pipe` accept factories " -"that return streaming protocols." +"Event methods, such " +"as :meth:`loop.create_server`, :meth:`loop.create_unix_server`, :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.connect_accepted_socket`, :meth:`loop.connect_read_pipe`, " +"and :meth:`loop.connect_write_pipe` accept factories that return streaming " +"protocols." msgstr "" msgid "" @@ -711,16 +711,16 @@ msgid "*nbytes* is the total number of bytes that were written to the buffer." msgstr "" msgid "" -"See the documentation of the :meth:`protocol.eof_received() ` method." +"See the documentation of the :meth:`protocol.eof_received() " +"` method." msgstr "" msgid "" ":meth:`~BufferedProtocol.get_buffer` can be called an arbitrary number of " "times during a connection. However, :meth:`protocol.eof_received() " -"` is called at most once and, if called, :meth:" -"`~BufferedProtocol.get_buffer` and :meth:`~BufferedProtocol.buffer_updated` " -"won't be called after it." +"` is called at most once and, if " +"called, :meth:`~BufferedProtocol.get_buffer` " +"and :meth:`~BufferedProtocol.buffer_updated` won't be called after it." msgstr "" msgid "" @@ -747,8 +747,8 @@ msgid "" msgstr "" msgid "" -"Called when a previous send or receive operation raises an :class:" -"`OSError`. *exc* is the :class:`OSError` instance." +"Called when a previous send or receive operation raises " +"an :class:`OSError`. *exc* is the :class:`OSError` instance." msgstr "" msgid "" @@ -764,10 +764,10 @@ msgid "" msgstr "" msgid "" -"The socket always appears 'ready' and excess packets are dropped. An :class:" -"`OSError` with ``errno`` set to :const:`errno.ENOBUFS` may or may not be " -"raised; if it is raised, it will be reported to :meth:`DatagramProtocol." -"error_received` but otherwise ignored." +"The socket always appears 'ready' and excess packets are dropped. " +"An :class:`OSError` with ``errno`` set to :const:`errno.ENOBUFS` may or may " +"not be raised; if it is raised, it will be reported " +"to :meth:`DatagramProtocol.error_received` but otherwise ignored." msgstr "" msgid "Subprocess Protocols" @@ -800,8 +800,8 @@ msgid "Called when the child process has exited." msgstr "" msgid "" -"It can be called before :meth:`~SubprocessProtocol.pipe_data_received` and :" -"meth:`~SubprocessProtocol.pipe_connection_lost` methods." +"It can be called before :meth:`~SubprocessProtocol.pipe_data_received` " +"and :meth:`~SubprocessProtocol.pipe_connection_lost` methods." msgstr "" msgid "Examples" @@ -1078,8 +1078,8 @@ msgstr "" msgid "" "The :ref:`watch a file descriptor for read events " -"` example uses the low-level :meth:`loop." -"add_reader` method to register an FD." +"` example uses the low-" +"level :meth:`loop.add_reader` method to register an FD." msgstr "" msgid "" diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po index 8fe250c842..d56c45542e 100644 --- a/library/asyncio-queue.po +++ b/library/asyncio-queue.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,8 +36,8 @@ msgid "" msgstr "" msgid "" -"Note that methods of asyncio queues don't have a *timeout* parameter; use :" -"func:`asyncio.wait_for` function to do queue operations with a timeout." +"Note that methods of asyncio queues don't have a *timeout* parameter; " +"use :func:`asyncio.wait_for` function to do queue operations with a timeout." msgstr "" msgid "See also the `Examples`_ section below." @@ -76,8 +76,8 @@ msgid "Return ``True`` if there are :attr:`maxsize` items in the queue." msgstr "" msgid "" -"If the queue was initialized with ``maxsize=0`` (the default), then :meth:" -"`full` never returns ``True``." +"If the queue was initialized with ``maxsize=0`` (the default), " +"then :meth:`full` never returns ``True``." msgstr "" msgid "" @@ -94,15 +94,19 @@ msgid "" "Return an item if one is immediately available, else raise :exc:`QueueEmpty`." msgstr "" +msgid "" +"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty." +msgstr "" + msgid "Block until all items in the queue have been received and processed." msgstr "" msgid "" "The count of unfinished tasks goes up whenever an item is added to the " -"queue. The count goes down whenever a consumer coroutine calls :meth:" -"`task_done` to indicate that the item was retrieved and all work on it is " -"complete. When the count of unfinished tasks drops to zero, :meth:`join` " -"unblocks." +"queue. The count goes down whenever a consumer coroutine " +"calls :meth:`task_done` to indicate that the item was retrieved and all work " +"on it is complete. When the count of unfinished tasks drops to " +"zero, :meth:`join` unblocks." msgstr "" msgid "" @@ -126,9 +130,10 @@ msgid "Put a :class:`Queue` instance into a shutdown mode." msgstr "" msgid "" -"The queue can no longer grow. Future calls to :meth:`~Queue.put` raise :exc:" -"`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` will be " -"unblocked and will raise :exc:`QueueShutDown` in the formerly awaiting task." +"The queue can no longer grow. Future calls to :meth:`~Queue.put` " +"raise :exc:`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` " +"will be unblocked and will raise :exc:`QueueShutDown` in the formerly " +"awaiting task." msgstr "" msgid "" @@ -142,17 +147,17 @@ msgid "" msgstr "" msgid "" -"Once the queue is empty, future calls to :meth:`~Queue.get` will raise :exc:" -"`QueueShutDown`." +"Once the queue is empty, future calls to :meth:`~Queue.get` will " +"raise :exc:`QueueShutDown`." msgstr "" msgid "" "If *immediate* is true, the queue is terminated immediately. The queue is " "drained to be completely empty and the count of unfinished tasks is reduced " -"by the number of tasks drained. If unfinished tasks is zero, callers of :" -"meth:`~Queue.join` are unblocked. Also, blocked callers of :meth:`~Queue." -"get` are unblocked and will raise :exc:`QueueShutDown` because the queue is " -"empty." +"by the number of tasks drained. If unfinished tasks is zero, callers " +"of :meth:`~Queue.join` are unblocked. Also, blocked callers " +"of :meth:`~Queue.get` are unblocked and will raise :exc:`QueueShutDown` " +"because the queue is empty." msgstr "" msgid "" @@ -214,8 +219,9 @@ msgid "" msgstr "" msgid "" -"Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on " -"a queue which has been shut down." +"Exception raised " +"when :meth:`~Queue.put`, :meth:`~Queue.put_nowait`, :meth:`~Queue.get` " +"or :meth:`~Queue.get_nowait` is called on a queue which has been shut down." msgstr "" msgid "Examples" diff --git a/library/asyncio-runner.po b/library/asyncio-runner.po index fafc9ef81e..c5aa0f000c 100644 --- a/library/asyncio-runner.po +++ b/library/asyncio-runner.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -59,8 +59,8 @@ msgstr "" msgid "" "If *debug* is ``True``, the event loop will be run in debug mode. ``False`` " -"disables debug mode explicitly. ``None`` is used to respect the global :ref:" -"`asyncio-debug-mode` settings." +"disables debug mode explicitly. ``None`` is used to respect the " +"global :ref:`asyncio-debug-mode` settings." msgstr "" msgid "" @@ -68,8 +68,9 @@ msgid "" "otherwise :func:`asyncio.new_event_loop` is used. The loop is closed at the " "end. This function should be used as a main entry point for asyncio " "programs, and should ideally only be called once. It is recommended to use " -"*loop_factory* to configure the event loop instead of policies. Passing :" -"class:`asyncio.EventLoop` allows running asyncio without the policy system." +"*loop_factory* to configure the event loop instead of policies. " +"Passing :class:`asyncio.EventLoop` allows running asyncio without the policy " +"system." msgstr "" msgid "" @@ -117,8 +118,8 @@ msgid "" msgstr "" msgid "" -"Sometimes several top-level async functions should be called in the same :" -"ref:`event loop ` and :class:`contextvars.Context`." +"Sometimes several top-level async functions should be called in the " +"same :ref:`event loop ` and :class:`contextvars.Context`." msgstr "" msgid "" @@ -149,9 +150,9 @@ msgid "If the argument is a coroutine, it is wrapped in a Task." msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the code to run in. The runner's default " -"context is used if context is ``None``." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the code to run in. The runner's " +"default context is used if context is ``None``." msgstr "" msgid "Returns the awaitable's result or raises an exception." @@ -182,10 +183,10 @@ msgid "Handling Keyboard Interruption" msgstr "" msgid "" -"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-C`, :exc:" -"`KeyboardInterrupt` exception is raised in the main thread by default. " -"However this doesn't work with :mod:`asyncio` because it can interrupt " -"asyncio internals and can hang the program from exiting." +"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-" +"C`, :exc:`KeyboardInterrupt` exception is raised in the main thread by " +"default. However this doesn't work with :mod:`asyncio` because it can " +"interrupt asyncio internals and can hang the program from exiting." msgstr "" msgid "" @@ -209,13 +210,13 @@ msgid "" "handler cancels the main task by calling :meth:`asyncio.Task.cancel` which " "raises :exc:`asyncio.CancelledError` inside the main task. This causes the " "Python stack to unwind, ``try/except`` and ``try/finally`` blocks can be " -"used for resource cleanup. After the main task is cancelled, :meth:`asyncio." -"Runner.run` raises :exc:`KeyboardInterrupt`." +"used for resource cleanup. After the main task is " +"cancelled, :meth:`asyncio.Runner.run` raises :exc:`KeyboardInterrupt`." msgstr "" msgid "" -"A user could write a tight loop which cannot be interrupted by :meth:" -"`asyncio.Task.cancel`, in which case the second following :kbd:`Ctrl-C` " -"immediately raises the :exc:`KeyboardInterrupt` without cancelling the main " -"task." +"A user could write a tight loop which cannot be interrupted " +"by :meth:`asyncio.Task.cancel`, in which case the second " +"following :kbd:`Ctrl-C` immediately raises the :exc:`KeyboardInterrupt` " +"without cancelling the main task." msgstr "" diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index 871b70871c..bd375d8a9d 100644 --- a/library/asyncio-stream.po +++ b/library/asyncio-stream.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -76,24 +76,25 @@ msgid "" msgstr "" msgid "" -"The returned *reader* and *writer* objects are instances of :class:" -"`StreamReader` and :class:`StreamWriter` classes." +"The returned *reader* and *writer* objects are instances " +"of :class:`StreamReader` and :class:`StreamWriter` classes." msgstr "" msgid "" -"*limit* determines the buffer size limit used by the returned :class:" -"`StreamReader` instance. By default the *limit* is set to 64 KiB." +"*limit* determines the buffer size limit used by the " +"returned :class:`StreamReader` instance. By default the *limit* is set to " +"64 KiB." msgstr "" msgid "" -"The rest of the arguments are passed directly to :meth:`loop." -"create_connection`." +"The rest of the arguments are passed directly " +"to :meth:`loop.create_connection`." msgstr "" msgid "" -"The *sock* argument transfers ownership of the socket to the :class:" -"`StreamWriter` created. To close the socket, call its :meth:`~asyncio." -"StreamWriter.close` method." +"The *sock* argument transfers ownership of the socket to " +"the :class:`StreamWriter` created. To close the socket, call " +"its :meth:`~asyncio.StreamWriter.close` method." msgstr "" msgid "Added the *ssl_handshake_timeout* parameter." @@ -188,13 +189,13 @@ msgstr "" msgid "" "Represents a reader object that provides APIs to read data from the IO " -"stream. As an :term:`asynchronous iterable`, the object supports the :" -"keyword:`async for` statement." +"stream. As an :term:`asynchronous iterable`, the object supports " +"the :keyword:`async for` statement." msgstr "" msgid "" -"It is not recommended to instantiate *StreamReader* objects directly; use :" -"func:`open_connection` and :func:`start_server` instead." +"It is not recommended to instantiate *StreamReader* objects directly; " +"use :func:`open_connection` and :func:`start_server` instead." msgstr "" msgid "Acknowledge the EOF." @@ -250,15 +251,15 @@ msgid "" msgstr "" msgid "" -"If the amount of data read exceeds the configured stream limit, a :exc:" -"`LimitOverrunError` exception is raised, and the data is left in the " +"If the amount of data read exceeds the configured stream limit, " +"a :exc:`LimitOverrunError` exception is raised, and the data is left in the " "internal buffer and can be read again." msgstr "" msgid "" -"If EOF is reached before the complete separator is found, an :exc:" -"`IncompleteReadError` exception is raised, and the internal buffer is " -"reset. The :attr:`IncompleteReadError.partial` attribute may contain a " +"If EOF is reached before the complete separator is found, " +"an :exc:`IncompleteReadError` exception is raised, and the internal buffer " +"is reset. The :attr:`IncompleteReadError.partial` attribute may contain a " "portion of the separator." msgstr "" @@ -283,8 +284,8 @@ msgid "" msgstr "" msgid "" -"It is not recommended to instantiate *StreamWriter* objects directly; use :" -"func:`open_connection` and :func:`start_server` instead." +"It is not recommended to instantiate *StreamWriter* objects directly; " +"use :func:`open_connection` and :func:`start_server` instead." msgstr "" msgid "" @@ -343,8 +344,8 @@ msgid "Return the underlying asyncio transport." msgstr "" msgid "" -"Access optional transport information; see :meth:`BaseTransport." -"get_extra_info` for details." +"Access optional transport information; " +"see :meth:`BaseTransport.get_extra_info` for details." msgstr "" msgid "Wait until it is appropriate to resume writing to the stream. Example::" @@ -359,8 +360,16 @@ msgid "" "This is a flow control method that interacts with the underlying IO write " "buffer. When the size of the buffer reaches the high watermark, *drain()* " "blocks until the size of the buffer is drained down to the low watermark and " -"writing can be resumed. When there is nothing to wait for, the :meth:" -"`drain` returns immediately." +"writing can be resumed. When there is nothing to wait for, " +"the :meth:`drain` returns immediately." +msgstr "" + +msgid "" +"When the write buffer is below the high watermark, :meth:`drain` returns " +"immediately without yielding to the event loop. As a result, code which " +"repeatedly calls ``write()`` followed by ``await drain()`` may prevent other " +"tasks from running. To prevent blocking behavior, yield to the event loop " +"explicitly with ``await asyncio.sleep(0)`` (see :func:`asyncio.sleep`)." msgstr "" msgid "Upgrade an existing stream-based connection to TLS." @@ -389,6 +398,11 @@ msgid "" "(default)." msgstr "" +msgid "" +"Raises a ``ValueError`` if ``sslcontext.check_hostname`` is ``True`` and " +"``server_hostname`` is not supplied." +msgstr "" + msgid "" "Return ``True`` if the stream is closed or in the process of being closed." msgstr "" @@ -413,8 +427,8 @@ msgstr "" msgid "" "The :ref:`TCP echo client protocol " -"` example uses the low-level :meth:" -"`loop.create_connection` method." +"` example uses the low-" +"level :meth:`loop.create_connection` method." msgstr "" msgid "TCP echo server using streams" @@ -456,8 +470,8 @@ msgstr "" msgid "" "The :ref:`TCP echo server protocol " -"` example uses the :meth:`loop." -"create_server` method." +"` example uses " +"the :meth:`loop.create_server` method." msgstr "" msgid "Get HTTP headers" @@ -521,8 +535,8 @@ msgid "Register an open socket to wait for data using streams" msgstr "" msgid "" -"Coroutine waiting until a socket receives data using the :func:" -"`open_connection` function::" +"Coroutine waiting until a socket receives data using " +"the :func:`open_connection` function::" msgstr "" msgid "" @@ -565,6 +579,6 @@ msgstr "" msgid "" "The :ref:`watch a file descriptor for read events " -"` example uses the low-level :meth:`loop." -"add_reader` method to watch a file descriptor." +"` example uses the low-" +"level :meth:`loop.add_reader` method to watch a file descriptor." msgstr "" diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index 2acb21c93b..c8cf4c02d1 100644 --- a/library/asyncio-subprocess.po +++ b/library/asyncio-subprocess.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -99,9 +99,9 @@ msgstr "" msgid "" "The *limit* argument sets the buffer limit for :class:`StreamReader` " -"wrappers for :attr:`~asyncio.subprocess.Process.stdout` and :attr:`~asyncio." -"subprocess.Process.stderr` (if :const:`subprocess.PIPE` is passed to " -"*stdout* and *stderr* arguments)." +"wrappers for :attr:`~asyncio.subprocess.Process.stdout` " +"and :attr:`~asyncio.subprocess.Process.stderr` (if :const:`subprocess.PIPE` " +"is passed to *stdout* and *stderr* arguments)." msgstr "" msgid "Return a :class:`~asyncio.subprocess.Process` instance." @@ -142,11 +142,10 @@ msgid "" msgstr "" msgid "" -"asyncio also has the following *low-level* APIs to work with subprocesses: :" -"meth:`loop.subprocess_exec`, :meth:`loop.subprocess_shell`, :meth:`loop." -"connect_read_pipe`, :meth:`loop.connect_write_pipe`, as well as the :ref:" -"`Subprocess Transports ` and :ref:`Subprocess " -"Protocols `." +"asyncio also has the following *low-level* APIs to work with " +"subprocesses: :meth:`loop.subprocess_exec`, :meth:`loop.subprocess_shell`, :meth:`loop.connect_read_pipe`, :meth:`loop.connect_write_pipe`, " +"as well as the :ref:`Subprocess Transports ` " +"and :ref:`Subprocess Protocols `." msgstr "" msgid "Constants" @@ -156,16 +155,16 @@ msgid "Can be passed to the *stdin*, *stdout* or *stderr* parameters." msgstr "" msgid "" -"If *PIPE* is passed to *stdin* argument, the :attr:`Process.stdin ` attribute will point to a :class:`~asyncio." -"StreamWriter` instance." +"If *PIPE* is passed to *stdin* argument, the :attr:`Process.stdin " +"` attribute will point to " +"a :class:`~asyncio.StreamWriter` instance." msgstr "" msgid "" -"If *PIPE* is passed to *stdout* or *stderr* arguments, the :attr:`Process." -"stdout ` and :attr:`Process.stderr " -"` attributes will point to :class:" -"`~asyncio.StreamReader` instances." +"If *PIPE* is passed to *stdout* or *stderr* arguments, " +"the :attr:`Process.stdout ` " +"and :attr:`Process.stderr ` attributes " +"will point to :class:`~asyncio.StreamReader` instances." msgstr "" msgid "" @@ -175,8 +174,8 @@ msgstr "" msgid "" "Special value that can be used as the *stdin*, *stdout* or *stderr* argument " -"to process creation functions. It indicates that the special file :data:`os." -"devnull` will be used for the corresponding subprocess stream." +"to process creation functions. It indicates that the special " +"file :data:`os.devnull` will be used for the corresponding subprocess stream." msgstr "" msgid "Interacting with Subprocesses" @@ -190,25 +189,25 @@ msgid "" msgstr "" msgid "" -"An object that wraps OS processes created by the :func:`~asyncio." -"create_subprocess_exec` and :func:`~asyncio.create_subprocess_shell` " -"functions." +"An object that wraps OS processes created by " +"the :func:`~asyncio.create_subprocess_exec` " +"and :func:`~asyncio.create_subprocess_shell` functions." msgstr "" msgid "" -"This class is designed to have a similar API to the :class:`subprocess." -"Popen` class, but there are some notable differences:" +"This class is designed to have a similar API to " +"the :class:`subprocess.Popen` class, but there are some notable differences:" msgstr "" msgid "" -"unlike Popen, Process instances do not have an equivalent to the :meth:" -"`~subprocess.Popen.poll` method;" +"unlike Popen, Process instances do not have an equivalent to " +"the :meth:`~subprocess.Popen.poll` method;" msgstr "" msgid "" -"the :meth:`~asyncio.subprocess.Process.communicate` and :meth:`~asyncio." -"subprocess.Process.wait` methods don't have a *timeout* parameter: use the :" -"func:`~asyncio.wait_for` function;" +"the :meth:`~asyncio.subprocess.Process.communicate` " +"and :meth:`~asyncio.subprocess.Process.wait` methods don't have a *timeout* " +"parameter: use the :func:`~asyncio.wait_for` function;" msgstr "" msgid "" @@ -345,9 +344,9 @@ msgid "Process identification number (PID)." msgstr "" msgid "" -"Note that for processes created by the :func:`~asyncio." -"create_subprocess_shell` function, this attribute is the PID of the spawned " -"shell." +"Note that for processes created by " +"the :func:`~asyncio.create_subprocess_shell` function, this attribute is the " +"PID of the spawned shell." msgstr "" msgid "Return code of the process when it exits." diff --git a/library/asyncio-sync.po b/library/asyncio-sync.po index 36f82ddbc4..d6e66a2a7f 100644 --- a/library/asyncio-sync.po +++ b/library/asyncio-sync.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -147,8 +147,8 @@ msgid "" msgstr "" msgid "" -"An Event object manages an internal flag that can be set to *true* with the :" -"meth:`~Event.set` method and reset to *false* with the :meth:`clear` " +"An Event object manages an internal flag that can be set to *true* with " +"the :meth:`~Event.set` method and reset to *false* with the :meth:`clear` " "method. The :meth:`~Event.wait` method blocks until the flag is set to " "*true*. The flag is set to *false* initially." msgstr "" @@ -197,8 +197,8 @@ msgid "Clear (unset) the event." msgstr "" msgid "" -"Subsequent tasks awaiting on :meth:`~Event.wait` will now block until the :" -"meth:`~Event.set` method is called again." +"Subsequent tasks awaiting on :meth:`~Event.wait` will now block until " +"the :meth:`~Event.set` method is called again." msgstr "" msgid "Return ``True`` if the event is set." @@ -216,11 +216,11 @@ msgid "" msgstr "" msgid "" -"In essence, a Condition object combines the functionality of an :class:" -"`Event` and a :class:`Lock`. It is possible to have multiple Condition " -"objects share one Lock, which allows coordinating exclusive access to a " -"shared resource between different tasks interested in particular states of " -"that shared resource." +"In essence, a Condition object combines the functionality of " +"an :class:`Event` and a :class:`Lock`. It is possible to have multiple " +"Condition objects share one Lock, which allows coordinating exclusive access " +"to a shared resource between different tasks interested in particular states " +"of that shared resource." msgstr "" msgid "" @@ -289,8 +289,8 @@ msgid "Wait until notified." msgstr "" msgid "" -"If the calling task has not acquired the lock when this method is called, a :" -"exc:`RuntimeError` is raised." +"If the calling task has not acquired the lock when this method is called, " +"a :exc:`RuntimeError` is raised." msgstr "" msgid "" @@ -301,9 +301,9 @@ msgstr "" msgid "" "Note that a task *may* return from this call spuriously, which is why the " -"caller should always re-check the state and be prepared to :meth:`~Condition." -"wait` again. For this reason, you may prefer to use :meth:`~Condition." -"wait_for` instead." +"caller should always re-check the state and be prepared " +"to :meth:`~Condition.wait` again. For this reason, you may prefer to " +"use :meth:`~Condition.wait_for` instead." msgstr "" msgid "Wait until a predicate becomes *true*." @@ -322,16 +322,16 @@ msgid "A Semaphore object. Not thread-safe." msgstr "" msgid "" -"A semaphore manages an internal counter which is decremented by each :meth:" -"`acquire` call and incremented by each :meth:`release` call. The counter can " -"never go below zero; when :meth:`acquire` finds that it is zero, it blocks, " -"waiting until some task calls :meth:`release`." +"A semaphore manages an internal counter which is decremented by " +"each :meth:`acquire` call and incremented by each :meth:`release` call. The " +"counter can never go below zero; when :meth:`acquire` finds that it is zero, " +"it blocks, waiting until some task calls :meth:`release`." msgstr "" msgid "" "The optional *value* argument gives the initial value for the internal " -"counter (``1`` by default). If the given value is less than ``0`` a :exc:" -"`ValueError` is raised." +"counter (``1`` by default). If the given value is less than ``0`` " +"a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -386,9 +386,9 @@ msgid "A bounded semaphore object. Not thread-safe." msgstr "" msgid "" -"Bounded Semaphore is a version of :class:`Semaphore` that raises a :exc:" -"`ValueError` in :meth:`~Semaphore.release` if it increases the internal " -"counter above the initial *value*." +"Bounded Semaphore is a version of :class:`Semaphore` that raises " +"a :exc:`ValueError` in :meth:`~Semaphore.release` if it increases the " +"internal counter above the initial *value*." msgstr "" msgid "Barrier" @@ -399,15 +399,15 @@ msgstr "" msgid "" "A barrier is a simple synchronization primitive that allows to block until " -"*parties* number of tasks are waiting on it. Tasks can wait on the :meth:" -"`~Barrier.wait` method and would be blocked until the specified number of " -"tasks end up waiting on :meth:`~Barrier.wait`. At that point all of the " -"waiting tasks would unblock simultaneously." +"*parties* number of tasks are waiting on it. Tasks can wait on " +"the :meth:`~Barrier.wait` method and would be blocked until the specified " +"number of tasks end up waiting on :meth:`~Barrier.wait`. At that point all " +"of the waiting tasks would unblock simultaneously." msgstr "" msgid "" -":keyword:`async with` can be used as an alternative to awaiting on :meth:" -"`~Barrier.wait`." +":keyword:`async with` can be used as an alternative to awaiting " +"on :meth:`~Barrier.wait`." msgstr "" msgid "The barrier can be reused any number of times." @@ -473,8 +473,8 @@ msgstr "" msgid "" "This method may raise a :class:`BrokenBarrierError` exception if the barrier " -"is broken or reset while a task is waiting. It could raise a :exc:" -"`CancelledError` if a task is cancelled." +"is broken or reset while a task is waiting. It could raise " +"a :exc:`CancelledError` if a task is cancelled." msgstr "" msgid "" @@ -504,12 +504,12 @@ msgid "A boolean that is ``True`` if the barrier is in the broken state." msgstr "" msgid "" -"This exception, a subclass of :exc:`RuntimeError`, is raised when the :class:" -"`Barrier` object is reset or broken." +"This exception, a subclass of :exc:`RuntimeError`, is raised when " +"the :class:`Barrier` object is reset or broken." msgstr "" msgid "" -"Acquiring a lock using ``await lock`` or ``yield from lock`` and/or :keyword:" -"`with` statement (``with await lock``, ``with (yield from lock)``) was " -"removed. Use ``async with lock`` instead." +"Acquiring a lock using ``await lock`` or ``yield from lock`` and/" +"or :keyword:`with` statement (``with await lock``, ``with (yield from " +"lock)``) was removed. Use ``async with lock`` instead." msgstr "" diff --git a/library/asyncio-task.po b/library/asyncio-task.po index dcdd5ec9d9..ab8f058f2a 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -151,8 +151,8 @@ msgid "" msgstr "" msgid "" -"The :class:`asyncio.TaskGroup` class provides a more modern alternative to :" -"func:`create_task`. Using this API, the last example becomes::" +"The :class:`asyncio.TaskGroup` class provides a more modern alternative " +"to :func:`create_task`. Using this API, the last example becomes::" msgstr "" msgid "" @@ -181,8 +181,8 @@ msgid "Awaitables" msgstr "" msgid "" -"We say that an object is an **awaitable** object if it can be used in an :" -"keyword:`await` expression. Many asyncio APIs are designed to accept " +"We say that an object is an **awaitable** object if it can be used in " +"an :keyword:`await` expression. Many asyncio APIs are designed to accept " "awaitables." msgstr "" @@ -233,8 +233,9 @@ msgid "*Tasks* are used to schedule coroutines *concurrently*." msgstr "" msgid "" -"When a coroutine is wrapped into a *Task* with functions like :func:`asyncio." -"create_task` the coroutine is automatically scheduled to run soon::" +"When a coroutine is wrapped into a *Task* with functions " +"like :func:`asyncio.create_task` the coroutine is automatically scheduled to " +"run soon::" msgstr "" msgid "" @@ -295,8 +296,8 @@ msgid "" msgstr "" msgid "" -"A good example of a low-level function that returns a Future object is :meth:" -"`loop.run_in_executor`." +"A good example of a low-level function that returns a Future object " +"is :meth:`loop.run_in_executor`." msgstr "" msgid "Creating tasks" @@ -317,21 +318,22 @@ msgid "" msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *coro* to run in. The current context " -"copy is created when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *coro* to run in. The current " +"context copy is created when no *context* is provided." msgstr "" msgid "" "An optional keyword-only *eager_start* argument allows specifying if the " "task should execute eagerly during the call to create_task, or be scheduled " -"later. If *eager_start* is not passed the mode set by :meth:`loop." -"set_task_factory` will be used." +"later. If *eager_start* is not passed the mode set " +"by :meth:`loop.set_task_factory` will be used." msgstr "" msgid "" -"The task is executed in the loop returned by :func:`get_running_loop`, :exc:" -"`RuntimeError` is raised if there is no running loop in current thread." +"The task is executed in the loop returned " +"by :func:`get_running_loop`, :exc:`RuntimeError` is raised if there is no " +"running loop in current thread." msgstr "" msgid "" @@ -363,6 +365,20 @@ msgid "" " task.add_done_callback(background_tasks.discard)" msgstr "" +msgid "" +"Note that this approach never awaits the tasks, so if a task fails, its " +"exception is never retrieved and asyncio logs a \"Task exception was never " +"retrieved\" message when the task is garbage collected. To avoid this, " +"use :class:`asyncio.TaskGroup` which keeps a strong reference to each task, " +"awaits them and propagates their exceptions::" +msgstr "" + +msgid "" +"async with asyncio.TaskGroup() as tg:\n" +" for i in range(10):\n" +" tg.create_task(some_coro(param=i))" +msgstr "" + msgid "Added the *name* parameter." msgstr "" @@ -376,26 +392,28 @@ msgid "Task cancellation" msgstr "" msgid "" -"Tasks can easily and safely be cancelled. When a task is cancelled, :exc:" -"`asyncio.CancelledError` will be raised in the task at the next opportunity." +"Tasks can easily and safely be cancelled. When a task is " +"cancelled, :exc:`asyncio.CancelledError` will be raised in the task at the " +"next opportunity." msgstr "" msgid "" "It is recommended that coroutines use ``try/finally`` blocks to robustly " "perform clean-up logic. In case :exc:`asyncio.CancelledError` is explicitly " -"caught, it should generally be propagated when clean-up is complete. :exc:" -"`asyncio.CancelledError` directly subclasses :exc:`BaseException` so most " -"code will not need to be aware of it." +"caught, it should generally be propagated when clean-up is " +"complete. :exc:`asyncio.CancelledError` directly " +"subclasses :exc:`BaseException` so most code will not need to be aware of it." msgstr "" msgid "" -"The asyncio components that enable structured concurrency, like :class:" -"`asyncio.TaskGroup` and :func:`asyncio.timeout`, are implemented using " -"cancellation internally and might misbehave if a coroutine swallows :exc:" -"`asyncio.CancelledError`. Similarly, user code should not generally call :" -"meth:`uncancel `. However, in cases when suppressing :" -"exc:`asyncio.CancelledError` is truly desired, it is necessary to also call " -"``uncancel()`` to completely remove the cancellation state." +"The asyncio components that enable structured concurrency, " +"like :class:`asyncio.TaskGroup` and :func:`asyncio.timeout`, are implemented " +"using cancellation internally and might misbehave if a coroutine " +"swallows :exc:`asyncio.CancelledError`. Similarly, user code should not " +"generally call :meth:`uncancel `. However, in cases " +"when suppressing :exc:`asyncio.CancelledError` is truly desired, it is " +"necessary to also call ``uncancel()`` to completely remove the cancellation " +"state." msgstr "" msgid "Task groups" @@ -413,10 +431,10 @@ msgid "" msgstr "" msgid "" -"Create a task in this task group. The signature matches that of :func:" -"`asyncio.create_task`. If the task group is inactive (e.g. not yet entered, " -"already finished, or in the process of shutting down), we will close the " -"given ``coro``." +"Create a task in this task group. The signature matches that " +"of :func:`asyncio.create_task`. If the task group is inactive (e.g. not yet " +"entered, already finished, or in the process of shutting down), we will " +"close the given ``coro`` and raise :exc:`RuntimeError`." msgstr "" msgid "Close the given coroutine if the task group is not active." @@ -433,8 +451,8 @@ msgid "" " async with asyncio.TaskGroup() as tg:\n" " task1 = tg.create_task(some_coro(...))\n" " task2 = tg.create_task(another_coro(...))\n" -" print(f\"Both tasks have completed now: {task1.result()}, {task2." -"result()}\")" +" print(f\"Both tasks have completed now: {task1.result()}, " +"{task2.result()}\")" msgstr "" msgid "" @@ -449,11 +467,11 @@ msgid "" "The first time any of the tasks belonging to the group fails with an " "exception other than :exc:`asyncio.CancelledError`, the remaining tasks in " "the group are cancelled. No further tasks can then be added to the group. At " -"this point, if the body of the ``async with`` statement is still active (i." -"e., :meth:`~object.__aexit__` hasn't been called yet), the task directly " -"containing the ``async with`` statement is also cancelled. The resulting :" -"exc:`asyncio.CancelledError` will interrupt an ``await``, but it will not " -"bubble out of the containing ``async with`` statement." +"this point, if the body of the ``async with`` statement is still active " +"(i.e., :meth:`~object.__aexit__` hasn't been called yet), the task directly " +"containing the ``async with`` statement is also cancelled. The " +"resulting :exc:`asyncio.CancelledError` will interrupt an ``await``, but it " +"will not bubble out of the containing ``async with`` statement." msgstr "" msgid "" @@ -464,22 +482,23 @@ msgid "" msgstr "" msgid "" -"Two base exceptions are treated specially: If any task fails with :exc:" -"`KeyboardInterrupt` or :exc:`SystemExit`, the task group still cancels the " -"remaining tasks and waits for them, but then the initial :exc:" -"`KeyboardInterrupt` or :exc:`SystemExit` is re-raised instead of :exc:" -"`ExceptionGroup` or :exc:`BaseExceptionGroup`." +"Two base exceptions are treated specially: If any task fails " +"with :exc:`KeyboardInterrupt` or :exc:`SystemExit`, the task group still " +"cancels the remaining tasks and waits for them, but then the " +"initial :exc:`KeyboardInterrupt` or :exc:`SystemExit` is re-raised instead " +"of :exc:`ExceptionGroup` or :exc:`BaseExceptionGroup`." msgstr "" msgid "" -"If the body of the ``async with`` statement exits with an exception (so :" -"meth:`~object.__aexit__` is called with an exception set), this is treated " -"the same as if one of the tasks failed: the remaining tasks are cancelled " -"and then waited for, and non-cancellation exceptions are grouped into an " -"exception group and raised. The exception passed into :meth:`~object." -"__aexit__`, unless it is :exc:`asyncio.CancelledError`, is also included in " -"the exception group. The same special case is made for :exc:" -"`KeyboardInterrupt` and :exc:`SystemExit` as in the previous paragraph." +"If the body of the ``async with`` statement exits with an exception " +"(so :meth:`~object.__aexit__` is called with an exception set), this is " +"treated the same as if one of the tasks failed: the remaining tasks are " +"cancelled and then waited for, and non-cancellation exceptions are grouped " +"into an exception group and raised. The exception passed " +"into :meth:`~object.__aexit__`, unless it is :exc:`asyncio.CancelledError`, " +"is also included in the exception group. The same special case is made " +"for :exc:`KeyboardInterrupt` and :exc:`SystemExit` as in the previous " +"paragraph." msgstr "" msgid "" @@ -494,14 +513,15 @@ msgstr "" msgid "" "In the case where a task group is cancelled externally and also must raise " -"an :exc:`ExceptionGroup`, it will call the parent task's :meth:`~asyncio." -"Task.cancel` method. This ensures that a :exc:`asyncio.CancelledError` will " -"be raised at the next :keyword:`await`, so the cancellation is not lost." +"an :exc:`ExceptionGroup`, it will call the parent " +"task's :meth:`~asyncio.Task.cancel` method. This ensures that " +"a :exc:`asyncio.CancelledError` will be raised at the next :keyword:`await`, " +"so the cancellation is not lost." msgstr "" msgid "" -"Task groups preserve the cancellation count reported by :meth:`asyncio.Task." -"cancelling`." +"Task groups preserve the cancellation count reported " +"by :meth:`asyncio.Task.cancelling`." msgstr "" msgid "" @@ -722,12 +742,12 @@ msgid "A task factory for eager task execution." msgstr "" msgid "" -"When using this factory (via :meth:`loop.set_task_factory(asyncio." -"eager_task_factory) `), coroutines begin execution " -"synchronously during :class:`Task` construction. Tasks are only scheduled on " -"the event loop if they block. This can be a performance improvement as the " -"overhead of loop scheduling is avoided for coroutines that complete " -"synchronously." +"When using this factory " +"(via :meth:`loop.set_task_factory(asyncio.eager_task_factory) " +"`), coroutines begin execution synchronously " +"during :class:`Task` construction. Tasks are only scheduled on the event " +"loop if they block. This can be a performance improvement as the overhead of " +"loop scheduling is avoided for coroutines that complete synchronously." msgstr "" msgid "" @@ -751,22 +771,22 @@ msgstr "" msgid "" "*custom_task_constructor* must be a *callable* with the signature matching " -"the signature of :class:`Task.__init__ `. The callable must return a :" -"class:`asyncio.Task`-compatible object." +"the signature of :class:`Task.__init__ `. The callable must return " +"a :class:`asyncio.Task`-compatible object." msgstr "" msgid "" "This function returns a *callable* intended to be used as a task factory of " -"an event loop via :meth:`loop.set_task_factory(factory) `)." +"an event loop via :meth:`loop.set_task_factory(factory) " +"`)." msgstr "" msgid "Shielding from cancellation" msgstr "" msgid "" -"Protect an :ref:`awaitable object ` from being :meth:" -"`cancelled `." +"Protect an :ref:`awaitable object ` from " +"being :meth:`cancelled `." msgstr "" msgid "If *aw* is a coroutine it is automatically scheduled as a Task." @@ -790,8 +810,8 @@ msgid "" "*except* that if the coroutine containing it is cancelled, the Task running " "in ``something()`` is not cancelled. From the point of view of " "``something()``, the cancellation did not happen. Although its caller is " -"still cancelled, so the \"await\" expression still raises a :exc:" -"`CancelledError`." +"still cancelled, so the \"await\" expression still raises " +"a :exc:`CancelledError`." msgstr "" msgid "" @@ -840,8 +860,8 @@ msgid "" msgstr "" msgid "" -"In either case, the context manager can be rescheduled after creation using :" -"meth:`Timeout.reschedule`." +"In either case, the context manager can be rescheduled after creation " +"using :meth:`Timeout.reschedule`." msgstr "" msgid "" @@ -852,15 +872,15 @@ msgstr "" msgid "" "If ``long_running_task`` takes more than 10 seconds to complete, the context " -"manager will cancel the current task and handle the resulting :exc:`asyncio." -"CancelledError` internally, transforming it into a :exc:`TimeoutError` which " -"can be caught and handled." +"manager will cancel the current task and handle the " +"resulting :exc:`asyncio.CancelledError` internally, transforming it into " +"a :exc:`TimeoutError` which can be caught and handled." msgstr "" msgid "" -"The :func:`asyncio.timeout` context manager is what transforms the :exc:" -"`asyncio.CancelledError` into a :exc:`TimeoutError`, which means the :exc:" -"`TimeoutError` can only be caught *outside* of the context manager." +"The :func:`asyncio.timeout` context manager is what transforms " +"the :exc:`asyncio.CancelledError` into a :exc:`TimeoutError`, which means " +"the :exc:`TimeoutError` can only be caught *outside* of the context manager." msgstr "" msgid "Example of catching :exc:`TimeoutError`::" @@ -963,13 +983,10 @@ msgid "" "for. If *timeout* is ``None``, block until the future completes." msgstr "" -msgid "" -"If a timeout occurs, it cancels the task and raises :exc:`TimeoutError`." +msgid "If a timeout occurs, it cancels *aw* and raises :exc:`TimeoutError`." msgstr "" -msgid "" -"To avoid the task :meth:`cancellation `, wrap it in :func:" -"`shield`." +msgid "To prevent *aw* from being cancelled, wrap it in :func:`shield`." msgstr "" msgid "" @@ -1009,6 +1026,11 @@ msgstr "" msgid "Raises :exc:`TimeoutError` instead of :exc:`asyncio.TimeoutError`." msgstr "" +msgid "" +"Implemented using :func:`asyncio.timeout`, a coroutine passed as *aw* is no " +"longer wrapped in a :class:`Task` when *timeout* is positive." +msgstr "" + msgid "Waiting primitives" msgstr "" @@ -1057,8 +1079,8 @@ msgstr "" msgid "" "The function will return when any future finishes by raising an exception. " -"If no future raises an exception then it is equivalent to :const:" -"`ALL_COMPLETED`." +"If no future raises an exception then it is equivalent " +"to :const:`ALL_COMPLETED`." msgstr "" msgid "The function will return when all futures finish or are cancelled." @@ -1069,6 +1091,11 @@ msgid "" "when a timeout occurs." msgstr "" +msgid "" +"If ``wait()`` is cancelled, the futures in *aws* are not cancelled and " +"continue to run." +msgstr "" + msgid "Passing coroutine objects to ``wait()`` directly is forbidden." msgstr "" @@ -1082,11 +1109,11 @@ msgid "" msgstr "" msgid "" -"The object returned by ``as_completed()`` can be iterated as an :term:" -"`asynchronous iterator` or a plain :term:`iterator`. When asynchronous " -"iteration is used, the originally-supplied awaitables are yielded if they " -"are tasks or futures. This makes it easy to correlate previously-scheduled " -"tasks with their results. Example::" +"The object returned by ``as_completed()`` can be iterated as " +"an :term:`asynchronous iterator` or a plain :term:`iterator`. When " +"asynchronous iteration is used, the originally-supplied awaitables are " +"yielded if they are tasks or futures. This makes it easy to correlate " +"previously-scheduled tasks with their results. Example::" msgstr "" msgid "" @@ -1134,6 +1161,12 @@ msgid "" "iteration or by the coroutines yielded during plain iteration." msgstr "" +msgid "" +"``as_completed()`` does not cancel the tasks running the supplied " +"awaitables: if a timeout occurs or the iteration is cancelled, the remaining " +"tasks continue to run." +msgstr "" + msgid "" "Deprecation warning is emitted if not all awaitable objects in the *aws* " "iterable are Future-like objects and there is no running event loop." @@ -1373,20 +1406,20 @@ msgstr "" msgid "" ":meth:`cancelled` can be used to check if the Task was cancelled. The method " -"returns ``True`` if the wrapped coroutine did not suppress the :exc:" -"`CancelledError` exception and was actually cancelled." +"returns ``True`` if the wrapped coroutine did not suppress " +"the :exc:`CancelledError` exception and was actually cancelled." msgstr "" msgid "" -":class:`asyncio.Task` inherits from :class:`Future` all of its APIs except :" -"meth:`Future.set_result` and :meth:`Future.set_exception`." +":class:`asyncio.Task` inherits from :class:`Future` all of its APIs " +"except :meth:`Future.set_result` and :meth:`Future.set_exception`." msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *coro* to run in. If no *context* is " -"provided, the Task copies the current context and later runs its coroutine " -"in the copied context." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *coro* to run in. If no " +"*context* is provided, the Task copies the current context and later runs " +"its coroutine in the copied context." msgstr "" msgid "" @@ -1398,6 +1431,11 @@ msgid "" "eagerly and will skip scheduling to the event loop." msgstr "" +msgid "" +"Tasks are :ref:`generic ` over the return type of their wrapped " +"coroutines." +msgstr "" + msgid "Added support for the :mod:`contextvars` module." msgstr "" @@ -1431,8 +1469,8 @@ msgid "" msgstr "" msgid "" -"If the Task's result isn't yet available, this method raises an :exc:" -"`InvalidStateError` exception." +"If the Task's result isn't yet available, this method raises " +"an :exc:`InvalidStateError` exception." msgstr "" msgid "Return the exception of the Task." @@ -1537,8 +1575,8 @@ msgid "" msgstr "" msgid "" -"In the default Task implementation, the name will be visible in the :func:" -"`repr` output of a task object." +"In the default Task implementation, the name will be visible in " +"the :func:`repr` output of a task object." msgstr "" msgid "Request the Task to be cancelled." @@ -1557,12 +1595,12 @@ msgstr "" msgid "" "The coroutine then has a chance to clean up or even deny the request by " "suppressing the exception with a :keyword:`try` ... ... ``except " -"CancelledError`` ... :keyword:`finally` block. Therefore, unlike :meth:" -"`Future.cancel`, :meth:`Task.cancel` does not guarantee that the Task will " -"be cancelled, although suppressing cancellation completely is not common and " -"is actively discouraged. Should the coroutine nevertheless decide to " -"suppress the cancellation, it needs to call :meth:`Task.uncancel` in " -"addition to catching the exception." +"CancelledError`` ... :keyword:`finally` block. Therefore, " +"unlike :meth:`Future.cancel`, :meth:`Task.cancel` does not guarantee that " +"the Task will be cancelled, although suppressing cancellation completely is " +"not common and is actively discouraged. Should the coroutine nevertheless " +"decide to suppress the cancellation, it needs to call :meth:`Task.uncancel` " +"in addition to catching the exception." msgstr "" msgid "Added the *msg* parameter." @@ -1616,9 +1654,9 @@ msgid "Return ``True`` if the Task is *cancelled*." msgstr "" msgid "" -"The Task is *cancelled* when the cancellation was requested with :meth:" -"`cancel` and the wrapped coroutine propagated the :exc:`CancelledError` " -"exception thrown into it." +"The Task is *cancelled* when the cancellation was requested " +"with :meth:`cancel` and the wrapped coroutine propagated " +"the :exc:`CancelledError` exception thrown into it." msgstr "" msgid "Decrement the count of cancellation requests to this Task." @@ -1628,16 +1666,16 @@ msgid "Returns the remaining number of cancellation requests." msgstr "" msgid "" -"Note that once execution of a cancelled task completed, further calls to :" -"meth:`uncancel` are ineffective." +"Note that once execution of a cancelled task completed, further calls " +"to :meth:`uncancel` are ineffective." msgstr "" msgid "" "This method is used by asyncio's internals and isn't expected to be used by " "end-user code. In particular, if a Task gets successfully uncancelled, this " -"allows for elements of structured concurrency like :ref:`taskgroups` and :" -"func:`asyncio.timeout` to continue running, isolating cancellation to the " -"respective structured block. For example::" +"allows for elements of structured concurrency like :ref:`taskgroups` " +"and :func:`asyncio.timeout` to continue running, isolating cancellation to " +"the respective structured block. For example::" msgstr "" msgid "" @@ -1656,22 +1694,22 @@ msgstr "" msgid "" "While the block with ``make_request()`` and ``make_another_request()`` might " "get cancelled due to the timeout, ``unrelated_code()`` should continue " -"running even in case of the timeout. This is implemented with :meth:" -"`uncancel`. :class:`TaskGroup` context managers use :func:`uncancel` in a " -"similar fashion." +"running even in case of the timeout. This is implemented " +"with :meth:`uncancel`. :class:`TaskGroup` context managers " +"use :func:`uncancel` in a similar fashion." msgstr "" msgid "" -"If end-user code is, for some reason, suppressing cancellation by catching :" -"exc:`CancelledError`, it needs to call this method to remove the " +"If end-user code is, for some reason, suppressing cancellation by " +"catching :exc:`CancelledError`, it needs to call this method to remove the " "cancellation state." msgstr "" msgid "" "When this method decrements the cancellation count to zero, the method " -"checks if a previous :meth:`cancel` call had arranged for :exc:" -"`CancelledError` to be thrown into the task. If it hasn't been thrown yet, " -"that arrangement will be rescinded (by resetting the internal " +"checks if a previous :meth:`cancel` call had arranged " +"for :exc:`CancelledError` to be thrown into the task. If it hasn't been " +"thrown yet, that arrangement will be rescinded (by resetting the internal " "``_must_cancel`` flag)." msgstr "" diff --git a/library/asyncio.po b/library/asyncio.po index 3d5a037813..712dbae952 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -4,18 +4,18 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Rafael Fontenelle , 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# Ciarbin , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,6 +28,9 @@ msgstr "" msgid "High-level APIs" msgstr "Wysokopoziomowe interfejsy API" +msgid "Introspection APIs" +msgstr "" + msgid "Low-level APIs" msgstr "niskopoziomowe interfejsy API" @@ -84,7 +87,7 @@ msgstr "" "kodu sieciowego." msgid ":ref:`a-conceptual-overview-of-asyncio`" -msgstr "" +msgstr ":ref:`a-conceptual-overview-of-asyncio`" msgid "Explanation of the fundamentals of asyncio." msgstr "" @@ -111,6 +114,18 @@ msgstr "" msgid ":ref:`synchronize ` concurrent code;" msgstr "" +msgid "For **introspection**, asyncio provides APIs and tools for:" +msgstr "" + +msgid "" +"inspecting the :ref:`async call graph ` of tasks and futures;" +msgstr "" + +msgid "" +"inspecting tasks in another running Python process with :ref:`command-line " +"tools `;" +msgstr "" + msgid "" "Additionally, there are **low-level** APIs for *library and framework " "developers* to:" @@ -118,9 +133,9 @@ msgstr "" msgid "" "create and manage :ref:`event loops `, which provide " -"asynchronous APIs for :ref:`networking `, running :ref:" -"`subprocesses `, handling :ref:`OS signals " -"`, etc;" +"asynchronous APIs for :ref:`networking `, " +"running :ref:`subprocesses `, handling :ref:`OS " +"signals `, etc;" msgstr "" msgid "" @@ -145,8 +160,8 @@ msgid "asyncio REPL" msgstr "" msgid "" -"You can experiment with an ``asyncio`` concurrent context in the :term:" -"`REPL`:" +"You can experiment with an ``asyncio`` concurrent context in " +"the :term:`REPL`:" msgstr "" msgid "" @@ -180,7 +195,7 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "The source code for asyncio can be found in :source:`Lib/asyncio/`." msgstr "" diff --git a/library/atexit.po b/library/atexit.po index 2d701d1de1..edb6491537 100644 --- a/library/atexit.po +++ b/library/atexit.po @@ -53,9 +53,9 @@ msgstr "" msgid "" "Register *func* as a function to be executed at termination. Any optional " -"arguments that are to be passed to *func* must be passed as arguments to :" -"func:`register`. It is possible to register the same function and arguments " -"more than once." +"arguments that are to be passed to *func* must be passed as arguments " +"to :func:`register`. It is possible to register the same function and " +"arguments more than once." msgstr "" msgid "" @@ -79,12 +79,13 @@ msgid "" msgstr "" msgid "" -"Remove *func* from the list of functions to be run at interpreter shutdown. :" -"func:`unregister` silently does nothing if *func* was not previously " -"registered. If *func* has been registered more than once, every occurrence " -"of that function in the :mod:`atexit` call stack will be removed. Equality " -"comparisons (``==``) are used internally during unregistration, so function " -"references do not need to have matching identities." +"Remove *func* from the list of functions to be run at interpreter " +"shutdown. :func:`unregister` silently does nothing if *func* was not " +"previously registered. If *func* has been registered more than once, every " +"occurrence of that function in the :mod:`atexit` call stack will be " +"removed. Equality comparisons (``==``) are used internally during " +"unregistration, so function references do not need to have matching " +"identities." msgstr "" msgid "Module :mod:`readline`" diff --git a/library/audit_events.po b/library/audit_events.po index 433a235d8e..867a3968c7 100644 --- a/library/audit_events.po +++ b/library/audit_events.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,9 +27,9 @@ msgid "Audit events table" msgstr "" msgid "" -"This table contains all events raised by :func:`sys.audit` or :c:func:" -"`PySys_Audit` calls throughout the CPython runtime and the standard " -"library. These calls were added in 3.8 or later (see :pep:`578`)." +"This table contains all events raised by :func:`sys.audit` " +"or :c:func:`PySys_Audit` calls throughout the CPython runtime and the " +"standard library. These calls were added in 3.8 or later (see :pep:`578`)." msgstr "" msgid "" diff --git a/library/base64.po b/library/base64.po index 8daab3f91b..f12e349202 100644 --- a/library/base64.po +++ b/library/base64.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,25 +33,27 @@ msgid "" "This module provides functions for encoding binary data to printable ASCII " "characters and decoding such encodings back to binary data. This includes " "the :ref:`encodings specified in ` :rfc:`4648` (Base64, " -"Base32 and Base16) and the non-standard :ref:`Base85 encodings `." +"Base32 and Base16), the :ref:`Base85 encoding ` specified in " +"`PDF 2.0 `_, and non-standard " +"variants of Base85 used elsewhere." msgstr "" msgid "" "There are two interfaces provided by this module. The modern interface " -"supports encoding :term:`bytes-like objects ` to ASCII :" -"class:`bytes`, and decoding :term:`bytes-like objects ` " -"or strings containing ASCII to :class:`bytes`. Both base-64 alphabets " -"defined in :rfc:`4648` (normal, and URL- and filesystem-safe) are supported." +"supports encoding :term:`bytes-like objects ` to " +"ASCII :class:`bytes`, and decoding :term:`bytes-like objects ` or strings containing ASCII to :class:`bytes`. Both base-64 " +"alphabets defined in :rfc:`4648` (normal, and URL- and filesystem-safe) are " +"supported." msgstr "" msgid "" "The :ref:`legacy interface ` does not support decoding from " "strings, but it does provide functions for encoding and decoding to and " "from :term:`file objects `. It only supports the Base64 " -"standard alphabet, and it adds newlines every 76 characters as per :rfc:" -"`2045`. Note that if you are looking for :rfc:`2045` support you probably " -"want to be looking at the :mod:`email` package instead." +"standard alphabet, and it adds newlines every 76 characters as " +"per :rfc:`2045`. Note that if you are looking for :rfc:`2045` support you " +"probably want to be looking at the :mod:`email` package instead." msgstr "" msgid "" @@ -116,8 +118,8 @@ msgid "" msgstr "" msgid "" -"For more information about the strict base64 check, see :func:`binascii." -"a2b_base64`" +"For more information about the strict base64 check, " +"see :func:`binascii.a2b_base64`" msgstr "" msgid "" @@ -144,8 +146,8 @@ msgstr "" msgid "" "Decode :term:`bytes-like object` or ASCII string *s* using the URL- and " "filesystem-safe alphabet, which substitutes ``-`` instead of ``+`` and ``_`` " -"instead of ``/`` in the standard Base64 alphabet, and return the decoded :" -"class:`bytes`." +"instead of ``/`` in the standard Base64 alphabet, and return the " +"decoded :class:`bytes`." msgstr "" msgid "" @@ -209,31 +211,42 @@ msgid "Base85 Encodings" msgstr "" msgid "" -"Base85 encoding is not formally specified but rather a de facto standard, " -"thus different systems perform the encoding differently." +"Base85 encoding is a family of algorithms which represent four bytes using " +"five ASCII characters. Originally implemented in the Unix ``btoa(1)`` " +"utility, a version of it was later adopted by Adobe in the PostScript " +"language and is standardized in PDF 2.0 (ISO 32000-2). This version, in both " +"its ``btoa`` and PDF variants, is implemented by :func:`a85encode`." msgstr "" msgid "" -"The :func:`a85encode` and :func:`b85encode` functions in this module are two " -"implementations of the de facto standard. You should call the function with " -"the Base85 implementation used by the software you intend to work with." +"A separate version, using a different output character set, was defined as " +"an April Fool's joke in :rfc:`1924` but is now used by Git and other " +"software. This version is implemented by :func:`b85encode`." msgstr "" msgid "" -"The two functions present in this module differ in how they handle the " -"following:" +"Finally, a third version, using yet another output character set designed " +"for safe inclusion in programming language strings, is defined by ZeroMQ and " +"implemented here by :func:`z85encode`." msgstr "" -msgid "Whether to include enclosing ``<~`` and ``~>`` markers" +msgid "" +"The functions present in this module differ in how they handle the following:" +msgstr "" + +msgid "Whether to include and expect enclosing ``<~`` and ``~>`` markers." msgstr "" -msgid "Whether to include newline characters" +msgid "Whether to fold the input into multiple lines." msgstr "" -msgid "The set of ASCII characters used for encoding" +msgid "The set of ASCII characters used for encoding." msgstr "" -msgid "Handling of null bytes" +msgid "Compact encodings of sequences of spaces and null bytes." +msgstr "" + +msgid "The encoding of zero-padding bytes applied to the input." msgstr "" msgid "" @@ -248,7 +261,7 @@ msgstr "" msgid "" "*foldspaces* is an optional flag that uses the special short sequence 'y' " "instead of 4 consecutive spaces (ASCII 0x20) as supported by 'btoa'. This " -"feature is not supported by the \"standard\" Ascii85 encoding." +"feature is not supported by the standard encoding used in PDF." msgstr "" msgid "" @@ -258,13 +271,17 @@ msgid "" msgstr "" msgid "" -"*pad* controls whether the input is padded to a multiple of 4 before " -"encoding. Note that the ``btoa`` implementation always pads." +"*pad* controls whether zero-padding applied to the end of the input is fully " +"retained in the output encoding, as done by ``btoa``, producing an exact " +"multiple of 5 bytes of output. This is not part of the standard encoding " +"used in PDF, as it does not preserve the length of the data." msgstr "" msgid "" "*adobe* controls whether the encoded byte sequence is framed with ``<~`` and " -"``~>``, which is used by the Adobe implementation." +"``~>``, as in a PostScript base-85 string literal. Note that while " +"ASCII85Decode streams in PDF documents *must* be terminated with ``~>``, " +"they *must not* use a leading ``<~``." msgstr "" msgid "" @@ -275,12 +292,13 @@ msgstr "" msgid "" "*foldspaces* is a flag that specifies whether the 'y' short sequence should " "be accepted as shorthand for 4 consecutive spaces (ASCII 0x20). This feature " -"is not supported by the \"standard\" Ascii85 encoding." +"is not supported by the standard Ascii85 encoding used in PDF and PostScript." msgstr "" msgid "" -"*adobe* controls whether the input sequence is in Adobe Ascii85 format (i.e. " -"is framed with <~ and ~>)." +"*adobe* controls whether the ``<~`` and ``~>`` markers are present. While " +"the leading ``<~`` is not required, the input must end with ``~>``, or " +"a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -295,26 +313,32 @@ msgid "" msgstr "" msgid "" -"If *pad* is true, the input is padded with ``b'\\0'`` so its length is a " -"multiple of 4 bytes before encoding." +"The input is padded with ``b'\\0'`` so its length is a multiple of 4 bytes " +"before encoding. If *pad* is true, all the resulting characters are " +"retained in the output, which will always be a multiple of 5 bytes, and thus " +"the length of the data may not be preserved on decoding." msgstr "" msgid "" "Decode the base85-encoded :term:`bytes-like object` or ASCII string *b* and " -"return the decoded :class:`bytes`. Padding is implicitly removed, if " -"necessary." +"return the decoded :class:`bytes`." msgstr "" msgid "" "Encode the :term:`bytes-like object` *s* using Z85 (as used in ZeroMQ) and " -"return the encoded :class:`bytes`. See `Z85 specification `_ for more information." +"return the encoded :class:`bytes`." +msgstr "" + +msgid "" +"The `ZeroMQ specification `_ requires the " +"length of Z85-encoded data to be a multiple of 5 bytes. To produce compliant " +"data frames, you must pad the input data to this function to a multiple of 4 " +"bytes." msgstr "" msgid "" "Decode the Z85-encoded :term:`bytes-like object` or ASCII string *s* and " -"return the decoded :class:`bytes`. See `Z85 specification `_ for more information." +"return the decoded :class:`bytes`." msgstr "" msgid "Legacy Interface" @@ -334,11 +358,12 @@ msgstr "" msgid "" "Encode the contents of the binary *input* file and write the resulting " -"base64 encoded data to the *output* file. *input* and *output* must be :term:" -"`file objects `. *input* will be read until ``input.read()`` " -"returns an empty bytes object. :func:`encode` inserts a newline character " -"(``b'\\n'``) after every 76 bytes of the output, as well as ensuring that " -"the output always ends with a newline, as per :rfc:`2045` (MIME)." +"base64 encoded data to the *output* file. *input* and *output* must " +"be :term:`file objects `. *input* will be read until " +"``input.read()`` returns an empty bytes object. :func:`encode` inserts a " +"newline character (``b'\\n'``) after every 76 bytes of the output, as well " +"as ensuring that the output always ends with a newline, as per :rfc:`2045` " +"(MIME)." msgstr "" msgid "" @@ -382,6 +407,25 @@ msgstr "" "Sekcja 5.2, \"Base64 Treść-Transfer-Kodowanie,\" dostarcza definicji " "kodowania base64." +msgid "" +"`ISO 32000-2 Portable document format - Part 2: PDF 2.0 `_" +msgstr "" + +msgid "" +"Section 7.4.3, \"ASCII85Decode Filter,\" provides the definition of the " +"Ascii85 encoding used in PDF and PostScript, including the output character " +"set and the details of data length preservation using zero-padding and " +"partial output groups." +msgstr "" + +msgid "`ZeroMQ RFC 32/Z85 `_" +msgstr "" + +msgid "" +"The \"Formal Specification\" section provides the character set used in Z85." +msgstr "" + msgid "base64" msgstr "" diff --git a/library/bdb.po b/library/bdb.po index 500a138c6e..588f00644c 100644 --- a/library/bdb.po +++ b/library/bdb.po @@ -65,10 +65,10 @@ msgstr "" msgid "" "When creating a breakpoint, its associated :attr:`file name ` should " -"be in canonical form. If a :attr:`funcname` is defined, a breakpoint :attr:" -"`hit ` will be counted when the first line of that function is " -"executed. A :attr:`conditional ` breakpoint always counts a :attr:" -"`hit `." +"be in canonical form. If a :attr:`funcname` is defined, a " +"breakpoint :attr:`hit ` will be counted when the first line of that " +"function is executed. A :attr:`conditional ` breakpoint always counts " +"a :attr:`hit `." msgstr "" msgid ":class:`Breakpoint` instances have the following methods:" @@ -146,8 +146,8 @@ msgid "Numeric index for a single instance of a :class:`Breakpoint`." msgstr "" msgid "" -"Dictionary of :class:`Breakpoint` instances indexed by (:attr:`file`, :attr:" -"`line`) tuples." +"Dictionary of :class:`Breakpoint` instances indexed by " +"(:attr:`file`, :attr:`line`) tuples." msgstr "" msgid "Number of times to ignore a :class:`Breakpoint`." @@ -161,8 +161,8 @@ msgstr "Клас :class:`Bdb` діє як загальний базовий кл msgid "" "This class takes care of the details of the trace facility; a derived class " -"should implement user interaction. The standard debugger class (:class:`pdb." -"Pdb`) is an example." +"should implement user interaction. The standard debugger class " +"(:class:`pdb.Pdb`) is an example." msgstr "" "Цей клас піклується про деталі засобу трасування; похідний клас повинен " "реалізовувати взаємодію з користувачем. Прикладом є стандартний клас " @@ -183,13 +183,13 @@ msgstr "" msgid "" "The *backend* argument specifies the backend to use for :class:`Bdb`. It can " -"be either ``'settrace'`` or ``'monitoring'``. ``'settrace'`` uses :func:`sys." -"settrace` which has the best backward compatibility. The ``'monitoring'`` " -"backend uses the new :mod:`sys.monitoring` that was introduced in Python " -"3.12, which can be much more efficient because it can disable unused events. " -"We are trying to keep the exact interfaces for both backends, but there are " -"some differences. The debugger developers are encouraged to use the " -"``'monitoring'`` backend to achieve better performance." +"be either ``'settrace'`` or ``'monitoring'``. ``'settrace'`` " +"uses :func:`sys.settrace` which has the best backward compatibility. The " +"``'monitoring'`` backend uses the new :mod:`sys.monitoring` that was " +"introduced in Python 3.12, which can be much more efficient because it can " +"disable unused events. We are trying to keep the exact interfaces for both " +"backends, but there are some differences. The debugger developers are " +"encouraged to use the ``'monitoring'`` backend to achieve better performance." msgstr "" msgid "Added the *skip* parameter." @@ -206,10 +206,10 @@ msgid "Return canonical form of *filename*." msgstr "" msgid "" -"For real file names, the canonical form is an operating-system-dependent, :" -"func:`case-normalized ` :func:`absolute path `. A *filename* with angle brackets, such as ``\"\"`` " -"generated in interactive mode, is returned unchanged." +"For real file names, the canonical form is an operating-system-" +"dependent, :func:`case-normalized ` :func:`absolute path " +"`. A *filename* with angle brackets, such as " +"``\"\"`` generated in interactive mode, is returned unchanged." msgstr "" msgid "" @@ -218,13 +218,13 @@ msgid "" msgstr "" msgid "" -"Stop tracing. For ``'settrace'`` backend, this method is equivalent to ``sys." -"settrace(None)``" +"Stop tracing. For ``'settrace'`` backend, this method is equivalent to " +"``sys.settrace(None)``" msgstr "" msgid "" -"Set the :attr:`!botframe`, :attr:`!stopframe`, :attr:`!returnframe` and :" -"attr:`quitting ` attributes with values ready to start " +"Set the :attr:`!botframe`, :attr:`!stopframe`, :attr:`!returnframe` " +"and :attr:`quitting ` attributes with values ready to start " "debugging." msgstr "" @@ -280,43 +280,44 @@ msgstr "Параметр *arg* залежить від попередньої п msgid "" "See the documentation for :func:`sys.settrace` for more information on the " -"trace function. For more information on code and frame objects, refer to :" -"ref:`types`." +"trace function. For more information on code and frame objects, refer " +"to :ref:`types`." msgstr "" "Перегляньте документацію для :func:`sys.settrace`, щоб дізнатися більше про " "функцію трасування. Для отримання додаткової інформації про код і об’єкти " "фрейму зверніться до :ref:`types`." msgid "" -"If the debugger should stop on the current line, invoke the :meth:" -"`user_line` method (which should be overridden in subclasses). Raise a :exc:" -"`BdbQuit` exception if the :attr:`quitting ` flag is set " -"(which can be set from :meth:`user_line`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop on the current line, invoke " +"the :meth:`user_line` method (which should be overridden in subclasses). " +"Raise a :exc:`BdbQuit` exception if the :attr:`quitting ` " +"flag is set (which can be set from :meth:`user_line`). Return a reference " +"to the :meth:`trace_dispatch` method for further tracing in that scope." msgstr "" msgid "" -"If the debugger should stop on this function call, invoke the :meth:" -"`user_call` method (which should be overridden in subclasses). Raise a :exc:" -"`BdbQuit` exception if the :attr:`quitting ` flag is set " -"(which can be set from :meth:`user_call`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop on this function call, invoke " +"the :meth:`user_call` method (which should be overridden in subclasses). " +"Raise a :exc:`BdbQuit` exception if the :attr:`quitting ` " +"flag is set (which can be set from :meth:`user_call`). Return a reference " +"to the :meth:`trace_dispatch` method for further tracing in that scope." msgstr "" msgid "" -"If the debugger should stop on this function return, invoke the :meth:" -"`user_return` method (which should be overridden in subclasses). Raise a :" -"exc:`BdbQuit` exception if the :attr:`quitting ` flag is set " -"(which can be set from :meth:`user_return`). Return a reference to the :" -"meth:`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop on this function return, invoke " +"the :meth:`user_return` method (which should be overridden in subclasses). " +"Raise a :exc:`BdbQuit` exception if the :attr:`quitting ` " +"flag is set (which can be set from :meth:`user_return`). Return a reference " +"to the :meth:`trace_dispatch` method for further tracing in that scope." msgstr "" msgid "" -"If the debugger should stop at this exception, invokes the :meth:" -"`user_exception` method (which should be overridden in subclasses). Raise a :" -"exc:`BdbQuit` exception if the :attr:`quitting ` flag is set " -"(which can be set from :meth:`user_exception`). Return a reference to the :" -"meth:`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop at this exception, invokes " +"the :meth:`user_exception` method (which should be overridden in " +"subclasses). Raise a :exc:`BdbQuit` exception if the :attr:`quitting " +"` flag is set (which can be set from :meth:`user_exception`). " +"Return a reference to the :meth:`trace_dispatch` method for further tracing " +"in that scope." msgstr "" msgid "" @@ -361,8 +362,8 @@ msgid "" msgstr "" msgid "" -"Called from :meth:`dispatch_line` when either :meth:`stop_here` or :meth:" -"`break_here` returns ``True``." +"Called from :meth:`dispatch_line` when either :meth:`stop_here` " +"or :meth:`break_here` returns ``True``." msgstr "" msgid "" @@ -451,9 +452,9 @@ msgid "" msgstr "" msgid "" -"Delete the breakpoint which has the index *arg* in the :attr:`Breakpoint." -"bpbynumber`. If *arg* is not numeric or out of range, return an error " -"message." +"Delete the breakpoint which has the index *arg* in " +"the :attr:`Breakpoint.bpbynumber`. If *arg* is not numeric or out of range, " +"return an error message." msgstr "" "Видаліть точку зупину, яка має індекс *arg* у :attr:`Breakpoint.bpbynumber`. " "Якщо *arg* не є числом або виходить за межі діапазону, повертає повідомлення " @@ -579,16 +580,16 @@ msgid "Finally, the module defines the following functions:" msgstr "Нарешті, модуль визначає такі функції:" msgid "" -"Return ``True`` if we should break here, depending on the way the :class:" -"`Breakpoint` *b* was set." +"Return ``True`` if we should break here, depending on the way " +"the :class:`Breakpoint` *b* was set." msgstr "" msgid "" -"If it was set via line number, it checks if :attr:`b.line ` is the same as the one in *frame*. If the breakpoint was set via :" -"attr:`function name `, we have to check we are in " -"the right *frame* (the right function) and if we are on its first executable " -"line." +"If it was set via line number, it checks if :attr:`b.line " +"` is the same as the one in *frame*. If the breakpoint " +"was set via :attr:`function name `, we have to " +"check we are in the right *frame* (the right function) and if we are on its " +"first executable line." msgstr "" msgid "" @@ -597,15 +598,16 @@ msgid "" msgstr "" msgid "" -"The *active breakpoint* is the first entry in :attr:`bplist ` for the (:attr:`file `, :attr:`line `) (which must exist) that is :attr:`enabled `, for which :func:`checkfuncname` is true, and that has neither a " +"The *active breakpoint* is the first entry in :attr:`bplist " +"` for the (:attr:`file " +"`, :attr:`line `) (which must " +"exist) that is :attr:`enabled `, for " +"which :func:`checkfuncname` is true, and that has neither a " "false :attr:`condition ` nor positive :attr:`ignore " "` count. The *flag*, meaning that a temporary " -"breakpoint should be deleted, is ``False`` only when the :attr:`cond ` cannot be evaluated (in which case, :attr:`ignore ` count is ignored)." +"breakpoint should be deleted, is ``False`` only when the :attr:`cond " +"` cannot be evaluated (in which case, :attr:`ignore " +"` count is ignored)." msgstr "" msgid "If no such entry exists, then ``(None, None)`` is returned." diff --git a/library/binascii.po b/library/binascii.po index f66b6fc3d7..4e8bbec6a0 100644 --- a/library/binascii.po +++ b/library/binascii.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -175,9 +175,8 @@ msgid "" msgstr "" msgid "" -"Similar functionality (accepting only text string arguments, but more " -"liberal towards whitespace) is also accessible using the :meth:`bytes." -"fromhex` class method." +"Similar functionality (but more liberal towards whitespace) is also " +"accessible using the :meth:`bytes.fromhex` class method." msgstr "" msgid "Exception raised on errors. These are usually programming errors." diff --git a/library/bisect.po b/library/bisect.po index b928710d91..26412cd86a 100644 --- a/library/bisect.po +++ b/library/bisect.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,10 +40,10 @@ msgid "" "The module is called :mod:`!bisect` because it uses a basic bisection " "algorithm to do its work. Unlike other bisection tools that search for a " "specific value, the functions in this module are designed to locate an " -"insertion point. Accordingly, the functions never call an :meth:`~object." -"__eq__` method to determine whether a value has been found. Instead, the " -"functions only call the :meth:`~object.__lt__` method and will return an " -"insertion point between values in an array." +"insertion point. Accordingly, the functions never call " +"an :meth:`~object.__eq__` method to determine whether a value has been " +"found. Instead, the functions only call the :meth:`~object.__lt__` method " +"and will return an insertion point between values in an array." msgstr "" msgid "" @@ -153,10 +153,10 @@ msgid "" "The search functions are stateless and discard key function results after " "they are used. Consequently, if the search functions are used in a loop, " "the key function may be called again and again on the same array elements. " -"If the key function isn't fast, consider wrapping it with :py:func:" -"`functools.cache` to avoid duplicate computations. Alternatively, consider " -"searching an array of precomputed keys to locate the insertion point (as " -"shown in the examples section below)." +"If the key function isn't fast, consider wrapping it " +"with :py:deco:`functools.cache` to avoid duplicate computations. " +"Alternatively, consider searching an array of precomputed keys to locate the " +"insertion point (as shown in the examples section below)." msgstr "" msgid "" @@ -231,7 +231,7 @@ msgid "" msgstr "" msgid "" -">>> def grade(score)\n" +">>> def grade(score):\n" "... i = bisect([60, 70, 80, 90], score)\n" "... return \"FDCBA\"[i]\n" "...\n" diff --git a/library/builtins.po b/library/builtins.po index a8bcd86b8e..aceccf092a 100644 --- a/library/builtins.po +++ b/library/builtins.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,8 +28,8 @@ msgstr "" msgid "" "This module provides direct access to all 'built-in' identifiers of Python; " -"for example, ``builtins.open`` is the full name for the built-in function :" -"func:`open`." +"for example, ``builtins.open`` is the full name for the built-in " +"function :func:`open`." msgstr "" msgid "" @@ -62,9 +62,9 @@ msgstr "" msgid "" "As an implementation detail, most modules have the name ``__builtins__`` " "made available as part of their globals. The value of ``__builtins__`` is " -"normally either this module or the value of this module's :attr:`~object." -"__dict__` attribute. Since this is an implementation detail, it may not be " -"used by alternate implementations of Python." +"normally either this module or the value of this " +"module's :attr:`~object.__dict__` attribute. Since this is an implementation " +"detail, it may not be used by alternate implementations of Python." msgstr "" msgid ":ref:`built-in-consts`" diff --git a/library/bz2.po b/library/bz2.po index 444787a153..afd599a8c7 100644 --- a/library/bz2.po +++ b/library/bz2.po @@ -4,17 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -61,8 +60,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "(De)compression of files" msgstr "" @@ -85,8 +84,8 @@ msgid "" msgstr "" msgid "" -"The *compresslevel* argument is an integer from 1 to 9, as for the :class:" -"`BZ2File` constructor." +"The *compresslevel* argument is an integer from 1 to 9, as for " +"the :class:`BZ2File` constructor." msgstr "" msgid "" @@ -97,8 +96,8 @@ msgid "" msgstr "" msgid "" -"For text mode, a :class:`BZ2File` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"For text mode, a :class:`BZ2File` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" @@ -141,9 +140,10 @@ msgid "" msgstr "" msgid "" -":class:`BZ2File` provides all of the members specified by the :class:`io." -"BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io." -"IOBase.truncate`. Iteration and the :keyword:`with` statement are supported." +":class:`BZ2File` provides all of the members specified by " +"the :class:`io.BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` " +"and :meth:`~io.IOBase.truncate`. Iteration and the :keyword:`with` statement " +"are supported." msgstr "" msgid ":class:`BZ2File` also provides the following methods and attributes:" @@ -156,10 +156,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`BZ2File`, it may change the position of the underlying file object (e.g. if " -"the :class:`BZ2File` was constructed by passing a file object for " -"*filename*)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`BZ2File`, it may change the position of the underlying file " +"object (e.g. if the :class:`BZ2File` was constructed by passing a file " +"object for *filename*)." msgstr "" msgid "Return the file descriptor for the underlying file." @@ -249,8 +249,8 @@ msgid "" msgstr "" msgid "" -"When you have finished providing data to the compressor, call the :meth:" -"`flush` method to finish the compression process." +"When you have finished providing data to the compressor, call " +"the :meth:`flush` method to finish the compression process." msgstr "" msgid "" @@ -297,9 +297,9 @@ msgid "" msgstr "" msgid "" -"Attempting to decompress data after the end of stream is reached raises an :" -"exc:`EOFError`. Any data found after the end of the stream is ignored and " -"saved in the :attr:`~.unused_data` attribute." +"Attempting to decompress data after the end of stream is reached raises " +"an :exc:`EOFError`. Any data found after the end of the stream is ignored " +"and saved in the :attr:`~.unused_data` attribute." msgstr "" msgid "Added the *max_length* parameter." diff --git a/library/calendar.po b/library/calendar.po index 82faebfd68..00c1480f62 100644 --- a/library/calendar.po +++ b/library/calendar.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -51,8 +51,8 @@ msgstr "" msgid "" "Creates a :class:`Calendar` object. *firstweekday* is an integer specifying " -"the first day of the week. :const:`MONDAY` is ``0`` (the default), :const:" -"`SUNDAY` is ``6``." +"the first day of the week. :const:`MONDAY` is ``0`` (the " +"default), :const:`SUNDAY` is ``6``." msgstr "" msgid "" @@ -68,8 +68,9 @@ msgid "The first weekday as an integer (0--6)." msgstr "" msgid "" -"This property can also be set and read using :meth:`~Calendar." -"setfirstweekday` and :meth:`~Calendar.getfirstweekday` respectively." +"This property can also be set and read " +"using :meth:`~Calendar.setfirstweekday` " +"and :meth:`~Calendar.getfirstweekday` respectively." msgstr "" msgid "Return an :class:`int` for the current first weekday (0--6)." @@ -87,8 +88,8 @@ msgstr "" msgid "" "Return an iterator for the weekday numbers that will be used for one week. " -"The first value from the iterator will be the same as the value of the :attr:" -"`~Calendar.firstweekday` property." +"The first value from the iterator will be the same as the value of " +"the :attr:`~Calendar.firstweekday` property." msgstr "" msgid "" @@ -99,31 +100,31 @@ msgid "" msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will simply be day of the month numbers. For the days outside " -"of the specified month, the day number is ``0``." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will simply be day of the month numbers. For the days " +"outside of the specified month, the day number is ``0``." msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will be tuples consisting of a day of the month number and a " -"weekday number." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will be tuples consisting of a day of the month number " +"and a weekday number." msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will be tuples consisting of a year, a month and a day of the " -"month numbers." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will be tuples consisting of a year, a month and a day " +"of the month numbers." msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will be tuples consisting of a year, a month, a day of the " -"month, and a day of the week numbers." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will be tuples consisting of a year, a month, a day of " +"the month, and a day of the week numbers." msgstr "" msgid "" @@ -149,15 +150,15 @@ msgid "" msgstr "" msgid "" -"Return the data for the specified year ready for formatting (similar to :" -"meth:`yeardatescalendar`). Entries in the week lists are tuples of day " +"Return the data for the specified year ready for formatting (similar " +"to :meth:`yeardatescalendar`). Entries in the week lists are tuples of day " "numbers and weekday numbers. Day numbers outside this month are zero." msgstr "" msgid "" -"Return the data for the specified year ready for formatting (similar to :" -"meth:`yeardatescalendar`). Entries in the week lists are day numbers. Day " -"numbers outside this month are zero." +"Return the data for the specified year ready for formatting (similar " +"to :meth:`yeardatescalendar`). Entries in the week lists are day numbers. " +"Day numbers outside this month are zero." msgstr "" msgid "This class can be used to generate plain text calendars." @@ -173,10 +174,9 @@ msgid "" msgstr "" msgid "" -"Return a single week in a string with no newline. If *w* is provided, it " -"specifies the width of the date columns, which are centered. Depends on the " -"first weekday as specified in the constructor or set by the :meth:" -"`setfirstweekday` method." +"Return a single week in a string with no newline. *width* specifies the " +"width of the date columns, which are centered. Depends on the first weekday " +"as specified in the constructor or set by the :meth:`setfirstweekday` method." msgstr "" msgid "" @@ -195,8 +195,8 @@ msgid "" "Return a month's calendar in a multi-line string. If *w* is provided, it " "specifies the width of the date columns, which are centered. If *l* is " "given, it specifies the number of lines that each week will use. Depends on " -"the first weekday as specified in the constructor or set by the :meth:" -"`setfirstweekday` method." +"the first weekday as specified in the constructor or set by " +"the :meth:`setfirstweekday` method." msgstr "" msgid "" @@ -213,9 +213,9 @@ msgid "" "Return a *m*-column calendar for an entire year as a multi-line string. " "Optional parameters *w*, *l*, and *c* are for date column width, lines per " "week, and number of spaces between month columns, respectively. Depends on " -"the first weekday as specified in the constructor or set by the :meth:" -"`setfirstweekday` method. The earliest year for which a calendar can be " -"generated is platform-dependent." +"the first weekday as specified in the constructor or set by " +"the :meth:`setfirstweekday` method. The earliest year for which a calendar " +"can be generated is platform-dependent." msgstr "" msgid "" @@ -294,13 +294,13 @@ msgid "" msgstr "" msgid "" -"The CSS class for the whole year's table of tables (used by :meth:" -"`formatyear`). The default value is ``\"year\"``." +"The CSS class for the whole year's table of tables (used " +"by :meth:`formatyear`). The default value is ``\"year\"``." msgstr "" msgid "" -"The CSS class for the table head for the whole year (used by :meth:" -"`formatyear`). The default value is ``\"year\"``." +"The CSS class for the table head for the whole year (used " +"by :meth:`formatyear`). The default value is ``\"year\"``." msgstr "" msgid "" @@ -346,9 +346,9 @@ msgstr "" msgid "" "Sets the weekday (``0`` is Monday, ``6`` is Sunday) to start each week. The " -"values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:" -"`THURSDAY`, :const:`FRIDAY`, :const:`SATURDAY`, and :const:`SUNDAY` are " -"provided for convenience. For example, to set the first weekday to Sunday::" +"values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:`THURSDAY`, :const:`FRIDAY`, :const:`SATURDAY`, " +"and :const:`SUNDAY` are provided for convenience. For example, to set the " +"first weekday to Sunday::" msgstr "" msgid "" @@ -377,7 +377,7 @@ msgid "" msgstr "" msgid "" -"Return a header containing abbreviated weekday names. *n* specifies the " +"Return a header containing abbreviated weekday names. *width* specifies the " "width in characters for one weekday." msgstr "" @@ -396,12 +396,13 @@ msgid "Prints a month's calendar as returned by :func:`month`." msgstr "" msgid "" -"Returns a month's calendar in a multi-line string using the :meth:" -"`~TextCalendar.formatmonth` of the :class:`TextCalendar` class." +"Returns a month's calendar in a multi-line string using " +"the :meth:`~TextCalendar.formatmonth` of the :class:`TextCalendar` class." msgstr "" msgid "" -"Prints the calendar for an entire year as returned by :func:`calendar`." +"Prints the calendar for an entire year as returned " +"by :func:`~calendar.calendar`." msgstr "" msgid "" @@ -437,8 +438,8 @@ msgstr "" msgid "" "Enumeration defining days of the week as integer constants. The members of " -"this enumeration are exported to the module scope as :data:`MONDAY` through :" -"data:`SUNDAY`." +"this enumeration are exported to the module scope as :data:`MONDAY` " +"through :data:`SUNDAY`." msgstr "" msgid "" @@ -606,8 +607,8 @@ msgid "The locale to use for month and weekday names. Defaults to English." msgstr "" msgid "" -"The encoding to use for output. :option:`--encoding` is required if :option:" -"`--locale` is set." +"The encoding to use for output. :option:`--encoding` is required " +"if :option:`--locale` is set." msgstr "" msgid "Print the calendar to the terminal as text, or as an HTML document." diff --git a/library/cmath.po b/library/cmath.po index 8cd4ffa8e2..64578382f3 100644 --- a/library/cmath.po +++ b/library/cmath.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -271,8 +271,8 @@ msgstr "" msgid "" "A Python complex number ``z`` is stored internally using *rectangular* or " -"*Cartesian* coordinates. It is completely determined by its *real part* ``z." -"real`` and its *imaginary part* ``z.imag``." +"*Cartesian* coordinates. It is completely determined by its *real part* " +"``z.real`` and its *imaginary part* ``z.imag``." msgstr "" msgid "" @@ -336,8 +336,8 @@ msgid "" msgstr "" msgid "" -"Return the base-10 logarithm of *z*. This has the same branch cut as :func:" -"`log`." +"Return the base-10 logarithm of *z*. This has the same branch cut " +"as :func:`log`." msgstr "" msgid "" diff --git a/library/cmd.po b/library/cmd.po index c6952dc2c4..d222e5d0f3 100644 --- a/library/cmd.po +++ b/library/cmd.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,6 +36,15 @@ msgid "" "sophisticated interface." msgstr "" +msgid "" +"A command interpreter built with :class:`Cmd` typically presents the user " +"with an interactive prompt, reads input one line at a time, and dispatches " +"each command to a method named ``do_`` followed by the command name. For " +"example, the ``help`` command is handled by the :meth:`~Cmd.do_help` " +"method. Apart from the built-in ``help`` command, most of the interpreter's " +"behavior is defined by the ``do_*`` methods you add in your own subclass." +msgstr "" + msgid "" "A :class:`Cmd` instance or subclass instance is a line-oriented interpreter " "framework. There is no good reason to instantiate :class:`Cmd` itself; " @@ -46,30 +55,30 @@ msgstr "" msgid "" "The optional argument *completekey* is the :mod:`readline` name of a " -"completion key; it defaults to :kbd:`Tab`. If *completekey* is not :const:" -"`None` and :mod:`readline` is available, command completion is done " -"automatically." +"completion key; it defaults to :kbd:`Tab`. If *completekey* is " +"not :const:`None` and :mod:`readline` is available, command completion is " +"done automatically." msgstr "" msgid "" -"The default, ``'tab'``, is treated specially, so that it refers to the :kbd:" -"`Tab` key on every :data:`readline.backend`. Specifically, if :data:" -"`readline.backend` is ``editline``, ``Cmd`` will use ``'^I'`` instead of " -"``'tab'``. Note that other values are not treated this way, and might only " -"work with a specific backend." +"The default, ``'tab'``, is treated specially, so that it refers to " +"the :kbd:`Tab` key on every :data:`readline.backend`. Specifically, " +"if :data:`readline.backend` is ``editline``, ``Cmd`` will use ``'^I'`` " +"instead of ``'tab'``. Note that other values are not treated this way, and " +"might only work with a specific backend." msgstr "" msgid "" "The optional arguments *stdin* and *stdout* specify the input and output " "file objects that the Cmd instance or subclass instance will use for input " -"and output. If not specified, they will default to :data:`sys.stdin` and :" -"data:`sys.stdout`." +"and output. If not specified, they will default to :data:`sys.stdin` " +"and :data:`sys.stdout`." msgstr "" msgid "" -"If you want a given *stdin* to be used, make sure to set the instance's :" -"attr:`use_rawinput` attribute to ``False``, otherwise *stdin* will be " -"ignored." +"If you want a given *stdin* to be used, make sure to set the " +"instance's :attr:`use_rawinput` attribute to ``False``, otherwise *stdin* " +"will be ignored." msgstr "" msgid "``completekey='tab'`` is replaced by ``'^I'`` for ``editline``." @@ -93,11 +102,12 @@ msgid "" msgstr "" msgid "" -"If the :mod:`readline` module is loaded, input will automatically inherit :" -"program:`bash`\\ -like history-list editing (e.g. :kbd:`Control-P` scrolls " -"back to the last command, :kbd:`Control-N` forward to the next one, :kbd:" -"`Control-F` moves the cursor to the right non-destructively, :kbd:`Control-" -"B` moves the cursor to the left non-destructively, etc.)." +"If the :mod:`readline` module is loaded, input will automatically " +"inherit :program:`bash`\\ -like history-list editing (e.g. :kbd:`Control-P` " +"scrolls back to the last command, :kbd:`Control-N` forward to the next " +"one, :kbd:`Control-F` moves the cursor to the right non-" +"destructively, :kbd:`Control-B` moves the cursor to the left non-" +"destructively, etc.)." msgstr "" msgid "An end-of-file on input is passed back as the string ``'EOF'``." @@ -130,20 +140,20 @@ msgstr "" msgid "" "All subclasses of :class:`Cmd` inherit a predefined :meth:`!do_help`. This " -"method, called with an argument ``'bar'``, invokes the corresponding method :" -"meth:`!help_bar`, and if that is not present, prints the docstring of :meth:" -"`!do_bar`, if available. With no argument, :meth:`!do_help` lists all " -"available help topics (that is, all commands with corresponding :meth:`!" +"method, called with an argument ``'bar'``, invokes the corresponding " +"method :meth:`!help_bar`, and if that is not present, prints the docstring " +"of :meth:`!do_bar`, if available. With no argument, :meth:`!do_help` lists " +"all available help topics (that is, all commands with corresponding :meth:`!" "help_\\*` methods or commands that have docstrings), and also lists any " "undocumented commands." msgstr "" msgid "" "Interpret the argument as though it had been typed in response to the " -"prompt. This may be overridden, but should not normally need to be; see the :" -"meth:`precmd` and :meth:`postcmd` methods for useful execution hooks. The " -"return value is a flag indicating whether interpretation of commands by the " -"interpreter should stop. If there is a :meth:`!do_\\*` method for the " +"prompt. This may be overridden, but should not normally need to be; see " +"the :meth:`precmd` and :meth:`postcmd` methods for useful execution hooks. " +"The return value is a flag indicating whether interpretation of commands by " +"the interpreter should stop. If there is a :meth:`!do_\\*` method for the " "command *str*, the return value of that method is returned, otherwise the " "return value from the :meth:`default` method is returned." msgstr "" @@ -171,9 +181,9 @@ msgstr "" msgid "" "Hook method executed just before the command line *line* is interpreted, but " -"after the input prompt is generated and issued. This method is a stub in :" -"class:`Cmd`; it exists to be overridden by subclasses. The return value is " -"used as the command which will be executed by the :meth:`onecmd` method; " +"after the input prompt is generated and issued. This method is a stub " +"in :class:`Cmd`; it exists to be overridden by subclasses. The return value " +"is used as the command which will be executed by the :meth:`onecmd` method; " "the :meth:`precmd` implementation may re-write the command or simply return " "*line* unchanged." msgstr "" @@ -212,14 +222,14 @@ msgid "The last nonempty command prefix seen." msgstr "" msgid "" -"A list of queued input lines. The cmdqueue list is checked in :meth:" -"`cmdloop` when new input is needed; if it is nonempty, its elements will be " -"processed in order, as if entered at the prompt." +"A list of queued input lines. The cmdqueue list is checked " +"in :meth:`cmdloop` when new input is needed; if it is nonempty, its elements " +"will be processed in order, as if entered at the prompt." msgstr "" msgid "" -"A string to issue as an intro or banner. May be overridden by giving the :" -"meth:`cmdloop` method an argument." +"A string to issue as an intro or banner. May be overridden by giving " +"the :meth:`cmdloop` method an argument." msgstr "" msgid "" @@ -228,14 +238,14 @@ msgstr "" msgid "" "The header to issue if the help output has a section for miscellaneous help " -"topics (that is, there are :meth:`!help_\\*` methods without corresponding :" -"meth:`!do_\\*` methods)." +"topics (that is, there are :meth:`!help_\\*` methods without " +"corresponding :meth:`!do_\\*` methods)." msgstr "" msgid "" "The header to issue if the help output has a section for undocumented " -"commands (that is, there are :meth:`!do_\\*` methods without corresponding :" -"meth:`!help_\\*` methods)." +"commands (that is, there are :meth:`!do_\\*` methods without " +"corresponding :meth:`!help_\\*` methods)." msgstr "" msgid "" @@ -245,11 +255,12 @@ msgstr "" msgid "" "A flag, defaulting to true. If true, :meth:`cmdloop` uses :func:`input` to " -"display a prompt and read the next command; if false, :data:`sys.stdout." -"write() ` and :data:`sys.stdin.readline() ` are used. " -"(This means that by importing :mod:`readline`, on systems that support it, " -"the interpreter will automatically support :program:`Emacs`\\ -like line " -"editing and command-history keystrokes.)" +"display a prompt and read the next command; if " +"false, :data:`sys.stdout.write() ` " +"and :data:`sys.stdin.readline() ` are used. (This means that by " +"importing :mod:`readline`, on systems that support it, the interpreter will " +"automatically support :program:`Emacs`\\ -like line editing and command-" +"history keystrokes.)" msgstr "" msgid "Cmd Example" @@ -266,18 +277,18 @@ msgid "" msgstr "" msgid "" -"Basic turtle commands such as :meth:`~turtle.forward` are added to a :class:" -"`Cmd` subclass with method named :meth:`!do_forward`. The argument is " -"converted to a number and dispatched to the turtle module. The docstring is " -"used in the help utility provided by the shell." +"Basic turtle commands such as :meth:`~turtle.forward` are added to " +"a :class:`Cmd` subclass with method named :meth:`!do_forward`. The argument " +"is converted to a number and dispatched to the turtle module. The docstring " +"is used in the help utility provided by the shell." msgstr "" msgid "" "The example also includes a basic record and playback facility implemented " "with the :meth:`~Cmd.precmd` method which is responsible for converting the " "input to lowercase and writing the commands to a file. The :meth:`!" -"do_playback` method reads the file and adds the recorded commands to the :" -"attr:`~Cmd.cmdqueue` for immediate playback::" +"do_playback` method reads the file and adds the recorded commands to " +"the :attr:`~Cmd.cmdqueue` for immediate playback::" msgstr "" msgid "" diff --git a/library/cmdline.po b/library/cmdline.po index eb846f197b..25ffc56ccf 100644 --- a/library/cmdline.po +++ b/library/cmdline.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/cmdlinelibs.po b/library/cmdlinelibs.po index af13979225..e83d834301 100644 --- a/library/cmdlinelibs.po +++ b/library/cmdlinelibs.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,7 +25,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Command-line interface libraries" -msgstr "" +msgstr "Biblioteki interfejsu wiersza poleceń" msgid "" "The modules described in this chapter assist with implementing command line " diff --git a/library/code.po b/library/code.po index b07d0a07cb..42c6830142 100644 --- a/library/code.po +++ b/library/code.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -55,8 +55,8 @@ msgid "" "Closely emulate the behavior of the interactive Python interpreter. This " "class builds on :class:`InteractiveInterpreter` and adds prompting using the " "familiar ``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* " -"is true, ``exit()`` and ``quit()`` in the console will not raise :exc:" -"`SystemExit`, but instead return to the calling code." +"is true, ``exit()`` and ``quit()`` in the console will not " +"raise :exc:`SystemExit`, but instead return to the calling code." msgstr "" msgid "Added *local_exit* parameter." @@ -68,9 +68,9 @@ msgid "" "the :meth:`InteractiveConsole.raw_input` method, if provided. If *local* is " "provided, it is passed to the :class:`InteractiveConsole` constructor for " "use as the default namespace for the interpreter loop. If *local_exit* is " -"provided, it is passed to the :class:`InteractiveConsole` constructor. The :" -"meth:`~InteractiveConsole.interact` method of the instance is then run with " -"*banner* and *exitmsg* passed as the banner and exit message to use, if " +"provided, it is passed to the :class:`InteractiveConsole` constructor. " +"The :meth:`~InteractiveConsole.interact` method of the instance is then run " +"with *banner* and *exitmsg* passed as the banner and exit message to use, if " "provided. The console object is discarded after use." msgstr "" @@ -111,10 +111,9 @@ msgid "" msgstr "" msgid "" -"The input is incorrect; :func:`compile_command` raised an exception (:exc:" -"`SyntaxError` or :exc:`OverflowError`). A syntax traceback will be printed " -"by calling the :meth:`showsyntaxerror` method. :meth:`runsource` returns " -"``False``." +"The input is incorrect; :func:`compile_command` raised an exception " +"(usually :exc:`SyntaxError`). A syntax traceback will be printed by calling " +"the :meth:`showsyntaxerror` method. :meth:`runsource` returns ``False``." msgstr "" msgid "" @@ -130,14 +129,14 @@ msgid "" msgstr "" msgid "" -"The return value can be used to decide whether to use ``sys.ps1`` or ``sys." -"ps2`` to prompt the next line." +"The return value can be used to decide whether to use ``sys.ps1`` or " +"``sys.ps2`` to prompt the next line." msgstr "" msgid "" "Execute a code object. When an exception occurs, :meth:`showtraceback` is " -"called to display a traceback. All exceptions are caught except :exc:" -"`SystemExit`, which is allowed to propagate." +"called to display a traceback. All exceptions are caught " +"except :exc:`SystemExit`, which is allowed to propagate." msgstr "" msgid "" @@ -175,9 +174,9 @@ msgid "Interactive Console Objects" msgstr "" msgid "" -"The :class:`InteractiveConsole` class is a subclass of :class:" -"`InteractiveInterpreter`, and so offers all the methods of the interpreter " -"objects as well as the following additions." +"The :class:`InteractiveConsole` class is a subclass " +"of :class:`InteractiveInterpreter`, and so offers all the methods of the " +"interpreter objects as well as the following additions." msgstr "" msgid "" @@ -218,7 +217,7 @@ msgstr "" msgid "" "Write a prompt and read a line. The returned line does not include the " -"trailing newline. When the user enters the EOF key sequence, :exc:" -"`EOFError` is raised. The base implementation reads from ``sys.stdin``; a " -"subclass may replace this with a different implementation." +"trailing newline. When the user enters the EOF key " +"sequence, :exc:`EOFError` is raised. The base implementation reads from " +"``sys.stdin``; a subclass may replace this with a different implementation." msgstr "" diff --git a/library/codecs.po b/library/codecs.po index 084c8635bc..e11311d8f1 100644 --- a/library/codecs.po +++ b/library/codecs.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:00+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -51,9 +51,9 @@ msgstr "" msgid "" "*Errors* may be given to set the desired error handling scheme. The default " -"error handler is ``'strict'`` meaning that encoding errors raise :exc:" -"`ValueError` (or a more codec specific subclass, such as :exc:" -"`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more " +"error handler is ``'strict'`` meaning that encoding errors " +"raise :exc:`ValueError` (or a more codec specific subclass, such " +"as :exc:`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more " "information on codec error handling." msgstr "" @@ -62,9 +62,9 @@ msgstr "" msgid "" "*Errors* may be given to set the desired error handling scheme. The default " -"error handler is ``'strict'`` meaning that decoding errors raise :exc:" -"`ValueError` (or a more codec specific subclass, such as :exc:" -"`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more " +"error handler is ``'strict'`` meaning that decoding errors " +"raise :exc:`ValueError` (or a more codec specific subclass, such " +"as :exc:`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more " "information on codec error handling." msgstr "" @@ -80,15 +80,16 @@ msgid "The full details for each codec can also be looked up directly:" msgstr "" msgid "" -"Looks up the codec info in the Python codec registry and returns a :class:" -"`CodecInfo` object as defined below." +"Looks up the codec info in the Python codec registry and returns " +"a :class:`CodecInfo` object as defined below." msgstr "" msgid "" "Encodings are first looked up in the registry's cache. If not found, the " "list of registered search functions is scanned. If no :class:`CodecInfo` " -"object is found, a :exc:`LookupError` is raised. Otherwise, the :class:" -"`CodecInfo` object is stored in the cache and returned to the caller." +"object is found, a :exc:`LookupError` is raised. Otherwise, " +"the :class:`CodecInfo` object is stored in the cache and returned to the " +"caller." msgstr "" msgid "" @@ -101,23 +102,23 @@ msgstr "" msgid "" "The stateless encoding and decoding functions. These must be functions or " -"methods which have the same interface as the :meth:`~Codec.encode` and :meth:" -"`~Codec.decode` methods of Codec instances (see :ref:`Codec Interface `). The functions or methods are expected to work in a stateless " -"mode." +"methods which have the same interface as the :meth:`~Codec.encode` " +"and :meth:`~Codec.decode` methods of Codec instances (see :ref:`Codec " +"Interface `). The functions or methods are expected to work " +"in a stateless mode." msgstr "" msgid "" "Incremental encoder and decoder classes or factory functions. These have to " -"provide the interface defined by the base classes :class:" -"`IncrementalEncoder` and :class:`IncrementalDecoder`, respectively. " -"Incremental codecs can maintain state." +"provide the interface defined by the base " +"classes :class:`IncrementalEncoder` and :class:`IncrementalDecoder`, " +"respectively. Incremental codecs can maintain state." msgstr "" msgid "" "Stream writer and reader classes or factory functions. These have to provide " -"the interface defined by the base classes :class:`StreamWriter` and :class:" -"`StreamReader`, respectively. Stream codecs can maintain state." +"the interface defined by the base classes :class:`StreamWriter` " +"and :class:`StreamReader`, respectively. Stream codecs can maintain state." msgstr "" msgid "" @@ -157,13 +158,13 @@ msgid "" msgstr "" msgid "" -"Look up the codec for the given encoding and return its :class:" -"`StreamReader` class or factory function." +"Look up the codec for the given encoding and return " +"its :class:`StreamReader` class or factory function." msgstr "" msgid "" -"Look up the codec for the given encoding and return its :class:" -"`StreamWriter` class or factory function." +"Look up the codec for the given encoding and return " +"its :class:`StreamWriter` class or factory function." msgstr "" msgid "" @@ -195,9 +196,9 @@ msgid "" msgstr "" msgid "" -"Open an encoded file using the given *mode* and return an instance of :class:" -"`StreamReaderWriter`, providing transparent encoding/decoding. The default " -"file mode is ``'r'``, meaning to open the file in read mode." +"Open an encoded file using the given *mode* and return an instance " +"of :class:`StreamReaderWriter`, providing transparent encoding/decoding. The " +"default file mode is ``'r'``, meaning to open the file in read mode." msgstr "" msgid "" @@ -254,8 +255,8 @@ msgstr "" msgid "" "Uses an incremental encoder to iteratively encode the input provided by " -"*iterator*. *iterator* must yield :class:`str` objects. This function is a :" -"term:`generator`. The *errors* argument (as well as any other keyword " +"*iterator*. *iterator* must yield :class:`str` objects. This function is " +"a :term:`generator`. The *errors* argument (as well as any other keyword " "argument) is passed through to the incremental encoder." msgstr "" @@ -275,8 +276,8 @@ msgstr "" msgid "" "This function requires that the codec accept :class:`bytes` objects to " "decode. Therefore it does not support text-to-text encoders such as " -"``rot_13``, although ``rot_13`` may be used equivalently with :func:" -"`iterencode`." +"``rot_13``, although ``rot_13`` may be used equivalently " +"with :func:`iterencode`." msgstr "" msgid "" @@ -302,11 +303,11 @@ msgid "" "These constants define various byte sequences, being Unicode byte order " "marks (BOMs) for several encodings. They are used in UTF-16 and UTF-32 data " "streams to indicate the byte order used, and in UTF-8 as a Unicode " -"signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` or :const:" -"`BOM_UTF16_LE` depending on the platform's native byte order, :const:`BOM` " -"is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` for :const:" -"`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The others " -"represent the BOM in UTF-8 and UTF-32 encodings." +"signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` " +"or :const:`BOM_UTF16_LE` depending on the platform's native byte " +"order, :const:`BOM` is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` " +"for :const:`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The " +"others represent the BOM in UTF-8 and UTF-32 encodings." msgstr "" msgid "Codec Base Classes" @@ -375,9 +376,10 @@ msgstr "``'backslashreplace'``" msgid "" "Replace with backslashed escape sequences. On encoding, use hexadecimal form " -"of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :" -"samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value with " -"format :samp:`\\\\x{hh}`. Implemented in :func:`backslashreplace_errors`." +"of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}" +"` :samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value " +"with format :samp:`\\\\x{hh}`. Implemented " +"in :func:`backslashreplace_errors`." msgstr "" msgid "``'surrogateescape'``" @@ -391,8 +393,8 @@ msgid "" msgstr "" msgid "" -"The following error handlers are only applicable to encoding (within :term:" -"`text encodings `):" +"The following error handlers are only applicable to encoding " +"(within :term:`text encodings `):" msgstr "" msgid "``'xmlcharrefreplace'``" @@ -400,8 +402,8 @@ msgstr "``'xmlcharrefreplace'``" msgid "" "Replace with XML/HTML numeric character reference, which is a decimal form " -"of Unicode code point with format :samp:`&#{num};`. Implemented in :func:" -"`xmlcharrefreplace_errors`." +"of Unicode code point with format :samp:`&#{num};`. Implemented " +"in :func:`xmlcharrefreplace_errors`." msgstr "" msgid "``'namereplace'``" @@ -409,8 +411,8 @@ msgstr "``'namereplace'``" msgid "" "Replace with ``\\N{...}`` escape sequences, what appears in the braces is " -"the Name property from Unicode Character Database. Implemented in :func:" -"`namereplace_errors`." +"the Name property from Unicode Character Database. Implemented " +"in :func:`namereplace_errors`." msgstr "" msgid "" @@ -460,17 +462,18 @@ msgid "" msgstr "" msgid "" -"For encoding, *error_handler* will be called with a :exc:" -"`UnicodeEncodeError` instance, which contains information about the location " -"of the error. The error handler must either raise this or a different " -"exception, or return a tuple with a replacement for the unencodable part of " -"the input and a position where encoding should continue. The replacement may " -"be either :class:`str` or :class:`bytes`. If the replacement is bytes, the " -"encoder will simply copy them into the output buffer. If the replacement is " -"a string, the encoder will encode the replacement. Encoding continues on " -"original input at the specified position. Negative position values will be " -"treated as being relative to the end of the input string. If the resulting " -"position is out of bound an :exc:`IndexError` will be raised." +"For encoding, *error_handler* will be called with " +"a :exc:`UnicodeEncodeError` instance, which contains information about the " +"location of the error. The error handler must either raise this or a " +"different exception, or return a tuple with a replacement for the " +"unencodable part of the input and a position where encoding should continue. " +"The replacement may be either :class:`str` or :class:`bytes`. If the " +"replacement is bytes, the encoder will simply copy them into the output " +"buffer. If the replacement is a string, the encoder will encode the " +"replacement. Encoding continues on original input at the specified position. " +"Negative position values will be treated as being relative to the end of the " +"input string. If the resulting position is out of bound an :exc:`IndexError` " +"will be raised." msgstr "" msgid "" @@ -531,8 +534,8 @@ msgid "Works with decoding and translating." msgstr "" msgid "" -"Implements the ``'xmlcharrefreplace'`` error handling (for encoding within :" -"term:`text encoding` only)." +"Implements the ``'xmlcharrefreplace'`` error handling (for encoding " +"within :term:`text encoding` only)." msgstr "" msgid "" @@ -542,8 +545,8 @@ msgid "" msgstr "" msgid "" -"Implements the ``'namereplace'`` error handling (for encoding within :term:" -"`text encoding` only)." +"Implements the ``'namereplace'`` error handling (for encoding " +"within :term:`text encoding` only)." msgstr "" msgid "" @@ -574,9 +577,9 @@ msgid "" msgstr "" msgid "" -"The method may not store state in the :class:`Codec` instance. Use :class:" -"`StreamWriter` for codecs which have to keep state in order to make encoding " -"efficient." +"The method may not store state in the :class:`Codec` instance. " +"Use :class:`StreamWriter` for codecs which have to keep state in order to " +"make encoding efficient." msgstr "" msgid "" @@ -598,9 +601,9 @@ msgid "" msgstr "" msgid "" -"The method may not store state in the :class:`Codec` instance. Use :class:" -"`StreamReader` for codecs which have to keep state in order to make decoding " -"efficient." +"The method may not store state in the :class:`Codec` instance. " +"Use :class:`StreamReader` for codecs which have to keep state in order to " +"make decoding efficient." msgstr "" msgid "" @@ -615,17 +618,17 @@ msgid "" "The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes " "provide the basic interface for incremental encoding and decoding. Encoding/" "decoding the input isn't done with one call to the stateless encoder/decoder " -"function, but with multiple calls to the :meth:`~IncrementalEncoder.encode`/:" -"meth:`~IncrementalDecoder.decode` method of the incremental encoder/decoder. " -"The incremental encoder/decoder keeps track of the encoding/decoding process " -"during method calls." +"function, but with multiple calls to " +"the :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` " +"method of the incremental encoder/decoder. The incremental encoder/decoder " +"keeps track of the encoding/decoding process during method calls." msgstr "" msgid "" -"The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:" -"`~IncrementalDecoder.decode` method is the same as if all the single inputs " -"were joined into one, and this input was encoded/decoded with the stateless " -"encoder/decoder." +"The joined output of calls to " +"the :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` " +"method is the same as if all the single inputs were joined into one, and " +"this input was encoded/decoded with the stateless encoder/decoder." msgstr "" msgid "IncrementalEncoder Objects" @@ -655,19 +658,19 @@ msgstr "" msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " -"error handling strategies during the lifetime of the :class:" -"`IncrementalEncoder` object." +"error handling strategies during the lifetime of " +"the :class:`IncrementalEncoder` object." msgstr "" msgid "" "Encodes *object* (taking the current state of the encoder into account) and " -"returns the resulting encoded object. If this is the last call to :meth:" -"`encode` *final* must be true (the default is false)." +"returns the resulting encoded object. If this is the last call " +"to :meth:`encode` *final* must be true (the default is false)." msgstr "" msgid "" -"Reset the encoder to the initial state. The output is discarded: call ``." -"encode(object, final=True)``, passing an empty byte or text string if " +"Reset the encoder to the initial state. The output is discarded: call " +"``.encode(object, final=True)``, passing an empty byte or text string if " "necessary, to reset the encoder and to get the output." msgstr "" @@ -711,18 +714,18 @@ msgstr "" msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " -"error handling strategies during the lifetime of the :class:" -"`IncrementalDecoder` object." +"error handling strategies during the lifetime of " +"the :class:`IncrementalDecoder` object." msgstr "" msgid "" "Decodes *object* (taking the current state of the decoder into account) and " -"returns the resulting decoded object. If this is the last call to :meth:" -"`decode` *final* must be true (the default is false). If *final* is true the " -"decoder must decode the input completely and must flush all buffers. If this " -"isn't possible (e.g. because of incomplete byte sequences at the end of the " -"input) it must initiate error handling just like in the stateless case " -"(which might raise an exception)." +"returns the resulting decoded object. If this is the last call " +"to :meth:`decode` *final* must be true (the default is false). If *final* is " +"true the decoder must decode the input completely and must flush all " +"buffers. If this isn't possible (e.g. because of incomplete byte sequences " +"at the end of the input) it must initiate error handling just like in the " +"stateless case (which might raise an exception)." msgstr "" msgid "Reset the decoder to the initial state." @@ -852,8 +855,8 @@ msgid "" msgstr "" msgid "" -"The set of allowed values for the *errors* argument can be extended with :" -"func:`register_error`." +"The set of allowed values for the *errors* argument can be extended " +"with :func:`register_error`." msgstr "" msgid "Decodes data from the stream and returns the resulting object." @@ -908,8 +911,8 @@ msgid "" msgstr "" msgid "" -"*sizehint*, if given, is passed as the *size* argument to the stream's :meth:" -"`read` method." +"*sizehint*, if given, is passed as the *size* argument to the " +"stream's :meth:`read` method." msgstr "" msgid "" @@ -931,8 +934,8 @@ msgid "" msgstr "" msgid "" -"The design is such that one can use the factory functions returned by the :" -"func:`lookup` function to construct the instance." +"The design is such that one can use the factory functions returned by " +"the :func:`lookup` function to construct the instance." msgstr "" msgid "" @@ -944,8 +947,8 @@ msgid "" msgstr "" msgid "" -":class:`StreamReaderWriter` instances define the combined interfaces of :" -"class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " +":class:`StreamReaderWriter` instances define the combined interfaces " +"of :class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " "other methods and attributes from the underlying stream." msgstr "" @@ -985,9 +988,9 @@ msgid "" msgstr "" msgid "" -":class:`StreamRecoder` instances define the combined interfaces of :class:" -"`StreamReader` and :class:`StreamWriter` classes. They inherit all other " -"methods and attributes from the underlying stream." +":class:`StreamRecoder` instances define the combined interfaces " +"of :class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " +"other methods and attributes from the underlying stream." msgstr "" msgid "Encodings and Unicode" @@ -1333,8 +1336,8 @@ msgstr "" msgid "cp858" msgstr "cp858" -msgid "858, IBM858" -msgstr "858, IBM858" +msgid "858, IBM00858" +msgstr "" msgid "cp860" msgstr "cp860" @@ -1456,8 +1459,8 @@ msgstr "" msgid "cp1140" msgstr "cp1140" -msgid "ibm1140" -msgstr "ibm1140" +msgid "IBM01140" +msgstr "" msgid "cp1250" msgstr "cp1250" @@ -1896,9 +1899,9 @@ msgid "Text Encodings" msgstr "" msgid "" -"The following codecs provide :class:`str` to :class:`bytes` encoding and :" -"term:`bytes-like object` to :class:`str` decoding, similar to the Unicode " -"text encodings." +"The following codecs provide :class:`str` to :class:`bytes` encoding " +"and :term:`bytes-like object` to :class:`str` decoding, similar to the " +"Unicode text encodings." msgstr "" msgid "idna" @@ -1909,6 +1912,11 @@ msgid "" "``errors='strict'`` is supported." msgstr "" +msgid "" +"This codec builds on ``punycode``, whose algorithms scale poorly, so limit " +"the length of untrusted input." +msgstr "" + msgid "mbcs" msgstr "mbcs" @@ -1938,6 +1946,11 @@ msgstr "punycode" msgid "Implement :rfc:`3492`. Stateful codecs are not supported." msgstr "" +msgid "" +"The decoding and encoding algorithms scale poorly, so limit the length of " +"untrusted input." +msgstr "" + msgid "raw_unicode_escape" msgstr "raw_unicode_escape" @@ -2075,10 +2088,10 @@ msgstr "" msgid "" "The following functions provide encoding and decoding functionality similar " -"to codecs, but are not available as named codecs through :func:`codecs." -"encode` or :func:`codecs.decode`. They are used internally (for example, by :" -"mod:`pickle`) and behave similarly to the ``string_escape`` codec that was " -"removed in Python 3." +"to codecs, but are not available as named codecs " +"through :func:`codecs.encode` or :func:`codecs.decode`. They are used " +"internally (for example, by :mod:`pickle`) and behave similarly to the " +"``string_escape`` codec that was removed in Python 3." msgstr "" msgid "" @@ -2104,9 +2117,9 @@ msgid "Text Transforms" msgstr "" msgid "" -"The following codec provides a text transform: a :class:`str` to :class:" -"`str` mapping. It is not supported by :meth:`str.encode` (which only " -"produces :class:`bytes` output)." +"The following codec provides a text transform: a :class:`str` " +"to :class:`str` mapping. It is not supported by :meth:`str.encode` (which " +"only produces :class:`bytes` output)." msgstr "" msgid "rot_13" @@ -2154,10 +2167,10 @@ msgid "" msgstr "" msgid "" -"This function first normalizes the *encoding* using :func:" -"`normalize_encoding`, then looks for a corresponding alias. It attempts to " -"import a codec module from the encodings package using either the alias or " -"the normalized name. If the module is found and defines a valid " +"This function first normalizes the *encoding* " +"using :func:`normalize_encoding`, then looks for a corresponding alias. It " +"attempts to import a codec module from the encodings package using either " +"the alias or the normalized name. If the module is found and defines a valid " "``getregentry()`` function that returns a :class:`codecs.CodecInfo` object, " "the codec is cached and returned." msgstr "" @@ -2196,6 +2209,11 @@ msgid "" "encoding and :mod:`stringprep`." msgstr "" +msgid "" +"This module builds on ``punycode``, whose algorithms scale poorly, so limit " +"the length of untrusted input." +msgstr "" + msgid "" "If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the " "third-party :pypi:`idna` module." @@ -2203,15 +2221,15 @@ msgstr "" msgid "" "These RFCs together define a protocol to support non-ASCII characters in " -"domain names. A domain name containing non-ASCII characters (such as ``www." -"Alliancefrançaise.nu``) is converted into an ASCII-compatible encoding (ACE, " -"such as ``www.xn--alliancefranaise-npb.nu``). The ACE form of the domain " -"name is then used in all places where arbitrary characters are not allowed " -"by the protocol, such as DNS queries, HTTP :mailheader:`Host` fields, and so " -"on. This conversion is carried out in the application; if possible invisible " -"to the user: The application should transparently convert Unicode domain " -"labels to IDNA on the wire, and convert back ACE labels to Unicode before " -"presenting them to the user." +"domain names. A domain name containing non-ASCII characters (such as " +"``www.Alliancefrançaise.nu``) is converted into an ASCII-compatible encoding " +"(ACE, such as ``www.xn--alliancefranaise-npb.nu``). The ACE form of the " +"domain name is then used in all places where arbitrary characters are not " +"allowed by the protocol, such as DNS queries, HTTP :mailheader:`Host` " +"fields, and so on. This conversion is carried out in the application; if " +"possible invisible to the user: The application should transparently convert " +"Unicode domain labels to IDNA on the wire, and convert back ACE labels to " +"Unicode before presenting them to the user." msgstr "" msgid "" @@ -2224,8 +2242,8 @@ msgid "" "the :mod:`socket` module transparently converts Unicode host names to ACE, " "so that applications need not be concerned about converting host names " "themselves when they pass them to the socket module. On top of that, modules " -"that have host names as function parameters, such as :mod:`http.client` and :" -"mod:`ftplib`, accept Unicode host names (:mod:`http.client` then also " +"that have host names as function parameters, such as :mod:`http.client` " +"and :mod:`ftplib`, accept Unicode host names (:mod:`http.client` then also " "transparently sends an IDNA hostname in the :mailheader:`Host` field if it " "sends that field at all)." msgstr "" diff --git a/library/codeop.po b/library/codeop.po index 32710786c5..0d7555fc68 100644 --- a/library/codeop.po +++ b/library/codeop.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -67,16 +67,16 @@ msgid "" msgstr "" msgid "" -"If there is a problem with *source*, an exception will be raised. :exc:" -"`SyntaxError` is raised if there is invalid Python syntax, and :exc:" -"`OverflowError` or :exc:`ValueError` if there is an invalid literal." +"If there is a problem with *source*, an exception will be " +"raised. :exc:`SyntaxError` is raised if there is invalid Python syntax, " +"and :exc:`OverflowError` or :exc:`ValueError` if there is an invalid literal." msgstr "" msgid "" "The *symbol* argument determines whether *source* is compiled as a statement " "(``'single'``, the default), as a sequence of :term:`statement` (``'exec'``) " -"or as an :term:`expression` (``'eval'``). Any other value will cause :exc:" -"`ValueError` to be raised." +"or as an :term:`expression` (``'eval'``). Any other value will " +"cause :exc:`ValueError` to be raised." msgstr "" msgid "" diff --git a/library/collections.abc.po b/library/collections.abc.po index a536e37537..db8d3c42d6 100644 --- a/library/collections.abc.po +++ b/library/collections.abc.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,8 +35,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/_collections_abc.py`" msgid "" "This module provides :term:`abstract base classes ` " "that can be used to test whether a class provides a particular interface; " -"for example, whether it is :term:`hashable` or whether it is a :term:" -"`mapping`." +"for example, whether it is :term:`hashable` or whether it is " +"a :term:`mapping`." msgstr "" msgid "" @@ -106,9 +106,9 @@ msgstr "" msgid "" "In this example, class :class:`!D` does not need to define ``__contains__``, " "``__iter__``, and ``__reversed__`` because the :ref:`in-operator " -"`, the :term:`iteration ` logic, and the :func:" -"`reversed` function automatically fall back to using ``__getitem__`` and " -"``__len__``." +"`, the :term:`iteration ` logic, and " +"the :func:`reversed` function automatically fall back to using " +"``__getitem__`` and ``__len__``." msgstr "" msgid "" @@ -399,8 +399,8 @@ msgid "" "Checking ``isinstance(obj, Iterable)`` detects classes that are registered " "as :class:`Iterable` or that have an :meth:`~container.__iter__` method, but " "it does not detect classes that iterate with the :meth:`~object.__getitem__` " -"method. The only reliable way to determine whether an object is :term:" -"`iterable` is to call ``iter(obj)``." +"method. The only reliable way to determine whether an object " +"is :term:`iterable` is to call ``iter(obj)``." msgstr "" msgid "Collections Abstract Base Classes -- Detailed Descriptions" @@ -430,16 +430,17 @@ msgid "" "Checking ``isinstance(obj, Iterable)`` detects classes that are registered " "as :class:`Iterable` or that have an :meth:`~container.__iter__` method, but " "it does not detect classes that iterate with the :meth:`~object.__getitem__` " -"method. The only reliable way to determine whether an object is :term:" -"`iterable` is to call ``iter(obj)``." +"method. The only reliable way to determine whether an object " +"is :term:`iterable` is to call ``iter(obj)``." msgstr "" msgid "ABC for sized iterable container classes." msgstr "" msgid "" -"ABC for classes that provide the :meth:`~iterator.__iter__` and :meth:" -"`~iterator.__next__` methods. See also the definition of :term:`iterator`." +"ABC for classes that provide the :meth:`~iterator.__iter__` " +"and :meth:`~iterator.__next__` methods. See also the definition " +"of :term:`iterator`." msgstr "" msgid "" @@ -448,28 +449,29 @@ msgid "" msgstr "" msgid "" -"ABC for :term:`generator` classes that implement the protocol defined in :" -"pep:`342` that extends :term:`iterators ` with the :meth:" -"`~generator.send`, :meth:`~generator.throw` and :meth:`~generator.close` " -"methods." +"ABC for :term:`generator` classes that implement the protocol defined " +"in :pep:`342` that extends :term:`iterators ` with " +"the :meth:`~generator.send`, :meth:`~generator.throw` " +"and :meth:`~generator.close` methods." msgstr "" msgid "" -"See :ref:`annotating-generators-and-coroutines` for details on using :class:" -"`!Generator` in type annotations." +"See :ref:`annotating-generators-and-coroutines` for details on " +"using :class:`!Generator` in type annotations." msgstr "" msgid "ABCs for read-only and mutable :term:`sequences `." msgstr "" msgid "" -"Implementation note: Some of the mixin methods, such as :meth:`~container." -"__iter__`, :meth:`~object.__reversed__`, and :meth:`~sequence.index` make " -"repeated calls to the underlying :meth:`~object.__getitem__` method. " -"Consequently, if :meth:`~object.__getitem__` is implemented with constant " -"access speed, the mixin methods will have linear performance; however, if " -"the underlying method is linear (as it would be with a linked list), the " -"mixins will have quadratic performance and will likely need to be overridden." +"Implementation note: Some of the mixin methods, such " +"as :meth:`~container.__iter__`, :meth:`~object.__reversed__`, " +"and :meth:`~sequence.index` make repeated calls to the " +"underlying :meth:`~object.__getitem__` method. Consequently, " +"if :meth:`~object.__getitem__` is implemented with constant access speed, " +"the mixin methods will have linear performance; however, if the underlying " +"method is linear (as it would be with a linked list), the mixins will have " +"quadratic performance and will likely need to be overridden." msgstr "" msgid "Return first index of *value*." @@ -523,13 +525,13 @@ msgstr "" msgid "" "ABC for :term:`awaitable` objects, which can be used in :keyword:`await` " -"expressions. Custom implementations must provide the :meth:`~object." -"__await__` method." +"expressions. Custom implementations must provide " +"the :meth:`~object.__await__` method." msgstr "" msgid "" -":term:`Coroutine ` objects and instances of the :class:" -"`~collections.abc.Coroutine` ABC are all instances of this ABC." +":term:`Coroutine ` objects and instances of " +"the :class:`~collections.abc.Coroutine` ABC are all instances of this ABC." msgstr "" msgid "" @@ -542,10 +544,11 @@ msgstr "" msgid "" "ABC for :term:`coroutine` compatible classes. These implement the following " -"methods, defined in :ref:`coroutine-objects`: :meth:`~coroutine.send`, :meth:" -"`~coroutine.throw`, and :meth:`~coroutine.close`. Custom implementations " -"must also implement :meth:`~object.__await__`. All :class:`Coroutine` " -"instances are also instances of :class:`Awaitable`." +"methods, defined in :ref:`coroutine-" +"objects`: :meth:`~coroutine.send`, :meth:`~coroutine.throw`, " +"and :meth:`~coroutine.close`. Custom implementations must also " +"implement :meth:`~object.__await__`. All :class:`Coroutine` instances are " +"also instances of :class:`Awaitable`." msgstr "" msgid "" @@ -557,9 +560,9 @@ msgid "" msgstr "" msgid "" -"See :ref:`annotating-generators-and-coroutines` for details on using :class:" -"`!Coroutine` in type annotations. The variance and order of type parameters " -"correspond to those of :class:`Generator`." +"See :ref:`annotating-generators-and-coroutines` for details on " +"using :class:`!Coroutine` in type annotations. The variance and order of " +"type parameters correspond to those of :class:`Generator`." msgstr "" msgid "" @@ -578,8 +581,8 @@ msgid "" msgstr "" msgid "" -"See :ref:`annotating-generators-and-coroutines` for details on using :class:" -"`!AsyncGenerator` in type annotations." +"See :ref:`annotating-generators-and-coroutines` for details on " +"using :class:`!AsyncGenerator` in type annotations." msgstr "" msgid "" @@ -605,9 +608,10 @@ msgid "" "Several of the ABCs are also useful as mixins that make it easier to develop " "classes supporting container APIs. For example, to write a class supporting " "the full :class:`Set` API, it is only necessary to supply the three " -"underlying abstract methods: :meth:`~object.__contains__`, :meth:`~container." -"__iter__`, and :meth:`~object.__len__`. The ABC supplies the remaining " -"methods such as :meth:`!__and__` and :meth:`~frozenset.isdisjoint`::" +"underlying abstract " +"methods: :meth:`~object.__contains__`, :meth:`~container.__iter__`, " +"and :meth:`~object.__len__`. The ABC supplies the remaining methods such " +"as :meth:`!__and__` and :meth:`~frozenset.isdisjoint`::" msgstr "" msgid "" @@ -642,12 +646,12 @@ msgid "" "Since some set operations create new sets, the default mixin methods need a " "way to create new instances from an :term:`iterable`. The class constructor " "is assumed to have a signature in the form ``ClassName(iterable)``. That " -"assumption is factored-out to an internal :class:`classmethod` called :meth:" -"`!_from_iterable` which calls ``cls(iterable)`` to produce a new set. If " -"the :class:`Set` mixin is being used in a class with a different constructor " -"signature, you will need to override :meth:`!_from_iterable` with a " -"classmethod or regular method that can construct new instances from an " -"iterable argument." +"assumption is factored-out to an internal :class:`classmethod` " +"called :meth:`!_from_iterable` which calls ``cls(iterable)`` to produce a " +"new set. If the :class:`Set` mixin is being used in a class with a different " +"constructor signature, you will need to override :meth:`!_from_iterable` " +"with a classmethod or regular method that can construct new instances from " +"an iterable argument." msgstr "" msgid "" @@ -660,7 +664,7 @@ msgid "" "The :class:`Set` mixin provides a :meth:`!_hash` method to compute a hash " "value for the set; however, :meth:`~object.__hash__` is not defined because " "not all sets are :term:`hashable` or immutable. To add set hashability " -"using mixins, inherit from both :meth:`Set` and :meth:`Hashable`, then " +"using mixins, inherit from both :class:`Set` and :class:`Hashable`, then " "define ``__hash__ = Set._hash``." msgstr "" diff --git a/library/collections.po b/library/collections.po index 65cf10447f..4c1fe2fcd2 100644 --- a/library/collections.po +++ b/library/collections.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,8 +32,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/collections/__init__.py`" msgid "" "This module implements specialized container datatypes providing " -"alternatives to Python's general purpose built-in containers, :class:" -"`dict`, :class:`list`, :class:`set`, and :class:`tuple`." +"alternatives to Python's general purpose built-in " +"containers, :class:`dict`, :class:`list`, :class:`set`, and :class:`tuple`." msgstr "" msgid ":func:`namedtuple`" @@ -159,10 +160,11 @@ msgstr "" msgid "" "Property returning a new :class:`ChainMap` containing all of the maps in the " "current instance except the first one. This is useful for skipping the " -"first map in the search. Use cases are similar to those for the :keyword:" -"`nonlocal` keyword used in :term:`nested scopes `. The use " -"cases also parallel those for the built-in :func:`super` function. A " -"reference to ``d.parents`` is equivalent to: ``ChainMap(*d.maps[1:])``." +"first map in the search. Use cases are similar to those for " +"the :keyword:`nonlocal` keyword used in :term:`nested scopes `. The use cases also parallel those for the built-in :func:`super` " +"function. A reference to ``d.parents`` is equivalent to: " +"``ChainMap(*d.maps[1:])``." msgstr "" msgid "" @@ -206,9 +208,9 @@ msgstr "" msgid "" "Django's `Context class `_ for templating is a read-only chain of mappings. It " -"also features pushing and popping of contexts similar to the :meth:" -"`~collections.ChainMap.new_child` method and the :attr:`~collections." -"ChainMap.parents` property." +"also features pushing and popping of contexts similar to " +"the :meth:`~collections.ChainMap.new_child` method and " +"the :attr:`~collections.ChainMap.parents` property." msgstr "" msgid "" @@ -219,8 +221,8 @@ msgid "" msgstr "" msgid "" -"A `greatly simplified read-only version of Chainmap `_." +"A `greatly simplified read-only version of Chainmap `_." msgstr "" msgid ":class:`ChainMap` Examples and Recipes" @@ -504,9 +506,9 @@ msgstr "" msgid "" "For in-place operations such as ``c[key] += 1``, the value type need only " "support addition and subtraction. So fractions, floats, and decimals would " -"work and negative values are supported. The same is also true for :meth:" -"`~Counter.update` and :meth:`~Counter.subtract` which allow negative and " -"zero values for both inputs and outputs." +"work and negative values are supported. The same is also true " +"for :meth:`~Counter.update` and :meth:`~Counter.subtract` which allow " +"negative and zero values for both inputs and outputs." msgstr "" msgid "" @@ -522,8 +524,8 @@ msgid "" msgstr "" msgid "" -"`Bag class `_ in Smalltalk." +"`Bag class `_ in Smalltalk." msgstr "" msgid "" @@ -583,6 +585,9 @@ msgid "" "only the most recent activity is of interest." msgstr "" +msgid "Deques are :ref:`generic ` over the type of their contents." +msgstr "" + msgid "Deque objects support the following methods:" msgstr "" @@ -622,8 +627,8 @@ msgid "Insert *value* into the deque at position *index*." msgstr "" msgid "" -"If the insertion would cause a bounded deque to grow beyond *maxlen*, an :" -"exc:`IndexError` is raised." +"If the insertion would cause a bounded deque to grow beyond *maxlen*, " +"an :exc:`IndexError` is raised." msgstr "" msgid "" @@ -637,8 +642,8 @@ msgid "" msgstr "" msgid "" -"Remove the first occurrence of *value*. If not found, raises a :exc:" -"`ValueError`." +"Remove the first occurrence of *value*. If not found, raises " +"a :exc:`ValueError`." msgstr "" msgid "Reverse the elements of the deque in-place and then return ``None``." @@ -772,11 +777,11 @@ msgstr "" msgid "" "A `round-robin scheduler `_ can be implemented with input iterators stored in a :" -"class:`deque`. Values are yielded from the active iterator in position " -"zero. If that iterator is exhausted, it can be removed with :meth:`~deque." -"popleft`; otherwise, it can be cycled back to the end with the :meth:`~deque." -"rotate` method::" +"robin_scheduling>`_ can be implemented with input iterators stored in " +"a :class:`deque`. Values are yielded from the active iterator in position " +"zero. If that iterator is :term:`exhausted`, it can be removed " +"with :meth:`~deque.popleft`; otherwise, it can be cycled back to the end " +"with the :meth:`~deque.rotate` method::" msgstr "" msgid "" @@ -807,12 +812,13 @@ msgid "" msgstr "" msgid "" -"To implement :class:`deque` slicing, use a similar approach applying :meth:" -"`~deque.rotate` to bring a target element to the left side of the deque. " -"Remove old entries with :meth:`~deque.popleft`, add new entries with :meth:" -"`~deque.extend`, and then reverse the rotation. With minor variations on " -"that approach, it is easy to implement Forth style stack manipulations such " -"as ``dup``, ``drop``, ``swap``, ``over``, ``pick``, ``rot``, and ``roll``." +"To implement :class:`deque` slicing, use a similar approach " +"applying :meth:`~deque.rotate` to bring a target element to the left side of " +"the deque. Remove old entries with :meth:`~deque.popleft`, add new entries " +"with :meth:`~deque.extend`, and then reverse the rotation. With minor " +"variations on that approach, it is easy to implement Forth style stack " +"manipulations such as ``dup``, ``drop``, ``swap``, ``over``, ``pick``, " +"``rot``, and ``roll``." msgstr "" msgid ":class:`defaultdict` objects" @@ -826,10 +832,15 @@ msgid "" msgstr "" msgid "" -"The first argument provides the initial value for the :attr:" -"`default_factory` attribute; it defaults to ``None``. All remaining " -"arguments are treated the same as if they were passed to the :class:`dict` " -"constructor, including keyword arguments." +"The first argument provides the initial value for " +"the :attr:`default_factory` attribute; it defaults to ``None``. All " +"remaining arguments are treated the same as if they were passed to " +"the :class:`dict` constructor, including keyword arguments." +msgstr "" + +msgid "" +":class:`!defaultdict`\\s are :ref:`generic ` over two types, " +"signifying (respectively) the types of the dictionary's keys and values." msgstr "" msgid "" @@ -838,8 +849,8 @@ msgid "" msgstr "" msgid "" -"If the :attr:`default_factory` attribute is ``None``, this raises a :exc:" -"`KeyError` exception with the *key* as argument." +"If the :attr:`default_factory` attribute is ``None``, this raises " +"a :exc:`KeyError` exception with the *key* as argument." msgstr "" msgid "" @@ -854,16 +865,16 @@ msgid "" msgstr "" msgid "" -"This method is called by the :meth:`~object.__getitem__` method of the :" -"class:`dict` class when the requested key is not found; whatever it returns " -"or raises is then returned or raised by :meth:`~object.__getitem__`." +"This method is called by the :meth:`~object.__getitem__` method of " +"the :class:`dict` class when the requested key is not found; whatever it " +"returns or raises is then returned or raised by :meth:`~object.__getitem__`." msgstr "" msgid "" -"Note that :meth:`__missing__` is *not* called for any operations besides :" -"meth:`~object.__getitem__`. This means that :meth:`~dict.get` will, like " -"normal dictionaries, return ``None`` as a default rather than using :attr:" -"`default_factory`." +"Note that :meth:`__missing__` is *not* called for any operations " +"besides :meth:`~object.__getitem__`. This means that :meth:`~dict.get` will, " +"like normal dictionaries, return ``None`` as a default rather than " +"using :attr:`default_factory`." msgstr "" msgid ":class:`defaultdict` objects support the following instance variable:" @@ -889,26 +900,27 @@ msgstr "" msgid "" "When each key is encountered for the first time, it is not already in the " -"mapping; so an entry is automatically created using the :attr:`~defaultdict." -"default_factory` function which returns an empty :class:`list`. The :meth:" -"`list.append` operation then attaches the value to the new list. When keys " -"are encountered again, the look-up proceeds normally (returning the list for " -"that key) and the :meth:`list.append` operation adds another value to the " -"list. This technique is simpler and faster than an equivalent technique " +"mapping; so an entry is automatically created using " +"the :attr:`~defaultdict.default_factory` function which returns an " +"empty :class:`list`. The :meth:`list.append` operation then attaches the " +"value to the new list. When keys are encountered again, the look-up " +"proceeds normally (returning the list for that key) and " +"the :meth:`list.append` operation adds another value to the list. This " +"technique is simpler and faster than an equivalent technique " "using :meth:`dict.setdefault`:" msgstr "" msgid "" -"Setting the :attr:`~defaultdict.default_factory` to :class:`int` makes the :" -"class:`defaultdict` useful for counting (like a bag or multiset in other " -"languages):" +"Setting the :attr:`~defaultdict.default_factory` to :class:`int` makes " +"the :class:`defaultdict` useful for counting (like a bag or multiset in " +"other languages):" msgstr "" msgid "" -"When a letter is first encountered, it is missing from the mapping, so the :" -"attr:`~defaultdict.default_factory` function calls :func:`int` to supply a " -"default count of zero. The increment operation then builds up the count for " -"each letter." +"When a letter is first encountered, it is missing from the mapping, so " +"the :attr:`~defaultdict.default_factory` function calls :func:`int` to " +"supply a default count of zero. The increment operation then builds up the " +"count for each letter." msgstr "" msgid "" @@ -919,8 +931,8 @@ msgid "" msgstr "" msgid "" -"Setting the :attr:`~defaultdict.default_factory` to :class:`set` makes the :" -"class:`defaultdict` useful for building a dictionary of sets:" +"Setting the :attr:`~defaultdict.default_factory` to :class:`set` makes " +"the :class:`defaultdict` useful for building a dictionary of sets:" msgstr "" msgid ":func:`namedtuple` Factory Function for Tuples with Named Fields" @@ -937,9 +949,9 @@ msgid "" "Returns a new tuple subclass named *typename*. The new subclass is used to " "create tuple-like objects that have fields accessible by attribute lookup as " "well as being indexable and iterable. Instances of the subclass also have a " -"helpful docstring (with *typename* and *field_names*) and a helpful :meth:" -"`~object.__repr__` method which lists the tuple contents in a ``name=value`` " -"format." +"helpful docstring (with *typename* and *field_names*) and a " +"helpful :meth:`~object.__repr__` method which lists the tuple contents in a " +"``name=value`` format." msgstr "" msgid "" @@ -951,8 +963,9 @@ msgstr "" msgid "" "Any valid Python identifier may be used for a fieldname except for names " "starting with an underscore. Valid identifiers consist of letters, digits, " -"and underscores but do not start with a digit or underscore and cannot be a :" -"mod:`keyword` such as *class*, *for*, *return*, *global*, *pass*, or *raise*." +"and underscores but do not start with a digit or underscore and cannot be " +"a :mod:`keyword` such as *class*, *for*, *return*, *global*, *pass*, or " +"*raise*." msgstr "" msgid "" @@ -995,14 +1008,14 @@ msgid "" msgstr "" msgid "Added the *module* parameter." -msgstr "" +msgstr "Dodany parametr *module*." msgid "Removed the *verbose* parameter and the :attr:`!_source` attribute." msgstr "" msgid "" -"Added the *defaults* parameter and the :attr:`~somenamedtuple." -"_field_defaults` attribute." +"Added the *defaults* parameter and " +"the :attr:`~somenamedtuple._field_defaults` attribute." msgstr "" msgid "" @@ -1138,8 +1151,8 @@ msgid "" msgstr "" msgid "" -"To retrieve a field whose name is stored in a string, use the :func:" -"`getattr` function:" +"To retrieve a field whose name is stored in a string, use " +"the :func:`getattr` function:" msgstr "" msgid "" @@ -1328,15 +1341,15 @@ msgid "" msgstr "" msgid "" -"Equality tests between :class:`OrderedDict` objects and other :class:" -"`~collections.abc.Mapping` objects are order-insensitive like regular " -"dictionaries. This allows :class:`OrderedDict` objects to be substituted " -"anywhere a regular dictionary is used." +"Equality tests between :class:`OrderedDict` objects and " +"other :class:`~collections.abc.Mapping` objects are order-insensitive like " +"regular dictionaries. This allows :class:`OrderedDict` objects to be " +"substituted anywhere a regular dictionary is used." msgstr "" msgid "" -"The items, keys, and values :term:`views ` of :class:" -"`OrderedDict` now support reverse iteration using :func:`reversed`." +"The items, keys, and values :term:`views ` " +"of :class:`OrderedDict` now support reverse iteration using :func:`reversed`." msgstr "" msgid "" @@ -1365,13 +1378,13 @@ msgid "" msgstr "" msgid "" -"An :class:`OrderedDict` would also be useful for implementing variants of :" -"func:`functools.lru_cache`:" +"An :class:`OrderedDict` would also be useful for implementing variants " +"of :deco:`functools.lru_cache`:" msgstr "" msgid "" "from collections import OrderedDict\n" -"from time import time\n" +"from time import monotonic\n" "\n" "class TimeBoundedLRU:\n" " \"LRU Cache that invalidates and refreshes old entries.\"\n" @@ -1386,10 +1399,10 @@ msgid "" " if args in self.cache:\n" " self.cache.move_to_end(args)\n" " timestamp, result = self.cache[args]\n" -" if time() - timestamp <= self.maxage:\n" +" if monotonic() - timestamp <= self.maxage:\n" " return result\n" " result = self.func(*args)\n" -" self.cache[args] = time(), result\n" +" self.cache[args] = monotonic(), result\n" " if len(self.cache) > self.maxsize:\n" " self.cache.popitem(last=False)\n" " return result" @@ -1444,9 +1457,9 @@ msgstr "" msgid "" "Class that simulates a dictionary. The instance's contents are kept in a " -"regular dictionary, which is accessible via the :attr:`data` attribute of :" -"class:`!UserDict` instances. If arguments are provided, they are used to " -"initialize :attr:`data`, like a regular dictionary." +"regular dictionary, which is accessible via the :attr:`data` attribute " +"of :class:`!UserDict` instances. If arguments are provided, they are used " +"to initialize :attr:`data`, like a regular dictionary." msgstr "" msgid "" @@ -1476,20 +1489,20 @@ msgstr "" msgid "" "Class that simulates a list. The instance's contents are kept in a regular " -"list, which is accessible via the :attr:`data` attribute of :class:" -"`UserList` instances. The instance's contents are initially set to a copy " -"of *list*, defaulting to the empty list ``[]``. *list* can be any iterable, " -"for example a real Python list or a :class:`UserList` object." +"list, which is accessible via the :attr:`data` attribute " +"of :class:`UserList` instances. The instance's contents are initially set " +"to a copy of *list*, defaulting to the empty list ``[]``. *list* can be any " +"iterable, for example a real Python list or a :class:`UserList` object." msgstr "" msgid "" -"In addition to supporting the methods and operations of mutable sequences, :" -"class:`UserList` instances provide the following attribute:" +"In addition to supporting the methods and operations of mutable " +"sequences, :class:`UserList` instances provide the following attribute:" msgstr "" msgid "" -"A real :class:`list` object used to store the contents of the :class:" -"`UserList` class." +"A real :class:`list` object used to store the contents of " +"the :class:`UserList` class." msgstr "" msgid "" @@ -1527,13 +1540,13 @@ msgid "" msgstr "" msgid "" -"In addition to supporting the methods and operations of strings, :class:" -"`UserString` instances provide the following attribute:" +"In addition to supporting the methods and operations of " +"strings, :class:`UserString` instances provide the following attribute:" msgstr "" msgid "" -"A real :class:`str` object used to store the contents of the :class:" -"`UserString` class." +"A real :class:`str` object used to store the contents of " +"the :class:`UserString` class." msgstr "" msgid "" diff --git a/library/colorsys.po b/library/colorsys.po index f90478ea0a..c9366a37c2 100644 --- a/library/colorsys.po +++ b/library/colorsys.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,9 +40,9 @@ msgid "" msgstr "" msgid "" -"More information about color spaces can be found at https://poynton.ca/" -"ColorFAQ.html and https://www.cambridgeincolour.com/tutorials/color-spaces." -"htm." +"More information about color spaces can be found at https://www.poynton.ca/" +"pdf/ColourFAQ.pdf and https://www.cambridgeincolour.com/tutorials/color-" +"spaces.htm." msgstr "" msgid "The :mod:`!colorsys` module defines the following functions:" diff --git a/library/compileall.po b/library/compileall.po index ea800d6d5b..056866924a 100644 --- a/library/compileall.po +++ b/library/compileall.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -133,9 +133,9 @@ msgid "" "values cause hash-based pycs to be generated. Hash-based pycs embed a hash " "of the source file contents rather than a timestamp. See :ref:`pyc-" "invalidation` for more information on how Python validates bytecode cache " -"files at runtime. The default is ``timestamp`` if the :envvar:" -"`SOURCE_DATE_EPOCH` environment variable is not set, and ``checked-hash`` if " -"the ``SOURCE_DATE_EPOCH`` environment variable is set." +"files at runtime. The default is ``timestamp`` if " +"the :envvar:`SOURCE_DATE_EPOCH` environment variable is not set, and " +"``checked-hash`` if the ``SOURCE_DATE_EPOCH`` environment variable is set." msgstr "" msgid "" @@ -177,19 +177,19 @@ msgid "" msgstr "" msgid "" -"Similarly, the :func:`compile` function respects the :data:`sys." -"pycache_prefix` setting. The generated bytecode cache will only be useful " -"if :func:`compile` is run with the same :data:`sys.pycache_prefix` (if any) " -"that will be used at runtime." +"Similarly, the :func:`compile` function respects " +"the :data:`sys.pycache_prefix` setting. The generated bytecode cache will " +"only be useful if :func:`compile` is run with the " +"same :data:`sys.pycache_prefix` (if any) that will be used at runtime." msgstr "" msgid "Public functions" msgstr "" msgid "" -"Recursively descend the directory tree named by *dir*, compiling all :file:`." -"py` files along the way. Return a true value if all the files compiled " -"successfully, and a false value otherwise." +"Recursively descend the directory tree named by *dir*, compiling " +"all :file:`.py` files along the way. Return a true value if all the files " +"compiled successfully, and a false value otherwise." msgstr "" msgid "" @@ -243,14 +243,14 @@ msgid "" "in parallel. The default is to not use multiple workers. If the platform " "can't use multiple workers and *workers* argument is given, then sequential " "compilation will be used as a fallback. If *workers* is 0, the number of " -"cores in the system is used. If *workers* is lower than ``0``, a :exc:" -"`ValueError` will be raised." +"cores in the system is used. If *workers* is lower than ``0``, " +"a :exc:`ValueError` will be raised." msgstr "" msgid "" -"*invalidation_mode* should be a member of the :class:`py_compile." -"PycInvalidationMode` enum and controls how the generated pycs are " -"invalidated at runtime." +"*invalidation_mode* should be a member of " +"the :class:`py_compile.PycInvalidationMode` enum and controls how the " +"generated pycs are invalidated at runtime." msgstr "" msgid "" @@ -294,8 +294,8 @@ msgstr "" msgid "" "Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* " -"arguments. Default value of *maxlevels* was changed from ``10`` to ``sys." -"getrecursionlimit()``" +"arguments. Default value of *maxlevels* was changed from ``10`` to " +"``sys.getrecursionlimit()``" msgstr "" msgid "" @@ -332,9 +332,9 @@ msgstr "" msgid "" "If *skip_curdir* is true (the default), the current directory is not " -"included in the search. All other parameters are passed to the :func:" -"`compile_dir` function. Note that unlike the other compile functions, " -"``maxlevels`` defaults to ``0``." +"included in the search. All other parameters are passed to " +"the :func:`compile_dir` function. Note that unlike the other compile " +"functions, ``maxlevels`` defaults to ``0``." msgstr "" msgid "" diff --git a/library/compression.zstd.po b/library/compression.zstd.po index 0895cb0263..a9c8804e3f 100644 --- a/library/compression.zstd.po +++ b/library/compression.zstd.po @@ -4,17 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-13 20:58+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -61,13 +60,14 @@ msgid "" msgstr "" msgid "" -"The :func:`train_dict` and :func:`finalize_dict` functions and the :class:" -"`ZstdDict` class to train and manage Zstandard dictionaries." +"The :func:`train_dict` and :func:`finalize_dict` functions and " +"the :class:`ZstdDict` class to train and manage Zstandard dictionaries." msgstr "" msgid "" -"The :class:`CompressionParameter`, :class:`DecompressionParameter`, and :" -"class:`Strategy` classes for setting advanced (de)compression parameters." +"The :class:`CompressionParameter`, :class:`DecompressionParameter`, " +"and :class:`Strategy` classes for setting advanced (de)compression " +"parameters." msgstr "" msgid "" @@ -78,8 +78,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "Exceptions" msgstr "Wyjątki" @@ -93,15 +93,15 @@ msgid "Reading and writing compressed files" msgstr "" msgid "" -"Open a Zstandard-compressed file in binary or text mode, returning a :term:" -"`file object`." +"Open a Zstandard-compressed file in binary or text mode, returning " +"a :term:`file object`." msgstr "" msgid "" -"The *file* argument can be either a file name (given as a :class:`str`, :" -"class:`bytes` or :term:`path-like ` object), in which case " -"the named file is opened, or it can be an existing file object to read from " -"or write to." +"The *file* argument can be either a file name (given as " +"a :class:`str`, :class:`bytes` or :term:`path-like ` " +"object), in which case the named file is opened, or it can be an existing " +"file object to read from or write to." msgstr "" msgid "" @@ -115,9 +115,9 @@ msgstr "" msgid "" "When reading, the *options* argument can be a dictionary providing advanced " "decompression parameters; see :class:`DecompressionParameter` for detailed " -"information about supported parameters. The *zstd_dict* argument is a :class:" -"`ZstdDict` instance to be used during decompression. When reading, if the " -"*level* argument is not None, a :exc:`!TypeError` will be raised." +"information about supported parameters. The *zstd_dict* argument is " +"a :class:`ZstdDict` instance to be used during decompression. When reading, " +"if the *level* argument is not None, a :exc:`!TypeError` will be raised." msgstr "" msgid "" @@ -125,8 +125,8 @@ msgid "" "compression parameters; see :class:`CompressionParameter` for detailed " "information about supported parameters. The *level* argument is the " "compression level to use when writing compressed data. Only one of *level* " -"or *options* may be non-None. The *zstd_dict* argument is a :class:" -"`ZstdDict` instance to be used during compression." +"or *options* may be non-None. The *zstd_dict* argument is " +"a :class:`ZstdDict` instance to be used during compression." msgstr "" msgid "" @@ -136,8 +136,8 @@ msgid "" msgstr "" msgid "" -"In text mode, a :class:`ZstdFile` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"In text mode, a :class:`ZstdFile` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line endings." msgstr "" @@ -147,10 +147,10 @@ msgstr "" msgid "" "A :class:`ZstdFile` can wrap an already-open :term:`file object`, or operate " "directly on a named file. The *file* argument specifies either the file " -"object to wrap, or the name of the file to open (as a :class:`str`, :class:" -"`bytes` or :term:`path-like ` object). If wrapping an " -"existing file object, the wrapped file will not be closed when the :class:" -"`ZstdFile` is closed." +"object to wrap, or the name of the file to open (as " +"a :class:`str`, :class:`bytes` or :term:`path-like ` " +"object). If wrapping an existing file object, the wrapped file will not be " +"closed when the :class:`ZstdFile` is closed." msgstr "" msgid "" @@ -175,9 +175,10 @@ msgid "" msgstr "" msgid "" -":class:`!ZstdFile` supports all the members specified by :class:`io." -"BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io." -"IOBase.truncate`. Iteration and the :keyword:`with` statement are supported." +":class:`!ZstdFile` supports all the members specified " +"by :class:`io.BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` " +"and :meth:`~io.IOBase.truncate`. Iteration and the :keyword:`with` statement " +"are supported." msgstr "" msgid "The following method and attributes are also provided:" @@ -190,10 +191,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`ZstdFile`, it may change the position of the underlying file object (for " -"example, if the :class:`ZstdFile` was constructed by passing a file object " -"for *file*)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`ZstdFile`, it may change the position of the underlying file " +"object (for example, if the :class:`ZstdFile` was constructed by passing a " +"file object for *file*)." msgstr "" msgid "``'rb'`` for reading and ``'wb'`` for writing." @@ -214,8 +215,9 @@ msgstr "" msgid "" "The *level* argument is an integer controlling the level of compression. " -"*level* is an alternative to setting :attr:`CompressionParameter." -"compression_level` in *options*. Use :meth:`~CompressionParameter.bounds` " +"*level* is an alternative to " +"setting :attr:`CompressionParameter.compression_level` in *options*. " +"Use :meth:`~CompressionParameter.bounds` " "on :attr:`~CompressionParameter.compression_level` to get the values that " "can be passed for *level*. If advanced compression options are needed, the " "*level* argument must be omitted and in the *options* dictionary the :attr:`!" @@ -230,8 +232,8 @@ msgstr "" msgid "" "The *zstd_dict* argument is an instance of :class:`ZstdDict` containing " -"trained data to improve compression efficiency. The function :func:" -"`train_dict` can be used to generate a Zstandard dictionary." +"trained data to improve compression efficiency. The " +"function :func:`train_dict` can be used to generate a Zstandard dictionary." msgstr "" msgid "" @@ -268,8 +270,8 @@ msgstr "" msgid "" "The *zstd_dict* argument is an optional instance of :class:`ZstdDict` " -"containing trained data to improve compression efficiency. The function :" -"func:`train_dict` can be used to generate a Zstandard dictionary." +"containing trained data to improve compression efficiency. The " +"function :func:`train_dict` can be used to generate a Zstandard dictionary." msgstr "" msgid "" @@ -281,8 +283,8 @@ msgid "" msgstr "" msgid "" -"The *mode* argument is a :class:`ZstdCompressor` attribute, either :attr:`~." -"CONTINUE`, :attr:`~.FLUSH_BLOCK`, or :attr:`~.FLUSH_FRAME`." +"The *mode* argument is a :class:`ZstdCompressor` attribute, " +"either :attr:`~.CONTINUE`, :attr:`~.FLUSH_BLOCK`, or :attr:`~.FLUSH_FRAME`." msgstr "" msgid "" @@ -298,8 +300,8 @@ msgid "" msgstr "" msgid "" -"The *mode* argument is a :class:`ZstdCompressor` attribute, either :attr:`~." -"FLUSH_BLOCK`, or :attr:`~.FLUSH_FRAME`." +"The *mode* argument is a :class:`ZstdCompressor` attribute, " +"either :attr:`~.FLUSH_BLOCK`, or :attr:`~.FLUSH_FRAME`." msgstr "" msgid "" @@ -321,9 +323,9 @@ msgid "" msgstr "" msgid "" -"After :meth:`flush` or :meth:`.compress` are called with mode :attr:" -"`FLUSH_FRAME`, the next frame will not include the frame size into the " -"header unless :meth:`!set_pledged_input_size` is called again." +"After :meth:`flush` or :meth:`.compress` are called with " +"mode :attr:`FLUSH_FRAME`, the next frame will not include the frame size " +"into the header unless :meth:`!set_pledged_input_size` is called again." msgstr "" msgid "" @@ -345,9 +347,9 @@ msgstr "" msgid "" "The last mode passed to either :meth:`~.compress` or :meth:`~.flush`. The " -"value can be one of :attr:`~.CONTINUE`, :attr:`~.FLUSH_BLOCK`, or :attr:`~." -"FLUSH_FRAME`. The initial value is :attr:`~.FLUSH_FRAME`, signifying that " -"the compressor is at the start of a new frame." +"value can be one of :attr:`~.CONTINUE`, :attr:`~.FLUSH_BLOCK`, " +"or :attr:`~.FLUSH_FRAME`. The initial value is :attr:`~.FLUSH_FRAME`, " +"signifying that the compressor is at the start of a new frame." msgstr "" msgid "" @@ -362,10 +364,10 @@ msgstr "" msgid "" "This class does not transparently handle inputs containing multiple " -"compressed frames, unlike the :func:`decompress` function and :class:" -"`ZstdFile` class. To decompress a multi-frame input, you should use :func:" -"`decompress`, :class:`ZstdFile` if working with a :term:`file object`, or " -"multiple :class:`!ZstdDecompressor` instances." +"compressed frames, unlike the :func:`decompress` function " +"and :class:`ZstdFile` class. To decompress a multi-frame input, you should " +"use :func:`decompress`, :class:`ZstdFile` if working with a :term:`file " +"object`, or multiple :class:`!ZstdDecompressor` instances." msgstr "" msgid "" @@ -390,9 +392,9 @@ msgid "" msgstr "" msgid "" -"Attempting to decompress data after the end of a frame will raise a :exc:" -"`ZstdError`. Any data found after the end of the frame is ignored and saved " -"in the :attr:`~.unused_data` attribute." +"Attempting to decompress data after the end of a frame will raise " +"a :exc:`EOFError`. Any data found after the end of the frame is ignored and " +"saved in the :attr:`~.unused_data` attribute." msgstr "" msgid "``True`` if the end-of-stream marker has been reached." @@ -443,8 +445,8 @@ msgid "" msgstr "" msgid "" -"The *zstd_dict* argument is a :class:`ZstdDict` instance with the :attr:" -"`~ZstdDict.dict_content` containing the raw dictionary contents." +"The *zstd_dict* argument is a :class:`ZstdDict` instance with " +"the :attr:`~ZstdDict.dict_content` containing the raw dictionary contents." msgstr "" msgid "" @@ -583,7 +585,7 @@ msgid "" msgstr "" msgid "" -"Parameters are optional; any omitted parameter will have it's value selected " +"Parameters are optional; any omitted parameter will have its value selected " "automatically." msgstr "" @@ -606,9 +608,9 @@ msgstr "" msgid "" "Return the tuple of int bounds, ``(lower, upper)``, of a compression " "parameter. This method should be called on the attribute you wish to " -"retrieve the bounds of. For example, to get the valid values for :attr:`~." -"compression_level`, one may check the result of ``CompressionParameter." -"compression_level.bounds()``." +"retrieve the bounds of. For example, to get the valid values " +"for :attr:`~.compression_level`, one may check the result of " +"``CompressionParameter.compression_level.bounds()``." msgstr "" msgid "Both the lower and upper bounds are inclusive." @@ -649,9 +651,10 @@ msgstr "" msgid "" "Size of the multi-probe search table, as a power of two. The resulting " "memory usage is ``1 << (chain_log+2)`` bytes. Larger tables result in better " -"and slower compression. This parameter has no effect for the :attr:" -"`~Strategy.fast` strategy. It's still useful when using :attr:`~Strategy." -"dfast` strategy, in which case it defines a secondary probe table." +"and slower compression. This parameter has no effect for " +"the :attr:`~Strategy.fast` strategy. It's still useful when " +"using :attr:`~Strategy.dfast` strategy, in which case it defines a secondary " +"probe table." msgstr "" msgid "" @@ -673,10 +676,10 @@ msgid "The impact of this field depends on the selected :class:`Strategy`." msgstr "" msgid "" -"For strategies :attr:`~Strategy.btopt`, :attr:`~Strategy.btultra` and :attr:" -"`~Strategy.btultra2`, the value is the length of a match considered \"good " -"enough\" to stop searching. Larger values make compression ratios better, " -"but compresses slower." +"For strategies :attr:`~Strategy.btopt`, :attr:`~Strategy.btultra` " +"and :attr:`~Strategy.btultra2`, the value is the length of a match " +"considered \"good enough\" to stop searching. Larger values make compression " +"ratios better, but compresses slower." msgstr "" msgid "" @@ -706,10 +709,11 @@ msgid "" msgstr "" msgid "" -"Enabling this parameter increases default :attr:`~CompressionParameter." -"window_log` to 128 MiB except when expressly set to a different value. This " -"setting is enabled by default if :attr:`!window_log` >= 128 MiB and the " -"compression strategy >= :attr:`~Strategy.btopt` (compression level 16+)." +"Enabling this parameter increases " +"default :attr:`~CompressionParameter.window_log` to 128 MiB except when " +"expressly set to a different value. This setting is enabled by default " +"if :attr:`!window_log` >= 128 MiB and the compression strategy " +">= :attr:`~Strategy.btopt` (compression level 16+)." msgstr "" msgid "" @@ -747,16 +751,16 @@ msgid "Calling :func:`compress` for one-shot compression" msgstr "" msgid "" -"Providing all of the data to be compressed in the frame in a single :meth:" -"`ZstdCompressor.compress` call, with the :attr:`ZstdCompressor.FLUSH_FRAME` " -"mode." +"Providing all of the data to be compressed in the frame in a " +"single :meth:`ZstdCompressor.compress` call, with " +"the :attr:`ZstdCompressor.FLUSH_FRAME` mode." msgstr "" msgid "" "Calling :meth:`ZstdCompressor.set_pledged_input_size` with the exact amount " -"of data that will be provided to the compressor prior to any calls to :meth:" -"`ZstdCompressor.compress` for the current frame. :meth:`!ZstdCompressor." -"set_pledged_input_size` must be called for each new frame." +"of data that will be provided to the compressor prior to any calls " +"to :meth:`ZstdCompressor.compress` for the current frame. :meth:`!" +"ZstdCompressor.set_pledged_input_size` must be called for each new frame." msgstr "" msgid "" @@ -791,20 +795,20 @@ msgid "" msgstr "" msgid "" -"Select how many threads will be spawned to compress in parallel. When :attr:" -"`!nb_workers` > 0, enables multi-threaded compression, a value of ``1`` " -"means \"one-thread multi-threaded mode\". More workers improve speed, but " -"also increase memory usage and slightly reduce compression ratio." +"Select how many threads will be spawned to compress in parallel. " +"When :attr:`!nb_workers` > 0, enables multi-threaded compression, a value of " +"``1`` means \"one-thread multi-threaded mode\". More workers improve speed, " +"but also increase memory usage and slightly reduce compression ratio." msgstr "" msgid "A value of zero disables multi-threading." msgstr "" msgid "" -"Size of a compression job, in bytes. This value is enforced only when :attr:" -"`~CompressionParameter.nb_workers` >= 1. Each compression job is completed " -"in parallel, so this value can indirectly impact the number of active " -"threads." +"Size of a compression job, in bytes. This value is enforced only " +"when :attr:`~CompressionParameter.nb_workers` >= 1. Each compression job is " +"completed in parallel, so this value can indirectly impact the number of " +"active threads." msgstr "" msgid "" @@ -831,7 +835,7 @@ msgstr "" msgid "" "An :class:`~enum.IntEnum` containing the advanced decompression parameter " "keys that can be used when decompressing data. Parameters are optional; any " -"omitted parameter will have it's value selected automatically." +"omitted parameter will have its value selected automatically." msgstr "" msgid "Example setting the :attr:`~.window_log_max` to the maximum size::" diff --git a/library/concurrent.futures.po b/library/concurrent.futures.po index 6d0ad27fd7..82c1f0cba3 100644 --- a/library/concurrent.futures.po +++ b/library/concurrent.futures.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,17 +38,17 @@ msgid "" msgstr "" msgid "" -"The asynchronous execution can be performed with threads, using :class:" -"`ThreadPoolExecutor` or :class:`InterpreterPoolExecutor`, or separate " -"processes, using :class:`ProcessPoolExecutor`. Each implements the same " -"interface, which is defined by the abstract :class:`Executor` class." +"The asynchronous execution can be performed with threads, " +"using :class:`ThreadPoolExecutor` or :class:`InterpreterPoolExecutor`, or " +"separate processes, using :class:`ProcessPoolExecutor`. Each implements the " +"same interface, which is defined by the abstract :class:`Executor` class." msgstr "" msgid "" -":class:`concurrent.futures.Future` must not be confused with :class:`asyncio." -"Future`, which is designed for use with :mod:`asyncio` tasks and coroutines. " -"See the :doc:`asyncio's Future ` documentation for a " -"detailed comparison of the two." +":class:`concurrent.futures.Future` must not be confused " +"with :class:`asyncio.Future`, which is designed for use with :mod:`asyncio` " +"tasks and coroutines. See the :doc:`asyncio's Future ` " +"documentation for a detailed comparison of the two." msgstr "" msgid "Availability" @@ -95,11 +95,11 @@ msgid "" msgstr "" msgid "" -"The returned iterator raises a :exc:`TimeoutError` if :meth:`~iterator." -"__next__` is called and the result isn't available after *timeout* seconds " -"from the original call to :meth:`Executor.map`. *timeout* can be an int or a " -"float. If *timeout* is not specified or ``None``, there is no limit to the " -"wait time." +"The returned iterator raises a :exc:`TimeoutError` " +"if :meth:`~iterator.__next__` is called and the result isn't available after " +"*timeout* seconds from the original call to :meth:`Executor.map`. *timeout* " +"can be an int or a float. If *timeout* is not specified or ``None``, there " +"is no limit to the wait time." msgstr "" msgid "" @@ -113,8 +113,8 @@ msgid "" "(approximate) size of these chunks can be specified by setting *chunksize* " "to a positive integer. For very long iterables, using a large value for " "*chunksize* can significantly improve performance compared to the default " -"size of 1. With :class:`ThreadPoolExecutor` and :class:" -"`InterpreterPoolExecutor`, *chunksize* has no effect." +"size of 1. With :class:`ThreadPoolExecutor` " +"and :class:`InterpreterPoolExecutor`, *chunksize* has no effect." msgstr "" msgid "Added the *chunksize* parameter." @@ -125,9 +125,9 @@ msgstr "" msgid "" "Signal the executor that it should free any resources that it is using when " -"the currently pending futures are done executing. Calls to :meth:`Executor." -"submit` and :meth:`Executor.map` made after shutdown will raise :exc:" -"`RuntimeError`." +"the currently pending futures are done executing. Calls " +"to :meth:`Executor.submit` and :meth:`Executor.map` made after shutdown will " +"raise :exc:`RuntimeError`." msgstr "" msgid "" @@ -168,7 +168,7 @@ msgid "" " e.submit(shutil.copy, 'src4.txt', 'dest4.txt')" msgstr "" -msgid "Added *cancel_futures*." +msgid "Added the *cancel_futures* parameter." msgstr "" msgid "ThreadPoolExecutor" @@ -240,18 +240,30 @@ msgid "" "well as any attempt to submit more jobs to the pool." msgstr "" +msgid "" +"*ctxkwargs* is a mapping of additional keyword arguments passed " +"to :meth:`prepare_context`, allowing customization of the worker execution " +"context." +msgstr "" + +msgid "" +"Setting up the necessary context for creating worker instances in a pool-" +"based executor (for example, in a concurrent environment like threads or " +"interpreters)." +msgstr "" + msgid "" "If *max_workers* is ``None`` or not given, it will default to the number of " -"processors on the machine, multiplied by ``5``, assuming that :class:" -"`ThreadPoolExecutor` is often used to overlap I/O instead of CPU work and " -"the number of workers should be higher than the number of workers for :class:" -"`ProcessPoolExecutor`." +"processors on the machine, multiplied by ``5``, assuming " +"that :class:`ThreadPoolExecutor` is often used to overlap I/O instead of CPU " +"work and the number of workers should be higher than the number of workers " +"for :class:`ProcessPoolExecutor`." msgstr "" msgid "" -"Added the *thread_name_prefix* parameter to allow users to control the :" -"class:`threading.Thread` names for worker threads created by the pool for " -"easier debugging." +"Added the *thread_name_prefix* parameter to allow users to control " +"the :class:`threading.Thread` names for worker threads created by the pool " +"for easier debugging." msgstr "" msgid "Added the *initializer* and *initargs* arguments." @@ -270,8 +282,13 @@ msgid "" msgstr "" msgid "" -"Default value of *max_workers* is changed to ``min(32, (os." -"process_cpu_count() or 1) + 4)``." +"Default value of *max_workers* is changed to ``min(32, " +"(os.process_cpu_count() or 1) + 4)``." +msgstr "" + +msgid "" +"Added *ctxkwargs* to pass additional arguments to :meth:`prepare_context` " +"class method." msgstr "" msgid "ThreadPoolExecutor Example" @@ -386,8 +403,8 @@ msgid "" msgstr "" msgid "" -"The executor may replace uncaught exceptions from *initializer* with :class:" -"`~concurrent.interpreters.ExecutionFailed`." +"The executor may replace uncaught exceptions from *initializer* " +"with :class:`~concurrent.interpreters.ExecutionFailed`." msgstr "" msgid "Other caveats from parent :class:`ThreadPoolExecutor` apply here." @@ -403,11 +420,13 @@ msgstr "" msgid "" "When a worker's current task raises an uncaught exception, the worker always " "tries to preserve the exception as-is. If that is successful then it also " -"sets the ``__cause__`` to a corresponding :class:`~concurrent.interpreters." -"ExecutionFailed` instance, which contains a summary of the original " -"exception. In the uncommon case that the worker is not able to preserve the " -"original as-is then it directly preserves the corresponding :class:" -"`~concurrent.interpreters.ExecutionFailed` instance instead." +"sets the ``__cause__`` to a " +"corresponding :class:`~concurrent.interpreters.ExecutionFailed` instance, " +"which contains a summary of the original exception. In the uncommon case " +"that the worker is not able to preserve the original as-is then it directly " +"preserves the " +"corresponding :class:`~concurrent.interpreters.ExecutionFailed` instance " +"instead." msgstr "" msgid "ProcessPoolExecutor" @@ -415,11 +434,11 @@ msgstr "" msgid "" "The :class:`ProcessPoolExecutor` class is an :class:`Executor` subclass that " -"uses a pool of processes to execute calls asynchronously. :class:" -"`ProcessPoolExecutor` uses the :mod:`multiprocessing` module, which allows " -"it to side-step the :term:`Global Interpreter Lock ` but also means that only picklable objects can be executed and " -"returned." +"uses a pool of processes to execute calls " +"asynchronously. :class:`ProcessPoolExecutor` uses the :mod:`multiprocessing` " +"module, which allows it to side-step the :term:`Global Interpreter Lock " +"` but also means that only picklable objects can be " +"executed and returned." msgstr "" msgid "" @@ -435,9 +454,10 @@ msgstr "" msgid "" "Note that the restrictions on functions and arguments needing to picklable " -"as per :class:`multiprocessing.Process` apply when using :meth:`~Executor." -"submit` and :meth:`~Executor.map` on a :class:`ProcessPoolExecutor`. A " -"function defined in a REPL or a lambda should not be expected to work." +"as per :class:`multiprocessing.Process` apply when " +"using :meth:`~Executor.submit` and :meth:`~Executor.map` on " +"a :class:`ProcessPoolExecutor`. A function defined in a REPL or a lambda " +"should not be expected to work." msgstr "" msgid "" @@ -450,8 +470,8 @@ msgid "" "the default chosen will be at most ``61``, even if more processors are " "available. *mp_context* can be a :mod:`multiprocessing` context or ``None``. " "It will be used to launch the workers. If *mp_context* is ``None`` or not " -"given, the default :mod:`multiprocessing` context is used. See :ref:" -"`multiprocessing-start-methods`." +"given, the default :mod:`multiprocessing` context is used. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" @@ -473,16 +493,10 @@ msgid "" msgstr "" msgid "" -"Bugs have been reported when using the *max_tasks_per_child* feature that " -"can result in the :class:`ProcessPoolExecutor` hanging in some " -"circumstances. Follow its eventual resolution in :gh:`115634`." -msgstr "" - -msgid "" -"When one of the worker processes terminates abruptly, a :exc:`~concurrent." -"futures.process.BrokenProcessPool` error is now raised. Previously, " -"behaviour was undefined but operations on the executor or its futures would " -"often freeze or deadlock." +"When one of the worker processes terminates abruptly, " +"a :exc:`~concurrent.futures.process.BrokenProcessPool` error is now raised. " +"Previously, behaviour was undefined but operations on the executor or its " +"futures would often freeze or deadlock." msgstr "" msgid "" @@ -496,30 +510,37 @@ msgid "" msgstr "" msgid "" -"On POSIX systems, if your application has multiple threads and the :mod:" -"`multiprocessing` context uses the ``\"fork\"`` start method: The :func:`os." -"fork` function called internally to spawn workers may raise a :exc:" -"`DeprecationWarning`. Pass a *mp_context* configured to use a different " -"start method. See the :func:`os.fork` documentation for further explanation." +"On POSIX systems, if your application has multiple threads and " +"the :mod:`multiprocessing` context uses the ``\"fork\"`` start method: " +"The :func:`os.fork` function called internally to spawn workers may raise " +"a :exc:`DeprecationWarning`. Pass a *mp_context* configured to use a " +"different start method. See the :func:`os.fork` documentation for further " +"explanation." msgstr "" msgid "" -"*max_workers* uses :func:`os.process_cpu_count` by default, instead of :func:" -"`os.cpu_count`." +"*max_workers* uses :func:`os.process_cpu_count` by default, instead " +"of :func:`os.cpu_count`." msgstr "" msgid "" "The default process start method (see :ref:`multiprocessing-start-methods`) " -"changed away from *fork*. If you require the *fork* start method for :class:" -"`ProcessPoolExecutor` you must explicitly pass ``mp_context=multiprocessing." -"get_context(\"fork\")``." +"changed away from *fork*. If you require the *fork* start method " +"for :class:`ProcessPoolExecutor` you must explicitly pass " +"``mp_context=multiprocessing.get_context(\"fork\")``." +msgstr "" + +msgid "" +"Fixed a deadlock (:gh:`115634`) where the executor could hang after a worker " +"process exited upon reaching its *max_tasks_per_child* limit while tasks " +"remained queued." msgstr "" msgid "" -"Attempt to terminate all living worker processes immediately by calling :" -"meth:`Process.terminate ` on each of " -"them. Internally, it will also call :meth:`Executor.shutdown` to ensure that " -"all other resources associated with the executor are freed." +"Attempt to terminate all living worker processes immediately by " +"calling :meth:`Process.terminate ` on " +"each of them. Internally, it will also call :meth:`Executor.shutdown` to " +"ensure that all other resources associated with the executor are freed." msgstr "" msgid "" @@ -528,10 +549,10 @@ msgid "" msgstr "" msgid "" -"Attempt to kill all living worker processes immediately by calling :meth:" -"`Process.kill ` on each of them. Internally, " -"it will also call :meth:`Executor.shutdown` to ensure that all other " -"resources associated with the executor are freed." +"Attempt to kill all living worker processes immediately by " +"calling :meth:`Process.kill ` on each of them. " +"Internally, it will also call :meth:`Executor.shutdown` to ensure that all " +"other resources associated with the executor are freed." msgstr "" msgid "ProcessPoolExecutor Example" @@ -653,8 +674,8 @@ msgid "" msgstr "" msgid "" -"The following :class:`Future` methods are meant for use in unit tests and :" -"class:`Executor` implementations." +"The following :class:`Future` methods are meant for use in unit tests " +"and :class:`Executor` implementations." msgstr "" msgid "" @@ -664,8 +685,8 @@ msgid "" msgstr "" msgid "" -"If the method returns ``False`` then the :class:`Future` was cancelled, i." -"e. :meth:`Future.cancel` was called and returned ``True``. Any threads " +"If the method returns ``False`` then the :class:`Future` was cancelled, " +"i.e. :meth:`Future.cancel` was called and returned ``True``. Any threads " "waiting on the :class:`Future` completing (i.e. through :func:`as_completed` " "or :func:`wait`) will be woken up." msgstr "" @@ -677,8 +698,9 @@ msgid "" msgstr "" msgid "" -"This method can only be called once and cannot be called after :meth:`Future." -"set_result` or :meth:`Future.set_exception` have been called." +"This method can only be called once and cannot be called " +"after :meth:`Future.set_result` or :meth:`Future.set_exception` have been " +"called." msgstr "" msgid "" @@ -691,26 +713,26 @@ msgid "" msgstr "" msgid "" -"This method raises :exc:`concurrent.futures.InvalidStateError` if the :class:" -"`Future` is already done." +"This method raises :exc:`concurrent.futures.InvalidStateError` if " +"the :class:`Future` is already done." msgstr "" msgid "" -"Sets the result of the work associated with the :class:`Future` to the :" -"class:`Exception` *exception*." +"Sets the result of the work associated with the :class:`Future` to " +"the :class:`Exception` *exception*." msgstr "" msgid "Module Functions" msgstr "" msgid "" -"Wait for the :class:`Future` instances (possibly created by different :class:" -"`Executor` instances) given by *fs* to complete. Duplicate futures given to " -"*fs* are removed and will be returned only once. Returns a named 2-tuple of " -"sets. The first set, named ``done``, contains the futures that completed " -"(finished or cancelled futures) before the wait completed. The second set, " -"named ``not_done``, contains the futures that did not complete (pending or " -"running futures)." +"Wait for the :class:`Future` instances (possibly created by " +"different :class:`Executor` instances) given by *fs* to complete. Duplicate " +"futures given to *fs* are removed and will be returned only once. Returns a " +"named 2-tuple of sets. The first set, named ``done``, contains the futures " +"that completed (finished or cancelled futures) before the wait completed. " +"The second set, named ``not_done``, contains the futures that did not " +"complete (pending or running futures)." msgstr "" msgid "" @@ -735,8 +757,8 @@ msgstr "" msgid "" "The function will return when any future finishes by raising an exception. " -"If no future raises an exception then it is equivalent to :const:" -"`ALL_COMPLETED`." +"If no future raises an exception then it is equivalent " +"to :const:`ALL_COMPLETED`." msgstr "" msgid "The function will return when all futures finish or are cancelled." @@ -789,19 +811,21 @@ msgstr "" msgid "" "Derived from :exc:`~concurrent.futures.BrokenExecutor`, this exception class " -"is raised when one of the workers of a :class:`~concurrent.futures." -"ThreadPoolExecutor` has failed initializing." +"is raised when one of the workers of " +"a :class:`~concurrent.futures.ThreadPoolExecutor` has failed initializing." msgstr "" msgid "" "Derived from :exc:`~concurrent.futures.thread.BrokenThreadPool`, this " -"exception class is raised when one of the workers of a :class:`~concurrent." -"futures.InterpreterPoolExecutor` has failed initializing." +"exception class is raised when one of the workers of " +"a :class:`~concurrent.futures.InterpreterPoolExecutor` has failed " +"initializing." msgstr "" msgid "" -"Derived from :exc:`~concurrent.futures.BrokenExecutor` (formerly :exc:" -"`RuntimeError`), this exception class is raised when one of the workers of " -"a :class:`~concurrent.futures.ProcessPoolExecutor` has terminated in a non-" -"clean fashion (for example, if it was killed from the outside)." +"Derived from :exc:`~concurrent.futures.BrokenExecutor` " +"(formerly :exc:`RuntimeError`), this exception class is raised when one of " +"the workers of a :class:`~concurrent.futures.ProcessPoolExecutor` has " +"terminated in a non-clean fashion (for example, if it was killed from the " +"outside)." msgstr "" diff --git a/library/concurrent.interpreters.po b/library/concurrent.interpreters.po index 9397d26ef1..70c5ecd1ca 100644 --- a/library/concurrent.interpreters.po +++ b/library/concurrent.interpreters.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,8 +46,8 @@ msgstr "" msgid "" "For concurrency, interpreters themselves (and this module) don't provide " "much more than isolation, which on its own isn't useful. Actual concurrency " -"is available separately through :mod:`threads ` See `below " -"`_" +"is available separately through :mod:`threads ` -- see `below " +"`_." msgstr "" msgid ":class:`~concurrent.futures.InterpreterPoolExecutor`" @@ -145,9 +146,9 @@ msgstr "" msgid "" "Running in a different interpreter involves switching to it in the current " "thread and then calling some function. The runtime will execute the " -"function using the current interpreter's state. The :mod:`!concurrent." -"interpreters` module provides a basic API for creating and managing " -"interpreters, as well as the switch-and-call operation." +"function using the current interpreter's state. The :mod:`!" +"concurrent.interpreters` module provides a basic API for creating and " +"managing interpreters, as well as the switch-and-call operation." msgstr "" msgid "" @@ -218,8 +219,9 @@ msgid "" msgstr "" msgid "" -"With this in mind, the :mod:`!concurrent.interpreters` module provides a :" -"class:`queue.Queue` implementation, available through :func:`create_queue`." +"With this in mind, the :mod:`!concurrent.interpreters` module provides " +"a :class:`queue.Queue` implementation, available " +"through :func:`create_queue`." msgstr "" msgid "\"Sharing\" Objects" @@ -262,7 +264,7 @@ msgid ":class:`tuple` (of similarly supported objects)" msgstr "" msgid "" -"There is a small number of Python types that actually share mutable data " +"There are a small number of Python types that actually share mutable data " "between interpreters:" msgstr "" @@ -273,7 +275,7 @@ msgid ":class:`Queue`" msgstr ":class:`Queue`" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "This module defines the following functions:" msgstr "" @@ -303,6 +305,13 @@ msgid "" "for it." msgstr "" +msgid "" +"*maxsize* is an integer that sets the upperbound limit on the number of " +"items that can be placed in the queue. Insertion will be blocked once this " +"size has been reached, until queue items are consumed. If *maxsize* is less " +"than or equal to zero, the queue size is infinite." +msgstr "" + msgid "Interpreter objects" msgstr "" @@ -310,8 +319,8 @@ msgid "A single interpreter in the current process." msgstr "" msgid "" -"Generally, :class:`Interpreter` shouldn't be called directly. Instead, use :" -"func:`create` or one of the other module functions." +"Generally, :class:`Interpreter` shouldn't be called directly. Instead, " +"use :func:`create` or one of the other module functions." msgstr "" msgid "(read-only)" @@ -343,8 +352,8 @@ msgid "Run the given source code in the interpreter (in the current thread)." msgstr "" msgid "" -"Return the result of calling running the given function in the interpreter " -"(in the current thread)." +"Return the result of running the given function in the interpreter (in the " +"current thread)." msgstr "" msgid "Run the given function in the interpreter (in a new thread)." @@ -380,27 +389,64 @@ msgid "Communicating Between Interpreters" msgstr "" msgid "" -"A wrapper around a low-level, cross-interpreter queue, which implements the :" -"class:`queue.Queue` interface. The underlying queue can only be created " +"A wrapper around a low-level, cross-interpreter queue, which implements all " +"the methods of :class:`queue.Queue` except " +"for :meth:`~queue.Queue.task_done`, :meth:`~queue.Queue.join` " +"and :meth:`~queue.Queue.shutdown`. The underlying queue can only be created " "through :func:`create_queue`." msgstr "" msgid "The queue's ID." msgstr "" +msgid "Return the number of items in the queue." +msgstr "" + +msgid "Return ``True`` if the queue is empty, ``False`` otherwise." +msgstr "" + +msgid "Return ``True`` if the queue is full, ``False`` otherwise." +msgstr "" + msgid "" -"This exception, a subclass of :exc:`queue.Empty`, is raised from :meth:`!" -"Queue.get` and :meth:`!Queue.get_nowait` when the queue is empty." +"Put *obj* into the queue. If optional args *block* is true and *timeout* is " +"``None`` (the default), block if necessary until a free slot is available. " +"If *timeout* is a positive number, it blocks at most *timeout* seconds and " +"raises the :exc:`QueueFull` exception if no free slot was available within " +"that time. Otherwise (*block* is false), put an object on the queue if a " +"free slot is immediately available, else raise the :exc:`QueueFull` " +"exception (*timeout* is ignored in that case)." +msgstr "" + +msgid "Equivalent to ``put(obj, block=False)``." msgstr "" msgid "" -"This exception, a subclass of :exc:`queue.Full`, is raised from :meth:`!" -"Queue.put` and :meth:`!Queue.put_nowait` when the queue is full." +"Remove and return an object from the queue. If optional args *block* is " +"true and *timeout* is ``None`` (the default), block if necessary until an " +"object is available. If *timeout* is a positive number, it blocks at most " +"*timeout* seconds and raises the :exc:`QueueEmpty` exception if no object " +"was available within that time. Otherwise (*block* is false), return an " +"object if one is immediately available, else raise the :exc:`QueueEmpty` " +"exception (*timeout* is ignored in that case)." msgstr "" -msgid "Basic usage" +msgid "Equivalent to ``get(block=False)``." +msgstr "" + +msgid "" +"This exception, a subclass of :exc:`queue.Empty`, is raised " +"from :meth:`Queue.get` and :meth:`Queue.get_nowait` when the queue is empty." msgstr "" +msgid "" +"This exception, a subclass of :exc:`queue.Full`, is raised " +"from :meth:`Queue.put` and :meth:`Queue.put_nowait` when the queue is full." +msgstr "" + +msgid "Basic usage" +msgstr "Podstawowe użycie" + msgid "Creating an interpreter and running code in it::" msgstr "" @@ -438,3 +484,20 @@ msgid "" "t = interp.call_in_thread(run)\n" "t.join()" msgstr "" + +msgid "Communicating between interpreters with a queue::" +msgstr "" + +msgid "" +"from concurrent import interpreters\n" +"\n" +"interp = interpreters.create()\n" +"queue = interpreters.create_queue()\n" +"\n" +"def worker(queue):\n" +" queue.put('spam!')\n" +"\n" +"t = interp.call_in_thread(worker, queue)\n" +"print(queue.get())\n" +"t.join()" +msgstr "" diff --git a/library/configparser.po b/library/configparser.po index 4bca257a77..19deba8f80 100644 --- a/library/configparser.po +++ b/library/configparser.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -163,12 +163,12 @@ msgid "" msgstr "" msgid "" -"It is possible to read several configurations into a single :class:" -"`ConfigParser`, where the most recently added configuration has the highest " -"priority. Any conflicting keys are taken from the more recent configuration " -"while the previously existing keys are retained. The example below reads in " -"an ``override.ini`` file, which will override any conflicting keys from the " -"``example.ini`` file." +"It is possible to read several configurations into a " +"single :class:`ConfigParser`, where the most recently added configuration " +"has the highest priority. Any conflicting keys are taken from the more " +"recent configuration while the previously existing keys are retained. The " +"example below reads in an ``override.ini`` file, which will override any " +"conflicting keys from the ``example.ini`` file." msgstr "" msgid "" @@ -287,10 +287,10 @@ msgstr "" "'9'" msgid "" -"One more thing to be aware of is that the parser-level :meth:`~ConfigParser." -"get` method provides a custom, more complex interface, maintained for " -"backwards compatibility. When using this method, a fallback value can be " -"provided via the ``fallback`` keyword-only argument:" +"One more thing to be aware of is that the parser-" +"level :meth:`~ConfigParser.get` method provides a custom, more complex " +"interface, maintained for backwards compatibility. When using this method, " +"a fallback value can be provided via the ``fallback`` keyword-only argument:" msgstr "" msgid "" @@ -300,9 +300,9 @@ msgid "" msgstr "" msgid "" -"The same ``fallback`` argument can be used with the :meth:`~ConfigParser." -"getint`, :meth:`~ConfigParser.getfloat` and :meth:`~ConfigParser.getboolean` " -"methods, for example:" +"The same ``fallback`` argument can be used with " +"the :meth:`~ConfigParser.getint`, :meth:`~ConfigParser.getfloat` " +"and :meth:`~ConfigParser.getboolean` methods, for example:" msgstr "" msgid "" @@ -454,8 +454,8 @@ msgid "" msgstr "" msgid "" -"With ``interpolation`` set to ``None``, the parser would simply return " -"``%(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/" +"With ``interpolation`` set to ``None``, the parser would simply return ``%" +"(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/" "lumberjack`` as the value of ``my_dir``." msgstr "" @@ -463,9 +463,9 @@ msgid "" "An alternative handler for interpolation which implements a more advanced " "syntax, used for instance in ``zc.buildout``. Extended interpolation is " "using ``${section:option}`` to denote a value from a foreign section. " -"Interpolation can span multiple levels. For convenience, if the ``section:" -"`` part is omitted, interpolation defaults to the current section (and " -"possibly the default values from the special section)." +"Interpolation can span multiple levels. For convenience, if the " +"``section:`` part is omitted, interpolation defaults to the current section " +"(and possibly the default values from the special section)." msgstr "" msgid "" @@ -527,9 +527,9 @@ msgstr "" msgid "" ":mod:`!configparser` objects behave as close to actual dictionaries as " -"possible. The mapping interface is complete and adheres to the :class:" -"`~collections.abc.MutableMapping` ABC. However, there are a few differences " -"that should be taken into account:" +"possible. The mapping interface is complete and adheres to " +"the :class:`~collections.abc.MutableMapping` ABC. However, there are a few " +"differences that should be taken into account:" msgstr "" msgid "" @@ -546,8 +546,8 @@ msgid "" msgstr "" msgid "" -"All sections include ``DEFAULTSECT`` values as well which means that ``." -"clear()`` on a section may not leave the section visibly empty. This is " +"All sections include ``DEFAULTSECT`` values as well which means that " +"``.clear()`` on a section may not leave the section visibly empty. This is " "because default values cannot be deleted from the section (because " "technically they are not there). If they are overridden in the section, " "deleting causes the default value to be visible again. Trying to delete a " @@ -575,10 +575,10 @@ msgstr "" msgid "" "``parser.items()`` is compatible with the mapping protocol (returns a list " "of *section_name*, *section_proxy* pairs including the DEFAULTSECT). " -"However, this method can also be invoked with arguments: ``parser." -"items(section, raw, vars)``. The latter call returns a list of *option*, " -"*value* pairs for a specified ``section``, with all interpolations expanded " -"(unless ``raw=True`` is provided)." +"However, this method can also be invoked with arguments: " +"``parser.items(section, raw, vars)``. The latter call returns a list of " +"*option*, *value* pairs for a specified ``section``, with all interpolations " +"expanded (unless ``raw=True`` is provided)." msgstr "" msgid "" @@ -614,8 +614,8 @@ msgid "" msgstr "" msgid "" -"Hint: if you want to specify default values for a specific section, use :" -"meth:`~ConfigParser.read_dict` before you read the actual file." +"Hint: if you want to specify default values for a specific section, " +"use :meth:`~ConfigParser.read_dict` before you read the actual file." msgstr "" msgid "*dict_type*, default value: :class:`dict`" @@ -707,8 +707,8 @@ msgid "" msgstr "" msgid "" -"See also the *space_around_delimiters* argument to :meth:`ConfigParser." -"write`." +"See also the *space_around_delimiters* argument " +"to :meth:`ConfigParser.write`." msgstr "" msgid "*comment_prefixes*, default value: ``('#', ';')``" @@ -786,9 +786,10 @@ msgstr "" msgid "" "When set to ``True``, the parser will not allow for any section or option " -"duplicates while reading from a single source (using :meth:`~ConfigParser." -"read_file`, :meth:`~ConfigParser.read_string` or :meth:`~ConfigParser." -"read_dict`). It is recommended to use strict parsers in new applications." +"duplicates while reading from a single source " +"(using :meth:`~ConfigParser.read_file`, :meth:`~ConfigParser.read_string` " +"or :meth:`~ConfigParser.read_dict`). It is recommended to use strict " +"parsers in new applications." msgstr "" msgid "" @@ -837,9 +838,9 @@ msgid "" "other valid section name. Some typical values include: ``\"general\"`` or " "``\"common\"``. The name provided is used for recognizing default sections " "when reading from any source and is used when writing configuration back to " -"a file. Its current value can be retrieved using the ``parser_instance." -"default_section`` attribute and may be modified at runtime (i.e. to convert " -"files from one format to another)." +"a file. Its current value can be retrieved using the " +"``parser_instance.default_section`` attribute and may be modified at runtime " +"(i.e. to convert files from one format to another)." msgstr "" msgid "*interpolation*, default value: ``configparser.BasicInterpolation``" @@ -850,8 +851,8 @@ msgid "" "through the *interpolation* argument. ``None`` can be used to turn off " "interpolation completely, ``ExtendedInterpolation()`` provides a more " "advanced variant inspired by ``zc.buildout``. More on the subject in the " -"`dedicated documentation section <#interpolation-of-values>`_. :class:" -"`RawConfigParser` has a default value of ``None``." +"`dedicated documentation section <#interpolation-of-" +"values>`_. :class:`RawConfigParser` has a default value of ``None``." msgstr "" msgid "*converters*, default value: not set" @@ -863,9 +864,9 @@ msgid "" "and :meth:`~ConfigParser.getboolean` are implemented. Should other getters " "be desirable, users may define them in a subclass or pass a dictionary where " "each key is a name of the converter and each value is a callable " -"implementing said conversion. For instance, passing ``{'decimal': decimal." -"Decimal}`` would add :meth:`!getdecimal` on both the parser object and all " -"section proxies. In other words, it will be possible to write both " +"implementing said conversion. For instance, passing ``{'decimal': " +"decimal.Decimal}`` would add :meth:`!getdecimal` on both the parser object " +"and all section proxies. In other words, it will be possible to write both " "``parser_instance.getdecimal('section', 'key', fallback=0)`` and " "``parser_instance['section'].getdecimal('key', 0)``." msgstr "" @@ -1112,13 +1113,13 @@ msgstr "" msgid "" "When *strict* is ``True`` (the default), the parser won't allow for any " "section or option duplicates while reading from a single source (file, " -"string or dictionary), raising :exc:`DuplicateSectionError` or :exc:" -"`DuplicateOptionError`. When *empty_lines_in_values* is ``False`` (default: " -"``True``), each empty line marks the end of an option. Otherwise, internal " -"empty lines of a multiline option are kept as part of the value. When " -"*allow_no_value* is ``True`` (default: ``False``), options without values " -"are accepted; the value held for these is ``None`` and they are serialized " -"without the trailing delimiter." +"string or dictionary), raising :exc:`DuplicateSectionError` " +"or :exc:`DuplicateOptionError`. When *empty_lines_in_values* is ``False`` " +"(default: ``True``), each empty line marks the end of an option. Otherwise, " +"internal empty lines of a multiline option are kept as part of the value. " +"When *allow_no_value* is ``True`` (default: ``False``), options without " +"values are accepted; the value held for these is ``None`` and they are " +"serialized without the trailing delimiter." msgstr "" msgid "" @@ -1139,11 +1140,11 @@ msgid "" msgstr "" msgid "" -"All option names used in interpolation will be passed through the :meth:" -"`optionxform` method just like any other option name reference. For " -"example, using the default implementation of :meth:`optionxform` (which " -"converts option names to lower case), the values ``foo %(bar)s`` and ``foo " -"%(BAR)s`` are equivalent." +"All option names used in interpolation will be passed through " +"the :meth:`optionxform` method just like any other option name reference. " +"For example, using the default implementation of :meth:`optionxform` (which " +"converts option names to lower case), the values ``foo %(bar)s`` and ``foo %" +"(BAR)s`` are equivalent." msgstr "" msgid "" @@ -1217,9 +1218,9 @@ msgid "Return a list of options available in the specified *section*." msgstr "" msgid "" -"If the given *section* exists, and contains the given *option*, return :" -"const:`True`; otherwise return :const:`False`. If the specified *section* " -"is :const:`None` or an empty string, DEFAULT is assumed." +"If the given *section* exists, and contains the given *option*, " +"return :const:`True`; otherwise return :const:`False`. If the specified " +"*section* is :const:`None` or an empty string, DEFAULT is assumed." msgstr "" msgid "" @@ -1240,8 +1241,8 @@ msgstr "" msgid "" "If none of the named files exist, the :class:`ConfigParser` instance will " "contain an empty dataset. An application which requires initial values to " -"be loaded from a file should load the required file or files using :meth:" -"`read_file` before calling :meth:`read` for any optional files::" +"be loaded from a file should load the required file or files " +"using :meth:`read_file` before calling :meth:`read` for any optional files::" msgstr "" msgid "" @@ -1341,9 +1342,9 @@ msgid "" "``'1'``, ``'yes'``, ``'true'``, and ``'on'``, which cause this method to " "return ``True``, and ``'0'``, ``'no'``, ``'false'``, and ``'off'``, which " "cause it to return ``False``. These string values are checked in a case-" -"insensitive manner. Any other value will cause it to raise :exc:" -"`ValueError`. See :meth:`get` for explanation of *raw*, *vars* and " -"*fallback*." +"insensitive manner. Any other value will cause it to " +"raise :exc:`ValueError`. See :meth:`get` for explanation of *raw*, *vars* " +"and *fallback*." msgstr "" msgid "" @@ -1353,8 +1354,8 @@ msgstr "" msgid "" "Otherwise, return a list of *name*, *value* pairs for the options in the " -"given *section*. Optional arguments have the same meaning as for the :meth:" -"`get` method." +"given *section*. Optional arguments have the same meaning as for " +"the :meth:`get` method." msgstr "" msgid "" @@ -1430,9 +1431,9 @@ msgid "" msgstr "" msgid "" -"The maximum depth for recursive interpolation for :meth:`~configparser." -"ConfigParser.get` when the *raw* parameter is false. This is relevant only " -"when the default *interpolation* is used." +"The maximum depth for recursive interpolation " +"for :meth:`~configparser.ConfigParser.get` when the *raw* parameter is " +"false. This is relevant only when the default *interpolation* is used." msgstr "" msgid "RawConfigParser Objects" @@ -1457,9 +1458,9 @@ msgstr "" msgid "" "If the given section already exists, :exc:`DuplicateSectionError` is raised. " -"If the *default section* name is passed, :exc:`ValueError` is raised. If :" -"const:`UNNAMED_SECTION` is passed and support is disabled, :exc:" -"`UnnamedSectionDisabledError` is raised." +"If the *default section* name is passed, :exc:`ValueError` is raised. " +"If :const:`UNNAMED_SECTION` is passed and support is " +"disabled, :exc:`UnnamedSectionDisabledError` is raised." msgstr "" msgid "" @@ -1472,9 +1473,9 @@ msgstr "" msgid "" "If the given section exists, set the given option to the specified value; " -"otherwise raise :exc:`NoSectionError`. While it is possible to use :class:" -"`RawConfigParser` (or :class:`ConfigParser` with *raw* parameters set to " -"true) for *internal* storage of non-string values, full functionality " +"otherwise raise :exc:`NoSectionError`. While it is possible to " +"use :class:`RawConfigParser` (or :class:`ConfigParser` with *raw* parameters " +"set to true) for *internal* storage of non-string values, full functionality " "(including interpolation and output to files) can only be achieved using " "string values." msgstr "" @@ -1502,8 +1503,8 @@ msgid "" msgstr "" msgid "" -"Added the optional *source* and *lineno* attributes and parameters to :meth:" -"`!__init__`." +"Added the optional *source* and *lineno* attributes and parameters " +"to :meth:`!__init__`." msgstr "" msgid "" @@ -1525,8 +1526,8 @@ msgstr "" msgid "" "Exception raised when string interpolation cannot be completed because the " -"number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass of :" -"exc:`InterpolationError`." +"number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass " +"of :exc:`InterpolationError`." msgstr "" msgid "" diff --git a/library/constants.po b/library/constants.po index d767272b61..2aa1576984 100644 --- a/library/constants.po +++ b/library/constants.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-08-21 15:26+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -47,31 +47,19 @@ msgid "" "An object frequently used to represent the absence of a value, as when " "default arguments are not passed to a function. Assignments to ``None`` are " "illegal and raise a :exc:`SyntaxError`. ``None`` is the sole instance of " -"the :data:`~types.NoneType` type." +"the :class:`~types.NoneType` type." msgstr "" -"Obiekt często używany do reprezentowania braku wartości, na przykład gdy " -"domyślne argumenty nie są przekazywane do funkcji. Przypisania do ``None`` " -"są niedozwolone i rzucają wyjątkiem :exc:`SyntaxError`. ``None`` jest jedyną " -"instancją typu :data:`~types.NoneType`." msgid "" -"A special value which should be returned by the binary special methods (e." -"g. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object.__add__`, :" -"meth:`~object.__rsub__`, etc.) to indicate that the operation is not " -"implemented with respect to the other type; may be returned by the in-place " -"binary special methods (e.g. :meth:`~object.__imul__`, :meth:`~object." -"__iand__`, etc.) for the same purpose. It should not be evaluated in a " -"boolean context. :data:`!NotImplemented` is the sole instance of the :data:" -"`types.NotImplementedType` type." +"A special value which should be returned by the binary special methods " +"(e.g. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object.__add__`, :meth:`~object.__rsub__`, " +"etc.) to indicate that the operation is not implemented with respect to the " +"other type; may be returned by the in-place binary special methods " +"(e.g. :meth:`~object.__imul__`, :meth:`~object.__iand__`, etc.) for the same " +"purpose. It should not be evaluated in a boolean context. :data:`!" +"NotImplemented` is the sole instance of " +"the :class:`types.NotImplementedType` type." msgstr "" -"Specjalna wartość, która powinna być zwracana przez specjalne metody binarne " -"(np. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object." -"__add__`, :meth:`~object.__rsub__`, itp.) aby zasygnalizować, że dana " -"operacja nie jest zaimplementowana w odniesieniu do drugiego typu; może być " -"zwracana przez specjalne metody binarne operujące w miejscu (ang. in-place) " -"(np. :meth:`~object.__imul__`, :meth:`~object.__iand__`, itp.) w tym samym " -"celu. Nie powinna być ewaluowana w kontekście logicznym. :data:`!" -"NotImplemented` jest jedyną instancją typu :data:`types.NotImplementedType`." msgid "" "When a binary (or in-place) method returns :data:`!NotImplemented` the " @@ -95,37 +83,37 @@ msgstr "Zobacz przykłady w :ref:`implementing-the-arithmetic-operations`." msgid "" ":data:`!NotImplemented` and :exc:`!NotImplementedError` are not " -"interchangeable. This constant should only be used as described above; see :" -"exc:`NotImplementedError` for details on correct usage of the exception." +"interchangeable. This constant should only be used as described above; " +"see :exc:`NotImplementedError` for details on correct usage of the exception." msgstr "" msgid "Evaluating :data:`!NotImplemented` in a boolean context was deprecated." msgstr "" msgid "" -"Evaluating :data:`!NotImplemented` in a boolean context now raises a :exc:" -"`TypeError`. It previously evaluated to :const:`True` and emitted a :exc:" -"`DeprecationWarning` since Python 3.9." +"Evaluating :data:`!NotImplemented` in a boolean context now raises " +"a :exc:`TypeError`. It previously evaluated to :const:`True` and emitted " +"a :exc:`DeprecationWarning` since Python 3.9." msgstr "" msgid "" "The same as the ellipsis literal \"``...``\", an object frequently used to " "indicate that something is omitted. Assignment to ``Ellipsis`` is possible, " "but assignment to ``...`` raises a :exc:`SyntaxError`. ``Ellipsis`` is the " -"sole instance of the :data:`types.EllipsisType` type." +"sole instance of the :class:`types.EllipsisType` type." msgstr "" msgid "" "This constant is true if Python was not started with an :option:`-O` option. " "See also the :keyword:`assert` statement." msgstr "" -"Ta stała ma wartość True jeśli Python nie został uruchomiony z opcją :option:" -"`-O`. Zobacz także deklarację :keyword:`assert`." +"Ta stała ma wartość True jeśli Python nie został uruchomiony z " +"opcją :option:`-O`. Zobacz także deklarację :keyword:`assert`." msgid "" "The names :data:`None`, :data:`False`, :data:`True` and :data:`__debug__` " -"cannot be reassigned (assignments to them, even as an attribute name, raise :" -"exc:`SyntaxError`), so they can be considered \"true\" constants." +"cannot be reassigned (assignments to them, even as an attribute name, " +"raise :exc:`SyntaxError`), so they can be considered \"true\" constants." msgstr "" "Nazwy :data:`None`, :data:`False`, :data:`True` oraz :data:`__debug__` nie " "mogą być przypisane ponownie (przypisania do nich, nawet jako nazwa " @@ -142,9 +130,10 @@ msgid "" "interpreter shell and should not be used in programs." msgstr "" "Moduł :mod:`site` (który jest importowany automatycznie podczas " -"uruchamiania, z wyjątkiem sytuacji, gdy podano opcję wiersza poleceń :option:" -"`-S`) dodaje kilka stałych do wbudowanej przestrzeni nazw. Są one przydatne " -"w interaktywnej powłoce interpretera i nie powinny być używane w programach." +"uruchamiania, z wyjątkiem sytuacji, gdy podano opcję wiersza " +"poleceń :option:`-S`) dodaje kilka stałych do wbudowanej przestrzeni nazw. " +"Są one przydatne w interaktywnej powłoce interpretera i nie powinny być " +"używane w programach." msgid "" "Objects that when printed, print a message like \"Use quit() or Ctrl-D (i.e. " @@ -155,8 +144,8 @@ msgstr "" msgid "" "Object that when printed, prints the message \"Type help() for interactive " "help, or help(object) for help about object.\", and when accessed directly " -"in the interactive interpreter, invokes the built-in help system (see :func:" -"`help`)." +"in the interactive interpreter, invokes the built-in help system " +"(see :func:`help`)." msgstr "" msgid "" diff --git a/library/contextlib.po b/library/contextlib.po index ee379987e5..50fd2c0247 100644 --- a/library/contextlib.po +++ b/library/contextlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,9 +31,9 @@ msgid "**Source code:** :source:`Lib/contextlib.py`" msgstr "**Kod źródłowy:** :source:`Lib/contextlib.py`" msgid "" -"This module provides utilities for common tasks involving the :keyword:" -"`with` statement. For more information see also :ref:`typecontextmanager` " -"and :ref:`context-managers`." +"This module provides utilities for common tasks involving " +"the :keyword:`with` statement. For more information see " +"also :ref:`typecontextmanager` and :ref:`context-managers`." msgstr "" msgid "Utilities" @@ -43,33 +43,35 @@ msgid "Functions and classes provided:" msgstr "" msgid "" -"An :term:`abstract base class` for classes that implement :meth:`~object." -"__enter__` and :meth:`~object.__exit__`. A default implementation for :meth:" -"`~object.__enter__` is provided which returns ``self`` while :meth:`~object." -"__exit__` is an abstract method which by default returns ``None``. See also " -"the definition of :ref:`typecontextmanager`." +"An :term:`abstract base class` for classes that " +"implement :meth:`~object.__enter__` and :meth:`~object.__exit__`. A default " +"implementation for :meth:`~object.__enter__` is provided which returns " +"``self`` while :meth:`~object.__exit__` is an abstract method which by " +"default returns ``None``. See also the definition " +"of :ref:`typecontextmanager`." msgstr "" msgid "" -"An :term:`abstract base class` for classes that implement :meth:`~object." -"__aenter__` and :meth:`~object.__aexit__`. A default implementation for :" -"meth:`~object.__aenter__` is provided which returns ``self`` while :meth:" -"`~object.__aexit__` is an abstract method which by default returns ``None``. " -"See also the definition of :ref:`async-context-managers`." +"An :term:`abstract base class` for classes that " +"implement :meth:`~object.__aenter__` and :meth:`~object.__aexit__`. A " +"default implementation for :meth:`~object.__aenter__` is provided which " +"returns ``self`` while :meth:`~object.__aexit__` is an abstract method which " +"by default returns ``None``. See also the definition of :ref:`async-context-" +"managers`." msgstr "" msgid "" "This function is a :term:`decorator` that can be used to define a factory " "function for :keyword:`with` statement context managers, without needing to " -"create a class or separate :meth:`~object.__enter__` and :meth:`~object." -"__exit__` methods." +"create a class or separate :meth:`~object.__enter__` " +"and :meth:`~object.__exit__` methods." msgstr "" msgid "" "While many objects natively support use in with statements, sometimes a " "resource needs to be managed that isn't a context manager in its own right, " -"and doesn't implement a ``close()`` method for use with ``contextlib." -"closing``." +"and doesn't implement a ``close()`` method for use with " +"``contextlib.closing``." msgstr "" msgid "" @@ -107,26 +109,26 @@ msgid "" msgstr "" msgid "" -"At the point where the generator yields, the block nested in the :keyword:" -"`with` statement is executed. The generator is then resumed after the block " -"is exited. If an unhandled exception occurs in the block, it is reraised " -"inside the generator at the point where the yield occurred. Thus, you can " -"use a :keyword:`try`...\\ :keyword:`except`...\\ :keyword:`finally` " -"statement to trap the error (if any), or ensure that some cleanup takes " -"place. If an exception is trapped merely in order to log it or to perform " -"some action (rather than to suppress it entirely), the generator must " -"reraise that exception. Otherwise the generator context manager will " -"indicate to the :keyword:`!with` statement that the exception has been " -"handled, and execution will resume with the statement immediately following " -"the :keyword:`!with` statement." +"At the point where the generator yields, the block nested in " +"the :keyword:`with` statement is executed. The generator is then resumed " +"after the block is exited. If an unhandled exception occurs in the block, it " +"is reraised inside the generator at the point where the yield occurred. " +"Thus, you can use a :keyword:`try`...\\ :keyword:`except`..." +"\\ :keyword:`finally` statement to trap the error (if any), or ensure that " +"some cleanup takes place. If an exception is trapped merely in order to log " +"it or to perform some action (rather than to suppress it entirely), the " +"generator must reraise that exception. Otherwise the generator context " +"manager will indicate to the :keyword:`!with` statement that the exception " +"has been handled, and execution will resume with the statement immediately " +"following the :keyword:`!with` statement." msgstr "" msgid "" -":func:`contextmanager` uses :class:`ContextDecorator` so the context " +":deco:`contextmanager` uses :class:`ContextDecorator` so the context " "managers it creates can be used as decorators as well as in :keyword:`with` " "statements. When used as a decorator, a new generator instance is implicitly " "created on each function call (this allows the otherwise \"one-shot\" " -"context managers created by :func:`contextmanager` to meet the requirement " +"context managers created by :deco:`contextmanager` to meet the requirement " "that context managers support multiple invocations in order to be used as " "decorators)." msgstr "" @@ -135,16 +137,16 @@ msgid "Use of :class:`ContextDecorator`." msgstr "" msgid "" -"Similar to :func:`~contextlib.contextmanager`, but creates an :ref:" -"`asynchronous context manager `." +"Similar to :deco:`~contextlib.contextmanager`, but creates " +"an :ref:`asynchronous context manager `." msgstr "" msgid "" "This function is a :term:`decorator` that can be used to define a factory " "function for :keyword:`async with` statement asynchronous context managers, " "without needing to create a class or separate :meth:`~object.__aenter__` " -"and :meth:`~object.__aexit__` methods. It must be applied to an :term:" -"`asynchronous generator` function." +"and :meth:`~object.__aexit__` methods. It must be applied to " +"an :term:`asynchronous generator` function." msgstr "" msgid "A simple example::" @@ -167,7 +169,7 @@ msgid "" msgstr "" msgid "" -"Context managers defined with :func:`asynccontextmanager` can be used either " +"Context managers defined with :deco:`asynccontextmanager` can be used either " "as decorators or with :keyword:`async with` statements::" msgstr "" @@ -191,12 +193,12 @@ msgstr "" msgid "" "When used as a decorator, a new generator instance is implicitly created on " "each function call. This allows the otherwise \"one-shot\" context managers " -"created by :func:`asynccontextmanager` to meet the requirement that context " +"created by :deco:`asynccontextmanager` to meet the requirement that context " "managers support multiple invocations in order to be used as decorators." msgstr "" msgid "" -"Async context managers created with :func:`asynccontextmanager` can be used " +"Async context managers created with :deco:`asynccontextmanager` can be used " "as decorators." msgstr "" @@ -235,10 +237,11 @@ msgstr "" msgid "" "Most types managing resources support the :term:`context manager` protocol, " -"which closes *thing* on leaving the :keyword:`with` statement. As such, :" -"func:`!closing` is most useful for third party types that don't support " -"context managers. This example is purely for illustration purposes, as :func:" -"`~urllib.request.urlopen` would normally be used in a context manager." +"which closes *thing* on leaving the :keyword:`with` statement. As " +"such, :func:`!closing` is most useful for third party types that don't " +"support context managers. This example is purely for illustration purposes, " +"as :func:`~urllib.request.urlopen` would normally be used in a context " +"manager." msgstr "" msgid "" @@ -280,9 +283,9 @@ msgid "" msgstr "" msgid "" -"Return a context manager that returns *enter_result* from :meth:`~object." -"__enter__`, but otherwise does nothing. It is intended to be used as a stand-" -"in for an optional context manager, for example::" +"Return a context manager that returns *enter_result* " +"from :meth:`~object.__enter__`, but otherwise does nothing. It is intended " +"to be used as a stand-in for an optional context manager, for example::" msgstr "" msgid "" @@ -380,16 +383,16 @@ msgid "This context manager is :ref:`reentrant `." msgstr "" msgid "" -"If the code within the :keyword:`!with` block raises a :exc:" -"`BaseExceptionGroup`, suppressed exceptions are removed from the group. Any " -"exceptions of the group which are not suppressed are re-raised in a new " -"group which is created using the original group's :meth:`~BaseExceptionGroup." -"derive` method." +"If the code within the :keyword:`!with` block raises " +"a :exc:`BaseExceptionGroup`, suppressed exceptions are removed from the " +"group. Any exceptions of the group which are not suppressed are re-raised " +"in a new group which is created using the original " +"group's :meth:`~BaseExceptionGroup.derive` method." msgstr "" msgid "" -"``suppress`` now supports suppressing exceptions raised as part of a :exc:" -"`BaseExceptionGroup`." +"``suppress`` now supports suppressing exceptions raised as part of " +"a :exc:`BaseExceptionGroup`." msgstr "" msgid "" @@ -404,10 +407,10 @@ msgstr "" msgid "" "For example, the output of :func:`help` normally is sent to *sys.stdout*. " -"You can capture that output in a string by redirecting the output to an :" -"class:`io.StringIO` object. The replacement stream is returned from the :" -"meth:`~object.__enter__` method and so is available as the target of the :" -"keyword:`with` statement::" +"You can capture that output in a string by redirecting the output to " +"an :class:`io.StringIO` object. The replacement stream is returned from " +"the :meth:`~object.__enter__` method and so is available as the target of " +"the :keyword:`with` statement::" msgstr "" msgid "" @@ -443,8 +446,8 @@ msgid "" msgstr "" msgid "" -"Similar to :func:`~contextlib.redirect_stdout` but redirecting :data:`sys." -"stderr` to another file or file-like object." +"Similar to :func:`~contextlib.redirect_stdout` but " +"redirecting :data:`sys.stderr` to another file or file-like object." msgstr "" msgid "" @@ -466,14 +469,14 @@ msgid "" msgstr "" msgid "" -"Context managers inheriting from ``ContextDecorator`` have to implement :" -"meth:`~object.__enter__` and :meth:`~object.__exit__` as normal. " +"Context managers inheriting from ``ContextDecorator`` have to " +"implement :meth:`~object.__enter__` and :meth:`~object.__exit__` as normal. " "``__exit__`` retains its optional exception handling even when used as a " "decorator." msgstr "" msgid "" -"``ContextDecorator`` is used by :func:`contextmanager`, so you get this " +"``ContextDecorator`` is used by :deco:`contextmanager`, so you get this " "functionality automatically." msgstr "" @@ -678,14 +681,15 @@ msgstr "" msgid "" "As ``__enter__`` is *not* invoked, this method can be used to cover part of " -"an :meth:`~object.__enter__` implementation with a context manager's own :" -"meth:`~object.__exit__` method." +"an :meth:`~object.__enter__` implementation with a context manager's " +"own :meth:`~object.__exit__` method." msgstr "" msgid "" "If passed an object that is not a context manager, this method assumes it is " -"a callback with the same signature as a context manager's :meth:`~object." -"__exit__` method and adds it directly to the callback stack." +"a callback with the same signature as a context " +"manager's :meth:`~object.__exit__` method and adds it directly to the " +"callback stack." msgstr "" msgid "" @@ -743,9 +747,10 @@ msgid "" msgstr "" msgid "" -"An :ref:`asynchronous context manager `, similar to :" -"class:`ExitStack`, that supports combining both synchronous and asynchronous " -"context managers, as well as having coroutines for cleanup logic." +"An :ref:`asynchronous context manager `, similar " +"to :class:`ExitStack`, that supports combining both synchronous and " +"asynchronous context managers, as well as having coroutines for cleanup " +"logic." msgstr "" msgid "" @@ -774,7 +779,7 @@ msgstr "" msgid "Similar to :meth:`ExitStack.close` but properly handles awaitables." msgstr "" -msgid "Continuing the example for :func:`asynccontextmanager`::" +msgid "Continuing the example for :deco:`asynccontextmanager`::" msgstr "" msgid "" @@ -826,12 +831,12 @@ msgid "Catching exceptions from ``__enter__`` methods" msgstr "" msgid "" -"It is occasionally desirable to catch exceptions from an :meth:`~object." -"__enter__` method implementation, *without* inadvertently catching " -"exceptions from the :keyword:`with` statement body or the context manager's :" -"meth:`~object.__exit__` method. By using :class:`ExitStack` the steps in the " -"context management protocol can be separated slightly in order to allow " -"this::" +"It is occasionally desirable to catch exceptions from " +"an :meth:`~object.__enter__` method implementation, *without* inadvertently " +"catching exceptions from the :keyword:`with` statement body or the context " +"manager's :meth:`~object.__exit__` method. By using :class:`ExitStack` the " +"steps in the context management protocol can be separated slightly in order " +"to allow this::" msgstr "" msgid "" @@ -847,12 +852,12 @@ msgstr "" msgid "" "Actually needing to do this is likely to indicate that the underlying API " -"should be providing a direct resource management interface for use with :" -"keyword:`try`/:keyword:`except`/:keyword:`finally` statements, but not all " -"APIs are well designed in that regard. When a context manager is the only " -"resource management API provided, then :class:`ExitStack` can make it easier " -"to handle various situations that can't be handled directly in a :keyword:" -"`with` statement." +"should be providing a direct resource management interface for use " +"with :keyword:`try`/:keyword:`except`/:keyword:`finally` statements, but not " +"all APIs are well designed in that regard. When a context manager is the " +"only resource management API provided, then :class:`ExitStack` can make it " +"easier to handle various situations that can't be handled directly in " +"a :keyword:`with` statement." msgstr "" msgid "Cleaning up in an ``__enter__`` implementation" @@ -860,8 +865,8 @@ msgstr "" msgid "" "As noted in the documentation of :meth:`ExitStack.push`, this method can be " -"useful in cleaning up an already allocated resource if later steps in the :" -"meth:`~object.__enter__` implementation fail." +"useful in cleaning up an already allocated resource if later steps in " +"the :meth:`~object.__enter__` implementation fail." msgstr "" msgid "" @@ -979,8 +984,8 @@ msgstr "" msgid "" "If the resource cleanup isn't already neatly bundled into a standalone " -"function, then it is still possible to use the decorator form of :meth:" -"`ExitStack.callback` to declare the resource cleanup in advance::" +"function, then it is still possible to use the decorator form " +"of :meth:`ExitStack.callback` to declare the resource cleanup in advance::" msgstr "" msgid "" @@ -1055,9 +1060,9 @@ msgstr "" msgid "" "Note that there is one additional limitation when using context managers as " -"function decorators: there's no way to access the return value of :meth:" -"`~object.__enter__`. If that value is needed, then it is still necessary to " -"use an explicit ``with`` statement." +"function decorators: there's no way to access the return value " +"of :meth:`~object.__enter__`. If that value is needed, then it is still " +"necessary to use an explicit ``with`` statement." msgstr "" msgid ":pep:`343` - The \"with\" statement" @@ -1091,7 +1096,7 @@ msgid "" msgstr "" msgid "" -"Context managers created using :func:`contextmanager` are also single use " +"Context managers created using :deco:`contextmanager` are also single use " "context managers, and will complain about the underlying generator failing " "to yield if an attempt is made to use them a second time::" msgstr "" @@ -1160,8 +1165,8 @@ msgstr "" msgid "" "Note also that being reentrant is *not* the same thing as being thread " "safe. :func:`redirect_stdout`, for example, is definitely not thread safe, " -"as it makes a global modification to the system state by binding :data:`sys." -"stdout` to a different stream." +"as it makes a global modification to the system state by " +"binding :data:`sys.stdout` to a different stream." msgstr "" msgid "Reusable context managers" @@ -1178,14 +1183,15 @@ msgstr "" msgid "" ":class:`threading.Lock` is an example of a reusable, but not reentrant, " -"context manager (for a reentrant lock, it is necessary to use :class:" -"`threading.RLock` instead)." +"context manager (for a reentrant lock, it is necessary to " +"use :class:`threading.RLock` instead)." msgstr "" msgid "" -"Another example of a reusable, but not reentrant, context manager is :class:" -"`ExitStack`, as it invokes *all* currently registered callbacks when leaving " -"any with statement, regardless of where those callbacks were added::" +"Another example of a reusable, but not reentrant, context manager " +"is :class:`ExitStack`, as it invokes *all* currently registered callbacks " +"when leaving any with statement, regardless of where those callbacks were " +"added::" msgstr "" msgid "" diff --git a/library/contextvars.po b/library/contextvars.po index 6f7a5ab3b3..887eacb10c 100644 --- a/library/contextvars.po +++ b/library/contextvars.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,9 +35,9 @@ msgid "" msgstr "" msgid "" -"Context managers that have state should use Context Variables instead of :" -"func:`threading.local` to prevent their state from bleeding to other code " -"unexpectedly, when used in concurrent code." +"Context managers that have state should use Context Variables instead " +"of :func:`threading.local` to prevent their state from bleeding to other " +"code unexpectedly, when used in concurrent code." msgstr "" msgid "See also :pep:`567` for additional details." @@ -57,9 +57,9 @@ msgid "" msgstr "" msgid "" -"The optional keyword-only *default* parameter is returned by :meth:" -"`ContextVar.get` when no value for the variable is found in the current " -"context." +"The optional keyword-only *default* parameter is returned " +"by :meth:`ContextVar.get` when no value for the variable is found in the " +"current context." msgstr "" msgid "" @@ -69,6 +69,11 @@ msgid "" "garbage collected." msgstr "" +msgid "" +":class:`!ContextVar`\\s are :ref:`generic ` over the type of their " +"contained value." +msgstr "" + msgid "The name of the variable. This is a read-only property." msgstr "" @@ -138,8 +143,8 @@ msgid "Added support for using tokens as context managers." msgstr "" msgid "" -"Reset the context variable to the value it had before the :meth:`ContextVar." -"set` that created the *token* was used." +"Reset the context variable to the value it had before " +"the :meth:`ContextVar.set` that created the *token* was used." msgstr "" msgid "For example::" @@ -171,6 +176,11 @@ msgid "" "automatically reset context variables. See :meth:`ContextVar.set`." msgstr "" +msgid "" +"Tokens are :ref:`generic ` over the same type as " +"the :class:`ContextVar` which created them." +msgstr "" + msgid "Added support for usage as a context manager." msgstr "" @@ -180,9 +190,9 @@ msgid "" msgstr "" msgid "" -"A read-only property. Set to the value the variable had before the :meth:" -"`ContextVar.set` method call that created the token. It points to :attr:" -"`Token.MISSING` if the variable was not set before the call." +"A read-only property. Set to the value the variable had before " +"the :meth:`ContextVar.set` method call that created the token. It points " +"to :attr:`Token.MISSING` if the variable was not set before the call." msgstr "" msgid "A marker object used by :attr:`Token.old_value`." @@ -219,9 +229,9 @@ msgid "" msgstr "" msgid "" -"Each thread has its own effective stack of :class:`!Context` objects. The :" -"term:`current context` is the :class:`!Context` object at the top of the " -"current thread's stack. All :class:`!Context` objects in the stacks are " +"Each thread has its own effective stack of :class:`!Context` objects. " +"The :term:`current context` is the :class:`!Context` object at the top of " +"the current thread's stack. All :class:`!Context` objects in the stacks are " "considered to be *entered*." msgstr "" diff --git a/library/copy.po b/library/copy.po index 78a28bb480..a5840410cb 100644 --- a/library/copy.po +++ b/library/copy.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -102,14 +102,18 @@ msgid "" "This module does not copy types like module, method, stack trace, stack " "frame, file, socket, window, or any similar types. It does \"copy\" " "functions and classes (shallow and deeply), by returning the original object " -"unchanged; this is compatible with the way these are treated by the :mod:" -"`pickle` module." +"unchanged; this is compatible with the way these are treated by " +"the :mod:`pickle` module." msgstr "" msgid "" -"Shallow copies of dictionaries can be made using :meth:`dict.copy`, and of " -"lists by assigning a slice of the entire list, for example, ``copied_list = " -"original_list[:]``." +"Shallow copies of many collections can be made using the " +"corresponding :meth:`!copy` method (such " +"as :meth:`list.copy`, :meth:`dict.copy` or :meth:`set.copy`), and of " +"sequences (such as lists or bytearrays) by making a slice of the entire " +"sequence (``sequence[:]``). However, these methods and slicing can create an " +"instance of the base type when copying an instance of a subclass, " +"whereas :func:`copy.copy` normally returns an instance of the same type." msgstr "" msgid "" @@ -138,10 +142,10 @@ msgid "" msgstr "" msgid "" -"Function :func:`!copy.replace` is more limited than :func:`~copy.copy` and :" -"func:`~copy.deepcopy`, and only supports named tuples created by :func:" -"`~collections.namedtuple`, :mod:`dataclasses`, and other classes which " -"define method :meth:`~object.__replace__`." +"Function :func:`!copy.replace` is more limited than :func:`~copy.copy` " +"and :func:`~copy.deepcopy`, and only supports named tuples created " +"by :func:`~collections.namedtuple`, :mod:`dataclasses`, and other classes " +"which define method :meth:`~object.__replace__`." msgstr "" msgid "" diff --git a/library/copyreg.po b/library/copyreg.po index 2e1ff1aa7c..5842a5a521 100644 --- a/library/copyreg.po +++ b/library/copyreg.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,8 +45,9 @@ msgstr "" msgid "" "Declares that *function* should be used as a \"reduction\" function for " "objects of type *type*. *function* must return either a string or a tuple " -"containing between two and six elements. See the :attr:`~pickle.Pickler." -"dispatch_table` for more details on the interface of *function*." +"containing between two and six elements. See " +"the :attr:`~pickle.Pickler.dispatch_table` for more details on the interface " +"of *function*." msgstr "" msgid "" diff --git a/library/csv.po b/library/csv.po index 529d9c82d9..806eea1ad8 100644 --- a/library/csv.po +++ b/library/csv.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -85,9 +85,9 @@ msgstr "" msgid "" "Each row read from the csv file is returned as a list of strings. No " -"automatic data type conversion is performed unless the :data:" -"`QUOTE_NONNUMERIC` format option is specified (in which case unquoted fields " -"are transformed into floats)." +"automatic data type conversion is performed unless " +"the :data:`QUOTE_NONNUMERIC` format option is specified (in which case " +"unquoted fields are transformed into floats)." msgstr "" msgid "A short usage example::" @@ -103,18 +103,26 @@ msgid "" "Spam, Lovely Spam, Wonderful Spam" msgstr "" +msgid "where :file:`eggs.csv` contains:" +msgstr "" + +msgid "" +"Spam Spam Spam Spam Spam |Baked Beans|\n" +"Spam |Lovely Spam| |Wonderful Spam|" +msgstr "" + msgid "" "Return a writer object responsible for converting the user's data into " "delimited strings on the given file-like object. *csvfile* can be any " "object with a :meth:`~io.TextIOBase.write` method. If *csvfile* is a file " "object, it should be opened with ``newline=''`` [1]_. An optional *dialect* " "parameter can be given which is used to define a set of parameters specific " -"to a particular CSV dialect. It may be an instance of a subclass of the :" -"class:`Dialect` class or one of the strings returned by the :func:" -"`list_dialects` function. The other optional *fmtparams* keyword arguments " -"can be given to override individual formatting parameters in the current " -"dialect. For full details about dialects and formatting parameters, see " -"the :ref:`csv-fmt-params` section. To make it as easy as possible to " +"to a particular CSV dialect. It may be an instance of a subclass of " +"the :class:`Dialect` class or one of the strings returned by " +"the :func:`list_dialects` function. The other optional *fmtparams* keyword " +"arguments can be given to override individual formatting parameters in the " +"current dialect. For full details about dialects and formatting parameters, " +"see the :ref:`csv-fmt-params` section. To make it as easy as possible to " "interface with modules which implement the DB API, the value :const:`None` " "is written as the empty string. While this isn't a reversible " "transformation, it makes it easier to dump SQL NULL data values to CSV files " @@ -131,6 +139,9 @@ msgid "" " spamwriter.writerow(['Spam', 'Lovely Spam', 'Wonderful Spam'])" msgstr "" +msgid "which writes :file:`eggs.csv` containing:" +msgstr "" + msgid "" "Associate *dialect* with *name*. *name* must be a string. The dialect can " "be specified either by passing a sub-class of :class:`Dialect`, or by " @@ -140,8 +151,8 @@ msgid "" msgstr "" msgid "" -"Delete the dialect associated with *name* from the dialect registry. An :" -"exc:`Error` is raised if *name* is not a registered dialect name." +"Delete the dialect associated with *name* from the dialect registry. " +"An :exc:`Error` is raised if *name* is not a registered dialect name." msgstr "" msgid "" @@ -185,8 +196,8 @@ msgid "" msgstr "" msgid "" -"All other optional or keyword arguments are passed to the underlying :class:" -"`reader` instance." +"All other optional or keyword arguments are passed to the " +"underlying :class:`reader` instance." msgstr "" msgid "" @@ -214,6 +225,15 @@ msgid "" "{'first_name': 'John', 'last_name': 'Cleese'}" msgstr "" +msgid "where :file:`names.csv` contains:" +msgstr "" + +msgid "" +"first_name,last_name\n" +"Eric,Idle\n" +"John,Cleese" +msgstr "" + msgid "" "Create an object which operates like a regular writer but maps dictionaries " "onto output rows. The *fieldnames* parameter is a :mod:`sequence " @@ -223,10 +243,10 @@ msgid "" "written if the dictionary is missing a key in *fieldnames*. If the " "dictionary passed to the :meth:`~csvwriter.writerow` method contains a key " "not found in *fieldnames*, the optional *extrasaction* parameter indicates " -"what action to take. If it is set to ``'raise'``, the default value, a :exc:" -"`ValueError` is raised. If it is set to ``'ignore'``, extra values in the " -"dictionary are ignored. Any other optional or keyword arguments are passed " -"to the underlying :class:`writer` instance." +"what action to take. If it is set to ``'raise'``, the default value, " +"a :exc:`ValueError` is raised. If it is set to ``'ignore'``, extra values in " +"the dictionary are ignored. Any other optional or keyword arguments are " +"passed to the underlying :class:`writer` instance." msgstr "" msgid "" @@ -247,12 +267,22 @@ msgid "" " writer.writerow({'first_name': 'Wonderful', 'last_name': 'Spam'})" msgstr "" +msgid "which writes :file:`names.csv` containing:" +msgstr "" + +msgid "" +"first_name,last_name\n" +"Baked,Beans\n" +"Lovely,Spam\n" +"Wonderful,Spam" +msgstr "" + msgid "" "The :class:`Dialect` class is a container class whose attributes contain " "information for how to handle doublequotes, whitespace, delimiters, etc. Due " "to the lack of a strict CSV specification, different applications produce " -"subtly different CSV data. :class:`Dialect` instances define how :class:" -"`reader` and :class:`writer` instances behave." +"subtly different CSV data. :class:`Dialect` instances define " +"how :class:`reader` and :class:`writer` instances behave." msgstr "" msgid "" @@ -298,10 +328,17 @@ msgid "" msgstr "" msgid "" -"Analyze the sample text (presumed to be in CSV format) and return :const:" -"`True` if the first row appears to be a series of column headers. Inspecting " -"each column, one of two key criteria will be considered to estimate if the " -"sample contains a header:" +"If several delimiters fit the sample equally well --- for example if both " +"``','`` and ``';'`` split every row consistently --- the delimiters listed " +"in the :attr:`~Sniffer.preferred` attribute are preferred, in that order, no " +"matter how many times each of them occurs." +msgstr "" + +msgid "" +"Analyze the sample text (presumed to be in CSV format) and " +"return :const:`True` if the first row appears to be a series of column " +"headers. Inspecting each column, one of two key criteria will be considered " +"to estimate if the sample contains a header:" msgstr "" msgid "the second through n-th rows contain numeric values" @@ -322,6 +359,15 @@ msgid "" "negatives." msgstr "" +msgid "The :class:`Sniffer` class has the following attribute:" +msgstr "" + +msgid "" +"The list of the delimiters preferred for breaking ties, in the order of " +"preference. It can be modified. Its initial value is ``[',', '\\t', ';', ' " +"', ':']``." +msgstr "" + msgid "An example for :class:`Sniffer` use::" msgstr "" @@ -342,22 +388,24 @@ msgstr "" msgid "" "Instructs :class:`writer` objects to only quote those fields which contain " "special characters such as *delimiter*, *quotechar*, ``'\\r'``, ``'\\n'`` or " -"any of the characters in *lineterminator*." +"any of the characters in *lineterminator*. If *doublequote* " +"is :const:`False` and *escapechar* is set, the *quotechar* is escaped " +"instead of causing the field to be quoted." msgstr "" msgid "Instructs :class:`writer` objects to quote all non-numeric fields." msgstr "" msgid "" -"Instructs :class:`reader` objects to convert all non-quoted fields to type :" -"class:`float`." +"Instructs :class:`reader` objects to convert all non-quoted fields to " +"type :class:`float`." msgstr "" msgid "" -"Some numeric types, such as :class:`bool`, :class:`~fractions.Fraction`, or :" -"class:`~enum.IntEnum`, have a string representation that cannot be converted " -"to :class:`float`. They cannot be read in the :data:`QUOTE_NONNUMERIC` and :" -"data:`QUOTE_STRINGS` modes." +"Some numeric types, such as :class:`bool`, :class:`~fractions.Fraction`, " +"or :class:`~enum.IntEnum`, have a string representation that cannot be " +"converted to :class:`float`. They cannot be read in " +"the :data:`QUOTE_NONNUMERIC` and :data:`QUOTE_STRINGS` modes." msgstr "" msgid "" @@ -409,12 +457,12 @@ msgid "" "To make it easier to specify the format of input and output records, " "specific formatting parameters are grouped together into dialects. A " "dialect is a subclass of the :class:`Dialect` class containing various " -"attributes describing the format of the CSV file. When creating :class:" -"`reader` or :class:`writer` objects, the programmer can specify a string or " -"a subclass of the :class:`Dialect` class as the dialect parameter. In " -"addition to, or instead of, the *dialect* parameter, the programmer can also " -"specify individual formatting parameters, which have the same names as the " -"attributes defined below for the :class:`Dialect` class." +"attributes describing the format of the CSV file. When " +"creating :class:`reader` or :class:`writer` objects, the programmer can " +"specify a string or a subclass of the :class:`Dialect` class as the dialect " +"parameter. In addition to, or instead of, the *dialect* parameter, the " +"programmer can also specify individual formatting parameters, which have the " +"same names as the attributes defined below for the :class:`Dialect` class." msgstr "" msgid "Dialects support the following attributes:" @@ -426,14 +474,14 @@ msgstr "" msgid "" "Controls how instances of *quotechar* appearing inside a field should " -"themselves be quoted. When :const:`True`, the character is doubled. When :" -"const:`False`, the *escapechar* is used as a prefix to the *quotechar*. It " -"defaults to :const:`True`." +"themselves be quoted. When :const:`True`, the character is doubled. " +"When :const:`False`, the *escapechar* is used as a prefix to the " +"*quotechar*. It defaults to :const:`True`." msgstr "" msgid "" -"On output, if *doublequote* is :const:`False` and no *escapechar* is set, :" -"exc:`Error` is raised if a *quotechar* is found in a field." +"On output, if *doublequote* is :const:`False` and no *escapechar* is " +"set, :exc:`Error` is raised if a *quotechar* is found in a field." msgstr "" msgid "" @@ -443,8 +491,8 @@ msgstr "" msgid "" "the *delimiter*, the *quotechar*, ``'\\r'``, ``'\\n'`` and any of the " -"characters in *lineterminator* are escaped if *quoting* is set to :const:" -"`QUOTE_NONE`;" +"characters in *lineterminator* are escaped if *quoting* is set " +"to :const:`QUOTE_NONE`;" msgstr "" msgid "the *quotechar* is escaped if *doublequote* is :const:`False`;" @@ -458,6 +506,10 @@ msgid "" "character. It defaults to :const:`None`, which disables escaping." msgstr "" +msgid "" +"Previously the *escapechar* itself was not escaped, which lost it on reading." +msgstr "" + msgid "An empty *escapechar* is not allowed." msgstr "" @@ -505,8 +557,8 @@ msgid "Reader Objects" msgstr "" msgid "" -"Reader objects (:class:`DictReader` instances and objects returned by the :" -"func:`reader` function) have the following public methods:" +"Reader objects (:class:`DictReader` instances and objects returned by " +"the :func:`reader` function) have the following public methods:" msgstr "" msgid "" @@ -580,8 +632,8 @@ msgid "" msgstr "" msgid "" -":meth:`writeheader` now also returns the value returned by the :meth:" -"`csvwriter.writerow` method it uses internally." +":meth:`writeheader` now also returns the value returned by " +"the :meth:`csvwriter.writerow` method it uses internally." msgstr "" msgid "Examples" @@ -621,9 +673,9 @@ msgstr "" msgid "" "Since :func:`open` is used to open a CSV file for reading, the file will by " -"default be decoded into unicode using the system default encoding (see :func:" -"`locale.getencoding`). To decode a file using a different encoding, use the " -"``encoding`` argument of open::" +"default be decoded into unicode using the system default encoding " +"(see :func:`locale.getencoding`). To decode a file using a different " +"encoding, use the ``encoding`` argument of open::" msgstr "" msgid "" @@ -684,8 +736,8 @@ msgid "" "If ``newline=''`` is not specified, newlines embedded inside quoted fields " "will not be interpreted correctly, and on platforms that use ``\\r\\n`` line " "endings on write an extra ``\\r`` will be added. It should always be safe " -"to specify ``newline=''``, since the csv module does its own (:term:" -"`universal `) newline handling." +"to specify ``newline=''``, since the csv module does its own " +"(:term:`universal `) newline handling." msgstr "" msgid "csv" diff --git a/library/ctypes.po b/library/ctypes.po index c208e38005..e1fd6e9e94 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -4,17 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2025 -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -44,42 +43,51 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." + +msgid "" +":mod:`!ctypes` provides low-level access to native libraries and the " +"process's memory, bypassing Python's safety mechanisms and allowing " +"execution of arbitrary native code. Incorrect use can corrupt data and " +"objects, reveal sensitive information, cause crashes, or otherwise " +"compromise the running process." +msgstr "" msgid "ctypes tutorial" msgstr "" msgid "" "Note: Some code samples reference the ctypes :class:`c_int` type. On " -"platforms where ``sizeof(long) == sizeof(int)`` it is an alias to :class:" -"`c_long`. So, you should not be confused if :class:`c_long` is printed if " -"you would expect :class:`c_int` --- they are actually the same type." +"platforms where ``sizeof(long) == sizeof(int)`` it is an alias " +"to :class:`c_long`. So, you should not be confused if :class:`c_long` is " +"printed if you would expect :class:`c_int` --- they are actually the same " +"type." msgstr "" msgid "Loading dynamic link libraries" msgstr "" msgid "" -":mod:`!ctypes` exports the :py:data:`~ctypes.cdll`, and on Windows :py:data:" -"`~ctypes.windll` and :py:data:`~ctypes.oledll` objects, for loading dynamic " -"link libraries." +":mod:`!ctypes` exports the :py:data:`~ctypes.cdll`, and on " +"Windows :py:data:`~ctypes.windll` and :py:data:`~ctypes.oledll` objects, for " +"loading dynamic link libraries." msgstr "" msgid "" -"You load libraries by accessing them as attributes of these objects. :py:" -"data:`!cdll` loads libraries which export functions using the standard " -"``cdecl`` calling convention, while :py:data:`!windll` libraries call " -"functions using the ``stdcall`` calling convention. :py:data:`~oledll` also " -"uses the ``stdcall`` calling convention, and assumes the functions return a " -"Windows :c:type:`!HRESULT` error code. The error code is used to " +"You load libraries by accessing them as attributes of these " +"objects. :py:data:`!cdll` loads libraries which export functions using the " +"standard ``cdecl`` calling convention, while :py:data:`!windll` libraries " +"call functions using the ``stdcall`` calling convention. :py:data:`~oledll` " +"also uses the ``stdcall`` calling convention, and assumes the functions " +"return a Windows :c:type:`!HRESULT` error code. The error code is used to " "automatically raise an :class:`OSError` exception when the function call " "fails." msgstr "" msgid "" -"Windows errors used to raise :exc:`WindowsError`, which is now an alias of :" -"exc:`OSError`." +"Windows errors used to raise :exc:`WindowsError`, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" @@ -110,10 +118,10 @@ msgstr "" msgid "" "Other systems require the filename *including* the extension to load a " -"library, so attribute access can not be used to load libraries. Either the :" -"meth:`~LibraryLoader.LoadLibrary` method of the dll loaders should be used, " -"or you should load the library by creating an instance of :py:class:`CDLL` " -"by calling the constructor." +"library, so attribute access can not be used to load libraries. Either " +"the :meth:`~LibraryLoader.LoadLibrary` method of the dll loaders should be " +"used, or you should load the library by creating an instance " +"of :py:class:`CDLL` by calling the constructor." msgstr "" msgid "For example, on Linux::" @@ -184,8 +192,8 @@ msgstr "" msgid "" "Sometimes, dlls export functions with names which aren't valid Python " -"identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to use :func:" -"`getattr` to retrieve the function::" +"identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to " +"use :func:`getattr` to retrieve the function::" msgstr "" msgid "" @@ -239,29 +247,13 @@ msgid "" msgstr "" msgid "" -":exc:`ValueError` is raised when you call an ``stdcall`` function with the " -"``cdecl`` calling convention, or vice versa::" -msgstr "" - -msgid "" -">>> cdll.kernel32.GetModuleHandleA(None)\n" -"Traceback (most recent call last):\n" -" File \"\", line 1, in \n" -"ValueError: Procedure probably called with not enough arguments (4 bytes " -"missing)\n" -">>>\n" -"\n" -">>> windll.msvcrt.printf(b\"spam\")\n" -"Traceback (most recent call last):\n" -" File \"\", line 1, in \n" -"ValueError: Procedure probably called with too many arguments (4 bytes in " -"excess)\n" -">>>" -msgstr "" - -msgid "" -"To find out the correct calling convention you have to look into the C " -"header file or the documentation for the function you want to call." +":mod:`!ctypes` cannot determine a function's calling convention or " +"signature. Consult the function's C header file or documentation to choose " +"the correct calling convention and set the :attr:`~_CFuncPtr.argtypes` " +"attribute, as described in :ref:`ctypes-specifying-required-argument-types`. " +"Without :attr:`~_CFuncPtr.argtypes`, the number of arguments is not checked. " +"Calling a function with an incorrect calling convention or with incorrect " +"arguments can corrupt memory or crash Python." msgstr "" msgid "" @@ -279,20 +271,18 @@ msgid "" msgstr "" msgid "" -"There are, however, enough ways to crash Python with :mod:`!ctypes`, so you " -"should be careful anyway. The :mod:`faulthandler` module can be helpful in " -"debugging crashes (e.g. from segmentation faults produced by erroneous C " -"library calls)." +"The :mod:`faulthandler` module can help debug crashes, such as segmentation " +"faults produced by erroneous C library calls." msgstr "" msgid "" "``None``, integers, bytes objects and (unicode) strings are the only native " "Python objects that can directly be used as parameters in these function " "calls. ``None`` is passed as a C ``NULL`` pointer, bytes objects and strings " -"are passed as pointer to the memory block that contains their data (:c:expr:" -"`char *` or :c:expr:`wchar_t *`). Python integers are passed as the " -"platform's default C :c:expr:`int` type, their value is masked to fit into " -"the C type." +"are passed as pointer to the memory block that contains their data " +"(:c:expr:`char *` or :c:expr:`wchar_t *`). Python integers are passed as " +"the platform's default C :c:expr:`int` type, their value is masked to fit " +"into the C type." msgstr "" msgid "" @@ -659,10 +649,10 @@ msgstr "" ">>>" msgid "" -"The constructors for numeric types will convert input using :py:meth:" -"`~object.__bool__`, :py:meth:`~object.__index__` (for ``int``), :py:meth:" -"`~object.__float__` or :py:meth:`~object.__complex__`. This means :py:class:" -"`~ctypes.c_bool` accepts any object with a truth value::" +"The constructors for numeric types will convert input " +"using :py:meth:`~object.__bool__`, :py:meth:`~object.__index__` (for " +"``int``), :py:meth:`~object.__float__` or :py:meth:`~object.__complex__`. " +"This means :py:class:`~ctypes.c_bool` accepts any object with a truth value::" msgstr "" msgid "" @@ -688,10 +678,10 @@ msgid "" msgstr "" msgid "" -"Assigning a new value to instances of the pointer types :class:`c_char_p`, :" -"class:`c_wchar_p`, and :class:`c_void_p` changes the *memory location* they " -"point to, *not the contents* of the memory block (of course not, because " -"Python string objects are immutable)::" +"Assigning a new value to instances of the pointer " +"types :class:`c_char_p`, :class:`c_wchar_p`, and :class:`c_void_p` changes " +"the *memory location* they point to, *not the contents* of the memory block " +"(of course not, because Python string objects are immutable)::" msgstr "" msgid "" @@ -713,11 +703,11 @@ msgstr "" msgid "" "You should be careful, however, not to pass them to functions expecting " -"pointers to mutable memory. If you need mutable memory blocks, ctypes has a :" -"func:`create_string_buffer` function which creates these in various ways. " -"The current memory block contents can be accessed (or changed) with the " -"``raw`` property; if you want to access it as NUL terminated string, use the " -"``value`` property::" +"pointers to mutable memory. If you need mutable memory blocks, ctypes has " +"a :func:`create_string_buffer` function which creates these in various " +"ways. The current memory block contents can be accessed (or changed) with " +"the ``raw`` property; if you want to access it as NUL terminated string, use " +"the ``value`` property::" msgstr "" msgid "" @@ -752,9 +742,9 @@ msgid "Calling functions, continued" msgstr "" msgid "" -"Note that printf prints to the real standard output channel, *not* to :data:" -"`sys.stdout`, so these examples will only work at the console prompt, not " -"from within *IDLE* or *PythonWin*::" +"Note that printf prints to the real standard output channel, *not* " +"to :data:`sys.stdout`, so these examples will only work at the console " +"prompt, not from within *IDLE* or *PythonWin*::" msgstr "" msgid "" @@ -838,8 +828,8 @@ msgstr "" msgid "" "If you don't want to store the instance's data in the :attr:`!" -"_as_parameter_` instance variable, you could define a :class:`property` " -"which makes the attribute available on request." +"_as_parameter_` instance variable, you could define a :deco:`property` which " +"makes the attribute available on request." msgstr "" msgid "Specifying the required argument types (function prototypes)" @@ -884,16 +874,36 @@ msgid "" ">>>" msgstr "" +msgid "" +"Setting :attr:`~_CFuncPtr.argtypes` also causes :mod:`!ctypes` to " +"raise :exc:`TypeError` if too few arguments are passed::" +msgstr "" + +msgid "" +">>> printf(b\"%s %d %f\\n\", b\"X\", 2)\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: this function takes at least 4 arguments (3 given)" +msgstr "" + +msgid "" +"Functions using the ``stdcall`` calling convention require exactly as many " +"arguments as there are items in :attr:`~_CFuncPtr.argtypes`. Functions using " +"the ``cdecl`` calling convention accept additional arguments, to support " +"variadic functions. The declaration must match the function's actual " +"signature; ctypes cannot verify this." +msgstr "" + msgid "" "If you have defined your own classes which you pass to function calls, you " "have to implement a :meth:`~_CData.from_param` class method for them to be " -"able to use them in the :attr:`~_CFuncPtr.argtypes` sequence. The :meth:" -"`~_CData.from_param` class method receives the Python object passed to the " -"function call, it should do a typecheck or whatever is needed to make sure " -"this object is acceptable, and then return the object itself, its :attr:`!" -"_as_parameter_` attribute, or whatever you want to pass as the C function " -"argument in this case. Again, the result should be an integer, string, " -"bytes, a :mod:`!ctypes` instance, or an object with an :attr:`!" +"able to use them in the :attr:`~_CFuncPtr.argtypes` sequence. " +"The :meth:`~_CData.from_param` class method receives the Python object " +"passed to the function call, it should do a typecheck or whatever is needed " +"to make sure this object is acceptable, and then return the object itself, " +"its :attr:`!_as_parameter_` attribute, or whatever you want to pass as the C " +"function argument in this case. Again, the result should be an integer, " +"string, bytes, a :mod:`!ctypes` instance, or an object with an :attr:`!" "_as_parameter_` attribute." msgstr "" @@ -907,9 +917,10 @@ msgid "" msgstr "" msgid "" -"The C prototype of :c:func:`time` is ``time_t time(time_t *)``. Because :c:" -"type:`time_t` might be of a different type than the default return type :c:" -"expr:`int`, you should specify the :attr:`!restype` attribute::" +"The C prototype of :c:func:`time` is ``time_t time(time_t *)``. " +"Because :c:type:`time_t` might be of a different type than the default " +"return type :c:expr:`int`, you should specify the :attr:`!restype` " +"attribute::" msgstr "" msgid ">>> libc.time.restype = c_time_t" @@ -1023,10 +1034,10 @@ msgstr "" msgid "" ":mod:`!ctypes` exports the :func:`byref` function which is used to pass " -"parameters by reference. The same effect can be achieved with the :func:" -"`pointer` function, although :func:`pointer` does a lot more work since it " -"constructs a real pointer object, so it is faster to use :func:`byref` if " -"you don't need the pointer object in Python itself::" +"parameters by reference. The same effect can be achieved with " +"the :func:`pointer` function, although :func:`pointer` does a lot more work " +"since it constructs a real pointer object, so it is faster to " +"use :func:`byref` if you don't need the pointer object in Python itself::" msgstr "" msgid "" @@ -1047,11 +1058,11 @@ msgid "Structures and unions" msgstr "" msgid "" -"Structures and unions must derive from the :class:`Structure` and :class:" -"`Union` base classes which are defined in the :mod:`!ctypes` module. Each " -"subclass must define a :attr:`~Structure._fields_` attribute. :attr:`!" -"_fields_` must be a list of *2-tuples*, containing a *field name* and a " -"*field type*." +"Structures and unions must derive from the :class:`Structure` " +"and :class:`Union` base classes which are defined in the :mod:`!ctypes` " +"module. Each subclass must define a :attr:`~Structure._fields_` " +"attribute. :attr:`!_fields_` must be a list of *2-tuples*, containing a " +"*field name* and a *field type*." msgstr "" msgid "" @@ -1119,8 +1130,8 @@ msgstr "" msgid "" "Field :term:`descriptor`\\s can be retrieved from the *class*, they are " -"useful for debugging because they can provide useful information. See :class:" -"`CField`::" +"useful for debugging because they can provide useful information. " +"See :class:`CField`::" msgstr "" msgid "" @@ -1150,17 +1161,17 @@ msgstr "" msgid "" "It is possible to specify the maximum alignment for the fields and/or for " -"the structure itself by setting the class attributes :attr:`~Structure." -"_pack_` and/or :attr:`~Structure._align_`, respectively. See the attribute " -"documentation for details." +"the structure itself by setting the class " +"attributes :attr:`~Structure._pack_` and/or :attr:`~Structure._align_`, " +"respectively. See the attribute documentation for details." msgstr "" msgid "" ":mod:`!ctypes` uses the native byte order for Structures and Unions. To " -"build structures with non-native byte order, you can use one of the :class:" -"`BigEndianStructure`, :class:`LittleEndianStructure`, :class:" -"`BigEndianUnion`, and :class:`LittleEndianUnion` base classes. These " -"classes cannot contain pointer fields." +"build structures with non-native byte order, you can use one of " +"the :class:`BigEndianStructure`, :class:`LittleEndianStructure`, :class:`BigEndianUnion`, " +"and :class:`LittleEndianUnion` base classes. These classes cannot contain " +"pointer fields." msgstr "" msgid "Bit fields in structures and unions" @@ -1260,8 +1271,8 @@ msgid "Pointers" msgstr "" msgid "" -"Pointer instances are created by calling the :func:`pointer` function on a :" -"mod:`!ctypes` type::" +"Pointer instances are created by calling the :func:`pointer` function on " +"a :mod:`!ctypes` type::" msgstr "" msgid "" @@ -1360,6 +1371,15 @@ msgid "" "instead of a single item." msgstr "" +msgid "" +"Because pointer objects support subscription, they implicitly " +"support :term:`iteration `. Unless doing this in a controlled " +"manner, such as by manually calling :func:`next` on a :func:`pointer` " +"iterator, this will typically lead to infinite loops or crashes, because " +"ctypes has no way of knowing when to stop iteration. In other words, a " +"``pointer`` iterator will infinitely yield arbitrary memory." +msgstr "" + msgid "" "Behind the scenes, the :func:`pointer` function does more than simply create " "pointer instances, it has to create pointer *types* first. This is done with " @@ -1434,8 +1454,8 @@ msgid "" "In the above, it's only safe for one object to read and write to the address " "at once if the GIL is disabled. So, ``pointer_a`` can be shared and written " "to across multiple threads, but only if ``pointer_b`` is not also attempting " -"to do the same. If this is an issue, consider using a :class:`threading." -"Lock` to synchronize access to memory:" +"to do the same. If this is an issue, consider using " +"a :class:`threading.Lock` to synchronize access to memory:" msgstr "" msgid "" @@ -1581,8 +1601,8 @@ msgstr "" msgid "" "because the new ``class cell`` is not available in the class statement " -"itself. In :mod:`!ctypes`, we can define the ``cell`` class and set the :" -"attr:`~Structure._fields_` attribute later, after the class statement::" +"itself. In :mod:`!ctypes`, we can define the ``cell`` class and set " +"the :attr:`~Structure._fields_` attribute later, after the class statement::" msgstr "" msgid "" @@ -2148,9 +2168,9 @@ msgid "" "Functions in this library use the standard C calling convention, and are " "assumed to return :c:expr:`int`. The Python :term:`global interpreter lock` " "is released before calling any function exported by these libraries, and " -"reacquired afterwards. For different function behavior, use a subclass: :py:" -"class:`~ctypes.OleDLL`, :py:class:`~ctypes.WinDLL`, or :py:class:`~ctypes." -"PyDLL`." +"reacquired afterwards. For different function behavior, use a " +"subclass: :py:class:`~ctypes.OleDLL`, :py:class:`~ctypes.WinDLL`, " +"or :py:class:`~ctypes.PyDLL`." msgstr "" msgid "" @@ -2162,9 +2182,9 @@ msgid "" msgstr "" msgid "" -"If *handle* is ``None``, the underlying platform's :manpage:`dlopen(3)` or :" -"c:func:`!LoadLibrary` function is used to load the library into the process, " -"and to get a handle to it." +"If *handle* is ``None``, the underlying platform's :manpage:`dlopen(3)` " +"or :c:func:`!LoadLibrary` function is used to load the library into the " +"process, and to get a handle to it." msgstr "" msgid "" @@ -2175,7 +2195,7 @@ msgstr "" msgid "" "On non-Windows systems, *name* can be ``None``. In this case, :c:func:`!" "dlopen` is called with ``NULL``, which opens the main program as a " -"\"library\". (Some systems do the same is *name* is empty; ``None``/``NULL`` " +"\"library\". (Some systems do the same if *name* is empty; ``None``/``NULL`` " "is more portable.)" msgstr "" @@ -2213,7 +2233,11 @@ msgid "" "ctypes` maintains a thread-local copy of the system's :data:`errno` " "variable; if you call foreign functions created with ``use_errno=True`` then " "the :data:`errno` value before the function call is swapped with the ctypes " -"private copy, the same happens immediately after the function call." +"private copy, the same happens immediately after the function call. This " +"mechanism only works for libraries that use the same C runtime library as " +"the interpreter itself. A library linked against a different C runtime (for " +"example, a different CRT on Windows) has its own :data:`errno`, which :mod:`!" +"ctypes` cannot observe." msgstr "" msgid "" @@ -2224,10 +2248,11 @@ msgstr "" msgid "" "The *use_last_error* parameter, when set to true, enables the same mechanism " -"for the Windows error code which is managed by the :func:`GetLastError` and :" -"func:`!SetLastError` Windows API functions; :func:`ctypes.get_last_error` " -"and :func:`ctypes.set_last_error` are used to request and change the ctypes " -"private copy of the windows error code." +"for the Windows error code which is managed by the :func:`GetLastError` " +"and :func:`!SetLastError` Windows API " +"functions; :func:`ctypes.get_last_error` and :func:`ctypes.set_last_error` " +"are used to request and change the ctypes private copy of the windows error " +"code." msgstr "" msgid "" @@ -2241,13 +2266,14 @@ msgstr "" msgid "" "On Windows creating a :class:`CDLL` instance may fail even if the DLL name " -"exists. When a dependent DLL of the loaded DLL is not found, a :exc:" -"`OSError` error is raised with the message *\"[WinError 126] The specified " -"module could not be found\".* This error message does not contain the name " -"of the missing DLL because the Windows API does not return this information " -"making this error hard to diagnose. To resolve this error and determine " -"which DLL is not found, you need to find the list of dependent DLLs and " -"determine which one is not found using Windows debugging and tracing tools." +"exists. When a dependent DLL of the loaded DLL is not found, " +"a :exc:`OSError` error is raised with the message *\"[WinError 126] The " +"specified module could not be found\".* This error message does not contain " +"the name of the missing DLL because the Windows API does not return this " +"information making this error hard to diagnose. To resolve this error and " +"determine which DLL is not found, you need to find the list of dependent " +"DLLs and determine which one is not found using Windows debugging and " +"tracing tools." msgstr "" msgid "" @@ -2295,18 +2321,19 @@ msgstr "" msgid "" "Functions in this library use the ``stdcall`` calling convention, and are " -"assumed to return the windows specific :class:`HRESULT` code. :class:" -"`HRESULT` values contain information specifying whether the function call " -"failed or succeeded, together with additional error code. If the return " -"value signals a failure, an :class:`OSError` is automatically raised." +"assumed to return the windows specific :class:`HRESULT` " +"code. :class:`HRESULT` values contain information specifying whether the " +"function call failed or succeeded, together with additional error code. If " +"the return value signals a failure, an :class:`OSError` is automatically " +"raised." msgstr "" msgid "Availability" msgstr "Dostępność" msgid "" -":exc:`WindowsError` used to be raised, which is now an alias of :exc:" -"`OSError`." +":exc:`WindowsError` used to be raised, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" @@ -2346,8 +2373,8 @@ msgid "" msgstr "" msgid "" -"Class which loads shared libraries. *dlltype* should be one of the :class:" -"`CDLL`, :class:`PyDLL`, :class:`WinDLL`, or :class:`OleDLL` types." +"Class which loads shared libraries. *dlltype* should be one of " +"the :class:`CDLL`, :class:`PyDLL`, :class:`WinDLL`, or :class:`OleDLL` types." msgstr "" msgid "" @@ -2384,9 +2411,12 @@ msgstr "" msgid "" "An instance of :class:`PyDLL` that exposes Python C API functions as " -"attributes. Note that all these functions are assumed to return C :c:expr:" -"`int`, which is of course not always the truth, so you have to assign the " -"correct :attr:`!restype` attribute to use these functions." +"attributes. Note that all these functions are assumed to return " +"C :c:expr:`int`, which is of course not always the truth, so you have to " +"assign the correct :attr:`!restype` attribute to use these functions." +msgstr "" + +msgid "If the Python interpreter is statically linked, this may be ``None``." msgstr "" msgid "" @@ -2396,9 +2426,9 @@ msgid "" msgstr "" msgid "" -"Accessing a function on a loaded library raises an auditing event ``ctypes." -"dlsym`` with arguments ``library`` (the library object) and ``name`` (the " -"symbol's name as a string or integer)." +"Accessing a function on a loaded library raises an auditing event " +"``ctypes.dlsym`` with arguments ``library`` (the library object) and " +"``name`` (the symbol's name as a string or integer)." msgstr "" msgid "" @@ -2461,19 +2491,20 @@ msgstr "" msgid "" "Assign a tuple of ctypes types to specify the argument types that the " -"function accepts. Functions using the ``stdcall`` calling convention can " -"only be called with the same number of arguments as the length of this " -"tuple; functions using the C calling convention accept additional, " -"unspecified arguments as well." +"function accepts. :exc:`TypeError` is raised if the function is called with " +"fewer arguments than the length of this tuple. Functions using the " +"``stdcall`` calling convention also raise :exc:`TypeError` if called with " +"more arguments; functions using the ``cdecl`` calling convention accept " +"additional, unspecified arguments as well." msgstr "" msgid "" -"When a foreign function is called, each actual argument is passed to the :" -"meth:`~_CData.from_param` class method of the items in the :attr:`argtypes` " -"tuple, this method allows adapting the actual argument to an object that the " -"foreign function accepts. For example, a :class:`c_char_p` item in the :" -"attr:`argtypes` tuple will convert a string passed as argument into a bytes " -"object using ctypes conversion rules." +"When a foreign function is called, each actual argument is passed to " +"the :meth:`~_CData.from_param` class method of the items in " +"the :attr:`argtypes` tuple, this method allows adapting the actual argument " +"to an object that the foreign function accepts. For example, " +"a :class:`c_char_p` item in the :attr:`argtypes` tuple will convert a string " +"passed as argument into a bytes object using ctypes conversion rules." msgstr "" msgid "" @@ -2499,22 +2530,49 @@ msgid "" msgstr "" msgid "" -"*arguments* is a tuple containing the parameters originally passed to the " -"function call, this allows specializing the behavior on the arguments used." +"*arguments* is a tuple containing the parameters passed to the function " +"call, including any output parameters that :mod:`!ctypes` created for the " +"call; this allows specializing the behavior on the arguments used." +msgstr "" + +msgid "" +"If the callable returns the *arguments* tuple it received, unchanged, :mod:`!" +"ctypes` continues its normal processing of the result, which includes " +"returning output parameters (see :ref:`ctypes-function-prototypes`). Any " +"other object returned by the callable is returned from the foreign function " +"call instead. The callable can also check the result value and raise an " +"exception if the foreign function call failed." msgstr "" msgid "" -"The object that this function returns will be returned from the foreign " -"function call, but it can also check the result value and raise an exception " -"if the foreign function call failed." +"For example, this callable raises an exception when the foreign function " +"signals failure with a negative return value, and otherwise leaves the " +"result to :mod:`!ctypes`::" +msgstr "" + +msgid "" +"def errcheck(result, func, arguments):\n" +" if result < 0:\n" +" raise RuntimeError(f\"call failed with error {result}\")\n" +" return arguments" +msgstr "" + +msgid "" +"This one instead replaces the result, converting a C ``int`` used as a " +"boolean into a :class:`bool`::" +msgstr "" + +msgid "" +"def errcheck(result, func, arguments):\n" +" return result != 0" msgstr "" msgid "" "On Windows, when a foreign function call raises a system exception (for " "example, due to an access violation), it will be captured and replaced with " -"a suitable Python exception. Further, an auditing event ``ctypes." -"set_exception`` with argument ``code`` will be raised, allowing an audit " -"hook to replace the exception with its own." +"a suitable Python exception. Further, an auditing event " +"``ctypes.set_exception`` with argument ``code`` will be raised, allowing an " +"audit hook to replace the exception with its own." msgstr "" msgid "" @@ -2539,9 +2597,10 @@ msgstr "" msgid "" "The returned function prototype creates functions that use the standard C " "calling convention. The function will release the GIL during the call. If " -"*use_errno* is set to true, the ctypes private copy of the system :data:" -"`errno` variable is exchanged with the real :data:`errno` value before and " -"after the call; *use_last_error* does the same for the Windows error code." +"*use_errno* is set to true, the ctypes private copy of the " +"system :data:`errno` variable is exchanged with the real :data:`errno` value " +"before and after the call; *use_last_error* does the same for the Windows " +"error code." msgstr "" msgid "" @@ -2552,7 +2611,10 @@ msgstr "" msgid "" "The returned function prototype creates functions that use the Python " -"calling convention. The function will *not* release the GIL during the call." +"calling convention. Unlike :func:`CFUNCTYPE` and :func:`WINFUNCTYPE`, " +"ctypes does *not* release the GIL before calling the foreign function, so " +"the function may safely use the Python C API. Note that this does not " +"prevent the GIL from being released *during* the call." msgstr "" msgid "" @@ -2601,8 +2663,8 @@ msgid "" msgstr "" msgid "" -"*paramflags* must be a tuple of the same length as :attr:`~_CFuncPtr." -"argtypes`." +"*paramflags* must be a tuple of the same length " +"as :attr:`~_CFuncPtr.argtypes`." msgstr "" msgid "" @@ -2785,8 +2847,8 @@ msgid "" msgstr "" msgid "" -"Copies a COM pointer from *src* to *dst* and returns the Windows specific :c:" -"type:`!HRESULT` value." +"Copies a COM pointer from *src* to *dst* and returns the Windows " +"specific :c:type:`!HRESULT` value." msgstr "" msgid "" @@ -2924,8 +2986,8 @@ msgstr "" msgid "" "Returns a textual description of the error code *code*. If no error code is " -"specified, the last error code is used by calling the Windows API function :" -"func:`GetLastError`." +"specified, the last error code is used by calling the Windows API " +"function :func:`GetLastError`." msgstr "" msgid "" @@ -2935,8 +2997,8 @@ msgid "" msgstr "" msgid "" -"Returns the current value of the ctypes-private copy of the system :data:" -"`errno` variable in the calling thread." +"Returns the current value of the ctypes-private copy of the " +"system :data:`errno` variable in the calling thread." msgstr "" msgid "" @@ -3034,10 +3096,10 @@ msgid "" msgstr "" msgid "" -"Creates an instance of :exc:`OSError`. If *code* is not specified, :func:" -"`GetLastError` is called to determine the error code. If *descr* is not " -"specified, :func:`FormatError` is called to get a textual description of the " -"error." +"Creates an instance of :exc:`OSError`. If *code* is not " +"specified, :func:`GetLastError` is called to determine the error code. If " +"*descr* is not specified, :func:`FormatError` is called to get a textual " +"description of the error." msgstr "" msgid "" @@ -3070,10 +3132,10 @@ msgstr "" msgid "" "This function is similar to :func:`string_at` with the key difference of not " "making a copy of the specified memory. It is a semantically equivalent (but " -"more efficient) alternative to ``memoryview((c_byte * size)." -"from_address(ptr))``. (While :meth:`~_CData.from_address` only takes " -"integers, *ptr* can also be given as a :class:`ctypes.POINTER` or a :func:" -"`~ctypes.byref` object.)" +"more efficient) alternative to ``memoryview((c_byte * " +"size).from_address(ptr))``. (While :meth:`~_CData.from_address` only takes " +"integers, *ptr* can also be given as a :class:`ctypes.POINTER` or " +"a :func:`~ctypes.byref` object.)" msgstr "" msgid "" @@ -3087,9 +3149,9 @@ msgstr "" msgid "" "This non-public class is the common base class of all ctypes data types. " "Among other things, all ctypes type instances contain a memory block that " -"hold C compatible data; the address of the memory block is returned by the :" -"func:`addressof` helper function. Another instance variable is exposed as :" -"attr:`_objects`; this contains other Python objects that need to be kept " +"hold C compatible data; the address of the memory block is returned by " +"the :func:`addressof` helper function. Another instance variable is exposed " +"as :attr:`_objects`; this contains other Python objects that need to be kept " "alive in case the memory block contains pointers." msgstr "" @@ -3102,8 +3164,8 @@ msgid "" "This method returns a ctypes instance that shares the buffer of the *source* " "object. The *source* object must support the writeable buffer interface. " "The optional *offset* parameter specifies an offset into the source buffer " -"in bytes; the default is zero. If the source buffer is not large enough a :" -"exc:`ValueError` is raised." +"in bytes; the default is zero. If the source buffer is not large enough " +"a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -3124,8 +3186,9 @@ msgid "" msgstr "" msgid "" -"This method, and others that indirectly call this method, raises an :ref:" -"`auditing event ` ``ctypes.cdata`` with argument ``address``." +"This method, and others that indirectly call this method, raises " +"an :ref:`auditing event ` ``ctypes.cdata`` with argument " +"``address``." msgstr "" msgid "" @@ -3161,9 +3224,9 @@ msgstr "" msgid "" "Sometimes ctypes data instances do not own the memory block they contain, " -"instead they share part of the memory block of a base object. The :attr:" -"`_b_base_` read-only member is the root ctypes object that owns the memory " -"block." +"instead they share part of the memory block of a base object. " +"The :attr:`_b_base_` read-only member is the root ctypes object that owns " +"the memory block." msgstr "" msgid "" @@ -3181,8 +3244,8 @@ msgstr "" msgid "" "This non-public class is the base class of all fundamental ctypes data " "types. It is mentioned here because it contains the common attributes of the " -"fundamental ctypes data types. :class:`_SimpleCData` is a subclass of :" -"class:`_CData`, so it inherits their methods and attributes. ctypes data " +"fundamental ctypes data types. :class:`_SimpleCData` is a subclass " +"of :class:`_CData`, so it inherits their methods and attributes. ctypes data " "types that are not and do not contain pointers can now be pickled." msgstr "" @@ -3214,11 +3277,11 @@ msgstr "" msgid "" "Types marked \\* in the summary may be (or always are) aliases of a " "different :class:`_SimpleCData` subclass, and will not necessarily use the " -"listed type code. For example, if the platform's :c:expr:`long`, :c:expr:" -"`long long` and :c:expr:`time_t` C types are the same, then :class:" -"`c_long`, :class:`c_longlong` and :class:`c_time_t` all refer to a single " -"class, :class:`c_long`, whose :attr:`_type_` code is ``'l'``. The ``'L'`` " -"code will be unused." +"listed type code. For example, if the " +"platform's :c:expr:`long`, :c:expr:`long long` and :c:expr:`time_t` C types " +"are the same, then :class:`c_long`, :class:`c_longlong` " +"and :class:`c_time_t` all refer to a single class, :class:`c_long`, " +"whose :attr:`_type_` code is ``'l'``. The ``'L'`` code will be unused." msgstr "" msgid "" @@ -3304,8 +3367,8 @@ msgid "" msgstr "" msgid "" -"Represents the C 8-bit :c:expr:`signed int` datatype. It is an alias for :" -"class:`c_byte`." +"Represents the C 8-bit :c:expr:`signed int` datatype. It is an alias " +"for :class:`c_byte`." msgstr "" msgid "" @@ -3331,8 +3394,8 @@ msgstr "" msgid "" "Represents the C :c:expr:`signed long long` datatype. The constructor " "accepts an optional integer initializer; no overflow checking is done. On " -"platforms where ``sizeof(long long) == sizeof(long)`` it is an alias to :" -"class:`c_long`." +"platforms where ``sizeof(long long) == sizeof(long)`` it is an alias " +"to :class:`c_long`." msgstr "" msgid "" @@ -3346,9 +3409,9 @@ msgid "" msgstr "" msgid "" -"Represents the :c:type:`Py_ssize_t` datatype. This is a signed version of :c:" -"type:`size_t`; that is, the POSIX :c:type:`ssize_t` type. Usually an alias " -"for another integer type." +"Represents the :c:type:`Py_ssize_t` datatype. This is a signed version " +"of :c:type:`size_t`; that is, the POSIX :c:type:`ssize_t` type. Usually an " +"alias for another integer type." msgstr "" msgid "" @@ -3369,8 +3432,8 @@ msgid "" msgstr "" msgid "" -"Represents the C 8-bit :c:expr:`unsigned int` datatype. It is an alias for :" -"class:`c_ubyte`." +"Represents the C 8-bit :c:expr:`unsigned int` datatype. It is an alias " +"for :class:`c_ubyte`." msgstr "" msgid "" @@ -3396,8 +3459,8 @@ msgstr "" msgid "" "Represents the C :c:expr:`unsigned long long` datatype. The constructor " "accepts an optional integer initializer; no overflow checking is done. On " -"platforms where ``sizeof(long long) == sizeof(long)`` it is an alias to :" -"class:`c_long`." +"platforms where ``sizeof(long long) == sizeof(long)`` it is an alias " +"to :class:`c_long`." msgstr "" msgid "" @@ -3441,11 +3504,353 @@ msgstr "" msgid ":class:`!py_object` is now a :term:`generic type`." msgstr "" +msgid "Windows data types" +msgstr "" + +msgid "**Source code:** :source:`Lib/ctypes/wintypes.py`" +msgstr "" + +msgid "" +"The :mod:`!ctypes.wintypes` module provides types for use with Windows APIs. " +"Most are aliases for types defined in :mod:`ctypes`. See Microsoft's " +"`Windows data types `_ documentation for the corresponding C definitions. On " +"non-Windows platforms, the sizes and layouts of these types may differ from " +"their Windows counterparts." +msgstr "" + +msgid "" +"Added :class:`HCONV`, :class:`HCONVLIST`, :class:`HCURSOR`, :class:`HDDEDATA`, :class:`HDROP`, :class:`HFILE`, :class:`HRESULT`, " +"and :class:`HSZ`." +msgstr "" + +msgid "" +">>> from ctypes import POINTER\n" +">>> from ctypes.wintypes import LPRECT, RECT, SHORT\n" +">>> SHORT(-1).value\n" +"-1\n" +">>> rect = RECT(0, 0, 100, 50)\n" +">>> rect.right, rect.bottom\n" +"(100, 50)\n" +">>> LPRECT is POINTER(RECT)\n" +"True" +msgstr "" + +msgid "Simple types" +msgstr "" + +msgid "The following names are aliases for fundamental :mod:`ctypes` types:" +msgstr "" + +msgid "Windows types" +msgstr "" + +msgid ":mod:`ctypes` type" +msgstr "" + +msgid ":class:`~ctypes.c_ubyte`" +msgstr "" + +msgid ":class:`~ctypes.c_char`" +msgstr "" + +msgid ":class:`~ctypes.c_wchar`" +msgstr "" + +msgid ":class:`~ctypes.c_ushort`" +msgstr "" + +msgid ":class:`~ctypes.c_ulong`" +msgstr "" + +msgid ":class:`~ctypes.c_long`" +msgstr "" + +msgid ":class:`~ctypes.c_int`" +msgstr "" + +msgid ":class:`~ctypes.c_uint`" +msgstr "" + +msgid ":class:`~ctypes.c_short`" +msgstr "" + +msgid ":class:`~ctypes.c_double`" +msgstr "" + +msgid ":class:`~ctypes.c_float`" +msgstr "" + +msgid ":class:`~ctypes.c_longlong`" +msgstr "" + +msgid ":class:`~ctypes.c_ulonglong`" +msgstr "" + +msgid ":class:`~ctypes.c_char_p`" +msgstr "" + +msgid ":class:`~ctypes.c_wchar_p`" +msgstr "" + +msgid ":class:`~ctypes.c_void_p`" +msgstr "" + +msgid "" +":class:`LARGE_INTEGER` and :class:`ULARGE_INTEGER` expose an integer :attr:`!" +"value` attribute, with no ``LowPart``, ``HighPart``, or ``QuadPart`` fields." +msgstr "" + +msgid "" +"An unsigned integer type with the same size as :class:`~ctypes.c_void_p`." +msgstr "" + +msgid "A signed integer type with the same size as :class:`~ctypes.c_void_p`." +msgstr "" + +msgid "" +"A 16-bit Boolean type whose :attr:`!value` attribute is a " +"Python :class:`bool`. Assigning to :attr:`!value` stores ``-1`` for a true " +"value and ``0`` for a false value." +msgstr "" + +msgid "Handle types" +msgstr "" + +msgid "" +"An alias for :class:`~ctypes.c_void_p`, used to represent Windows handles." +msgstr "" + +msgid "" +"Aliases for :class:`HANDLE` for use with specific Windows " +"APIs. :class:`HFILE` is an alias for :class:`INT` and is listed among the " +"simple types above." +msgstr "" + +msgid "Structures" +msgstr "" + +msgid "The following types are subclasses of :class:`ctypes.Structure`." +msgstr "" + +msgid "" +"A rectangle with ``left``, ``top``, ``right``, and ``bottom`` fields, all of " +"type :class:`LONG`." +msgstr "" + +msgid "" +"A rectangle with ``Left``, ``Top``, ``Right``, and ``Bottom`` fields, all of " +"type :class:`SHORT`." +msgstr "" + +msgid "A point with ``x`` and ``y`` fields, both of type :class:`LONG`." +msgstr "" + +msgid "Dimensions with ``cx`` and ``cy`` fields, both of type :class:`LONG`." +msgstr "" + +msgid "" +"A file time with ``dwLowDateTime`` and ``dwHighDateTime`` fields, both of " +"type :class:`DWORD`." +msgstr "" + +msgid "A Windows message with the following fields:" +msgstr "" + +msgid "Field" +msgstr "Pole" + +msgid "Type" +msgstr "Typ" + +msgid "``hWnd``" +msgstr "" + +msgid ":class:`HWND`" +msgstr "" + +msgid "``message``" +msgstr "" + +msgid ":class:`UINT`" +msgstr "" + +msgid "``wParam``" +msgstr "" + +msgid ":class:`WPARAM`" +msgstr "" + +msgid "``lParam``" +msgstr "" + +msgid ":class:`LPARAM`" +msgstr "" + +msgid "``time``" +msgstr "" + +msgid ":class:`DWORD`" +msgstr "" + +msgid "``pt``" +msgstr "" + +msgid ":class:`POINT`" +msgstr "" + +msgid "" +"Structures used by Windows file-search functions, with the following " +"fields. :class:`WIN32_FIND_DATAA` uses :class:`CHAR` for its file names, " +"and :class:`WIN32_FIND_DATAW` uses :class:`WCHAR`." +msgstr "" + +msgid "Fields" +msgstr "" + +msgid "``dwFileAttributes``" +msgstr "" + +msgid "``ftCreationTime``, ``ftLastAccessTime``, ``ftLastWriteTime``" +msgstr "" + +msgid ":class:`FILETIME`" +msgstr "" + +msgid "``nFileSizeHigh``, ``nFileSizeLow``" +msgstr "" + +msgid "``dwReserved0``, ``dwReserved1``" +msgstr "" + +msgid "``cFileName``" +msgstr "" + +msgid "An array of :data:`MAX_PATH` characters" +msgstr "" + +msgid "``cAlternateFileName``" +msgstr "" + +msgid "An array of 14 characters" +msgstr "" + +msgid "Pointer types" +msgstr "" + +msgid "" +"The following names are aliases for ``ctypes.POINTER(T)``, where *T* is the " +"type in the second column:" +msgstr "" + +msgid "Referenced type" +msgstr "" + +msgid ":class:`BOOL`" +msgstr "" + +msgid ":class:`BOOLEAN`" +msgstr "" + +msgid ":class:`BYTE`" +msgstr "" + +msgid ":class:`CHAR`" +msgstr "" + +msgid ":class:`COLORREF`" +msgstr "" + +msgid ":class:`FLOAT`" +msgstr "" + +msgid ":class:`HANDLE`" +msgstr "" + +msgid ":class:`HKEY`" +msgstr "" + +msgid ":class:`HKL`" +msgstr "" + +msgid ":class:`INT`" +msgstr "" + +msgid ":class:`LARGE_INTEGER`" +msgstr "" + +msgid ":class:`LCID`" +msgstr "" + +msgid ":class:`LONG`" +msgstr "" + +msgid ":class:`MSG`" +msgstr "" + +msgid ":class:`POINTL`" +msgstr "" + +msgid ":class:`RECT`" +msgstr "" + +msgid ":class:`RECTL`" +msgstr "" + +msgid ":class:`SC_HANDLE`" +msgstr "" + +msgid ":class:`SHORT`" +msgstr "" + +msgid ":class:`SIZE`" +msgstr "" + +msgid ":class:`SIZEL`" +msgstr "" + +msgid ":class:`SMALL_RECT`" +msgstr "" + +msgid ":class:`ULARGE_INTEGER`" +msgstr "" + +msgid ":class:`ULONG`" +msgstr "" + +msgid ":class:`USHORT`" +msgstr "" + +msgid ":class:`WCHAR`" +msgstr "" + +msgid ":class:`WIN32_FIND_DATAA`" +msgstr "" + +msgid ":class:`WIN32_FIND_DATAW`" +msgstr "" + +msgid ":class:`WORD`" +msgstr "" + +msgid "Constants and functions" +msgstr "" + +msgid "" +"The value ``260``, used as the size of the file-name arrays " +"in :class:`WIN32_FIND_DATAA` and :class:`WIN32_FIND_DATAW`." +msgstr "" + +msgid "" +"Return a :class:`COLORREF` value as a Python integer. The *red*, *green*, " +"and *blue* arguments are integers from ``0`` to ``255``, specifying the " +"intensity of each color component::" +msgstr "" + msgid "" -"The :mod:`!ctypes.wintypes` module provides quite some other Windows " -"specific data types, for example :c:type:`!HWND`, :c:type:`!WPARAM`, :c:type:" -"`!VARIANT_BOOL` or :c:type:`!DWORD`. Some useful structures like :c:type:`!" -"MSG` or :c:type:`!RECT` are also defined." +">>> from ctypes.wintypes import RGB\n" +">>> hex(RGB(255, 128, 0))\n" +"'0x80ff'" msgstr "" msgid "Structured data types" @@ -3455,8 +3860,8 @@ msgid "Abstract base class for unions in native byte order." msgstr "" msgid "" -"Unions share common attributes and behavior with structures; see :class:" -"`Structure` documentation for details." +"Unions share common attributes and behavior with structures; " +"see :class:`Structure` documentation for details." msgstr "" msgid "Abstract base class for unions in *big endian* byte order." @@ -3525,10 +3930,10 @@ msgstr "" msgid "" "Additionally, the :attr:`!_fields_` class variable must be defined before " "the structure or union type is first used: an instance or subclass is " -"created, :func:`sizeof` is called on it, and so on. Later assignments to :" -"attr:`!_fields_` will raise an :exc:`AttributeError`. If :attr:`!_fields_` " -"has not been set before such use, the structure or union will have no own " -"fields, as if :attr:`!_fields_` was empty." +"created, :func:`sizeof` is called on it, and so on. Later assignments " +"to :attr:`!_fields_` will raise an :exc:`AttributeError`. If :attr:`!" +"_fields_` has not been set before such use, the structure or union will have " +"no own fields, as if :attr:`!_fields_` was empty." msgstr "" msgid "" @@ -3542,8 +3947,8 @@ msgid "" msgstr "" msgid "" -"This is only implemented for the MSVC-compatible memory layout (see :attr:" -"`_layout_`)." +"This is only implemented for the MSVC-compatible memory layout " +"(see :attr:`_layout_`)." msgstr "" msgid "" @@ -3603,8 +4008,8 @@ msgstr "" msgid "" "``\"gcc-sysv\"``: the layout used by GCC with the System V or “SysV-like” " -"data model, as used on Linux and macOS. With this layout, :attr:`~Structure." -"_pack_` must be unset or zero." +"data model, as used on Linux and macOS. With this " +"layout, :attr:`~Structure._pack_` must be unset or zero." msgstr "" msgid "" @@ -3631,15 +4036,15 @@ msgid "" msgstr "" msgid "" -"An optional sequence that lists the names of unnamed (anonymous) fields. :" -"attr:`_anonymous_` must be already defined when :attr:`_fields_` is " +"An optional sequence that lists the names of unnamed (anonymous) " +"fields. :attr:`_anonymous_` must be already defined when :attr:`_fields_` is " "assigned, otherwise it will have no effect." msgstr "" msgid "" -"The fields listed in this variable must be structure or union type fields. :" -"mod:`!ctypes` will create descriptors in the structure type that allows " -"accessing the nested fields directly, without the need to create the " +"The fields listed in this variable must be structure or union type " +"fields. :mod:`!ctypes` will create descriptors in the structure type that " +"allows accessing the nested fields directly, without the need to create the " "structure or union field." msgstr "" @@ -3676,9 +4081,9 @@ msgstr "" msgid "" "It is possible to define sub-subclasses of structures, they inherit the " -"fields of the base class. If the subclass definition has a separate :attr:" -"`_fields_` variable, the fields specified in this are appended to the fields " -"of the base class." +"fields of the base class. If the subclass definition has a " +"separate :attr:`_fields_` variable, the fields specified in this are " +"appended to the fields of the base class." msgstr "" msgid "" @@ -3766,8 +4171,9 @@ msgid "True if this is a bitfield." msgstr "" msgid "" -"The location of a bitfield within its *storage unit*, that is, within :attr:" -"`~CField.byte_size` bytes of memory starting at :attr:`~CField.byte_offset`." +"The location of a bitfield within its *storage unit*, that is, " +"within :attr:`~CField.byte_size` bytes of memory starting " +"at :attr:`~CField.byte_offset`." msgstr "" msgid "" @@ -3793,18 +4199,21 @@ msgid "Abstract base class for arrays." msgstr "" msgid "" -"The recommended way to create concrete array types is by multiplying any :" -"mod:`!ctypes` data type with a non-negative integer. Alternatively, you can " -"subclass this type and define :attr:`_length_` and :attr:`_type_` class " -"variables. Array elements can be read and written using standard subscript " -"and slice accesses; for slice reads, the resulting object is *not* itself " -"an :class:`Array`." +"The recommended way to create concrete array types is by multiplying " +"any :mod:`!ctypes` data type with a non-negative integer. Alternatively, " +"you can subclass this type and define :attr:`_length_` and :attr:`_type_` " +"class variables. Array elements can be read and written using standard " +"subscript and slice accesses; for slice reads, the resulting object is *not* " +"itself an :class:`Array`." +msgstr "" + +msgid "Arrays are :ref:`generic ` over the type of their elements." msgstr "" msgid "" "A positive integer specifying the number of elements in the array. Out-of-" -"range subscripts result in an :exc:`IndexError`. Will be returned by :func:" -"`len`." +"range subscripts result in an :exc:`IndexError`. Will be returned " +"by :func:`len`." msgstr "" msgid "Specifies the type of each element in the array." @@ -3820,9 +4229,7 @@ msgid "" "ctypes` data type and *length* an integer." msgstr "" -msgid "" -"This function is :term:`soft deprecated` in favor of multiplication. There " -"are no plans to remove it." +msgid "In favor of multiplication." msgstr "" msgid "Private, abstract base class for pointers." @@ -3835,10 +4242,10 @@ msgstr "" msgid "" "If a pointer points to an array, its elements can be read and written using " -"standard subscript and slice accesses. Pointer objects have no size, so :" -"func:`len` will raise :exc:`TypeError`. Negative subscripts will read from " -"the memory *before* the pointer (as in C), and out-of-range subscripts will " -"probably crash with an access violation (if you're lucky)." +"standard subscript and slice accesses. Pointer objects have no size, " +"so :func:`len` will raise :exc:`TypeError`. Negative subscripts will read " +"from the memory *before* the pointer (as in C), and out-of-range subscripts " +"will probably crash with an access violation (if you're lucky)." msgstr "" msgid "Specifies the type pointed to." diff --git a/library/curses.ascii.po b/library/curses.ascii.po index 52269cfa7d..70b3746f73 100644 --- a/library/curses.ascii.po +++ b/library/curses.ascii.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -170,7 +170,7 @@ msgstr "" msgid "Checks for a character value that fits in the 7-bit ASCII set." msgstr "" -msgid "Checks for an ASCII whitespace character; space or horizontal tab." +msgid "Checks for an ASCII blank character; space or horizontal tab." msgstr "" msgid "" @@ -182,7 +182,7 @@ msgid "" "equivalent to ``c in string.digits``." msgstr "" -msgid "Checks for ASCII any printable character except space." +msgid "Checks for any ASCII printable character except space." msgstr "" msgid "Checks for an ASCII lower-case character." @@ -192,7 +192,7 @@ msgid "Checks for any ASCII printable character including space." msgstr "" msgid "" -"Checks for any printable ASCII character which is not a space or an " +"Checks for any ASCII printable character which is not a space or an " "alphanumeric character." msgstr "" @@ -205,11 +205,13 @@ msgid "Checks for an ASCII uppercase letter." msgstr "" msgid "" -"Checks for an ASCII hexadecimal digit. This is equivalent to ``c in string." -"hexdigits``." +"Checks for an ASCII hexadecimal digit. This is equivalent to ``c in " +"string.hexdigits``." msgstr "" -msgid "Checks for an ASCII control character (ordinal values 0 to 31)." +msgid "" +"Checks for an ASCII control character (ordinal values 0 to 31). " +"Unlike :func:`iscntrl`, this does not include the delete character (0x7f)." msgstr "" msgid "Checks for a non-ASCII character (ordinal values 0x80 and above)." @@ -217,8 +219,8 @@ msgstr "" msgid "" "These functions accept either integers or single-character strings; when the " -"argument is a string, it is first converted using the built-in function :" -"func:`ord`." +"argument is a string, it is first converted using the built-in " +"function :func:`ord`." msgstr "" msgid "" diff --git a/library/curses.panel.po b/library/curses.panel.po index 671316ee29..734a21ad8b 100644 --- a/library/curses.panel.po +++ b/library/curses.panel.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,6 +35,12 @@ msgstr "" msgid "Functions" msgstr "Zadania" +msgid "The module :mod:`!curses.panel` defines the following exception:" +msgstr "" + +msgid "Exception raised when a curses panel library function returns an error." +msgstr "" + msgid "The module :mod:`!curses.panel` defines the following functions:" msgstr "" @@ -42,10 +48,10 @@ msgid "Returns the bottom panel in the panel stack." msgstr "" msgid "" -"Returns a panel object, associating it with the given window *win*. Be aware " -"that you need to keep the returned panel object referenced explicitly. If " -"you don't, the panel object is garbage collected and removed from the panel " -"stack." +"Returns a panel object, associating it with the given window *win* and " +"placing the new panel on top of the panel stack. Be aware that you need to " +"keep the returned panel object referenced explicitly. If you don't, the " +"panel object is garbage collected and removed from the panel stack." msgstr "" msgid "Returns the top panel in the panel stack." @@ -56,12 +62,12 @@ msgid "" "call :func:`curses.doupdate`, so you'll have to do this yourself." msgstr "" -msgid "Panel Objects" +msgid "Panel objects" msgstr "" msgid "" "Panel objects, as returned by :func:`new_panel` above, are windows with a " -"stacking order. There's always a window associated with a panel which " +"stacking order. There's always a window associated with a panel which " "determines the content, while the panel methods are responsible for the " "window's depth in the panel stack." msgstr "" @@ -98,7 +104,9 @@ msgid "" "arbitrary piece of data with the panel, and can be any Python object." msgstr "" -msgid "Display the panel (which might have been hidden)." +msgid "" +"Display the panel (which might have been hidden), placing it on top of the " +"panel stack." msgstr "" msgid "Push panel to the top of the stack." diff --git a/library/curses.po b/library/curses.po index e10fa6f8d1..4ff7545150 100644 --- a/library/curses.po +++ b/library/curses.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# Stan Ulbrych, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Stan Ulbrych, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -58,12 +58,14 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "" "Whenever the documentation mentions a *character* it can be specified as an " -"integer, a one-character Unicode string or a one-byte byte string." +"integer, a one-character Unicode string or a one-byte byte string. An " +"integer is the code of a single encoded byte, optionally combined with " +"attributes and a color pair, as returned by :meth:`window.inch`." msgstr "" msgid "" @@ -71,6 +73,15 @@ msgid "" "as a Unicode string or a byte string." msgstr "" +msgid "" +"Whether curses may be used from several threads depends on the underlying " +"library and how it was built. In many implementations, including the default " +"build of ncurses, the screen state is shared and not thread-safe; since the " +"blocking and refresh methods (such as :meth:`~window.getch` " +"and :meth:`~window.refresh`) release the :term:`GIL`, unsynchronized use " +"from several threads can then crash the interpreter. Serialize the calls." +msgstr "" + msgid "Module :mod:`curses.ascii`" msgstr "moduł :mod:`curses.ascii`" @@ -134,6 +145,9 @@ msgstr "" msgid "Change the definition of the color-pair ``0`` to ``(fg, bg)``." msgstr "" +msgid "This is an ncurses extension." +msgstr "" + msgid "" "Return the output speed of the terminal in bits per second. On software " "terminal emulators it will have a fixed high value. Included for historical " @@ -163,15 +177,15 @@ msgid "" "color *color_number*, which must be between ``0`` and ``COLORS - 1``. " "Return a 3-tuple, containing the R,G,B values for the given color, which " "will be between ``0`` (no component) and ``1000`` (maximum amount of " -"component)." +"component). Raise an exception if the color is not supported." msgstr "" msgid "" "Return the attribute value for displaying text in the specified color pair. " "Only the first 256 color pairs are supported. This attribute value can be " -"combined with :const:`A_STANDOUT`, :const:`A_REVERSE`, and the other :const:" -"`!A_\\*` attributes. :func:`pair_number` is the counterpart to this " -"function." +"combined with :const:`A_STANDOUT`, :const:`A_REVERSE`, and the " +"other :const:`!A_\\*` attributes. :func:`pair_number` is the counterpart to " +"this function." msgstr "" msgid "" @@ -185,15 +199,15 @@ msgstr "" msgid "" "Save the current terminal mode as the \"program\" mode, the mode when the " "running program is using curses. (Its counterpart is the \"shell\" mode, " -"for when the program is not in curses.) Subsequent calls to :func:" -"`reset_prog_mode` will restore this mode." +"for when the program is not in curses.) Subsequent calls " +"to :func:`reset_prog_mode` will restore this mode." msgstr "" msgid "" "Save the current terminal mode as the \"shell\" mode, the mode when the " "running program is not using curses. (Its counterpart is the \"program\" " -"mode, when the program is using curses capabilities.) Subsequent calls to :" -"func:`reset_shell_mode` will restore this mode." +"mode, when the program is using curses capabilities.) Subsequent calls " +"to :func:`reset_shell_mode` will restore this mode." msgstr "" msgid "Insert an *ms* millisecond pause in output." @@ -202,7 +216,7 @@ msgstr "" msgid "" "Update the physical screen. The curses library keeps two data structures, " "one representing the current physical screen contents and a virtual screen " -"representing the desired next state. The :func:`doupdate` ground updates " +"representing the desired next state. The :func:`doupdate` function updates " "the physical screen to match the virtual screen." msgstr "" @@ -212,8 +226,8 @@ msgid "" "a window. The normal :meth:`~window.refresh` call is simply :meth:`!" "noutrefresh` followed by :func:`!doupdate`; if you have to update multiple " "windows, you can speed performance and perhaps reduce screen flicker by " -"issuing :meth:`!noutrefresh` calls on all windows, followed by a single :" -"func:`!doupdate`." +"issuing :meth:`!noutrefresh` calls on all windows, followed by a " +"single :func:`!doupdate`." msgstr "" msgid "" @@ -232,12 +246,12 @@ msgstr "" msgid "" "The :func:`.filter` routine, if used, must be called before :func:`initscr` " -"is called. The effect is that, during those calls, :envvar:`LINES` is set " -"to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, ``cuu1``, " -"``cuu``, ``vpa`` are disabled; and the ``home`` string is set to the value " -"of ``cr``. The effect is that the cursor is confined to the current line, " -"and so are screen updates. This may be used for enabling character-at-a-" -"time line editing without touching the rest of the screen." +"is called. The effect is that, during the initialization, :envvar:`LINES` " +"is set to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, " +"``cuu1``, ``cuu``, ``vpa`` are disabled; and the ``home`` string is set to " +"the value of ``cr``. The effect is that the cursor is confined to the " +"current line, and so are screen updates. This may be used for enabling " +"character-at-a-time line editing without touching the rest of the screen." msgstr "" msgid "" @@ -259,10 +273,8 @@ msgid "" "coordinates. (*z* is currently unused.) *bstate* is an integer value whose " "bits will be set to indicate the type of event, and will be the bitwise OR " "of one or more of the following constants, where *n* is the button number " -"from 1 to 5: :const:`BUTTONn_PRESSED`, :const:`BUTTONn_RELEASED`, :const:" -"`BUTTONn_CLICKED`, :const:`BUTTONn_DOUBLE_CLICKED`, :const:" -"`BUTTONn_TRIPLE_CLICKED`, :const:`BUTTON_SHIFT`, :const:`BUTTON_CTRL`, :" -"const:`BUTTON_ALT`." +"from 1 to " +"5: :const:`BUTTONn_PRESSED`, :const:`BUTTONn_RELEASED`, :const:`BUTTONn_CLICKED`, :const:`BUTTONn_DOUBLE_CLICKED`, :const:`BUTTONn_TRIPLE_CLICKED`, :const:`BUTTON_SHIFT`, :const:`BUTTON_CTRL`, :const:`BUTTON_ALT`." msgstr "" msgid "" @@ -277,9 +289,10 @@ msgid "" msgstr "" msgid "" -"Read window related data stored in the file by an earlier :func:`window." -"putwin` call. The routine then creates and initializes a new window using " -"that data, returning the new window object." +"Read window-related data stored in the file by an " +"earlier :meth:`window.putwin` call. The routine then creates and initializes " +"a new window using that data, returning the new window object. The *file* " +"argument must be a file object opened for reading in binary mode." msgstr "" msgid "" @@ -290,7 +303,7 @@ msgstr "" msgid "" "Return ``True`` if the module supports extended colors; otherwise, return " "``False``. Extended color support allows more than 256 color pairs for " -"terminals that support more than 16 colors (e.g. xterm-256color)." +"terminals that support more than 16 colors (for example, xterm-256color)." msgstr "" msgid "Extended color support requires ncurses version 6.1 or later." @@ -317,9 +330,11 @@ msgstr "" msgid "" "Used for half-delay mode, which is similar to cbreak mode in that characters " "typed by the user are immediately available to the program. However, after " -"blocking for *tenths* tenths of seconds, raise an exception if nothing has " -"been typed. The value of *tenths* must be a number between ``1`` and " -"``255``. Use :func:`nocbreak` to leave half-delay mode." +"blocking for *tenths* tenths of seconds, if nothing has been " +"typed, :meth:`~window.getch` returns ``-1``, while :meth:`~window.getkey` " +"and :meth:`~window.get_wch` raise :exc:`curses.error`. The value of *tenths* " +"must be a number between ``1`` and ``255``. Use :func:`nocbreak` to leave " +"half-delay mode." msgstr "" msgid "" @@ -337,10 +352,10 @@ msgid "" "Change the definition of a color-pair. It takes three arguments: the number " "of the color-pair to be changed, the foreground color number, and the " "background color number. The value of *pair_number* must be between ``1`` " -"and ``COLOR_PAIRS - 1`` (the ``0`` color pair can only be changed by :func:" -"`use_default_colors` and :func:`assume_default_colors`). The value of *fg* " -"and *bg* arguments must be between ``0`` and ``COLORS - 1``, or, after " -"calling :func:`!use_default_colors` or :func:`!assume_default_colors`, " +"and ``COLOR_PAIRS - 1`` (the ``0`` color pair can only be changed " +"by :func:`use_default_colors` and :func:`assume_default_colors`). The value " +"of *fg* and *bg* arguments must be between ``0`` and ``COLORS - 1``, or, " +"after calling :func:`!use_default_colors` or :func:`!assume_default_colors`, " "``-1``. If the color-pair was previously initialized, the screen is " "refreshed and all occurrences of that color-pair are changed to the new " "definition." @@ -351,11 +366,21 @@ msgid "" "object which represents the whole screen." msgstr "" +msgid "" +"See :func:`setupterm` for a caveat about calling it before this function." +msgstr "" + msgid "" "If there is an error opening the terminal, the underlying curses library may " "cause the interpreter to exit." msgstr "" +msgid "" +"If *flag* is ``True``, pressing an interrupt key (interrupt, break, or quit) " +"will flush all output in the terminal driver queue. If *flag* is ``False``, " +"no flushing is done." +msgstr "" + msgid "" "Return ``True`` if :func:`resize_term` would modify the window structure, " "``False`` otherwise." @@ -376,6 +401,9 @@ msgid "" "character." msgstr "" +msgid "Raise a :exc:`ValueError` if *k* is negative." +msgstr "" + msgid "" "Return the user's current line kill character as a one-byte bytes object. " "Under Unix operating systems this is a property of the controlling tty of " @@ -396,16 +424,17 @@ msgstr "" msgid "" "Set the maximum time in milliseconds that can elapse between press and " "release events in order for them to be recognized as a click, and return the " -"previous interval value. The default value is 200 milliseconds, or one " -"fifth of a second." +"previous interval value. The default value is 166 milliseconds, or one " +"sixth of a second. Use a negative *interval* to obtain the interval value " +"without changing it." msgstr "" msgid "" "Set the mouse events to be reported, and return a tuple ``(availmask, " "oldmask)``. *availmask* indicates which of the specified mouse events can " "be reported; on complete failure it returns ``0``. *oldmask* is the " -"previous value of the given window's mouse event mask. If this function is " -"never called, no mouse events are ever reported." +"previous value of the mouse event mask. If this function is never called, " +"no mouse events are ever reported." msgstr "" msgid "Sleep for *ms* milliseconds." @@ -421,14 +450,14 @@ msgid "" "and is not necessarily associated with a particular part of the screen. " "Pads can be used when a large window is needed, and only a part of the " "window will be on the screen at one time. Automatic refreshes of pads (such " -"as from scrolling or echoing of input) do not occur. The :meth:`~window." -"refresh` and :meth:`~window.noutrefresh` methods of a pad require 6 " -"arguments to specify the part of the pad to be displayed and the location on " -"the screen to be used for the display. The arguments are *pminrow*, " -"*pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* arguments " -"refer to the upper left corner of the pad region to be displayed and the *s* " -"arguments define a clipping box on the screen within which the pad region is " -"to be displayed." +"as from scrolling or echoing of input) do not occur. " +"The :meth:`~window.refresh` and :meth:`~window.noutrefresh` methods of a pad " +"require 6 arguments to specify the part of the pad to be displayed and the " +"location on the screen to be used for the display. The arguments are " +"*pminrow*, *pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* " +"arguments refer to the upper-left corner of the pad region to be displayed " +"and the *s* arguments define a clipping box on the screen within which the " +"pad region is to be displayed." msgstr "" msgid "" @@ -447,6 +476,9 @@ msgid "" "mode is initially on." msgstr "" +msgid "If *flag* is ``False``, the effect is the same as calling :func:`nonl`." +msgstr "" + msgid "" "Leave cbreak mode. Return to normal \"cooked\" mode with line buffering." msgstr "" @@ -481,14 +513,17 @@ msgid "" msgstr "" msgid "" -"Return the number of the color-pair set by the attribute value *attr*. :func:" -"`color_pair` is the counterpart to this function." +"Return the number of the color-pair set by the attribute value " +"*attr*. :func:`color_pair` is the counterpart to this function." msgstr "" msgid "" "Equivalent to ``tputs(str, 1, putchar)``; emit the value of a specified " -"terminfo capability for the current terminal. Note that the output of :func:" -"`putp` always goes to standard output." +"terminfo capability, a bytes object, for the current terminal. Note that the " +"output of :func:`putp` always goes to standard output." +msgstr "" + +msgid ":func:`setupterm` (or :func:`initscr`) must be called first." msgstr "" msgid "" @@ -504,18 +539,18 @@ msgid "" msgstr "" msgid "" -"Restore the terminal to \"program\" mode, as previously saved by :func:" -"`def_prog_mode`." +"Restore the terminal to \"program\" mode, as previously saved " +"by :func:`def_prog_mode`." msgstr "" msgid "" -"Restore the terminal to \"shell\" mode, as previously saved by :func:" -"`def_shell_mode`." +"Restore the terminal to \"shell\" mode, as previously saved " +"by :func:`def_shell_mode`." msgstr "" msgid "" -"Restore the state of the terminal modes to what it was at the last call to :" -"func:`savetty`." +"Restore the state of the terminal modes to what it was at the last call " +"to :func:`savetty`." msgstr "" msgid "" @@ -534,8 +569,8 @@ msgid "" msgstr "" msgid "" -"Save the current state of the terminal modes in a buffer, usable by :func:" -"`resetty`." +"Save the current state of the terminal modes in a buffer, usable " +"by :func:`resetty`." msgstr "" msgid "Retrieves the value set by :func:`set_escdelay`." @@ -568,6 +603,18 @@ msgid "" "descriptor for ``sys.stdout`` will be used." msgstr "" +msgid "" +"Raise a :exc:`curses.error` if the terminal could not be found or its " +"terminfo database entry could not be read. If the terminal has already been " +"initialized, this function has no effect." +msgstr "" + +msgid "" +"Calling :func:`initscr` after :func:`setupterm` leaks the terminal " +"that :func:`setupterm` allocated: the curses library keeps only a single " +"current terminal and does not free the previously allocated one." +msgstr "" + msgid "" "Must be called if the programmer wants to use colors, and before any other " "color manipulation routine is called. It is good practice to call this " @@ -576,11 +623,11 @@ msgstr "" msgid "" ":func:`start_color` initializes eight basic colors (black, red, green, " -"yellow, blue, magenta, cyan, and white), and two global variables in the :" -"mod:`!curses` module, :const:`COLORS` and :const:`COLOR_PAIRS`, containing " -"the maximum number of colors and color-pairs the terminal can support. It " -"also restores the colors on the terminal to the values they had when the " -"terminal was just turned on." +"yellow, blue, magenta, cyan, and white), and two global variables in " +"the :mod:`!curses` module, :const:`COLORS` and :const:`COLOR_PAIRS`, " +"containing the maximum number of colors and color-pairs the terminal can " +"support. It also restores the colors on the terminal to the values they had " +"when the terminal was just turned on." msgstr "" msgid "" @@ -590,8 +637,10 @@ msgid "" msgstr "" msgid "" -"Return the value of the environment variable :envvar:`TERM`, as a bytes " -"object, truncated to 14 characters." +"Return the name of the terminal in use, as a bytes object. This is the name " +"passed to :func:`setupterm`, or the value of the :envvar:`TERM` environment " +"variable if none was given. Some curses libraries truncate it to 14 " +"characters." msgstr "" msgid "" @@ -617,9 +666,10 @@ msgstr "" msgid "" "Instantiate the bytes object *str* with the supplied parameters, where *str* " -"should be a parameterized string obtained from the terminfo database. E.g. " -"``tparm(tigetstr(\"cup\"), 5, 3)`` could result in ``b'\\033[6;4H'``, the " -"exact result depending on terminal type." +"should be a parameterized byte string obtained from the terminfo database. " +"For example, ``tparm(tigetstr(\"cup\"), 5, 3)`` could result in " +"``b'\\033[6;4H'``, the exact result depending on terminal type. Up to nine " +"integer parameters may be supplied." msgstr "" msgid "" @@ -638,14 +688,19 @@ msgstr "" msgid "" "Return a bytes object which is a printable representation of the character " -"*ch*. Control characters are represented as a caret followed by the " -"character, for example as ``b'^C'``. Printing characters are left as they " -"are." +"*ch*; any attributes and color pair are ignored. Control characters are " +"represented as a caret followed by the character, for example as ``b'^C'``. " +"Printing characters are left as they are." msgstr "" msgid "Push *ch* so the next :meth:`~window.getch` will return it." msgstr "" +msgid "" +"*ch* may be an integer (a key code or the code of an encoded byte), a byte, " +"or a string of length 1 which encodes to a single byte." +msgstr "" + msgid "Only one *ch* can be pushed before :meth:`!getch` is called." msgstr "" @@ -657,6 +712,11 @@ msgstr "" msgid "Push *ch* so the next :meth:`~window.get_wch` will return it." msgstr "" +msgid "" +"*ch* may be an integer (a character code, not a key code) or a string of " +"length 1." +msgstr "" + msgid "Only one *ch* can be pushed before :meth:`!get_wch` is called." msgstr "" @@ -690,7 +750,7 @@ msgid "" "echo, and disables the terminal keypad." msgstr "" -msgid "Window Objects" +msgid "Window objects" msgstr "" msgid "" @@ -706,7 +766,7 @@ msgstr "" msgid "" "Writing outside the window, subwindow, or pad raises a :exc:`curses.error`. " -"Attempting to write to the lower right corner of a window, subwindow, or pad " +"Attempting to write to the lower-right corner of a window, subwindow, or pad " "will cause an exception to be raised after the character is printed." msgstr "" @@ -722,17 +782,16 @@ msgstr "" msgid "" "Writing outside the window, subwindow, or pad raises :exc:`curses.error`. " -"Attempting to write to the lower right corner of a window, subwindow, or pad " +"Attempting to write to the lower-right corner of a window, subwindow, or pad " "will cause an exception to be raised after the string is printed." msgstr "" msgid "" -"A `bug in ncurses `_, the backend for " -"this Python module, can cause SegFaults when resizing windows. This is fixed " -"in ncurses-6.1-20190511. If you are stuck with an earlier ncurses, you can " -"avoid triggering this if you do not call :func:`addstr` with a *str* that " -"has embedded newlines. Instead, call :func:`addstr` separately for each " -"line." +"A bug in ncurses, the backend for this Python module, could cause segfaults " +"when resizing windows. This was fixed in ncurses-6.1-20190511. If you are " +"stuck with an earlier ncurses, you can avoid triggering it by not " +"calling :meth:`!addstr` with a *str* that has embedded newlines; instead, " +"call :meth:`!addstr` separately for each line." msgstr "" msgid "" @@ -901,7 +960,9 @@ msgid "" "reflect the current cursor position of the window." msgstr "" -msgid "Delete any character at ``(y, x)``." +msgid "" +"Delete the character under the cursor, or at ``(y, x)`` if specified. All " +"characters to the right on the same line are shifted one position left." msgstr "" msgid "" @@ -917,8 +978,8 @@ msgid "" msgstr "" msgid "" -"Add character *ch* with attribute *attr*, and immediately call :meth:" -"`refresh` on the window." +"Add character *ch* with attribute *attr*, and immediately " +"call :meth:`refresh` on the window." msgstr "" msgid "" @@ -932,10 +993,11 @@ msgid "Previously it returned ``1`` or ``0`` instead of ``True`` or ``False``." msgstr "" msgid "" -"Encoding used to encode method arguments (Unicode strings and characters). " -"The encoding attribute is inherited from the parent window when a subwindow " -"is created, for example with :meth:`window.subwin`. By default, current " -"locale encoding is used (see :func:`locale.getencoding`)." +"Encoding used to encode the string arguments of the methods and to decode " +"their results on a build without wide-character support. The encoding " +"attribute is inherited from the parent window when a subwindow is created, " +"for example with :meth:`window.subwin`. By default, current locale encoding " +"is used (see :func:`locale.getencoding`)." msgstr "" msgid "Clear the window." @@ -944,27 +1006,60 @@ msgstr "" msgid "Return a tuple ``(y, x)`` of coordinates of upper-left corner." msgstr "" -msgid "Return the given window's current background character/attribute pair." +msgid "" +"Return the given window's current background character/attribute pair. Its " +"components can be extracted like those of :meth:`inch`." +msgstr "" + +msgid "" +"Read a key press, after moving the cursor to *y*, *x* if specified, and " +"return it as an integer. The window is refreshed first if it is not a pad " +"and was modified since the last refresh. Wait until a key is pressed, or " +"return ``-1`` if the read is non-blocking or times out (see :meth:`nodelay` " +"and :meth:`timeout`)." +msgstr "" + +msgid "" +"An ordinary key is returned as the code of a single byte of its encoding in " +"the current locale, so a character encoded with several bytes takes several " +"calls. For example, in a UTF-8 locale ``'é'`` is read as ``195``, then " +"``169``. Use :meth:`get_wch` to read it as a single character." +msgstr "" + +msgid "" +"In keypad mode (see :meth:`keypad`) function keys and other special keys are " +"returned as one of the :ref:`KEY_* constants `, which " +"cannot be mistaken for an ordinary key. Otherwise, or if their escape " +"sequence does not arrive in time (see :meth:`notimeout` " +"and :func:`set_escdelay`), their bytes are returned one at a time." +msgstr "" + +msgid "" +"In echo mode (see :func:`echo`) the key is added to the window as " +"by :meth:`addch`; special keys are not echoed." msgstr "" msgid "" -"Get a character. Note that the integer returned does *not* have to be in " -"ASCII range: function keys, keypad keys and so on are represented by numbers " -"higher than 255. In no-delay mode, return ``-1`` if there is no input, " -"otherwise wait until a key is pressed." +"Read a key press, after moving the cursor to *y*, *x* if specified, and " +"return it as a one-character :class:`str`. The window is refreshed first if " +"it is not a pad and was modified since the last refresh. Wait until a key is " +"pressed, or raise :exc:`error` if the read is non-blocking or times out " +"(see :meth:`nodelay` and :meth:`timeout`)." msgstr "" msgid "" -"Get a wide character. Return a character for most keys, or an integer for " -"function keys, keypad keys, and other special keys. In no-delay mode, raise " -"an exception if there is no input." +"In keypad mode (see :meth:`keypad`) function keys and other special keys are " +"returned as one of the :ref:`KEY_* constants `, an " +"integer. Otherwise, or if their escape sequence does not arrive in time " +"(see :meth:`notimeout` and :func:`set_escdelay`), their characters are " +"returned one at a time." msgstr "" msgid "" -"Get a character, returning a string instead of an integer, as :meth:`getch` " -"does. Function keys, keypad keys and other special keys return a multibyte " -"string containing the key name. In no-delay mode, raise an exception if " -"there is no input." +"Read a key press as :meth:`getch` does, but return it as a :class:`str`: an " +"ordinary key as a one-character string, the byte decoded as Latin-1, and a " +"special key as its name, such as ``'KEY_UP'`` (see :func:`keyname`). " +"Raise :exc:`error` instead of returning ``-1`` if there is no input." msgstr "" msgid "Return a tuple ``(y, x)`` of the height and width of the window." @@ -977,8 +1072,10 @@ msgid "" msgstr "" msgid "" -"Read a bytes object from the user, with primitive line editing capacity. The " -"maximum value for *n* is 2047." +"Read a line of input from the user, with primitive line editing capacity, " +"after moving the cursor to *y*, *x* if specified. Return it as a bytes " +"object, in the encoding of the current locale and without the terminating " +"newline. At most *n* bytes are read; *n* defaults to and cannot exceed 2047." msgstr "" msgid "The maximum value for *n* was increased from 1023 to 2047." @@ -991,7 +1088,8 @@ msgstr "" msgid "" "Display a horizontal line starting at ``(y, x)`` with length *n* consisting " -"of the character *ch*." +"of the character *ch* with attributes *attr*. The line stops at the right " +"edge of the window if fewer than *n* cells are available." msgstr "" msgid "" @@ -1002,8 +1100,8 @@ msgid "" msgstr "" msgid "" -"If *flag* is ``True``, :mod:`!curses` will try and use hardware line editing " -"facilities. Otherwise, line insertion/deletion are disabled." +"If *flag* is ``True``, :mod:`!curses` will try to use hardware line editing " +"facilities. Otherwise, curses will not use them." msgstr "" msgid "" @@ -1015,12 +1113,21 @@ msgstr "" msgid "" "Return the character at the given position in the window. The bottom 8 bits " -"are the character proper, and upper bits are the attributes." +"are the character proper and the upper bits are the attributes; extract them " +"with the :data:`A_CHARTEXT` and :data:`A_ATTRIBUTES` bit-masks, and the " +"color pair with :func:`pair_number`. The character byte is the locale-" +"encoded byte of the cell's character, consistent with :meth:`instr`. On a " +"wide-character build, a character that does not fit in a single byte in the " +"current locale has a character byte of ``0``; use :meth:`instr` to read such " +"characters." msgstr "" msgid "" -"Paint character *ch* at ``(y, x)`` with attributes *attr*, moving the line " -"from position *x* right by one character." +"Insert character *ch* with attributes *attr* before the character under the " +"cursor, or at ``(y, x)`` if specified. All characters to the right of the " +"cursor are shifted one position right, with the rightmost character on the " +"line being lost. The cursor position does not change (after moving to *y*, " +"*x*, if specified)." msgstr "" msgid "" @@ -1039,10 +1146,10 @@ msgstr "" msgid "" "Insert a character string (as many characters as will fit on the line) " "before the character under the cursor, up to *n* characters. If *n* is " -"zero or negative, the entire string is inserted. All characters to the right " -"of the cursor are shifted right, with the rightmost characters on the line " -"being lost. The cursor position does not change (after moving to *y*, *x*, " -"if specified)." +"negative, the entire string is inserted. All characters to the right of the " +"cursor are shifted right, with the rightmost characters on the line being " +"lost. The cursor position does not change (after moving to *y*, *x*, if " +"specified)." msgstr "" msgid "" @@ -1054,34 +1161,34 @@ msgid "" msgstr "" msgid "" -"Return a bytes object of characters, extracted from the window starting at " -"the current cursor position, or at *y*, *x* if specified. Attributes are " -"stripped from the characters. If *n* is specified, :meth:`instr` returns a " -"string at most *n* characters long (exclusive of the trailing NUL). The " -"maximum value for *n* is 2047." +"Read the text of the window from the current cursor position, or from *y*, " +"*x* if specified, to the end of the line, and return it as a bytes object, " +"in the encoding of the current locale. Attributes and color pairs are " +"stripped. At most *n* bytes are read; *n* defaults to and cannot exceed 2047." msgstr "" msgid "" -"Return ``True`` if the specified line was modified since the last call to :" -"meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` " +"Return ``True`` if the specified line was modified since the last call " +"to :meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` " "exception if *line* is not valid for the given window." msgstr "" msgid "" -"Return ``True`` if the specified window was modified since the last call to :" -"meth:`refresh`; otherwise return ``False``." +"Return ``True`` if the specified window was modified since the last call " +"to :meth:`refresh`; otherwise return ``False``." msgstr "" msgid "" "If *flag* is ``True``, escape sequences generated by some keys (keypad, " "function keys) will be interpreted by :mod:`!curses`. If *flag* is " -"``False``, escape sequences will be left as is in the input stream." +"``False``, escape sequences will be left as is in the input stream. Keypad " +"mode is disabled by default, but :func:`wrapper` enables it for the main " +"window." msgstr "" msgid "" "If *flag* is ``True``, cursor is left where it is on update, instead of " -"being at \"cursor position.\" This reduces cursor movement where possible. " -"If possible the cursor will be made invisible." +"being at \"cursor position.\" This reduces cursor movement where possible." msgstr "" msgid "" @@ -1101,6 +1208,11 @@ msgstr "" msgid "Move the window so its upper-left corner is at ``(new_y, new_x)``." msgstr "" +msgid "" +"Moving the window so that any part of it would be off the screen is an " +"error: the window is not moved and :exc:`curses.error` is raised." +msgstr "" + msgid "If *flag* is ``True``, :meth:`getch` will be non-blocking." msgstr "" @@ -1118,6 +1230,12 @@ msgid "" "of the physical screen. To accomplish that, call :func:`doupdate`." msgstr "" +msgid "" +"The 6 arguments can only be specified, and are then required, when the " +"window is a pad created with :func:`newpad`; they have the same meaning as " +"for :meth:`refresh`." +msgstr "" + msgid "" "Overlay the window on top of *destwin*. The windows need not be the same " "size, only the overlapping region is copied. This copy is non-destructive, " @@ -1126,8 +1244,8 @@ msgid "" msgstr "" msgid "" -"To get fine-grained control over the copied region, the second form of :meth:" -"`overlay` can be used. *sminrow* and *smincol* are the upper-left " +"To get fine-grained control over the copied region, the second form " +"of :meth:`overlay` can be used. *sminrow* and *smincol* are the upper-left " "coordinates of the source window, and the other variables mark a rectangle " "in the destination window." msgstr "" @@ -1140,8 +1258,8 @@ msgid "" msgstr "" msgid "" -"To get fine-grained control over the copied region, the second form of :meth:" -"`overwrite` can be used. *sminrow* and *smincol* are the upper-left " +"To get fine-grained control over the copied region, the second form " +"of :meth:`overwrite` can be used. *sminrow* and *smincol* are the upper-left " "coordinates of the source window, the other variables mark a rectangle in " "the destination window." msgstr "" @@ -1157,8 +1275,8 @@ msgid "" msgstr "" msgid "" -"Touch the entire window, causing it to be completely redrawn on the next :" -"meth:`refresh` call." +"Touch the entire window, causing it to be completely redrawn on the " +"next :meth:`refresh` call." msgstr "" msgid "" @@ -1167,17 +1285,17 @@ msgid "" msgstr "" msgid "" -"The 6 optional arguments can only be specified when the window is a pad " -"created with :func:`newpad`. The additional parameters are needed to " -"indicate what part of the pad and screen are involved. *pminrow* and " -"*pmincol* specify the upper left-hand corner of the rectangle to be " -"displayed in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* " -"specify the edges of the rectangle to be displayed on the screen. The lower " -"right-hand corner of the rectangle to be displayed in the pad is calculated " -"from the screen coordinates, since the rectangles must be the same size. " -"Both rectangles must be entirely contained within their respective " -"structures. Negative values of *pminrow*, *pmincol*, *sminrow*, or " -"*smincol* are treated as if they were zero." +"The 6 arguments can only be specified, and are then required, when the " +"window is a pad created with :func:`newpad`. The additional parameters are " +"needed to indicate what part of the pad and screen are involved. *pminrow* " +"and *pmincol* specify the upper-left corner of the rectangle to be displayed " +"in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* specify the " +"edges of the rectangle to be displayed on the screen. The lower-right " +"corner of the rectangle to be displayed in the pad is calculated from the " +"screen coordinates, since the rectangles must be the same size. Both " +"rectangles must be entirely contained within their respective structures. " +"Negative values of *pminrow*, *pmincol*, *sminrow*, or *smincol* are treated " +"as if they were zero." msgstr "" msgid "" @@ -1187,7 +1305,11 @@ msgid "" "rendition (as set by :meth:`bkgdset`) merged into them." msgstr "" -msgid "Scroll the screen or scrolling region upward by *lines* lines." +msgid "" +"Scroll the screen or scrolling region. Scroll upward by *lines* lines if " +"*lines* is positive, or downward if it is negative. " +"Raise :exc:`curses.error` unless scrolling has been enabled for the window " +"with :meth:`scrollok`." msgstr "" msgid "" @@ -1213,8 +1335,16 @@ msgid "Turn on attribute *A_STANDOUT*." msgstr "" msgid "" -"Return a sub-window, whose upper-left corner is at ``(begin_y, begin_x)``, " -"and whose width/height is *ncols*/*nlines*." +"Return a sub-pad, whose upper-left corner is at ``(begin_y, begin_x)``, and " +"whose width/height is *ncols*/*nlines*. The coordinates are relative to the " +"parent pad (unlike :meth:`subwin`, which uses screen coordinates). This " +"method is only available for pads created with :func:`newpad`." +msgstr "" + +msgid "" +"Return a sub-window, whose upper-left corner is at the screen-relative " +"coordinates ``(begin_y, begin_x)``, and whose width/height is *ncols*/" +"*nlines*." msgstr "" msgid "" @@ -1242,9 +1372,9 @@ msgid "" "Set blocking or non-blocking read behavior for the window. If *delay* is " "negative, blocking read is used (which will wait indefinitely for input). " "If *delay* is zero, then non-blocking read is used, and :meth:`getch` will " -"return ``-1`` if no input is waiting. If *delay* is positive, then :meth:" -"`getch` will block for *delay* milliseconds, and return ``-1`` if there is " -"still no input at the end of that time." +"return ``-1`` if no input is waiting. If *delay* is positive, " +"then :meth:`getch` will block for *delay* milliseconds, and return ``-1`` if " +"there is still no input at the end of that time." msgstr "" msgid "" @@ -1260,8 +1390,8 @@ msgid "" msgstr "" msgid "" -"Mark all lines in the window as unchanged since the last call to :meth:" -"`refresh`." +"Mark all lines in the window as unchanged since the last call " +"to :meth:`refresh`." msgstr "" msgid "" @@ -1276,8 +1406,8 @@ msgid "The :mod:`!curses` module defines the following data members:" msgstr "" msgid "" -"Some curses routines that return an integer, such as :meth:`~window." -"getch`, return :const:`ERR` upon failure." +"Some curses routines that return an integer, such " +"as :meth:`~window.getch`, return :const:`ERR` upon failure." msgstr "" msgid "" @@ -1309,15 +1439,15 @@ msgid "" msgstr "" msgid "" -"The width of the screen, i.e., the number of columns. It is defined only " -"after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :" -"func:`resizeterm` and :func:`resize_term`." +"The width of the screen, that is, the number of columns. It is defined only " +"after the call to :func:`initscr`. Updated " +"by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." msgstr "" msgid "" -"The height of the screen, i.e., the number of lines. It is defined only " -"after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :" -"func:`resizeterm` and :func:`resize_term`." +"The height of the screen, that is, the number of lines. It is defined only " +"after the call to :func:`initscr`. Updated " +"by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." msgstr "" msgid "" @@ -1534,7 +1664,7 @@ msgid "Cmd (command)" msgstr "" msgid "Copy" -msgstr "" +msgstr "Kopiuj" msgid "Create" msgstr "" @@ -1697,13 +1827,14 @@ msgstr "" msgid "" "On VT100s and their software emulations, such as X terminal emulators, there " -"are normally at least four function keys (:const:`KEY_F1 `, :const:" -"`KEY_F2 `, :const:`KEY_F3 `, :const:`KEY_F4 `) " -"available, and the arrow keys mapped to :const:`KEY_UP`, :const:`KEY_DOWN`, :" -"const:`KEY_LEFT` and :const:`KEY_RIGHT` in the obvious way. If your machine " -"has a PC keyboard, it is safe to expect arrow keys and twelve function keys " -"(older PC keyboards may have only ten function keys); also, the following " -"keypad mappings are standard:" +"are normally at least four function keys (:const:`KEY_F1 " +"`, :const:`KEY_F2 `, :const:`KEY_F3 " +"`, :const:`KEY_F4 `) available, and the arrow keys mapped " +"to :const:`KEY_UP`, :const:`KEY_DOWN`, :const:`KEY_LEFT` " +"and :const:`KEY_RIGHT` in the obvious way. If your machine has a PC " +"keyboard, it is safe to expect arrow keys and twelve function keys (older PC " +"keyboards may have only ten function keys); also, the following keypad " +"mappings are standard:" msgstr "" msgid "Keycap" @@ -1761,7 +1892,7 @@ msgstr "" msgid "ACS code" msgstr "" -msgid "alternate name for upper right corner" +msgid "alternate name for upper-right corner" msgstr "" msgid "solid square block" @@ -1773,7 +1904,7 @@ msgstr "" msgid "alternate name for horizontal line" msgstr "" -msgid "alternate name for upper left corner" +msgid "alternate name for upper-left corner" msgstr "" msgid "alternate name for top tee" @@ -1812,10 +1943,10 @@ msgstr "" msgid "less-than-or-equal-to" msgstr "" -msgid "lower left-hand corner" +msgid "lower-left corner" msgstr "" -msgid "lower right-hand corner" +msgid "lower-right corner" msgstr "" msgid "left tee" @@ -1851,7 +1982,7 @@ msgstr "" msgid "scan line 9" msgstr "" -msgid "alternate name for lower right corner" +msgid "alternate name for lower-right corner" msgstr "" msgid "alternate name for vertical line" @@ -1860,7 +1991,7 @@ msgstr "" msgid "alternate name for right tee" msgstr "" -msgid "alternate name for lower left corner" +msgid "alternate name for lower-left corner" msgstr "" msgid "alternate name for bottom tee" @@ -1881,10 +2012,10 @@ msgstr "" msgid "up arrow" msgstr "" -msgid "upper left corner" +msgid "upper-left corner" msgstr "" -msgid "upper right corner" +msgid "upper-right corner" msgstr "" msgid "vertical line" @@ -1918,6 +2049,9 @@ msgstr "" msgid "Control was down during button state change" msgstr "" +msgid "Alt was down during button state change" +msgstr "" + msgid "The following table lists the predefined colors:" msgstr "" @@ -1966,10 +2100,10 @@ msgstr "" msgid "" "Draw a rectangle. The first argument must be a window object; the remaining " "arguments are coordinates relative to that window. The second and third " -"arguments are the y and x coordinates of the upper left hand corner of the " +"arguments are the y and x coordinates of the upper-left corner of the " "rectangle to be drawn; the fourth and fifth arguments are the y and x " -"coordinates of the lower right hand corner. The rectangle will be drawn " -"using VT100/IBM PC forms characters on terminals that make this possible " +"coordinates of the lower-right corner. The rectangle will be drawn using " +"VT100/IBM PC forms characters on terminals that make this possible " "(including xterm and most other software terminal emulators). Otherwise it " "will be drawn with ASCII dashes, vertical bars, and plus signs." msgstr "" @@ -1981,10 +2115,12 @@ msgid "You can instantiate a :class:`Textbox` object as follows:" msgstr "" msgid "" -"Return a textbox widget object. The *win* argument should be a curses :ref:" -"`window ` object in which the textbox is to be " -"contained. The edit cursor of the textbox is initially located at the upper " -"left hand corner of the containing window, with coordinates ``(0, 0)``. The " +"Return a textbox widget object. The *win* argument should be a " +"curses :ref:`window ` object in which the textbox is " +"to be contained. If *insert_mode* is true, the textbox inserts typed " +"characters, shifting existing text to the right, rather than overwriting it. " +"The edit cursor of the textbox is initially located at the upper-left corner " +"of the containing window, with coordinates ``(0, 0)``. The " "instance's :attr:`stripspaces` flag is initially on." msgstr "" @@ -1994,16 +2130,17 @@ msgstr "" msgid "" "This is the entry point you will normally use. It accepts editing " "keystrokes until one of the termination keystrokes is entered. If " -"*validator* is supplied, it must be a function. It will be called for each " +"*validate* is supplied, it must be a function. It will be called for each " "keystroke entered with the keystroke as a parameter; command dispatch is " -"done on the result. This method returns the window contents as a string; " -"whether blanks in the window are included is affected by the :attr:" -"`stripspaces` attribute." +"done on the result. If it returns a false value, the keystroke is ignored. " +"This method returns the window contents as a string; whether blanks in the " +"window are included is affected by the :attr:`stripspaces` attribute." msgstr "" msgid "" -"Process a single command keystroke. Here are the supported special " -"keystrokes:" +"Process a single command keystroke. Returns ``1`` to continue editing, or " +"``0`` if a termination keystroke was processed. Here are the supported " +"special keystrokes:" msgstr "" msgid "Keystroke" @@ -2057,7 +2194,9 @@ msgstr "" msgid ":kbd:`Control-J`" msgstr ":kbd:`Control-J`" -msgid "Terminate if the window is 1 line, otherwise insert newline." +msgid "" +"Terminate if the window is 1 line, otherwise move to the start of the next " +"line." msgstr "" msgid ":kbd:`Control-K`" diff --git a/library/dataclasses.po b/library/dataclasses.po index 34c6a80b73..248251b7fa 100644 --- a/library/dataclasses.po +++ b/library/dataclasses.po @@ -31,14 +31,14 @@ msgstr "**Вихідний код:** :source:`Lib/dataclasses.py`" msgid "" "This module provides a decorator and functions for automatically adding " -"generated :term:`special methods ` such as :meth:`~object." -"__init__` and :meth:`~object.__repr__` to user-defined classes. It was " -"originally described in :pep:`557`." +"generated :term:`special methods ` such " +"as :meth:`~object.__init__` and :meth:`~object.__repr__` to user-defined " +"classes. It was originally described in :pep:`557`." msgstr "" msgid "" -"The member variables to use in these generated methods are defined using :" -"pep:`526` type annotations. For example, this code::" +"The member variables to use in these generated methods are defined " +"using :pep:`526` type annotations. For example, this code::" msgstr "" "Змінні-члени для використання в цих згенерованих методах визначаються за " "допомогою анотацій типу :pep:`526`. Наприклад, цей код::" @@ -77,8 +77,9 @@ msgid "Module contents" msgstr "Зміст модуля" msgid "" -"This function is a :term:`decorator` that is used to add generated :term:" -"`special methods ` to classes, as described below." +"This function is a :term:`decorator` that is used to add " +"generated :term:`special methods ` to classes, as described " +"below." msgstr "" msgid "" @@ -162,23 +163,25 @@ msgid "" msgstr "" msgid "" -"*order*: If true (the default is ``False``), :meth:`~object.__lt__`, :meth:" -"`~object.__le__`, :meth:`~object.__gt__`, and :meth:`~object.__ge__` methods " -"will be generated. These compare the class as if it were a tuple of its " -"fields, in order. Both instances in the comparison must be of the identical " -"type. If *order* is true and *eq* is false, a :exc:`ValueError` is raised." +"*order*: If true (the default is " +"``False``), :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"and :meth:`~object.__ge__` methods will be generated. These compare the " +"class as if it were a tuple of its fields, in order. Both instances in the " +"comparison must be of the identical type. If *order* is true and *eq* is " +"false, a :exc:`ValueError` is raised." msgstr "" msgid "" -"If the class already defines any of :meth:`!__lt__`, :meth:`!__le__`, :meth:" -"`!__gt__`, or :meth:`!__ge__`, then :exc:`TypeError` is raised." +"If the class already defines any of :meth:`!__lt__`, :meth:`!" +"__le__`, :meth:`!__gt__`, or :meth:`!__ge__`, then :exc:`TypeError` is " +"raised." msgstr "" msgid "" -"*unsafe_hash*: If true, force ``dataclasses`` to create a :meth:`~object." -"__hash__` method, even though it may not be safe to do so. Otherwise, " -"generate a :meth:`~object.__hash__` method according to how *eq* and " -"*frozen* are set. The default value is ``False``." +"*unsafe_hash*: If true, force ``dataclasses`` to create " +"a :meth:`~object.__hash__` method, even though it may not be safe to do so. " +"Otherwise, generate a :meth:`~object.__hash__` method according to how *eq* " +"and *frozen* are set. The default value is ``False``." msgstr "" msgid "" @@ -191,11 +194,11 @@ msgid "" msgstr "" msgid "" -"By default, ``@dataclass`` will not implicitly add a :meth:`~object." -"__hash__` method unless it is safe to do so. Neither will it add or change " -"an existing explicitly defined :meth:`!__hash__` method. Setting the class " -"attribute ``__hash__ = None`` has a specific meaning to Python, as described " -"in the :meth:`!__hash__` documentation." +"By default, ``@dataclass`` will not implicitly add " +"a :meth:`~object.__hash__` method unless it is safe to do so. Neither will " +"it add or change an existing explicitly defined :meth:`!__hash__` method. " +"Setting the class attribute ``__hash__ = None`` has a specific meaning to " +"Python, as described in the :meth:`!__hash__` documentation." msgstr "" msgid "" @@ -210,33 +213,33 @@ msgstr "" msgid "" "Here are the rules governing implicit creation of a :meth:`!__hash__` " "method. Note that you cannot both have an explicit :meth:`!__hash__` method " -"in your dataclass and set ``unsafe_hash=True``; this will result in a :exc:" -"`TypeError`." +"in your dataclass and set ``unsafe_hash=True``; this will result in " +"a :exc:`TypeError`." msgstr "" msgid "" "If *eq* and *frozen* are both true, by default ``@dataclass`` will generate " -"a :meth:`!__hash__` method for you. If *eq* is true and *frozen* is false, :" -"meth:`!__hash__` will be set to ``None``, marking it unhashable (which it " -"is, since it is mutable). If *eq* is false, :meth:`!__hash__` will be left " -"untouched meaning the :meth:`!__hash__` method of the superclass will be " -"used (if the superclass is :class:`object`, this means it will fall back to " -"id-based hashing)." +"a :meth:`!__hash__` method for you. If *eq* is true and *frozen* is " +"false, :meth:`!__hash__` will be set to ``None``, marking it unhashable " +"(which it is, since it is mutable). If *eq* is false, :meth:`!__hash__` " +"will be left untouched meaning the :meth:`!__hash__` method of the " +"superclass will be used (if the superclass is :class:`object`, this means it " +"will fall back to id-based hashing)." msgstr "" msgid "" "*frozen*: If true (the default is ``False``), assigning to fields will " -"generate an exception. This emulates read-only frozen instances. If :meth:" -"`~object.__setattr__` or :meth:`~object.__delattr__` is defined in the " -"class, then :exc:`TypeError` is raised. See the discussion below." +"generate an exception. This emulates read-only frozen instances. " +"If :meth:`~object.__setattr__` or :meth:`~object.__delattr__` is defined in " +"the class, then :exc:`TypeError` is raised. See the discussion below." msgstr "" msgid "" -"*match_args*: If true (the default is ``True``), the :attr:`~object." -"__match_args__` tuple will be created from the list of non keyword-only " -"parameters to the generated :meth:`~object.__init__` method (even if :meth:`!" -"__init__` is not generated, see above). If false, or if :attr:`!" -"__match_args__` is already defined in the class, then :attr:`!" +"*match_args*: If true (the default is ``True``), " +"the :attr:`~object.__match_args__` tuple will be created from the list of " +"non keyword-only parameters to the generated :meth:`~object.__init__` method " +"(even if :meth:`!__init__` is not generated, see above). If false, or " +"if :attr:`!__match_args__` is already defined in the class, then :attr:`!" "__match_args__` will not be generated." msgstr "" @@ -255,8 +258,8 @@ msgstr "" msgid "" "*slots*: If true (the default is ``False``), :attr:`~object.__slots__` " "attribute will be generated and new class will be returned instead of the " -"original one. If :attr:`!__slots__` is already defined in the class, then :" -"exc:`TypeError` is raised." +"original one. If :attr:`!__slots__` is already defined in the class, " +"then :exc:`TypeError` is raised." msgstr "" msgid "" @@ -270,9 +273,9 @@ msgid "" "If a field name is already included in the :attr:`!__slots__` of a base " "class, it will not be included in the generated :attr:`!__slots__` to " "prevent :ref:`overriding them `. Therefore, do not " -"use :attr:`!__slots__` to retrieve the field names of a dataclass. Use :func:" -"`fields` instead. To be able to determine inherited slots, base class :attr:" -"`!__slots__` may be any iterable, but *not* an iterator." +"use :attr:`!__slots__` to retrieve the field names of a dataclass. " +"Use :func:`fields` instead. To be able to determine inherited slots, base " +"class :attr:`!__slots__` may be any iterable, but *not* an iterator." msgstr "" msgid "" @@ -389,8 +392,8 @@ msgstr "" msgid "" "*compare*: If true (the default), this field is included in the generated " -"equality and comparison methods (:meth:`~object.__eq__`, :meth:`~object." -"__gt__`, et al.)." +"equality and comparison methods " +"(:meth:`~object.__eq__`, :meth:`~object.__gt__`, et al.)." msgstr "" msgid "" @@ -452,9 +455,10 @@ msgid ":attr:`!type`: The type of the field." msgstr "" msgid "" -":attr:`!default`, :attr:`!default_factory`, :attr:`!init`, :attr:`!repr`, :" -"attr:`!hash`, :attr:`!compare`, :attr:`!metadata`, and :attr:`!kw_only` have " -"the identical meaning and values as they do in the :func:`field` function." +":attr:`!default`, :attr:`!default_factory`, :attr:`!init`, :attr:`!" +"repr`, :attr:`!hash`, :attr:`!compare`, :attr:`!metadata`, and :attr:`!" +"kw_only` have the identical meaning and values as they do in " +"the :func:`field` function." msgstr "" msgid "" @@ -467,9 +471,9 @@ msgstr "" msgid "" "``InitVar[T]`` type annotations describe variables that are :ref:`init-only " "`. Fields annotated with :class:`!InitVar` " -"are considered pseudo-fields, and thus are neither returned by the :func:" -"`fields` function nor used in any way except adding them as parameters to :" -"meth:`~object.__init__` and an optional :meth:`__post_init__`." +"are considered pseudo-fields, and thus are neither returned by " +"the :func:`fields` function nor used in any way except adding them as " +"parameters to :meth:`~object.__init__` and an optional :meth:`__post_init__`." msgstr "" msgid "" @@ -479,9 +483,9 @@ msgid "" "not return pseudo-fields which are ``ClassVar`` or ``InitVar``." msgstr "" "Повертає кортеж об’єктів :class:`Field`, які визначають поля для цього класу " -"даних. Приймає або клас даних, або екземпляр класу даних. Викликає :exc:" -"`TypeError`, якщо не передано клас даних або його екземпляр. Не повертає " -"псевдополя, які є ``ClassVar`` або ``InitVar``." +"даних. Приймає або клас даних, або екземпляр класу даних. " +"Викликає :exc:`TypeError`, якщо не передано клас даних або його екземпляр. " +"Не повертає псевдополя, які є ``ClassVar`` або ``InitVar``." msgid "" "Converts the dataclass *obj* to a dict (by using the factory function " @@ -550,8 +554,8 @@ msgid "" "``name``, ``(name, type)``, or ``(name, type, Field)``. If just ``name`` is " "supplied, :data:`typing.Any` is used for ``type``. The values of *init*, " "*repr*, *eq*, *order*, *unsafe_hash*, *frozen*, *match_args*, *kw_only*, " -"*slots*, and *weakref_slot* have the same meaning as they do in :func:" -"`@dataclass `." +"*slots*, and *weakref_slot* have the same meaning as they do " +"in :func:`@dataclass `." msgstr "" msgid "" @@ -562,15 +566,15 @@ msgstr "" msgid "" "The *decorator* parameter is a callable that will be used to create the " "dataclass. It should take the class object as a first argument and the same " -"keyword arguments as :func:`@dataclass `. By default, the :func:" -"`@dataclass ` function is used." +"keyword arguments as :func:`@dataclass `. By default, " +"the :func:`@dataclass ` function is used." msgstr "" msgid "" "This function is not strictly required, because any Python mechanism for " -"creating a new class with :attr:`!__annotations__` can then apply the :func:" -"`@dataclass ` function to convert that class to a dataclass. " -"This function is provided as a convenience. For example::" +"creating a new class with :attr:`!__annotations__` can then apply " +"the :func:`@dataclass ` function to convert that class to a " +"dataclass. This function is provided as a convenience. For example::" msgstr "" msgid "" @@ -601,8 +605,8 @@ msgstr "" msgid "" "Creates a new object of the same type as *obj*, replacing fields with values " "from *changes*. If *obj* is not a Data Class, raises :exc:`TypeError`. If " -"keys in *changes* are not field names of the given dataclass, raises :exc:" -"`TypeError`." +"keys in *changes* are not field names of the given dataclass, " +"raises :exc:`TypeError`." msgstr "" msgid "" @@ -633,8 +637,8 @@ msgid "" msgstr "" msgid "" -"Dataclass instances are also supported by generic function :func:`copy." -"replace`." +"Dataclass instances are also supported by generic " +"function :func:`copy.replace`." msgstr "" msgid "" @@ -664,9 +668,9 @@ msgid "" "with the type of :const:`!KW_ONLY` are marked as keyword-only fields. Note " "that a pseudo-field of type :const:`!KW_ONLY` is otherwise completely " "ignored. This includes the name of such a field. By convention, a name of " -"``_`` is used for a :const:`!KW_ONLY` field. Keyword-only fields signify :" -"meth:`~object.__init__` parameters that must be specified as keywords when " -"the class is instantiated." +"``_`` is used for a :const:`!KW_ONLY` field. Keyword-only fields " +"signify :meth:`~object.__init__` parameters that must be specified as " +"keywords when the class is instantiated." msgstr "" msgid "" @@ -691,21 +695,21 @@ msgid "" msgstr "" msgid "" -"Raised when an implicitly defined :meth:`~object.__setattr__` or :meth:" -"`~object.__delattr__` is called on a dataclass which was defined with " -"``frozen=True``. It is a subclass of :exc:`AttributeError`." +"Raised when an implicitly defined :meth:`~object.__setattr__` " +"or :meth:`~object.__delattr__` is called on a dataclass which was defined " +"with ``frozen=True``. It is a subclass of :exc:`AttributeError`." msgstr "" msgid "Post-init processing" msgstr "Обробка після ініціалізації" msgid "" -"When defined on the class, it will be called by the generated :meth:`~object." -"__init__`, normally as :meth:`!self.__post_init__`. However, if any " -"``InitVar`` fields are defined, they will also be passed to :meth:`!" -"__post_init__` in the order they were defined in the class. If no :meth:`!" -"__init__` method is generated, then :meth:`!__post_init__` will not " -"automatically be called." +"When defined on the class, it will be called by the " +"generated :meth:`~object.__init__`, normally as :meth:`!self.__post_init__`. " +"However, if any ``InitVar`` fields are defined, they will also be passed " +"to :meth:`!__post_init__` in the order they were defined in the class. If " +"no :meth:`!__init__` method is generated, then :meth:`!__post_init__` will " +"not automatically be called." msgstr "" msgid "" @@ -754,8 +758,8 @@ msgid "" msgstr "" msgid "" -"See the section below on init-only variables for ways to pass parameters to :" -"meth:`!__post_init__`. Also see the warning about how :func:`replace` " +"See the section below on init-only variables for ways to pass parameters " +"to :meth:`!__post_init__`. Also see the warning about how :func:`replace` " "handles ``init=False`` fields." msgstr "" @@ -768,8 +772,8 @@ msgid "" "defined in :pep:`526`. It does this by checking if the type of the field " "is :data:`typing.ClassVar`. If a field is a ``ClassVar``, it is excluded " "from consideration as a field and is ignored by the dataclass mechanisms. " -"Such ``ClassVar`` pseudo-fields are not returned by the module-level :func:" -"`fields` function." +"Such ``ClassVar`` pseudo-fields are not returned by the module-" +"level :func:`fields` function." msgstr "" msgid "Init-only variables" @@ -819,15 +823,16 @@ msgstr "Заморожені екземпляри" msgid "" "It is not possible to create truly immutable Python objects. However, by " "passing ``frozen=True`` to the :func:`@dataclass ` decorator you " -"can emulate immutability. In that case, dataclasses will add :meth:`~object." -"__setattr__` and :meth:`~object.__delattr__` methods to the class. These " -"methods will raise a :exc:`FrozenInstanceError` when invoked." +"can emulate immutability. In that case, dataclasses will " +"add :meth:`~object.__setattr__` and :meth:`~object.__delattr__` methods to " +"the class. These methods will raise a :exc:`FrozenInstanceError` when " +"invoked." msgstr "" msgid "" -"There is a tiny performance penalty when using ``frozen=True``: :meth:" -"`~object.__init__` cannot use simple assignment to initialize fields, and " -"must use :meth:`!object.__setattr__`." +"There is a tiny performance penalty when using " +"``frozen=True``: :meth:`~object.__init__` cannot use simple assignment to " +"initialize fields, and must use :meth:`!object.__setattr__`." msgstr "" msgid "Inheritance" @@ -995,14 +1000,14 @@ msgstr "" msgid "" "This has the same issue as the original example using class :class:`!C`. " -"That is, two instances of class :class:`!D` that do not specify a value for :" -"attr:`!x` when creating a class instance will share the same copy of :attr:`!" -"x`. Because dataclasses just use normal Python class creation they also " -"share this behavior. There is no general way for Data Classes to detect " -"this condition. Instead, the :func:`@dataclass ` decorator will " -"raise a :exc:`ValueError` if it detects an unhashable default parameter. " -"The assumption is that if a value is unhashable, it is mutable. This is a " -"partial solution, but it does protect against many common errors." +"That is, two instances of class :class:`!D` that do not specify a value " +"for :attr:`!x` when creating a class instance will share the same copy " +"of :attr:`!x`. Because dataclasses just use normal Python class creation " +"they also share this behavior. There is no general way for Data Classes to " +"detect this condition. Instead, the :func:`@dataclass ` " +"decorator will raise a :exc:`ValueError` if it detects an unhashable default " +"parameter. The assumption is that if a value is unhashable, it is mutable. " +"This is a partial solution, but it does protect against many common errors." msgstr "" msgid "" @@ -1021,9 +1026,10 @@ msgid "" msgstr "" msgid "" -"Instead of looking for and disallowing objects of type :class:`list`, :class:" -"`dict`, or :class:`set`, unhashable objects are now not allowed as default " -"values. Unhashability is used to approximate mutability." +"Instead of looking for and disallowing objects of " +"type :class:`list`, :class:`dict`, or :class:`set`, unhashable objects are " +"now not allowed as default values. Unhashability is used to approximate " +"mutability." msgstr "" msgid "Descriptor-typed fields" @@ -1041,9 +1047,9 @@ msgid "" msgstr "" msgid "" -"Similarly, when getting or setting the field, the descriptor's :meth:" -"`~object.__get__` or :meth:`!__set__` method is called rather than returning " -"or overwriting the descriptor object." +"Similarly, when getting or setting the field, the " +"descriptor's :meth:`~object.__get__` or :meth:`!__set__` method is called " +"rather than returning or overwriting the descriptor object." msgstr "" msgid "" diff --git a/library/datatypes.po b/library/datatypes.po index 6a8ee2dc97..7aa8cd0199 100644 --- a/library/datatypes.po +++ b/library/datatypes.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,16 +36,17 @@ msgstr "" "enumeratory." msgid "" -"Python also provides some built-in data types, in particular, :class:" -"`dict`, :class:`list`, :class:`set` and :class:`frozenset`, and :class:" -"`tuple`. The :class:`str` class is used to hold Unicode strings, and the :" -"class:`bytes` and :class:`bytearray` classes are used to hold binary data." +"Python also provides some built-in data types, in " +"particular, :class:`dict`, :class:`list`, :class:`set` " +"and :class:`frozenset`, and :class:`tuple`. The :class:`str` class is used " +"to hold Unicode strings, and the :class:`bytes` and :class:`bytearray` " +"classes are used to hold binary data." msgstr "" -"Python posiada również wbudowane typy danych, w szczególności :class:" -"`dict`, :class:`list`, :class:`set` i :class:`frozenset`, i :class:`tuple`. " -"Klasa :class:`str` jest używana do trzymania ciągu znaków unicode, zaś " -"klasy :class:`bytes` i :class:`bytearray` są używane do trzymania danych w " -"formacie binarnym." +"Python posiada również wbudowane typy danych, w " +"szczególności :class:`dict`, :class:`list`, :class:`set` " +"i :class:`frozenset`, i :class:`tuple`. Klasa :class:`str` jest używana do " +"trzymania ciągu znaków unicode, zaś klasy :class:`bytes` " +"i :class:`bytearray` są używane do trzymania danych w formacie binarnym." msgid "The following modules are documented in this chapter:" msgstr "Poszczególne moduły są opisane w rodziale:" diff --git a/library/datetime.po b/library/datetime.po index c3b58bec54..24433aae7d 100644 --- a/library/datetime.po +++ b/library/datetime.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -102,12 +102,12 @@ msgid "" msgstr "" msgid "" -"For applications requiring aware objects, :class:`.datetime` and :class:`." -"time` objects have an optional time zone information attribute, :attr:`!" -"tzinfo`, that can be set to an instance of a subclass of the abstract :class:" -"`!tzinfo` class. These :class:`tzinfo` objects capture information about the " -"offset from UTC time, the time zone name, and whether daylight saving time " -"is in effect." +"For applications requiring aware objects, :class:`.datetime` " +"and :class:`.time` objects have an optional time zone information " +"attribute, :attr:`!tzinfo`, that can be set to an instance of a subclass of " +"the abstract :class:`!tzinfo` class. These :class:`tzinfo` objects capture " +"information about the offset from UTC time, the time zone name, and whether " +"daylight saving time is in effect." msgstr "" msgid "" @@ -144,26 +144,27 @@ msgstr "" msgid "" "An idealized naive date, assuming the current Gregorian calendar always was, " -"and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, and :" -"attr:`day`." +"and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, " +"and :attr:`day`." msgstr "" msgid "" "An idealized time, independent of any particular day, assuming that every " "day has exactly 24\\*60\\*60 seconds. (There is no notion of \"leap " -"seconds\" here.) Attributes: :attr:`hour`, :attr:`minute`, :attr:`second`, :" -"attr:`microsecond`, and :attr:`.tzinfo`." +"seconds\" here.) " +"Attributes: :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:`microsecond`, " +"and :attr:`.tzinfo`." msgstr "" msgid "" -"A combination of a date and a time. Attributes: :attr:`year`, :attr:" -"`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:" -"`microsecond`, and :attr:`.tzinfo`." +"A combination of a date and a time. " +"Attributes: :attr:`year`, :attr:`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:`microsecond`, " +"and :attr:`.tzinfo`." msgstr "" msgid "" -"A duration expressing the difference between two :class:`.datetime` or :" -"class:`date` instances to microsecond resolution." +"A duration expressing the difference between two :class:`.datetime` " +"or :class:`date` instances to microsecond resolution." msgstr "" msgid "" @@ -218,28 +219,13 @@ msgid "" msgstr "" msgid "" -"A :class:`.datetime` object ``d`` is aware if both of the following hold:" +"A :class:`.datetime` object ``d`` is aware if :meth:`d.utcoffset() " +"` does not return ``None``. Otherwise, ``d`` is naive." msgstr "" -msgid "``d.tzinfo`` is not ``None``" -msgstr "" - -msgid "``d.tzinfo.utcoffset(d)`` does not return ``None``" -msgstr "" - -msgid "Otherwise, ``d`` is naive." -msgstr "" - -msgid "A :class:`.time` object ``t`` is aware if both of the following hold:" -msgstr "" - -msgid "``t.tzinfo`` is not ``None``" -msgstr "" - -msgid "``t.tzinfo.utcoffset(None)`` does not return ``None``." -msgstr "" - -msgid "Otherwise, ``t`` is naive." +msgid "" +"A :class:`.time` object ``t`` is aware if :meth:`t.utcoffset() " +"` does not return ``None``. Otherwise, ``t`` is naive." msgstr "" msgid "" @@ -329,8 +315,8 @@ msgid "" msgstr "" msgid "" -"If the normalized value of days lies outside the indicated range, :exc:" -"`OverflowError` is raised." +"If the normalized value of days lies outside the indicated " +"range, :exc:`OverflowError` is raised." msgstr "" msgid "" @@ -381,8 +367,8 @@ msgstr "" msgid "" "Note that, because of normalization, ``timedelta.max`` is greater than ``-" -"timedelta.min``. ``-timedelta.max`` is not representable as a :class:" -"`timedelta` object." +"timedelta.min``. ``-timedelta.max`` is not representable as " +"a :class:`timedelta` object." msgstr "" msgid "Instance attributes (read-only):" @@ -460,8 +446,8 @@ msgid "``f = t2 / t3``" msgstr "" msgid "" -"Division (3) of overall duration ``t2`` by interval unit ``t3``. Returns a :" -"class:`float` object." +"Division (3) of overall duration ``t2`` by interval unit ``t3``. Returns " +"a :class:`float` object." msgstr "" msgid "``t1 = t2 / f or t1 = t2 / i``" @@ -572,15 +558,15 @@ msgstr "" msgid "" "In addition to the operations listed above, :class:`timedelta` objects " -"support certain additions and subtractions with :class:`date` and :class:`." -"datetime` objects (see below)." +"support certain additions and subtractions with :class:`date` " +"and :class:`.datetime` objects (see below)." msgstr "" msgid "" -"Floor division and true division of a :class:`timedelta` object by another :" -"class:`!timedelta` object are now supported, as are remainder operations and " -"the :func:`divmod` function. True division and multiplication of a :class:`!" -"timedelta` object by a :class:`float` object are now supported." +"Floor division and true division of a :class:`timedelta` object by " +"another :class:`!timedelta` object are now supported, as are remainder " +"operations and the :func:`divmod` function. True division and multiplication " +"of a :class:`!timedelta` object by a :class:`float` object are now supported." msgstr "" msgid ":class:`timedelta` objects support equality and order comparisons." @@ -690,18 +676,18 @@ msgstr "" msgid "" "This may raise :exc:`OverflowError`, if the timestamp is out of the range of " -"values supported by the platform C :c:func:`localtime` function, and :exc:" -"`OSError` on :c:func:`localtime` failure. It's common for this to be " -"restricted to years from 1970 through 2038. Note that on non-POSIX systems " -"that include leap seconds in their notion of a timestamp, leap seconds are " -"ignored by :meth:`fromtimestamp`." +"values supported by the platform C :c:func:`localtime` function, " +"and :exc:`OSError` on :c:func:`localtime` failure. It's common for this to " +"be restricted to years from 1970 through 2038. Note that on non-POSIX " +"systems that include leap seconds in their notion of a timestamp, leap " +"seconds are ignored by :meth:`fromtimestamp`." msgstr "" msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " -"function. Raise :exc:`OSError` instead of :exc:`ValueError` on :c:func:" -"`localtime` failure." +"function. Raise :exc:`OSError` instead of :exc:`ValueError` " +"on :c:func:`localtime` failure." msgstr "" msgid "" @@ -749,8 +735,8 @@ msgstr "" msgid "" "Return a :class:`date` corresponding to the ISO calendar date specified by " -"*year*, *week* and *day*. This is the inverse of the function :meth:`date." -"isocalendar`." +"*year*, *week* and *day*. This is the inverse of the " +"function :meth:`date.isocalendar`." msgstr "" msgid "" @@ -768,13 +754,13 @@ msgid "" msgstr "" msgid "" -"If *format* specifies a day of month without a year a :exc:" -"`DeprecationWarning` is emitted. This is to avoid a quadrennial leap year " -"bug in code seeking to parse only a month and day as the default year used " -"in absence of one in the format is not a leap year. Such *format* values may " -"raise an error as of Python 3.15. The workaround is to always include a " -"year in your *format*. If parsing *date_string* values that do not have a " -"year, explicitly add a year that is a leap year before parsing:" +"If *format* specifies a day of month without a year " +"a :exc:`DeprecationWarning` is emitted. This is to avoid a quadrennial leap " +"year bug in code seeking to parse only a month and day as the default year " +"used in absence of one in the format is not a leap year. Such *format* " +"values may raise an error as of Python 3.15. The workaround is to always " +"include a year in your *format*. If parsing *date_string* values that do " +"not have a year, explicitly add a year that is a leap year before parsing:" msgstr "" msgid "" @@ -851,17 +837,17 @@ msgstr "" msgid "" "*date2* is moved forward in time if ``timedelta.days > 0``, or backward if " "``timedelta.days < 0``. Afterward ``date2 - date1 == timedelta.days``. " -"``timedelta.seconds`` and ``timedelta.microseconds`` are ignored. :exc:" -"`OverflowError` is raised if ``date2.year`` would be smaller than :const:" -"`MINYEAR` or larger than :const:`MAXYEAR`." +"``timedelta.seconds`` and ``timedelta.microseconds`` are " +"ignored. :exc:`OverflowError` is raised if ``date2.year`` would be smaller " +"than :const:`MINYEAR` or larger than :const:`MAXYEAR`." msgstr "" msgid "``timedelta.seconds`` and ``timedelta.microseconds`` are ignored." msgstr "" msgid "" -"This is exact, and cannot overflow. ``timedelta.seconds`` and ``timedelta." -"microseconds`` are 0, and ``date2 + timedelta == date1`` after." +"This is exact, and cannot overflow. ``timedelta.seconds`` and " +"``timedelta.microseconds`` are 0, and ``date2 + timedelta == date1`` after." msgstr "" msgid ":class:`date` objects are equal if they represent the same date." @@ -880,16 +866,17 @@ msgid "" msgstr "" msgid "" -"Order comparison between a :class:`date` object that is not also a :class:`." -"datetime` instance and a :class:`!datetime` object raises :exc:`TypeError`." +"Order comparison between a :class:`date` object that is not also " +"a :class:`.datetime` instance and a :class:`!datetime` object " +"raises :exc:`TypeError`." msgstr "" msgid "" -"Comparison between :class:`.datetime` object and an instance of the :class:" -"`date` subclass that is not a :class:`!datetime` subclass no longer converts " -"the latter to :class:`!date`, ignoring the time part and the time zone. The " -"default behavior can be changed by overriding the special comparison methods " -"in subclasses." +"Comparison between :class:`.datetime` object and an instance of " +"the :class:`date` subclass that is not a :class:`!datetime` subclass no " +"longer converts the latter to :class:`!date`, ignoring the time part and the " +"time zone. The default behavior can be changed by overriding the special " +"comparison methods in subclasses." msgstr "" msgid "" @@ -917,8 +904,8 @@ msgid "" msgstr "" msgid "" -"Return a :class:`time.struct_time` such as returned by :func:`time." -"localtime`." +"Return a :class:`time.struct_time` such as returned " +"by :func:`time.localtime`." msgstr "" msgid "The hours, minutes and seconds are 0, and the DST flag is -1." @@ -938,20 +925,20 @@ msgstr "" msgid "" "Return the proleptic Gregorian ordinal of the date, where January 1 of year " -"1 has ordinal 1. For any :class:`date` object ``d``, ``date.fromordinal(d." -"toordinal()) == d``." +"1 has ordinal 1. For any :class:`date` object ``d``, " +"``date.fromordinal(d.toordinal()) == d``." msgstr "" msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " -"For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See also :" -"meth:`isoweekday`." +"For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See " +"also :meth:`isoweekday`." msgstr "" msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " -"For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See also :" -"meth:`weekday`, :meth:`isocalendar`." +"For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See " +"also :meth:`weekday`, :meth:`isocalendar`." msgstr "" msgid "" @@ -1016,16 +1003,16 @@ msgid "time.ctime(time.mktime(d.timetuple()))" msgstr "" msgid "" -"on platforms where the native C :c:func:`ctime` function (which :func:`time." -"ctime` invokes, but which :meth:`date.ctime` does not invoke) conforms to " -"the C standard." +"on platforms where the native C :c:func:`ctime` function " +"(which :func:`time.ctime` invokes, but which :meth:`date.ctime` does not " +"invoke) conforms to the C standard." msgstr "" msgid "" "Return a string representing the date, controlled by an explicit format " "string. Format codes referring to hours, minutes or seconds will see 0 " -"values. See also :ref:`strftime-strptime-behavior` and :meth:`date." -"isoformat`." +"values. See also :ref:`strftime-strptime-behavior` " +"and :meth:`date.isoformat`." msgstr "" msgid "" @@ -1178,10 +1165,11 @@ msgid "Return the current local date and time." msgstr "" msgid "" -"If optional argument *tz* is ``None`` or not specified, this is like :meth:" -"`today`, but, if possible, supplies more precision than can be gotten from " -"going through a :func:`time.time` timestamp (for example, this may be " -"possible on platforms supplying the C :c:func:`gettimeofday` function)." +"If optional argument *tz* is ``None`` or not specified, this is " +"like :meth:`today`, but, if possible, supplies more precision than can be " +"gotten from going through a :func:`time.time` timestamp (for example, this " +"may be possible on platforms supplying the C :c:func:`gettimeofday` " +"function)." msgstr "" msgid "" @@ -1231,20 +1219,20 @@ msgstr "" msgid "" ":meth:`fromtimestamp` may raise :exc:`OverflowError`, if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " -"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` or :" -"c:func:`gmtime` failure. It's common for this to be restricted to years in " -"1970 through 2038. Note that on non-POSIX systems that include leap seconds " -"in their notion of a timestamp, leap seconds are ignored by :meth:" -"`fromtimestamp`, and then it's possible to have two timestamps differing by " -"a second that yield identical :class:`.datetime` objects. This method is " -"preferred over :meth:`utcfromtimestamp`." +"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` " +"or :c:func:`gmtime` failure. It's common for this to be restricted to years " +"in 1970 through 2038. Note that on non-POSIX systems that include leap " +"seconds in their notion of a timestamp, leap seconds are ignored " +"by :meth:`fromtimestamp`, and then it's possible to have two timestamps " +"differing by a second that yield identical :class:`.datetime` objects. This " +"method is preferred over :meth:`utcfromtimestamp`." msgstr "" msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " -"or :c:func:`gmtime` functions. Raise :exc:`OSError` instead of :exc:" -"`ValueError` on :c:func:`localtime` or :c:func:`gmtime` failure." +"or :c:func:`gmtime` functions. Raise :exc:`OSError` instead " +"of :exc:`ValueError` on :c:func:`localtime` or :c:func:`gmtime` failure." msgstr "" msgid ":meth:`fromtimestamp` may return instances with :attr:`.fold` set to 1." @@ -1257,9 +1245,9 @@ msgstr "" msgid "" "This may raise :exc:`OverflowError`, if the timestamp is out of the range of " -"values supported by the platform C :c:func:`gmtime` function, and :exc:" -"`OSError` on :c:func:`gmtime` failure. It's common for this to be restricted " -"to years in 1970 through 2038." +"values supported by the platform C :c:func:`gmtime` function, " +"and :exc:`OSError` on :c:func:`gmtime` failure. It's common for this to be " +"restricted to years in 1970 through 2038." msgstr "" msgid "To get an aware :class:`.datetime` object, call :meth:`fromtimestamp`::" @@ -1278,8 +1266,8 @@ msgid "" msgstr "" msgid "" -"except the latter formula always supports the full years range: between :" -"const:`MINYEAR` and :const:`MAXYEAR` inclusive." +"except the latter formula always supports the full years range: " +"between :const:`MINYEAR` and :const:`MAXYEAR` inclusive." msgstr "" msgid "" @@ -1293,8 +1281,8 @@ msgstr "" msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`gmtime` " -"function. Raise :exc:`OSError` instead of :exc:`ValueError` on :c:func:" -"`gmtime` failure." +"function. Raise :exc:`OSError` instead of :exc:`ValueError` " +"on :c:func:`gmtime` failure." msgstr "" msgid "Accepts any real number as *timestamp*, not only integer or float." @@ -1317,13 +1305,13 @@ msgid "" "given :class:`.time` object's. If the *tzinfo* argument is provided, its " "value is used to set the :attr:`.tzinfo` attribute of the result, otherwise " "the :attr:`~.time.tzinfo` attribute of the *time* argument is used. If the " -"*date* argument is a :class:`!datetime` object, its time components and :" -"attr:`.tzinfo` attributes are ignored." +"*date* argument is a :class:`!datetime` object, its time components " +"and :attr:`.tzinfo` attributes are ignored." msgstr "" msgid "" -"For any :class:`.datetime` object ``d``, ``d == datetime.combine(d.date(), d." -"time(), d.tzinfo)``." +"For any :class:`.datetime` object ``d``, ``d == datetime.combine(d.date(), " +"d.time(), d.tzinfo)``." msgstr "" msgid "Added the *tzinfo* argument." @@ -1360,16 +1348,16 @@ msgid "" ">>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23, 283000)\n" ">>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')\n" -"datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone." -"utc)\n" +"datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, " +"tzinfo=datetime.timezone.utc)\n" ">>> dt.datetime.fromisoformat('2011-11-04T00:05:23+04:00')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23,\n" " tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))" msgstr "" msgid "" -"Previously, this method only supported formats that could be emitted by :" -"meth:`date.isoformat` or :meth:`datetime.isoformat`." +"Previously, this method only supported formats that could be emitted " +"by :meth:`date.isoformat` or :meth:`datetime.isoformat`." msgstr "" msgid "" @@ -1395,15 +1383,15 @@ msgstr "" msgid "" ":exc:`ValueError` is raised if the date_string and format can't be parsed " "by :func:`time.strptime` or if it returns a value which isn't a time tuple. " -"See also :ref:`strftime-strptime-behavior` and :meth:`datetime." -"fromisoformat`." +"See also :ref:`strftime-strptime-behavior` " +"and :meth:`datetime.fromisoformat`." msgstr "" msgid "" -"If *format* specifies a day of month without a year a :exc:" -"`DeprecationWarning` is now emitted. This is to avoid a quadrennial leap " -"year bug in code seeking to parse only a month and day as the default year " -"used in absence of one in the format is not a leap year. Such *format* " +"If *format* specifies a day of month without a year " +"a :exc:`DeprecationWarning` is now emitted. This is to avoid a quadrennial " +"leap year bug in code seeking to parse only a month and day as the default " +"year used in absence of one in the format is not a leap year. Such *format* " "values may raise an error as of Python 3.15. The workaround is to always " "include a year in your *format*. If parsing *date_string* values that do " "not have a year, explicitly add a year that is a leap year before parsing:" @@ -1491,12 +1479,12 @@ msgstr "``datetime1 >= datetime2``" msgid "" "``datetime2`` is a duration of ``timedelta`` removed from ``datetime1``, " -"moving forward in time if ``timedelta.days > 0``, or backward if ``timedelta." -"days < 0``. The result has the same :attr:`~.datetime.tzinfo` attribute as " -"the input datetime, and ``datetime2 - datetime1 == timedelta`` after. :exc:" -"`OverflowError` is raised if ``datetime2.year`` would be smaller than :const:" -"`MINYEAR` or larger than :const:`MAXYEAR`. Note that no time zone " -"adjustments are done even if the input is an aware object." +"moving forward in time if ``timedelta.days > 0``, or backward if " +"``timedelta.days < 0``. The result has the same :attr:`~.datetime.tzinfo` " +"attribute as the input datetime, and ``datetime2 - datetime1 == timedelta`` " +"after. :exc:`OverflowError` is raised if ``datetime2.year`` would be smaller " +"than :const:`MINYEAR` or larger than :const:`MAXYEAR`. Note that no time " +"zone adjustments are done even if the input is an aware object." msgstr "" msgid "" @@ -1513,18 +1501,19 @@ msgid "" msgstr "" msgid "" -"If both are naive, or both are aware and have the same :attr:`~.datetime." -"tzinfo` attribute, the :attr:`~.datetime.tzinfo` attributes are ignored, and " -"the result is a :class:`timedelta` object ``t`` such that ``datetime2 + t == " -"datetime1``. No time zone adjustments are done in this case." +"If both are naive, or both are aware and have the " +"same :attr:`~.datetime.tzinfo` attribute, the :attr:`~.datetime.tzinfo` " +"attributes are ignored, and the result is a :class:`timedelta` object ``t`` " +"such that ``datetime2 + t == datetime1``. No time zone adjustments are done " +"in this case." msgstr "" msgid "" "If both are aware and have different :attr:`~.datetime.tzinfo` attributes, " "``a-b`` acts as if ``a`` and ``b`` were first converted to naive UTC " -"datetimes. The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - (b." -"replace(tzinfo=None) - b.utcoffset())`` except that the implementation never " -"overflows." +"datetimes. The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - " +"(b.replace(tzinfo=None) - b.utcoffset())`` except that the implementation " +"never overflows." msgstr "" msgid "" @@ -1551,8 +1540,8 @@ msgid "" msgstr "" msgid "" -"Order comparison between naive and aware :class:`.datetime` objects raises :" -"exc:`TypeError`." +"Order comparison between naive and aware :class:`.datetime` objects " +"raises :exc:`TypeError`." msgstr "" msgid "" @@ -1586,15 +1575,15 @@ msgid "" msgstr "" msgid "" -"Return a new :class:`datetime` object with the same attributes, but with " -"specified parameters updated. Note that ``tzinfo=None`` can be specified to " -"create a naive datetime from an aware datetime with no conversion of date " -"and time data." +"Return a new :class:`~datetime.datetime` object with the same attributes, " +"but with specified parameters updated. Note that ``tzinfo=None`` can be " +"specified to create a naive datetime from an aware datetime with no " +"conversion of date and time data." msgstr "" msgid "" -":class:`.datetime` objects are also supported by generic function :func:" -"`copy.replace`." +":class:`.datetime` objects are also supported by generic " +"function :func:`copy.replace`." msgstr "" msgid "" @@ -1626,16 +1615,16 @@ msgstr "" msgid "" "If you merely want to attach a :class:`timezone` object *tz* to a datetime " -"*dt* without adjustment of date and time data, use ``dt." -"replace(tzinfo=tz)``. If you merely want to remove the :class:`!timezone` " -"object from an aware datetime *dt* without conversion of date and time data, " -"use ``dt.replace(tzinfo=None)``." +"*dt* without adjustment of date and time data, use " +"``dt.replace(tzinfo=tz)``. If you merely want to remove the :class:`!" +"timezone` object from an aware datetime *dt* without conversion of date and " +"time data, use ``dt.replace(tzinfo=None)``." msgstr "" msgid "" -"Note that the default :meth:`tzinfo.fromutc` method can be overridden in a :" -"class:`tzinfo` subclass to affect the result returned by :meth:`astimezone`. " -"Ignoring error cases, :meth:`astimezone` acts like::" +"Note that the default :meth:`tzinfo.fromutc` method can be overridden in " +"a :class:`tzinfo` subclass to affect the result returned " +"by :meth:`astimezone`. Ignoring error cases, :meth:`astimezone` acts like::" msgstr "" msgid "" @@ -1657,27 +1646,29 @@ msgid "" msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"utcoffset(self)``, and raises an exception if the latter doesn't return " -"``None`` or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.utcoffset(self)``, and raises an exception if the latter " +"doesn't return ``None`` or a :class:`timedelta` object with magnitude less " +"than one day." msgstr "" msgid "The UTC offset is not restricted to a whole number of minutes." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"dst(self)``, and raises an exception if the latter doesn't return ``None`` " -"or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.dst(self)``, and raises an exception if the latter doesn't " +"return ``None`` or a :class:`timedelta` object with magnitude less than one " +"day." msgstr "" msgid "The DST offset is not restricted to a whole number of minutes." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"tzname(self)``, raises an exception if the latter doesn't return ``None`` or " -"a string object," +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.tzname(self)``, raises an exception if the latter doesn't " +"return ``None`` or a string object," msgstr "" msgid "" @@ -1688,56 +1679,55 @@ msgstr "" msgid "" "where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the " -"day number within the current year starting with 1 for January 1st. The :" -"attr:`~time.struct_time.tm_isdst` flag of the result is set according to " -"the :meth:`dst` method: :attr:`.tzinfo` is ``None`` or :meth:`dst` returns " -"``None``, :attr:`!tm_isdst` is set to ``-1``; else if :meth:`dst` returns a " -"non-zero value, :attr:`!tm_isdst` is set to 1; else :attr:`!tm_isdst` is set " -"to 0." +"day number within the current year starting with 1 for January 1st. " +"The :attr:`~time.struct_time.tm_isdst` flag of the result is set according " +"to the :meth:`dst` method: :attr:`.tzinfo` is ``None`` or :meth:`dst` " +"returns ``None``, :attr:`!tm_isdst` is set to ``-1``; else if :meth:`dst` " +"returns a non-zero value, :attr:`!tm_isdst` is set to 1; else :attr:`!" +"tm_isdst` is set to 0." msgstr "" msgid "" -"If :class:`.datetime` instance ``d`` is naive, this is the same as ``d." -"timetuple()`` except that :attr:`~.time.struct_time.tm_isdst` is forced to 0 " -"regardless of what ``d.dst()`` returns. DST is never in effect for a UTC " -"time." +"If :class:`.datetime` instance ``d`` is naive, this is the same as " +"``d.timetuple()`` except that :attr:`~.time.struct_time.tm_isdst` is forced " +"to 0 regardless of what ``d.dst()`` returns. DST is never in effect for a " +"UTC time." msgstr "" msgid "" -"If ``d`` is aware, ``d`` is normalized to UTC time, by subtracting ``d." -"utcoffset()``, and a :class:`time.struct_time` for the normalized time is " -"returned. :attr:`!tm_isdst` is forced to 0. Note that an :exc:" -"`OverflowError` may be raised if ``d.year`` was ``MINYEAR`` or ``MAXYEAR`` " -"and UTC adjustment spills over a year boundary." +"If ``d`` is aware, ``d`` is normalized to UTC time, by subtracting " +"``d.utcoffset()``, and a :class:`time.struct_time` for the normalized time " +"is returned. :attr:`!tm_isdst` is forced to 0. Note that " +"an :exc:`OverflowError` may be raised if ``d.year`` was ``MINYEAR`` or " +"``MAXYEAR`` and UTC adjustment spills over a year boundary." msgstr "" msgid "" "Because naive ``datetime`` objects are treated by many ``datetime`` methods " "as local times, it is preferred to use aware datetimes to represent times in " "UTC; as a result, using :meth:`datetime.utctimetuple` may give misleading " -"results. If you have a naive ``datetime`` representing UTC, use ``datetime." -"replace(tzinfo=timezone.utc)`` to make it aware, at which point you can use :" -"meth:`.datetime.timetuple`." +"results. If you have a naive ``datetime`` representing UTC, use " +"``datetime.replace(tzinfo=timezone.utc)`` to make it aware, at which point " +"you can use :meth:`.datetime.timetuple`." msgstr "" msgid "" -"Return the proleptic Gregorian ordinal of the date. The same as ``self." -"date().toordinal()``." +"Return the proleptic Gregorian ordinal of the date. The same as " +"``self.date().toordinal()``." msgstr "" msgid "" "Return POSIX timestamp corresponding to the :class:`.datetime` instance. The " -"return value is a :class:`float` similar to that returned by :func:`time." -"time`." +"return value is a :class:`float` similar to that returned " +"by :func:`time.time`." msgstr "" msgid "" "Naive :class:`.datetime` instances are assumed to represent local time and " -"this method relies on the platform C :c:func:`mktime` function to perform " -"the conversion. Since :class:`!datetime` supports wider range of values " -"than :c:func:`mktime` on many platforms, this method may raise :exc:" -"`OverflowError` or :exc:`OSError` for times far in the past or far in the " -"future." +"this method relies on platform C functions to perform the conversion. " +"Since :class:`!datetime` supports a wider range of values than the platform " +"C functions on many platforms, this method may raise :exc:`OverflowError` " +"or :exc:`OSError` for times far in the past or far in the future." msgstr "" msgid "" @@ -1748,10 +1738,10 @@ msgid "(dt - datetime(1970, 1, 1, tzinfo=timezone.utc)).total_seconds()" msgstr "" msgid "" -"There is no method to obtain the POSIX timestamp directly from a naive :" -"class:`.datetime` instance representing UTC time. If your application uses " -"this convention and your system time zone is not set to UTC, you can obtain " -"the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" +"There is no method to obtain the POSIX timestamp directly from a " +"naive :class:`.datetime` instance representing UTC time. If your application " +"uses this convention and your system time zone is not set to UTC, you can " +"obtain the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" msgstr "" msgid "timestamp = dt.replace(tzinfo=timezone.utc).timestamp()" @@ -1768,6 +1758,11 @@ msgid "" "disambiguate the times during a repeated interval." msgstr "" +msgid "" +"This method no longer relies on the platform C :c:func:`mktime` function to " +"perform conversions." +msgstr "" + msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "The same as ``self.date().weekday()``. See also :meth:`isoweekday`." @@ -1775,8 +1770,8 @@ msgstr "" msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " -"The same as ``self.date().isoweekday()``. See also :meth:`weekday`, :meth:" -"`isocalendar`." +"The same as ``self.date().isoweekday()``. See " +"also :meth:`weekday`, :meth:`isocalendar`." msgstr "" msgid "" @@ -1883,8 +1878,8 @@ msgid "Added the *timespec* parameter." msgstr "" msgid "" -"For a :class:`.datetime` instance ``d``, ``str(d)`` is equivalent to ``d." -"isoformat(' ')``." +"For a :class:`.datetime` instance ``d``, ``str(d)`` is equivalent to " +"``d.isoformat(' ')``." msgstr "" msgid "Return a string representing the date and time::" @@ -1902,22 +1897,22 @@ msgid "" msgstr "" msgid "" -"on platforms where the native C :c:func:`ctime` function (which :func:`time." -"ctime` invokes, but which :meth:`datetime.ctime` does not invoke) conforms " -"to the C standard." +"on platforms where the native C :c:func:`ctime` function " +"(which :func:`time.ctime` invokes, but which :meth:`datetime.ctime` does not " +"invoke) conforms to the C standard." msgstr "" msgid "" "Return a string representing the date and time, controlled by an explicit " -"format string. See also :ref:`strftime-strptime-behavior` and :meth:" -"`datetime.isoformat`." +"format string. See also :ref:`strftime-strptime-behavior` " +"and :meth:`datetime.isoformat`." msgstr "" msgid "" "Same as :meth:`.datetime.strftime`. This makes it possible to specify a " "format string for a :class:`.datetime` object in :ref:`formatted string " -"literals ` and when using :meth:`str.format`. See also :ref:" -"`strftime-strptime-behavior` and :meth:`datetime.isoformat`." +"literals ` and when using :meth:`str.format`. See " +"also :ref:`strftime-strptime-behavior` and :meth:`datetime.isoformat`." msgstr "" msgid "Examples of usage: :class:`!datetime`" @@ -1939,8 +1934,8 @@ msgid "" ">>> dt.datetime.now()\n" "datetime.datetime(2007, 12, 6, 16, 29, 43, 79043) # GMT +1\n" ">>> dt.datetime.now(dt.timezone.utc)\n" -"datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, tzinfo=datetime.timezone." -"utc)\n" +"datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, " +"tzinfo=datetime.timezone.utc)\n" "\n" ">>> # Using datetime.strptime()\n" ">>> my_datetime = dt.datetime.strptime(\"21/11/06 16:30\", \"%d/%m/%y %H:" @@ -1975,8 +1970,8 @@ msgid "" ">>> # Formatting a datetime\n" ">>> my_datetime.strftime(\"%A, %d. %B %Y %I:%M%p\")\n" "'Tuesday, 21. November 2006 04:30PM'\n" -">>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:%M%p}.'." -"format(my_datetime, \"day\", \"month\", \"time\")\n" +">>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:" +"%M%p}.'.format(my_datetime, \"day\", \"month\", \"time\")\n" "'The day is 21, the month is November, the time is 04:30PM.'" msgstr "" @@ -2067,8 +2062,8 @@ msgid "" msgstr "" msgid "" -"All arguments are optional. *tzinfo* may be ``None``, or an instance of a :" -"class:`tzinfo` subclass. The remaining arguments must be integers in the " +"All arguments are optional. *tzinfo* may be ``None``, or an instance of " +"a :class:`tzinfo` subclass. The remaining arguments must be integers in the " "following ranges:" msgstr "" @@ -2085,8 +2080,8 @@ msgstr "" msgid "" "The smallest possible difference between non-equal :class:`.time` objects, " -"``timedelta(microseconds=1)``, although note that arithmetic on :class:`." -"time` objects is not supported." +"``timedelta(microseconds=1)``, although note that arithmetic " +"on :class:`.time` objects is not supported." msgstr "" msgid "" @@ -2162,8 +2157,8 @@ msgid "" ">>> dt.time.fromisoformat('04:23:01,000384')\n" "datetime.time(4, 23, 1, 384)\n" ">>> dt.time.fromisoformat('04:23:01+04:00')\n" -"datetime.time(4, 23, 1, tzinfo=datetime.timezone(datetime." -"timedelta(seconds=14400)))\n" +"datetime.time(4, 23, 1, " +"tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))\n" ">>> dt.time.fromisoformat('04:23:01Z')\n" "datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)\n" ">>> dt.time.fromisoformat('04:23:01+00:00')\n" @@ -2171,8 +2166,8 @@ msgid "" msgstr "" msgid "" -"Previously, this method only supported formats that could be emitted by :" -"meth:`time.isoformat`." +"Previously, this method only supported formats that could be emitted " +"by :meth:`time.isoformat`." msgstr "" msgid "" @@ -2191,8 +2186,8 @@ msgstr "" msgid "" ":exc:`ValueError` is raised if the *date_string* and *format* cannot be " "parsed by :func:`time.strptime` or if it returns a value which is not a time " -"tuple. See also :ref:`strftime-strptime-behavior` and :meth:`time." -"fromisoformat`." +"tuple. See also :ref:`strftime-strptime-behavior` " +"and :meth:`time.fromisoformat`." msgstr "" msgid "" @@ -2203,8 +2198,8 @@ msgid "" msgstr "" msgid "" -":class:`.time` objects are also supported by generic function :func:`copy." -"replace`." +":class:`.time` objects are also supported by generic " +"function :func:`copy.replace`." msgstr "" msgid "Return a string representing the time in ISO 8601 format, one of:" @@ -2222,8 +2217,8 @@ msgid "" msgstr "" msgid "" -"``HH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0 and :meth:" -"`utcoffset` does not return ``None``" +"``HH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0 " +"and :meth:`utcoffset` does not return ``None``" msgstr "" msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument." @@ -2231,8 +2226,8 @@ msgstr "" msgid "" ">>> import datetime as dt\n" -">>> dt.time(hour=12, minute=34, second=56, microsecond=123456)." -"isoformat(timespec='minutes')\n" +">>> dt.time(hour=12, minute=34, second=56, " +"microsecond=123456).isoformat(timespec='minutes')\n" "'12:34'\n" ">>> my_time = dt.time(hour=12, minute=34, second=56, microsecond=0)\n" ">>> my_time.isoformat(timespec='microseconds')\n" @@ -2246,8 +2241,8 @@ msgstr "" msgid "" "Return a string representing the time, controlled by an explicit format " -"string. See also :ref:`strftime-strptime-behavior` and :meth:`time." -"isoformat`." +"string. See also :ref:`strftime-strptime-behavior` " +"and :meth:`time.isoformat`." msgstr "" msgid "" @@ -2258,21 +2253,23 @@ msgid "" msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"utcoffset(None)``, and raises an exception if the latter doesn't return " -"``None`` or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.utcoffset(None)``, and raises an exception if the latter " +"doesn't return ``None`` or a :class:`timedelta` object with magnitude less " +"than one day." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"dst(None)``, and raises an exception if the latter doesn't return ``None``, " -"or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.dst(None)``, and raises an exception if the latter doesn't " +"return ``None``, or a :class:`timedelta` object with magnitude less than one " +"day." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"tzname(None)``, or raises an exception if the latter doesn't return ``None`` " -"or a string object." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.tzname(None)``, or raises an exception if the latter doesn't " +"return ``None`` or a string object." msgstr "" msgid "Examples of usage: :class:`!time`" @@ -2328,24 +2325,24 @@ msgstr "" msgid "" "You need to derive a concrete subclass, and (at least) supply " -"implementations of the standard :class:`tzinfo` methods needed by the :class:" -"`.datetime` methods you use. The :mod:`!datetime` module provides :class:" -"`timezone`, a simple concrete subclass of :class:`!tzinfo` which can " -"represent time zones with fixed offset from UTC such as UTC itself or North " -"American EST and EDT." +"implementations of the standard :class:`tzinfo` methods needed by " +"the :class:`.datetime` methods you use. The :mod:`!datetime` module " +"provides :class:`timezone`, a simple concrete subclass of :class:`!tzinfo` " +"which can represent time zones with fixed offset from UTC such as UTC itself " +"or North American EST and EDT." msgstr "" msgid "" -"Special requirement for pickling: A :class:`tzinfo` subclass must have an :" -"meth:`~object.__init__` method that can be called with no arguments, " +"Special requirement for pickling: A :class:`tzinfo` subclass must have " +"an :meth:`~object.__init__` method that can be called with no arguments, " "otherwise it can be pickled but possibly not unpickled again. This is a " "technical requirement that may be relaxed in the future." msgstr "" msgid "" "A concrete subclass of :class:`tzinfo` may need to implement the following " -"methods. Exactly which methods are needed depends on the uses made of aware :" -"mod:`!datetime` objects. If in doubt, simply implement all of them." +"methods. Exactly which methods are needed depends on the uses made of " +"aware :mod:`!datetime` objects. If in doubt, simply implement all of them." msgstr "" msgid "" @@ -2354,13 +2351,14 @@ msgid "" msgstr "" msgid "" -"This represents the *total* offset from UTC; for example, if a :class:" -"`tzinfo` object represents both time zone and DST adjustments, :meth:" -"`utcoffset` should return their sum. If the UTC offset isn't known, return " -"``None``. Else the value returned must be a :class:`timedelta` object " -"strictly between ``-timedelta(hours=24)`` and ``timedelta(hours=24)`` (the " -"magnitude of the offset must be less than one day). Most implementations of :" -"meth:`utcoffset` will probably look like one of these two::" +"This represents the *total* offset from UTC; for example, if " +"a :class:`tzinfo` object represents both time zone and DST " +"adjustments, :meth:`utcoffset` should return their sum. If the UTC offset " +"isn't known, return ``None``. Else the value returned must be " +"a :class:`timedelta` object strictly between ``-timedelta(hours=24)`` and " +"``timedelta(hours=24)`` (the magnitude of the offset must be less than one " +"day). Most implementations of :meth:`utcoffset` will probably look like one " +"of these two::" msgstr "" msgid "" @@ -2374,8 +2372,8 @@ msgid "" msgstr "" msgid "" -"The default implementation of :meth:`utcoffset` raises :exc:" -"`NotImplementedError`." +"The default implementation of :meth:`utcoffset` " +"raises :exc:`NotImplementedError`." msgstr "" msgid "" @@ -2387,12 +2385,13 @@ msgid "" "Return ``timedelta(0)`` if DST is not in effect. If DST is in effect, return " "the offset as a :class:`timedelta` object (see :meth:`utcoffset` for " "details). Note that DST offset, if applicable, has already been added to the " -"UTC offset returned by :meth:`utcoffset`, so there's no need to consult :" -"meth:`dst` unless you're interested in obtaining DST info separately. For " -"example, :meth:`datetime.timetuple` calls its :attr:`~.datetime.tzinfo` " -"attribute's :meth:`dst` method to determine how the :attr:`~time.struct_time." -"tm_isdst` flag should be set, and :meth:`tzinfo.fromutc` calls :meth:`dst` " -"to account for DST changes when crossing time zones." +"UTC offset returned by :meth:`utcoffset`, so there's no need to " +"consult :meth:`dst` unless you're interested in obtaining DST info " +"separately. For example, :meth:`datetime.timetuple` calls " +"its :attr:`~.datetime.tzinfo` attribute's :meth:`dst` method to determine " +"how the :attr:`~time.struct_time.tm_isdst` flag should be set, " +"and :meth:`tzinfo.fromutc` calls :meth:`dst` to account for DST changes when " +"crossing time zones." msgstr "" msgid "" @@ -2404,15 +2403,15 @@ msgid "``tz.utcoffset(dt) - tz.dst(dt)``" msgstr "``tz.utcoffset(dt) - tz.dst(dt)``" msgid "" -"must return the same result for every :class:`.datetime` *dt* with ``dt." -"tzinfo == tz``. For sane :class:`!tzinfo` subclasses, this expression yields " -"the time zone's \"standard offset\", which should not depend on the date or " -"the time, but only on geographic location. The implementation of :meth:" -"`datetime.astimezone` relies on this, but cannot detect violations; it's the " -"programmer's responsibility to ensure it. If a :class:`!tzinfo` subclass " -"cannot guarantee this, it may be able to override the default implementation " -"of :meth:`tzinfo.fromutc` to work correctly with :meth:`~.datetime." -"astimezone` regardless." +"must return the same result for every :class:`.datetime` *dt* with " +"``dt.tzinfo == tz``. For sane :class:`!tzinfo` subclasses, this expression " +"yields the time zone's \"standard offset\", which should not depend on the " +"date or the time, but only on geographic location. The implementation " +"of :meth:`datetime.astimezone` relies on this, but cannot detect violations; " +"it's the programmer's responsibility to ensure it. If a :class:`!tzinfo` " +"subclass cannot guarantee this, it may be able to override the default " +"implementation of :meth:`tzinfo.fromutc` to work correctly " +"with :meth:`~.datetime.astimezone` regardless." msgstr "" msgid "" @@ -2456,15 +2455,15 @@ msgid "" "particular. For example, ``\"GMT\"``, ``\"UTC\"``, ``\"-500\"``, " "``\"-5:00\"``, ``\"EDT\"``, ``\"US/Eastern\"``, ``\"America/New York\"`` are " "all valid replies. Return ``None`` if a string name isn't known. Note that " -"this is a method rather than a fixed string primarily because some :class:" -"`tzinfo` subclasses will wish to return different names depending on the " -"specific value of *dt* passed, especially if the :class:`!tzinfo` class is " -"accounting for daylight time." +"this is a method rather than a fixed string primarily because " +"some :class:`tzinfo` subclasses will wish to return different names " +"depending on the specific value of *dt* passed, especially if the :class:`!" +"tzinfo` class is accounting for daylight time." msgstr "" msgid "" -"The default implementation of :meth:`tzname` raises :exc:" -"`NotImplementedError`." +"The default implementation of :meth:`tzname` " +"raises :exc:`NotImplementedError`." msgstr "" msgid "" @@ -2486,11 +2485,11 @@ msgstr "" msgid "" "When a :class:`.datetime` object is passed in response to a :class:`!" -"datetime` method, ``dt.tzinfo`` is the same object as *self*. :class:" -"`tzinfo` methods can rely on this, unless user code calls :class:`!tzinfo` " -"methods directly. The intent is that the :class:`!tzinfo` methods interpret " -"*dt* as being in local time, and not need worry about objects in other time " -"zones." +"datetime` method, ``dt.tzinfo`` is the same object as " +"*self*. :class:`tzinfo` methods can rely on this, unless user code " +"calls :class:`!tzinfo` methods directly. The intent is that the :class:`!" +"tzinfo` methods interpret *dt* as being in local time, and not need worry " +"about objects in other time zones." msgstr "" msgid "" @@ -2501,23 +2500,23 @@ msgstr "" msgid "" "This is called from the default :meth:`datetime.astimezone` implementation. " "When called from that, ``dt.tzinfo`` is *self*, and *dt*'s date and time " -"data are to be viewed as expressing a UTC time. The purpose of :meth:" -"`fromutc` is to adjust the date and time data, returning an equivalent " -"datetime in *self*'s local time." +"data are to be viewed as expressing a UTC time. The purpose " +"of :meth:`fromutc` is to adjust the date and time data, returning an " +"equivalent datetime in *self*'s local time." msgstr "" msgid "" -"Most :class:`tzinfo` subclasses should be able to inherit the default :meth:" -"`fromutc` implementation without problems. It's strong enough to handle " -"fixed-offset time zones, and time zones accounting for both standard and " -"daylight time, and the latter even if the DST transition times differ in " -"different years. An example of a time zone the default :meth:`fromutc` " -"implementation may not handle correctly in all cases is one where the " -"standard offset (from UTC) depends on the specific date and time passed, " -"which can happen for political reasons. The default implementations of :meth:" -"`~.datetime.astimezone` and :meth:`fromutc` may not produce the result you " -"want if the result is one of the hours straddling the moment the standard " -"offset changes." +"Most :class:`tzinfo` subclasses should be able to inherit the " +"default :meth:`fromutc` implementation without problems. It's strong enough " +"to handle fixed-offset time zones, and time zones accounting for both " +"standard and daylight time, and the latter even if the DST transition times " +"differ in different years. An example of a time zone the " +"default :meth:`fromutc` implementation may not handle correctly in all cases " +"is one where the standard offset (from UTC) depends on the specific date and " +"time passed, which can happen for political reasons. The default " +"implementations of :meth:`~.datetime.astimezone` and :meth:`fromutc` may not " +"produce the result you want if the result is one of the hours straddling the " +"moment the standard offset changes." msgstr "" msgid "" @@ -2545,8 +2544,8 @@ msgid "" msgstr "" msgid "" -"In the following :download:`tzinfo_examples.py <../includes/tzinfo_examples." -"py>` file there are some examples of :class:`tzinfo` classes:" +"In the following :download:`tzinfo_examples.py <../includes/" +"tzinfo_examples.py>` file there are some examples of :class:`tzinfo` classes:" msgstr "" msgid "" @@ -2732,11 +2731,11 @@ msgid "" msgstr "" msgid "" -"Note that there are unavoidable subtleties twice per year in a :class:" -"`tzinfo` subclass accounting for both standard and daylight time, at the DST " -"transition points. For concreteness, consider US Eastern (UTC -0500), where " -"EDT begins the minute after 1:59 (EST) on the second Sunday in March, and " -"ends the minute after 1:59 (EDT) on the first Sunday in November::" +"Note that there are unavoidable subtleties twice per year in " +"a :class:`tzinfo` subclass accounting for both standard and daylight time, " +"at the DST transition points. For concreteness, consider US Eastern (UTC " +"-0500), where EDT begins the minute after 1:59 (EST) on the second Sunday in " +"March, and ends the minute after 1:59 (EDT) on the first Sunday in November::" msgstr "" msgid "" @@ -2808,11 +2807,11 @@ msgstr "" msgid "" "Applications that can't bear wall-time ambiguities should explicitly check " -"the value of the :attr:`~.datetime.fold` attribute or avoid using hybrid :" -"class:`tzinfo` subclasses; there are no ambiguities when using :class:" -"`timezone`, or any other fixed-offset :class:`!tzinfo` subclass (such as a " -"class representing only EST (fixed offset -5 hours), or only EDT (fixed " -"offset -4 hours))." +"the value of the :attr:`~.datetime.fold` attribute or avoid using " +"hybrid :class:`tzinfo` subclasses; there are no ambiguities when " +"using :class:`timezone`, or any other fixed-offset :class:`!tzinfo` subclass " +"(such as a class representing only EST (fixed offset -5 hours), or only EDT " +"(fixed offset -4 hours))." msgstr "" msgid ":mod:`zoneinfo`" @@ -2893,8 +2892,8 @@ msgid "Always returns ``None``." msgstr "" msgid "" -"Return ``dt + offset``. The *dt* argument must be an aware :class:`." -"datetime` instance, with ``tzinfo`` set to ``self``." +"Return ``dt + offset``. The *dt* argument must be an " +"aware :class:`.datetime` instance, with ``tzinfo`` set to ``self``." msgstr "" msgid "The UTC time zone, ``timezone(timedelta(0))``." @@ -2910,14 +2909,14 @@ msgid "" msgstr "" msgid "" -"Conversely, the :meth:`date.strptime`, :meth:`datetime.strptime` and :meth:" -"`time.strptime` class methods create an object from a string representing " -"the time and a corresponding format string." +"Conversely, the :meth:`date.strptime`, :meth:`datetime.strptime` " +"and :meth:`time.strptime` class methods create an object from a string " +"representing the time and a corresponding format string." msgstr "" msgid "" -"The table below provides a high-level comparison of :meth:`~.datetime." -"strftime` versus :meth:`~.datetime.strptime`:" +"The table below provides a high-level comparison " +"of :meth:`~.datetime.strftime` versus :meth:`~.datetime.strptime`:" msgstr "" msgid "``strftime``" @@ -3298,11 +3297,11 @@ msgid "(empty), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216" msgstr "" msgid "" -"These may not be available on all platforms when used with the :meth:`~." -"datetime.strftime` method. The ISO 8601 year and ISO 8601 week directives " -"are not interchangeable with the year and week number directives above. " -"Calling :meth:`~.datetime.strptime` with incomplete or ambiguous ISO 8601 " -"directives will raise a :exc:`ValueError`." +"These may not be available on all platforms when used with " +"the :meth:`~.datetime.strftime` method. The ISO 8601 year and ISO 8601 week " +"directives are not interchangeable with the year and week number directives " +"above. Calling :meth:`~.datetime.strptime` with incomplete or ambiguous ISO " +"8601 directives will raise a :exc:`ValueError`." msgstr "" msgid "" @@ -3325,8 +3324,8 @@ msgstr "" msgid "" "Broadly speaking, ``d.strftime(fmt)`` acts like the :mod:`time` module's " -"``time.strftime(fmt, d.timetuple())`` although not all objects support a :" -"meth:`~date.timetuple` method." +"``time.strftime(fmt, d.timetuple())`` although not all objects support " +"a :meth:`~date.timetuple` method." msgstr "" msgid "" @@ -3349,6 +3348,14 @@ msgid "" "year to partial date strings before parsing." msgstr "" +msgid "" +"If a :meth:`~.datetime.strptime` format string contains more than one " +"directive for the same field, for example both ``%Y`` and ``%y``, every " +"directive must still match the input, but only the value of the last one is " +"used. For example, parsing ``200099`` with ``%Y%y`` gives the year 1999. " +"Repeating the same directive, like ``%Y%Y``, raises an error." +msgstr "" + msgid "" ">>> import datetime as dt\n" ">>> value = \"2/29\"\n" @@ -3385,8 +3392,8 @@ msgid "" "For the same reason, handling of format strings containing Unicode code " "points that can't be represented in the charset of the current locale is " "also platform-dependent. On some platforms such code points are preserved " -"intact in the output, while on others ``strftime`` may raise :exc:" -"`UnicodeError` or return an empty string instead." +"intact in the output, while on others ``strftime`` may " +"raise :exc:`UnicodeError` or return an empty string instead." msgstr "" msgid "" @@ -3445,9 +3452,9 @@ msgid "" "seconds and ``ffffff`` is a 6-digit string giving the number of UTC offset " "microseconds. The ``ffffff`` part is omitted when the offset is a whole " "number of seconds and both the ``ffffff`` and the ``SS`` part is omitted " -"when the offset is a whole number of minutes. For example, if :meth:`~." -"datetime.utcoffset` returns ``timedelta(hours=-3, minutes=-30)``, ``%z`` is " -"replaced with the string ``'-0330'``." +"when the offset is a whole number of minutes. For example, " +"if :meth:`~.datetime.utcoffset` returns ``timedelta(hours=-3, " +"minutes=-30)``, ``%z`` is replaced with the string ``'-0330'``." msgstr "" msgid "" @@ -3464,9 +3471,9 @@ msgid "" msgstr "" msgid "" -"In :meth:`~.datetime.strftime`, ``%Z`` is replaced by an empty string if :" -"meth:`~.datetime.tzname` returns ``None``; otherwise ``%Z`` is replaced by " -"the returned value, which must be a string." +"In :meth:`~.datetime.strftime`, ``%Z`` is replaced by an empty string " +"if :meth:`~.datetime.tzname` returns ``None``; otherwise ``%Z`` is replaced " +"by the returned value, which must be a string." msgstr "" msgid ":meth:`~.datetime.strptime` only accepts certain values for ``%Z``:" @@ -3498,9 +3505,9 @@ msgstr "" msgid "" "Similar to ``%U`` and ``%W``, ``%V`` is only used in calculations when the " -"day of the week and the ISO year (``%G``) are specified in a :meth:`~." -"datetime.strptime` format string. Also note that ``%G`` and ``%Y`` are not " -"interchangeable." +"day of the week and the ISO year (``%G``) are specified in " +"a :meth:`~.datetime.strptime` format string. Also note that ``%G`` and " +"``%Y`` are not interchangeable." msgstr "" msgid "" diff --git a/library/dbm.po b/library/dbm.po index 30318d8d56..feed95b8d8 100644 --- a/library/dbm.po +++ b/library/dbm.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -55,8 +55,8 @@ msgstr "" msgid "" "This function attempts to guess which of the several simple database modules " -"available --- :mod:`dbm.sqlite3`, :mod:`dbm.gnu`, :mod:`dbm.ndbm`, or :mod:" -"`dbm.dumb` --- should be used to open a given file." +"available --- :mod:`dbm.sqlite3`, :mod:`dbm.gnu`, :mod:`dbm.ndbm`, " +"or :mod:`dbm.dumb` --- should be used to open a given file." msgstr "" msgid "Return one of the following values:" @@ -84,10 +84,10 @@ msgid "Parameters" msgstr "parametry" msgid "" -"The database file to open. If the database file already exists, the :func:" -"`whichdb` function is used to determine its type and the appropriate module " -"is used; if it does not exist, the first submodule listed above that can be " -"imported is used." +"The database file to open. If the database file already exists, " +"the :func:`whichdb` function is used to determine its type and the " +"appropriate module is used; if it does not exist, the first submodule listed " +"above that can be imported is used." msgstr "" msgid "The database file to open." @@ -134,7 +134,8 @@ msgstr "" msgid "" "Key and values are always stored as :class:`bytes`. This means that when " "strings are used they are implicitly converted to the default encoding " -"before being stored." +"before being stored. For detailed information about accepted types, " +"see :ref:`dbm-key-value-types`." msgstr "" msgid "" @@ -143,8 +144,8 @@ msgid "" msgstr "" msgid "" -":meth:`!get` and :meth:`!setdefault` methods are now available for all :mod:" -"`!dbm` backends." +":meth:`!get` and :meth:`!setdefault` methods are now available for " +"all :mod:`!dbm` backends." msgstr "" msgid "" @@ -160,6 +161,77 @@ msgstr "" msgid ":meth:`!clear` methods are now available for all :mod:`!dbm` backends." msgstr "" +msgid "Key and value types" +msgstr "" + +msgid "" +"The accepted types for keys and values vary by backend. Keys and values are " +"handled the same way, except where noted below:" +msgstr "" + +msgid "**Traditional backends:**" +msgstr "" + +msgid "" +":mod:`dbm.gnu` and :mod:`dbm.ndbm`: Accept :class:`str` and :class:`bytes` " +"objects." +msgstr "" + +msgid "" +":mod:`dbm.dumb`: Accepts :class:`str` and :class:`bytes` " +"objects; :class:`bytearray` is acceptable as a value, but not as a key." +msgstr "" + +msgid "" +"**SQLite backend** (:mod:`dbm.sqlite3`): " +"Accepts :class:`str`, :class:`bytes`, :class:`int`, :class:`float`, :class:`bool`, :class:`bytearray`, :class:`memoryview`, " +"and :class:`array.array` objects." +msgstr "" + +msgid "**Storage format:**" +msgstr "" + +msgid "" +"All keys and values are stored as :class:`bytes` objects in the database. " +"When retrieving, you'll always get bytes back, regardless of the original " +"type stored." +msgstr "" + +msgid "**Type conversion examples:**" +msgstr "" + +msgid "``db['key'] = 'string'`` stored as ``b'string'``" +msgstr "" + +msgid "" +"``db['key'] = bytearray(b'data')`` stored as ``b'data'`` (:mod:`dbm.dumb` " +"and :mod:`dbm.sqlite3` only)" +msgstr "" + +msgid "``db['key'] = 42`` stored as ``b'42'`` (:mod:`dbm.sqlite3` only)" +msgstr "" + +msgid "``db['key'] = 3.14`` stored as ``b'3.14'`` (:mod:`dbm.sqlite3` only)" +msgstr "" + +msgid "``db['key'] = True`` stored as ``b'1'`` (:mod:`dbm.sqlite3` only)" +msgstr "" + +msgid "``db['key'] = False`` stored as ``b'0'`` (:mod:`dbm.sqlite3` only)" +msgstr "" + +msgid "" +"``db['key'] = memoryview(b'data')`` stored as ``b'data'`` " +"(:mod:`dbm.sqlite3` only)" +msgstr "" + +msgid "" +"``db['key'] = array.array('i', [1, 2, 3])`` stored as bytes (for example, on " +"little-endian: " +"``b'\\x01\\x00\\x00\\x00\\x02\\x00\\x00\\x00\\x03\\x00\\x00\\x00'``) " +"(:mod:`dbm.sqlite3` only)" +msgstr "" + msgid "" "The following example records some hostnames and a corresponding title, and " "then prints out the contents of the database::" @@ -184,8 +256,9 @@ msgid "" " # Often-used methods of the dict interface work too.\n" " print(db.get('python.org', b'not present'))\n" "\n" -" # Storing a non-string key or value will raise an exception (most\n" -" # likely a TypeError).\n" +" # Storing a non-string key or value behavior depends on the backend:\n" +" # - Traditional backends (ndbm, gnu, dumb) will raise a TypeError\n" +" # - The sqlite3 backend accepts it and converts to bytes\n" " db['www.yahoo.com'] = 4\n" "\n" "# db is automatically closed when leaving the with statement." @@ -208,9 +281,9 @@ msgstr "**Kod źródłowy:** :source:`Lib/dbm/sqlite3.py`" msgid "" "This module uses the standard library :mod:`sqlite3` module to provide an " -"SQLite backend for the :mod:`!dbm` module. The files created by :mod:`!dbm." -"sqlite3` can thus be opened by :mod:`sqlite3`, or any other SQLite browser, " -"including the SQLite CLI." +"SQLite backend for the :mod:`!dbm` module. The files created by :mod:`!" +"dbm.sqlite3` can thus be opened by :mod:`sqlite3`, or any other SQLite " +"browser, including the SQLite CLI." msgstr "" msgid "Availability" @@ -268,9 +341,9 @@ msgid "" msgstr "" msgid "" -"Raised on :mod:`!dbm.gnu`-specific errors, such as I/O errors. :exc:" -"`KeyError` is raised for general mapping errors like specifying an incorrect " -"key." +"Raised on :mod:`!dbm.gnu`-specific errors, such as I/O " +"errors. :exc:`KeyError` is raised for general mapping errors like specifying " +"an incorrect key." msgstr "" msgid "" @@ -363,10 +436,10 @@ msgstr "" msgid "" "If you have carried out a lot of deletions and would like to shrink the " -"space used by the GDBM file, this routine will reorganize the database. :" -"class:`!gdbm` objects will not shorten the length of a database file except " -"by using this reorganization; otherwise, deleted file space will be kept and " -"reused as new (key, value) pairs are added." +"space used by the GDBM file, this routine will reorganize the " +"database. :class:`!gdbm` objects will not shorten the length of a database " +"file except by using this reorganization; otherwise, deleted file space will " +"be kept and reused as new (key, value) pairs are added." msgstr "" msgid "" @@ -399,9 +472,9 @@ msgid "" msgstr "" msgid "" -"Raised on :mod:`!dbm.ndbm`-specific errors, such as I/O errors. :exc:" -"`KeyError` is raised for general mapping errors like specifying an incorrect " -"key." +"Raised on :mod:`!dbm.ndbm`-specific errors, such as I/O " +"errors. :exc:`KeyError` is raised for general mapping errors like specifying " +"an incorrect key." msgstr "" msgid "Name of the NDBM implementation library used." @@ -436,10 +509,10 @@ msgid "**Source code:** :source:`Lib/dbm/dumb.py`" msgstr "**Kod źródłowy:** :source:`Lib/dbm/dumb.py`" msgid "" -"The :mod:`!dbm.dumb` module is intended as a last resort fallback for the :" -"mod:`!dbm` module when a more robust module is not available. The :mod:`!dbm." -"dumb` module is not written for speed and is not nearly as heavily used as " -"the other database modules." +"The :mod:`!dbm.dumb` module is intended as a last resort fallback for " +"the :mod:`!dbm` module when a more robust module is not available. " +"The :mod:`!dbm.dumb` module is not written for speed and is not nearly as " +"heavily used as the other database modules." msgstr "" msgid "" @@ -452,9 +525,9 @@ msgid "The :mod:`!dbm.dumb` module defines the following:" msgstr "" msgid "" -"Raised on :mod:`!dbm.dumb`-specific errors, such as I/O errors. :exc:" -"`KeyError` is raised for general mapping errors like specifying an incorrect " -"key." +"Raised on :mod:`!dbm.dumb`-specific errors, such as I/O " +"errors. :exc:`KeyError` is raised for general mapping errors like " +"specifying an incorrect key." msgstr "" msgid "Open a :mod:`!dbm.dumb` database." @@ -462,8 +535,8 @@ msgstr "" msgid "" "The basename of the database file (without extensions). A new database " -"creates the following files: - :file:`{filename}.dat` - :file:`{filename}." -"dir`" +"creates the following files: - :file:`{filename}.dat` " +"- :file:`{filename}.dir`" msgstr "" msgid "" @@ -505,9 +578,9 @@ msgstr "" msgid "" "The returned database object behaves similar to a mutable :term:`mapping`, " -"but the :meth:`!keys` and :meth:`!items` methods return lists, and the :meth:" -"`!setdefault` method requires two arguments. It also supports a \"closing\" " -"context manager via the :keyword:`with` keyword." +"but the :meth:`!keys` and :meth:`!items` methods return lists, and " +"the :meth:`!setdefault` method requires two arguments. It also supports a " +"\"closing\" context manager via the :keyword:`with` keyword." msgstr "" msgid "Close the database." diff --git a/library/debug.po b/library/debug.po index b7204e97f0..d238de4e82 100644 --- a/library/debug.po +++ b/library/debug.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/decimal.po b/library/decimal.po index 287e372489..ba1b2cd6d8 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,8 +31,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/decimal.py`" msgid "" "The :mod:`!decimal` module provides support for fast correctly rounded " -"decimal floating-point arithmetic. It offers several advantages over the :" -"class:`float` datatype:" +"decimal floating-point arithmetic. It offers several advantages over " +"the :class:`float` datatype:" msgstr "" msgid "" @@ -107,19 +107,18 @@ msgid "" "The context for arithmetic is an environment specifying precision, rounding " "rules, limits on exponents, flags indicating the results of operations, and " "trap enablers which determine whether signals are treated as exceptions. " -"Rounding options include :const:`ROUND_CEILING`, :const:`ROUND_DOWN`, :const:" -"`ROUND_FLOOR`, :const:`ROUND_HALF_DOWN`, :const:`ROUND_HALF_EVEN`, :const:" -"`ROUND_HALF_UP`, :const:`ROUND_UP`, and :const:`ROUND_05UP`." +"Rounding options " +"include :const:`ROUND_CEILING`, :const:`ROUND_DOWN`, :const:`ROUND_FLOOR`, :const:`ROUND_HALF_DOWN`, :const:`ROUND_HALF_EVEN`, :const:`ROUND_HALF_UP`, :const:`ROUND_UP`, " +"and :const:`ROUND_05UP`." msgstr "" msgid "" "Signals are groups of exceptional conditions arising during the course of " "computation. Depending on the needs of the application, signals may be " "ignored, considered as informational, or treated as exceptions. The signals " -"in the decimal module are: :const:`Clamped`, :const:`InvalidOperation`, :" -"const:`DivisionByZero`, :const:`Inexact`, :const:`Rounded`, :const:" -"`Subnormal`, :const:`Overflow`, :const:`Underflow` and :const:" -"`FloatOperation`." +"in the decimal module " +"are: :const:`Clamped`, :const:`InvalidOperation`, :const:`DivisionByZero`, :const:`Inexact`, :const:`Rounded`, :const:`Subnormal`, :const:`Overflow`, :const:`Underflow` " +"and :const:`FloatOperation`." msgstr "" msgid "" @@ -305,15 +304,15 @@ msgstr "" msgid "" "For more advanced work, it may be useful to create alternate contexts using " -"the :meth:`Context` constructor. To make an alternate active, use the :func:" -"`setcontext` function." +"the :meth:`Context` constructor. To make an alternate active, use " +"the :func:`setcontext` function." msgstr "" msgid "" "In accordance with the standard, the :mod:`!decimal` module provides two " -"ready to use standard contexts, :const:`BasicContext` and :const:" -"`ExtendedContext`. The former is especially useful for debugging because " -"many of the traps are enabled:" +"ready to use standard contexts, :const:`BasicContext` " +"and :const:`ExtendedContext`. The former is especially useful for debugging " +"because many of the traps are enabled:" msgstr "" msgid "" @@ -394,11 +393,11 @@ msgid "Construct a new :class:`Decimal` object based from *value*." msgstr "" msgid "" -"*value* can be an integer, string, tuple, :class:`float`, or another :class:" -"`Decimal` object. If no *value* is given, returns ``Decimal('0')``. If " -"*value* is a string, it should conform to the decimal numeric string syntax " -"after leading and trailing whitespace characters, as well as underscores " -"throughout, are removed::" +"*value* can be an integer, string, tuple, :class:`float`, or " +"another :class:`Decimal` object. If no *value* is given, returns " +"``Decimal('0')``. If *value* is a string, it should conform to the decimal " +"numeric string syntax after leading and trailing whitespace characters, as " +"well as underscores throughout, are removed::" msgstr "" msgid "" @@ -476,8 +475,8 @@ msgid "" "numeric types such as :class:`float` and :class:`int`. All of the usual " "math operations and special methods apply. Likewise, decimal objects can be " "copied, pickled, printed, used as dictionary keys, used as set elements, " -"compared, sorted, and coerced to another type (such as :class:`float` or :" -"class:`int`)." +"compared, sorted, and coerced to another type (such as :class:`float` " +"or :class:`int`)." msgstr "" msgid "" @@ -521,13 +520,13 @@ msgid "" msgstr "" msgid "" -"Decimal objects cannot generally be combined with floats or instances of :" -"class:`fractions.Fraction` in arithmetic operations: an attempt to add a :" -"class:`Decimal` to a :class:`float`, for example, will raise a :exc:" -"`TypeError`. However, it is possible to use Python's comparison operators " -"to compare a :class:`Decimal` instance ``x`` with another number ``y``. " -"This avoids confusing results when doing equality comparisons between " -"numbers of different types." +"Decimal objects cannot generally be combined with floats or instances " +"of :class:`fractions.Fraction` in arithmetic operations: an attempt to add " +"a :class:`Decimal` to a :class:`float`, for example, will raise " +"a :exc:`TypeError`. However, it is possible to use Python's comparison " +"operators to compare a :class:`Decimal` instance ``x`` with another number " +"``y``. This avoids confusing results when doing equality comparisons " +"between numbers of different types." msgstr "" msgid "" @@ -548,9 +547,9 @@ msgid "" msgstr "" msgid "" -"Return a pair ``(n, d)`` of integers that represent the given :class:" -"`Decimal` instance as a fraction, in lowest terms and with a positive " -"denominator::" +"Return a pair ``(n, d)`` of integers that represent the " +"given :class:`Decimal` instance as a fraction, in lowest terms and with a " +"positive denominator::" msgstr "" msgid "" @@ -620,8 +619,8 @@ msgstr "" msgid "" "Compare two operands using their abstract representation rather than their " "value as in :meth:`compare_total`, but ignoring the sign of each operand. " -"``x.compare_total_mag(y)`` is equivalent to ``x.copy_abs().compare_total(y." -"copy_abs())``." +"``x.compare_total_mag(y)`` is equivalent to " +"``x.copy_abs().compare_total(y.copy_abs())``." msgstr "" msgid "" @@ -651,8 +650,8 @@ msgid "" msgstr "" msgid "" -"Alternative constructor that only accepts instances of :class:`float` or :" -"class:`int`." +"Alternative constructor that only accepts instances of :class:`float` " +"or :class:`int`." msgstr "" msgid "" @@ -688,8 +687,9 @@ msgstr "" "Decimal('-Infinity')" msgid "" -"Alternative constructor that only accepts instances of :class:`float`, :" -"class:`int` or :class:`Decimal`, but not strings or tuples." +"Alternative constructor that only accepts instances " +"of :class:`float`, :class:`int` or :class:`Decimal`, but not strings or " +"tuples." msgstr "" msgid "" @@ -723,13 +723,13 @@ msgid "" msgstr "" msgid "" -"Return :const:`True` if the argument is a (quiet or signaling) NaN and :" -"const:`False` otherwise." +"Return :const:`True` if the argument is a (quiet or signaling) NaN " +"and :const:`False` otherwise." msgstr "" msgid "" -"Return :const:`True` if the argument is a *normal* finite number. Return :" -"const:`False` if the argument is zero, subnormal, infinite or a NaN." +"Return :const:`True` if the argument is a *normal* finite number. " +"Return :const:`False` if the argument is zero, subnormal, infinite or a NaN." msgstr "" msgid "" @@ -753,8 +753,8 @@ msgid "" msgstr "" msgid "" -"Return :const:`True` if the argument is a (positive or negative) zero and :" -"const:`False` otherwise." +"Return :const:`True` if the argument is a (positive or negative) zero " +"and :const:`False` otherwise." msgstr "" msgid "" @@ -768,8 +768,8 @@ msgid "" msgstr "" msgid "" -"For a nonzero number, return the adjusted exponent of its operand as a :" -"class:`Decimal` instance. If the operand is a zero then ``Decimal('-" +"For a nonzero number, return the adjusted exponent of its operand as " +"a :class:`Decimal` instance. If the operand is a zero then ``Decimal('-" "Infinity')`` is returned and the :const:`DivisionByZero` flag is raised. If " "the operand is an infinity then ``Decimal('Infinity')`` is returned." msgstr "" @@ -930,8 +930,8 @@ msgid "" msgstr "" msgid "" -"An error is returned whenever the resulting exponent is greater than :attr:" -"`~Context.Emax` or less than :meth:`~Context.Etiny`." +"An error is returned whenever the resulting exponent is greater " +"than :attr:`~Context.Emax` or less than :meth:`~Context.Etiny`." msgstr "" msgid "" @@ -1012,9 +1012,9 @@ msgid "" msgstr "" msgid "" -"Round to the nearest integer without signaling :const:`Inexact` or :const:" -"`Rounded`. If given, applies *rounding*; otherwise, uses the rounding " -"method in either the supplied *context* or the current context." +"Round to the nearest integer without signaling :const:`Inexact` " +"or :const:`Rounded`. If given, applies *rounding*; otherwise, uses the " +"rounding method in either the supplied *context* or the current context." msgstr "" msgid "Decimal numbers can be rounded using the :func:`.round` function:" @@ -1022,8 +1022,8 @@ msgstr "" msgid "" "If *ndigits* is not given or ``None``, returns the nearest :class:`int` to " -"*number*, rounding ties to even, and ignoring the rounding mode of the :" -"class:`Decimal` context. Raises :exc:`OverflowError` if *number* is an " +"*number*, rounding ties to even, and ignoring the rounding mode of " +"the :class:`Decimal` context. Raises :exc:`OverflowError` if *number* is an " "infinity or :exc:`ValueError` if it is a (quiet or signaling) NaN." msgstr "" @@ -1032,10 +1032,11 @@ msgid "" "and a :class:`Decimal` representing *number* rounded to the nearest multiple " "of ``Decimal('1E-ndigits')`` is returned; in this case, ``round(number, " "ndigits)`` is equivalent to ``self.quantize(Decimal('1E-ndigits'))``. " -"Returns ``Decimal('NaN')`` if *number* is a quiet NaN. Raises :class:" -"`InvalidOperation` if *number* is an infinity, a signaling NaN, or if the " -"length of the coefficient after the quantize operation would be greater than " -"the current context's precision. In other words, for the non-corner cases:" +"Returns ``Decimal('NaN')`` if *number* is a quiet NaN. " +"Raises :class:`InvalidOperation` if *number* is an infinity, a signaling " +"NaN, or if the length of the coefficient after the quantize operation would " +"be greater than the current context's precision. In other words, for the " +"non-corner cases:" msgstr "" msgid "" @@ -1073,11 +1074,11 @@ msgid "Logical operands" msgstr "" msgid "" -"The :meth:`~Decimal.logical_and`, :meth:`~Decimal.logical_invert`, :meth:" -"`~Decimal.logical_or`, and :meth:`~Decimal.logical_xor` methods expect their " -"arguments to be *logical operands*. A *logical operand* is a :class:" -"`Decimal` instance whose exponent and sign are both zero, and whose digits " -"are all either ``0`` or ``1``." +"The :meth:`~Decimal.logical_and`, :meth:`~Decimal.logical_invert`, :meth:`~Decimal.logical_or`, " +"and :meth:`~Decimal.logical_xor` methods expect their arguments to be " +"*logical operands*. A *logical operand* is a :class:`Decimal` instance " +"whose exponent and sign are both zero, and whose digits are all either ``0`` " +"or ``1``." msgstr "" msgid "Context objects" @@ -1140,9 +1141,9 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`TypeError` if *kwargs* supplies an attribute that :class:" -"`Context` doesn't support. Raises either :exc:`TypeError` or :exc:" -"`ValueError` if *kwargs* supplies an invalid value for an attribute." +"Raises :exc:`TypeError` if *kwargs* supplies an attribute " +"that :class:`Context` doesn't support. Raises either :exc:`TypeError` " +"or :exc:`ValueError` if *kwargs* supplies an invalid value for an attribute." msgstr "" msgid "" @@ -1152,8 +1153,8 @@ msgstr "" msgid "" "Return a context object initialized to the proper values for one of the IEEE " -"interchange formats. The argument must be a multiple of 32 and less than :" -"const:`IEEE_CONTEXT_MAX_BITS`." +"interchange formats. The argument must be a multiple of 32 and less " +"than :const:`IEEE_CONTEXT_MAX_BITS`." msgstr "" msgid "" @@ -1163,10 +1164,10 @@ msgstr "" msgid "" "This is a standard context defined by the General Decimal Arithmetic " -"Specification. Precision is set to nine. Rounding is set to :const:" -"`ROUND_HALF_UP`. All flags are cleared. All traps are enabled (treated as " -"exceptions) except :const:`Inexact`, :const:`Rounded`, and :const:" -"`Subnormal`." +"Specification. Precision is set to nine. Rounding is set " +"to :const:`ROUND_HALF_UP`. All flags are cleared. All traps are enabled " +"(treated as exceptions) except :const:`Inexact`, :const:`Rounded`, " +"and :const:`Subnormal`." msgstr "" msgid "" @@ -1175,9 +1176,9 @@ msgstr "" msgid "" "This is a standard context defined by the General Decimal Arithmetic " -"Specification. Precision is set to nine. Rounding is set to :const:" -"`ROUND_HALF_EVEN`. All flags are cleared. No traps are enabled (so that " -"exceptions are not raised during computations)." +"Specification. Precision is set to nine. Rounding is set " +"to :const:`ROUND_HALF_EVEN`. All flags are cleared. No traps are enabled " +"(so that exceptions are not raised during computations)." msgstr "" msgid "" @@ -1207,9 +1208,10 @@ msgid "" msgstr "" msgid "" -"The default values are :attr:`Context.prec`\\ =\\ ``28``, :attr:`Context." -"rounding`\\ =\\ :const:`ROUND_HALF_EVEN`, and enabled traps for :class:" -"`Overflow`, :class:`InvalidOperation`, and :class:`DivisionByZero`." +"The default values are :attr:`Context.prec`\\ =\\ " +"``28``, :attr:`Context.rounding`\\ =\\ :const:`ROUND_HALF_EVEN`, and enabled " +"traps for :class:`Overflow`, :class:`InvalidOperation`, " +"and :class:`DivisionByZero`." msgstr "" msgid "" @@ -1238,8 +1240,8 @@ msgstr "" msgid "" "Integers specifying the outer limits allowable for exponents. *Emin* must be " -"in the range [:const:`MIN_EMIN`, ``0``], *Emax* in the range [``0``, :const:" -"`MAX_EMAX`]." +"in the range [:const:`MIN_EMIN`, ``0``], *Emax* in the range " +"[``0``, :const:`MAX_EMAX`]." msgstr "" msgid "" @@ -1252,12 +1254,13 @@ msgid "" "Either ``0`` (the default) or ``1``. If set to ``1``, the exponent ``e`` of " "a :class:`Decimal` instance representable in this context is strictly " "limited to the range ``Emin - prec + 1 <= e <= Emax - prec + 1``. If *clamp* " -"is ``0`` then a weaker condition holds: the adjusted exponent of the :class:" -"`Decimal` instance is at most :attr:`~Context.Emax`. When *clamp* is ``1``, " -"a large normal number will, where possible, have its exponent reduced and a " -"corresponding number of zeros added to its coefficient, in order to fit the " -"exponent constraints; this preserves the value of the number but loses " -"information about significant trailing zeros. For example::" +"is ``0`` then a weaker condition holds: the adjusted exponent of " +"the :class:`Decimal` instance is at most :attr:`~Context.Emax`. When " +"*clamp* is ``1``, a large normal number will, where possible, have its " +"exponent reduced and a corresponding number of zeros added to its " +"coefficient, in order to fit the exponent constraints; this preserves the " +"value of the number but loses information about significant trailing zeros. " +"For example::" msgstr "" msgid "" @@ -1276,12 +1279,13 @@ msgid "" "The :class:`Context` class defines several general purpose methods as well " "as a large number of methods for doing arithmetic directly in a given " "context. In addition, for each of the :class:`Decimal` methods described " -"above (with the exception of the :meth:`~Decimal.adjusted` and :meth:" -"`~Decimal.as_tuple` methods) there is a corresponding :class:`Context` " -"method. For example, for a :class:`Context` instance ``C`` and :class:" -"`Decimal` instance ``x``, ``C.exp(x)`` is equivalent to ``x." -"exp(context=C)``. Each :class:`Context` method accepts a Python integer (an " -"instance of :class:`int`) anywhere that a Decimal instance is accepted." +"above (with the exception of the :meth:`~Decimal.adjusted` " +"and :meth:`~Decimal.as_tuple` methods) there is a " +"corresponding :class:`Context` method. For example, for a :class:`Context` " +"instance ``C`` and :class:`Decimal` instance ``x``, ``C.exp(x)`` is " +"equivalent to ``x.exp(context=C)``. Each :class:`Context` method accepts a " +"Python integer (an instance of :class:`int`) anywhere that a Decimal " +"instance is accepted." msgstr "" msgid "Resets all of the flags to ``0``." @@ -1344,8 +1348,8 @@ msgstr "" msgid "" "Returns a value equal to ``Emin - prec + 1`` which is the minimum exponent " -"value for subnormal results. When underflow occurs, the exponent is set to :" -"const:`Etiny`." +"value for subnormal results. When underflow occurs, the exponent is set " +"to :const:`Etiny`." msgstr "" msgid "Returns a value equal to ``Emax - prec + 1``." @@ -1512,9 +1516,9 @@ msgid "" msgstr "" msgid "" -"The C module computes :meth:`power` in terms of the correctly rounded :meth:" -"`exp` and :meth:`ln` functions. The result is well-defined but only \"almost " -"always correctly rounded\"." +"The C module computes :meth:`power` in terms of the correctly " +"rounded :meth:`exp` and :meth:`ln` functions. The result is well-defined but " +"only \"almost always correctly rounded\"." msgstr "" msgid "" @@ -1681,18 +1685,18 @@ msgstr "" msgid "" "If the context's trap enabler is set for the signal, then the condition " -"causes a Python exception to be raised. For example, if the :class:" -"`DivisionByZero` trap is set, then a :exc:`DivisionByZero` exception is " -"raised upon encountering the condition." +"causes a Python exception to be raised. For example, if " +"the :class:`DivisionByZero` trap is set, then a :exc:`DivisionByZero` " +"exception is raised upon encountering the condition." msgstr "" msgid "Altered an exponent to fit representation constraints." msgstr "" msgid "" -"Typically, clamping occurs when an exponent falls outside the context's :" -"attr:`~Context.Emin` and :attr:`~Context.Emax` limits. If possible, the " -"exponent is reduced to fit by adding zeros to the coefficient." +"Typically, clamping occurs when an exponent falls outside the " +"context's :attr:`~Context.Emin` and :attr:`~Context.Emax` limits. If " +"possible, the exponent is reduced to fit by adding zeros to the coefficient." msgstr "" msgid "Base class for other signals and a subclass of :exc:`ArithmeticError`." @@ -1743,8 +1747,8 @@ msgid "" "Indicates the exponent is larger than :attr:`Context.Emax` after rounding " "has occurred. If not trapped, the result depends on the rounding mode, " "either pulling inward to the largest representable finite number or rounding " -"outward to ``Infinity``. In either case, :class:`Inexact` and :class:" -"`Rounded` are also signaled." +"outward to ``Infinity``. In either case, :class:`Inexact` " +"and :class:`Rounded` are also signaled." msgstr "" msgid "Rounding occurred though possibly no information was lost." @@ -1768,8 +1772,8 @@ msgid "Numerical underflow with result rounded to zero." msgstr "" msgid "" -"Occurs when a subnormal result is pushed to zero by rounding. :class:" -"`Inexact` and :class:`Subnormal` are also signaled." +"Occurs when a subnormal result is pushed to zero by " +"rounding. :class:`Inexact` and :class:`Subnormal` are also signaled." msgstr "" msgid "Enable stricter semantics for mixing floats and Decimals." @@ -1777,18 +1781,18 @@ msgstr "" msgid "" "If the signal is not trapped (default), mixing floats and Decimals is " -"permitted in the :class:`~decimal.Decimal` constructor, :meth:`~decimal." -"Context.create_decimal` and all comparison operators. Both conversion and " -"comparisons are exact. Any occurrence of a mixed operation is silently " -"recorded by setting :exc:`FloatOperation` in the context flags. Explicit " -"conversions with :meth:`~decimal.Decimal.from_float` or :meth:`~decimal." -"Context.create_decimal_from_float` do not set the flag." +"permitted in the :class:`~decimal.Decimal` " +"constructor, :meth:`~decimal.Context.create_decimal` and all comparison " +"operators. Both conversion and comparisons are exact. Any occurrence of a " +"mixed operation is silently recorded by setting :exc:`FloatOperation` in the " +"context flags. Explicit conversions with :meth:`~decimal.Decimal.from_float` " +"or :meth:`~decimal.Context.create_decimal_from_float` do not set the flag." msgstr "" msgid "" "Otherwise (the signal is trapped), only equality comparisons and explicit " -"conversions are silent. All other mixed operations raise :exc:" -"`FloatOperation`." +"conversions are silent. All other mixed operations " +"raise :exc:`FloatOperation`." msgstr "" msgid "The following table summarizes the hierarchy of signals::" @@ -1891,10 +1895,10 @@ msgid "" msgstr "" msgid "" -"Some operations are indeterminate and return ``NaN``, or if the :exc:" -"`InvalidOperation` signal is trapped, raise an exception. For example, " -"``0/0`` returns ``NaN`` which means \"not a number\". This variety of " -"``NaN`` is quiet and, once created, will flow through other computations " +"Some operations are indeterminate and return ``NaN``, or if " +"the :exc:`InvalidOperation` signal is trapped, raise an exception. For " +"example, ``0/0`` returns ``NaN`` which means \"not a number\". This variety " +"of ``NaN`` is quiet and, once created, will flow through other computations " "always resulting in another ``NaN``. This behavior can be useful for a " "series of computations that occasionally have missing inputs --- it allows " "the calculation to proceed while flagging specific results as invalid." @@ -1912,14 +1916,14 @@ msgid "" "is a quiet or signaling ``NaN`` always returns :const:`False` (even when " "doing ``Decimal('NaN')==Decimal('NaN')``), while a test for inequality " "always returns :const:`True`. An attempt to compare two Decimals using any " -"of the ``<``, ``<=``, ``>`` or ``>=`` operators will raise the :exc:" -"`InvalidOperation` signal if either operand is a ``NaN``, and return :const:" -"`False` if this signal is not trapped. Note that the General Decimal " -"Arithmetic specification does not specify the behavior of direct " +"of the ``<``, ``<=``, ``>`` or ``>=`` operators will raise " +"the :exc:`InvalidOperation` signal if either operand is a ``NaN``, and " +"return :const:`False` if this signal is not trapped. Note that the General " +"Decimal Arithmetic specification does not specify the behavior of direct " "comparisons; these rules for comparisons involving a ``NaN`` were taken from " "the IEEE 854 standard (see Table 3 in section 5.7). To ensure strict " -"standards-compliance, use the :meth:`~Decimal.compare` and :meth:`~Decimal." -"compare_signal` methods instead." +"standards-compliance, use the :meth:`~Decimal.compare` " +"and :meth:`~Decimal.compare_signal` methods instead." msgstr "" msgid "" @@ -1953,10 +1957,10 @@ msgid "" msgstr "" msgid "" -"If :func:`setcontext` has not been called before :func:`getcontext`, then :" -"func:`getcontext` will automatically create a new context for use in the " -"current thread. New context objects have default values set from the :data:" -"`decimal.DefaultContext` object." +"If :func:`setcontext` has not been called before :func:`getcontext`, " +"then :func:`getcontext` will automatically create a new context for use in " +"the current thread. New context objects have default values set from " +"the :data:`decimal.DefaultContext` object." msgstr "" msgid "" @@ -1964,8 +1968,8 @@ msgid "" "new threads. If the flag is false, new threads will start with an empty " "context. In this case, :func:`getcontext` will create a new context object " "when called and use the default values from *DefaultContext*. If the flag " -"is true, new threads will start with a copy of context from the caller of :" -"meth:`threading.Thread.start`." +"is true, new threads will start with a copy of context from the caller " +"of :meth:`threading.Thread.start`." msgstr "" msgid "" @@ -2219,7 +2223,7 @@ msgid "" "Decimal('3.1416')\n" ">>> pi - Decimal('0.00005') # Subtract unrounded numbers, then round\n" "Decimal('3.1415')\n" -">>> pi + 0 - Decimal('0.00005'). # Intermediate values are rounded\n" +">>> pi + 0 - Decimal('0.00005') # Intermediate values are rounded\n" "Decimal('3.1416')" msgstr "" @@ -2306,8 +2310,8 @@ msgstr "" "Decimal('1.23')" msgid "" -"Alternatively, inputs can be rounded upon creation using the :meth:`Context." -"create_decimal` method:" +"Alternatively, inputs can be rounded upon creation using " +"the :meth:`Context.create_decimal` method:" msgstr "" msgid "Q: Is the CPython implementation fast for large numbers?" @@ -2315,10 +2319,10 @@ msgstr "" msgid "" "A: Yes. In the CPython and PyPy3 implementations, the C/CFFI versions of " -"the decimal module integrate the high speed `libmpdec `_ library for arbitrary precision " -"correctly rounded decimal floating-point arithmetic [#]_. ``libmpdec`` uses " -"`Karatsuba multiplication `_ library for arbitrary " +"precision correctly rounded decimal floating-point arithmetic [#]_. " +"``libmpdec`` uses `Karatsuba multiplication `_ for medium-sized numbers and the `Number Theoretic " "Transform `_ for very " @@ -2326,10 +2330,10 @@ msgid "" msgstr "" msgid "" -"The context must be adapted for exact arbitrary precision arithmetic. :attr:" -"`~Context.Emin` and :attr:`~Context.Emax` should always be set to the " -"maximum values, :attr:`~Context.clamp` should always be 0 (the default). " -"Setting :attr:`~Context.prec` requires some care." +"The context must be adapted for exact arbitrary precision " +"arithmetic. :attr:`~Context.Emin` and :attr:`~Context.Emax` should always be " +"set to the maximum values, :attr:`~Context.clamp` should always be 0 (the " +"default). Setting :attr:`~Context.prec` requires some care." msgstr "" msgid "" diff --git a/library/devmode.po b/library/devmode.po index 8cd109861d..6eafd31acc 100644 --- a/library/devmode.po +++ b/library/devmode.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -83,9 +83,9 @@ msgid "" msgstr "" msgid "" -"Use the :option:`-W error <-W>` command line option or set the :envvar:" -"`PYTHONWARNINGS` environment variable to ``error`` to treat warnings as " -"errors." +"Use the :option:`-W error <-W>` command line option or set " +"the :envvar:`PYTHONWARNINGS` environment variable to ``error`` to treat " +"warnings as errors." msgstr "" msgid "Install debug hooks on memory allocators to check for:" @@ -119,9 +119,8 @@ msgstr "" msgid "" "Call :func:`faulthandler.enable` at Python startup to install handlers for " -"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal." -"SIGABRT`, :const:`~signal.SIGBUS` and :const:`~signal.SIGILL` signals to " -"dump the Python traceback on a crash." +"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS` " +"and :const:`~signal.SIGILL` signals to dump the Python traceback on a crash." msgstr "" msgid "" @@ -131,8 +130,9 @@ msgid "" msgstr "" msgid "" -"Enable :ref:`asyncio debug mode `. For example, :mod:" -"`asyncio` checks for coroutines that were not awaited and logs them." +"Enable :ref:`asyncio debug mode `. For " +"example, :mod:`asyncio` checks for coroutines that were not awaited and logs " +"them." msgstr "" msgid "" @@ -142,8 +142,8 @@ msgstr "" msgid "" "Check the *encoding* and *errors* arguments for string encoding and decoding " -"operations. Examples: :func:`open`, :meth:`str.encode` and :meth:`bytes." -"decode`." +"operations. Examples: :func:`open`, :meth:`str.encode` " +"and :meth:`bytes.decode`." msgstr "" msgid "" @@ -164,16 +164,16 @@ msgid "" "The Python Development Mode does not enable the :mod:`tracemalloc` module by " "default, because the overhead cost (to performance and memory) would be too " "large. Enabling the :mod:`tracemalloc` module provides additional " -"information on the origin of some errors. For example, :exc:" -"`ResourceWarning` logs the traceback where the resource was allocated, and a " -"buffer overflow error logs the traceback where the memory block was " -"allocated." +"information on the origin of some errors. For " +"example, :exc:`ResourceWarning` logs the traceback where the resource was " +"allocated, and a buffer overflow error logs the traceback where the memory " +"block was allocated." msgstr "" msgid "" "The Python Development Mode does not prevent the :option:`-O` command line " -"option from removing :keyword:`assert` statements nor from setting :const:" -"`__debug__` to ``False``." +"option from removing :keyword:`assert` statements nor from " +"setting :const:`__debug__` to ``False``." msgstr "" msgid "" @@ -230,8 +230,8 @@ msgstr "" msgid "" "$ python -X dev script.py README.txt\n" "269\n" -"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper name='README." -"rst' mode='r' encoding='UTF-8'>\n" +"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper " +"name='README.rst' mode='r' encoding='UTF-8'>\n" " main()\n" "ResourceWarning: Enable tracemalloc to get the object allocation traceback" msgstr "" @@ -244,8 +244,8 @@ msgstr "" msgid "" "$ python -X dev -X tracemalloc=5 script.py README.rst\n" "269\n" -"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper name='README." -"rst' mode='r' encoding='UTF-8'>\n" +"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper " +"name='README.rst' mode='r' encoding='UTF-8'>\n" " main()\n" "Object allocated at (most recent call last):\n" " File \"script.py\", lineno 10\n" @@ -310,8 +310,8 @@ msgstr "" msgid "" "$ python -X dev script.py\n" "import os\n" -"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper name='script." -"py' mode='r' encoding='UTF-8'>\n" +"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper " +"name='script.py' mode='r' encoding='UTF-8'>\n" " main()\n" "ResourceWarning: Enable tracemalloc to get the object allocation traceback\n" "Exception ignored in: <_io.TextIOWrapper name='script.py' mode='r' " @@ -326,8 +326,8 @@ msgid "" "``os.close(fp.fileno())`` closes the file descriptor. When the file object " "finalizer tries to close the file descriptor again, it fails with the ``Bad " "file descriptor`` error. A file descriptor must be closed only once. In the " -"worst case scenario, closing it twice can lead to a crash (see :issue:" -"`18748` for an example)." +"worst case scenario, closing it twice can lead to a crash " +"(see :issue:`18748` for an example)." msgstr "" msgid "" diff --git a/library/difflib.po b/library/difflib.po index ccf580b9fb..a1ddc61270 100644 --- a/library/difflib.po +++ b/library/difflib.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,48 +31,100 @@ msgid "**Source code:** :source:`Lib/difflib.py`" msgstr "**Kod źródłowy:** :source:`Lib/difflib.py`" msgid "" -"This module provides classes and functions for comparing sequences. It can " -"be used for example, for comparing files, and can produce information about " -"file differences in various formats, including HTML and context and unified " -"diffs. For comparing directories and files, see also, the :mod:`filecmp` " -"module." +"This module provides classes and functions for comparing sequences. Most of " +"them compare sequences of text lines (for example lists of strings, " +"or :term:`file objects `) and produce :dfn:`diffs` -- reports " +"on the differences. Diffs can be produced in various formats, including HTML " +"and context and unified diffs -- formats produced by tools " +"like :manpage:`diff ` and :manpage:`git diff `." msgstr "" msgid "" -"This is a flexible class for comparing pairs of sequences of any type, so " -"long as the sequence elements are :term:`hashable`. The basic algorithm " -"predates, and is a little fancier than, an algorithm published in the late " -"1980's by Ratcliff and Obershelp under the hyperbolic name \"gestalt pattern " -"matching.\" The idea is to find the longest contiguous matching subsequence " -"that contains no \"junk\" elements; these \"junk\" elements are ones that " -"are uninteresting in some sense, such as blank lines or whitespace. " -"(Handling junk is an extension to the Ratcliff and Obershelp algorithm.) The " -"same idea is then applied recursively to the pieces of the sequences to the " -"left and to the right of the matching subsequence. This does not yield " -"minimal edit sequences, but does tend to yield matches that \"look right\" " -"to people." +"Comparisons are done using a matching algorithm implemented " +"in :class:`SequenceMatcher` -- a flexible class for comparing pairs of " +"sequences of any type, not just text, so long as the sequence elements " +"are :term:`hashable`." +msgstr "" + +msgid "Junk heuristic" msgstr "" msgid "" -"**Timing:** The basic Ratcliff-Obershelp algorithm is cubic time in the " -"worst case and quadratic time in the expected case. :class:`SequenceMatcher` " -"is quadratic time for the worst case and has expected-case behavior " -"dependent in a complicated way on how many elements the sequences have in " -"common; best case time is linear." +":mod:`!difflib` uses a :dfn:`junk` heuristic: some items are deemed to " +"be :dfn:`junk`, and ignored when searching for similarities. Ideally, these " +"are uninteresting or common items, such as blank lines or whitespace." msgstr "" msgid "" -"**Automatic junk heuristic:** :class:`SequenceMatcher` supports a heuristic " -"that automatically treats certain sequence items as junk. The heuristic " -"counts how many times each individual item appears in the sequence. If an " -"item's duplicates (after the first one) account for more than 1% of the " -"sequence and the sequence is at least 200 items long, this item is marked as " -"\"popular\" and is treated as junk for the purpose of sequence matching. " -"This heuristic can be turned off by setting the ``autojunk`` argument to " -"``False`` when creating the :class:`SequenceMatcher`." +"This heuristic can speed the algorithm up (because it reduces the number of " +"possible combinations) and it can produce results that are more " +"understandable for humans (typically breaking on whitespace). But it can " +"also cause pathological cases:" msgstr "" -msgid "Added the *autojunk* parameter." +msgid "" +"Inappropriately chosen junk items can cause an unexpectedly **large** (but " +"still correct) result." +msgstr "" + +msgid "" +"The default heuristic is **asymmetric**: only the second sequence is " +"inspected when determining what is considered junk, so comparing A to B can " +"give different results than comparing B to A and reversing the result." +msgstr "" + +msgid "" +"By default, if the second input sequence is at least 200 items long, items " +"that account for more than 1% it are considered *junk*." +msgstr "" + +msgid "" +"Depending on your data, you should consider turning this heuristic off " +"(setting :class:`~difflib.SequenceMatcher`'s *autojunk* argument to " +"``False``) or tuning it (using the *isjunk* argument, perhaps to one of " +"the :ref:`predefined functions `)." +msgstr "" + +msgid "The :mod:`!difflib` algorithm" +msgstr "" + +msgid "" +"The algorithm used in :class:`SequenceMatcher` predates, and is a little " +"fancier than, an algorithm published in the late 1980s by Ratcliff and " +"Obershelp under the hyperbolic name \"gestalt pattern matching.\" The idea " +"is to find the longest contiguous subsequence common to both inputs, then " +"recursively handle the pieces of the sequences to the left and to the right " +"of the matching subsequence." +msgstr "" + +msgid "" +"`Pattern Matching: The Gestalt Approach `_" +msgstr "" + +msgid "" +"Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. " +"This was published in Dr. Dobb's Journal in July, 1988." +msgstr "" + +msgid "" +"As an extension to the Ratcliff and Obershelp algorithm, :mod:`!difflib` " +"searches for the longest *junk-free* contiguous subsequence. See " +"the :ref:`difflib-junk` section for details." +msgstr "" + +msgid "Timing" +msgstr "" + +msgid "" +"The basic Ratcliff-Obershelp algorithm is cubic time in the worst case and " +"quadratic time in the expected case. :mod:`difflib`'s algorithm is quadratic " +"time for the worst case and has expected-case behavior dependent in a " +"complicated way on how many elements the sequences have in common; best case " +"time is linear." +msgstr "" + +msgid "Diff generation" msgstr "" msgid "" @@ -121,6 +174,58 @@ msgid "" "tabs or line breaks." msgstr "" +msgid "" +"Note that :class:`Differ`\\ -generated deltas make no claim to be " +"**minimal** diffs. To the contrary, minimal diffs are often counter-" +"intuitive for humans, because they synch up anywhere possible, sometimes at " +"accidental matches 100 pages apart. Restricting synch points to contiguous " +"matches preserves some notion of locality, at the occasional cost of " +"producing a longer diff." +msgstr "" + +msgid "The :class:`Differ` class has this constructor:" +msgstr "" + +msgid "" +"Optional keyword parameters *linejunk* and *charjunk* are for filter " +"functions (or ``None``):" +msgstr "" + +msgid "" +"*linejunk*: A function that accepts a single string argument, and returns " +"true if the string is junk. The default is ``None``, meaning that no line " +"is considered junk." +msgstr "" + +msgid "" +"*charjunk*: A function that accepts a single character argument (a string of " +"length 1), and returns true if the character is junk. The default is " +"``None``, meaning that no character is considered junk." +msgstr "" + +msgid "" +"These junk-filtering functions speed up matching to find differences and do " +"not cause any differing lines or characters to be ignored. Read the " +"description of the :meth:`~SequenceMatcher.find_longest_match` method's " +"*isjunk* parameter for an explanation." +msgstr "" + +msgid "" +":class:`Differ` objects are used (deltas generated) via a single method:" +msgstr "" + +msgid "" +"Compare two sequences of lines, and generate the delta (a sequence of lines)." +msgstr "" + +msgid "" +"Each sequence must contain individual single-line strings ending with " +"newlines. Such sequences can be obtained from " +"the :meth:`~io.IOBase.readlines` method of file-like objects. The generated " +"delta also consists of newline-terminated strings, ready to be printed as-is " +"via the :meth:`~io.IOBase.writelines` method of a file-like object." +msgstr "" + msgid "" "This class can be used to create an HTML table (or a complete HTML file " "containing the table) showing a side by side, line by line comparison of " @@ -128,6 +233,11 @@ msgid "" "generated in either full or contextual difference mode." msgstr "" +msgid "" +"The trailing newlines get stripped before the diff, so the result can be " +"incomplete. See :gh:`71896` for details." +msgstr "" + msgid "The constructor for this class is:" msgstr "" @@ -145,10 +255,10 @@ msgid "" msgstr "" msgid "" -"*linejunk* and *charjunk* are optional keyword arguments passed into :func:" -"`ndiff` (used by :class:`HtmlDiff` to generate the side by side HTML " -"differences). See :func:`ndiff` documentation for argument default values " -"and descriptions." +"*linejunk* and *charjunk* are optional keyword arguments passed " +"into :func:`ndiff` (used by :class:`HtmlDiff` to generate the side by side " +"HTML differences). See :func:`ndiff` documentation for argument default " +"values and descriptions." msgstr "" msgid "The following methods are public:" @@ -194,8 +304,8 @@ msgid "" msgstr "" msgid "" -"The arguments for this method are the same as those for the :meth:" -"`make_file` method." +"The arguments for this method are the same as those for " +"the :meth:`make_file` method." msgstr "" msgid "" @@ -337,6 +447,9 @@ msgid "" "unknown/inconsistent encodings as *a* and *b*." msgstr "" +msgid "Junk definition functions" +msgstr "" + msgid "" "Return ``True`` for ignorable lines. The line *line* is ignorable if *line* " "is blank or contains a single ``'#'``, otherwise it is not ignorable. Used " @@ -349,22 +462,9 @@ msgid "" "for parameter *charjunk* in :func:`ndiff`." msgstr "" -msgid "" -"`Pattern Matching: The Gestalt Approach `_" -msgstr "" - -msgid "" -"Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. " -"This was published in Dr. Dobb's Journal in July, 1988." -msgstr "" - msgid "SequenceMatcher objects" msgstr "" -msgid "The :class:`SequenceMatcher` class has this constructor:" -msgstr "" - msgid "" "Optional argument *isjunk* must be ``None`` (the default) or a one-argument " "function that takes a sequence element and returns true if and only if the " @@ -383,8 +483,8 @@ msgstr "" msgid "" "The optional arguments *a* and *b* are sequences to be compared; both " -"default to empty strings. The elements of both sequences must be :term:" -"`hashable`." +"default to empty strings. The elements of both sequences must " +"be :term:`hashable`." msgstr "" msgid "" @@ -392,13 +492,16 @@ msgid "" "heuristic." msgstr "" +msgid "Added the *autojunk* parameter." +msgstr "" + msgid "" "SequenceMatcher objects get three data attributes: *bjunk* is the set of " "elements of *b* for which *isjunk* is ``True``; *bpopular* is the set of non-" "junk elements considered popular by the heuristic (if it is not disabled); " "*b2j* is a dict mapping the remaining elements of *b* to a list of positions " -"where they occur. All three are reset whenever *b* is reset with :meth:" -"`set_seqs` or :meth:`set_seq2`." +"where they occur. All three are reset whenever *b* is reset " +"with :meth:`set_seqs` or :meth:`set_seq2`." msgstr "" msgid "The *bjunk* and *bpopular* attributes." @@ -467,8 +570,8 @@ msgstr "" msgid "" "Return list of triples describing non-overlapping matching subsequences. " -"Each triple is of the form ``(i, j, n)``, and means that ``a[i:i+n] == b[j:" -"j+n]``. The triples are monotonically increasing in *i* and *j*." +"Each triple is of the form ``(i, j, n)``, and means that ``a[i:i+n] == " +"b[j:j+n]``. The triples are monotonically increasing in *i* and *j*." msgstr "" msgid "" @@ -564,26 +667,11 @@ msgid "" msgstr "" msgid "" -"This is expensive to compute if :meth:`get_matching_blocks` or :meth:" -"`get_opcodes` hasn't already been called, in which case you may want to try :" -"meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an upper bound." -msgstr "" - -msgid "" -"Caution: The result of a :meth:`ratio` call may depend on the order of the " -"arguments. For instance::" -msgstr "" - -msgid "" -">>> SequenceMatcher(None, 'tide', 'diet').ratio()\n" -"0.25\n" -">>> SequenceMatcher(None, 'diet', 'tide').ratio()\n" -"0.5" +"This is expensive to compute if :meth:`get_matching_blocks` " +"or :meth:`get_opcodes` hasn't already been called, in which case you may " +"want to try :meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an " +"upper bound." msgstr "" -">>> SequenceMatcher(None, 'tide', 'diet').ratio()\n" -"0.25\n" -">>> SequenceMatcher(None, 'diet', 'tide').ratio()\n" -"0.5" msgid "Return an upper bound on :meth:`ratio` relatively quickly." msgstr "" @@ -593,12 +681,15 @@ msgstr "" msgid "" "The three methods that return the ratio of matching to total characters can " -"give different results due to differing levels of approximation, although :" -"meth:`~SequenceMatcher.quick_ratio` and :meth:`~SequenceMatcher." -"real_quick_ratio` are always at least as large as :meth:`~SequenceMatcher." -"ratio`:" +"give different results due to differing levels of approximation, " +"although :meth:`~SequenceMatcher.quick_ratio` " +"and :meth:`~SequenceMatcher.real_quick_ratio` are always at least as large " +"as :meth:`~SequenceMatcher.ratio`:" msgstr "" +msgid "Examples" +msgstr "Przykłady" + msgid "SequenceMatcher examples" msgstr "" @@ -607,25 +698,26 @@ msgstr "" msgid "" ":meth:`~SequenceMatcher.ratio` returns a float in [0, 1], measuring the " -"similarity of the sequences. As a rule of thumb, a :meth:`~SequenceMatcher." -"ratio` value over 0.6 means the sequences are close matches:" +"similarity of the sequences. As a rule of thumb, " +"a :meth:`~SequenceMatcher.ratio` value over 0.6 means the sequences are " +"close matches:" msgstr "" msgid "" -"If you're only interested in where the sequences match, :meth:" -"`~SequenceMatcher.get_matching_blocks` is handy:" +"If you're only interested in where the sequences " +"match, :meth:`~SequenceMatcher.get_matching_blocks` is handy:" msgstr "" msgid "" -"Note that the last tuple returned by :meth:`~SequenceMatcher." -"get_matching_blocks` is always a dummy, ``(len(a), len(b), 0)``, and this is " -"the only case in which the last tuple element (number of elements matched) " -"is ``0``." +"Note that the last tuple returned " +"by :meth:`~SequenceMatcher.get_matching_blocks` is always a dummy, " +"``(len(a), len(b), 0)``, and this is the only case in which the last tuple " +"element (number of elements matched) is ``0``." msgstr "" msgid "" -"If you want to know how to change the first sequence into the second, use :" -"meth:`~SequenceMatcher.get_opcodes`:" +"If you want to know how to change the first sequence into the second, " +"use :meth:`~SequenceMatcher.get_opcodes`:" msgstr "" msgid "" @@ -635,63 +727,8 @@ msgstr "" msgid "" "`Simple version control recipe `_ for a small application built with :class:" -"`SequenceMatcher`." -msgstr "" - -msgid "Differ objects" -msgstr "" - -msgid "" -"Note that :class:`Differ`\\ -generated deltas make no claim to be " -"**minimal** diffs. To the contrary, minimal diffs are often counter-" -"intuitive, because they synch up anywhere possible, sometimes accidental " -"matches 100 pages apart. Restricting synch points to contiguous matches " -"preserves some notion of locality, at the occasional cost of producing a " -"longer diff." -msgstr "" - -msgid "The :class:`Differ` class has this constructor:" -msgstr "" - -msgid "" -"Optional keyword parameters *linejunk* and *charjunk* are for filter " -"functions (or ``None``):" -msgstr "" - -msgid "" -"*linejunk*: A function that accepts a single string argument, and returns " -"true if the string is junk. The default is ``None``, meaning that no line " -"is considered junk." -msgstr "" - -msgid "" -"*charjunk*: A function that accepts a single character argument (a string of " -"length 1), and returns true if the character is junk. The default is " -"``None``, meaning that no character is considered junk." -msgstr "" - -msgid "" -"These junk-filtering functions speed up matching to find differences and do " -"not cause any differing lines or characters to be ignored. Read the " -"description of the :meth:`~SequenceMatcher.find_longest_match` method's " -"*isjunk* parameter for an explanation." -msgstr "" - -msgid "" -":class:`Differ` objects are used (deltas generated) via a single method:" -msgstr "" - -msgid "" -"Compare two sequences of lines, and generate the delta (a sequence of lines)." -msgstr "" - -msgid "" -"Each sequence must contain individual single-line strings ending with " -"newlines. Such sequences can be obtained from the :meth:`~io.IOBase." -"readlines` method of file-like objects. The delta generated also consists " -"of newline-terminated strings, ready to be printed as-is via the :meth:`~io." -"IOBase.writelines` method of a file-like object." +"simple-version-control/>`_ for a small application built " +"with :class:`SequenceMatcher`." msgstr "" msgid "Differ example" @@ -783,8 +820,8 @@ msgid "" " elif options.n:\n" " diff = difflib.ndiff(fromlines, tolines)\n" " elif options.m:\n" -" diff = difflib.HtmlDiff().make_file(fromlines,tolines,fromfile," -"tofile,context=options.c,numlines=n)\n" +" diff = " +"difflib.HtmlDiff().make_file(fromlines,tolines,fromfile,tofile,context=options.c,numlines=n)\n" " else:\n" " diff = difflib.context_diff(fromlines, tolines, fromfile, tofile, " "fromdate, todate, n=n)\n" @@ -828,8 +865,8 @@ msgid "" "confusing if the source files contain tab characters.\n" "\n" "The first file can be recovered by retaining only lines that begin with\n" -"\" \" or \"- \", and deleting those 2-character prefixes; use ndiff with -" -"r1.\n" +"\" \" or \"- \", and deleting those 2-character prefixes; use ndiff with " +"-r1.\n" "\n" "The second file can be recovered similarly, but by retaining only \" \" " "and\n" diff --git a/library/dis.po b/library/dis.po index 05f2550a77..5162979e48 100644 --- a/library/dis.po +++ b/library/dis.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -64,8 +65,8 @@ msgstr "" msgid "" "The argument of a jump is the offset of the target instruction relative to " -"the instruction that appears immediately after the jump instruction's :" -"opcode:`CACHE` entries." +"the instruction that appears immediately after the jump " +"instruction's :opcode:`CACHE` entries." msgstr "" msgid "" @@ -115,7 +116,7 @@ msgid "(The \"2\" is a line number)." msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The :mod:`!dis` module can be invoked as a script from the command line:" @@ -152,9 +153,9 @@ msgid "Bytecode analysis" msgstr "" msgid "" -"The bytecode analysis API allows pieces of Python code to be wrapped in a :" -"class:`Bytecode` object that provides easy access to details of the compiled " -"code." +"The bytecode analysis API allows pieces of Python code to be wrapped in " +"a :class:`Bytecode` object that provides easy access to details of the " +"compiled code." msgstr "" msgid "" @@ -214,8 +215,8 @@ msgid "The first source line of the code object (if available)" msgstr "" msgid "" -"Return a formatted view of the bytecode operations (the same as printed by :" -"func:`dis.dis`, but returned as a multi-line string)." +"Return a formatted view of the bytecode operations (the same as printed " +"by :func:`dis.dis`, but returned as a multi-line string)." msgstr "" msgid "" @@ -377,7 +378,7 @@ msgid "" "the details of each operation in the supplied code." msgstr "" -msgid "The *adaptive* parameter works as it does in :func:`dis`." +msgid "The *adaptive* parameter works as it does in :func:`~dis.dis`." msgstr "" msgid "" @@ -388,18 +389,18 @@ msgid "" msgstr "" msgid "" -"This generator function uses the :meth:`~codeobject.co_lines` method of the :" -"ref:`code object ` *code* to find the offsets which are starts " -"of lines in the source code. They are generated as ``(offset, lineno)`` " -"pairs." +"This generator function uses the :meth:`~codeobject.co_lines` method of " +"the :ref:`code object ` *code* to find the offsets which are " +"starts of lines in the source code. They are generated as ``(offset, " +"lineno)`` pairs." msgstr "" msgid "Line numbers can be decreasing. Before, they were always increasing." msgstr "" msgid "" -"The :pep:`626` :meth:`~codeobject.co_lines` method is used instead of the :" -"attr:`~codeobject.co_firstlineno` and :attr:`~codeobject.co_lnotab` " +"The :pep:`626` :meth:`~codeobject.co_lines` method is used instead of " +"the :attr:`~codeobject.co_firstlineno` and :attr:`~codeobject.co_lnotab` " "attributes of the :ref:`code object `." msgstr "" @@ -551,9 +552,9 @@ msgid "" msgstr "" msgid "" -"Do nothing code. Used by the interpreter to record :monitoring-event:" -"`BRANCH_LEFT` and :monitoring-event:`BRANCH_RIGHT` events for :mod:`sys." -"monitoring`." +"Do nothing code. Used by the interpreter to record :monitoring-" +"event:`BRANCH_LEFT` and :monitoring-event:`BRANCH_RIGHT` events " +"for :mod:`sys.monitoring`." msgstr "" msgid "Removes the iterator from the top of the stack." @@ -748,10 +749,10 @@ msgid "" msgstr "" msgid "" -"Handles an exception raised during a :meth:`~generator.throw` or :meth:" -"`~generator.close` call through the current frame. If ``STACK[-1]`` is an " -"instance of :exc:`StopIteration`, pop three values from the stack and push " -"its ``value`` member. Otherwise, re-raise ``STACK[-1]``." +"Handles an exception raised during a :meth:`~generator.throw` " +"or :meth:`~generator.close` call through the current frame. If " +"``STACK[-1]`` is an instance of :exc:`StopIteration`, pop three values from " +"the stack and push its ``value`` member. Otherwise, re-raise ``STACK[-1]``." msgstr "" msgid "**Miscellaneous opcodes**" @@ -788,10 +789,10 @@ msgid "" msgstr "" msgid "" -"For all of the :opcode:`SET_ADD`, :opcode:`LIST_APPEND` and :opcode:" -"`MAP_ADD` instructions, while the added value or key/value pair is popped " -"off, the container object remains on the stack so that it is available for " -"further iterations of the loop." +"For all of the :opcode:`SET_ADD`, :opcode:`LIST_APPEND` " +"and :opcode:`MAP_ADD` instructions, while the added value or key/value pair " +"is popped off, the container object remains on the stack so that it is " +"available for further iterations of the loop." msgstr "" msgid "Returns with ``STACK[-1]`` to the caller of the function." @@ -826,8 +827,8 @@ msgstr "" msgid "" "Re-raises the exception currently on top of the stack. If oparg is non-zero, " -"pops an additional value from the stack which is used to set :attr:`~frame." -"f_lasti` of the current frame." +"pops an additional value from the stack which is used to " +"set :attr:`~frame.f_lasti` of the current frame." msgstr "" msgid "" @@ -868,8 +869,8 @@ msgstr "" msgid "" "Pushes a common constant onto the stack. The interpreter contains a " -"hardcoded list of constants supported by this instruction. Used by the :" -"keyword:`assert` statement to load :exc:`AssertionError`." +"hardcoded list of constants supported by this instruction. Used by " +"the :keyword:`assert` statement to load :exc:`AssertionError`." msgstr "" msgid "" @@ -899,8 +900,9 @@ msgstr "" msgid "" "``STACK[-1]`` is a tuple of mapping keys, and ``STACK[-2]`` is the match " -"subject. If ``STACK[-2]`` contains all of the keys in ``STACK[-1]``, push a :" -"class:`tuple` containing the corresponding values. Otherwise, push ``None``." +"subject. If ``STACK[-2]`` contains all of the keys in ``STACK[-1]``, push " +"a :class:`tuple` containing the corresponding values. Otherwise, push " +"``None``." msgstr "" msgid "" @@ -911,13 +913,14 @@ msgstr "" msgid "" "Implements ``name = STACK.pop()``. *namei* is the index of *name* in the " "attribute :attr:`~codeobject.co_names` of the :ref:`code object `. The compiler tries to use :opcode:`STORE_FAST` or :opcode:" -"`STORE_GLOBAL` if possible." +"objects>`. The compiler tries to use :opcode:`STORE_FAST` " +"or :opcode:`STORE_GLOBAL` if possible." msgstr "" msgid "" -"Implements ``del name``, where *namei* is the index into :attr:`~codeobject." -"co_names` attribute of the :ref:`code object `." +"Implements ``del name``, where *namei* is the index " +"into :attr:`~codeobject.co_names` attribute of the :ref:`code object `." msgstr "" msgid "" @@ -962,8 +965,8 @@ msgid "" msgstr "" msgid "" -"where *namei* is the index of name in :attr:`~codeobject.co_names` of the :" -"ref:`code object `." +"where *namei* is the index of name in :attr:`~codeobject.co_names` of " +"the :ref:`code object `." msgstr "" msgid "" @@ -972,8 +975,8 @@ msgid "" msgstr "" msgid "" -"where *namei* is the index of name into :attr:`~codeobject.co_names` of the :" -"ref:`code object `." +"where *namei* is the index of name into :attr:`~codeobject.co_names` of " +"the :ref:`code object `." msgstr "" msgid "Works as :opcode:`STORE_NAME`, but stores the name as a global." @@ -996,8 +999,8 @@ msgstr "" msgid "" "Pushes a reference to the locals dictionary onto the stack. This is used to " -"prepare namespace dictionaries for :opcode:`LOAD_FROM_DICT_OR_DEREF` and :" -"opcode:`LOAD_FROM_DICT_OR_GLOBALS`." +"prepare namespace dictionaries for :opcode:`LOAD_FROM_DICT_OR_DEREF` " +"and :opcode:`LOAD_FROM_DICT_OR_GLOBALS`." msgstr "" msgid "" @@ -1163,9 +1166,9 @@ msgid "" msgstr "" msgid "" -"The low bit of ``namei`` signals to attempt a method load, as with :opcode:" -"`LOAD_ATTR`, which results in pushing ``NULL`` and the loaded method. When " -"it is unset a single value is pushed to the stack." +"The low bit of ``namei`` signals to attempt a method load, as " +"with :opcode:`LOAD_ATTR`, which results in pushing ``NULL`` and the loaded " +"method. When it is unset a single value is pushed to the stack." msgstr "" msgid "" @@ -1180,8 +1183,8 @@ msgid "" msgstr "" msgid "" -"The fifth-lowest bit of the oparg now indicates a forced conversion to :" -"class:`bool`." +"The fifth-lowest bit of the oparg now indicates a forced conversion " +"to :class:`bool`." msgstr "" msgid "Performs ``is`` comparison, or ``is not`` if ``invert`` is 1." @@ -1192,10 +1195,10 @@ msgstr "" msgid "" "Imports the module ``co_names[namei]``. ``STACK[-1]`` and ``STACK[-2]`` are " -"popped and provide the *fromlist* and *level* arguments of :func:" -"`__import__`. The module object is pushed onto the stack. The current " -"namespace is not affected: for a proper import statement, a subsequent :" -"opcode:`STORE_FAST` instruction modifies the namespace." +"popped and provide the *fromlist* and *level* arguments " +"of :func:`__import__`. The module object is pushed onto the stack. The " +"current namespace is not affected: for a proper import statement, a " +"subsequent :opcode:`STORE_FAST` instruction modifies the namespace." msgstr "" msgid "" @@ -1245,19 +1248,24 @@ msgstr "" msgid "" "``STACK[-1]`` is an :term:`iterator`. Call its :meth:`~iterator.__next__` " "method. If this yields a new value, push it on the stack (leaving the " -"iterator below it). If the iterator indicates it is exhausted then the byte " -"code counter is incremented by *delta*." +"iterator below it). If the iterator indicates it is :term:`exhausted` then " +"the byte code counter is incremented by *delta*." msgstr "" msgid "Up until 3.11 the iterator was popped when it was exhausted." msgstr "" -msgid "Loads the global named ``co_names[namei>>1]`` onto the stack." +msgid "" +"Loads the global named ``co_names[namei>>1]`` onto the stack. If the low bit " +"of ``namei`` is set, a ``NULL`` is pushed onto the stack after the global " +"variable." +msgstr "" + +msgid "The low bit of ``namei`` indicates whether a ``NULL`` is pushed." msgstr "" msgid "" -"If the low bit of ``namei`` is set, then a ``NULL`` is pushed to the stack " -"before the global variable." +"The ``NULL`` is pushed after the global variable, rather than before it." msgstr "" msgid "" @@ -1330,8 +1338,8 @@ msgstr "" msgid "" "Pops a mapping off the stack and looks up the name associated with slot " "``i`` of the \"fast locals\" storage in this mapping. If the name is not " -"found there, loads it from the cell contained in slot ``i``, similar to :" -"opcode:`LOAD_DEREF`. This is used for loading :term:`closure variables " +"found there, loads it from the cell contained in slot ``i``, similar " +"to :opcode:`LOAD_DEREF`. This is used for loading :term:`closure variables " "` in class bodies (which previously used :opcode:`!" "LOAD_CLASSDEREF`) and in :ref:`annotation scopes ` within " "class bodies." @@ -1768,10 +1776,10 @@ msgid "Sets the ``__type_params__`` attribute of a function." msgstr "" msgid "" -"Performs special method lookup on ``STACK[-1]``. If ``type(STACK[-1])." -"__xxx__`` is a method, leave ``type(STACK[-1]).__xxx__; STACK[-1]`` on the " -"stack. If ``type(STACK[-1]).__xxx__`` is not a method, leave ``STACK[-1]." -"__xxx__; NULL`` on the stack." +"Performs special method lookup on ``STACK[-1]``. If " +"``type(STACK[-1]).__xxx__`` is a method, leave ``type(STACK[-1]).__xxx__; " +"STACK[-1]`` on the stack. If ``type(STACK[-1]).__xxx__`` is not a method, " +"leave ``STACK[-1].__xxx__; NULL`` on the stack." msgstr "" msgid "**Pseudo-instructions**" @@ -1805,8 +1813,9 @@ msgstr "" msgid "" "This variant is used in :keyword:`with` and :keyword:`async with` " -"constructs, which push the return value of the context manager's :meth:" -"`~object.__enter__` or :meth:`~object.__aenter__` to the stack." +"constructs, which push the return value of the context " +"manager's :meth:`~object.__enter__` or :meth:`~object.__aenter__` to the " +"stack." msgstr "" msgid "" diff --git a/library/doctest.po b/library/doctest.po index 8a898e52b0..7b22b90ac0 100644 --- a/library/doctest.po +++ b/library/doctest.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -225,9 +225,9 @@ msgstr "" msgid "" "You can force verbose mode by passing ``verbose=True`` to :func:`testmod`, " -"or prohibit it by passing ``verbose=False``. In either of those cases, :" -"data:`sys.argv` is not examined by :func:`testmod` (so passing ``-v`` or not " -"has no effect)." +"or prohibit it by passing ``verbose=False``. In either of those " +"cases, :data:`sys.argv` is not examined by :func:`testmod` (so passing ``-" +"v`` or not has no effect)." msgstr "" msgid "" @@ -296,8 +296,8 @@ msgstr "" msgid "" "As with :func:`testmod`, :func:`testfile` won't display anything unless an " "example fails. If an example does fail, then the failing example(s) and the " -"cause(s) of the failure(s) are printed to stdout, using the same format as :" -"func:`!testmod`." +"cause(s) of the failure(s) are printed to stdout, using the same format " +"as :func:`!testmod`." msgstr "" msgid "" @@ -341,9 +341,9 @@ msgid "python -m doctest -v example.py" msgstr "" msgid "" -"This will import :file:`example.py` as a standalone module and run :func:" -"`testmod` on it. Note that this may not work correctly if the file is part " -"of a package and imports other submodules from that package." +"This will import :file:`example.py` as a standalone module and " +"run :func:`testmod` on it. Note that this may not work correctly if the file " +"is part of a package and imports other submodules from that package." msgstr "" msgid "" @@ -355,8 +355,8 @@ msgid "python -m doctest -v example.txt" msgstr "" msgid "" -"Option flags control various aspects of doctest's behavior, see section :ref:" -"`doctest-options`." +"Option flags control various aspects of doctest's behavior, see " +"section :ref:`doctest-options`." msgstr "" msgid "This is shorthand for ``-o FAIL_FAST``." @@ -388,10 +388,10 @@ msgid "" "the docstring. Doctest looks for a module-level variable called ``__test__`` " "and uses it to locate other tests. If ``M.__test__`` exists, it must be a " "dict, and each entry maps a (string) name to a function object, class " -"object, or string. Function and class object docstrings found from ``M." -"__test__`` are searched, and strings are treated as if they were " -"docstrings. In output, a key ``K`` in ``M.__test__`` appears with name ``M." -"__test__.K``." +"object, or string. Function and class object docstrings found from " +"``M.__test__`` are searched, and strings are treated as if they were " +"docstrings. In output, a key ``K`` in ``M.__test__`` appears with name " +"``M.__test__.K``." msgstr "" msgid "For example, place this block of code at the top of :file:`example.py`:" @@ -412,8 +412,8 @@ msgstr "" msgid "" "The value of ``example.__test__[\"numbers\"]`` will be treated as a " "docstring and all the tests inside it will be run. It is important to note " -"that the value can be mapped to a function, class object, or module; if so, :" -"mod:`!doctest` searches them recursively for docstrings, which are then " +"that the value can be mapped to a function, class object, or module; if " +"so, :mod:`!doctest` searches them recursively for docstrings, which are then " "scanned for tests." msgstr "" @@ -479,14 +479,14 @@ msgid "" "All hard tab characters are expanded to spaces, using 8-column tab stops. " "Tabs in output generated by the tested code are not modified. Because any " "hard tabs in the sample output *are* expanded, this means that if the code " -"output includes hard tabs, the only way the doctest can pass is if the :" -"const:`NORMALIZE_WHITESPACE` option or :ref:`directive ` " -"is in effect. Alternatively, the test can be rewritten to capture the output " -"and compare it to an expected value as part of the test. This handling of " -"tabs in the source was arrived at through trial and error, and has proven to " -"be the least error prone way of handling them. It is possible to use a " -"different algorithm for handling tabs by writing a custom :class:" -"`DocTestParser` class." +"output includes hard tabs, the only way the doctest can pass is if " +"the :const:`NORMALIZE_WHITESPACE` option or :ref:`directive ` is in effect. Alternatively, the test can be rewritten to " +"capture the output and compare it to an expected value as part of the test. " +"This handling of tabs in the source was arrived at through trial and error, " +"and has proven to be the least error prone way of handling them. It is " +"possible to use a different algorithm for handling tabs by writing a " +"custom :class:`DocTestParser` class." msgstr "" msgid "" @@ -582,8 +582,8 @@ msgid "" msgstr "" msgid "" -"That doctest succeeds if :exc:`ValueError` is raised, with the ``list." -"remove(x): x not in list`` detail as shown." +"That doctest succeeds if :exc:`ValueError` is raised, with the " +"``list.remove(x): x not in list`` detail as shown." msgstr "" msgid "" @@ -641,10 +641,10 @@ msgstr "" msgid "" "Note that tracebacks are treated very specially. In particular, in the " -"rewritten example, the use of ``...`` is independent of doctest's :const:" -"`ELLIPSIS` option. The ellipsis in that example could be left out, or could " -"just as well be three (or three hundred) commas or digits, or an indented " -"transcript of a Monty Python skit." +"rewritten example, the use of ``...`` is independent of " +"doctest's :const:`ELLIPSIS` option. The ellipsis in that example could be " +"left out, or could just as well be three (or three hundred) commas or " +"digits, or an indented transcript of a Monty Python skit." msgstr "" msgid "Some details you should read once, but won't need to remember:" @@ -674,8 +674,8 @@ msgid "" msgstr "" msgid "" -"The interactive shell omits the traceback header line for some :exc:" -"`SyntaxError`\\ s. But doctest uses the traceback header line to " +"The interactive shell omits the traceback header line for " +"some :exc:`SyntaxError`\\ s. But doctest uses the traceback header line to " "distinguish exceptions from non-exceptions. So in the rare case where you " "need to test a :exc:`!SyntaxError` that omits the traceback header, you will " "need to manually add the traceback header line to your test example." @@ -714,11 +714,11 @@ msgstr "" msgid "" "A number of option flags control various aspects of doctest's behavior. " -"Symbolic names for the flags are supplied as module constants, which can be :" -"ref:`bitwise ORed ` together and passed to various functions. The " -"names can also be used in :ref:`doctest directives `, " -"and may be passed to the doctest command line interface via the ``-o`` " -"option." +"Symbolic names for the flags are supplied as module constants, which can " +"be :ref:`bitwise ORed ` together and passed to various functions. " +"The names can also be used in :ref:`doctest directives `, and may be passed to the doctest command line interface via " +"the ``-o`` option." msgstr "" msgid "" @@ -729,20 +729,21 @@ msgstr "" msgid "" "By default, if an expected output block contains just ``1``, an actual " "output block containing just ``1`` or just ``True`` is considered to be a " -"match, and similarly for ``0`` versus ``False``. When :const:" -"`DONT_ACCEPT_TRUE_FOR_1` is specified, neither substitution is allowed. The " -"default behavior caters to that Python changed the return type of many " -"functions from integer to boolean; doctests expecting \"little integer\" " -"output still work in these cases. This option will probably go away, but " -"not for several years." +"match, and similarly for ``0`` versus ``False``. " +"When :const:`DONT_ACCEPT_TRUE_FOR_1` is specified, neither substitution is " +"allowed. The default behavior caters to that Python changed the return type " +"of many functions from integer to boolean; doctests expecting \"little " +"integer\" output still work in these cases. This option will probably go " +"away, but not for several years." msgstr "" msgid "" "By default, if an expected output block contains a line containing only the " "string ````, then that line will match a blank line in the actual " "output. Because a genuinely blank line delimits the expected output, this " -"is the only way to communicate that a blank line is expected. When :const:" -"`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not allowed." +"is the only way to communicate that a blank line is expected. " +"When :const:`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not " +"allowed." msgstr "" msgid "" @@ -770,11 +771,11 @@ msgstr "" msgid "" "For example, an example expecting ``ValueError: 42`` will pass if the actual " -"exception raised is ``ValueError: 3*14``, but will fail if, say, a :exc:" -"`TypeError` is raised instead. It will also ignore any fully qualified name " -"included before the exception class, which can vary between implementations " -"and versions of Python and the code/libraries in use. Hence, all three of " -"these variations will work with the flag specified:" +"exception raised is ``ValueError: 3*14``, but will fail if, say, " +"a :exc:`TypeError` is raised instead. It will also ignore any fully " +"qualified name included before the exception class, which can vary between " +"implementations and versions of Python and the code/libraries in use. Hence, " +"all three of these variations will work with the flag specified:" msgstr "" msgid "" @@ -866,10 +867,10 @@ msgstr "" msgid "" "Create a new option flag with a given name, and return the new flag's " -"integer value. :func:`register_optionflag` can be used when subclassing :" -"class:`OutputChecker` or :class:`DocTestRunner` to create new options that " -"are supported by your subclasses. :func:`register_optionflag` should always " -"be called using the following idiom::" +"integer value. :func:`register_optionflag` can be used when " +"subclassing :class:`OutputChecker` or :class:`DocTestRunner` to create new " +"options that are supported by your subclasses. :func:`register_optionflag` " +"should always be called using the following idiom::" msgstr "" msgid "MY_FLAG = register_optionflag('MY_FLAG')" @@ -1143,8 +1144,9 @@ msgid "" msgstr "" msgid "" -"Optional argument *optionflags* (default value ``0``) takes the :ref:" -"`bitwise OR ` of option flags. See section :ref:`doctest-options`." +"Optional argument *optionflags* (default value ``0``) takes " +"the :ref:`bitwise OR ` of option flags. See section :ref:`doctest-" +"options`." msgstr "" msgid "" @@ -1177,10 +1179,10 @@ msgid "" msgstr "" msgid "" -"Also test examples reachable from dict ``m.__test__``, if it exists. ``m." -"__test__`` maps names (strings) to functions, classes and strings; function " -"and class docstrings are searched for examples; strings are searched " -"directly, as if they were docstrings." +"Also test examples reachable from dict ``m.__test__``, if it exists. " +"``m.__test__`` maps names (strings) to functions, classes and strings; " +"function and class docstrings are searched for examples; strings are " +"searched directly, as if they were docstrings." msgstr "" msgid "" @@ -1198,11 +1200,11 @@ msgstr "" msgid "" "Optional argument *exclude_empty* defaults to false. If true, objects for " "which no doctests are found are excluded from consideration. The default is " -"a backward compatibility hack, so that code still using :meth:`doctest." -"master.summarize ` in conjunction with :func:" -"`testmod` continues to get output for objects with no tests. The " -"*exclude_empty* argument to the newer :class:`DocTestFinder` constructor " -"defaults to true." +"a backward compatibility hack, so that code still " +"using :meth:`doctest.master.summarize ` in " +"conjunction with :func:`testmod` continues to get output for objects with no " +"tests. The *exclude_empty* argument to the newer :class:`DocTestFinder` " +"constructor defaults to true." msgstr "" msgid "" @@ -1271,18 +1273,18 @@ msgid "" msgstr "" msgid "" -"Convert doctest tests from one or more text files to a :class:`unittest." -"TestSuite`." +"Convert doctest tests from one or more text files to " +"a :class:`unittest.TestSuite`." msgstr "" msgid "" "The returned :class:`unittest.TestSuite` is to be run by the unittest " "framework and runs the interactive examples in each file. If an example in " -"any file fails, then the synthesized unit test fails, and a :exc:`~unittest." -"TestCase.failureException` exception is raised showing the name of the file " -"containing the test and a (sometimes approximate) line number. If all the " -"examples in a file are skipped, then the synthesized unit test is also " -"marked as skipped." +"any file fails, then the synthesized unit test fails, and " +"a :exc:`~unittest.TestCase.failureException` exception is raised showing the " +"name of the file containing the test and a (sometimes approximate) line " +"number. If all the examples in a file are skipped, then the synthesized " +"unit test is also marked as skipped." msgstr "" msgid "Pass one or more paths (as strings) to text files to be examined." @@ -1344,9 +1346,10 @@ msgstr "" msgid "" "Optional argument *optionflags* specifies the default doctest options for " -"the tests, created by or-ing together individual option flags. See section :" -"ref:`doctest-options`. See function :func:`set_unittest_reportflags` below " -"for a better way to set reporting options." +"the tests, created by or-ing together individual option flags. See " +"section :ref:`doctest-options`. See " +"function :func:`set_unittest_reportflags` below for a better way to set " +"reporting options." msgstr "" msgid "" @@ -1418,9 +1421,9 @@ msgid "" msgstr "" msgid "" -"So both ways of creating a :class:`unittest.TestSuite` run instances of :" -"class:`!DocTestCase`. This is important for a subtle reason: when you run :" -"mod:`!doctest` functions yourself, you can control the :mod:`!doctest` " +"So both ways of creating a :class:`unittest.TestSuite` run instances " +"of :class:`!DocTestCase`. This is important for a subtle reason: when you " +"run :mod:`!doctest` functions yourself, you can control the :mod:`!doctest` " "options in use directly, by passing option flags to :mod:`!doctest` " "functions. However, if you're writing a :mod:`unittest` framework, :mod:`!" "unittest` ultimately controls when and how tests get run. The framework " @@ -1445,14 +1448,15 @@ msgstr "" msgid "" "This is a module-global setting, and affects all future doctests run by " "module :mod:`unittest`: the :meth:`!runTest` method of :class:`!" -"DocTestCase` looks at the option flags specified for the test case when the :" -"class:`!DocTestCase` instance was constructed. If no reporting flags were " -"specified (which is the typical and expected case), :mod:`!doctest`'s :mod:`!" -"unittest` reporting flags are :ref:`bitwise ORed ` into the option " -"flags, and the option flags so augmented are passed to the :class:" -"`DocTestRunner` instance created to run the doctest. If any reporting flags " -"were specified when the :class:`!DocTestCase` instance was constructed, :mod:" -"`!doctest`'s :mod:`!unittest` reporting flags are ignored." +"DocTestCase` looks at the option flags specified for the test case when " +"the :class:`!DocTestCase` instance was constructed. If no reporting flags " +"were specified (which is the typical and expected case), :mod:`!" +"doctest`'s :mod:`!unittest` reporting flags are :ref:`bitwise ORed " +"` into the option flags, and the option flags so augmented are " +"passed to the :class:`DocTestRunner` instance created to run the doctest. " +"If any reporting flags were specified when the :class:`!DocTestCase` " +"instance was constructed, :mod:`!doctest`'s :mod:`!unittest` reporting flags " +"are ignored." msgstr "" msgid "" @@ -1491,9 +1495,9 @@ msgid "" msgstr "" msgid "" -":class:`DocTestFinder`: Finds all docstrings in a given module, and uses a :" -"class:`DocTestParser` to create a :class:`DocTest` from every docstring that " -"contains interactive examples." +":class:`DocTestFinder`: Finds all docstrings in a given module, and uses " +"a :class:`DocTestParser` to create a :class:`DocTest` from every docstring " +"that contains interactive examples." msgstr "" msgid "" @@ -1549,8 +1553,8 @@ msgstr "" msgid "" "The namespace (aka globals) that the examples should be run in. This is a " "dictionary mapping names to values. Any changes to the namespace made by " -"the examples (such as binding new variables) will be reflected in :attr:" -"`globs` after the test is run." +"the examples (such as binding new variables) will be reflected " +"in :attr:`globs` after the test is run." msgstr "" msgid "" @@ -1605,9 +1609,9 @@ msgstr "" msgid "" "The exception message generated by the example, if the example is expected " "to generate an exception; or ``None`` if it is not expected to generate an " -"exception. This exception message is compared against the return value of :" -"func:`traceback.format_exception_only`. :attr:`exc_msg` ends with a newline " -"unless it's ``None``. The constructor adds a newline if needed." +"exception. This exception message is compared against the return value " +"of :func:`traceback.format_exception_only`. :attr:`exc_msg` ends with a " +"newline unless it's ``None``. The constructor adds a newline if needed." msgstr "" msgid "" @@ -1655,8 +1659,9 @@ msgid "" msgstr "" msgid "" -"If the optional argument *exclude_empty* is false, then :meth:`DocTestFinder." -"find` will include tests for objects with empty docstrings." +"If the optional argument *exclude_empty* is false, " +"then :meth:`DocTestFinder.find` will include tests for objects with empty " +"docstrings." msgstr "" msgid ":class:`DocTestFinder` defines the following method:" @@ -1707,9 +1712,9 @@ msgid "" "The globals for each :class:`DocTest` is formed by combining *globs* and " "*extraglobs* (bindings in *extraglobs* override bindings in *globs*). A new " "shallow copy of the globals dictionary is created for each :class:`!" -"DocTest`. If *globs* is not specified, then it defaults to the module's :" -"attr:`~module.__dict__`, if specified, or ``{}`` otherwise. If *extraglobs* " -"is not specified, then it defaults to ``{}``." +"DocTest`. If *globs* is not specified, then it defaults to the " +"module's :attr:`~module.__dict__`, if specified, or ``{}`` otherwise. If " +"*extraglobs* is not specified, then it defaults to ``{}``." msgstr "" msgid "DocTestParser objects" @@ -1724,14 +1729,14 @@ msgid ":class:`DocTestParser` defines the following methods:" msgstr "" msgid "" -"Extract all doctest examples from the given string, and collect them into a :" -"class:`DocTest` object." +"Extract all doctest examples from the given string, and collect them into " +"a :class:`DocTest` object." msgstr "" msgid "" -"*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:" -"`!DocTest` object. See the documentation for :class:`DocTest` for more " -"information." +"*globs*, *name*, *filename*, and *lineno* are attributes for the " +"new :class:`!DocTest` object. See the documentation for :class:`DocTest` " +"for more information." msgstr "" msgid "" @@ -1764,15 +1769,15 @@ msgid "DocTestRunner objects" msgstr "" msgid "" -"A processing class used to execute and verify the interactive examples in a :" -"class:`DocTest`." +"A processing class used to execute and verify the interactive examples in " +"a :class:`DocTest`." msgstr "" msgid "" -"The comparison between expected outputs and actual outputs is done by an :" -"class:`OutputChecker`. This comparison may be customized with a number of " -"option flags; see section :ref:`doctest-options` for more information. If " -"the option flags are insufficient, then the comparison may also be " +"The comparison between expected outputs and actual outputs is done by " +"an :class:`OutputChecker`. This comparison may be customized with a number " +"of option flags; see section :ref:`doctest-options` for more information. " +"If the option flags are insufficient, then the comparison may also be " "customized by passing a subclass of :class:`!OutputChecker` to the " "constructor." msgstr "" @@ -1780,11 +1785,12 @@ msgstr "" msgid "" "The test runner's display output can be controlled in two ways. First, an " "output function can be passed to :meth:`run`; this function will be called " -"with strings that should be displayed. It defaults to ``sys.stdout." -"write``. If capturing the output is not sufficient, then the display output " -"can be also customized by subclassing DocTestRunner, and overriding the " -"methods :meth:`report_start`, :meth:`report_success`, :meth:" -"`report_unexpected_exception`, and :meth:`report_failure`." +"with strings that should be displayed. It defaults to " +"``sys.stdout.write``. If capturing the output is not sufficient, then the " +"display output can be also customized by subclassing DocTestRunner, and " +"overriding the " +"methods :meth:`report_start`, :meth:`report_success`, :meth:`report_unexpected_exception`, " +"and :meth:`report_failure`." msgstr "" msgid "" @@ -1794,11 +1800,12 @@ msgid "" msgstr "" msgid "" -"The optional keyword argument *verbose* controls the :class:" -"`DocTestRunner`'s verbosity. If *verbose* is ``True``, then information is " -"printed about each example, as it is run. If *verbose* is ``False``, then " -"only failures are printed. If *verbose* is unspecified, or ``None``, then " -"verbose output is used iff the command-line switch ``-v`` is used." +"The optional keyword argument *verbose* controls " +"the :class:`DocTestRunner`'s verbosity. If *verbose* is ``True``, then " +"information is printed about each example, as it is run. If *verbose* is " +"``False``, then only failures are printed. If *verbose* is unspecified, or " +"``None``, then verbose output is used iff the command-line switch ``-v`` is " +"used." msgstr "" msgid "" @@ -1809,9 +1816,10 @@ msgstr "" msgid "" "The test runner accumulates statistics. The aggregated number of attempted, " -"failed and skipped examples is also available via the :attr:`tries`, :attr:" -"`failures` and :attr:`skips` attributes. The :meth:`run` and :meth:" -"`summarize` methods return a :class:`TestResults` instance." +"failed and skipped examples is also available via " +"the :attr:`tries`, :attr:`failures` and :attr:`skips` attributes. " +"The :meth:`run` and :meth:`summarize` methods return a :class:`TestResults` " +"instance." msgstr "" msgid ":class:`DocTestRunner` defines the following methods:" @@ -1825,8 +1833,8 @@ msgstr "" msgid "" "*example* is the example about to be processed. *test* is the test " -"containing *example*. *out* is the output function that was passed to :meth:" -"`DocTestRunner.run`." +"containing *example*. *out* is the output function that was passed " +"to :meth:`DocTestRunner.run`." msgstr "" msgid "" @@ -1855,9 +1863,9 @@ msgstr "" msgid "" "*example* is the example about to be processed. *exc_info* is a tuple " -"containing information about the unexpected exception (as returned by :func:" -"`sys.exc_info`). *test* is the test containing *example*. *out* is the " -"output function that was passed to :meth:`DocTestRunner.run`." +"containing information about the unexpected exception (as returned " +"by :func:`sys.exc_info`). *test* is the test containing *example*. *out* is " +"the output function that was passed to :meth:`DocTestRunner.run`." msgstr "" msgid "" @@ -1881,8 +1889,8 @@ msgstr "" msgid "" "The output of each example is checked using the :class:`DocTestRunner`'s " -"output checker, and the results are formatted by the :meth:`!DocTestRunner." -"report_\\*` methods." +"output checker, and the results are formatted by the :meth:`!" +"DocTestRunner.report_\\*` methods." msgstr "" msgid "" @@ -1913,10 +1921,10 @@ msgstr "" msgid "" "A class used to check the whether the actual output from a doctest example " -"matches the expected output. :class:`OutputChecker` defines two methods: :" -"meth:`check_output`, which compares a given pair of outputs, and returns " -"``True`` if they match; and :meth:`output_difference`, which returns a " -"string describing the differences between two outputs." +"matches the expected output. :class:`OutputChecker` defines two " +"methods: :meth:`check_output`, which compares a given pair of outputs, and " +"returns ``True`` if they match; and :meth:`output_difference`, which returns " +"a string describing the differences between two outputs." msgstr "" msgid ":class:`OutputChecker` defines the following methods:" @@ -1926,8 +1934,8 @@ msgid "" "Return ``True`` iff the actual output from an example (*got*) matches the " "expected output (*want*). These strings are always considered to match if " "they are identical; but depending on what option flags the test runner is " -"using, several non-exact match types are also possible. See section :ref:" -"`doctest-options` for more information about option flags." +"using, several non-exact match types are also possible. See " +"section :ref:`doctest-options` for more information about option flags." msgstr "" msgid "" @@ -1955,15 +1963,15 @@ msgid "" msgstr "" msgid "" -"The :mod:`unittest` cases generated by :func:`DocTestSuite` support the :" -"meth:`debug` method defined by :class:`unittest.TestCase`." +"The :mod:`unittest` cases generated by :func:`DocTestSuite` support " +"the :meth:`debug` method defined by :class:`unittest.TestCase`." msgstr "" msgid "" "You can add a call to :func:`pdb.set_trace` in a doctest example, and you'll " "drop into the Python debugger when that line is executed. Then you can " -"inspect current values of variables, and so on. For example, suppose :file:" -"`a.py` contains just this module docstring::" +"inspect current values of variables, and so on. For example, " +"suppose :file:`a.py` contains just this module docstring::" msgstr "" msgid "" @@ -2085,10 +2093,10 @@ msgid "Debug the doctests for an object." msgstr "" msgid "" -"The *module* and *name* arguments are the same as for function :func:" -"`testsource` above. The synthesized Python script for the named object's " -"docstring is written to a temporary file, and then that file is run under " -"the control of the Python debugger, :mod:`pdb`." +"The *module* and *name* arguments are the same as for " +"function :func:`testsource` above. The synthesized Python script for the " +"named object's docstring is written to a temporary file, and then that file " +"is run under the control of the Python debugger, :mod:`pdb`." msgstr "" msgid "" @@ -2100,8 +2108,8 @@ msgid "" "Optional argument *pm* controls whether post-mortem debugging is used. If " "*pm* has a true value, the script file is run directly, and the debugger " "gets involved only if the script terminates via raising an unhandled " -"exception. If it does, then post-mortem debugging is invoked, via :func:" -"`pdb.post_mortem`, passing the traceback object from the unhandled " +"exception. If it does, then post-mortem debugging is invoked, " +"via :func:`pdb.post_mortem`, passing the traceback object from the unhandled " "exception. If *pm* is not specified, or is false, the script is run under " "the debugger from the start, via passing an appropriate :func:`exec` call " "to :func:`pdb.run`." @@ -2135,11 +2143,11 @@ msgstr "" msgid "" "A subclass of :class:`DocTestRunner` that raises an exception as soon as a " -"failure is encountered. If an unexpected exception occurs, an :exc:" -"`UnexpectedException` exception is raised, containing the test, the example, " -"and the original exception. If the output doesn't match, then a :exc:" -"`DocTestFailure` exception is raised, containing the test, the example, and " -"the actual output." +"failure is encountered. If an unexpected exception occurs, " +"an :exc:`UnexpectedException` exception is raised, containing the test, the " +"example, and the original exception. If the output doesn't match, then " +"a :exc:`DocTestFailure` exception is raised, containing the test, the " +"example, and the actual output." msgstr "" msgid "" diff --git a/library/email.charset.po b/library/email.charset.po index 768db58003..f9fa10beec 100644 --- a/library/email.charset.po +++ b/library/email.charset.po @@ -43,8 +43,8 @@ msgid "" "This module provides a class :class:`Charset` for representing character " "sets and character set conversions in email messages, as well as a character " "set registry and several convenience methods for manipulating this registry. " -"Instances of :class:`Charset` are used in several other modules within the :" -"mod:`email` package." +"Instances of :class:`Charset` are used in several other modules within " +"the :mod:`email` package." msgstr "" msgid "Import this class from the :mod:`email.charset` module." @@ -97,8 +97,8 @@ msgstr "" msgid "" "Same as *header_encoding*, but describes the encoding for the mail message's " -"body, which indeed may be different than the header encoding. ``charset." -"SHORTEST`` is not allowed for *body_encoding*." +"body, which indeed may be different than the header encoding. " +"``charset.SHORTEST`` is not allowed for *body_encoding*." msgstr "" msgid "" @@ -251,6 +251,6 @@ msgstr "" msgid "" "*charset* is the canonical name of a character set. *codecname* is the name " -"of a Python codec, as appropriate for the second argument to the :class:" -"`str`'s :meth:`~str.encode` method." +"of a Python codec, as appropriate for the second argument to " +"the :class:`str`'s :meth:`~str.encode` method." msgstr "" diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index 49b980fd7e..10d695281c 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -24,38 +24,38 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "" -":mod:`email.message.Message`: Representing an email message using the :data:" -"`~email.policy.compat32` API" +":mod:`email.message.Message`: Representing an email message using " +"the :data:`~email.policy.compat32` API" msgstr "" msgid "" -"The :class:`Message` class is very similar to the :class:`~email.message." -"EmailMessage` class, without the methods added by that class, and with the " -"default behavior of certain other methods being slightly different. We also " -"document here some methods that, while supported by the :class:`~email." -"message.EmailMessage` class, are not recommended unless you are dealing with " -"legacy code." +"The :class:`Message` class is very similar to " +"the :class:`~email.message.EmailMessage` class, without the methods added by " +"that class, and with the default behavior of certain other methods being " +"slightly different. We also document here some methods that, while " +"supported by the :class:`~email.message.EmailMessage` class, are not " +"recommended unless you are dealing with legacy code." msgstr "" msgid "The philosophy and structure of the two classes is otherwise the same." msgstr "" msgid "" -"This document describes the behavior under the default (for :class:" -"`Message`) policy :attr:`~email.policy.Compat32`. If you are going to use " -"another policy, you should be using the :class:`~email.message.EmailMessage` " -"class instead." +"This document describes the behavior under the default " +"(for :class:`Message`) policy :attr:`~email.policy.Compat32`. If you are " +"going to use another policy, you should be using " +"the :class:`~email.message.EmailMessage` class instead." msgstr "" msgid "" -"An email message consists of *headers* and a *payload*. Headers must be :" -"rfc:`5322` style names and values, where the field name and value are " +"An email message consists of *headers* and a *payload*. Headers must " +"be :rfc:`5322` style names and values, where the field name and value are " "separated by a colon. The colon is not part of either the field name or the " "field value. The payload may be a simple text message, or a binary object, " "or a structured sequence of sub-messages each with their own set of headers " "and their own payload. The latter type of payload is indicated by the " -"message having a MIME type such as :mimetype:`multipart/\\*` or :mimetype:" -"`message/rfc822`." +"message having a MIME type such as :mimetype:`multipart/\\*` " +"or :mimetype:`message/rfc822`." msgstr "" msgid "" @@ -76,8 +76,8 @@ msgid "" "matched case-insensitively. There may also be a single envelope header, " "also known as the *Unix-From* header or the ``From_`` header. The *payload* " "is either a string or bytes, in the case of simple message objects, or a " -"list of :class:`Message` objects, for MIME container documents (e.g. :" -"mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." +"list of :class:`Message` objects, for MIME container documents " +"(e.g. :mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." msgstr "" msgid "Here are the methods of the :class:`Message` class:" @@ -86,10 +86,10 @@ msgstr "" msgid "" "If *policy* is specified (it must be an instance of a :mod:`~email.policy` " "class) use the rules it specifies to update and serialize the representation " -"of the message. If *policy* is not set, use the :class:`compat32 ` policy, which maintains backward compatibility with the " -"Python 3.2 version of the email package. For more information see the :mod:" -"`~email.policy` documentation." +"of the message. If *policy* is not set, use the :class:`compat32 " +"` policy, which maintains backward compatibility with " +"the Python 3.2 version of the email package. For more information see " +"the :mod:`~email.policy` documentation." msgstr "" msgid "The *policy* keyword argument was added." @@ -117,9 +117,10 @@ msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " "mangling of lines that begin with ``From`` that is required by the Unix mbox " -"format. For more flexibility, instantiate a :class:`~email.generator." -"Generator` instance and use its :meth:`~email.generator.Generator.flatten` " -"method directly. For example::" +"format. For more flexibility, instantiate " +"a :class:`~email.generator.Generator` instance and use " +"its :meth:`~email.generator.Generator.flatten` method directly. For " +"example::" msgstr "" msgid "" @@ -134,8 +135,8 @@ msgstr "" msgid "" "If the message object contains binary data that is not encoded according to " "RFC standards, the non-compliant data will be replaced by unicode \"unknown " -"character\" code points. (See also :meth:`.as_bytes` and :class:`~email." -"generator.BytesGenerator`.)" +"character\" code points. (See also :meth:`.as_bytes` " +"and :class:`~email.generator.BytesGenerator`.)" msgstr "" msgid "the *policy* keyword argument was added." @@ -159,9 +160,10 @@ msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " "mangling of lines that begin with ``From`` that is required by the Unix mbox " -"format. For more flexibility, instantiate a :class:`~email.generator." -"BytesGenerator` instance and use its :meth:`~email.generator.BytesGenerator." -"flatten` method directly. For example::" +"format. For more flexibility, instantiate " +"a :class:`~email.generator.BytesGenerator` instance and use " +"its :meth:`~email.generator.BytesGenerator.flatten` method directly. For " +"example::" msgstr "" msgid "" @@ -179,13 +181,14 @@ msgid "" msgstr "" msgid "" -"Return ``True`` if the message's payload is a list of sub-\\ :class:" -"`Message` objects, otherwise return ``False``. When :meth:`is_multipart` " -"returns ``False``, the payload should be a string object (which might be a " -"CTE encoded binary payload). (Note that :meth:`is_multipart` returning " -"``True`` does not necessarily mean that \"msg.get_content_maintype() == " -"'multipart'\" will return the ``True``. For example, ``is_multipart`` will " -"return ``True`` when the :class:`Message` is of type ``message/rfc822``.)" +"Return ``True`` if the message's payload is a list of sub-" +"\\ :class:`Message` objects, otherwise return ``False``. " +"When :meth:`is_multipart` returns ``False``, the payload should be a string " +"object (which might be a CTE encoded binary payload). (Note " +"that :meth:`is_multipart` returning ``True`` does not necessarily mean that " +"\"msg.get_content_maintype() == 'multipart'\" will return the ``True``. For " +"example, ``is_multipart`` will return ``True`` when the :class:`Message` is " +"of type ``message/rfc822``.)" msgstr "" msgid "" @@ -209,8 +212,9 @@ msgstr "" msgid "" "This is a legacy method. On the :class:`~email.message.EmailMessage` class " -"its functionality is replaced by :meth:`~email.message.EmailMessage." -"set_content` and the related ``make`` and ``add`` methods." +"its functionality is replaced " +"by :meth:`~email.message.EmailMessage.set_content` and the related ``make`` " +"and ``add`` methods." msgstr "" msgid "" @@ -225,8 +229,8 @@ msgid "" "element of the payload, counting from zero, if :meth:`is_multipart` is " "``True``. An :exc:`IndexError` will be raised if *i* is less than 0 or " "greater than or equal to the number of items in the payload. If the payload " -"is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, a :" -"exc:`TypeError` is raised." +"is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, " +"a :exc:`TypeError` is raised." msgstr "" msgid "" @@ -248,16 +252,18 @@ msgid "" "When *decode* is ``False`` (the default) the body is returned as a string " "without decoding the :mailheader:`Content-Transfer-Encoding`. However, for " "a :mailheader:`Content-Transfer-Encoding` of 8bit, an attempt is made to " -"decode the original bytes using the ``charset`` specified by the :mailheader:" -"`Content-Type` header, using the ``replace`` error handler. If no " -"``charset`` is specified, or if the ``charset`` given is not recognized by " -"the email package, the body is decoded using the default ASCII charset." +"decode the original bytes using the ``charset`` specified by " +"the :mailheader:`Content-Type` header, using the ``replace`` error handler. " +"If no ``charset`` is specified, or if the ``charset`` given is not " +"recognized by the email package, the body is decoded using the default ASCII " +"charset." msgstr "" msgid "" "This is a legacy method. On the :class:`~email.message.EmailMessage` class " -"its functionality is replaced by :meth:`~email.message.EmailMessage." -"get_content` and :meth:`~email.message.EmailMessage.iter_parts`." +"its functionality is replaced " +"by :meth:`~email.message.EmailMessage.get_content` " +"and :meth:`~email.message.EmailMessage.iter_parts`." msgstr "" msgid "" @@ -268,40 +274,40 @@ msgstr "" msgid "" "This is a legacy method. On the :class:`~email.message.EmailMessage` class " -"its functionality is replaced by :meth:`~email.message.EmailMessage." -"set_content`." +"its functionality is replaced " +"by :meth:`~email.message.EmailMessage.set_content`." msgstr "" msgid "" -"Set the character set of the payload to *charset*, which can either be a :" -"class:`~email.charset.Charset` instance (see :mod:`email.charset`), a string " -"naming a character set, or ``None``. If it is a string, it will be " +"Set the character set of the payload to *charset*, which can either be " +"a :class:`~email.charset.Charset` instance (see :mod:`email.charset`), a " +"string naming a character set, or ``None``. If it is a string, it will be " "converted to a :class:`~email.charset.Charset` instance. If *charset* is " -"``None``, the ``charset`` parameter will be removed from the :mailheader:" -"`Content-Type` header (the message will not be otherwise modified). " -"Anything else will generate a :exc:`TypeError`." +"``None``, the ``charset`` parameter will be removed from " +"the :mailheader:`Content-Type` header (the message will not be otherwise " +"modified). Anything else will generate a :exc:`TypeError`." msgstr "" msgid "" "If there is no existing :mailheader:`MIME-Version` header one will be " "added. If there is no existing :mailheader:`Content-Type` header, one will " -"be added with a value of :mimetype:`text/plain`. Whether the :mailheader:" -"`Content-Type` header already exists or not, its ``charset`` parameter will " -"be set to *charset.output_charset*. If *charset.input_charset* and " -"*charset.output_charset* differ, the payload will be re-encoded to the " -"*output_charset*. If there is no existing :mailheader:`Content-Transfer-" -"Encoding` header, then the payload will be transfer-encoded, if needed, " -"using the specified :class:`~email.charset.Charset`, and a header with the " -"appropriate value will be added. If a :mailheader:`Content-Transfer-" -"Encoding` header already exists, the payload is assumed to already be " -"correctly encoded using that :mailheader:`Content-Transfer-Encoding` and is " -"not modified." +"be added with a value of :mimetype:`text/plain`. Whether " +"the :mailheader:`Content-Type` header already exists or not, its ``charset`` " +"parameter will be set to *charset.output_charset*. If " +"*charset.input_charset* and *charset.output_charset* differ, the payload " +"will be re-encoded to the *output_charset*. If there is no " +"existing :mailheader:`Content-Transfer-Encoding` header, then the payload " +"will be transfer-encoded, if needed, using the " +"specified :class:`~email.charset.Charset`, and a header with the appropriate " +"value will be added. If a :mailheader:`Content-Transfer-Encoding` header " +"already exists, the payload is assumed to already be correctly encoded using " +"that :mailheader:`Content-Transfer-Encoding` and is not modified." msgstr "" msgid "" "This is a legacy method. On the :class:`~email.message.EmailMessage` class " -"its functionality is replaced by the *charset* parameter of the :meth:`email." -"message.EmailMessage.set_content` method." +"its functionality is replaced by the *charset* parameter of " +"the :meth:`email.message.EmailMessage.set_content` method." msgstr "" msgid "" @@ -320,10 +326,11 @@ msgid "" "differences between these methods and a normal mapping (i.e. dictionary) " "interface. For example, in a dictionary there are no duplicate keys, but " "here there may be duplicate message headers. Also, in dictionaries there is " -"no guaranteed order to the keys returned by :meth:`keys`, but in a :class:" -"`Message` object, headers are always returned in the order they appeared in " -"the original message, or were added to the message later. Any header " -"deleted and then re-added are always appended to the end of the header list." +"no guaranteed order to the keys returned by :meth:`keys`, but in " +"a :class:`Message` object, headers are always returned in the order they " +"appeared in the original message, or were added to the message later. Any " +"header deleted and then re-added are always appended to the end of the " +"header list." msgstr "" msgid "" @@ -361,8 +368,8 @@ msgstr "" msgid "" "Return the value of the named header field. *name* should not include the " -"colon field separator. If the header is missing, ``None`` is returned; a :" -"exc:`KeyError` is never raised." +"colon field separator. If the header is missing, ``None`` is returned; " +"a :exc:`KeyError` is never raised." msgstr "" msgid "" @@ -413,9 +420,9 @@ msgstr "" "повідомлення." msgid "" -"Return the value of the named header field. This is identical to :meth:" -"`~object.__getitem__` except that optional *failobj* is returned if the " -"named header is missing (defaults to ``None``)." +"Return the value of the named header field. This is identical " +"to :meth:`~object.__getitem__` except that optional *failobj* is returned if " +"the named header is missing (defaults to ``None``)." msgstr "" msgid "Here are some additional useful methods:" @@ -449,11 +456,11 @@ msgid "" "key will be added. If the value contains non-ASCII characters, it can be " "specified as a three tuple in the format ``(CHARSET, LANGUAGE, VALUE)``, " "where ``CHARSET`` is a string naming the charset to be used to encode the " -"value, ``LANGUAGE`` can usually be set to ``None`` or the empty string (see :" -"rfc:`2231` for other possibilities), and ``VALUE`` is the string value " +"value, ``LANGUAGE`` can usually be set to ``None`` or the empty string " +"(see :rfc:`2231` for other possibilities), and ``VALUE`` is the string value " "containing non-ASCII code points. If a three tuple is not passed and the " -"value contains non-ASCII characters, it is automatically encoded in :rfc:" -"`2231` format using a ``CHARSET`` of ``utf-8`` and a ``LANGUAGE`` of " +"value contains non-ASCII characters, it is automatically encoded " +"in :rfc:`2231` format using a ``CHARSET`` of ``utf-8`` and a ``LANGUAGE`` of " "``None``." msgstr "" @@ -492,11 +499,11 @@ msgstr "" msgid "" "Return the message's content type. The returned string is coerced to lower " -"case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:" -"`Content-Type` header in the message the default type as given by :meth:" -"`get_default_type` will be returned. Since according to :rfc:`2045`, " -"messages always have a default type, :meth:`get_content_type` will always " -"return a value." +"case of the form :mimetype:`maintype/subtype`. If there was " +"no :mailheader:`Content-Type` header in the message the default type as " +"given by :meth:`get_default_type` will be returned. Since according " +"to :rfc:`2045`, messages always have a default " +"type, :meth:`get_content_type` will always return a value." msgstr "" msgid "" @@ -523,8 +530,8 @@ msgstr "" msgid "" "Return the default content type. Most messages have a default content type " -"of :mimetype:`text/plain`, except for messages that are subparts of :" -"mimetype:`multipart/digest` containers. Such subparts have a default " +"of :mimetype:`text/plain`, except for messages that are subparts " +"of :mimetype:`multipart/digest` containers. Such subparts have a default " "content type of :mimetype:`message/rfc822`." msgstr "" "Повернути типовий тип вмісту. Більшість повідомлень мають стандартний тип " @@ -543,14 +550,15 @@ msgid "" "elements of the returned list are 2-tuples of key/value pairs, as split on " "the ``'='`` sign. The left hand side of the ``'='`` is the key, while the " "right hand side is the value. If there is no ``'='`` sign in the parameter " -"the value is the empty string, otherwise the value is as described in :meth:" -"`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." +"the value is the empty string, otherwise the value is as described " +"in :meth:`get_param` and is unquoted if optional *unquote* is ``True`` (the " +"default)." msgstr "" msgid "" -"Optional *failobj* is the object to return if there is no :mailheader:" -"`Content-Type` header. Optional *header* is the header to search instead " -"of :mailheader:`Content-Type`." +"Optional *failobj* is the object to return if there is " +"no :mailheader:`Content-Type` header. Optional *header* is the header to " +"search instead of :mailheader:`Content-Type`." msgstr "" msgid "" @@ -567,8 +575,8 @@ msgid "" msgstr "" msgid "" -"Optional *header* if given, specifies the message header to use instead of :" -"mailheader:`Content-Type`." +"Optional *header* if given, specifies the message header to use instead " +"of :mailheader:`Content-Type`." msgstr "" msgid "" @@ -581,11 +589,12 @@ msgid "" msgstr "" msgid "" -"If your application doesn't care whether the parameter was encoded as in :" -"rfc:`2231`, you can collapse the parameter value by calling :func:`email." -"utils.collapse_rfc2231_value`, passing in the return value from :meth:" -"`get_param`. This will return a suitably decoded Unicode string when the " -"value is a tuple, or the original string unquoted if it isn't. For example::" +"If your application doesn't care whether the parameter was encoded as " +"in :rfc:`2231`, you can collapse the parameter value by " +"calling :func:`email.utils.collapse_rfc2231_value`, passing in the return " +"value from :meth:`get_param`. This will return a suitably decoded Unicode " +"string when the value is a tuple, or the original string unquoted if it " +"isn't. For example::" msgstr "" msgid "" @@ -636,8 +645,8 @@ msgid "" "Remove the given parameter completely from the :mailheader:`Content-Type` " "header. The header will be re-written in place without the parameter or its " "value. All values will be quoted as necessary unless *requote* is ``False`` " -"(the default is ``True``). Optional *header* specifies an alternative to :" -"mailheader:`Content-Type`." +"(the default is ``True``). Optional *header* specifies an alternative " +"to :mailheader:`Content-Type`." msgstr "" msgid "" @@ -654,9 +663,9 @@ msgid "" msgstr "" msgid "" -"An alternative header can be specified in the *header* argument. When the :" -"mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " -"is also added." +"An alternative header can be specified in the *header* argument. When " +"the :mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` " +"header is also added." msgstr "" msgid "" @@ -674,10 +683,10 @@ msgid "" msgstr "" "Повертає значення параметра ``filename`` заголовка :mailheader:`Content-" "Disposition` повідомлення. Якщо заголовок не має параметра ``filename``, цей " -"метод повертається до пошуку параметра ``name`` у заголовку :mailheader:" -"`Content-Type`. Якщо нічого не знайдено або відсутній заголовок, " -"повертається *failobj*. Повернений рядок завжди буде без лапок відповідно " -"до :func:`email.utils.unquote`." +"метод повертається до пошуку параметра ``name`` у " +"заголовку :mailheader:`Content-Type`. Якщо нічого не знайдено або відсутній " +"заголовок, повертається *failobj*. Повернений рядок завжди буде без лапок " +"відповідно до :func:`email.utils.unquote`." msgid "" "Return the value of the ``boundary`` parameter of the :mailheader:`Content-" @@ -702,12 +711,12 @@ msgstr "" "об’єкт повідомлення не має заголовка :mailheader:`Content-Type`." msgid "" -"Note that using this method is subtly different than deleting the old :" -"mailheader:`Content-Type` header and adding a new one with the new boundary " -"via :meth:`add_header`, because :meth:`set_boundary` preserves the order of " -"the :mailheader:`Content-Type` header in the list of headers. However, it " -"does *not* preserve any continuation lines which may have been present in " -"the original :mailheader:`Content-Type` header." +"Note that using this method is subtly different than deleting the " +"old :mailheader:`Content-Type` header and adding a new one with the new " +"boundary via :meth:`add_header`, because :meth:`set_boundary` preserves the " +"order of the :mailheader:`Content-Type` header in the list of headers. " +"However, it does *not* preserve any continuation lines which may have been " +"present in the original :mailheader:`Content-Type` header." msgstr "" msgid "" @@ -720,8 +729,8 @@ msgstr "" "заголовок не має параметра ``charset``, повертається *failobj*." msgid "" -"Note that this method differs from :meth:`get_charset` which returns the :" -"class:`~email.charset.Charset` instance for the default encoding of the " +"Note that this method differs from :meth:`get_charset` which returns " +"the :class:`~email.charset.Charset` instance for the default encoding of the " "message body." msgstr "" @@ -743,10 +752,10 @@ msgid "" msgstr "" msgid "" -"Return the lowercased value (without parameters) of the message's :" -"mailheader:`Content-Disposition` header if it has one, or ``None``. The " -"possible values for this method are *inline*, *attachment* or ``None`` if " -"the message follows :rfc:`2183`." +"Return the lowercased value (without parameters) of the " +"message's :mailheader:`Content-Disposition` header if it has one, or " +"``None``. The possible values for this method are *inline*, *attachment* or " +"``None`` if the message follows :rfc:`2183`." msgstr "" "Повертає значення в нижньому регістрі (без параметрів) заголовка " "повідомлення :mailheader:`Content-Disposition`, якщо воно є, або ``None``. " @@ -849,11 +858,12 @@ msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " "the headers but before the first boundary string, it assigns this text to " -"the message's *preamble* attribute. When the :class:`~email.generator." -"Generator` is writing out the plain text representation of a MIME message, " -"and it finds the message has a *preamble* attribute, it will write this text " -"in the area between the headers and the first boundary. See :mod:`email." -"parser` and :mod:`email.generator` for details." +"the message's *preamble* attribute. When " +"the :class:`~email.generator.Generator` is writing out the plain text " +"representation of a MIME message, and it finds the message has a *preamble* " +"attribute, it will write this text in the area between the headers and the " +"first boundary. See :mod:`email.parser` and :mod:`email.generator` for " +"details." msgstr "" "Атрибут *преамбула* містить цей провідний додатковий текст для документів " "MIME. Коли :class:`~email.parser.Parser` виявляє текст після заголовків, але " @@ -878,8 +888,9 @@ msgid "" msgstr "" msgid "" -"You do not need to set the epilogue to the empty string in order for the :" -"class:`~email.generator.Generator` to print a newline at the end of the file." +"You do not need to set the epilogue to the empty string in order for " +"the :class:`~email.generator.Generator` to print a newline at the end of the " +"file." msgstr "" msgid "" diff --git a/library/email.contentmanager.po b/library/email.contentmanager.po index 7749a3b598..0b6a225451 100644 --- a/library/email.contentmanager.po +++ b/library/email.contentmanager.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -84,8 +84,8 @@ msgid "the type itself (``typ``)" msgstr "" msgid "" -"the type's fully qualified name (``typ.__module__ + '.' + typ." -"__qualname__``)." +"the type's fully qualified name (``typ.__module__ + '.' + " +"typ.__qualname__``)." msgstr "" msgid "the type's :attr:`qualname ` (``typ.__qualname__``)" @@ -122,31 +122,32 @@ msgid "Content Manager Instances" msgstr "" msgid "" -"Currently the email package provides only one concrete content manager, :" -"data:`raw_data_manager`, although more may be added in the future. :data:" -"`raw_data_manager` is the :attr:`~email.policy.EmailPolicy.content_manager` " -"provided by :attr:`~email.policy.EmailPolicy` and its derivatives." +"Currently the email package provides only one concrete content " +"manager, :data:`raw_data_manager`, although more may be added in the " +"future. :data:`raw_data_manager` is " +"the :attr:`~email.policy.EmailPolicy.content_manager` provided " +"by :attr:`~email.policy.EmailPolicy` and its derivatives." msgstr "" msgid "" "This content manager provides only a minimum interface beyond that provided " "by :class:`~email.message.Message` itself: it deals only with text, raw " -"byte strings, and :class:`~email.message.Message` objects. Nevertheless, it " +"bytes, and :class:`~email.message.Message` objects. Nevertheless, it " "provides significant advantages compared to the base API: ``get_content`` on " -"a text part will return a unicode string without the application needing to " -"manually decode it, ``set_content`` provides a rich set of options for " -"controlling the headers added to a part and controlling the content transfer " -"encoding, and it enables the use of the various ``add_`` methods, thereby " -"simplifying the creation of multipart messages." +"a text part will return a string without the application needing to manually " +"decode it, ``set_content`` provides a rich set of options for controlling " +"the headers added to a part and controlling the content transfer encoding, " +"and it enables the use of the various ``add_`` methods, thereby simplifying " +"the creation of multipart messages." msgstr "" msgid "" -"Return the payload of the part as either a string (for ``text`` parts), an :" -"class:`~email.message.EmailMessage` object (for ``message/rfc822`` parts), " -"or a ``bytes`` object (for all other non-multipart types). Raise a :exc:" -"`KeyError` if called on a ``multipart``. If the part is a ``text`` part and " -"*errors* is specified, use it as the error handler when decoding the payload " -"to unicode. The default error handler is ``replace``." +"Return the payload of the part as either a string (for ``text`` parts), " +"an :class:`~email.message.EmailMessage` object (for ``message/rfc822`` " +"parts), or a ``bytes`` object (for all other non-multipart types). Raise " +"a :exc:`KeyError` if called on a ``multipart``. If the part is a ``text`` " +"part and *errors* is specified, use it as the error handler when decoding " +"the payload to a string. The default error handler is ``replace``." msgstr "" msgid "Add headers and payload to *msg*:" @@ -162,8 +163,8 @@ msgid "" msgstr "" msgid "" -"For ``bytes``, use the specified *maintype* and *subtype*, or raise a :exc:" -"`TypeError` if they are not specified." +"For ``bytes``, use the specified *maintype* and *subtype*, or raise " +"a :exc:`TypeError` if they are not specified." msgstr "" msgid "" @@ -212,8 +213,8 @@ msgstr "" msgid "" "A *cte* of ``binary`` does not actually work correctly yet. The " -"``EmailMessage`` object as modified by ``set_content`` is correct, but :" -"class:`~email.generator.BytesGenerator` does not serialize it correctly." +"``EmailMessage`` object as modified by ``set_content`` is correct, " +"but :class:`~email.generator.BytesGenerator` does not serialize it correctly." msgstr "" msgid "" @@ -236,8 +237,8 @@ msgstr "" msgid "" "If *params* is specified, iterate its ``items`` method and use the resulting " -"``(key, value)`` pairs to set additional parameters on the :mailheader:" -"`Content-Type` header." +"``(key, value)`` pairs to set additional parameters on " +"the :mailheader:`Content-Type` header." msgstr "" msgid "" diff --git a/library/email.encoders.po b/library/email.encoders.po index 3f66fbc332..79bf044128 100644 --- a/library/email.encoders.po +++ b/library/email.encoders.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,8 +31,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/email/encoders.py`" msgid "" "This module is part of the legacy (``Compat32``) email API. In the new API " -"the functionality is provided by the *cte* parameter of the :meth:`~email." -"message.EmailMessage.set_content` method." +"the functionality is provided by the *cte* parameter of " +"the :meth:`~email.message.EmailMessage.set_content` method." msgstr "" msgid "" @@ -50,35 +50,35 @@ msgstr "" msgid "" "When creating :class:`~email.message.Message` objects from scratch, you " "often need to encode the payloads for transport through compliant mail " -"servers. This is especially true for :mimetype:`image/\\*` and :mimetype:" -"`text/\\*` type messages containing binary data." +"servers. This is especially true for :mimetype:`image/\\*` " +"and :mimetype:`text/\\*` type messages containing binary data." msgstr "" msgid "" "The :mod:`email` package provides some convenient encoders in its :mod:`!" -"encoders` module. These encoders are actually used by the :class:`~email." -"mime.audio.MIMEAudio` and :class:`~email.mime.image.MIMEImage` class " -"constructors to provide default encodings. All encoder functions take " -"exactly one argument, the message object to encode. They usually extract " -"the payload, encode it, and reset the payload to this newly encoded value. " -"They should also set the :mailheader:`Content-Transfer-Encoding` header as " -"appropriate." +"encoders` module. These encoders are actually used by " +"the :class:`~email.mime.audio.MIMEAudio` " +"and :class:`~email.mime.image.MIMEImage` class constructors to provide " +"default encodings. All encoder functions take exactly one argument, the " +"message object to encode. They usually extract the payload, encode it, and " +"reset the payload to this newly encoded value. They should also set " +"the :mailheader:`Content-Transfer-Encoding` header as appropriate." msgstr "" msgid "" "Note that these functions are not meaningful for a multipart message. They " -"must be applied to individual subparts instead, and will raise a :exc:" -"`TypeError` if passed a message whose type is multipart." +"must be applied to individual subparts instead, and will raise " +"a :exc:`TypeError` if passed a message whose type is multipart." msgstr "" msgid "Here are the encoding functions provided:" msgstr "" msgid "" -"Encodes the payload into quoted-printable form and sets the :mailheader:" -"`Content-Transfer-Encoding` header to ``quoted-printable`` [#]_. This is a " -"good encoding to use when most of your payload is normal printable data, but " -"contains a few unprintable characters." +"Encodes the payload into quoted-printable form and sets " +"the :mailheader:`Content-Transfer-Encoding` header to ``quoted-printable`` " +"[#]_. This is a good encoding to use when most of your payload is normal " +"printable data, but contains a few unprintable characters." msgstr "" msgid "" @@ -90,9 +90,9 @@ msgid "" msgstr "" msgid "" -"This doesn't actually modify the message's payload, but it does set the :" -"mailheader:`Content-Transfer-Encoding` header to either ``7bit`` or ``8bit`` " -"as appropriate, based on the payload data." +"This doesn't actually modify the message's payload, but it does set " +"the :mailheader:`Content-Transfer-Encoding` header to either ``7bit`` or " +"``8bit`` as appropriate, based on the payload data." msgstr "" msgid "" diff --git a/library/email.errors.po b/library/email.errors.po index c77f06eb8d..4ce749885a 100644 --- a/library/email.errors.po +++ b/library/email.errors.po @@ -41,20 +41,22 @@ msgid "" msgstr "" msgid "" -"This is the base class for exceptions raised by the :class:`~email.parser." -"Parser` class. It is derived from :exc:`MessageError`. This class is also " -"used internally by the parser used by :mod:`~email.headerregistry`." +"This is the base class for exceptions raised by " +"the :class:`~email.parser.Parser` class. It is derived " +"from :exc:`MessageError`. This class is also used internally by the parser " +"used by :mod:`~email.headerregistry`." msgstr "" msgid "" "Raised under some error conditions when parsing the :rfc:`5322` headers of a " -"message, this class is derived from :exc:`MessageParseError`. The :meth:" -"`~email.message.EmailMessage.set_boundary` method will raise this error if " -"the content type is unknown when the method is called. :class:`~email.header." -"Header` may raise this error for certain base64 decoding errors, and when an " -"attempt is made to create a header that appears to contain an embedded " -"header (that is, there is what is supposed to be a continuation line that " -"has no leading whitespace and looks like a header)." +"message, this class is derived from :exc:`MessageParseError`. " +"The :meth:`~email.message.EmailMessage.set_boundary` method will raise this " +"error if the content type is unknown when the method is " +"called. :class:`~email.header.Header` may raise this error for certain " +"base64 decoding errors, and when an attempt is made to create a header that " +"appears to contain an embedded header (that is, there is what is supposed to " +"be a continuation line that has no leading whitespace and looks like a " +"header)." msgstr "" msgid "Deprecated and no longer used." @@ -63,17 +65,17 @@ msgstr "" msgid "" "Raised when a payload is added to a :class:`~email.message.Message` object " "using :meth:`add_payload`, but the payload is already a scalar and the " -"message's :mailheader:`Content-Type` main type is not either :mimetype:" -"`multipart` or missing. :exc:`MultipartConversionError` multiply inherits " -"from :exc:`MessageError` and the built-in :exc:`TypeError`." +"message's :mailheader:`Content-Type` main type is not " +"either :mimetype:`multipart` or missing. :exc:`MultipartConversionError` " +"multiply inherits from :exc:`MessageError` and the built-in :exc:`TypeError`." msgstr "" msgid "" "Since :meth:`Message.add_payload` is deprecated, this exception is rarely " -"raised in practice. However the exception may also be raised if the :meth:" -"`~email.message.Message.attach` method is called on an instance of a class " -"derived from :class:`~email.mime.nonmultipart.MIMENonMultipart` (e.g. :class:" -"`~email.mime.image.MIMEImage`)." +"raised in practice. However the exception may also be raised if " +"the :meth:`~email.message.Message.attach` method is called on an instance of " +"a class derived from :class:`~email.mime.nonmultipart.MIMENonMultipart` " +"(e.g. :class:`~email.mime.image.MIMEImage`)." msgstr "" msgid "" @@ -95,8 +97,8 @@ msgid "" msgstr "" msgid "" -":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in the :" -"mailheader:`Content-Type` header was never found." +":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in " +"the :mailheader:`Content-Type` header was never found." msgstr "" msgid "" @@ -129,11 +131,11 @@ msgid "This defect has not been used for several Python versions." msgstr "" msgid "" -":class:`MultipartInvariantViolationDefect` -- A message claimed to be a :" -"mimetype:`multipart`, but no subparts were found. Note that when a message " -"has this defect, its :meth:`~email.message.Message.is_multipart` method may " -"return ``False`` even though its content type claims to be :mimetype:" -"`multipart`." +":class:`MultipartInvariantViolationDefect` -- A message claimed to be " +"a :mimetype:`multipart`, but no subparts were found. Note that when a " +"message has this defect, its :meth:`~email.message.Message.is_multipart` " +"method may return ``False`` even though its content type claims to " +"be :mimetype:`multipart`." msgstr "" msgid "" diff --git a/library/email.examples.po b/library/email.examples.po index 9ad4761e5a..b4de142519 100644 --- a/library/email.examples.po +++ b/library/email.examples.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,7 +33,7 @@ msgstr "" msgid "" "First, let's see how to create and send a simple text message (both the text " -"content and the addresses may contain unicode characters):" +"content and the addresses may contain Unicode characters):" msgstr "" msgid "" @@ -415,8 +415,8 @@ msgid "" " elif richest['content-type'].subtype == 'html':\n" " body = richest\n" " else:\n" -" print(\"Don't know how to display {}\".format(richest." -"get_content_type()))\n" +" print(\"Don't know how to display {}" +"\".format(richest.get_content_type()))\n" " sys.exit()\n" "elif richest['content-type'].content_type == 'multipart/related':\n" " body = richest.get_body(preferencelist=('html'))\n" @@ -432,8 +432,8 @@ msgid "" " # again strip the <> to go from email form of cid to html form.\n" " partfiles[part['content-id'][1:-1]] = f.name\n" "else:\n" -" print(\"Don't know how to display {}\".format(richest." -"get_content_type()))\n" +" print(\"Don't know how to display {}" +"\".format(richest.get_content_type()))\n" " sys.exit()\n" "with tempfile.NamedTemporaryFile(mode='w', delete=False) as f:\n" " f.write(magic_html_parser(body.get_content(), partfiles))\n" diff --git a/library/email.generator.po b/library/email.generator.po index ad6d14de7b..022221d159 100644 --- a/library/email.generator.po +++ b/library/email.generator.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,10 +32,10 @@ msgstr "**Kod źródłowy:** :source:`Lib/email/generator.py`" msgid "" "One of the most common tasks is to generate the flat (serialized) version of " "the email message represented by a message object structure. You will need " -"to do this if you want to send your message via :meth:`smtplib.SMTP." -"sendmail`, or print the message on the console. Taking a message object " -"structure and producing a serialized representation is the job of the " -"generator classes." +"to do this if you want to send your message " +"via :meth:`smtplib.SMTP.sendmail`, or print the message on the console. " +"Taking a message object structure and producing a serialized representation " +"is the job of the generator classes." msgstr "" msgid "" @@ -44,14 +44,14 @@ msgid "" "yourself. However the bundled generator knows how to generate most email in " "a standards-compliant way, should handle MIME and non-MIME email messages " "just fine, and is designed so that the bytes-oriented parsing and generation " -"operations are inverses, assuming the same non-transforming :mod:`~email." -"policy` is used for both. That is, parsing the serialized byte stream via " -"the :class:`~email.parser.BytesParser` class and then regenerating the " -"serialized byte stream using :class:`BytesGenerator` should produce output " -"identical to the input [#]_. (On the other hand, using the generator on an :" -"class:`~email.message.EmailMessage` constructed by program may result in " -"changes to the :class:`~email.message.EmailMessage` object as defaults are " -"filled in.)" +"operations are inverses, assuming the same non-" +"transforming :mod:`~email.policy` is used for both. That is, parsing the " +"serialized byte stream via the :class:`~email.parser.BytesParser` class and " +"then regenerating the serialized byte stream using :class:`BytesGenerator` " +"should produce output identical to the input [#]_. (On the other hand, " +"using the generator on an :class:`~email.message.EmailMessage` constructed " +"by program may result in changes to the :class:`~email.message.EmailMessage` " +"object as defaults are filled in.)" msgstr "" msgid "" @@ -64,9 +64,9 @@ msgid "" msgstr "" msgid "" -"To accommodate reproducible processing of SMIME-signed messages :class:" -"`Generator` disables header folding for message parts of type ``multipart/" -"signed`` and all subparts." +"To accommodate reproducible processing of SMIME-signed " +"messages :class:`Generator` disables header folding for message parts of " +"type ``multipart/signed`` and all subparts." msgstr "" msgid "" @@ -81,26 +81,26 @@ msgid "" "any line in the body that starts with the exact string ``\"From \"``, that " "is ``From`` followed by a space at the beginning of a line. *mangle_from_* " "defaults to the value of the :attr:`~email.policy.Policy.mangle_from_` " -"setting of the *policy* (which is ``True`` for the :data:`~email.policy." -"compat32` policy and ``False`` for all others). *mangle_from_* is intended " -"for use when messages are stored in Unix mbox format (see :mod:`mailbox` and " -"`WHY THE CONTENT-LENGTH FORMAT IS BAD `_)." +"setting of the *policy* (which is ``True`` for " +"the :data:`~email.policy.compat32` policy and ``False`` for all others). " +"*mangle_from_* is intended for use when messages are stored in Unix mbox " +"format (see :mod:`mailbox` and `WHY THE CONTENT-LENGTH FORMAT IS BAD " +"`_)." msgstr "" msgid "" "If *maxheaderlen* is not ``None``, refold any header lines that are longer " "than *maxheaderlen*, or if ``0``, do not rewrap any headers. If " -"*manheaderlen* is ``None`` (the default), wrap headers and other message " +"*maxheaderlen* is ``None`` (the default), wrap headers and other message " "lines according to the *policy* settings." msgstr "" msgid "" "If *policy* is specified, use that policy to control message generation. If " -"*policy* is ``None`` (the default), use the policy associated with the :" -"class:`~email.message.Message` or :class:`~email.message.EmailMessage` " -"object passed to ``flatten`` to control the message generation. See :mod:" -"`email.policy` for details on what *policy* controls." +"*policy* is ``None`` (the default), use the policy associated with " +"the :class:`~email.message.Message` or :class:`~email.message.EmailMessage` " +"object passed to ``flatten`` to control the message generation. " +"See :mod:`email.policy` for details on what *policy* controls." msgstr "" msgid "Added the *policy* keyword." @@ -121,15 +121,15 @@ msgid "" "If the :mod:`~email.policy` option :attr:`~email.policy.Policy.cte_type` is " "``8bit`` (the default), copy any headers in the original parsed message that " "have not been modified to the output with any bytes with the high bit set " -"reproduced as in the original, and preserve the non-ASCII :mailheader:" -"`Content-Transfer-Encoding` of any body parts that have them. If " -"``cte_type`` is ``7bit``, convert the bytes with the high bit set as needed " -"using an ASCII-compatible :mailheader:`Content-Transfer-Encoding`. That is, " -"transform parts with non-ASCII :mailheader:`Content-Transfer-Encoding` (:" -"mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII compatible :" -"mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid non-ASCII " -"bytes in headers using the MIME ``unknown-8bit`` character set, thus " -"rendering them RFC-compliant." +"reproduced as in the original, and preserve the non-" +"ASCII :mailheader:`Content-Transfer-Encoding` of any body parts that have " +"them. If ``cte_type`` is ``7bit``, convert the bytes with the high bit set " +"as needed using an ASCII-compatible :mailheader:`Content-Transfer-Encoding`. " +"That is, transform parts with non-ASCII :mailheader:`Content-Transfer-" +"Encoding` (:mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII " +"compatible :mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid " +"non-ASCII bytes in headers using the MIME ``unknown-8bit`` character set, " +"thus rendering them RFC-compliant." msgstr "" msgid "" @@ -153,26 +153,27 @@ msgstr "" msgid "" "Encode *s* using the ``ASCII`` codec and the ``surrogateescape`` error " -"handler, and pass it to the *write* method of the *outfp* passed to the :" -"class:`BytesGenerator`'s constructor." +"handler, and pass it to the *write* method of the *outfp* passed to " +"the :class:`BytesGenerator`'s constructor." msgstr "" msgid "" -"As a convenience, :class:`~email.message.EmailMessage` provides the methods :" -"meth:`~email.message.EmailMessage.as_bytes` and ``bytes(aMessage)`` (a.k.a. :" -"meth:`~email.message.EmailMessage.__bytes__`), which simplify the generation " -"of a serialized binary representation of a message object. For more detail, " -"see :mod:`email.message`." +"As a convenience, :class:`~email.message.EmailMessage` provides the " +"methods :meth:`~email.message.EmailMessage.as_bytes` and ``bytes(aMessage)`` " +"(a.k.a. :meth:`~email.message.EmailMessage.__bytes__`), which simplify the " +"generation of a serialized binary representation of a message object. For " +"more detail, see :mod:`email.message`." msgstr "" msgid "" "Because strings cannot represent binary data, the :class:`Generator` class " "must convert any binary data in any message it flattens to an ASCII " -"compatible format, by converting them to an ASCII compatible :mailheader:" -"`Content-Transfer_Encoding`. Using the terminology of the email RFCs, you " -"can think of this as :class:`Generator` serializing to an I/O stream that is " -"not \"8 bit clean\". In other words, most applications will want to be " -"using :class:`BytesGenerator`, and not :class:`Generator`." +"compatible format, by converting them to an ASCII " +"compatible :mailheader:`Content-Transfer-Encoding`. Using the terminology " +"of the email RFCs, you can think of this as :class:`Generator` serializing " +"to an I/O stream that is not \"8 bit clean\". In other words, most " +"applications will want to be using :class:`BytesGenerator`, and " +"not :class:`Generator`." msgstr "" msgid "" @@ -192,12 +193,13 @@ msgid "" "If the :mod:`~email.policy` option :attr:`~email.policy.Policy.cte_type` is " "``8bit``, generate the message as if the option were set to ``7bit``. (This " "is required because strings cannot represent non-ASCII bytes.) Convert any " -"bytes with the high bit set as needed using an ASCII-compatible :mailheader:" -"`Content-Transfer-Encoding`. That is, transform parts with non-ASCII :" -"mailheader:`Content-Transfer-Encoding` (:mailheader:`Content-Transfer-" -"Encoding: 8bit`) to an ASCII compatible :mailheader:`Content-Transfer-" -"Encoding`, and encode RFC-invalid non-ASCII bytes in headers using the MIME " -"``unknown-8bit`` character set, thus rendering them RFC-compliant." +"bytes with the high bit set as needed using an ASCII-" +"compatible :mailheader:`Content-Transfer-Encoding`. That is, transform " +"parts with non-ASCII :mailheader:`Content-Transfer-Encoding` " +"(:mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII " +"compatible :mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid " +"non-ASCII bytes in headers using the MIME ``unknown-8bit`` character set, " +"thus rendering them RFC-compliant." msgstr "" msgid "" @@ -211,32 +213,33 @@ msgid "" msgstr "" msgid "" -"Write *s* to the *write* method of the *outfp* passed to the :class:" -"`Generator`'s constructor. This provides just enough file-like API for :" -"class:`Generator` instances to be used in the :func:`print` function." +"Write *s* to the *write* method of the *outfp* passed to " +"the :class:`Generator`'s constructor. This provides just enough file-like " +"API for :class:`Generator` instances to be used in the :func:`print` " +"function." msgstr "" msgid "" -"As a convenience, :class:`~email.message.EmailMessage` provides the methods :" -"meth:`~email.message.EmailMessage.as_string` and ``str(aMessage)`` (a.k.a. :" -"meth:`~email.message.EmailMessage.__str__`), which simplify the generation " -"of a formatted string representation of a message object. For more detail, " -"see :mod:`email.message`." +"As a convenience, :class:`~email.message.EmailMessage` provides the " +"methods :meth:`~email.message.EmailMessage.as_string` and ``str(aMessage)`` " +"(a.k.a. :meth:`~email.message.EmailMessage.__str__`), which simplify the " +"generation of a formatted string representation of a message object. For " +"more detail, see :mod:`email.message`." msgstr "" msgid "" -"The :mod:`!email.generator` module also provides a derived class, :class:" -"`DecodedGenerator`, which is like the :class:`Generator` base class, except " -"that non-\\ :mimetype:`text` parts are not serialized, but are instead " -"represented in the output stream by a string derived from a template filled " -"in with information about the part." +"The :mod:`!email.generator` module also provides a derived " +"class, :class:`DecodedGenerator`, which is like the :class:`Generator` base " +"class, except that non-\\ :mimetype:`text` parts are not serialized, but are " +"instead represented in the output stream by a string derived from a template " +"filled in with information about the part." msgstr "" msgid "" "Act like :class:`Generator`, except that for any subpart of the message " -"passed to :meth:`Generator.flatten`, if the subpart is of main type :" -"mimetype:`text`, print the decoded payload of the subpart, and if the main " -"type is not :mimetype:`text`, instead of printing it fill in the string " +"passed to :meth:`Generator.flatten`, if the subpart is of main " +"type :mimetype:`text`, print the decoded payload of the subpart, and if the " +"main type is not :mimetype:`text`, instead of printing it fill in the string " "*fmt* using information from the part and print the resulting filled-in " "string." msgstr "" @@ -276,8 +279,8 @@ msgstr "" "\"[Non-text (%(type)s) part of message omitted, filename %(filename)s]\"" msgid "" -"Optional *_mangle_from_* and *maxheaderlen* are as with the :class:" -"`Generator` base class." +"Optional *mangle_from_* and *maxheaderlen* are as with " +"the :class:`Generator` base class." msgstr "" msgid "Footnotes" @@ -286,10 +289,10 @@ msgstr "Przypisy" msgid "" "This statement assumes that you use the appropriate setting for " "``unixfrom``, and that there are no :mod:`email.policy` settings calling for " -"automatic adjustments (for example, :attr:`~email.policy.EmailPolicy." -"refold_source` must be ``none``, which is *not* the default). It is also " -"not 100% true, since if the message does not conform to the RFC standards " -"occasionally information about the exact original text is lost during " -"parsing error recovery. It is a goal to fix these latter edge cases when " -"possible." +"automatic adjustments (for " +"example, :attr:`~email.policy.EmailPolicy.refold_source` must be ``none``, " +"which is *not* the default). It is also not 100% true, since if the message " +"does not conform to the RFC standards occasionally information about the " +"exact original text is lost during parsing error recovery. It is a goal to " +"fix these latter edge cases when possible." msgstr "" diff --git a/library/email.header.po b/library/email.header.po index 44e52acc19..9c23c7066d 100644 --- a/library/email.header.po +++ b/library/email.header.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -57,18 +57,19 @@ msgid "" "used in email messages. The base standard still requires email messages to " "be transferred using only 7-bit ASCII characters, so a slew of RFCs have " "been written describing how to encode email containing non-ASCII characters " -"into :rfc:`2822`\\ -compliant format. These RFCs include :rfc:`2045`, :rfc:" -"`2046`, :rfc:`2047`, and :rfc:`2231`. The :mod:`email` package supports " -"these standards in its :mod:`!email.header` and :mod:`email.charset` modules." +"into :rfc:`2822`\\ -compliant format. These RFCs " +"include :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, and :rfc:`2231`. " +"The :mod:`email` package supports these standards in its :mod:`!" +"email.header` and :mod:`email.charset` modules." msgstr "" msgid "" "If you want to include non-ASCII characters in your email headers, say in " -"the :mailheader:`Subject` or :mailheader:`To` fields, you should use the :" -"class:`Header` class and assign the field in the :class:`~email.message." -"Message` object to an instance of :class:`Header` instead of using a string " -"for the header value. Import the :class:`Header` class from the :mod:`!" -"email.header` module. For example::" +"the :mailheader:`Subject` or :mailheader:`To` fields, you should use " +"the :class:`Header` class and assign the field in " +"the :class:`~email.message.Message` object to an instance of :class:`Header` " +"instead of using a string for the header value. Import the :class:`Header` " +"class from the :mod:`!email.header` module. For example::" msgstr "" msgid "" @@ -84,10 +85,11 @@ msgstr "" msgid "" "Notice here how we wanted the :mailheader:`Subject` field to contain a non-" "ASCII character? We did this by creating a :class:`Header` instance and " -"passing in the character set that the byte string was encoded in. When the " -"subsequent :class:`~email.message.Message` instance was flattened, the :" -"mailheader:`Subject` field was properly :rfc:`2047` encoded. MIME-aware " -"mail readers would show this header using the embedded ISO-8859-1 character." +"passing in the character set to use when encoding it. When the " +"subsequent :class:`~email.message.Message` instance was flattened, " +"the :mailheader:`Subject` field was properly :rfc:`2047` encoded. MIME-" +"aware mail readers would show this header using the embedded ISO-8859-1 " +"character." msgstr "" msgid "Here is the :class:`Header` class description:" @@ -100,9 +102,9 @@ msgstr "" msgid "" "Optional *s* is the initial header value. If ``None`` (the default), the " -"initial header value is not set. You can later append to the header with :" -"meth:`append` method calls. *s* may be an instance of :class:`bytes` or :" -"class:`str`, but see the :meth:`append` documentation for semantics." +"initial header value is not set. You can later append to the header " +"with :meth:`append` method calls. *s* may be an instance of :class:`bytes` " +"or :class:`str`, but see the :meth:`append` documentation for semantics." msgstr "" msgid "" @@ -158,9 +160,9 @@ msgid "" msgstr "" msgid "" -"In either case, when producing an :rfc:`2822`\\ -compliant header using :rfc:" -"`2047` rules, the string will be encoded using the output codec of the " -"charset. If the string cannot be encoded using the output codec, a " +"In either case, when producing an :rfc:`2822`\\ -compliant header " +"using :rfc:`2047` rules, the string will be encoded using the output codec " +"of the charset. If the string cannot be encoded using the output codec, a " "UnicodeError will be raised." msgstr "" @@ -209,10 +211,10 @@ msgstr "" msgid "" "Returns an approximation of the :class:`Header` as a string, using an " -"unlimited line length. All pieces are converted to unicode using the " -"specified encoding and joined together appropriately. Any pieces with a " -"charset of ``'unknown-8bit'`` are decoded as ASCII using the ``'replace'`` " -"error handler." +"unlimited line length. All pieces are decoded using the specified encoding " +"and joined together appropriately. Any pieces with a charset of " +"``'unknown-8bit'`` are decoded as ASCII using the ``'replace'`` error " +"handler." msgstr "" msgid "Added handling for the ``'unknown-8bit'`` charset." @@ -271,8 +273,8 @@ msgid "" msgstr "" msgid "" -"Create a :class:`Header` instance from a sequence of pairs as returned by :" -"func:`decode_header`." +"Create a :class:`Header` instance from a sequence of pairs as returned " +"by :func:`decode_header`." msgstr "" msgid "" @@ -282,8 +284,8 @@ msgid "" msgstr "" msgid "" -"This function takes one of those sequence of pairs and returns a :class:" -"`Header` instance. Optional *maxlinelen*, *header_name*, and " +"This function takes one of those sequence of pairs and returns " +"a :class:`Header` instance. Optional *maxlinelen*, *header_name*, and " "*continuation_ws* are as in the :class:`Header` constructor." msgstr "" diff --git a/library/email.headerregistry.po b/library/email.headerregistry.po index 8ae9a6bdf4..0d7dd91f49 100644 --- a/library/email.headerregistry.po +++ b/library/email.headerregistry.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -34,39 +34,41 @@ msgstr "[1]_" msgid "" "Headers are represented by customized subclasses of :class:`str`. The " -"particular class used to represent a given header is determined by the :attr:" -"`~email.policy.EmailPolicy.header_factory` of the :mod:`~email.policy` in " -"effect when the headers are created. This section documents the particular " -"``header_factory`` implemented by the email package for handling :RFC:`5322` " -"compliant email messages, which not only provides customized header objects " -"for various header types, but also provides an extension mechanism for " -"applications to add their own custom header types." +"particular class used to represent a given header is determined by " +"the :attr:`~email.policy.EmailPolicy.header_factory` of " +"the :mod:`~email.policy` in effect when the headers are created. This " +"section documents the particular ``header_factory`` implemented by the email " +"package for handling :RFC:`5322` compliant email messages, which not only " +"provides customized header objects for various header types, but also " +"provides an extension mechanism for applications to add their own custom " +"header types." msgstr "" msgid "" -"When using any of the policy objects derived from :data:`~email.policy." -"EmailPolicy`, all headers are produced by :class:`.HeaderRegistry` and have :" -"class:`.BaseHeader` as their last base class. Each header class has an " -"additional base class that is determined by the type of the header. For " -"example, many headers have the class :class:`.UnstructuredHeader` as their " -"other base class. The specialized second class for a header is determined " -"by the name of the header, using a lookup table stored in the :class:`." -"HeaderRegistry`. All of this is managed transparently for the typical " -"application program, but interfaces are provided for modifying the default " -"behavior for use by more complex applications." +"When using any of the policy objects derived " +"from :data:`~email.policy.EmailPolicy`, all headers are produced " +"by :class:`.HeaderRegistry` and have :class:`.BaseHeader` as their last base " +"class. Each header class has an additional base class that is determined by " +"the type of the header. For example, many headers have the " +"class :class:`.UnstructuredHeader` as their other base class. The " +"specialized second class for a header is determined by the name of the " +"header, using a lookup table stored in the :class:`.HeaderRegistry`. All of " +"this is managed transparently for the typical application program, but " +"interfaces are provided for modifying the default behavior for use by more " +"complex applications." msgstr "" msgid "" "The sections below first document the header base classes and their " -"attributes, followed by the API for modifying the behavior of :class:`." -"HeaderRegistry`, and finally the support classes used to represent the data " -"parsed from structured headers." +"attributes, followed by the API for modifying the behavior " +"of :class:`.HeaderRegistry`, and finally the support classes used to " +"represent the data parsed from structured headers." msgstr "" msgid "" -"*name* and *value* are passed to ``BaseHeader`` from the :attr:`~email." -"policy.EmailPolicy.header_factory` call. The string value of any header " -"object is the *value* fully decoded to unicode." +"*name* and *value* are passed to ``BaseHeader`` from " +"the :attr:`~email.policy.EmailPolicy.header_factory` call. The string value " +"of any header object is the *value* fully decoded to a string." msgstr "" msgid "This base class defines the following read-only properties:" @@ -74,8 +76,9 @@ msgstr "" msgid "" "The name of the header (the portion of the field before the ':'). This is " -"exactly the value passed in the :attr:`~email.policy.EmailPolicy." -"header_factory` call for *name*; that is, case is preserved." +"exactly the value passed in " +"the :attr:`~email.policy.EmailPolicy.header_factory` call for *name*; that " +"is, case is preserved." msgstr "" msgid "" @@ -100,11 +103,11 @@ msgstr "" msgid "" "Return a string containing :attr:`~email.policy.Policy.linesep` characters " -"as required to correctly fold the header according to *policy*. A :attr:" -"`~email.policy.Policy.cte_type` of ``8bit`` will be treated as if it were " -"``7bit``, since headers may not contain arbitrary binary data. If :attr:" -"`~email.policy.EmailPolicy.utf8` is ``False``, non-ASCII data will be :rfc:" -"`2047` encoded." +"as required to correctly fold the header according to *policy*. " +"A :attr:`~email.policy.Policy.cte_type` of ``8bit`` will be treated as if it " +"were ``7bit``, since headers may not contain arbitrary binary data. " +"If :attr:`~email.policy.EmailPolicy.utf8` is ``False``, non-ASCII data will " +"be :rfc:`2047` encoded." msgstr "" msgid "" @@ -122,12 +125,13 @@ msgid "" "``kwds`` is a dictionary containing one pre-initialized key, ``defects``. " "``defects`` is an empty list. The parse method should append any detected " "defects to this list. On return, the ``kwds`` dictionary *must* contain " -"values for at least the keys ``decoded`` and ``defects``. ``decoded`` " -"should be the string value for the header (that is, the header value fully " -"decoded to unicode). The parse method should assume that *string* may " -"contain content-transfer-encoded parts, but should correctly handle all " -"valid unicode characters as well so that it can parse un-encoded header " -"values." +"values for at least the keys ``decoded``, ``defects`` and ``parse_tree``. " +"``decoded`` should be the string value for the header (that is, the header " +"value fully decoded to a string). ``parse_tree`` is set to the parse tree " +"obtained from parsing the header. The parse method should assume that " +"*string* may contain content-transfer-encoded parts, but should correctly " +"handle all valid Unicode characters as well so that it can parse un-encoded " +"header values." msgstr "" msgid "" @@ -162,7 +166,7 @@ msgid "" "mechanism for encoding non-ASCII text as ASCII characters within a header " "value. When a *value* containing encoded words is passed to the " "constructor, the ``UnstructuredHeader`` parser converts such encoded words " -"into unicode, following the :rfc:`2047` rules for unstructured text. The " +"into a string, following the :rfc:`2047` rules for unstructured text. The " "parser uses heuristics to attempt to decode certain non-compliant encoded " "words. Defects are registered in such cases, as well as defects for issues " "such as invalid characters within the encoded words or the non-encoded text." @@ -186,10 +190,11 @@ msgid "" "another, this attribute will contain a :class:`~datetime.datetime` instance " "representing that date. If the timezone of the input date is specified as " "``-0000`` (indicating it is in UTC but contains no information about the " -"source timezone), then :attr:`.datetime` will be a naive :class:`~datetime." -"datetime`. If a specific timezone offset is found (including ``+0000``), " -"then :attr:`.datetime` will contain an aware ``datetime`` that uses :class:" -"`datetime.timezone` to record the timezone offset." +"source timezone), then :attr:`.datetime` will be a " +"naive :class:`~datetime.datetime`. If a specific timezone offset is found " +"(including ``+0000``), then :attr:`.datetime` will contain an aware " +"``datetime`` that uses :class:`datetime.timezone` to record the timezone " +"offset." msgstr "" msgid "" @@ -212,8 +217,8 @@ msgstr "" msgid "" "Because this is a naive ``datetime`` it will be interpreted as a UTC " "timestamp, and the resulting value will have a timezone of ``-0000``. Much " -"more useful is to use the :func:`~email.utils.localtime` function from the :" -"mod:`~email.utils` module::" +"more useful is to use the :func:`~email.utils.localtime` function from " +"the :mod:`~email.utils` module::" msgstr "" msgid "msg['Date'] = utils.localtime()" @@ -245,9 +250,9 @@ msgid "" msgstr "" msgid "" -"The ``decoded`` value of the header will have all encoded words decoded to " -"unicode. :class:`~encodings.idna` encoded domain names are also decoded to " -"unicode. The ``decoded`` value is set by :ref:`joining ` " +"The ``decoded`` value of the header will have all encoded words decoded to a " +"string. :class:`~encodings.idna` encoded domain names are also decoded to a " +"string. The ``decoded`` value is set by :ref:`joining ` " "the :class:`str` value of the elements of the ``groups`` attribute with ``', " "'``." msgstr "" @@ -306,16 +311,16 @@ msgid "A dictionary mapping parameter names to parameter values." msgstr "" msgid "" -"A :class:`ParameterizedMIMEHeader` class that handles the :mailheader:" -"`Content-Type` header." +"A :class:`ParameterizedMIMEHeader` class that handles " +"the :mailheader:`Content-Type` header." msgstr "" msgid "The content type string, in the form ``maintype/subtype``." msgstr "" msgid "" -"A :class:`ParameterizedMIMEHeader` class that handles the :mailheader:" -"`Content-Disposition` header." +"A :class:`ParameterizedMIMEHeader` class that handles " +"the :mailheader:`Content-Disposition` header." msgstr "" msgid "``inline`` and ``attachment`` are the only valid values in common use." @@ -482,8 +487,8 @@ msgid "username@domain" msgstr "" msgid "" -"where each part must conform to specific syntax rules spelled out in :rfc:" -"`5322`." +"where each part must conform to specific syntax rules spelled out " +"in :rfc:`5322`." msgstr "" msgid "" @@ -491,7 +496,7 @@ msgid "" "*domain*, in which case *username* and *domain* will be parsed from the " "*addr_spec*. An *addr_spec* must be a properly RFC quoted string; if it is " "not ``Address`` will raise an error. Unicode characters are allowed and " -"will be property encoded when serialized. However, per the RFCs, unicode is " +"will be property encoded when serialized. However, per the RFCs, Unicode is " "*not* allowed in the username portion of the address." msgstr "" @@ -513,8 +518,8 @@ msgid "" msgstr "" msgid "" -"The ``str`` value of the object is the address quoted according to :rfc:" -"`5322` rules, but with no Content Transfer Encoding of any non-ASCII " +"The ``str`` value of the object is the address quoted according " +"to :rfc:`5322` rules, but with no Content Transfer Encoding of any non-ASCII " "characters." msgstr "" diff --git a/library/email.iterators.po b/library/email.iterators.po index e6a5318112..26b313e551 100644 --- a/library/email.iterators.po +++ b/library/email.iterators.po @@ -30,10 +30,10 @@ msgid "**Source code:** :source:`Lib/email/iterators.py`" msgstr "" msgid "" -"Iterating over a message object tree is fairly easy with the :meth:`Message." -"walk ` method. The :mod:`email.iterators` " -"module provides some useful higher level iterations over message object " -"trees." +"Iterating over a message object tree is fairly easy with " +"the :meth:`Message.walk ` method. " +"The :mod:`email.iterators` module provides some useful higher level " +"iterations over message object trees." msgstr "" msgid "" @@ -46,8 +46,8 @@ msgid "" msgstr "" msgid "" -"Optional *decode* is passed through to :meth:`Message.get_payload `." +"Optional *decode* is passed through to :meth:`Message.get_payload " +"`." msgstr "" msgid "" diff --git a/library/email.message.po b/library/email.message.po index 1ba5db2dff..71ee62fb03 100644 --- a/library/email.message.po +++ b/library/email.message.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -81,24 +81,24 @@ msgstr "" msgid "" "If *policy* is specified use the rules it specifies to update and serialize " -"the representation of the message. If *policy* is not set, use the :class:" -"`~email.policy.default` policy, which follows the rules of the email RFCs " -"except for line endings (instead of the RFC mandated ``\\r\\n``, it uses the " -"Python standard ``\\n`` line endings). For more information see the :mod:" -"`~email.policy` documentation. [2]_" +"the representation of the message. If *policy* is not set, use " +"the :class:`~email.policy.default` policy, which follows the rules of the " +"email RFCs except for line endings (instead of the RFC mandated ``\\r\\n``, " +"it uses the Python standard ``\\n`` line endings). For more information see " +"the :mod:`~email.policy` documentation. [2]_" msgstr "" msgid "" "Return the entire message flattened as a string. When optional *unixfrom* " "is true, the envelope header is included in the returned string. *unixfrom* " -"defaults to ``False``. For backward compatibility with the base :class:" -"`~email.message.Message` class *maxheaderlen* is accepted, but defaults to " -"``None``, which means that by default the line length is controlled by the :" -"attr:`~email.policy.Policy.max_line_length` of the policy. The *policy* " -"argument may be used to override the default policy obtained from the " -"message instance. This can be used to control some of the formatting " -"produced by the method, since the specified *policy* will be passed to the :" -"class:`~email.generator.Generator`." +"defaults to ``False``. For backward compatibility with the " +"base :class:`~email.message.Message` class *maxheaderlen* is accepted, but " +"defaults to ``None``, which means that by default the line length is " +"controlled by the :attr:`~email.policy.Policy.max_line_length` of the " +"policy. The *policy* argument may be used to override the default policy " +"obtained from the message instance. This can be used to control some of the " +"formatting produced by the method, since the specified *policy* will be " +"passed to the :class:`~email.generator.Generator`." msgstr "" msgid "" @@ -112,8 +112,9 @@ msgid "" "useful way to serialize messages in your application, especially if you are " "dealing with multiple messages. See :class:`email.generator.Generator` for " "a more flexible API for serializing messages. Note also that this method is " -"restricted to producing messages serialized as \"7 bit clean\" when :attr:" -"`~email.policy.EmailPolicy.utf8` is ``False``, which is the default." +"restricted to producing messages serialized as \"7 bit clean\" " +"when :attr:`~email.policy.EmailPolicy.utf8` is ``False``, which is the " +"default." msgstr "" msgid "" @@ -130,8 +131,8 @@ msgstr "" msgid "" "the method was changed to use ``utf8=True``, thus producing an :rfc:`6531`-" -"like message representation, instead of being a direct alias for :meth:" -"`as_string`." +"like message representation, instead of being a direct alias " +"for :meth:`as_string`." msgstr "" msgid "" @@ -140,8 +141,8 @@ msgid "" "*unixfrom* defaults to ``False``. The *policy* argument may be used to " "override the default policy obtained from the message instance. This can be " "used to control some of the formatting produced by the method, since the " -"specified *policy* will be passed to the :class:`~email.generator." -"BytesGenerator`." +"specified *policy* will be passed to " +"the :class:`~email.generator.BytesGenerator`." msgstr "" msgid "" @@ -157,14 +158,14 @@ msgid "" msgstr "" msgid "" -"Return ``True`` if the message's payload is a list of sub-\\ :class:" -"`EmailMessage` objects, otherwise return ``False``. When :meth:" -"`is_multipart` returns ``False``, the payload should be a string object " -"(which might be a CTE encoded binary payload). Note that :meth:" -"`is_multipart` returning ``True`` does not necessarily mean that \"msg." -"get_content_maintype() == 'multipart'\" will return the ``True``. For " -"example, ``is_multipart`` will return ``True`` when the :class:" -"`EmailMessage` is of type ``message/rfc822``." +"Return ``True`` if the message's payload is a list of sub-" +"\\ :class:`EmailMessage` objects, otherwise return ``False``. " +"When :meth:`is_multipart` returns ``False``, the payload should be a string " +"object (which might be a CTE encoded binary payload). Note " +"that :meth:`is_multipart` returning ``True`` does not necessarily mean that " +"\"msg.get_content_maintype() == 'multipart'\" will return the ``True``. For " +"example, ``is_multipart`` will return ``True`` when " +"the :class:`EmailMessage` is of type ``message/rfc822``." msgstr "" msgid "" @@ -216,8 +217,8 @@ msgstr "" msgid "" "Return the value of the named header field. *name* does not include the " -"colon field separator. If the header is missing, ``None`` is returned; a :" -"exc:`KeyError` is never raised." +"colon field separator. If the header is missing, ``None`` is returned; " +"a :exc:`KeyError` is never raised." msgstr "" msgid "" @@ -275,9 +276,9 @@ msgid "" msgstr "" msgid "" -"Return the value of the named header field. This is identical to :meth:" -"`~object.__getitem__` except that optional *failobj* is returned if the " -"named header is missing (*failobj* defaults to ``None``)." +"Return the value of the named header field. This is identical " +"to :meth:`~object.__getitem__` except that optional *failobj* is returned if " +"the named header is missing (*failobj* defaults to ``None``)." msgstr "" msgid "Here are some additional useful header related methods:" @@ -343,21 +344,21 @@ msgid "" msgstr "" msgid "" -"Return the message's content type, coerced to lower case of the form :" -"mimetype:`maintype/subtype`. If there is no :mailheader:`Content-Type` " -"header in the message return the value returned by :meth:" -"`get_default_type`. If the :mailheader:`Content-Type` header is invalid, " -"return ``text/plain``." +"Return the message's content type, coerced to lower case of the " +"form :mimetype:`maintype/subtype`. If there is no :mailheader:`Content-" +"Type` header in the message return the value returned " +"by :meth:`get_default_type`. If the :mailheader:`Content-Type` header is " +"invalid, return ``text/plain``." msgstr "" msgid "" -"(According to :rfc:`2045`, messages always have a default type, :meth:" -"`get_content_type` will always return a value. :rfc:`2045` defines a " -"message's default type to be :mimetype:`text/plain` unless it appears inside " -"a :mimetype:`multipart/digest` container, in which case it would be :" -"mimetype:`message/rfc822`. If the :mailheader:`Content-Type` header has an " -"invalid type specification, :rfc:`2045` mandates that the default type be :" -"mimetype:`text/plain`.)" +"(According to :rfc:`2045`, messages always have a default " +"type, :meth:`get_content_type` will always return a value. :rfc:`2045` " +"defines a message's default type to be :mimetype:`text/plain` unless it " +"appears inside a :mimetype:`multipart/digest` container, in which case it " +"would be :mimetype:`message/rfc822`. If the :mailheader:`Content-Type` " +"header has an invalid type specification, :rfc:`2045` mandates that the " +"default type be :mimetype:`text/plain`.)" msgstr "" msgid "" @@ -372,8 +373,8 @@ msgstr "" msgid "" "Return the default content type. Most messages have a default content type " -"of :mimetype:`text/plain`, except for messages that are subparts of :" -"mimetype:`multipart/digest` containers. Such subparts have a default " +"of :mimetype:`text/plain`, except for messages that are subparts " +"of :mimetype:`multipart/digest` containers. Such subparts have a default " "content type of :mimetype:`message/rfc822`." msgstr "" @@ -390,8 +391,8 @@ msgid "" "already exists in the header, replace its value with *value*. When *header* " "is ``Content-Type`` (the default) and the header does not yet exist in the " "message, add it, set its value to :mimetype:`text/plain`, and append the new " -"parameter value. Optional *header* specifies an alternative header to :" -"mailheader:`Content-Type`." +"parameter value. Optional *header* specifies an alternative header " +"to :mailheader:`Content-Type`." msgstr "" msgid "" @@ -415,9 +416,9 @@ msgid "" msgstr "" msgid "" -"Note that existing parameter values of headers may be accessed through the :" -"attr:`~email.headerregistry.ParameterizedMIMEHeader.params` attribute of the " -"header value (for example, ``msg['Content-Type'].params['charset']``)." +"Note that existing parameter values of headers may be accessed through " +"the :attr:`~email.headerregistry.ParameterizedMIMEHeader.params` attribute " +"of the header value (for example, ``msg['Content-Type'].params['charset']``)." msgstr "" msgid "``replace`` keyword was added." @@ -454,10 +455,10 @@ msgid "" msgstr "" msgid "" -"Note that using this method is subtly different from deleting the old :" -"mailheader:`Content-Type` header and adding a new one with the new boundary " -"via :meth:`add_header`, because :meth:`set_boundary` preserves the order of " -"the :mailheader:`Content-Type` header in the list of headers." +"Note that using this method is subtly different from deleting the " +"old :mailheader:`Content-Type` header and adding a new one with the new " +"boundary via :meth:`add_header`, because :meth:`set_boundary` preserves the " +"order of the :mailheader:`Content-Type` header in the list of headers." msgstr "" msgid "" @@ -486,15 +487,15 @@ msgid "" msgstr "" msgid "" -"is_attachment is now a method instead of a property, for consistency with :" -"meth:`~email.message.Message.is_multipart`." +"is_attachment is now a method instead of a property, for consistency " +"with :meth:`~email.message.Message.is_multipart`." msgstr "" msgid "" -"Return the lowercased value (without parameters) of the message's :" -"mailheader:`Content-Disposition` header if it has one, or ``None``. The " -"possible values for this method are *inline*, *attachment* or ``None`` if " -"the message follows :rfc:`2183`." +"Return the lowercased value (without parameters) of the " +"message's :mailheader:`Content-Disposition` header if it has one, or " +"``None``. The possible values for this method are *inline*, *attachment* or " +"``None`` if the message follows :rfc:`2183`." msgstr "" msgid "" @@ -616,8 +617,8 @@ msgid "" "Return an iterator over all of the immediate sub-parts of the message that " "are not candidate \"body\" parts. That is, skip the first occurrence of " "each of ``text/plain``, ``text/html``, ``multipart/related``, or ``multipart/" -"alternative`` (unless they are explicitly marked as attachments via :" -"mailheader:`Content-Disposition: attachment`), and return all remaining " +"alternative`` (unless they are explicitly marked as attachments " +"via :mailheader:`Content-Disposition: attachment`), and return all remaining " "parts. When applied directly to a ``multipart/related``, return an iterator " "over the all the related parts except the root part (ie: the part pointed to " "by the ``start`` parameter, or the first part if there is no ``start`` " @@ -628,8 +629,8 @@ msgstr "" msgid "" "Return an iterator over all of the immediate sub-parts of the message, which " -"will be empty for a non-``multipart``. (See also :meth:`~email.message." -"EmailMessage.walk`.)" +"will be empty for a non-``multipart``. (See " +"also :meth:`~email.message.EmailMessage.walk`.)" msgstr "" msgid "" @@ -667,48 +668,50 @@ msgid "" msgstr "" msgid "" -"Convert a non-``multipart``, a ``multipart/related``, or a ``multipart-" -"alternative`` into a ``multipart/mixed``, moving any existing :mailheader:" -"`Content-` headers and payload into a (new) first part of the " -"``multipart``. If *boundary* is specified, use it as the boundary string in " -"the multipart, otherwise leave the boundary to be automatically created when " -"it is needed (for example, when the message is serialized)." +"Convert a non-``multipart``, a ``multipart/related``, or a ``multipart/" +"alternative`` into a ``multipart/mixed``, moving any " +"existing :mailheader:`Content-` headers and payload into a (new) first part " +"of the ``multipart``. If *boundary* is specified, use it as the boundary " +"string in the multipart, otherwise leave the boundary to be automatically " +"created when it is needed (for example, when the message is serialized)." msgstr "" msgid "" "If the message is a ``multipart/related``, create a new message object, pass " -"all of the arguments to its :meth:`set_content` method, and :meth:`~email." -"message.Message.attach` it to the ``multipart``. If the message is a non-" -"``multipart``, call :meth:`make_related` and then proceed as above. If the " -"message is any other type of ``multipart``, raise a :exc:`TypeError`. If " -"*content_manager* is not specified, use the ``content_manager`` specified by " -"the current :mod:`~email.policy`. If the added part has no :mailheader:" -"`Content-Disposition` header, add one with the value ``inline``." +"all of the arguments to its :meth:`set_content` method, " +"and :meth:`~email.message.Message.attach` it to the ``multipart``. If the " +"message is a non-``multipart``, call :meth:`make_related` and then proceed " +"as above. If the message is any other type of ``multipart``, raise " +"a :exc:`TypeError`. If *content_manager* is not specified, use the " +"``content_manager`` specified by the current :mod:`~email.policy`. If the " +"added part has no :mailheader:`Content-Disposition` header, add one with the " +"value ``inline``." msgstr "" msgid "" "If the message is a ``multipart/alternative``, create a new message object, " -"pass all of the arguments to its :meth:`set_content` method, and :meth:" -"`~email.message.Message.attach` it to the ``multipart``. If the message is " -"a non-``multipart`` or ``multipart/related``, call :meth:`make_alternative` " -"and then proceed as above. If the message is any other type of " -"``multipart``, raise a :exc:`TypeError`. If *content_manager* is not " -"specified, use the ``content_manager`` specified by the current :mod:`~email." -"policy`." +"pass all of the arguments to its :meth:`set_content` method, " +"and :meth:`~email.message.Message.attach` it to the ``multipart``. If the " +"message is a non-``multipart`` or ``multipart/related``, " +"call :meth:`make_alternative` and then proceed as above. If the message is " +"any other type of ``multipart``, raise a :exc:`TypeError`. If " +"*content_manager* is not specified, use the ``content_manager`` specified by " +"the current :mod:`~email.policy`." msgstr "" msgid "" "If the message is a ``multipart/mixed``, create a new message object, pass " -"all of the arguments to its :meth:`set_content` method, and :meth:`~email." -"message.Message.attach` it to the ``multipart``. If the message is a non-" -"``multipart``, ``multipart/related``, or ``multipart/alternative``, call :" -"meth:`make_mixed` and then proceed as above. If *content_manager* is not " -"specified, use the ``content_manager`` specified by the current :mod:`~email." -"policy`. If the added part has no :mailheader:`Content-Disposition` header, " -"add one with the value ``attachment``. This method can be used both for " -"explicit attachments (:mailheader:`Content-Disposition: attachment`) and " -"``inline`` attachments (:mailheader:`Content-Disposition: inline`), by " -"passing appropriate options to the ``content_manager``." +"all of the arguments to its :meth:`set_content` method, " +"and :meth:`~email.message.Message.attach` it to the ``multipart``. If the " +"message is a non-``multipart``, ``multipart/related``, or ``multipart/" +"alternative``, call :meth:`make_mixed` and then proceed as above. If " +"*content_manager* is not specified, use the ``content_manager`` specified by " +"the current :mod:`~email.policy`. If the added part has " +"no :mailheader:`Content-Disposition` header, add one with the value " +"``attachment``. This method can be used both for explicit attachments " +"(:mailheader:`Content-Disposition: attachment`) and ``inline`` attachments " +"(:mailheader:`Content-Disposition: inline`), by passing appropriate options " +"to the ``content_manager``." msgstr "" msgid "Remove the payload and all of the headers." @@ -735,11 +738,12 @@ msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " "the headers but before the first boundary string, it assigns this text to " -"the message's *preamble* attribute. When the :class:`~email.generator." -"Generator` is writing out the plain text representation of a MIME message, " -"and it finds the message has a *preamble* attribute, it will write this text " -"in the area between the headers and the first boundary. See :mod:`email." -"parser` and :mod:`email.generator` for details." +"the message's *preamble* attribute. When " +"the :class:`~email.generator.Generator` is writing out the plain text " +"representation of a MIME message, and it finds the message has a *preamble* " +"attribute, it will write this text in the area between the headers and the " +"first boundary. See :mod:`email.parser` and :mod:`email.generator` for " +"details." msgstr "" msgid "" @@ -761,10 +765,10 @@ msgid "" msgstr "" msgid "" -"This class represents a subpart of a MIME message. It is identical to :" -"class:`EmailMessage`, except that no :mailheader:`MIME-Version` headers are " -"added when :meth:`~EmailMessage.set_content` is called, since sub-parts do " -"not need their own :mailheader:`MIME-Version` headers." +"This class represents a subpart of a MIME message. It is identical " +"to :class:`EmailMessage`, except that no :mailheader:`MIME-Version` headers " +"are added when :meth:`~EmailMessage.set_content` is called, since sub-parts " +"do not need their own :mailheader:`MIME-Version` headers." msgstr "" msgid "Footnotes" @@ -778,7 +782,7 @@ msgstr "" msgid "" "The :class:`EmailMessage` class requires a policy that provides a " "``content_manager`` attribute for content management methods like " -"``set_content()`` and ``get_content()`` to work. The legacy :const:`~email." -"policy.compat32` policy does not support these methods and should not be " -"used with :class:`EmailMessage`." +"``set_content()`` and ``get_content()`` to work. The " +"legacy :const:`~email.policy.compat32` policy does not support these methods " +"and should not be used with :class:`EmailMessage`." msgstr "" diff --git a/library/email.mime.po b/library/email.mime.po index 8785adf758..fc6a804284 100644 --- a/library/email.mime.po +++ b/library/email.mime.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -41,16 +41,17 @@ msgid "" "text to a parser, which parses the text and returns the root message " "object. However you can also build a complete message structure from " "scratch, or even individual :class:`~email.message.Message` objects by " -"hand. In fact, you can also take an existing structure and add new :class:" -"`~email.message.Message` objects, move them around, etc. This makes a very " -"convenient interface for slicing-and-dicing MIME messages." +"hand. In fact, you can also take an existing structure and add " +"new :class:`~email.message.Message` objects, move them around, etc. This " +"makes a very convenient interface for slicing-and-dicing MIME messages." msgstr "" msgid "" -"You can create a new object structure by creating :class:`~email.message." -"Message` instances, adding attachments and all the appropriate headers " -"manually. For MIME messages though, the :mod:`email` package provides some " -"convenient subclasses to make things easier." +"You can create a new object structure by " +"creating :class:`~email.message.Message` instances, adding attachments and " +"all the appropriate headers manually. For MIME messages though, " +"the :mod:`email` package provides some convenient subclasses to make things " +"easier." msgstr "" msgid "Here are the classes:" @@ -60,24 +61,26 @@ msgid "Module: :mod:`email.mime.base`" msgstr "" msgid "" -"This is the base class for all the MIME-specific subclasses of :class:" -"`~email.message.Message`. Ordinarily you won't create instances " +"This is the base class for all the MIME-specific subclasses " +"of :class:`~email.message.Message`. Ordinarily you won't create instances " "specifically of :class:`MIMEBase`, although you could. :class:`MIMEBase` is " "provided primarily as a convenient base class for more specific MIME-aware " "subclasses." msgstr "" msgid "" -"*_maintype* is the :mailheader:`Content-Type` major type (e.g. :mimetype:" -"`text` or :mimetype:`image`), and *_subtype* is the :mailheader:`Content-" -"Type` minor type (e.g. :mimetype:`plain` or :mimetype:`gif`). *_params* is " -"a parameter key/value dictionary and is passed directly to :meth:`Message." -"add_header `." +"*_maintype* is the :mailheader:`Content-Type` major type " +"(e.g. :mimetype:`text` or :mimetype:`image`), and *_subtype* is " +"the :mailheader:`Content-Type` minor type (e.g. :mimetype:`plain` " +"or :mimetype:`gif`). *_params* is a parameter key/value dictionary and is " +"passed directly to :meth:`Message.add_header " +"`." msgstr "" msgid "" -"If *policy* is specified, (defaults to the :class:`compat32 ` policy) it will be passed to :class:`~email.message.Message`." +"If *policy* is specified, (defaults to the :class:`compat32 " +"` policy) it will be passed " +"to :class:`~email.message.Message`." msgstr "" msgid "" @@ -95,9 +98,10 @@ msgstr "" msgid "" "A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate " "base class for MIME messages that are not :mimetype:`multipart`. The " -"primary purpose of this class is to prevent the use of the :meth:`~email." -"message.Message.attach` method, which only makes sense for :mimetype:" -"`multipart` messages. If :meth:`~email.message.Message.attach` is called, " +"primary purpose of this class is to prevent the use of " +"the :meth:`~email.message.Message.attach` method, which only makes sense " +"for :mimetype:`multipart` messages. " +"If :meth:`~email.message.Message.attach` is called, " "a :exc:`~email.errors.MultipartConversionError` exception is raised." msgstr "" @@ -108,9 +112,9 @@ msgid "" "A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate " "base class for MIME messages that are :mimetype:`multipart`. Optional " "*_subtype* defaults to :mimetype:`mixed`, but can be used to specify the " -"subtype of the message. A :mailheader:`Content-Type` header of :mimetype:" -"`multipart/_subtype` will be added to the message object. A :mailheader:" -"`MIME-Version` header will also be added." +"subtype of the message. A :mailheader:`Content-Type` header " +"of :mimetype:`multipart/_subtype` will be added to the message object. " +"A :mailheader:`MIME-Version` header will also be added." msgstr "" msgid "" @@ -122,13 +126,13 @@ msgstr "" msgid "" "*_subparts* is a sequence of initial subparts for the payload. It must be " "possible to convert this sequence to a list. You can always attach new " -"subparts to the message by using the :meth:`Message.attach ` method." +"subparts to the message by using the :meth:`Message.attach " +"` method." msgstr "" msgid "" -"Optional *policy* argument defaults to :class:`compat32 `." +"Optional *policy* argument defaults to :class:`compat32 " +"`." msgstr "" msgid "" @@ -141,22 +145,23 @@ msgid "Module: :mod:`email.mime.application`" msgstr "Moduł: :mod:`email.mime.application`" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEApplication` class is used to represent MIME message objects of major " -"type :mimetype:`application`. *_data* contains the bytes for the raw " -"application data. Optional *_subtype* specifies the MIME subtype and " +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEApplication` class is used to represent MIME message objects " +"of major type :mimetype:`application`. *_data* contains the bytes for the " +"raw application data. Optional *_subtype* specifies the MIME subtype and " "defaults to :mimetype:`octet-stream`." msgstr "" msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the data for transport. This callable takes one " -"argument, which is the :class:`MIMEApplication` instance. It should use :" -"meth:`~email.message.Message.get_payload` and :meth:`~email.message.Message." -"set_payload` to change the payload to encoded form. It should also add any :" -"mailheader:`Content-Transfer-Encoding` or other headers to the message " -"object as necessary. The default encoding is base64. See the :mod:`email." -"encoders` module for a list of the built-in encoders." +"argument, which is the :class:`MIMEApplication` instance. It should " +"use :meth:`~email.message.Message.get_payload` " +"and :meth:`~email.message.Message.set_payload` to change the payload to " +"encoded form. It should also add any :mailheader:`Content-Transfer-" +"Encoding` or other headers to the message object as necessary. The default " +"encoding is base64. See the :mod:`email.encoders` module for a list of the " +"built-in encoders." msgstr "" msgid "*_params* are passed straight through to the base class constructor." @@ -166,87 +171,89 @@ msgid "Module: :mod:`email.mime.audio`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEAudio` class is used to create MIME message objects of major type :" -"mimetype:`audio`. *_audiodata* contains the bytes for the raw audio data. " -"If this data can be decoded as au, wav, aiff, or aifc, then the subtype will " -"be automatically included in the :mailheader:`Content-Type` header. " -"Otherwise you can explicitly specify the audio subtype via the *_subtype* " -"argument. If the minor type could not be guessed and *_subtype* was not " -"given, then :exc:`TypeError` is raised." +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEAudio` class is used to create MIME message objects of major " +"type :mimetype:`audio`. *_audiodata* contains the bytes for the raw audio " +"data. If this data can be decoded as au, wav, aiff, or aifc, then the " +"subtype will be automatically included in the :mailheader:`Content-Type` " +"header. Otherwise you can explicitly specify the audio subtype via the " +"*_subtype* argument. If the minor type could not be guessed and *_subtype* " +"was not given, then :exc:`TypeError` is raised." msgstr "" msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the audio data for transport. This callable takes one " -"argument, which is the :class:`MIMEAudio` instance. It should use :meth:" -"`~email.message.Message.get_payload` and :meth:`~email.message.Message." -"set_payload` to change the payload to encoded form. It should also add any :" -"mailheader:`Content-Transfer-Encoding` or other headers to the message " -"object as necessary. The default encoding is base64. See the :mod:`email." -"encoders` module for a list of the built-in encoders." +"argument, which is the :class:`MIMEAudio` instance. It should " +"use :meth:`~email.message.Message.get_payload` " +"and :meth:`~email.message.Message.set_payload` to change the payload to " +"encoded form. It should also add any :mailheader:`Content-Transfer-" +"Encoding` or other headers to the message object as necessary. The default " +"encoding is base64. See the :mod:`email.encoders` module for a list of the " +"built-in encoders." msgstr "" msgid "Module: :mod:`email.mime.image`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEImage` class is used to create MIME message objects of major type :" -"mimetype:`image`. *_imagedata* contains the bytes for the raw image data. " -"If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, pgm, ppm, " -"rast, xbm, bmp, webp, and exr attempted), then the subtype will be " +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEImage` class is used to create MIME message objects of major " +"type :mimetype:`image`. *_imagedata* contains the bytes for the raw image " +"data. If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, " +"pgm, ppm, rast, xbm, bmp, webp, and exr attempted), then the subtype will be " "automatically included in the :mailheader:`Content-Type` header. Otherwise " "you can explicitly specify the image subtype via the *_subtype* argument. If " -"the minor type could not be guessed and *_subtype* was not given, then :exc:" -"`TypeError` is raised." +"the minor type could not be guessed and *_subtype* was not given, " +"then :exc:`TypeError` is raised." msgstr "" msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the image data for transport. This callable takes one " -"argument, which is the :class:`MIMEImage` instance. It should use :meth:" -"`~email.message.Message.get_payload` and :meth:`~email.message.Message." -"set_payload` to change the payload to encoded form. It should also add any :" -"mailheader:`Content-Transfer-Encoding` or other headers to the message " -"object as necessary. The default encoding is base64. See the :mod:`email." -"encoders` module for a list of the built-in encoders." +"argument, which is the :class:`MIMEImage` instance. It should " +"use :meth:`~email.message.Message.get_payload` " +"and :meth:`~email.message.Message.set_payload` to change the payload to " +"encoded form. It should also add any :mailheader:`Content-Transfer-" +"Encoding` or other headers to the message object as necessary. The default " +"encoding is base64. See the :mod:`email.encoders` module for a list of the " +"built-in encoders." msgstr "" msgid "" -"*_params* are passed straight through to the :class:`~email.mime.base." -"MIMEBase` constructor." +"*_params* are passed straight through to " +"the :class:`~email.mime.base.MIMEBase` constructor." msgstr "" msgid "Module: :mod:`email.mime.message`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEMessage` class is used to create MIME objects of main type :mimetype:" -"`message`. *_msg* is used as the payload, and must be an instance of class :" -"class:`~email.message.Message` (or a subclass thereof), otherwise a :exc:" -"`TypeError` is raised." +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEMessage` class is used to create MIME objects of main " +"type :mimetype:`message`. *_msg* is used as the payload, and must be an " +"instance of class :class:`~email.message.Message` (or a subclass thereof), " +"otherwise a :exc:`TypeError` is raised." msgstr "" msgid "" -"Optional *_subtype* sets the subtype of the message; it defaults to :" -"mimetype:`rfc822`." +"Optional *_subtype* sets the subtype of the message; it defaults " +"to :mimetype:`rfc822`." msgstr "" msgid "Module: :mod:`email.mime.text`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEText` class is used to create MIME objects of major type :mimetype:" -"`text`. *_text* is the string for the payload. *_subtype* is the minor type " -"and defaults to :mimetype:`plain`. *_charset* is the character set of the " -"text and is passed as an argument to the :class:`~email.mime.nonmultipart." -"MIMENonMultipart` constructor; it defaults to ``us-ascii`` if the string " -"contains only ``ascii`` code points, and ``utf-8`` otherwise. The " -"*_charset* parameter accepts either a string or a :class:`~email.charset." -"Charset` instance." +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEText` class is used to create MIME objects of major " +"type :mimetype:`text`. *_text* is the string for the payload. *_subtype* is " +"the minor type and defaults to :mimetype:`plain`. *_charset* is the " +"character set of the text and is passed as an argument to " +"the :class:`~email.mime.nonmultipart.MIMENonMultipart` constructor; it " +"defaults to ``us-ascii`` if the string contains only ``ascii`` code points, " +"and ``utf-8`` otherwise. The *_charset* parameter accepts either a string " +"or a :class:`~email.charset.Charset` instance." msgstr "" msgid "" diff --git a/library/email.parser.po b/library/email.parser.po index 42a4b78fa4..d438bcbd32 100644 --- a/library/email.parser.po +++ b/library/email.parser.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,47 +45,47 @@ msgid "" "root :class:`~email.message.EmailMessage` instance of the object structure. " "For simple, non-MIME messages the payload of this root object will likely be " "a string containing the text of the message. For MIME messages, the root " -"object will return ``True`` from its :meth:`~email.message.EmailMessage." -"is_multipart` method, and the subparts can be accessed via the payload " -"manipulation methods, such as :meth:`~email.message.EmailMessage.get_body`, :" -"meth:`~email.message.EmailMessage.iter_parts`, and :meth:`~email.message." -"EmailMessage.walk`." +"object will return ``True`` from " +"its :meth:`~email.message.EmailMessage.is_multipart` method, and the " +"subparts can be accessed via the payload manipulation methods, such " +"as :meth:`~email.message.EmailMessage.get_body`, :meth:`~email.message.EmailMessage.iter_parts`, " +"and :meth:`~email.message.EmailMessage.walk`." msgstr "" msgid "" -"There are actually two parser interfaces available for use, the :class:" -"`Parser` API and the incremental :class:`FeedParser` API. The :class:" -"`Parser` API is most useful if you have the entire text of the message in " -"memory, or if the entire message lives in a file on the file system. :class:" -"`FeedParser` is more appropriate when you are reading the message from a " -"stream which might block waiting for more input (such as reading an email " -"message from a socket). The :class:`FeedParser` can consume and parse the " -"message incrementally, and only returns the root object when you close the " -"parser." +"There are actually two parser interfaces available for use, " +"the :class:`Parser` API and the incremental :class:`FeedParser` API. " +"The :class:`Parser` API is most useful if you have the entire text of the " +"message in memory, or if the entire message lives in a file on the file " +"system. :class:`FeedParser` is more appropriate when you are reading the " +"message from a stream which might block waiting for more input (such as " +"reading an email message from a socket). The :class:`FeedParser` can " +"consume and parse the message incrementally, and only returns the root " +"object when you close the parser." msgstr "" msgid "" "Note that the parser can be extended in limited ways, and of course you can " "implement your own parser completely from scratch. All of the logic that " -"connects the :mod:`email` package's bundled parser and the :class:`~email." -"message.EmailMessage` class is embodied in the :class:`~email.policy.Policy` " -"class, so a custom parser can create message object trees any way it finds " -"necessary by implementing custom versions of the appropriate :class:`!" -"Policy` methods." +"connects the :mod:`email` package's bundled parser and " +"the :class:`~email.message.EmailMessage` class is embodied in " +"the :class:`~email.policy.Policy` class, so a custom parser can create " +"message object trees any way it finds necessary by implementing custom " +"versions of the appropriate :class:`!Policy` methods." msgstr "" msgid "FeedParser API" msgstr "" msgid "" -"The :class:`BytesFeedParser`, imported from the :mod:`email.feedparser` " +"The :class:`BytesFeedParser`, imported from the :mod:`!email.feedparser` " "module, provides an API that is conducive to incremental parsing of email " "messages, such as would be necessary when reading the text of an email " -"message from a source that can block (such as a socket). The :class:" -"`BytesFeedParser` can of course be used to parse an email message fully " -"contained in a :term:`bytes-like object`, string, or file, but the :class:" -"`BytesParser` API may be more convenient for such use cases. The semantics " -"and results of the two parser APIs are identical." +"message from a source that can block (such as a socket). " +"The :class:`BytesFeedParser` can of course be used to parse an email message " +"fully contained in a :term:`bytes-like object`, string, or file, but " +"the :class:`BytesParser` API may be more convenient for such use cases. The " +"semantics and results of the two parser APIs are identical." msgstr "" msgid "" @@ -94,10 +94,10 @@ msgid "" "to retrieve the root message object. The :class:`BytesFeedParser` is " "extremely accurate when parsing standards-compliant messages, and it does a " "very good job of parsing non-compliant messages, providing information about " -"how a message was deemed broken. It will populate a message object's :attr:" -"`~email.message.EmailMessage.defects` attribute with a list of any problems " -"it found in a message. See the :mod:`email.errors` module for the list of " -"defects that it can find." +"how a message was deemed broken. It will populate a message " +"object's :attr:`~email.message.EmailMessage.defects` attribute with a list " +"of any problems it found in a message. See the :mod:`email.errors` module " +"for the list of defects that it can find." msgstr "" msgid "Here is the API for the :class:`BytesFeedParser`:" @@ -105,24 +105,24 @@ msgstr "" msgid "" "Create a :class:`BytesFeedParser` instance. Optional *_factory* is a no-" -"argument callable; if not specified use the :attr:`~email.policy.Policy." -"message_factory` from the *policy*. Call *_factory* whenever a new message " -"object is needed." +"argument callable; if not specified use " +"the :attr:`~email.policy.Policy.message_factory` from the *policy*. Call " +"*_factory* whenever a new message object is needed." msgstr "" msgid "" "If *policy* is specified use the rules it specifies to update the " -"representation of the message. If *policy* is not set, use the :class:" -"`compat32 ` policy, which maintains backward " -"compatibility with the Python 3.2 version of the email package and provides :" -"class:`~email.message.Message` as the default factory. All other policies " -"provide :class:`~email.message.EmailMessage` as the default *_factory*. For " -"more information on what else *policy* controls, see the :mod:`~email." -"policy` documentation." +"representation of the message. If *policy* is not set, use " +"the :class:`compat32 ` policy, which maintains " +"backward compatibility with the Python 3.2 version of the email package and " +"provides :class:`~email.message.Message` as the default factory. All other " +"policies provide :class:`~email.message.EmailMessage` as the default " +"*_factory*. For more information on what else *policy* controls, see " +"the :mod:`~email.policy` documentation." msgstr "" msgid "" -"Note: **The policy keyword should always be specified**; The default will " +"Note: **The policy keyword should always be specified**. The default will " "change to :data:`email.policy.default` in a future version of Python." msgstr "" @@ -147,10 +147,10 @@ msgid "" msgstr "" msgid "" -"Works like :class:`BytesFeedParser` except that the input to the :meth:" -"`~BytesFeedParser.feed` method must be a string. This is of limited " -"utility, since the only way for such a message to be valid is for it to " -"contain only ASCII text or, if :attr:`~email.policy.EmailPolicy.utf8` is " +"Works like :class:`BytesFeedParser` except that the input to " +"the :meth:`~BytesFeedParser.feed` method must be a string. This is of " +"limited utility, since the only way for such a message to be valid is for it " +"to contain only ASCII text or, if :attr:`~email.policy.EmailPolicy.utf8` is " "``True``, no binary attachments." msgstr "" @@ -161,13 +161,13 @@ msgid "" "The :class:`BytesParser` class, imported from the :mod:`!email.parser` " "module, provides an API that can be used to parse a message when the " "complete contents of the message are available in a :term:`bytes-like " -"object` or file. The :mod:`!email.parser` module also provides :class:" -"`Parser` for parsing strings, and header-only parsers, :class:" -"`BytesHeaderParser` and :class:`HeaderParser`, which can be used if you're " -"only interested in the headers of the message. :class:`BytesHeaderParser` " -"and :class:`HeaderParser` can be much faster in these situations, since they " -"do not attempt to parse the message body, instead setting the payload to the " -"raw body." +"object` or file. The :mod:`!email.parser` module also " +"provides :class:`Parser` for parsing strings, and header-only " +"parsers, :class:`BytesHeaderParser` and :class:`HeaderParser`, which can be " +"used if you're only interested in the headers of the " +"message. :class:`BytesHeaderParser` and :class:`HeaderParser` can be much " +"faster in these situations, since they do not attempt to parse the message " +"body, instead setting the payload to the raw body." msgstr "" msgid "" @@ -186,8 +186,9 @@ msgstr "" msgid "" "Read all the data from the binary file-like object *fp*, parse the resulting " -"bytes, and return the message object. *fp* must support both the :meth:`~io." -"IOBase.readline` and the :meth:`~io.BufferedIOBase.read` methods." +"bytes, and return the message object. *fp* must support both " +"the :meth:`~io.IOBase.readline` and the :meth:`~io.BufferedIOBase.read` " +"methods." msgstr "" msgid "" @@ -196,8 +197,8 @@ msgid "" "headers and header continuation lines, optionally preceded by an envelope " "header. The header block is terminated either by the end of the data or by " "a blank line. Following the header block is the body of the message (which " -"may contain MIME-encoded subparts, including subparts with a :mailheader:" -"`Content-Transfer-Encoding` of ``8bit``)." +"may contain MIME-encoded subparts, including subparts with " +"a :mailheader:`Content-Transfer-Encoding` of ``8bit``)." msgstr "" msgid "" @@ -208,9 +209,9 @@ msgstr "" msgid "" "Similar to the :meth:`parse` method, except it takes a :term:`bytes-like " -"object` instead of a file-like object. Calling this method on a :term:" -"`bytes-like object` is equivalent to wrapping *bytes* in a :class:`~io." -"BytesIO` instance first and calling :meth:`parse`." +"object` instead of a file-like object. Calling this method on " +"a :term:`bytes-like object` is equivalent to wrapping *bytes* in " +"a :class:`~io.BytesIO` instance first and calling :meth:`parse`." msgstr "" msgid "Optional *headersonly* is as with the :meth:`parse` method." @@ -236,15 +237,15 @@ msgid "" msgstr "" msgid "" -"Other than the text mode requirement, this method operates like :meth:" -"`BytesParser.parse`." +"Other than the text mode requirement, this method operates " +"like :meth:`BytesParser.parse`." msgstr "" msgid "" "Similar to the :meth:`parse` method, except it takes a string object instead " "of a file-like object. Calling this method on a string is equivalent to " -"wrapping *text* in a :class:`~io.StringIO` instance first and calling :meth:" -"`parse`." +"wrapping *text* in a :class:`~io.StringIO` instance first and " +"calling :meth:`parse`." msgstr "" msgid "" @@ -302,34 +303,36 @@ msgstr "" msgid "" "Most non-\\ :mimetype:`multipart` type messages are parsed as a single " "message object with a string payload. These objects will return ``False`` " -"for :meth:`~email.message.EmailMessage.is_multipart`, and :meth:`~email." -"message.EmailMessage.iter_parts` will yield an empty list." +"for :meth:`~email.message.EmailMessage.is_multipart`, " +"and :meth:`~email.message.EmailMessage.iter_parts` will yield an empty list." msgstr "" msgid "" "All :mimetype:`multipart` type messages will be parsed as a container " "message object with a list of sub-message objects for their payload. The " -"outer container message will return ``True`` for :meth:`~email.message." -"EmailMessage.is_multipart`, and :meth:`~email.message.EmailMessage." -"iter_parts` will yield a list of subparts." +"outer container message will return ``True`` " +"for :meth:`~email.message.EmailMessage.is_multipart`, " +"and :meth:`~email.message.EmailMessage.iter_parts` will yield a list of " +"subparts." msgstr "" msgid "" -"Most messages with a content type of :mimetype:`message/\\*` (such as :" -"mimetype:`message/delivery-status` and :mimetype:`message/rfc822`) will also " -"be parsed as container object containing a list payload of length 1. Their :" -"meth:`~email.message.EmailMessage.is_multipart` method will return ``True``. " -"The single element yielded by :meth:`~email.message.EmailMessage.iter_parts` " -"will be a sub-message object." +"Most messages with a content type of :mimetype:`message/\\*` (such " +"as :mimetype:`message/delivery-status` and :mimetype:`message/rfc822`) will " +"also be parsed as container object containing a list payload of length 1. " +"Their :meth:`~email.message.EmailMessage.is_multipart` method will return " +"``True``. The single element yielded " +"by :meth:`~email.message.EmailMessage.iter_parts` will be a sub-message " +"object." msgstr "" msgid "" "Some non-standards-compliant messages may not be internally consistent about " -"their :mimetype:`multipart`\\ -edness. Such messages may have a :mailheader:" -"`Content-Type` header of type :mimetype:`multipart`, but their :meth:`~email." -"message.EmailMessage.is_multipart` method may return ``False``. If such " -"messages were parsed with the :class:`~email.parser.FeedParser`, they will " -"have an instance of the :class:`~email.errors." -"MultipartInvariantViolationDefect` class in their *defects* attribute list. " -"See :mod:`email.errors` for details." +"their :mimetype:`multipart`\\ -edness. Such messages may have " +"a :mailheader:`Content-Type` header of type :mimetype:`multipart`, but " +"their :meth:`~email.message.EmailMessage.is_multipart` method may return " +"``False``. If such messages were parsed with " +"the :class:`~email.parser.FeedParser`, they will have an instance of " +"the :class:`~email.errors.MultipartInvariantViolationDefect` class in their " +"*defects* attribute list. See :mod:`email.errors` for details." msgstr "" diff --git a/library/email.po b/library/email.po index 61ca6af72b..a78d7e137a 100644 --- a/library/email.po +++ b/library/email.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Rafael Fontenelle , 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,12 +31,12 @@ msgstr "**kod źródłowy:**. :source:`Lib/email/__init__.py`" msgid "" "The :mod:`!email` package is a library for managing email messages. It is " -"specifically *not* designed to do any sending of email messages to SMTP (:" -"rfc:`2821`), NNTP, or other servers; those are functions of modules such as :" -"mod:`smtplib`. The :mod:`!email` package attempts to be as RFC-compliant as " -"possible, supporting :rfc:`5322` and :rfc:`6532`, as well as such MIME-" -"related RFCs as :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, :rfc:`2183`, and :rfc:" -"`2231`." +"specifically *not* designed to do any sending of email messages to SMTP " +"(:rfc:`2821`), NNTP, or other servers; those are functions of modules such " +"as :mod:`smtplib`. The :mod:`!email` package attempts to be as RFC-" +"compliant as possible, supporting :rfc:`5322` and :rfc:`6532`, as well as " +"such MIME-related RFCs " +"as :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, :rfc:`2183`, and :rfc:`2231`." msgstr "" msgid "" @@ -56,57 +56,58 @@ msgid "" "to construct a new email, or to add or remove email subcomponents that " "themselves use the same object model interface. That is, following the " "nature of email messages and their MIME subcomponents, the email object " -"model is a tree structure of objects that all provide the :class:`~email." -"message.EmailMessage` API." +"model is a tree structure of objects that all provide " +"the :class:`~email.message.EmailMessage` API." msgstr "" "Centralnym komponentem pakietu jest \"model obiektowy\", który reprezentuje " "wiadomości e-mail. Aplikacja wchodzi w interakcję z pakietem głównie " -"poprzez model obiektowy interfejsu zdefiniowanego w pod-module :mod:`~email." -"message` . Aplikacja może używać tego API do zadawania pytań dotyczących " -"istniejącego e-mail, do konstruowania nowego e-mail lub do dodawania lub " -"usuwania e-mail pod-komponentów, które same używają tego samego interfejsu " -"modelu obiektowego. Oznacza to, że zgodnie z naturą wiadomości e-mail i ich " -"podkomponentów MIME, model obiektowy e-mail jest strukturą drzewiastą " -"obiektów, które wszystkie zapewniają :class:`~email.message.EmailMessage` " -"API ." +"poprzez model obiektowy interfejsu zdefiniowanego w pod-" +"module :mod:`~email.message` . Aplikacja może używać tego API do zadawania " +"pytań dotyczących istniejącego e-mail, do konstruowania nowego e-mail lub do " +"dodawania lub usuwania e-mail pod-komponentów, które same używają tego " +"samego interfejsu modelu obiektowego. Oznacza to, że zgodnie z naturą " +"wiadomości e-mail i ich podkomponentów MIME, model obiektowy e-mail jest " +"strukturą drzewiastą obiektów, które wszystkie " +"zapewniają :class:`~email.message.EmailMessage` API ." msgid "" "The other two major components of the package are the :mod:`~email.parser` " "and the :mod:`~email.generator`. The parser takes the serialized version of " -"an email message (a stream of bytes) and converts it into a tree of :class:" -"`~email.message.EmailMessage` objects. The generator takes an :class:" -"`~email.message.EmailMessage` and turns it back into a serialized byte " -"stream. (The parser and generator also handle streams of text characters, " -"but this usage is discouraged as it is too easy to end up with messages that " -"are not valid in one way or another.)" -msgstr "" -"Pozostałe dwa główne komponenty pakietu to :mod:`~email.parser` i :mod:" -"`~email.generator`. Analizator składni pobiera zserializowaną wersję " -"komunikatu e-mail (strumień bajtów) i przekształca go w drzewo obiektów :" -"class:`~email.message.EmailMessage`. Generator pobiera :class:`~email." -"message.EmailMessage` i zamienia ją z powrotem w serializowany strumień " -"bajtów. (Analizator składni i generator obsługują również strumienie znaków " -"tekstowych, ale to użycie jest odradzane, ponieważ zbyt łatwo jest skończyć " -"z wiadomościami, które nie są poprawne w jeden ani drugi sposób.)" +"an email message (a stream of bytes) and converts it into a tree " +"of :class:`~email.message.EmailMessage` objects. The generator takes " +"an :class:`~email.message.EmailMessage` and turns it back into a serialized " +"byte stream. (The parser and generator also handle streams of text " +"characters, but this usage is discouraged as it is too easy to end up with " +"messages that are not valid in one way or another.)" +msgstr "" +"Pozostałe dwa główne komponenty pakietu to :mod:`~email.parser` " +"i :mod:`~email.generator`. Analizator składni pobiera zserializowaną wersję " +"komunikatu e-mail (strumień bajtów) i przekształca go w drzewo " +"obiektów :class:`~email.message.EmailMessage`. Generator " +"pobiera :class:`~email.message.EmailMessage` i zamienia ją z powrotem w " +"serializowany strumień bajtów. (Analizator składni i generator obsługują " +"również strumienie znaków tekstowych, ale to użycie jest odradzane, ponieważ " +"zbyt łatwo jest skończyć z wiadomościami, które nie są poprawne w jeden ani " +"drugi sposób.)" msgid "" -"The control component is the :mod:`~email.policy` module. Every :class:" -"`~email.message.EmailMessage`, every :mod:`~email.generator`, and every :mod:" -"`~email.parser` has an associated :mod:`~email.policy` object that controls " -"its behavior. Usually an application only needs to specify the policy when " -"an :class:`~email.message.EmailMessage` is created, either by directly " -"instantiating an :class:`~email.message.EmailMessage` to create a new " -"email, or by parsing an input stream using a :mod:`~email.parser`. But the " -"policy can be changed when the message is serialized using a :mod:`~email." -"generator`. This allows, for example, a generic email message to be parsed " -"from disk, but to serialize it using standard SMTP settings when sending it " -"to an email server." +"The control component is the :mod:`~email.policy` module. " +"Every :class:`~email.message.EmailMessage`, every :mod:`~email.generator`, " +"and every :mod:`~email.parser` has an associated :mod:`~email.policy` object " +"that controls its behavior. Usually an application only needs to specify " +"the policy when an :class:`~email.message.EmailMessage` is created, either " +"by directly instantiating an :class:`~email.message.EmailMessage` to create " +"a new email, or by parsing an input stream using a :mod:`~email.parser`. " +"But the policy can be changed when the message is serialized using " +"a :mod:`~email.generator`. This allows, for example, a generic email message " +"to be parsed from disk, but to serialize it using standard SMTP settings " +"when sending it to an email server." msgstr "" msgid "" "The email package does its best to hide the details of the various governing " "RFCs from the application. Conceptually the application should be able to " -"treat the email message as a structured tree of unicode text and binary " +"treat the email message as a structured tree of Unicode text and binary " "attachments, without having to worry about how these are represented when " "serialized. In practice, however, it is often necessary to be aware of at " "least some of the rules governing MIME messages and their structure, " @@ -122,21 +123,21 @@ msgstr "" msgid "" "The following sections describe the functionality of the :mod:`!email` " "package. We start with the :mod:`~email.message` object model, which is the " -"primary interface an application will use, and follow that with the :mod:" -"`~email.parser` and :mod:`~email.generator` components. Then we cover the :" -"mod:`~email.policy` controls, which completes the treatment of the main " -"components of the library." +"primary interface an application will use, and follow that with " +"the :mod:`~email.parser` and :mod:`~email.generator` components. Then we " +"cover the :mod:`~email.policy` controls, which completes the treatment of " +"the main components of the library." msgstr "" msgid "" "The next three sections cover the exceptions the package may raise and the " "defects (non-compliance with the RFCs) that the :mod:`~email.parser` may " -"detect. Then we cover the :mod:`~email.headerregistry` and the :mod:`~email." -"contentmanager` sub-components, which provide tools for doing more detailed " -"manipulation of headers and payloads, respectively. Both of these " -"components contain features relevant to consuming and producing non-trivial " -"messages, but also document their extensibility APIs, which will be of " -"interest to advanced applications." +"detect. Then we cover the :mod:`~email.headerregistry` and " +"the :mod:`~email.contentmanager` sub-components, which provide tools for " +"doing more detailed manipulation of headers and payloads, respectively. " +"Both of these components contain features relevant to consuming and " +"producing non-trivial messages, but also document their extensibility APIs, " +"which will be of interest to advanced applications." msgstr "" msgid "" @@ -145,20 +146,22 @@ msgid "" msgstr "" msgid "" -"The foregoing represent the modern (unicode friendly) API of the email " -"package. The remaining sections, starting with the :class:`~email.message." -"Message` class, cover the legacy :data:`~email.policy.compat32` API that " -"deals much more directly with the details of how email messages are " -"represented. The :data:`~email.policy.compat32` API does *not* hide the " -"details of the RFCs from the application, but for applications that need to " -"operate at that level, they can be useful tools. This documentation is also " -"relevant for applications that are still using the :mod:`~email.policy." -"compat32` API for backward compatibility reasons." +"The foregoing represent the modern (Unicode friendly) API of the email " +"package. The remaining sections, starting with " +"the :class:`~email.message.Message` class, cover the " +"legacy :data:`~email.policy.compat32` API that deals much more directly with " +"the details of how email messages are represented. " +"The :data:`~email.policy.compat32` API does *not* hide the details of the " +"RFCs from the application, but for applications that need to operate at that " +"level, they can be useful tools. This documentation is also relevant for " +"applications that are still using the :mod:`~email.policy.compat32` API for " +"backward compatibility reasons." msgstr "" msgid "" -"Docs reorganized and rewritten to promote the new :class:`~email.message." -"EmailMessage`/:class:`~email.policy.EmailPolicy` API." +"Docs reorganized and rewritten to promote the " +"new :class:`~email.message.EmailMessage`/:class:`~email.policy.EmailPolicy` " +"API." msgstr "" msgid "Contents of the :mod:`!email` package documentation:" diff --git a/library/email.policy.po b/library/email.policy.po index e3792fa458..daacdf4c56 100644 --- a/library/email.policy.po +++ b/library/email.policy.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -50,37 +50,38 @@ msgstr "" msgid "" "A :class:`Policy` object encapsulates a set of attributes and methods that " -"control the behavior of various components of the email package during use. :" -"class:`Policy` instances can be passed to various classes and methods in the " -"email package to alter the default behavior. The settable values and their " -"defaults are described below." +"control the behavior of various components of the email package during " +"use. :class:`Policy` instances can be passed to various classes and methods " +"in the email package to alter the default behavior. The settable values and " +"their defaults are described below." msgstr "" msgid "" "There is a default policy used by all classes in the email package. For all " "of the :mod:`~email.parser` classes and the related convenience functions, " -"and for the :class:`~email.message.Message` class, this is the :class:" -"`Compat32` policy, via its corresponding pre-defined instance :const:" -"`compat32`. This policy provides for complete backward compatibility (in " -"some cases, including bug compatibility) with the pre-Python3.3 version of " -"the email package." +"and for the :class:`~email.message.Message` class, this is " +"the :class:`Compat32` policy, via its corresponding pre-defined " +"instance :const:`compat32`. This policy provides for complete backward " +"compatibility (in some cases, including bug compatibility) with the pre-" +"Python3.3 version of the email package." msgstr "" msgid "" -"This default value for the *policy* keyword to :class:`~email.message." -"EmailMessage` is the :class:`EmailPolicy` policy, via its pre-defined " -"instance :data:`~default`." +"This default value for the *policy* keyword " +"to :class:`~email.message.EmailMessage` is the :class:`EmailPolicy` policy, " +"via its pre-defined instance :data:`~default`." msgstr "" msgid "" -"When a :class:`~email.message.Message` or :class:`~email.message." -"EmailMessage` object is created, it acquires a policy. If the message is " -"created by a :mod:`~email.parser`, a policy passed to the parser will be the " -"policy used by the message it creates. If the message is created by the " -"program, then the policy can be specified when it is created. When a " -"message is passed to a :mod:`~email.generator`, the generator uses the " -"policy from the message by default, but you can also pass a specific policy " -"to the generator that will override the one stored on the message object." +"When a :class:`~email.message.Message` " +"or :class:`~email.message.EmailMessage` object is created, it acquires a " +"policy. If the message is created by a :mod:`~email.parser`, a policy " +"passed to the parser will be the policy used by the message it creates. If " +"the message is created by the program, then the policy can be specified when " +"it is created. When a message is passed to a :mod:`~email.generator`, the " +"generator uses the policy from the message by default, but you can also pass " +"a specific policy to the generator that will override the one stored on the " +"message object." msgstr "" msgid "" @@ -104,8 +105,8 @@ msgstr "" msgid "" ":class:`Policy` instances are immutable, but they can be cloned, accepting " -"the same keyword arguments as the class constructor and returning a new :" -"class:`Policy` instance that is a copy of the original but with the " +"the same keyword arguments as the class constructor and returning a " +"new :class:`Policy` instance that is a copy of the original but with the " "specified attributes values changed." msgstr "" @@ -248,9 +249,9 @@ msgid "" msgstr "" msgid "" -"If :const:`True`, any defects encountered will be raised as errors. If :" -"const:`False` (the default), defects will be passed to the :meth:" -"`register_defect` method." +"If :const:`True`, any defects encountered will be raised as errors. " +"If :const:`False` (the default), defects will be passed to " +"the :meth:`register_defect` method." msgstr "" msgid "" @@ -261,22 +262,22 @@ msgstr "" msgid "" "A factory function for constructing a new empty message object. Used by the " -"parser when building messages. Defaults to ``None``, in which case :class:" -"`~email.message.Message` is used." +"parser when building messages. Defaults to ``None``, in which " +"case :class:`~email.message.Message` is used." msgstr "" msgid "" -"If ``True`` (the default), the generator will raise :exc:`~email.errors." -"HeaderWriteError` instead of writing a header that is improperly folded or " -"delimited, such that it would be parsed as multiple headers or joined with " -"adjacent data. Such headers can be generated by custom header classes or " -"bugs in the ``email`` module." +"If ``True`` (the default), the generator will " +"raise :exc:`~email.errors.HeaderWriteError` instead of writing a header that " +"is improperly folded or delimited, such that it would be parsed as multiple " +"headers or joined with adjacent data. Such headers can be generated by " +"custom header classes or bugs in the ``email`` module." msgstr "" msgid "" -"As it's a security feature, this defaults to ``True`` even in the :class:" -"`~email.policy.Compat32` policy. For backwards compatible, but unsafe, " -"behavior, it must be set to ``False`` explicitly." +"As it's a security feature, this defaults to ``True`` even in " +"the :class:`~email.policy.Compat32` policy. For backwards compatible, but " +"unsafe, behavior, it must be set to ``False`` explicitly." msgstr "" msgid "" @@ -325,10 +326,11 @@ msgid "Return the maximum allowed number of headers named *name*." msgstr "" msgid "" -"Called when a header is added to an :class:`~email.message.EmailMessage` or :" -"class:`~email.message.Message` object. If the returned value is not ``0`` " -"or ``None``, and there are already a number of headers with the name *name* " -"greater than or equal to the value returned, a :exc:`ValueError` is raised." +"Called when a header is added to an :class:`~email.message.EmailMessage` " +"or :class:`~email.message.Message` object. If the returned value is not " +"``0`` or ``None``, and there are already a number of headers with the name " +"*name* greater than or equal to the value returned, a :exc:`ValueError` is " +"raised." msgstr "" msgid "" @@ -399,9 +401,9 @@ msgid "" "The email package calls this method with the *name* and *value* currently " "stored in the ``Message`` for a given header. The method should return a " "string that represents that header \"folded\" correctly (according to the " -"policy settings) by composing the *name* with the *value* and inserting :" -"attr:`linesep` characters at the appropriate places. See :rfc:`5322` for a " -"discussion of the rules for folding email headers." +"policy settings) by composing the *name* with the *value* and " +"inserting :attr:`linesep` characters at the appropriate places. " +"See :rfc:`5322` for a discussion of the rules for folding email headers." msgstr "" msgid "" @@ -453,9 +455,9 @@ msgid "" msgstr "" msgid "" -"If the value for a header in the ``Message`` object originated from a :mod:" -"`~email.parser` (as opposed to being set by a program), this attribute " -"indicates whether or not a generator should refold that value when " +"If the value for a header in the ``Message`` object originated from " +"a :mod:`~email.parser` (as opposed to being set by a program), this " +"attribute indicates whether or not a generator should refold that value when " "transforming the message back into serialized form. The possible values are:" msgstr "" @@ -493,13 +495,14 @@ msgid "" msgstr "" msgid "" -"An object with at least two methods: get_content and set_content. When the :" -"meth:`~email.message.EmailMessage.get_content` or :meth:`~email.message." -"EmailMessage.set_content` method of an :class:`~email.message.EmailMessage` " -"object is called, it calls the corresponding method of this object, passing " -"it the message object as its first argument, and any arguments or keywords " -"that were passed to it as additional arguments. By default " -"``content_manager`` is set to :data:`~email.contentmanager.raw_data_manager`." +"An object with at least two methods: get_content and set_content. When " +"the :meth:`~email.message.EmailMessage.get_content` " +"or :meth:`~email.message.EmailMessage.set_content` method of " +"an :class:`~email.message.EmailMessage` object is called, it calls the " +"corresponding method of this object, passing it the message object as its " +"first argument, and any arguments or keywords that were passed to it as " +"additional arguments. By default ``content_manager`` is set " +"to :data:`~email.contentmanager.raw_data_manager`." msgstr "" msgid "" @@ -532,7 +535,7 @@ msgid "" "If the value has a ``name`` attribute, it is returned to unmodified. " "Otherwise the *name*, and the *value* with any CR or LF characters removed, " "are passed to the ``header_factory``, and the resulting header object is " -"returned. Any surrogateescaped bytes get turned into the unicode unknown-" +"returned. Any surrogateescaped bytes get turned into the Unicode unknown-" "character glyph." msgstr "" @@ -564,7 +567,7 @@ msgstr "" msgid "" "If :attr:`~Policy.cte_type` is ``8bit``, non-ASCII binary data is converted " "back into bytes. Headers with binary data are not refolded, regardless of " -"the ``refold_header`` setting, since there is no way to know whether the " +"the ``refold_source`` setting, since there is no way to know whether the " "binary data consists of single byte characters or multibyte characters." msgstr "" @@ -590,8 +593,8 @@ msgid "" "The same as ``SMTP`` except that :attr:`~EmailPolicy.utf8` is ``True``. " "Useful for serializing messages to a message store without using encoded " "words in the headers. Should only be used for SMTP transmission if the " -"sender or recipient addresses have non-ASCII characters (the :meth:`smtplib." -"SMTP.send_message` method handles this automatically)." +"sender or recipient addresses have non-ASCII characters " +"(the :meth:`smtplib.SMTP.send_message` method handles this automatically)." msgstr "" msgid "" @@ -631,17 +634,17 @@ msgid "" msgstr "" msgid "" -"From the application view, this means that any header obtained through the :" -"class:`~email.message.EmailMessage` is a header object with extra " -"attributes, whose string value is the fully decoded unicode value of the " -"header. Likewise, a header may be assigned a new value, or a new header " -"created, using a unicode string, and the policy will take care of converting " -"the unicode string into the correct RFC encoded form." +"From the application view, this means that any header obtained through " +"the :class:`~email.message.EmailMessage` is a header object with extra " +"attributes, whose string value is the fully decoded value of the header. " +"Likewise, a header may be assigned a new value, or a new header created, " +"using a string, and the policy will take care of converting the string into " +"the correct RFC encoded form." msgstr "" msgid "" -"The header objects and their attributes are described in :mod:`~email." -"headerregistry`." +"The header objects and their attributes are described " +"in :mod:`~email.headerregistry`." msgstr "" msgid "" @@ -653,8 +656,8 @@ msgid "" msgstr "" msgid "" -"The following attributes have values that are different from the :class:" -"`Policy` default:" +"The following attributes have values that are different from " +"the :class:`Policy` default:" msgstr "" msgid "The default is ``True``." @@ -664,9 +667,9 @@ msgid "The name and value are returned unmodified." msgstr "" msgid "" -"If the value contains binary data, it is converted into a :class:`~email." -"header.Header` object using the ``unknown-8bit`` charset. Otherwise it is " -"returned unmodified." +"If the value contains binary data, it is converted into " +"a :class:`~email.header.Header` object using the ``unknown-8bit`` charset. " +"Otherwise it is returned unmodified." msgstr "" msgid "" @@ -691,9 +694,9 @@ msgid "" msgstr "" msgid "" -"The :const:`compat32` policy should not be used as a policy for :class:" -"`~email.message.EmailMessage` objects, and should only be used to serialize " -"messages that were created using the :const:`compat32` policy." +"The :const:`compat32` policy should not be used as a policy " +"for :class:`~email.message.EmailMessage` objects, and should only be used to " +"serialize messages that were created using the :const:`compat32` policy." msgstr "" msgid "Footnotes" diff --git a/library/email.utils.po b/library/email.utils.po index 9543749bb0..5e91748ca5 100644 --- a/library/email.utils.po +++ b/library/email.utils.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,23 +36,23 @@ msgstr "" msgid "" "Return local time as an aware datetime object. If called without arguments, " -"return current time. Otherwise *dt* argument should be a :class:`~datetime." -"datetime` instance, and it is converted to the local time zone according to " -"the system time zone database. If *dt* is naive (that is, ``dt.tzinfo`` is " -"``None``), it is assumed to be in local time." +"return the current time. Otherwise the *dt* argument should be " +"a :class:`~datetime.datetime` instance, and it is converted to the local " +"time zone according to the system time zone database. If *dt* is naive " +"(that is, ``dt.tzinfo`` is ``None``), it is assumed to be in local time." msgstr "" msgid "The *isdst* parameter." msgstr "" msgid "" -"Returns a string suitable for an :rfc:`2822`\\ -compliant :mailheader:" -"`Message-ID` header. Optional *idstring* if given, is a string used to " -"strengthen the uniqueness of the message id. Optional *domain* if given " -"provides the portion of the msgid after the '@'. The default is the local " -"hostname. It is not normally necessary to override this default, but may be " -"useful certain cases, such as a constructing distributed system that uses a " -"consistent domain name across multiple hosts." +"Returns a string suitable for an :rfc:`2822`\\ " +"-compliant :mailheader:`Message-ID` header. Optional *idstring*, if given, " +"is a string used to strengthen the uniqueness of the message id. Optional " +"*domain*, if given, provides the portion of the msgid after the '@'. The " +"default is the local hostname. It is normally not necessary to override " +"this default, but may be useful in certain cases, such as constructing a " +"distributed system that uses a consistent domain name across multiple hosts." msgstr "" msgid "Added the *domain* keyword." @@ -91,26 +91,27 @@ msgid "Add *strict* optional parameter and reject malformed inputs by default." msgstr "" msgid "" -"The inverse of :meth:`parseaddr`, this takes a 2-tuple of the form " -"``(realname, email_address)`` and returns the string value suitable for a :" -"mailheader:`To` or :mailheader:`Cc` header. If the first element of *pair* " -"is false, then the second element is returned unmodified." +"The inverse of :func:`parseaddr`, this takes a 2-tuple of the form " +"``(realname, email_address)`` and returns the string value suitable for " +"a :mailheader:`To` or :mailheader:`Cc` header. If the first element of " +"*pair* is false, then the second element is returned unmodified." msgstr "" msgid "" "Optional *charset* is the character set that will be used in the :rfc:`2047` " "encoding of the ``realname`` if the ``realname`` contains non-ASCII " -"characters. Can be an instance of :class:`str` or a :class:`~email.charset." -"Charset`. Defaults to ``utf-8``." +"characters. Can be an instance of :class:`str` or " +"a :class:`~email.charset.Charset`. Defaults to ``utf-8``." msgstr "" msgid "Added the *charset* option." msgstr "" msgid "" -"This method returns a list of 2-tuples of the form returned by " -"``parseaddr()``. *fieldvalues* is a sequence of header field values as might " -"be returned by :meth:`Message.get_all `." +"This function returns a list of 2-tuples of the form returned " +"by :func:`parseaddr`. *fieldvalues* is a sequence of header field values as " +"might be returned by :meth:`Message.get_all() " +"`." msgstr "" msgid "Here's a simple example that gets all the recipients of a message::" @@ -127,13 +128,14 @@ msgid "" msgstr "" msgid "" -"Attempts to parse a date according to the rules in :rfc:`2822`. however, " -"some mailers don't follow that format as specified, so :func:`parsedate` " -"tries to guess correctly in such cases. *date* is a string containing an :" -"rfc:`2822` date, such as ``\"Mon, 20 Nov 1995 19:12:08 -0500\"``. If it " -"succeeds in parsing the date, :func:`parsedate` returns a 9-tuple that can " -"be passed directly to :func:`time.mktime`; otherwise ``None`` will be " -"returned. Note that indexes 6, 7, and 8 of the result tuple are not usable." +"Attempts to parse a date according to the rules in :rfc:`2822#section-3.3`. " +"However, some mailers don't follow that format as specified, " +"so :func:`parsedate` tries to guess correctly in such cases. *date* is a " +"string containing an :rfc:`2822` date, such as ``\"Mon, 20 Nov 1995 19:12:08 " +"-0500\"``. If it succeeds in parsing the date, :func:`parsedate` returns a " +"9-tuple that can be passed directly to :func:`time.mktime`; otherwise " +"``None`` will be returned. Note that indexes 6, 7, and 8 of the result " +"tuple are not usable." msgstr "" msgid "" @@ -147,16 +149,17 @@ msgid "" msgstr "" msgid "" -"The inverse of :func:`format_datetime`. Performs the same function as :func:" -"`parsedate`, but on success returns a :mod:`~datetime.datetime`; otherwise " -"``ValueError`` is raised if *date* contains an invalid value such as an hour " -"greater than 23 or a timezone offset not between -24 and 24 hours. If the " -"input date has a timezone of ``-0000``, the ``datetime`` will be a naive " -"``datetime``, and if the date is conforming to the RFCs it will represent a " -"time in UTC but with no indication of the actual source timezone of the " -"message the date comes from. If the input date has any other valid timezone " -"offset, the ``datetime`` will be an aware ``datetime`` with the " -"corresponding a :class:`~datetime.timezone` :class:`~datetime.tzinfo`." +"The inverse of :func:`format_datetime`. Performs the same function " +"as :func:`parsedate`, but on success returns a :class:`~datetime.datetime`; " +"otherwise :exc:`ValueError` is raised if *date* contains an invalid value " +"such as an hour greater than 23 or a timezone offset not between -24 and 24 " +"hours. If the input date has a timezone of ``-0000``, the ``datetime`` will " +"be a naive ``datetime``, and if the date conforms to the RFCs it will " +"represent a time in UTC but with no indication of the actual source timezone " +"of the message the date comes from. If the input date has any other valid " +"timezone offset, the ``datetime`` will be an aware ``datetime`` whose " +"corresponding :attr:`~datetime.datetime.tzinfo` attribute is " +"a :class:`~datetime.timezone` object." msgstr "" msgid "" @@ -165,41 +168,41 @@ msgid "" "assume local time." msgstr "" -msgid "Returns a date string as per :rfc:`2822`, e.g.::" +msgid "Returns a date string as per :rfc:`2822`, for example::" msgstr "" msgid "Fri, 09 Nov 2001 01:08:47 -0000" msgstr "" msgid "" -"Optional *timeval* if given is a floating-point time value as accepted by :" -"func:`time.gmtime` and :func:`time.localtime`, otherwise the current time is " -"used." +"Optional *timeval*, if given, is a floating-point time value as accepted " +"by :func:`time.gmtime` and :func:`time.localtime`, otherwise the current " +"time is used." msgstr "" msgid "" "Optional *localtime* is a flag that when ``True``, interprets *timeval*, and " "returns a date relative to the local timezone instead of UTC, properly " -"taking daylight savings time into account. The default is ``False`` meaning " +"taking daylight saving time into account. The default is ``False`` meaning " "UTC is used." msgstr "" msgid "" -"Optional *usegmt* is a flag that when ``True``, outputs a date string with " -"the timezone as an ascii string ``GMT``, rather than a numeric ``-0000``. " +"Optional *usegmt* is a flag that when ``True``, outputs a date string with " +"the timezone as an ASCII string ``GMT``, rather than a numeric ``-0000``. " "This is needed for some protocols (such as HTTP). This only applies when " "*localtime* is ``False``. The default is ``False``." msgstr "" msgid "" -"Like ``formatdate``, but the input is a :mod:`datetime` instance. If it is " -"a naive datetime, it is assumed to be \"UTC with no information about the " -"source timezone\", and the conventional ``-0000`` is used for the timezone. " -"If it is an aware ``datetime``, then the numeric timezone offset is used. If " -"it is an aware timezone with offset zero, then *usegmt* may be set to " -"``True``, in which case the string ``GMT`` is used instead of the numeric " -"timezone offset. This provides a way to generate standards conformant HTTP " -"date headers." +"Like :func:`formatdate`, but the input is a :class:`~datetime.datetime` " +"instance. If it is a naive datetime, it is assumed to be \"UTC with no " +"information about the source timezone\", and the conventional ``-0000`` is " +"used for the timezone. If it is an aware ``datetime``, then the numeric " +"timezone offset is used. If it is an aware timezone with offset zero, then " +"*usegmt* may be set to ``True``, in which case the string ``GMT`` is used " +"instead of the numeric timezone offset. This provides a way to generate " +"standards-conformant HTTP date headers." msgstr "" msgid "Decode the string *s* according to :rfc:`2231`." @@ -207,21 +210,21 @@ msgstr "" msgid "" "Encode the string *s* according to :rfc:`2231`. Optional *charset* and " -"*language*, if given is the character set name and language name to use. If " -"neither is given, *s* is returned as-is. If *charset* is given but " +"*language*, if given, are the character set name and language name to use. " +"If neither is given, *s* is returned as-is. If *charset* is given but " "*language* is not, the string is encoded using the empty string for " "*language*." msgstr "" msgid "" -"When a header parameter is encoded in :rfc:`2231` format, :meth:`Message." -"get_param ` may return a 3-tuple containing " -"the character set, language, and value. :func:`collapse_rfc2231_value` " -"turns this into a unicode string. Optional *errors* is passed to the " -"*errors* argument of :class:`str`'s :func:`~str.encode` method; it defaults " -"to ``'replace'``. Optional *fallback_charset* specifies the character set " -"to use if the one in the :rfc:`2231` header is not known by Python; it " -"defaults to ``'us-ascii'``." +"When a header parameter is encoded in :rfc:`2231` " +"format, :meth:`Message.get_param() ` may " +"return a 3-tuple containing the character set, language, and " +"value. :func:`collapse_rfc2231_value` turns this into a string. Optional " +"*errors* is passed to the *errors* argument " +"of :class:`str`'s :meth:`~str.encode` method; it defaults to ``'replace'``. " +"Optional *fallback_charset* specifies the character set to use if the one in " +"the :rfc:`2231` header is not known by Python; it defaults to ``'us-ascii'``." msgstr "" msgid "" @@ -238,7 +241,7 @@ msgid "Footnotes" msgstr "Przypisy" msgid "" -"Note that the sign of the timezone offset is the opposite of the sign of the " -"``time.timezone`` variable for the same timezone; the latter variable " -"follows the POSIX standard while this module follows :rfc:`2822`." +"Note that the sign of the timezone offset is the opposite of the sign of " +"the :data:`time.timezone` variable for the same timezone; the latter " +"variable follows the POSIX standard while this module follows :rfc:`2822`." msgstr "" diff --git a/library/ensurepip.po b/library/ensurepip.po index 273b5e20ea..4517843a4a 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -59,8 +59,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid ":ref:`installing-index`" msgstr ":ref:`installing-index`" @@ -85,7 +85,7 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The command line interface is invoked using the interpreter's ``-m`` switch." @@ -204,8 +204,8 @@ msgid "" msgstr "" msgid "" -"The bootstrapping process has side effects on both ``sys.path`` and ``os." -"environ``. Invoking the command line interface in a subprocess instead " +"The bootstrapping process has side effects on both ``sys.path`` and " +"``os.environ``. Invoking the command line interface in a subprocess instead " "allows these side effects to be avoided." msgstr "" diff --git a/library/enum.po b/library/enum.po index b4eca02320..a5a34fbf29 100644 --- a/library/enum.po +++ b/library/enum.po @@ -4,17 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Transifex Bot <>, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Transifex Bot <>, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -120,16 +119,16 @@ msgid ":class:`IntEnum`" msgstr ":class:`IntEnum`" msgid "" -"Base class for creating enumerated constants that are also subclasses of :" -"class:`int`. (`Notes`_)" +"Base class for creating enumerated constants that are also subclasses " +"of :class:`int`. (`Notes`_)" msgstr "" msgid ":class:`StrEnum`" msgstr ":class:`StrEnum`" msgid "" -"Base class for creating enumerated constants that are also subclasses of :" -"class:`str`. (`Notes`_)" +"Base class for creating enumerated constants that are also subclasses " +"of :class:`str`. (`Notes`_)" msgstr "" msgid ":class:`Flag`" @@ -145,8 +144,9 @@ msgstr ":class:`IntFlag`" msgid "" "Base class for creating enumerated constants that can be combined using the " -"bitwise operators without losing their :class:`IntFlag` membership. :class:" -"`IntFlag` members are also subclasses of :class:`int`. (`Notes`_)" +"bitwise operators without losing their :class:`IntFlag` " +"membership. :class:`IntFlag` members are also subclasses of :class:`int`. " +"(`Notes`_)" msgstr "" msgid ":class:`ReprEnum`" @@ -185,13 +185,13 @@ msgid ":class:`auto`" msgstr ":class:`auto`" msgid "" -"Instances are replaced with an appropriate value for Enum members. :class:" -"`StrEnum` defaults to the lower-cased version of the member name, while " -"other Enums default to 1 and increase from there." +"Instances are replaced with an appropriate value for Enum " +"members. :class:`StrEnum` defaults to the lower-cased version of the member " +"name, while other Enums default to 1 and increase from there." msgstr "" -msgid ":func:`~enum.property`" -msgstr ":func:`~enum.property`" +msgid ":deco:`~enum.property`" +msgstr "" msgid "" "Allows :class:`Enum` members to have attributes without conflicting with " @@ -199,35 +199,35 @@ msgid "" "way." msgstr "" -msgid ":func:`unique`" -msgstr ":func:`unique`" +msgid ":deco:`unique`" +msgstr "" msgid "" "Enum class decorator that ensures only one name is bound to any one value." msgstr "" -msgid ":func:`verify`" -msgstr ":func:`verify`" +msgid ":deco:`verify`" +msgstr "" msgid "" "Enum class decorator that checks user-selectable constraints on an " "enumeration." msgstr "" -msgid ":func:`member`" -msgstr ":func:`member`" +msgid ":deco:`member`" +msgstr "" msgid "Make ``obj`` a member. Can be used as a decorator." msgstr "" -msgid ":func:`nonmember`" -msgstr ":func:`nonmember`" +msgid ":deco:`nonmember`" +msgstr "" msgid "Do not make ``obj`` a member. Can be used as a decorator." msgstr "" -msgid ":func:`global_enum`" -msgstr ":func:`global_enum`" +msgid ":deco:`global_enum`" +msgstr "" msgid "" "Modify the :class:`str() ` and :func:`repr` of an enum to show its " @@ -271,10 +271,10 @@ msgid "" msgstr "" msgid "" -"``EnumType`` is responsible for setting the correct :meth:`!__repr__`, :meth:" -"`!__str__`, :meth:`!__format__`, and :meth:`!__reduce__` methods on the " -"final *enum*, as well as creating the enum members, properly handling " -"duplicates, providing iteration over the enum class, etc." +"``EnumType`` is responsible for setting the correct :meth:`!" +"__repr__`, :meth:`!__str__`, :meth:`!__format__`, and :meth:`!__reduce__` " +"methods on the final *enum*, as well as creating the enum members, properly " +"handling duplicates, providing iteration over the enum class, etc." msgstr "" msgid "" @@ -374,8 +374,8 @@ msgid "" msgstr "" msgid "" -"Returns the Enum member in *cls* matching *name*, or raises a :exc:" -"`KeyError`::" +"Returns the Enum member in *cls* matching *name*, or raises " +"a :exc:`KeyError`::" msgstr "" msgid "" @@ -500,8 +500,8 @@ msgstr "" msgid "" "``_ignore_`` is a list of names that will not become members, and whose " -"names will also be removed from the completed enumeration. See :ref:" -"`TimePeriod ` for an example." +"names will also be removed from the completed enumeration. " +"See :ref:`TimePeriod ` for an example." msgstr "" msgid "" @@ -551,8 +551,8 @@ msgid "A list of the previous values." msgstr "" msgid "" -"A *staticmethod* that is used to determine the next value returned by :class:" -"`auto`." +"A *staticmethod* that is used to determine the next value returned " +"by :class:`auto`." msgstr "" msgid "" @@ -654,8 +654,8 @@ msgid "" "... cls_name = self.__class__.__name__\n" "... return f'{cls_name}.{self.name}'\n" "...\n" -">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), f\"{OtherStyle." -"ALTERNATE}\"\n" +">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), " +"f\"{OtherStyle.ALTERNATE}\"\n" "(OtherStyle.ALTERNATE, 'OtherStyle.ALTERNATE', 'OtherStyle.ALTERNATE')" msgstr "" @@ -673,8 +673,8 @@ msgid "" "... def __str__(self):\n" "... return f'{self.name}'\n" "...\n" -">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), f\"{OtherStyle." -"ALTERNATE}\"\n" +">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), " +"f\"{OtherStyle.ALTERNATE}\"\n" "(, 'ALTERNATE', 'ALTERNATE')" msgstr "" @@ -692,8 +692,8 @@ msgid "" "... def __format__(self, spec):\n" "... return f'{self.name}'\n" "...\n" -">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), f\"{OtherStyle." -"ALTERNATE}\"\n" +">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), " +"f\"{OtherStyle.ALTERNATE}\"\n" "(, 'OtherStyle.ALTERNATE', 'ALTERNATE')" msgstr "" @@ -948,8 +948,8 @@ msgid "the result is a valid *IntFlag*: an *IntFlag* is returned" msgstr "" msgid "" -"the result is not a valid *IntFlag*: the result depends on the :class:" -"`FlagBoundary` setting" +"the result is not a valid *IntFlag*: the result depends on " +"the :class:`FlagBoundary` setting" msgstr "" msgid "The :func:`repr` of unnamed zero-valued flags has changed. It is now::" @@ -989,9 +989,9 @@ msgid ":meth:`!str.__str__` for :class:`StrEnum`" msgstr "" msgid "" -"Inherit from :class:`!ReprEnum` to keep the :class:`str() ` / :func:" -"`format` of the mixed-in data type instead of using the :class:`Enum`-" -"default :meth:`str() `." +"Inherit from :class:`!ReprEnum` to keep the :class:`str() " +"` / :func:`format` of the mixed-in data type instead of using " +"the :class:`Enum`-default :meth:`str() `." msgstr "" msgid "" @@ -1057,8 +1057,8 @@ msgid "" msgstr "" msgid "" -"``FlagBoundary`` controls how out-of-range values are handled in :class:" -"`Flag` and its subclasses." +"``FlagBoundary`` controls how out-of-range values are handled " +"in :class:`Flag` and its subclasses." msgstr "" msgid "" @@ -1082,8 +1082,8 @@ msgid "" msgstr "" msgid "" -"Out-of-range values have invalid values removed, leaving a valid :class:" -"`Flag` value::" +"Out-of-range values have invalid values removed, leaving a " +"valid :class:`Flag` value::" msgstr "" msgid "" @@ -1098,8 +1098,8 @@ msgid "" msgstr "" msgid "" -"Out-of-range values lose their :class:`Flag` membership and revert to :class:" -"`int`." +"Out-of-range values lose their :class:`Flag` membership and revert " +"to :class:`int`." msgstr "" msgid "" @@ -1128,10 +1128,10 @@ msgid "" msgstr "" msgid "" -"Note that only the :class:`~collections.abc.MutableMapping` interface (:meth:" -"`~object.__setitem__` and :meth:`~dict.update`) is overridden. It may be " -"possible to bypass the checks using other :class:`!dict` operations like :" -"meth:`|= `." +"Note that only the :class:`~collections.abc.MutableMapping` interface " +"(:meth:`~object.__setitem__` and :meth:`~dict.update`) is overridden. It may " +"be possible to bypass the checks using other :class:`!dict` operations " +"like :meth:`|= `." msgstr "" msgid "A list of member names." @@ -1147,9 +1147,9 @@ msgstr "" msgid "" ":meth:`~Enum.__new__`, if specified, must create and return the enum " -"members; it is also a very good idea to set the member's :attr:`~Enum." -"_value_` appropriately. Once all the members are created it is no longer " -"used." +"members; it is also a very good idea to set the " +"member's :attr:`~Enum._value_` appropriately. Once all the members are " +"created it is no longer used." msgstr "" msgid "Supported ``_sunder_`` names" @@ -1167,9 +1167,9 @@ msgid "" msgstr "" msgid "" -":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a :" -"class:`str`, that will not be transformed into members, and will be removed " -"from the final class" +":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or " +"a :class:`str`, that will not be transformed into members, and will be " +"removed from the final class" msgstr "" msgid "" @@ -1217,10 +1217,11 @@ msgid "" "*auto* can be used in place of a value. If used, the *Enum* machinery will " "call an :class:`Enum`'s :meth:`~Enum._generate_next_value_` to get an " "appropriate value. For :class:`Enum` and :class:`IntEnum` that appropriate " -"value will be the last value plus one; for :class:`Flag` and :class:" -"`IntFlag` it will be the first power-of-two greater than the highest value; " -"for :class:`StrEnum` it will be the lower-cased version of the member's " -"name. Care must be taken if mixing *auto()* with manually specified values." +"value will be the last value plus one; for :class:`Flag` " +"and :class:`IntFlag` it will be the first power-of-two greater than the " +"highest value; for :class:`StrEnum` it will be the lower-cased version of " +"the member's name. Care must be taken if mixing *auto()* with manually " +"specified values." msgstr "" msgid "" @@ -1258,7 +1259,7 @@ msgid "" msgstr "" msgid "" -"A decorator similar to the built-in *property*, but specifically for " +"A decorator similar to the built-in :deco:`property`, but specifically for " "enumerations. It allows member attributes to have the same names as members " "themselves." msgstr "" @@ -1291,9 +1292,9 @@ msgid "" msgstr "" msgid "" -"A :keyword:`class` decorator specifically for enumerations. Members from :" -"class:`EnumCheck` are used to specify which constraints should be checked on " -"the decorated enumeration." +"A :keyword:`class` decorator specifically for enumerations. Members " +"from :class:`EnumCheck` are used to specify which constraints should be " +"checked on the decorated enumeration." msgstr "" msgid "A decorator for use in enums: its target will become a member." diff --git a/library/errno.po b/library/errno.po index a57761d253..d04294dcdc 100644 --- a/library/errno.po +++ b/library/errno.po @@ -40,8 +40,8 @@ msgid "" msgstr "" msgid "" -"To translate a numeric error code to an error message, use :func:`os." -"strerror`." +"To translate a numeric error code to an error message, " +"use :func:`os.strerror`." msgstr "" msgid "" @@ -51,23 +51,23 @@ msgid "" msgstr "" msgid "" -"Operation not permitted. This error is mapped to the exception :exc:" -"`PermissionError`." +"Operation not permitted. This error is mapped to the " +"exception :exc:`PermissionError`." msgstr "" msgid "" -"No such file or directory. This error is mapped to the exception :exc:" -"`FileNotFoundError`." +"No such file or directory. This error is mapped to the " +"exception :exc:`FileNotFoundError`." msgstr "" msgid "" -"No such process. This error is mapped to the exception :exc:" -"`ProcessLookupError`." +"No such process. This error is mapped to the " +"exception :exc:`ProcessLookupError`." msgstr "" msgid "" -"Interrupted system call. This error is mapped to the exception :exc:" -"`InterruptedError`." +"Interrupted system call. This error is mapped to the " +"exception :exc:`InterruptedError`." msgstr "" msgid "I/O error" @@ -86,8 +86,8 @@ msgid "Bad file number" msgstr "" msgid "" -"No child processes. This error is mapped to the exception :exc:" -"`ChildProcessError`." +"No child processes. This error is mapped to the " +"exception :exc:`ChildProcessError`." msgstr "" msgid "" @@ -98,8 +98,8 @@ msgid "Out of memory" msgstr "" msgid "" -"Permission denied. This error is mapped to the exception :exc:" -"`PermissionError`." +"Permission denied. This error is mapped to the " +"exception :exc:`PermissionError`." msgstr "" msgid "Bad address" @@ -122,13 +122,13 @@ msgid "No such device" msgstr "" msgid "" -"Not a directory. This error is mapped to the exception :exc:" -"`NotADirectoryError`." +"Not a directory. This error is mapped to the " +"exception :exc:`NotADirectoryError`." msgstr "" msgid "" -"Is a directory. This error is mapped to the exception :exc:" -"`IsADirectoryError`." +"Is a directory. This error is mapped to the " +"exception :exc:`IsADirectoryError`." msgstr "" msgid "Invalid argument" @@ -190,8 +190,8 @@ msgid "Too many symbolic links encountered" msgstr "" msgid "" -"Operation would block. This error is mapped to the exception :exc:" -"`BlockingIOError`." +"Operation would block. This error is mapped to the " +"exception :exc:`BlockingIOError`." msgstr "" msgid "No message of desired type" @@ -378,13 +378,13 @@ msgid "Network dropped connection because of reset" msgstr "" msgid "" -"Software caused connection abort. This error is mapped to the exception :exc:" -"`ConnectionAbortedError`." +"Software caused connection abort. This error is mapped to the " +"exception :exc:`ConnectionAbortedError`." msgstr "" msgid "" -"Connection reset by peer. This error is mapped to the exception :exc:" -"`ConnectionResetError`." +"Connection reset by peer. This error is mapped to the " +"exception :exc:`ConnectionResetError`." msgstr "" msgid "No buffer space available" @@ -405,13 +405,13 @@ msgid "Too many references: cannot splice" msgstr "" msgid "" -"Connection timed out. This error is mapped to the exception :exc:" -"`TimeoutError`." +"Connection timed out. This error is mapped to the " +"exception :exc:`TimeoutError`." msgstr "" msgid "" -"Connection refused. This error is mapped to the exception :exc:" -"`ConnectionRefusedError`." +"Connection refused. This error is mapped to the " +"exception :exc:`ConnectionRefusedError`." msgstr "" msgid "Host is down" @@ -421,13 +421,13 @@ msgid "No route to host" msgstr "" msgid "" -"Operation already in progress. This error is mapped to the exception :exc:" -"`BlockingIOError`." +"Operation already in progress. This error is mapped to the " +"exception :exc:`BlockingIOError`." msgstr "" msgid "" -"Operation now in progress. This error is mapped to the exception :exc:" -"`BlockingIOError`." +"Operation now in progress. This error is mapped to the " +"exception :exc:`BlockingIOError`." msgstr "" msgid "Stale NFS file handle" @@ -455,8 +455,8 @@ msgid "Interface output queue is full" msgstr "" msgid "" -"Capabilities insufficient. This error is mapped to the exception :exc:" -"`PermissionError`." +"Capabilities insufficient. This error is mapped to the " +"exception :exc:`PermissionError`." msgstr "" msgid ":ref:`Availability `: WASI, FreeBSD" diff --git a/library/exceptions.po b/library/exceptions.po index 787563d3c2..72636d9847 100644 --- a/library/exceptions.po +++ b/library/exceptions.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-08-21 15:26+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,12 +27,13 @@ msgid "Built-in Exceptions" msgstr "" msgid "" -"In Python, all exceptions must be instances of a class that derives from :" -"class:`BaseException`. In a :keyword:`try` statement with an :keyword:" -"`except` clause that mentions a particular class, that clause also handles " -"any exception classes derived from that class (but not exception classes " -"from which *it* is derived). Two exception classes that are not related via " -"subclassing are never equivalent, even if they have the same name." +"In Python, all exceptions must be instances of a class that derives " +"from :class:`BaseException`. In a :keyword:`try` statement with " +"an :keyword:`except` clause that mentions a particular class, that clause " +"also handles any exception classes derived from that class (but not " +"exception classes from which *it* is derived). Two exception classes that " +"are not related via subclassing are never equivalent, even if they have the " +"same name." msgstr "" msgid "" @@ -54,10 +55,10 @@ msgstr "" msgid "" "The built-in exception classes can be subclassed to define new exceptions; " -"programmers are encouraged to derive new exceptions from the :exc:" -"`Exception` class or one of its subclasses, and not from :exc:" -"`BaseException`. More information on defining exceptions is available in " -"the Python Tutorial under :ref:`tut-userexceptions`." +"programmers are encouraged to derive new exceptions from " +"the :exc:`Exception` class or one of its subclasses, and not " +"from :exc:`BaseException`. More information on defining exceptions is " +"available in the Python Tutorial under :ref:`tut-userexceptions`." msgstr "" msgid "Exception context" @@ -71,9 +72,9 @@ msgstr "" msgid "" "When raising a new exception while another exception is already being " "handled, the new exception's :attr:`!__context__` attribute is automatically " -"set to the handled exception. An exception may be handled when an :keyword:" -"`except` or :keyword:`finally` clause, or a :keyword:`with` statement, is " -"used." +"set to the handled exception. An exception may be handled when " +"an :keyword:`except` or :keyword:`finally` clause, or a :keyword:`with` " +"statement, is used." msgstr "" msgid "" @@ -120,12 +121,13 @@ msgid "" msgstr "" msgid "" -"Most built-in exceptions are implemented in C for efficiency, see: :source:" -"`Objects/exceptions.c`. Some have custom memory layouts which makes it " -"impossible to create a subclass that inherits from multiple exception types. " -"The memory layout of a type is an implementation detail and might change " -"between Python versions, leading to new conflicts in the future. Therefore, " -"it's recommended to avoid subclassing multiple exception types altogether." +"Most built-in exceptions are implemented in C for efficiency, " +"see: :source:`Objects/exceptions.c`. Some have custom memory layouts which " +"makes it impossible to create a subclass that inherits from multiple " +"exception types. The memory layout of a type is an implementation detail and " +"might change between Python versions, leading to new conflicts in the " +"future. Therefore, it's recommended to avoid subclassing multiple exception " +"types altogether." msgstr "" msgid "Base classes" @@ -138,9 +140,9 @@ msgstr "" msgid "" "The base class for all built-in exceptions. It is not meant to be directly " -"inherited by user-defined classes (for that, use :exc:`Exception`). If :" -"func:`str` is called on an instance of this class, the representation of the " -"argument(s) to the instance are returned, or the empty string when there " +"inherited by user-defined classes (for that, use :exc:`Exception`). " +"If :func:`str` is called on an instance of this class, the representation of " +"the argument(s) to the instance are returned, or the empty string when there " "were no arguments." msgstr "" @@ -182,8 +184,9 @@ msgid "" msgstr "" msgid "" -"A list of the notes of this exception, which were added with :meth:" -"`add_note`. This attribute is created when :meth:`add_note` is called." +"A list of the notes of this exception, which were added " +"with :meth:`add_note`. This attribute is created when :meth:`add_note` is " +"called." msgstr "" msgid "" @@ -193,8 +196,8 @@ msgstr "" msgid "" "The base class for those built-in exceptions that are raised for various " -"arithmetic errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:" -"`FloatingPointError`." +"arithmetic " +"errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:`FloatingPointError`." msgstr "" msgid "" @@ -239,18 +242,19 @@ msgstr "" msgid "" "Raised when the :func:`input` function hits an end-of-file condition (EOF) " -"without reading any data. (Note: the :meth:`io.TextIOBase.read` and :meth:" -"`io.IOBase.readline` methods return an empty string when they hit EOF.)" +"without reading any data. (Note: the :meth:`io.TextIOBase.read` " +"and :meth:`io.IOBase.readline` methods return an empty string when they hit " +"EOF.)" msgstr "" msgid "Not currently used." msgstr "" msgid "" -"Raised when a :term:`generator` or :term:`coroutine` is closed; see :meth:" -"`generator.close` and :meth:`coroutine.close`. It directly inherits from :" -"exc:`BaseException` instead of :exc:`Exception` since it is technically not " -"an error." +"Raised when a :term:`generator` or :term:`coroutine` is closed; " +"see :meth:`generator.close` and :meth:`coroutine.close`. It directly " +"inherits from :exc:`BaseException` instead of :exc:`Exception` since it is " +"technically not an error." msgstr "" msgid "" @@ -275,8 +279,8 @@ msgstr "" msgid "" "A subclass of :exc:`ImportError` which is raised by :keyword:`import` when a " -"module could not be located. It is also raised when ``None`` is found in :" -"data:`sys.modules`." +"module could not be located. It is also raised when ``None`` is found " +"in :data:`sys.modules`." msgstr "" msgid "" @@ -291,9 +295,9 @@ msgid "" msgstr "" msgid "" -"Raised when the user hits the interrupt key (normally :kbd:`Control-C` or :" -"kbd:`Delete`). During execution, a check for interrupts is made regularly. " -"The exception inherits from :exc:`BaseException` so as to not be " +"Raised when the user hits the interrupt key (normally :kbd:`Control-C` " +"or :kbd:`Delete`). During execution, a check for interrupts is made " +"regularly. The exception inherits from :exc:`BaseException` so as to not be " "accidentally caught by code that catches :exc:`Exception` and thus prevent " "the interpreter from exiting." msgstr "" @@ -310,10 +314,11 @@ msgid "" "Raised when an operation runs out of memory but the situation may still be " "rescued (by deleting some objects). The associated value is a string " "indicating what kind of (internal) operation ran out of memory. Note that " -"because of the underlying memory management architecture (C's :c:func:" -"`malloc` function), the interpreter may not always be able to completely " -"recover from this situation; it nevertheless raises an exception so that a " -"stack traceback can be printed, in case a run-away program was the cause." +"because of the underlying memory management architecture " +"(C's :c:func:`malloc` function), the interpreter may not always be able to " +"completely recover from this situation; it nevertheless raises an exception " +"so that a stack traceback can be printed, in case a run-away program was the " +"cause." msgstr "" msgid "" @@ -346,46 +351,47 @@ msgstr "" msgid "" ":exc:`!NotImplementedError` and :data:`!NotImplemented` are not " -"interchangeable. This exception should only be used as described above; see :" -"data:`NotImplemented` for details on correct usage of the built-in constant." +"interchangeable. This exception should only be used as described above; " +"see :data:`NotImplemented` for details on correct usage of the built-in " +"constant." msgstr "" msgid "" "This exception is raised when a system function returns a system-related " -"error, including I/O failures such as \"file not found\" or \"disk " -"full\" (not for illegal argument types or other incidental errors)." +"error, including I/O failures such as \"file not found\" or \"disk full\" " +"(not for illegal argument types or other incidental errors)." msgstr "" msgid "" "The second form of the constructor sets the corresponding attributes, " "described below. The attributes default to :const:`None` if not specified. " -"For backwards compatibility, if three arguments are passed, the :attr:" -"`~BaseException.args` attribute contains only a 2-tuple of the first two " -"constructor arguments." +"For backwards compatibility, if three arguments are passed, " +"the :attr:`~BaseException.args` attribute contains only a 2-tuple of the " +"first two constructor arguments." msgstr "" msgid "" "The constructor often actually returns a subclass of :exc:`OSError`, as " "described in `OS exceptions`_ below. The particular subclass depends on the " -"final :attr:`.errno` value. This behaviour only occurs when constructing :" -"exc:`OSError` directly or via an alias, and is not inherited when " -"subclassing." +"final :attr:`.errno` value. This behaviour only occurs when " +"constructing :exc:`OSError` directly or via an alias, and is not inherited " +"when subclassing." msgstr "" msgid "A numeric error code from the C variable :c:data:`errno`." msgstr "" msgid "" -"Under Windows, this gives you the native Windows error code. The :attr:`." -"errno` attribute is then an approximate translation, in POSIX terms, of that " -"native error code." +"Under Windows, this gives you the native Windows error code. " +"The :attr:`.errno` attribute is then an approximate translation, in POSIX " +"terms, of that native error code." msgstr "" msgid "" -"Under Windows, if the *winerror* constructor argument is an integer, the :" -"attr:`.errno` attribute is determined from the Windows error code, and the " -"*errno* argument is ignored. On other platforms, the *winerror* argument is " -"ignored, and the :attr:`winerror` attribute does not exist." +"Under Windows, if the *winerror* constructor argument is an integer, " +"the :attr:`.errno` attribute is determined from the Windows error code, and " +"the *errno* argument is ignored. On other platforms, the *winerror* " +"argument is ignored, and the :attr:`winerror` attribute does not exist." msgstr "" msgid "" @@ -395,33 +401,33 @@ msgid "" msgstr "" msgid "" -"For exceptions that involve a file system path (such as :func:`open` or :" -"func:`os.unlink`), :attr:`filename` is the file name passed to the function. " -"For functions that involve two file system paths (such as :func:`os." -"rename`), :attr:`filename2` corresponds to the second file name passed to " -"the function." +"For exceptions that involve a file system path (such as :func:`open` " +"or :func:`os.unlink`), :attr:`filename` is the file name passed to the " +"function. For functions that involve two file system paths (such " +"as :func:`os.rename`), :attr:`filename2` corresponds to the second file name " +"passed to the function." msgstr "" msgid "" -":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket." -"error`, :exc:`select.error` and :exc:`!mmap.error` have been merged into :" -"exc:`OSError`, and the constructor may return a subclass." +":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket.error`, :exc:`select.error` " +"and :exc:`!mmap.error` have been merged into :exc:`OSError`, and the " +"constructor may return a subclass." msgstr "" msgid "" "The :attr:`filename` attribute is now the original file name passed to the " -"function, instead of the name encoded to or decoded from the :term:" -"`filesystem encoding and error handler`. Also, the *filename2* constructor " -"argument and attribute was added." +"function, instead of the name encoded to or decoded from " +"the :term:`filesystem encoding and error handler`. Also, the *filename2* " +"constructor argument and attribute was added." msgstr "" msgid "" "Raised when the result of an arithmetic operation is too large to be " -"represented. This cannot occur for integers (which would rather raise :exc:" -"`MemoryError` than give up). However, for historical reasons, OverflowError " -"is sometimes raised for integers that are outside a required range. " -"Because of the lack of standardization of floating-point exception handling " -"in C, most floating-point operations are not checked." +"represented. This cannot occur for integers (which would rather " +"raise :exc:`MemoryError` than give up). However, for historical reasons, " +"OverflowError is sometimes raised for integers that are outside a required " +"range. Because of the lack of standardization of floating-point exception " +"handling in C, most floating-point operations are not checked." msgstr "" msgid "" @@ -431,8 +437,8 @@ msgid "" msgstr "" msgid "" -"Examples of operations which can be blocked with a :exc:" -"`PythonFinalizationError` during the Python finalization:" +"Examples of operations which can be blocked with " +"a :exc:`PythonFinalizationError` during the Python finalization:" msgstr "" msgid "Creating a new Python thread." @@ -455,14 +461,14 @@ msgstr "" msgid "" "This exception is derived from :exc:`RuntimeError`. It is raised when the " -"interpreter detects that the maximum recursion depth (see :func:`sys." -"getrecursionlimit`) is exceeded." +"interpreter detects that the maximum recursion depth " +"(see :func:`sys.getrecursionlimit`) is exceeded." msgstr "" msgid "" -"This exception is raised when a weak reference proxy, created by the :func:" -"`weakref.proxy` function, is used to access an attribute of the referent " -"after it has been garbage collected. For more information on weak " +"This exception is raised when a weak reference proxy, created by " +"the :func:`weakref.proxy` function, is used to access an attribute of the " +"referent after it has been garbage collected. For more information on weak " "references, see the :mod:`weakref` module." msgstr "" @@ -473,21 +479,22 @@ msgid "" msgstr "" msgid "" -"Raised by built-in function :func:`next` and an :term:`iterator`\\'s :meth:" -"`~iterator.__next__` method to signal that there are no further items " -"produced by the iterator." +"Raised by built-in function :func:`next` and " +"an :term:`iterator`\\'s :meth:`~iterator.__next__` method to signal that " +"there are no further items produced by the iterator." msgstr "" msgid "" "The exception object has a single attribute :attr:`!value`, which is given " -"as an argument when constructing the exception, and defaults to :const:" -"`None`." +"as an argument when constructing the exception, and defaults " +"to :const:`None`." msgstr "" msgid "" -"When a :term:`generator` or :term:`coroutine` function returns, a new :exc:" -"`StopIteration` instance is raised, and the value returned by the function " -"is used as the :attr:`value` parameter to the constructor of the exception." +"When a :term:`generator` or :term:`coroutine` function returns, a " +"new :exc:`StopIteration` instance is raised, and the value returned by the " +"function is used as the :attr:`value` parameter to the constructor of the " +"exception." msgstr "" msgid "" @@ -517,10 +524,10 @@ msgid "" msgstr "" msgid "" -"Raised when the parser encounters a syntax error. This may occur in an :" -"keyword:`import` statement, in a call to the built-in functions :func:" -"`compile`, :func:`exec`, or :func:`eval`, or when reading the initial script " -"or standard input (also interactively)." +"Raised when the parser encounters a syntax error. This may occur in " +"an :keyword:`import` statement, in a call to the built-in " +"functions :func:`compile`, :func:`exec`, or :func:`eval`, or when reading " +"the initial script or standard input (also interactively)." msgstr "" msgid "" @@ -577,9 +584,9 @@ msgstr "" msgid "" "Raised when the interpreter finds an internal error, but the situation does " "not look so serious to cause it to abandon all hope. The associated value is " -"a string indicating what went wrong (in low-level terms). In :term:" -"`CPython`, this could be raised by incorrectly using Python's C API, such as " -"returning a ``NULL`` value without an exception set." +"a string indicating what went wrong (in low-level terms). " +"In :term:`CPython`, this could be raised by incorrectly using Python's C " +"API, such as returning a ``NULL`` value without an exception set." msgstr "" msgid "" @@ -598,11 +605,11 @@ msgid "" "accidentally caught by code that catches :exc:`Exception`. This allows the " "exception to properly propagate up and cause the interpreter to exit. When " "it is not handled, the Python interpreter exits; no stack traceback is " -"printed. The constructor accepts the same optional argument passed to :func:" -"`sys.exit`. If the value is an integer, it specifies the system exit status " -"(passed to C's :c:func:`!exit` function); if it is ``None``, the exit status " -"is zero; if it has another type (such as a string), the object's value is " -"printed and the exit status is one." +"printed. The constructor accepts the same optional argument passed " +"to :func:`sys.exit`. If the value is an integer, it specifies the system " +"exit status (passed to C's :c:func:`!exit` function); if it is ``None``, the " +"exit status is zero; if it has another type (such as a string), the object's " +"value is printed and the exit status is one." msgstr "" msgid "" @@ -633,16 +640,16 @@ msgid "" msgstr "" msgid "" -"Passing arguments of the wrong type (e.g. passing a :class:`list` when an :" -"class:`int` is expected) should result in a :exc:`TypeError`, but passing " -"arguments with the wrong value (e.g. a number outside expected boundaries) " -"should result in a :exc:`ValueError`." +"Passing arguments of the wrong type (e.g. passing a :class:`list` when " +"an :class:`int` is expected) should result in a :exc:`TypeError`, but " +"passing arguments with the wrong value (e.g. a number outside expected " +"boundaries) should result in a :exc:`ValueError`." msgstr "" msgid "" "Raised when a reference is made to a local variable in a function or method, " -"but no value has been bound to that variable. This is a subclass of :exc:" -"`NameError`." +"but no value has been bound to that variable. This is a subclass " +"of :exc:`NameError`." msgstr "" msgid "" @@ -721,9 +728,9 @@ msgstr "" msgid "" "Raised when an operation would block on an object (e.g. socket) set for non-" -"blocking operation. Corresponds to :c:data:`errno` :py:const:`~errno." -"EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` and :py:" -"const:`~errno.EINPROGRESS`." +"blocking operation. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` " +"and :py:const:`~errno.EINPROGRESS`." msgstr "" msgid "" @@ -738,35 +745,36 @@ msgid "" msgstr "" msgid "" -"Raised when an operation on a child process failed. Corresponds to :c:data:" -"`errno` :py:const:`~errno.ECHILD`." +"Raised when an operation on a child process failed. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECHILD`." msgstr "" msgid "A base class for connection-related issues." msgstr "" msgid "" -"Subclasses are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:" -"`ConnectionRefusedError` and :exc:`ConnectionResetError`." +"Subclasses " +"are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:`ConnectionRefusedError` " +"and :exc:`ConnectionResetError`." msgstr "" msgid "" "A subclass of :exc:`ConnectionError`, raised when trying to write on a pipe " "while the other end has been closed, or trying to write on a socket which " -"has been shutdown for writing. Corresponds to :c:data:`errno` :py:const:" -"`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`." +"has been shutdown for writing. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`." msgstr "" msgid "" "A subclass of :exc:`ConnectionError`, raised when a connection attempt is " -"aborted by the peer. Corresponds to :c:data:`errno` :py:const:`~errno." -"ECONNABORTED`." +"aborted by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNABORTED`." msgstr "" msgid "" "A subclass of :exc:`ConnectionError`, raised when a connection attempt is " -"refused by the peer. Corresponds to :c:data:`errno` :py:const:`~errno." -"ECONNREFUSED`." +"refused by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNREFUSED`." msgstr "" msgid "" @@ -804,30 +812,30 @@ msgid "" "Raised when a directory operation (such as :func:`os.listdir`) is requested " "on something which is not a directory. On most POSIX platforms, it may also " "be raised if an operation attempts to open or traverse a non-directory file " -"as if it were a directory. Corresponds to :c:data:`errno` :py:const:`~errno." -"ENOTDIR`." +"as if it were a directory. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ENOTDIR`." msgstr "" msgid "" "Raised when trying to run an operation without the adequate access rights - " -"for example filesystem permissions. Corresponds to :c:data:`errno` :py:const:" -"`~errno.EACCES`, :py:const:`~errno.EPERM`, and :py:const:`~errno." -"ENOTCAPABLE`." +"for example filesystem permissions. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EACCES`, :py:const:`~errno.EPERM`, " +"and :py:const:`~errno.ENOTCAPABLE`." msgstr "" msgid "" -"WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped to :exc:" -"`PermissionError`." +"WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped " +"to :exc:`PermissionError`." msgstr "" msgid "" -"Raised when a given process doesn't exist. Corresponds to :c:data:`errno` :" -"py:const:`~errno.ESRCH`." +"Raised when a given process doesn't exist. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ESRCH`." msgstr "" msgid "" -"Raised when a system function timed out at the system level. Corresponds to :" -"c:data:`errno` :py:const:`~errno.ETIMEDOUT`." +"Raised when a system function timed out at the system level. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ETIMEDOUT`." msgstr "" msgid "All the above :exc:`OSError` subclasses were added." @@ -840,8 +848,8 @@ msgid "Warnings" msgstr "" msgid "" -"The following exceptions are used as warning categories; see the :ref:" -"`warning-categories` documentation for more details." +"The following exceptions are used as warning categories; see " +"the :ref:`warning-categories` documentation for more details." msgstr "" msgid "Base class for warning categories." @@ -856,9 +864,9 @@ msgid "" msgstr "" msgid "" -"Ignored by the default warning filters, except in the ``__main__`` module (:" -"pep:`565`). Enabling the :ref:`Python Development Mode ` shows this " -"warning." +"Ignored by the default warning filters, except in the ``__main__`` module " +"(:pep:`565`). Enabling the :ref:`Python Development Mode ` shows " +"this warning." msgstr "" msgid "The deprecation policy is described in :pep:`387`." @@ -930,18 +938,24 @@ msgid "" "Both of these exception types wrap the exceptions in the sequence ``excs``. " "The ``msg`` parameter must be a string. The difference between the two " "classes is that :exc:`BaseExceptionGroup` extends :exc:`BaseException` and " -"it can wrap any exception, while :exc:`ExceptionGroup` extends :exc:" -"`Exception` and it can only wrap subclasses of :exc:`Exception`. This design " -"is so that ``except Exception`` catches an :exc:`ExceptionGroup` but not :" -"exc:`BaseExceptionGroup`." +"it can wrap any exception, while :exc:`ExceptionGroup` " +"extends :exc:`Exception` and it can only wrap subclasses " +"of :exc:`Exception`. This design is so that ``except Exception`` catches " +"an :exc:`ExceptionGroup` but not :exc:`BaseExceptionGroup`." msgstr "" msgid "" "The :exc:`BaseExceptionGroup` constructor returns an :exc:`ExceptionGroup` " -"rather than a :exc:`BaseExceptionGroup` if all contained exceptions are :exc:" -"`Exception` instances, so it can be used to make the selection automatic. " -"The :exc:`ExceptionGroup` constructor, on the other hand, raises a :exc:" -"`TypeError` if any contained exception is not an :exc:`Exception` subclass." +"rather than a :exc:`BaseExceptionGroup` if all contained exceptions " +"are :exc:`Exception` instances, so it can be used to make the selection " +"automatic. The :exc:`ExceptionGroup` constructor, on the other hand, raises " +"a :exc:`TypeError` if any contained exception is not an :exc:`Exception` " +"subclass." +msgstr "" + +msgid "" +"Exception groups are :ref:`generic ` over the type of their " +"contained exceptions." msgstr "" msgid "" @@ -973,10 +987,10 @@ msgstr "" msgid "" "The nesting structure of the current exception is preserved in the result, " -"as are the values of its :attr:`message`, :attr:`~BaseException." -"__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException." -"__context__` and :attr:`~BaseException.__notes__` fields. Empty nested " -"groups are omitted from the result." +"as are the values of " +"its :attr:`message`, :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields. Empty nested groups are omitted " +"from the result." msgstr "" msgid "" @@ -1007,11 +1021,11 @@ msgid "" msgstr "" msgid "" -":meth:`subgroup` and :meth:`split` copy the :attr:`~BaseException." -"__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException." -"__context__` and :attr:`~BaseException.__notes__` fields from the original " -"exception group to the one returned by :meth:`derive`, so these fields do " -"not need to be updated by :meth:`derive`." +":meth:`subgroup` and :meth:`split` copy " +"the :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields from the original exception " +"group to the one returned by :meth:`derive`, so these fields do not need to " +"be updated by :meth:`derive`." msgstr "" msgid "" @@ -1063,8 +1077,8 @@ msgstr "" msgid "" "Like :exc:`ExceptionGroup`, any subclass of :exc:`BaseExceptionGroup` which " -"is also a subclass of :exc:`Exception` can only wrap instances of :exc:" -"`Exception`." +"is also a subclass of :exc:`Exception` can only wrap instances " +"of :exc:`Exception`." msgstr "" msgid "Exception hierarchy" diff --git a/library/faulthandler.po b/library/faulthandler.po index 2311f6980d..91e45b33a5 100644 --- a/library/faulthandler.po +++ b/library/faulthandler.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,10 +28,10 @@ msgstr "" msgid "" "This module contains functions to dump Python tracebacks explicitly, on a " -"fault, after a timeout, or on a user signal. Call :func:`faulthandler." -"enable` to install fault handlers for the :const:`~signal.SIGSEGV`, :const:" -"`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS`, and :" -"const:`~signal.SIGILL` signals. You can also enable them at startup by " +"fault, after a timeout, or on a user signal. " +"Call :func:`faulthandler.enable` to install fault handlers for " +"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS`, " +"and :const:`~signal.SIGILL` signals. You can also enable them at startup by " "setting the :envvar:`PYTHONFAULTHANDLER` environment variable or by using " "the :option:`-X` ``faulthandler`` command line option." msgstr "" @@ -81,8 +81,8 @@ msgid "" msgstr "" msgid "" -"The :ref:`Python Development Mode ` calls :func:`faulthandler." -"enable` at Python startup." +"The :ref:`Python Development Mode ` " +"calls :func:`faulthandler.enable` at Python startup." msgstr "" msgid "Module :mod:`pdb`" @@ -130,8 +130,8 @@ msgid "C Stack Compatibility" msgstr "" msgid "" -"If the system does not support the C-level :manpage:`backtrace(3)` or :" -"manpage:`dladdr1(3)`, then C stack dumps will not work. An error will be " +"If the system does not support the C-level :manpage:`backtrace(3)` " +"or :manpage:`dladdr1(3)`, then C stack dumps will not work. An error will be " "printed instead of the stack." msgstr "" @@ -151,16 +151,16 @@ msgid "Fault handler state" msgstr "" msgid "" -"Enable the fault handler: install handlers for the :const:`~signal." -"SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal." -"SIGBUS` and :const:`~signal.SIGILL` signals to dump the Python traceback. If " +"Enable the fault handler: install handlers for " +"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS` " +"and :const:`~signal.SIGILL` signals to dump the Python traceback. If " "*all_threads* is ``True``, produce tracebacks for every running thread. " "Otherwise, dump only the current thread." msgstr "" msgid "" -"The *file* must be kept open until the fault handler is disabled: see :ref:" -"`issue with file descriptors `." +"The *file* must be kept open until the fault handler is disabled: " +"see :ref:`issue with file descriptors `." msgstr "" msgid "" @@ -186,8 +186,8 @@ msgid "The dump now displays the C stack trace if *c_stack* is true." msgstr "" msgid "" -"Disable the fault handler: uninstall the signal handlers installed by :func:" -"`enable`." +"Disable the fault handler: uninstall the signal handlers installed " +"by :func:`enable`." msgstr "" msgid "Check if the fault handler is enabled." @@ -199,16 +199,16 @@ msgstr "" msgid "" "Dump the tracebacks of all threads, after a timeout of *timeout* seconds, or " "every *timeout* seconds if *repeat* is ``True``. If *exit* is ``True``, " -"call :c:func:`!_exit` with status=1 after dumping the tracebacks. (Note :c:" -"func:`!_exit` exits the process immediately, which means it doesn't do any " -"cleanup like flushing file buffers.) If the function is called twice, the " -"new call replaces previous parameters and resets the timeout. The timer has " -"a sub-second resolution." +"call :c:func:`!_exit` with status=1 after dumping the tracebacks. " +"(Note :c:func:`!_exit` exits the process immediately, which means it doesn't " +"do any cleanup like flushing file buffers.) If the function is called twice, " +"the new call replaces previous parameters and resets the timeout. The timer " +"has a sub-second resolution." msgstr "" msgid "" -"The *file* must be kept open until the traceback is dumped or :func:" -"`cancel_dump_traceback_later` is called: see :ref:`issue with file " +"The *file* must be kept open until the traceback is dumped " +"or :func:`cancel_dump_traceback_later` is called: see :ref:`issue with file " "descriptors `." msgstr "" @@ -231,8 +231,9 @@ msgid "" msgstr "" msgid "" -"The *file* must be kept open until the signal is unregistered by :func:" -"`unregister`: see :ref:`issue with file descriptors `." +"The *file* must be kept open until the signal is unregistered " +"by :func:`unregister`: see :ref:`issue with file descriptors `." msgstr "" msgid "Not available on Windows." diff --git a/library/fcntl.po b/library/fcntl.po index d83d7df49d..c49b09b2cf 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,8 +28,8 @@ msgstr "" msgid "" "This module performs file and I/O control on file descriptors. It is an " -"interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. See the :" -"manpage:`fcntl(2)` and :manpage:`ioctl(2)` Unix manual pages for full " +"interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. See " +"the :manpage:`fcntl(2)` and :manpage:`ioctl(2)` Unix manual pages for full " "details." msgstr "" @@ -38,10 +38,10 @@ msgstr "Dostępność" msgid "" "All functions in this module take a file descriptor *fd* as their first " -"argument. This can be an integer file descriptor, such as returned by ``sys." -"stdin.fileno()``, or an :class:`io.IOBase` object, such as ``sys.stdin`` " -"itself, which provides a :meth:`~io.IOBase.fileno` that returns a genuine " -"file descriptor." +"argument. This can be an integer file descriptor, such as returned by " +"``sys.stdin.fileno()``, or an :class:`io.IOBase` object, such as " +"``sys.stdin`` itself, which provides a :meth:`~io.IOBase.fileno` that " +"returns a genuine file descriptor." msgstr "" msgid "" @@ -57,8 +57,8 @@ msgstr "" msgid "" "On macOS, the :mod:`!fcntl` module exposes the ``F_GETPATH`` constant, which " -"obtains the path of a file from a file descriptor. On Linux(>=3.15), the :" -"mod:`!fcntl` module exposes the ``F_OFD_GETLK``, ``F_OFD_SETLK`` and " +"obtains the path of a file from a file descriptor. On Linux(>=3.15), " +"the :mod:`!fcntl` module exposes the ``F_OFD_GETLK``, ``F_OFD_SETLK`` and " "``F_OFD_SETLKW`` constants, which are used when working with open file " "description locks." msgstr "" @@ -115,10 +115,10 @@ msgid "" "a :meth:`~io.IOBase.fileno` method are accepted as well). The values used " "for *cmd* are operating system dependent, and are available as constants in " "the :mod:`!fcntl` module, using the same names as used in the relevant C " -"header files. The argument *arg* can either be an integer value, a :term:" -"`bytes-like object`, or a string. The type and size of *arg* must match the " -"type and size of the argument of the operation as specified in the relevant " -"C documentation." +"header files. The argument *arg* can either be an integer value, " +"a :term:`bytes-like object`, or a string. The type and size of *arg* must " +"match the type and size of the argument of the operation as specified in the " +"relevant C documentation." msgstr "" msgid "" @@ -187,8 +187,8 @@ msgid "" "code is passed back to the calling Python, and the buffer's new contents " "reflect the action of the :c:func:`ioctl`. This is a slight simplification, " "because if the supplied buffer is less than 1024 bytes long it is first " -"copied into a static buffer 1024 bytes long which is then passed to :func:" -"`ioctl` and copied back into the supplied buffer." +"copied into a static buffer 1024 bytes long which is then passed " +"to :func:`ioctl` and copied back into the supplied buffer." msgstr "" msgid "" @@ -248,9 +248,9 @@ msgstr "" msgid "" "This is essentially a wrapper around the :func:`~fcntl.fcntl` locking calls. " -"*fd* is the file descriptor (file objects providing a :meth:`~io.IOBase." -"fileno` method are accepted as well) of the file to lock or unlock, and " -"*cmd* is one of the following values:" +"*fd* is the file descriptor (file objects providing " +"a :meth:`~io.IOBase.fileno` method are accepted as well) of the file to lock " +"or unlock, and *cmd* is one of the following values:" msgstr "" msgid "Release an existing lock." @@ -268,18 +268,18 @@ msgid "" msgstr "" msgid "" -"If :const:`!LOCK_NB` is used and the lock cannot be acquired, an :exc:" -"`OSError` will be raised and the exception will have an *errno* attribute " -"set to :const:`~errno.EACCES` or :const:`~errno.EAGAIN` (depending on the " -"operating system; for portability, check for both values). On at least some " -"systems, :const:`!LOCK_EX` can only be used if the file descriptor refers to " -"a file opened for writing." +"If :const:`!LOCK_NB` is used and the lock cannot be acquired, " +"an :exc:`OSError` will be raised and the exception will have an *errno* " +"attribute set to :const:`~errno.EACCES` or :const:`~errno.EAGAIN` (depending " +"on the operating system; for portability, check for both values). On at " +"least some systems, :const:`!LOCK_EX` can only be used if the file " +"descriptor refers to a file opened for writing." msgstr "" msgid "" "*len* is the number of bytes to lock, *start* is the byte offset at which " -"the lock starts, relative to *whence*, and *whence* is as with :func:`io." -"IOBase.seek`, specifically:" +"the lock starts, relative to *whence*, and *whence* is as " +"with :func:`io.IOBase.seek`, specifically:" msgstr "" msgid "``0`` -- relative to the start of the file (:const:`os.SEEK_SET`)" diff --git a/library/filecmp.po b/library/filecmp.po index 56f69deeef..bb5cb1cdc7 100644 --- a/library/filecmp.po +++ b/library/filecmp.po @@ -80,8 +80,8 @@ msgid "" msgstr "" msgid "" -"The *shallow* parameter has the same meaning and default value as for :func:" -"`filecmp.cmp`." +"The *shallow* parameter has the same meaning and default value as " +"for :func:`filecmp.cmp`." msgstr "" msgid "" @@ -101,9 +101,9 @@ msgstr "" msgid "" "Construct a new directory comparison object, to compare the directories *a* " -"and *b*. *ignore* is a list of names to ignore, and defaults to :attr:" -"`filecmp.DEFAULT_IGNORES`. *hide* is a list of names to hide, and defaults " -"to ``[os.curdir, os.pardir]``." +"and *b*. *ignore* is a list of names to ignore, and defaults " +"to :attr:`filecmp.DEFAULT_IGNORES`. *hide* is a list of names to hide, and " +"defaults to ``[os.curdir, os.pardir]``." msgstr "" msgid "" diff --git a/library/fileinput.po b/library/fileinput.po index d70876a921..3a0243d7d0 100644 --- a/library/fileinput.po +++ b/library/fileinput.po @@ -49,9 +49,9 @@ msgstr "" msgid "" "All files are opened in text mode by default, but you can override this by " -"specifying the *mode* parameter in the call to :func:`.input` or :class:" -"`FileInput`. If an I/O error occurs during opening or reading a file, :exc:" -"`OSError` is raised." +"specifying the *mode* parameter in the call to :func:`.input` " +"or :class:`FileInput`. If an I/O error occurs during opening or reading a " +"file, :exc:`OSError` is raised." msgstr "" msgid ":exc:`IOError` used to be raised; it is now an alias of :exc:`OSError`." @@ -95,9 +95,9 @@ msgid "" msgstr "" msgid "" -"The :class:`FileInput` instance can be used as a context manager in the :" -"keyword:`with` statement. In this example, *input* is closed after the :" -"keyword:`!with` statement is exited, even if an exception occurs::" +"The :class:`FileInput` instance can be used as a context manager in " +"the :keyword:`with` statement. In this example, *input* is closed after " +"the :keyword:`!with` statement is exited, even if an exception occurs::" msgstr "" msgid "Can be used as a context manager." @@ -110,8 +110,9 @@ msgid "The keyword-only parameter *encoding* and *errors* are added." msgstr "" msgid "" -"The following functions use the global state created by :func:`fileinput." -"input`; if there is no active state, :exc:`RuntimeError` is raised." +"The following functions use the global state created " +"by :func:`fileinput.input`; if there is no active state, :exc:`RuntimeError` " +"is raised." msgstr "" msgid "" @@ -165,14 +166,13 @@ msgid "" msgstr "" msgid "" -"Class :class:`FileInput` is the implementation; its methods :meth:" -"`filename`, :meth:`fileno`, :meth:`lineno`, :meth:`filelineno`, :meth:" -"`isfirstline`, :meth:`isstdin`, :meth:`nextfile` and :meth:`close` " -"correspond to the functions of the same name in the module. In addition it " -"is :term:`iterable` and has a :meth:`~io.TextIOBase.readline` method which " -"returns the next input line. The sequence must be accessed in strictly " -"sequential order; random access and :meth:`~io.TextIOBase.readline` cannot " -"be mixed." +"Class :class:`FileInput` is the implementation; its " +"methods :meth:`filename`, :meth:`fileno`, :meth:`lineno`, :meth:`filelineno`, :meth:`isfirstline`, :meth:`isstdin`, :meth:`nextfile` " +"and :meth:`close` correspond to the functions of the same name in the " +"module. In addition it is :term:`iterable` and has " +"a :meth:`~io.TextIOBase.readline` method which returns the next input line. " +"The sequence must be accessed in strictly sequential order; random access " +"and :meth:`~io.TextIOBase.readline` cannot be mixed." msgstr "" msgid "" @@ -192,9 +192,9 @@ msgid "" msgstr "" msgid "" -"A :class:`FileInput` instance can be used as a context manager in the :" -"keyword:`with` statement. In this example, *input* is closed after the :" -"keyword:`!with` statement is exited, even if an exception occurs::" +"A :class:`FileInput` instance can be used as a context manager in " +"the :keyword:`with` statement. In this example, *input* is closed after " +"the :keyword:`!with` statement is exited, even if an exception occurs::" msgstr "" msgid "The keyword parameter *mode* and *openhook* are now keyword-only." @@ -234,8 +234,8 @@ msgid "" msgstr "" msgid "" -"Usage example: ``fi = fileinput.FileInput(openhook=fileinput." -"hook_compressed, encoding=\"utf-8\")``" +"Usage example: ``fi = " +"fileinput.FileInput(openhook=fileinput.hook_compressed, encoding=\"utf-8\")``" msgstr "" msgid "" @@ -244,14 +244,15 @@ msgid "" msgstr "" msgid "" -"Usage example: ``fi = fileinput.FileInput(openhook=fileinput." -"hook_encoded(\"utf-8\", \"surrogateescape\"))``" +"Usage example: ``fi = " +"fileinput.FileInput(openhook=fileinput.hook_encoded(\"utf-8\", " +"\"surrogateescape\"))``" msgstr "" msgid "Added the optional *errors* parameter." msgstr "" msgid "" -"This function is deprecated since :func:`fileinput.input` and :class:" -"`FileInput` now have *encoding* and *errors* parameters." +"This function is deprecated since :func:`fileinput.input` " +"and :class:`FileInput` now have *encoding* and *errors* parameters." msgstr "" diff --git a/library/fnmatch.po b/library/fnmatch.po index 31731a698d..b734e990e4 100644 --- a/library/fnmatch.po +++ b/library/fnmatch.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -72,10 +72,10 @@ msgstr "" msgid "" "Note that the filename separator (``'/'`` on Unix) is *not* special to this " -"module. See module :mod:`glob` for pathname expansion (:mod:`glob` uses :" -"func:`.filter` to match pathname segments). Similarly, filenames starting " -"with a period are not special for this module, and are matched by the ``*`` " -"and ``?`` patterns." +"module. See module :mod:`glob` for pathname expansion (:mod:`glob` " +"uses :func:`.filter` to match pathname segments). Similarly, filenames " +"starting with a period are not special for this module, and are matched by " +"the ``*`` and ``?`` patterns." msgstr "" msgid "" @@ -86,17 +86,16 @@ msgid "" msgstr "" msgid "" -"Finally, note that :func:`functools.lru_cache` with a *maxsize* of 32768 is " +"Finally, note that :deco:`functools.lru_cache` with a *maxsize* of 32768 is " "used to cache the (typed) compiled regex patterns in the following " -"functions: :func:`fnmatch`, :func:`fnmatchcase`, :func:`.filter`, :func:`." -"filterfalse`." +"functions: :func:`~fnmatch.fnmatch`, :func:`fnmatchcase`, :func:`.filter`, :func:`.filterfalse`." msgstr "" msgid "" "Test whether the filename string *name* matches the pattern string *pat*, " -"returning ``True`` or ``False``. Both parameters are case-normalized using :" -"func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a case-" -"sensitive comparison, regardless of whether that's standard for the " +"returning ``True`` or ``False``. Both parameters are case-normalized " +"using :func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a " +"case-sensitive comparison, regardless of whether that's standard for the " "operating system." msgstr "" diff --git a/library/fractions.po b/library/fractions.po index 81fa397247..e36c577909 100644 --- a/library/fractions.po +++ b/library/fractions.po @@ -46,16 +46,16 @@ msgid "" msgstr "" msgid "" -"The second version requires that *number* is an instance of :class:`numbers." -"Rational` or has the :meth:`!as_integer_ratio` method (this includes :class:" -"`float` and :class:`decimal.Decimal`). It returns a :class:`Fraction` " -"instance with exactly the same value. Assumed, that the :meth:`!" -"as_integer_ratio` method returns a pair of coprime integers and last one is " -"positive. Note that due to the usual issues with binary point (see :ref:`tut-" -"fp-issues`), the argument to ``Fraction(1.1)`` is not exactly equal to " -"11/10, and so ``Fraction(1.1)`` does *not* return ``Fraction(11, 10)`` as " -"one might expect. (But see the documentation for the :meth:" -"`limit_denominator` method below.)" +"The second version requires that *number* is an instance " +"of :class:`numbers.Rational` or has the :meth:`!as_integer_ratio` method " +"(this includes :class:`float` and :class:`decimal.Decimal`). It returns " +"a :class:`Fraction` instance with exactly the same value. Assumed, that " +"the :meth:`!as_integer_ratio` method returns a pair of coprime integers and " +"last one is positive. Note that due to the usual issues with binary point " +"(see :ref:`tut-fp-issues`), the argument to ``Fraction(1.1)`` is not exactly " +"equal to 11/10, and so ``Fraction(1.1)`` does *not* return ``Fraction(11, " +"10)`` as one might expect. (But see the documentation for " +"the :meth:`limit_denominator` method below.)" msgstr "" msgid "" @@ -70,10 +70,10 @@ msgid "" "where the optional ``sign`` may be either '+' or '-' and ``numerator`` and " "``denominator`` (if present) are strings of decimal digits (underscores may " "be used to delimit digits as with integral literals in code). In addition, " -"any string that represents a finite value and is accepted by the :class:" -"`float` constructor is also accepted by the :class:`Fraction` constructor. " -"In either form the input string may also have leading and/or trailing " -"whitespace. Here are some examples::" +"any string that represents a finite value and is accepted by " +"the :class:`float` constructor is also accepted by the :class:`Fraction` " +"constructor. In either form the input string may also have leading and/or " +"trailing whitespace. Here are some examples::" msgstr "" msgid "" @@ -104,16 +104,16 @@ msgid "" msgstr "" msgid "" -"The :class:`Fraction` class inherits from the abstract base class :class:" -"`numbers.Rational`, and implements all of the methods and operations from " -"that class. :class:`Fraction` instances are :term:`hashable`, and should be " -"treated as immutable. In addition, :class:`Fraction` has the following " -"properties and methods:" +"The :class:`Fraction` class inherits from the abstract base " +"class :class:`numbers.Rational`, and implements all of the methods and " +"operations from that class. :class:`Fraction` instances " +"are :term:`hashable`, and should be treated as immutable. In " +"addition, :class:`Fraction` has the following properties and methods:" msgstr "" msgid "" -"The :class:`Fraction` constructor now accepts :class:`float` and :class:" -"`decimal.Decimal` instances." +"The :class:`Fraction` constructor now accepts :class:`float` " +"and :class:`decimal.Decimal` instances." msgstr "" msgid "" @@ -128,8 +128,8 @@ msgid "" msgstr "" msgid "" -":class:`Fraction` implements ``__int__`` now to satisfy ``typing." -"SupportsInt`` instance checks." +":class:`Fraction` implements ``__int__`` now to satisfy " +"``typing.SupportsInt`` instance checks." msgstr "" msgid "" @@ -167,9 +167,9 @@ msgid "Return ``True`` if the Fraction is an integer." msgstr "" msgid "" -"Alternative constructor which only accepts instances of :class:`float` or :" -"class:`numbers.Integral`. Beware that ``Fraction.from_float(0.3)`` is not " -"the same value as ``Fraction(3, 10)``." +"Alternative constructor which only accepts instances of :class:`float` " +"or :class:`numbers.Integral`. Beware that ``Fraction.from_float(0.3)`` is " +"not the same value as ``Fraction(3, 10)``." msgstr "" msgid "" @@ -178,8 +178,8 @@ msgid "" msgstr "" msgid "" -"Alternative constructor which only accepts instances of :class:`decimal." -"Decimal` or :class:`numbers.Integral`." +"Alternative constructor which only accepts instances " +"of :class:`decimal.Decimal` or :class:`numbers.Integral`." msgstr "" msgid "" @@ -188,10 +188,10 @@ msgid "" msgstr "" msgid "" -"Alternative constructor which only accepts instances of :class:`numbers." -"Integral`, :class:`numbers.Rational`, :class:`float` or :class:`decimal." -"Decimal`, and objects with the :meth:`!as_integer_ratio` method, but not " -"strings." +"Alternative constructor which only accepts instances " +"of :class:`numbers.Integral`, :class:`numbers.Rational`, :class:`float` " +"or :class:`decimal.Decimal`, and objects with the :meth:`!as_integer_ratio` " +"method, but not strings." msgstr "" msgid "" @@ -217,14 +217,14 @@ msgid "" "The first version returns the nearest :class:`int` to ``self``, rounding " "half to even. The second version rounds ``self`` to the nearest multiple of " "``Fraction(1, 10**ndigits)`` (logically, if ``ndigits`` is negative), again " -"rounding half toward even. This method can also be accessed through the :" -"func:`round` function." +"rounding half toward even. This method can also be accessed through " +"the :func:`round` function." msgstr "" msgid "" -"Provides support for formatting of :class:`Fraction` instances via the :meth:" -"`str.format` method, the :func:`format` built-in function, or :ref:" -"`Formatted string literals `." +"Provides support for formatting of :class:`Fraction` instances via " +"the :meth:`str.format` method, the :func:`format` built-in function, " +"or :ref:`Formatted string literals `." msgstr "" msgid "" diff --git a/library/ftplib.po b/library/ftplib.po index 6e299e94fa..b967e46dec 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,12 +31,12 @@ msgid "**Source code:** :source:`Lib/ftplib.py`" msgstr "**Kod źródłowy:** :source:`Lib/ftplib.py`" msgid "" -"This module defines the class :class:`FTP` and a few related items. The :" -"class:`FTP` class implements the client side of the FTP protocol. You can " -"use this to write Python programs that perform a variety of automated FTP " -"jobs, such as mirroring other FTP servers. It is also used by the module :" -"mod:`urllib.request` to handle URLs that use FTP. For more information on " -"FTP (File Transfer Protocol), see internet :rfc:`959`." +"This module defines the class :class:`FTP` and a few related items. " +"The :class:`FTP` class implements the client side of the FTP protocol. You " +"can use this to write Python programs that perform a variety of automated " +"FTP jobs, such as mirroring other FTP servers. It is also used by the " +"module :mod:`urllib.request` to handle URLs that use FTP. For more " +"information on FTP (File Transfer Protocol), see internet :rfc:`959`." msgstr "" msgid "The default encoding is UTF-8, following :rfc:`2640`." @@ -67,14 +68,14 @@ msgid "" "drwxr-xr-x 3 1176 1176 4096 Oct 10 2012 tools\n" "'226 Directory send OK.'\n" ">>> with open('README', 'wb') as fp:\n" -">>> ftp.retrbinary('RETR README', fp.write)\n" +"... ftp.retrbinary('RETR README', fp.write)\n" "'226 Transfer complete.'\n" ">>> ftp.quit()\n" "'221 Goodbye.'" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "FTP objects" msgstr "" @@ -122,8 +123,8 @@ msgid "*source_address* parameter was added." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket. The " +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket. The " "*encoding* parameter was added, and the default was changed from Latin-1 to " "UTF-8 to follow :rfc:`2640`." msgstr "" @@ -264,9 +265,9 @@ msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`." msgstr "" msgid "" -"A file object (opened in binary mode) which is read until EOF, using its :" -"meth:`~io.RawIOBase.read` method in blocks of size *blocksize* to provide " -"the data to be stored." +"A file object (opened in binary mode) which is read until EOF, using " +"its :meth:`~io.RawIOBase.read` method in blocks of size *blocksize* to " +"provide the data to be stored." msgstr "" msgid "The read block size. Defaults to ``8192``." @@ -316,14 +317,14 @@ msgid "" msgstr "" msgid "" -"List a directory in a standardized format by using ``MLSD`` command (:rfc:" -"`3659`). If *path* is omitted the current directory is assumed. *facts* is " -"a list of strings representing the type of information desired (e.g. " -"``[\"type\", \"size\", \"perm\"]``). Return a generator object yielding a " -"tuple of two elements for every file found in path. First element is the " -"file name, the second one is a dictionary containing facts about the file " -"name. Content of this dictionary might be limited by the *facts* argument " -"but server is not guaranteed to return all requested facts." +"List a directory in a standardized format by using ``MLSD`` command " +"(:rfc:`3659`). If *path* is omitted the current directory is assumed. " +"*facts* is a list of strings representing the type of information desired " +"(e.g. ``[\"type\", \"size\", \"perm\"]``). Return a generator object " +"yielding a tuple of two elements for every file found in path. First " +"element is the file name, the second one is a dictionary containing facts " +"about the file name. Content of this dictionary might be limited by the " +"*facts* argument but server is not guaranteed to return all requested facts." msgstr "" msgid "" @@ -393,14 +394,14 @@ msgid "FTP_TLS objects" msgstr "" msgid "" -"An :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:" -"`4217`. Connect to port 21 implicitly securing the FTP control connection " -"before authenticating." +"An :class:`FTP` subclass which adds TLS support to FTP as described " +"in :rfc:`4217`. Connect to port 21 implicitly securing the FTP control " +"connection before authenticating." msgstr "" msgid "" -"The user must explicitly secure the data connection by calling the :meth:" -"`prot_p` method." +"The user must explicitly secure the data connection by calling " +"the :meth:`prot_p` method." msgstr "" msgid "" @@ -418,8 +419,9 @@ msgid "Added the *source_address* parameter." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -458,8 +460,9 @@ msgid "" msgstr "" msgid "" -"The method now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The method now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" diff --git a/library/functional.po b/library/functional.po index 585600203d..f8c0489a39 100644 --- a/library/functional.po +++ b/library/functional.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/functions.po b/library/functions.po index f332823749..80c65a52bd 100644 --- a/library/functions.po +++ b/library/functions.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2026 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2026\n" +"POT-Creation-Date: 2026-09-11 18:24+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -320,9 +320,9 @@ msgid "" "Return an :term:`asynchronous iterator` for an :term:`asynchronous " "iterable`. Equivalent to calling ``x.__aiter__()``." msgstr "" -"Zwraca :term:`asynchroniczny iterator ` dla :term:" -"`asynchronicznego iterable'a `. Ekwiwalent wywołania " -"``x.__aiter__()``." +"Zwraca :term:`asynchroniczny iterator ` " +"dla :term:`asynchronicznego iterable'a `. Ekwiwalent " +"wywołania ``x.__aiter__()``." msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant." msgstr "" @@ -351,11 +351,8 @@ msgstr "" msgid "" "When awaited, return the next item from the given :term:`asynchronous " -"iterator`, or *default* if given and the iterator is exhausted." +"iterator`, or *default* if given and the iterator is :term:`exhausted`." msgstr "" -"W przypadku oczekiwania zwraca następny element z podanego :term:" -"`asynchronicznego iteratora ` lub wartość *default*, " -"jeżeli jest ona podana, a iterator został wyczerpany." msgid "" "This is the async variant of the :func:`next` builtin, and behaves similarly." @@ -369,11 +366,11 @@ msgid "" "iterator. If *default* is given, it is returned if the iterator is " "exhausted, otherwise :exc:`StopAsyncIteration` is raised." msgstr "" -"Wywołuje on metodę :meth:`~object.__anext__` *async_iteratora*, zwracając :" -"term:`awaitable`. Oczekiwanie zwraca następną wartość iteratora. Jeśli " -"podano wartość *default*, jest ona zwracana, jeśli iterator zostanie " -"wyczerpany, w przeciwnym razie zostanie podniesiony wyjątek :exc:" -"`StopAsyncIteration`." +"Wywołuje on metodę :meth:`~object.__anext__` *async_iteratora*, " +"zwracając :term:`awaitable`. Oczekiwanie zwraca następną wartość iteratora. " +"Jeśli podano wartość *default*, jest ona zwracana, jeśli iterator zostanie " +"wyczerpany, w przeciwnym razie zostanie podniesiony " +"wyjątek :exc:`StopAsyncIteration`." msgid "" "Return ``True`` if any element of the *iterable* is true. If the iterable " @@ -397,9 +394,9 @@ msgstr "" msgid "" "As :func:`repr`, return a string containing a printable representation of an " -"object, but escape the non-ASCII characters in the string returned by :func:" -"`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates a string " -"similar to that returned by :func:`repr` in Python 2." +"object, but escape the non-ASCII characters in the string returned " +"by :func:`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates " +"a string similar to that returned by :func:`repr` in Python 2." msgstr "" "Tak jak :func:`repr`, zwraca ciąg znaków zawierający reprezentację obiektu, " "ale wypisuje znaki nie-ASCII w zwracanym przez :func:`repr` ciągu przy " @@ -408,9 +405,9 @@ msgstr "" msgid "" "Convert an integer number to a binary string prefixed with \"0b\". The " -"result is a valid Python expression. If *integer* is not a Python :class:" -"`int` object, it has to define an :meth:`~object.__index__` method that " -"returns an integer. Some examples:" +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. Some examples:" msgstr "" "Konwertuje liczbę całkowitą do binarnego ciągu znaków z prefiksem „0b”. " "Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " @@ -437,17 +434,17 @@ msgid "" "Return a Boolean value, i.e. one of ``True`` or ``False``. The argument is " "converted using the standard :ref:`truth testing procedure `. If the " "argument is false or omitted, this returns ``False``; otherwise, it returns " -"``True``. The :class:`bool` class is a subclass of :class:`int` (see :ref:" -"`typesnumeric`). It cannot be subclassed further. Its only instances are " -"``False`` and ``True`` (see :ref:`typebool`)." +"``True``. The :class:`bool` class is a subclass of :class:`int` " +"(see :ref:`typesnumeric`). It cannot be subclassed further. Its only " +"instances are ``False`` and ``True`` (see :ref:`typebool`)." msgstr "" "Zwraca wartość logiczną, tj. jedno z ``True`` lub ``False``. Wartość " -"argumentu jest konwertowana przy użyciu standardowej procedury testowania :" -"ref:`truth testing procedure`. Jeśli argument jest fałszywy lub " -"pominięty, zwraca ``False``; w przeciwnym razie, zwraca ``True``. Klasa :" -"class:`bool` jest podklasą klasy :class:`int` (zobacz :ref:`typesnumeric`). " -"Nie może być dalej podklasowana. Jej jedynymi instancjami są ``False`` i " -"``True`` (zobacz :ref:`typebool`)." +"argumentu jest konwertowana przy użyciu standardowej procedury " +"testowania :ref:`truth testing procedure`. Jeśli argument jest " +"fałszywy lub pominięty, zwraca ``False``; w przeciwnym razie, zwraca " +"``True``. Klasa :class:`bool` jest podklasą klasy :class:`int` " +"(zobacz :ref:`typesnumeric`). Nie może być dalej podklasowana. Jej jedynymi " +"instancjami są ``False`` i ``True`` (zobacz :ref:`typebool`)." msgid "The parameter is now positional-only." msgstr "Parametr jest teraz tylko-pozycyjny." @@ -467,17 +464,17 @@ msgstr "" "szczególności wywołuje :func:`sys.breakpointhook`, przekazując do niego " "bezpośrednio ``args`` i ``kws``. Domyślnie ``sys.breakpointhook()`` wywołuje " "funkcję :func:`pdb.set_trace` nie oczekującą argumentu. W tym przypadku jest " -"to wyłącznie funkcja dla wygody, aby nie trzeba było jawnie importować :mod:" -"`pdb` ani wpisywać tak dużo kodu, aby wejść do debuggera. Jednakże :func:" -"`sys.breakpointhook` może być ustawiony na inną funkcję i :func:`breakpoint` " -"automatycznie wywoła ją, pozwalając na przejście do wybranego debuggera. " -"Jeśli :func:`sys.breakpointhook` nie jest dostępny, funkcja rzuci :exc:" -"`RuntimeError`." +"to wyłącznie funkcja dla wygody, aby nie trzeba było jawnie " +"importować :mod:`pdb` ani wpisywać tak dużo kodu, aby wejść do debuggera. " +"Jednakże :func:`sys.breakpointhook` może być ustawiony na inną funkcję " +"i :func:`breakpoint` automatycznie wywoła ją, pozwalając na przejście do " +"wybranego debuggera. Jeśli :func:`sys.breakpointhook` nie jest dostępny, " +"funkcja rzuci :exc:`RuntimeError`." msgid "" -"By default, the behavior of :func:`breakpoint` can be changed with the :" -"envvar:`PYTHONBREAKPOINT` environment variable. See :func:`sys." -"breakpointhook` for usage details." +"By default, the behavior of :func:`breakpoint` can be changed with " +"the :envvar:`PYTHONBREAKPOINT` environment variable. " +"See :func:`sys.breakpointhook` for usage details." msgstr "" "Domyślnie zachowanie funkcji :func:`breakpoint` można zmienić za pomocą " "zmiennej środowiskowej :envvar:`PYTHONBREAKPOINT`. Szczegółowe informacje " @@ -487,8 +484,8 @@ msgid "" "Note that this is not guaranteed if :func:`sys.breakpointhook` has been " "replaced." msgstr "" -"Należy pamiętać, że nie jest to gwarantowane, jeśli :func:`sys." -"breakpointhook` został wymieniony." +"Należy pamiętać, że nie jest to gwarantowane, " +"jeśli :func:`sys.breakpointhook` został wymieniony." msgid "" "Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " @@ -556,8 +553,8 @@ msgstr "Zobacz też :ref:`binaryseq` i :ref:`typebytearray`." msgid "" "Return a new \"bytes\" object which is an immutable sequence of integers in " -"the range ``0 <= x < 256``. :class:`bytes` is an immutable version of :" -"class:`bytearray` -- it has the same non-mutating methods and the same " +"the range ``0 <= x < 256``. :class:`bytes` is an immutable version " +"of :class:`bytearray` -- it has the same non-mutating methods and the same " "indexing and slicing behavior." msgstr "" "Zwraca nowy obiekt „bajtów”, który jest niemutowalną sekwencją liczb " @@ -578,18 +575,19 @@ msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`." msgstr "Zobacz też :ref:`binaryseq`, :ref:`typebytes` i :ref:`bytes-methods`." msgid "" -"Return :const:`True` if the *object* argument appears callable, :const:" -"`False` if not. If this returns ``True``, it is still possible that a call " -"fails, but if it is ``False``, calling *object* will never succeed. Note " -"that classes are callable (calling a class returns a new instance); " -"instances are callable if their class has a :meth:`~object.__call__` method." +"Return :const:`True` if the *object* argument appears " +"callable, :const:`False` if not. If this returns ``True``, it is still " +"possible that a call fails, but if it is ``False``, calling *object* will " +"never succeed. Note that classes are callable (calling a class returns a new " +"instance); instances are callable if their class has " +"a :meth:`~object.__call__` method." msgstr "" -"Zwraca :const:`True` jeśli argument *object* jest wywoływalny, :const:" -"`False` jeśli nie. Jeśli zwraca ``True``, nadal możliwe jest, że wywołanie " -"nie powiedzie się, ale jeśli zwraca ``False``, wywołanie *object* nigdy się " -"nie powiedzie. Należy pamiętać, że klasy są wywoływalne (wywołanie klasy " -"zwraca nową instancję); instancje są wywoływalne, jeśli ich klasa ma metodę :" -"meth:`~object.__call__`." +"Zwraca :const:`True` jeśli argument *object* jest " +"wywoływalny, :const:`False` jeśli nie. Jeśli zwraca ``True``, nadal możliwe " +"jest, że wywołanie nie powiedzie się, ale jeśli zwraca ``False``, wywołanie " +"*object* nigdy się nie powiedzie. Należy pamiętać, że klasy są wywoływalne " +"(wywołanie klasy zwraca nową instancję); instancje są wywoływalne, jeśli ich " +"klasa ma metodę :meth:`~object.__call__`." msgid "" "This function was first removed in Python 3.0 and then brought back in " @@ -612,8 +610,8 @@ msgid "" "base 16). :exc:`ValueError` will be raised if it is outside that range." msgstr "" "Poprawnym zakresem argumentu są wartości od 0 do 1 114 111 (0x10FFFF w " -"systemie szesnastkowym). Dla wartości poza tym zakresem zostanie rzucony :" -"exc:`ValueError`." +"systemie szesnastkowym). Dla wartości poza tym zakresem zostanie " +"rzucony :exc:`ValueError`." msgid "Transform a method into a class method." msgstr "Przekształca metodę w metodę klasową." @@ -637,8 +635,8 @@ msgstr "" " def f(cls, arg1, arg2): ..." msgid "" -"The ``@classmethod`` form is a function :term:`decorator` -- see :ref:" -"`function` for details." +"The ``@classmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." msgstr "" "Forma ``@classmethod`` jest :term:`dekoratorem ` funkcji – " "szczegóły znajdziesz w :ref:`function`." @@ -665,22 +663,21 @@ msgstr "" "metodach klasowych znajdziesz w :ref:`types`." msgid "" -"Class methods can now wrap other :term:`descriptors ` such as :" -"func:`property`." +"Class methods can now wrap other :term:`descriptors ` such " +"as :func:`property`." msgstr "" "Metody klasowe mogą teraz opakowywać inne :term:`deskryptory `, " "takie jak :func:`property`." msgid "" -"Class methods now inherit the method attributes (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` and :attr:`~function.__annotations__`) and have a " -"new ``__wrapped__`` attribute." +"Class methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`) and have a new ``__wrapped__`` " +"attribute." msgstr "" -"Metody klasowe dziedziczą teraz atrybuty metod (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` i :attr:`~function.__annotations__`) i mają nowy " -"atrybut ``__wrapped__``." +"Metody klasowe dziedziczą teraz atrybuty metod " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`) i mają nowy atrybut ``__wrapped__``." msgid "" "Class methods can no longer wrap other :term:`descriptors ` such " @@ -724,23 +721,23 @@ msgstr "" "zostaną wydrukowane na standardowe wyjście)." msgid "" -"The optional arguments *flags* and *dont_inherit* control which :ref:" -"`compiler options ` should be activated and which :ref:" -"`future features ` should be allowed. If neither is present (or both " -"are zero) the code is compiled with the same flags that affect the code that " -"is calling :func:`compile`. If the *flags* argument is given and " -"*dont_inherit* is not (or is zero) then the compiler options and the future " -"statements specified by the *flags* argument are used in addition to those " -"that would be used anyway. If *dont_inherit* is a non-zero integer then the " -"*flags* argument is it -- the flags (future features and compiler options) " -"in the surrounding code are ignored." +"The optional arguments *flags* and *dont_inherit* control " +"which :ref:`compiler options ` should be activated and " +"which :ref:`future features ` should be allowed. If neither is " +"present (or both are zero) the code is compiled with the same flags that " +"affect the code that is calling :func:`compile`. If the *flags* argument is " +"given and *dont_inherit* is not (or is zero) then the compiler options and " +"the future statements specified by the *flags* argument are used in addition " +"to those that would be used anyway. If *dont_inherit* is a non-zero integer " +"then the *flags* argument is it -- the flags (future features and compiler " +"options) in the surrounding code are ignored." msgstr "" "Opcjonalne argumenty *flags* i *dont_inherit* kontrolują, które :ref:`opcje " -"kompilatora ` powinny być aktywowane i które :ref:" -"`przyszłe funkcje ` powinne być dozwolone. Jeśli żaden z nich nie " -"jest obecny (lub oba są zerowe), kod jest kompilowany z tymi samymi flagami, " -"które wpływają na kod wywołujący :func:`compile`. Jeśli argument *flags* " -"jest podany, a *dont_inherit* nie jest (lub wynosi zero), to opcje " +"kompilatora ` powinny być aktywowane i " +"które :ref:`przyszłe funkcje ` powinne być dozwolone. Jeśli żaden z " +"nich nie jest obecny (lub oba są zerowe), kod jest kompilowany z tymi samymi " +"flagami, które wpływają na kod wywołujący :func:`compile`. Jeśli argument " +"*flags* jest podany, a *dont_inherit* nie jest (lub wynosi zero), to opcje " "kompilatora i przyszłe instrukcje określone przez argument *flags* są " "używane w dodatku do tych, które i tak byłyby użyte. Jeśli *dont_inherit* " "jest niezerową liczbą całkowitą, to argument *flags* jest nim – flagi " @@ -749,15 +746,17 @@ msgstr "" msgid "" "Compiler options and future statements are specified by bits which can be " "bitwise ORed together to specify multiple options. The bitfield required to " -"specify a given future feature can be found as the :attr:`~__future__." -"_Feature.compiler_flag` attribute on the :class:`~__future__._Feature` " -"instance in the :mod:`__future__` module. :ref:`Compiler flags ` can be found in :mod:`ast` module, with ``PyCF_`` prefix." +"specify a given future feature can be found as " +"the :attr:`~__future__._Feature.compiler_flag` attribute on " +"the :class:`~__future__._Feature` instance in the :mod:`__future__` " +"module. :ref:`Compiler flags ` can be found " +"in :mod:`ast` module, with ``PyCF_`` prefix." msgstr "" "Opcje kompilatora i przyszłe instrukcja są określone przez bity, które mogą " "być łączone bitowo w celu określenia wielu opcji. Pole bitowe wymagane do " -"określenia danej przyszłej funkcji można znaleźć jako :attr:`~__future__." -"_Feature.compiler_flag` atrybut na instancji :class:`~__future__._Feature` w " +"określenia danej przyszłej funkcji można znaleźć " +"jako :attr:`~__future__._Feature.compiler_flag` atrybut na " +"instancji :class:`~__future__._Feature` w " "module :mod:`__future__` . :ref:`Flagi kompilatora ` " "można znaleźć w module :mod:`ast` , z prefiksem ``PyCF_``." @@ -782,11 +781,11 @@ msgstr "" "źródło jest nieprawidłowe." msgid "" -"If you want to parse Python code into its AST representation, see :func:`ast." -"parse`." +"If you want to parse Python code into its AST representation, " +"see :func:`ast.parse`." msgstr "" -"Jeśli chcesz przeanalizować kod Python do jego reprezentacji AST, zobacz :" -"func:`ast.parse`." +"Jeśli chcesz przeanalizować kod Python do jego reprezentacji AST, " +"zobacz :func:`ast.parse`." msgid "" "Raises an :ref:`auditing event ` ``compile`` with arguments " @@ -800,8 +799,8 @@ msgstr "" msgid "" "When compiling a string with multi-line code in ``'single'`` or ``'eval'`` " "mode, input must be terminated by at least one newline character. This is " -"to facilitate detection of incomplete and complete statements in the :mod:" -"`code` module." +"to facilitate detection of incomplete and complete statements in " +"the :mod:`code` module." msgstr "" "Podczas kompilacji napisem z kodem wielowierszowym w trybie ``'single'`` lub " "``'eval'``, dane wejściowe muszą być zakończone co najmniej jedną znak nowej " @@ -894,9 +893,9 @@ msgid "" "and ``')'``, which are ignored. The string must not contain whitespace " "between ``'+'``, ``'-'``, the ``'j'`` or ``'J'`` suffix, and the decimal " "number. For example, ``complex('1+2j')`` is fine, but ``complex('1 + 2j')`` " -"raises :exc:`ValueError`. More precisely, the input must conform to the :" -"token:`~float:complexvalue` production rule in the following grammar, after " -"parentheses and leading and trailing whitespace characters are removed:" +"raises :exc:`ValueError`. More precisely, the input must conform to " +"the :token:`~float:complexvalue` production rule in the following grammar, " +"after parentheses and leading and trailing whitespace characters are removed:" msgstr "" "Jeśli argument jest napisem, musi zawierać albo część rzeczywistą (w tym " "samym formacie co :func:`float`), albo część urojoną (w tym samym formacie, " @@ -913,17 +912,17 @@ msgstr "" msgid "" "If the argument is a number, the constructor serves as a numeric conversion " "like :class:`int` and :class:`float`. For a general Python object ``x``, " -"``complex(x)`` delegates to ``x.__complex__()``. If :meth:`~object." -"__complex__` is not defined then it falls back to :meth:`~object.__float__`. " -"If :meth:`!__float__` is not defined then it falls back to :meth:`~object." -"__index__`." +"``complex(x)`` delegates to ``x.__complex__()``. " +"If :meth:`~object.__complex__` is not defined then it falls back " +"to :meth:`~object.__float__`. If :meth:`!__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." msgstr "" "Jeśli argument jest liczbą, konstruktor służy jako konwersja numeryczna, " "podobnie jak :class:`int` i :class:`float`. Dla ogólnego obiektu Python " -"``x`` , ``complex(x)`` deleguje do ``x.__complex__()``. Jeśli :meth:`~object." -"__complex__` nie jest zdefiniowane, to spada z powrotem do :meth:`~object." -"__float__`. Jeśli :meth:`!__float__` nie jest zdefiniowane, to spada z " -"powrotem do :meth:`~object.__index__`." +"``x`` , ``complex(x)`` deleguje do ``x.__complex__()``. " +"Jeśli :meth:`~object.__complex__` nie jest zdefiniowane, to spada z powrotem " +"do :meth:`~object.__float__`. Jeśli :meth:`!__float__` nie jest " +"zdefiniowane, to spada z powrotem do :meth:`~object.__index__`." msgid "" "If two arguments are provided or keyword arguments are used, each argument " @@ -939,9 +938,9 @@ msgstr "" "liczbami rzeczywistymi, zwracana jest liczba zespolona ze składnikiem " "rzeczywistym *real* i składnikiem urojonym *imag*. Jeśli oba argumenty są " "liczbami zespolonymi, zwracana jest liczba zespolona ze składnikiem " -"rzeczywistym ``real.real-imag.imag`` i składnikiem urojonym ``real.imag+imag." -"real``. Jeśli jeden z argumentów jest liczbą rzeczywistą, w powyższych " -"wyrażeniach używany jest tylko jego składnik rzeczywisty." +"rzeczywistym ``real.real-imag.imag`` i składnikiem urojonym " +"``real.imag+imag.real``. Jeśli jeden z argumentów jest liczbą rzeczywistą, w " +"powyższych wyrażeniach używany jest tylko jego składnik rzeczywisty." msgid "" "See also :meth:`complex.from_number` which only accepts a single numeric " @@ -962,11 +961,11 @@ msgstr "" "kodu." msgid "" -"Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` and :" -"meth:`~object.__float__` are not defined." +"Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` " +"and :meth:`~object.__float__` are not defined." msgstr "" -"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__complex__` i :" -"meth:`~object.__float__` nie są zdefiniowane." +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__complex__` " +"i :meth:`~object.__float__` nie są zdefiniowane." msgid "" "Passing a complex number as the *real* or *imag* argument is now deprecated; " @@ -991,18 +990,18 @@ msgstr "" msgid "" "Create a new dictionary. The :class:`dict` object is the dictionary class. " -"See :class:`dict` and :ref:`typesmapping` for documentation about this class." +"See also :ref:`typesmapping` for documentation about this class." msgstr "" -"Utwórz nowy słownik. Obiekt :class:`dict` jest klasą słownik. Dokumentacja " -"dotycząca tej klasy znajduje się na stronach :class:`dict` i :ref:" -"`typesmapping`." +"Tworzy nowy słownik. Obiekt :class:`dict` jest klasą wbudowaną. Zobacz " +"też :ref:`typesmapping` po więcej dokumentacji na temat tej klasy." msgid "" -"For other containers see the built-in :class:`list`, :class:`set`, and :" -"class:`tuple` classes, as well as the :mod:`collections` module." +"For other containers see the built-in :class:`list`, :class:`set`, " +"and :class:`tuple` classes, as well as the :mod:`collections` module." msgstr "" -"Inne kontenery można znaleźć w klasach wbudowanych :class:`list` , :class:" -"`set` i :class:`tuple`, a także moduł :mod:`collections` ." +"Inne kontenery można znaleźć w klasach " +"wbudowanych :class:`list` , :class:`set` i :class:`tuple`, a także " +"moduł :mod:`collections` ." msgid "" "Without arguments, return the list of names in the current local scope. " @@ -1015,28 +1014,28 @@ msgstr "" msgid "" "If the object has a method named :meth:`~object.__dir__`, this method will " "be called and must return the list of attributes. This allows objects that " -"implement a custom :func:`~object.__getattr__` or :func:`~object." -"__getattribute__` function to customize the way :func:`dir` reports their " -"attributes." +"implement a custom :func:`~object.__getattr__` " +"or :func:`~object.__getattribute__` function to customize the " +"way :func:`dir` reports their attributes." msgstr "" "Jeśli obiekt posiada metodę o nazwie :meth:`~object.__dir__`, metoda ta " "zostanie wywołana i musi zwracać listę atrybut. Pozwala to obiektom, które " -"implementują niestandardowe :func:`~object.__getattr__` lub :func:`~object." -"__getattribute__` funkcje na dostosowanie sposobu, w jaki :func:`dir` " -"zgłasza ich atrybuty." +"implementują niestandardowe :func:`~object.__getattr__` " +"lub :func:`~object.__getattribute__` funkcje na dostosowanie sposobu, w " +"jaki :func:`dir` zgłasza ich atrybuty." msgid "" "If the object does not provide :meth:`~object.__dir__`, the function tries " "its best to gather information from the object's :attr:`~object.__dict__` " "attribute, if defined, and from its type object. The resulting list is not " -"necessarily complete and may be inaccurate when the object has a custom :" -"func:`~object.__getattr__`." +"necessarily complete and may be inaccurate when the object has a " +"custom :func:`~object.__getattr__`." msgstr "" "Jeśli obiekt nie udostępnia :meth:`~object.__dir__`, funkcja stara się " "zebrać informacje z :attr:`~object.__dict__` atrybut obiektu, jeśli jest " "zdefiniowany, oraz z jego obiektu typu. Wynikowa lista niekoniecznie jest " -"kompletna i może być niedokładna, jeśli obiekt ma niestandardowy :func:" -"`~object.__getattr__`." +"kompletna i może być niedokładna, jeśli obiekt ma " +"niestandardowy :func:`~object.__getattr__`." msgid "" "The default :func:`dir` mechanism behaves differently with different types " @@ -1091,10 +1090,10 @@ msgid "" "consisting of their quotient and remainder when using integer division. " "With mixed operand types, the rules for binary arithmetic operators apply. " "For integers, the result is the same as ``(a // b, a % b)``. For floating-" -"point numbers the result is ``(q, a % b)``, where *q* is usually ``math." -"floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` " -"is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, " -"and ``0 <= abs(a % b) < abs(b)``." +"point numbers the result is ``(q, a % b)``, where *q* is usually " +"``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b + a " +"% b`` is very close to *a*, if ``a % b`` is non-zero it has the same sign as " +"*b*, and ``0 <= abs(a % b) < abs(b)``." msgstr "" "Weź dwie (niezłożone) liczby jako argumenty i zwraca parę liczb składającą " "się z ich ilorazu i reszty, gdy używasz liczba całkowita dzielenia. W " @@ -1107,17 +1106,18 @@ msgstr "" "b) < abs(b)``." msgid "" -"Return an enumerate object. *iterable* must be a sequence, an :term:" -"`iterator`, or some other object which supports iteration. The :meth:" -"`~iterator.__next__` method of the iterator returned by :func:`enumerate` " -"returns a tuple containing a count (from *start* which defaults to 0) and " -"the values obtained from iterating over *iterable*." +"Return an enumerate object. *iterable* must be a sequence, " +"an :term:`iterator`, or some other object which supports iteration. " +"The :meth:`~iterator.__next__` method of the iterator returned " +"by :func:`enumerate` returns a tuple containing a count (from *start* which " +"defaults to 0) and the values obtained from iterating over *iterable*." msgstr "" "Zwraca obiekt wyliczeniowy. *iterable* musi być sekwencją, :term:`iteratorem " -"` lub innym obiektem obsługującym iterację. Metoda :meth:" -"`~iterator.__next__` iteratora zwróconego przez :func:`enumerate` zwraca " -"dwukrotkę zawierającą licznik (od *start*, który domyślnie wynosi 0) i " -"wartości uzyskane z iteracji na argumencie *iterable*." +"` lub innym obiektem obsługującym iterację. " +"Metoda :meth:`~iterator.__next__` iteratora zwróconego " +"przez :func:`enumerate` zwraca dwukrotkę zawierającą licznik (od *start*, " +"który domyślnie wynosi 0) i wartości uzyskane z iteracji na argumencie " +"*iterable*." msgid "Equivalent to::" msgstr "Odpowiednik::" @@ -1169,36 +1169,36 @@ msgstr "" msgid "" "The *source* argument is parsed and evaluated as a Python expression " -"(technically speaking, a condition list) using the *globals* and *locals* " -"mappings as global and local namespace. If the *globals* dictionary is " -"present and does not contain a value for the key ``__builtins__``, a " -"reference to the dictionary of the built-in module :mod:`builtins` is " -"inserted under that key before *source* is parsed. Overriding " -"``__builtins__`` can be used to restrict or change the available names, but " -"this is **not** a security mechanism: the executed code can still access all " -"builtins. If the *locals* mapping is omitted it defaults to the *globals* " -"dictionary. If both mappings are omitted, the source is executed with the " -"*globals* and *locals* in the environment where :func:`eval` is called. " -"Note, *eval()* will only have access to the :term:`nested scopes ` (non-locals) in the enclosing environment if they are already " -"referenced in the scope that is calling :func:`eval` (e.g. via a :keyword:" -"`nonlocal` statement)." +"(technically speaking, an :ref:`expression list `) using the " +"*globals* and *locals* mappings as global and local namespace. If the " +"*globals* dictionary is present and does not contain a value for the key " +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key before *source* is parsed. " +"Overriding ``__builtins__`` can be used to restrict or change the available " +"names, but this is **not** a security mechanism: the executed code can still " +"access all builtins. If the *locals* mapping is omitted it defaults to the " +"*globals* dictionary. If both mappings are omitted, the source is executed " +"with the *globals* and *locals* in the environment where :func:`eval` is " +"called. Note, *eval()* will only have access to the :term:`nested scopes " +"` (non-locals) in the enclosing environment if they are " +"already referenced in the scope that is calling :func:`eval` (e.g. via " +"a :keyword:`nonlocal` statement)." msgstr "" "Argument *source* jest analizowany i ewaluowany jako wyrażenie Python " -"(technicznie rzecz biorąc, lista warunków) przy użyciu mapowań *globals* i " -"*locals* jako globalnej i lokalnej przestrzeni nazw. Jeśli słownik " -"*globals* jest obecny i nie zawiera wartości dla klucza ``__builtins__``, " -"odwołanie do słownika wbudowanego modułu :mod:`builtins` jest wstawiane pod " -"tym kluczem, zanim *source* zostanie przeanalizowane. Nadpisywanie " -"``__builtins__`` może służyć do ograniczenia lub zmiany dostępnych nazw, ale " -"**nie** jest to mechanizm zabezpieczający: wykonywany kod nadal ma dostęp do " -"wszystkich wbudowanych funkcji. Jeśli mapowanie *locals* zostanie pominięte, " -"domyślnie będzie to słownik *globals*. Jeśli oba mapowania są pominięte, " -"wyrażenie jest wykonywane z *globals* i *locals* w środowisku, w którym " -"wywoływany jest :func:`eval`. Uwaga, *eval()* będzie miał dostęp do :term:" -"`zagnieżdżonych zakresów ` (non-locals) w otaczającym " -"środowisku tylko wtedy, gdy są one już przywoływane w zakresie, który " -"wywołuje :func:`eval` (np. poprzez instrukcję :keyword:`nonlocal`)." +"(technicznie rzecz biorąc, :ref:`expression list `) przy użyciu " +"mapowań *globals* i *locals* jako globalnej i lokalnej przestrzeni nazw. " +"Jeśli słownik *globals* jest obecny i nie zawiera wartości dla klucza " +"``__builtins__``, odwołanie do słownika wbudowanego modułu :mod:`builtins` " +"jest wstawiane pod tym kluczem, zanim *source* zostanie przeanalizowane. " +"Nadpisywanie ``__builtins__`` może służyć do ograniczenia lub zmiany " +"dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: wykonywany " +"kod nadal ma dostęp do wszystkich wbudowanych funkcji. Jeśli mapowanie " +"*locals* zostanie pominięte, domyślnie będzie to słownik *globals*. Jeśli " +"oba mapowania są pominięte, wyrażenie jest wykonywane z *globals* i *locals* " +"w środowisku, w którym wywoływany jest :func:`eval`. Uwaga, *eval()* będzie " +"miał dostęp do :term:`zagnieżdżonych zakresów ` (non-locals) w " +"otaczającym środowisku tylko wtedy, gdy są one już przywoływane w zakresie, " +"który wywołuje :func:`eval` (np. poprzez instrukcję :keyword:`nonlocal`)." msgid "Example:" msgstr "Przykład:" @@ -1221,11 +1221,11 @@ msgid "" "current global and local dictionary, respectively, which may be useful to " "pass around for use by :func:`eval` or :func:`exec`." msgstr "" -"Wskazówki: dynamiczne wykonywanie instrukcji jest obsługiwane przez :func:" -"`exec` funkcja . Adresy :func:`globals` i :func:`locals` funkcje zwracaja " -"określaaą odpowiednio bieżący globalny i lokalny adres słownika, który może " -"być przydatny do przekazania do użycia przez adresy :func:`eval` lub :func:" -"`exec`." +"Wskazówki: dynamiczne wykonywanie instrukcji jest obsługiwane " +"przez :func:`exec` funkcja . Adresy :func:`globals` i :func:`locals` " +"funkcje zwracaja określaaą odpowiednio bieżący globalny i lokalny adres " +"słownika, który może być przydatny do przekazania do użycia przez " +"adresy :func:`eval` lub :func:`exec`." msgid "" "If the given source is a string, then leading and trailing spaces and tabs " @@ -1266,10 +1266,10 @@ msgid "" "as a suite of Python statements which is then executed (unless a syntax " "error occurs). [#]_ If it is a code object, it is simply executed. In all " "cases, the code that's executed is expected to be valid as file input (see " -"the section :ref:`file-input` in the Reference Manual). Be aware that the :" -"keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements may " -"not be used outside of function definitions even within the context of code " -"passed to the :func:`exec` function. The return value is ``None``." +"the section :ref:`file-input` in the Reference Manual). Be aware that " +"the :keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements " +"may not be used outside of function definitions even within the context of " +"code passed to the :func:`exec` function. The return value is ``None``." msgstr "" "Ta funkcja obsługuje dynamiczne wykonywanie kodu Python. *source* musi być " "albo napis albo obiektem kodu. Jeśli jest to napis, napis jest analizowany " @@ -1277,10 +1277,11 @@ msgstr "" "wystąpi błąd składni). [#]_ Jeśli jest to obiekt kodu, jest on po prostu " "wykonywany. We wszystkich przypadkach wykonywany kod powinien być " "prawidłowy jako plik wejściowy (patrz sekcja :ref:`file-input` w Podręczniku " -"referencyjnym). Należy pamiętać, że wartości :keyword:`nonlocal`, :keyword:" -"`yield` i :keyword:`return` instrukcije nie mogą być używane poza " -"definicjami funkcji, nawet w kontekście kodu przekazywanego do :func:" -"`exec` . Wartość zwracana to ``None``." +"referencyjnym). Należy pamiętać, że " +"wartości :keyword:`nonlocal`, :keyword:`yield` i :keyword:`return` " +"instrukcije nie mogą być używane poza definicjami funkcji, nawet w " +"kontekście kodu przekazywanego do :func:`exec` . Wartość zwracana to " +"``None``." msgid "" "In all cases, if the optional parts are omitted, the code is executed in the " @@ -1315,10 +1316,11 @@ msgstr "" msgid "" "If the *globals* dictionary does not contain a value for the key " -"``__builtins__``, a reference to the dictionary of the built-in module :mod:" -"`builtins` is inserted under that key. Overriding ``__builtins__`` can be " -"used to restrict or change the available names, but this is **not** a " -"security mechanism: the executed code can still access all builtins." +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key. Overriding " +"``__builtins__`` can be used to restrict or change the available names, but " +"this is **not** a security mechanism: the executed code can still access all " +"builtins." msgstr "" "Jeśli słownik *globals* nie zawiera wartości dla klucza ``__builtins__``, " "odwołanie do słownika z wbudowanego modułu :mod:`builtins` jest wstawiane " @@ -1351,9 +1353,9 @@ msgid "" "Pass an explicit *locals* dictionary if you need to see effects of the code " "on *locals* after function :func:`exec` returns." msgstr "" -"Elementy domyślne *locals* działają w sposób opisany dla funkcji :func:" -"`locals` poniżej. Przekaż jawne *locals* słownik jeśli chcesz zobaczyć " -"efekty kodu na *locals* po funkcji :func:`exec` ." +"Elementy domyślne *locals* działają w sposób opisany dla " +"funkcji :func:`locals` poniżej. Przekaż jawne *locals* słownik jeśli chcesz " +"zobaczyć efekty kodu na *locals* po funkcji :func:`exec` ." msgid "Added the *closure* parameter." msgstr "Dodano parametr *zamknięcie*." @@ -1452,12 +1454,12 @@ msgstr "" "zostanie :exc:`OverflowError`." msgid "" -"For a general Python object ``x``, ``float(x)`` delegates to ``x." -"__float__()``. If :meth:`~object.__float__` is not defined then it falls " -"back to :meth:`~object.__index__`." +"For a general Python object ``x``, ``float(x)`` delegates to " +"``x.__float__()``. If :meth:`~object.__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." msgstr "" -"W przypadku ogólnego obiektu Python ``x`` , ``float(x)`` deleguje do ``x." -"__float__()``. Jeśli :meth:`~object.__float__` nie jest zdefiniowana, to " +"W przypadku ogólnego obiektu Python ``x`` , ``float(x)`` deleguje do " +"``x.__float__()``. Jeśli :meth:`~object.__float__` nie jest zdefiniowana, to " "spada z powrotem do :meth:`~object.__index__`." msgid "" @@ -1498,19 +1500,19 @@ msgstr "" "efekt jak wywołanie :func:`str(value) `." msgid "" -"A call to ``format(value, format_spec)`` is translated to ``type(value)." -"__format__(value, format_spec)`` which bypasses the instance dictionary when " -"searching for the value's :meth:`~object.__format__` method. A :exc:" -"`TypeError` exception is raised if the method search reaches :mod:`object` " -"and the *format_spec* is non-empty, or if either the *format_spec* or the " -"return value are not strings." +"A call to ``format(value, format_spec)`` is translated to " +"``type(value).__format__(value, format_spec)`` which bypasses the instance " +"dictionary when searching for the value's :meth:`~object.__format__` method. " +"A :exc:`TypeError` exception is raised if the method search " +"reaches :mod:`object` and the *format_spec* is non-empty, or if either the " +"*format_spec* or the return value are not strings." msgstr "" -"Wywołanie ``format(value, format_spec)`` jest tłumaczone na ``type(value)." -"__format__(value, format_spec)``, które omija instancję słownika podczas " -"wyszukiwania metody :meth:`~object.__format__` wartości . Wyjątek :exc:" -"`TypeError` jest rzucony, jeśli wyszukiwanie metody osiągnie :mod:`object` i " -"*format_spec* jest niepusty, lub jeśli *format_spec* lub wartość zwracana " -"nie są napisem." +"Wywołanie ``format(value, format_spec)`` jest tłumaczone na " +"``type(value).__format__(value, format_spec)``, które omija instancję " +"słownika podczas wyszukiwania metody :meth:`~object.__format__` wartości . " +"Wyjątek :exc:`TypeError` jest rzucony, jeśli wyszukiwanie metody " +"osiągnie :mod:`object` i *format_spec* jest niepusty, lub jeśli " +"*format_spec* lub wartość zwracana nie są napisem." msgid "" "``object().__format__(format_spec)`` raises :exc:`TypeError` if " @@ -1521,19 +1523,21 @@ msgstr "" msgid "" "Return a new :class:`frozenset` object, optionally with elements taken from " -"*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :" -"ref:`types-set` for documentation about this class." +"*iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-" +"set` for documentation about this class." msgstr "" -"Zwraca nowy obiekt :class:`frozenset`, opcjonalnie z elementami pobranymi z " -"*iterable*. ``frozenset`` jest klasą wbudowaną. Dokumentacja dotycząca tej " -"klasy znajduje się na stronach :class:`frozenset` i :ref:`types-set`." +"Zwraca nowy obiekt :class:`frozenset`, opcjonalnie z elementami z " +"*iterable*. :class:`frozenset` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." msgid "" -"For other containers see the built-in :class:`set`, :class:`list`, :class:" -"`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." +"For other containers see the built-" +"in :class:`set`, :class:`list`, :class:`tuple`, and :class:`dict` classes, " +"as well as the :mod:`collections` module." msgstr "" -"Dla innych kontenerów zobacz klasy wbudowane :class:`set` , :class:`list`, :" -"class:`tuple` i :class:`dict`, jak również moduł :mod:`collections` ." +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`set` , :class:`list`, :class:`tuple` i :class:`dict`, jak " +"również moduł :mod:`collections` ." msgid "" "Return the value of the named attribute of *object*. *name* must be a " @@ -1545,16 +1549,16 @@ msgid "" msgstr "" "Zwraca wartość nazwanego atrybut obiektu *object*. *name* musi być napisem. " "Jeśli napis jest nazwą jednego z atrybut obiektu, wynikiem jest wartość tego " -"atrybutu. Na przykład, ``getattr(x, 'foobar')`` jest równoważne ``x." -"foobar``. Jeśli nazwany atrybut nie istnieje, *default* jest zwracany, jeśli " -"został podany, w przeciwnym razie :exc:`AttributeError` jest rzucony. *name* " -"nie musi być identyfikatorem Pythona (Zobacz :func:`setattr`)." +"atrybutu. Na przykład, ``getattr(x, 'foobar')`` jest równoważne " +"``x.foobar``. Jeśli nazwany atrybut nie istnieje, *default* jest zwracany, " +"jeśli został podany, w przeciwnym razie :exc:`AttributeError` jest rzucony. " +"*name* nie musi być identyfikatorem Pythona (Zobacz :func:`setattr`)." msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " -"with two leading underscores) name in order to retrieve it with :func:" -"`getattr`." +"with two leading underscores) name in order to retrieve it " +"with :func:`getattr`." msgstr "" "Ponieważ :ref:`manipulowanie nazwami prywatnymi ` " "odbywa się w czasie kompilacji, należy ręcznie zmanipulować nazwę prywatną " @@ -1578,8 +1582,8 @@ msgid "" msgstr "" "Argumenty to obiekt i napis. Wynikiem jest ``True`` jeśli napis jest nazwą " "jednego z obiektów atrybut, ``False`` jeśli nie. (Jest to zaimplementowane " -"poprzez wywołanie ``getattr(object, name)`` i sprawdzenie, czy rzucone jest :" -"exc:`AttributeError` )." +"poprzez wywołanie ``getattr(object, name)`` i sprawdzenie, czy rzucone " +"jest :exc:`AttributeError` )." msgid "" "Return the hash value of the object (if it has one). Hash values are " @@ -1594,8 +1598,9 @@ msgstr "" "przypadku 1 i 1.0)." msgid "" -"For objects with custom :meth:`~object.__hash__` methods, note that :func:" -"`hash` truncates the return value based on the bit width of the host machine." +"For objects with custom :meth:`~object.__hash__` methods, note " +"that :func:`hash` truncates the return value based on the bit width of the " +"host machine." msgstr "" "W przypadku obiektów z niestandardowymi metodami :meth:`~object.__hash__` " "należy pamiętać, że :func:`hash` obcina wartość zwracaną w oparciu o " @@ -1631,8 +1636,8 @@ msgstr "" msgid "" "This function is added to the built-in namespace by the :mod:`site` module." msgstr "" -"Ta funkcja jest dodawana do przestrzeni nazw wbudowanych przez moduł :mod:" -"`site` ." +"Ta funkcja jest dodawana do przestrzeni nazw wbudowanych przez " +"moduł :mod:`site` ." msgid "" "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " @@ -1647,9 +1652,9 @@ msgid "" "an :meth:`~object.__index__` method that returns an integer. Some examples:" msgstr "" "Konwertuje liczbę całkowitą na zapis szesnastkowy małymi literami " -"poprzedzony „0x”. Jeśli *integer* nie jest pythonowym obiektem :class:" -"`int` , musi definiować metodę :meth:`~object.__index__`, która zwraca " -"liczbę całkowitą. Kilka przykładów:" +"poprzedzony „0x”. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int` , musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Kilka przykładów:" msgid "" "If you want to convert an integer number to an uppercase or lower " @@ -1668,8 +1673,8 @@ msgstr "" "całkowita przy użyciu podstawy 16." msgid "" -"To obtain a hexadecimal string representation for a float, use the :meth:" -"`float.hex` method." +"To obtain a hexadecimal string representation for a float, use " +"the :meth:`float.hex` method." msgstr "" "Aby uzyskać napis szesnastkowej reprezentacj dla zmiennoprzecinkowej, należy " "użyć metody :meth:`float.hex`." @@ -1773,14 +1778,15 @@ msgstr "" "115" msgid "" -"If the argument defines :meth:`~object.__int__`, ``int(x)`` returns ``x." -"__int__()``. If the argument defines :meth:`~object.__index__`, it returns " -"``x.__index__()``. For floating-point numbers, this truncates towards zero." +"If the argument defines :meth:`~object.__int__`, ``int(x)`` returns " +"``x.__int__()``. If the argument defines :meth:`~object.__index__`, it " +"returns ``x.__index__()``. For floating-point numbers, this truncates " +"towards zero." msgstr "" -"Jeśli argument definiuje :meth:`~object.__int__`, ``int(x)`` zwraca ``x." -"__int__()``. Jeśli argument definiuje :meth:`~object.__index__`, to zwraca " -"``x.__index__()``. W przypadku liczb zmiennoprzecinkowych, są one przycinane " -"w kierunku zera." +"Jeśli argument definiuje :meth:`~object.__int__`, ``int(x)`` zwraca " +"``x.__int__()``. Jeśli argument definiuje :meth:`~object.__index__`, to " +"zwraca ``x.__index__()``. W przypadku liczb zmiennoprzecinkowych, są one " +"przycinane w kierunku zera." msgid "" "If the argument is not a number or if *base* is given, then it must be a " @@ -1824,16 +1830,16 @@ msgid "The integer type is described in :ref:`typesnumeric`." msgstr "Typ liczba całkowita (integer) został opisany w :ref:`typesnumeric`." msgid "" -"If *base* is not an instance of :class:`int` and the *base* object has a :" -"meth:`base.__index__ ` method, that method is called to " +"If *base* is not an instance of :class:`int` and the *base* object has " +"a :meth:`base.__index__ ` method, that method is called to " "obtain an integer for the base. Previous versions used :meth:`base.__int__ " "` instead of :meth:`base.__index__ `." msgstr "" -"Jeśli *base* nie jest instancją :class:`int` i obiekt *base* posiada metodę :" -"meth:`base.__index__ `, metoda ta jest wywoływana w celu " -"uzyskania liczba całkowitych dla bazy. Poprzednie wersje używały :meth:" -"`base.__int__ ` zamiast :meth:`base.__index__ `." +"Jeśli *base* nie jest instancją :class:`int` i obiekt *base* posiada " +"metodę :meth:`base.__index__ `, metoda ta jest wywoływana " +"w celu uzyskania liczba całkowitych dla bazy. Poprzednie wersje " +"używały :meth:`base.__int__ ` zamiast :meth:`base.__index__ " +"`." msgid "The first parameter is now positional-only." msgstr "Pierwszy parametr jest teraz tylko pozycyjny." @@ -1849,15 +1855,15 @@ msgid "" ":class:`int` string inputs and string representations can be limited to help " "avoid denial of service attacks. A :exc:`ValueError` is raised when the " "limit is exceeded while converting a string to an :class:`int` or when " -"converting an :class:`int` into a string would exceed the limit. See the :" -"ref:`integer string conversion length limitation ` " +"converting an :class:`int` into a string would exceed the limit. See " +"the :ref:`integer string conversion length limitation ` " "documentation." msgstr "" ":class:`int` napis wejścia i reprezentacje napisa mogą być ograniczone, aby " "pomóc uniknąć ataków typu \"odmowa usługi\". :exc:`ValueError` jest rzucone, " "gdy limit zostanie przekroczony podczas konwersji napisa na :class:`int` lub " -"gdy konwersja :class:`int` na napis przekroczy limit. Zobacz dokumentację :" -"ref:`liczba całkowita napis ograniczenia długości konwersji " +"gdy konwersja :class:`int` na napis przekroczy limit. Zobacz " +"dokumentację :ref:`liczba całkowita napis ograniczenia długości konwersji " "`." msgid "" @@ -1871,9 +1877,9 @@ msgid "" "the function always returns ``False``. If *classinfo* is a tuple of type " "objects (or recursively, other such tuples) or a :ref:`types-union` of " "multiple types, return ``True`` if *object* is an instance of any of the " -"types. If *classinfo* is not a type or tuple of types and such tuples, a :" -"exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised for " -"an invalid type if an earlier check succeeds." +"types. If *classinfo* is not a type or tuple of types and such tuples, " +"a :exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised " +"for an invalid type if an earlier check succeeds." msgstr "" "Zwraca ``True`` jeśli argument *object* jest instancją argumentu " "*classinfo*, lub jego (bezpośrednią, pośrednią lub :term:`wirtualną " @@ -1890,15 +1896,15 @@ msgid "*classinfo* can be a :ref:`types-union`." msgstr "*classinfo* może być :ref:`types-union`." msgid "" -"Return ``True`` if *class* is a subclass (direct, indirect, or :term:" -"`virtual `) of *classinfo*. A class is considered a " -"subclass of itself. *classinfo* may be a tuple of class objects (or " -"recursively, other such tuples) or a :ref:`types-union`, in which case " +"Return ``True`` if *class* is a subclass (direct, indirect, " +"or :term:`virtual `) of *classinfo*. A class is " +"considered a subclass of itself. *classinfo* may be a tuple of class objects " +"(or recursively, other such tuples) or a :ref:`types-union`, in which case " "return ``True`` if *class* is a subclass of any entry in *classinfo*. In " "any other case, a :exc:`TypeError` exception is raised." msgstr "" -"Zwraca ``True`` jeśli *class* jest podklasą (bezpośrednią, pośrednią lub :" -"term:`wirtualną `) *classinfo*. Klasa jest " +"Zwraca ``True`` jeśli *class* jest podklasą (bezpośrednią, pośrednią " +"lub :term:`wirtualną `) *classinfo*. Klasa jest " "uważana za podklasę samej siebie. *classinfo* może być krotką obiektów klasy " "(lub rekurencyjnie, innych takich krotek) lub :ref:`types-union`, w którym " "to przypadku zwraca ``True`` jeśli *class* jest podklasą dowolnego wpisu w " @@ -1909,14 +1915,15 @@ msgid "" "differently depending on the presence of the second argument. Without a " "second argument, the single argument must be a collection object which " "supports the :term:`iterable` protocol (the :meth:`~object.__iter__` " -"method), or it must support the sequence protocol (the :meth:`~object." -"__getitem__` method with integer arguments starting at ``0``). If it does " -"not support either of those protocols, :exc:`TypeError` is raised. If the " -"second argument, *sentinel*, is given, then the first argument must be a " -"callable object. The iterator created in this case will call *callable* " -"with no arguments for each call to its :meth:`~iterator.__next__` method; if " -"the value returned is equal to *sentinel*, :exc:`StopIteration` will be " -"raised, otherwise the value will be returned." +"method), or it must support the sequence protocol " +"(the :meth:`~object.__getitem__` method with integer arguments starting at " +"``0``). If it does not support either of those protocols, :exc:`TypeError` " +"is raised. If the second argument, *sentinel*, is given, then the first " +"argument must be a callable object. The iterator created in this case will " +"call *callable* with no arguments for each call to " +"its :meth:`~iterator.__next__` method; if the value returned is equal to " +"*sentinel*, :exc:`StopIteration` will be raised, otherwise the value will be " +"returned." msgstr "" "Zwraca obiekt :term:`iteratora `. Pierwszy argument jest " "interpretowany bardzo różnie w zależności od obecności drugiego argumentu. " @@ -1927,9 +1934,10 @@ msgstr "" "obsługuje żadnego z tych protokołów, zostanie rzucony :exc:`TypeError`. " "Jeśli podano drugi argument, *sentinel*, to pierwszy argument musi być " "obiektem wywoływalnym. Utworzony w tym przypadku iterator będzie wywoływał " -"*callable* bez argumentu dla każdego wywołania jego metody :meth:`~iterator." -"__next__`; jeśli zwrócona wartość jest równa *sentinel*, zostanie rzucone :" -"exc:`StopIteration`, w przeciwnym razie zostanie zwrócona wartość." +"*callable* bez argumentu dla każdego wywołania jego " +"metody :meth:`~iterator.__next__`; jeśli zwrócona wartość jest równa " +"*sentinel*, zostanie rzucone :exc:`StopIteration`, w przeciwnym razie " +"zostanie zwrócona wartość." msgid "See also :ref:`typeiter`." msgstr "Zobacz także :ref:`typeiter`." @@ -1964,19 +1972,19 @@ msgstr "" "(taką jak słownik, zbiór lub zbiór zamrożony)." msgid "" -"``len`` raises :exc:`OverflowError` on lengths larger than :data:`sys." -"maxsize`, such as :class:`range(2 ** 100) `." +"``len`` raises :exc:`OverflowError` on lengths larger " +"than :data:`sys.maxsize`, such as :class:`range(2 ** 100) `." msgstr "" -"``len`` rzuca :exc:`OverflowError` dla długości większych niż :data:`sys." -"maxsize`, takich jak :class:`range(2 ** 100) `." +"``len`` rzuca :exc:`OverflowError` dla długości większych " +"niż :data:`sys.maxsize`, takich jak :class:`range(2 ** 100) `." msgid "" "Rather than being a function, :class:`list` is actually a mutable sequence " "type, as documented in :ref:`typesseq-list` and :ref:`typesseq`." msgstr "" "Zamiast być funkcją, :class:`list` jest w rzeczywistości typem mutowalnej " -"(zmiennej) sekwencji, jak udokumentowano w :ref:`typesseq-list` i :ref:" -"`typesseq`." +"(zmiennej) sekwencji, jak udokumentowano w :ref:`typesseq-list` " +"i :ref:`typesseq`." msgid "" "Return a mapping object representing the current local symbol table, with " @@ -1989,12 +1997,12 @@ msgstr "" msgid "" "At module scope, as well as when using :func:`exec` or :func:`eval` with a " -"single namespace, this function returns the same namespace as :func:" -"`globals`." +"single namespace, this function returns the same namespace " +"as :func:`globals`." msgstr "" -"W zakresie moduł, a także podczas korzystania z :func:`exec` lub :func:" -"`eval` z pojedynczą przestrzenią nazw, ta funkcja zwraca ta sama przestrzeń " -"nazw co :func:`globals`." +"W zakresie moduł, a także podczas korzystania z :func:`exec` " +"lub :func:`eval` z pojedynczą przestrzenią nazw, ta funkcja zwraca ta sama " +"przestrzeń nazw co :func:`globals`." msgid "" "At class scope, it returns the namespace that will be passed to the " @@ -2074,10 +2082,10 @@ msgstr "" msgid "" "As part of :pep:`667`, the semantics of mutating the mapping objects " -"returned from this function are now defined. The behavior in :term:" -"`optimized scopes ` is now as described above. Aside from " -"being defined, the behaviour in other scopes remains unchanged from previous " -"versions." +"returned from this function are now defined. The behavior " +"in :term:`optimized scopes ` is now as described above. " +"Aside from being defined, the behaviour in other scopes remains unchanged " +"from previous versions." msgstr "" "Jako część :pep:`667`, semantyka mutowania obiektów mapowania zwróconych z " "tej funkcji jest teraz zdefiniowana. Zachowanie w :term:`zoptymalizowanych " @@ -2090,20 +2098,11 @@ msgid "" "yielding the results. If additional *iterables* arguments are passed, " "*function* must take that many arguments and is applied to the items from " "all iterables in parallel. With multiple iterables, the iterator stops when " -"the shortest iterable is exhausted. If *strict* is ``True`` and one of the " -"iterables is exhausted before the others, a :exc:`ValueError` is raised. For " -"cases where the function inputs are already arranged into argument tuples, " -"see :func:`itertools.starmap`." -msgstr "" -"Zwraca iterator, który stosuje funkcję *function* do każdego elementu " -"*iterable*, dając wyniki. Jeśli przekazane zostaną dodatkowe argumenty " -"*iterables*, *funkcja* musi przyjmować taką liczbę argumentów i jest " -"stosowana do elementów ze wszystkich iterabli równolegle. W przypadku wielu " -"iterables, iterator zatrzymuje się, gdy najkrótszy iterable zostanie " -"wyczerpany. Jeśli *strict* jest ``True`` i jeden z iterabli wyczerpie się " -"przed innymi, rzucany jest :exc:`ValueError`. Dla przypadków, w których " -"wejścia funkcji są już ułożone w krotki argumentów, zobacz :func:`itertools." -"starmap`." +"the shortest iterable is :term:`exhausted`. If *strict* is ``True`` and one " +"of the iterables is exhausted before the others, a :exc:`ValueError` is " +"raised. For cases where the function inputs are already arranged into " +"argument tuples, see :func:`itertools.starmap`." +msgstr "" msgid "Added the *strict* parameter." msgstr "Dodano parametr *strict*." @@ -2128,8 +2127,8 @@ msgid "" "There are two optional keyword-only arguments. The *key* argument specifies " "a one-argument ordering function like that used for :meth:`list.sort`. The " "*default* argument specifies an object to return if the provided iterable is " -"empty. If the iterable is empty and *default* is not provided, a :exc:" -"`ValueError` is raised." +"empty. If the iterable is empty and *default* is not provided, " +"a :exc:`ValueError` is raised." msgstr "" "Istnieją dwa opcjonalne tylko ze słowem kluczowym argument. *Kluczowy* " "argument określa jedno-argumentowy uporządkowanie funkcji jak to używane " @@ -2140,8 +2139,8 @@ msgstr "" msgid "" "If multiple items are maximal, the function returns the first one " "encountered. This is consistent with other sort-stability preserving tools " -"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and ``heapq." -"nlargest(1, iterable, key=keyfunc)``." +"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and " +"``heapq.nlargest(1, iterable, key=keyfunc)``." msgstr "" "Jeśli wiele elementów jest maksymalnych, funkcja zwraca pierwszy napotkany " "element. Jest to zgodne z innymi narzędziami zachowującymi stabilność " @@ -2155,8 +2154,8 @@ msgid "The *key* can be ``None``." msgstr "*Kluczem* może być ``None``." msgid "" -"Return a \"memory view\" object created from the given argument. See :ref:" -"`typememoryview` for more information." +"Return a \"memory view\" object created from the given argument. " +"See :ref:`typememoryview` for more information." msgstr "" "Zwraca obiekt \"memory view\" utworzony z podanego argumentu. Więcej " "informacji można znaleźć na stronie :ref:`typememoryview`." @@ -2189,14 +2188,11 @@ msgstr "" "iterable, key=keyfunc)``." msgid "" -"Retrieve the next item from the :term:`iterator` by calling its :meth:" -"`~iterator.__next__` method. If *default* is given, it is returned if the " -"iterator is exhausted, otherwise :exc:`StopIteration` is raised." +"Retrieve the next item from the :term:`iterator` by calling " +"its :meth:`~iterator.__next__` method. If *default* is given, it is " +"returned if the iterator is :term:`exhausted`, " +"otherwise :exc:`StopIteration` is raised." msgstr "" -"Pobiera następny element z :term:`iterator` poprzez wywołanie jego metody :" -"meth:`~iterator.__next__`. Jeśli *domyślny* jest podany, jest zwracany, " -"jeśli iterator jest wyczerpany, w przeciwnym razie :exc:`StopIteration` jest " -"rzucony." msgid "" "This is the ultimate base class of all other classes. It has methods that " @@ -2218,9 +2214,9 @@ msgstr "" msgid "" "Convert an integer number to an octal string prefixed with \"0o\". The " -"result is a valid Python expression. If *integer* is not a Python :class:" -"`int` object, it has to define an :meth:`~object.__index__` method that " -"returns an integer. For example:" +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. For example:" msgstr "" "Konwertuje liczbę całkowitą na ósemkowy ciąg znaków z prefiksem \"0o\". " "Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " @@ -2264,10 +2260,10 @@ msgid "" "already exists), ``'x'`` for exclusive creation, and ``'a'`` for appending " "(which on *some* Unix systems, means that *all* writes append to the end of " "the file regardless of the current seek position). In text mode, if " -"*encoding* is not specified the encoding used is platform-dependent: :func:" -"`locale.getencoding` is called to get the current locale encoding. (For " -"reading and writing raw bytes use binary mode and leave *encoding* " -"unspecified.) The available modes are:" +"*encoding* is not specified the encoding used is platform-" +"dependent: :func:`locale.getencoding` is called to get the current locale " +"encoding. (For reading and writing raw bytes use binary mode and leave " +"*encoding* unspecified.) The available modes are:" msgstr "" "*mode* to opcjonalny napis , który określa tryb, w którym plik jest " "otwierany. Domyślnie jest to ``'r'``, co oznacza otwarcie do odczytu w " @@ -2384,9 +2380,9 @@ msgstr "" "ten sposób dotyczy binarnie buforowanego wejścia/wyjścia, ale " "``TextIOWrapper`` (tj. pliki otwierane za pomocą ``mode='r+'``) będą miały " "inne buforowanie. Aby wyłączyć buforowanie w ``TextIOWrapper``, należy " -"rozważyć użycie flagi ``write_through`` dla :func:`io.TextIOWrapper." -"reconfigure`. Gdy nie podano *buforowania* argument, polityka buforowania " -"domyślny działa w następujący sposób:" +"rozważyć użycie flagi ``write_through`` " +"dla :func:`io.TextIOWrapper.reconfigure`. Gdy nie podano *buforowania* " +"argument, polityka buforowania domyślny działa w następujący sposób:" msgid "" "Binary files are buffered in fixed-size chunks; the size of the buffer is " @@ -2404,9 +2400,10 @@ msgid "" "returns ``True``) use line buffering. Other text files use the policy " "described above for binary files." msgstr "" -"\"Interaktywne\" pliki tekstowe (pliki, dla których :meth:`~io.IOBase." -"isatty` zwraca ``True`` ) używają buforowania linii. Inne pliki tekstowe " -"używają zasad opisanych powyżej dla plików binarnych." +"\"Interaktywne\" pliki tekstowe (pliki, dla " +"których :meth:`~io.IOBase.isatty` zwraca ``True`` ) używają buforowania " +"linii. Inne pliki tekstowe używają zasad opisanych powyżej dla plików " +"binarnych." msgid "" "*encoding* is the name of the encoding used to decode or encode the file. " @@ -2425,14 +2422,16 @@ msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled—this cannot be used in binary mode. A variety of " "standard error handlers are available (listed under :ref:`error-handlers`), " -"though any error handling name that has been registered with :func:`codecs." -"register_error` is also valid. The standard names include:" +"though any error handling name that has been registered " +"with :func:`codecs.register_error` is also valid. The standard names " +"include:" msgstr "" "*errors* to opcjonalny napis, który określa sposób obsługi błędów kodowania " "i dekodowania - nie może być używany w trybie binarnym. Dostępnych jest " "wiele standardowych programów obsługi błędów (wymienionych w :ref:`error-" -"handlers`), choć każda nazwa obsługi błędów zarejestrowana w :func:`codecs." -"register_error` jest również ważna. Standardowe nazwy obejmują:" +"handlers`), choć każda nazwa obsługi błędów zarejestrowana " +"w :func:`codecs.register_error` jest również ważna. Standardowe nazwy " +"obejmują:" msgid "" "``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " @@ -2521,10 +2520,10 @@ msgstr "" msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " -"characters written are translated to the system default line separator, :" -"data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no translation " -"takes place. If *newline* is any of the other legal values, any ``'\\n'`` " -"characters written are translated to the given string." +"characters written are translated to the system default line " +"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no " +"translation takes place. If *newline* is any of the other legal values, any " +"``'\\n'`` characters written are translated to the given string." msgstr "" "Podczas zapisywania danych wyjściowych do strumienia, jeśli *newline* ma " "wartość ``None``, wszelkie zapisane ``'\\n'`` znaki są tłumaczone na " @@ -2561,8 +2560,8 @@ msgid "The newly created file is :ref:`non-inheritable `." msgstr "Nowo utworzony plik jest :ref:`non-inheritable `." msgid "" -"The following example uses the :ref:`dir_fd ` parameter of the :func:" -"`os.open` function to open a file relative to a given directory::" +"The following example uses the :ref:`dir_fd ` parameter of " +"the :func:`os.open` function to open a file relative to a given directory::" msgstr "" "Poniższy przykład używa :ref:`dir_fd ` parametr z :func:`os.open` " "funkcji do otwarcia pliku względem danego katalogu::" @@ -2591,37 +2590,38 @@ msgstr "" msgid "" "The type of :term:`file object` returned by the :func:`open` function " "depends on the mode. When :func:`open` is used to open a file in a text " -"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass of :" -"class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When used " -"to open a file in a binary mode with buffering, the returned class is a " +"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass " +"of :class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When " +"used to open a file in a binary mode with buffering, the returned class is a " "subclass of :class:`io.BufferedIOBase`. The exact class varies: in read " "binary mode, it returns an :class:`io.BufferedReader`; in write binary and " "append binary modes, it returns an :class:`io.BufferedWriter`, and in read/" "write mode, it returns an :class:`io.BufferedRandom`. When buffering is " -"disabled, the raw stream, a subclass of :class:`io.RawIOBase`, :class:`io." -"FileIO`, is returned." -msgstr "" -"Typ :term:`file object` zwracany przez :func:`open` zależy od trybu. Gdy :" -"func:`open` jest używany do otwarcia pliku w trybie tekstowym (``'w'``, " -"``'r'``, ``'wt'``, ``'rt'``, itd.), to zwracana jest podklasa klasy :class:" -"`io.TextIOBase` (w szczególności :class:`io.TextIOWrapper`). W przypadku " -"użycia do otwarcia pliku w trybie binarnym z buforowaniem, zwracana klasą " -"jest podklasa z :class:`io.BufferedIOBase`. Dokładna klasa różni się: w " -"trybie odczytu binarnego, jest to zwracane z :class:`io.BufferedReader`; w " -"trybach zapisu binarnego i dołączania binarnego, jest to zwracane z :class:" -"`io.BufferedWriter`, a w trybie odczytu/zapisu, jest to zwracane z :class:" -"`io.BufferedRandom`. Gdy buforowanie jest wyłączone, zwracany jest " -"nieprzetworzony strumień, podklasa z :class:`io.RawIOBase`, :class:`io." -"FileIO`." +"disabled, the raw stream, a subclass " +"of :class:`io.RawIOBase`, :class:`io.FileIO`, is returned." +msgstr "" +"Typ :term:`file object` zwracany przez :func:`open` zależy od trybu. " +"Gdy :func:`open` jest używany do otwarcia pliku w trybie tekstowym (``'w'``, " +"``'r'``, ``'wt'``, ``'rt'``, itd.), to zwracana jest podklasa " +"klasy :class:`io.TextIOBase` (w szczególności :class:`io.TextIOWrapper`). W " +"przypadku użycia do otwarcia pliku w trybie binarnym z buforowaniem, " +"zwracana klasą jest podklasa z :class:`io.BufferedIOBase`. Dokładna klasa " +"różni się: w trybie odczytu binarnego, jest to zwracane " +"z :class:`io.BufferedReader`; w trybach zapisu binarnego i dołączania " +"binarnego, jest to zwracane z :class:`io.BufferedWriter`, a w trybie odczytu/" +"zapisu, jest to zwracane z :class:`io.BufferedRandom`. Gdy buforowanie jest " +"wyłączone, zwracany jest nieprzetworzony strumień, podklasa " +"z :class:`io.RawIOBase`, :class:`io.FileIO`." msgid "" "See also the file handling modules, such as :mod:`fileinput`, :mod:`io` " -"(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:" -"`tempfile`, and :mod:`shutil`." +"(where :func:`open` is " +"declared), :mod:`os`, :mod:`os.path`, :mod:`tempfile`, and :mod:`shutil`." msgstr "" "Zobacz także moduły obsługę plików, takich jak :mod:`fileinput`, :mod:`io` " -"(gdzie zadeklarowano :func:`open` ), :mod:`os`, :mod:`os.path`, :mod:" -"`tempfile` i :mod:`shutil`." +"(gdzie " +"zadeklarowano :func:`open` ), :mod:`os`, :mod:`os.path`, :mod:`tempfile` " +"i :mod:`shutil`." msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " @@ -2658,8 +2658,8 @@ msgstr "Plik nie jest teraz dziedziczony." msgid "" "If the system call is interrupted and the signal handler does not raise an " -"exception, the function now retries the system call instead of raising an :" -"exc:`InterruptedError` exception (see :pep:`475` for the rationale)." +"exception, the function now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" "Jeśli wywołanie systemowe zostanie przerwane, a program obsługi sygnału nie " "rzuci wyjątku, funkcji ponawia teraz wywołanie systemowe zamiast rzucenja " @@ -2673,11 +2673,11 @@ msgstr "" "Dodano obsługę akceptowania obiektów implementujących :class:`os.PathLike`." msgid "" -"On Windows, opening a console buffer may return a subclass of :class:`io." -"RawIOBase` other than :class:`io.FileIO`." +"On Windows, opening a console buffer may return a subclass " +"of :class:`io.RawIOBase` other than :class:`io.FileIO`." msgstr "" -"W systemie Windows, otwarcie bufora konsoli może zwracać podklasa z :class:" -"`io.RawIOBase` innego niż :class:`io.FileIO`." +"W systemie Windows, otwarcie bufora konsoli może zwracać podklasa " +"z :class:`io.RawIOBase` innego niż :class:`io.FileIO`." msgid "The ``'U'`` mode has been removed." msgstr "Tryb ``'U'`` został usunięty." @@ -2688,8 +2688,8 @@ msgstr "Zwraca wartość porządkową znaku." msgid "" "If the argument is a one-character string, return the Unicode code point of " "that character. For example, ``ord('a')`` returns the integer ``97`` and " -"``ord('€')`` (Euro sign) returns ``8364``. This is the inverse of :func:" -"`chr`." +"``ord('€')`` (Euro sign) returns ``8364``. This is the inverse " +"of :func:`chr`." msgstr "" "Jeśli argument jest jedno-znakowym ciągiem znaków, zwraca punkt kodowy " "Unicode tego znaku. Na przykład, ``ord('a')`` zwraca liczbę całkowitą ``97`` " @@ -2724,9 +2724,9 @@ msgid "" "2)`` returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative " "base of type :class:`int` or :class:`float` and a non-integral exponent, a " "complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value " -"close to ``3j``. Whereas, for a negative base of type :class:`int` or :class:" -"`float` with an integral exponent, a float result is delivered. For example, " -"``pow(-9, 2.0)`` returns ``81.0``." +"close to ``3j``. Whereas, for a negative base of type :class:`int` " +"or :class:`float` with an integral exponent, a float result is delivered. " +"For example, ``pow(-9, 2.0)`` returns ``81.0``." msgstr "" "Gdy argumenty są wbudowanymi typami numerycznymi z mieszanymi typami " "operandów, obowiązują zasady koercji dla binarnych operatorów " @@ -2734,12 +2734,12 @@ msgstr "" "(po koercji), chyba że drugi argument jest ujemny; w takim przypadku " "wszystkie argument są konwertowane na float i dostarczany jest wynik float. " "Na przykład, ``pow(10, 2)`` zwracać ``100`` , ale ``pow(10, -2)`` zwracać " -"``0.01`` . W przypadku ujemnej podstawy typu :class:`int` lub :class:" -"`float` i wykładnika niecałkowitego wynikiem jest liczba zespolona. Na " -"przykład, ``pow(-9, 0.5)`` zwraca wartość zbliżoną do ``3j``. Natomiast dla " -"ujemnej podstawy typu :class:`int` lub :class:`float` z wykładnikiem " -"całkowitym, dostarczany jest wynik zmiennoprzecinkowy. Na przykład ``pow(-9, " -"2.0)`` zwraca ``81.0`` ." +"``0.01`` . W przypadku ujemnej podstawy typu :class:`int` " +"lub :class:`float` i wykładnika niecałkowitego wynikiem jest liczba " +"zespolona. Na przykład, ``pow(-9, 0.5)`` zwraca wartość zbliżoną do ``3j``. " +"Natomiast dla ujemnej podstawy typu :class:`int` lub :class:`float` z " +"wykładnikiem całkowitym, dostarczany jest wynik zmiennoprzecinkowy. Na " +"przykład ``pow(-9, 2.0)`` zwraca ``81.0`` ." msgid "" "For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must " @@ -2813,8 +2813,8 @@ msgstr "" "*Plik* argument musi być obiektem z metodą ``write(string)``; jeśli nie jest " "obecny lub ``None``, zostanie użyty :data:`sys.stdout`. Ponieważ drukowane " "argument są konwertowane na tekst napis, :func:`print` nie może być używany " -"z obiektami plików w trybie binarnym. Zamiast tego należy uży ``file." -"write(...)``." +"z obiektami plików w trybie binarnym. Zamiast tego należy uży " +"``file.write(...)``." msgid "" "Output buffering is usually determined by *file*. However, if *flush* is " @@ -2883,13 +2883,13 @@ msgstr "" msgid "" "If given, *doc* will be the docstring of the property attribute. Otherwise, " "the property will copy *fget*'s docstring (if it exists). This makes it " -"possible to create read-only properties easily using :func:`property` as a :" -"term:`decorator`::" +"possible to create read-only properties easily using :deco:`property` as " +"a :term:`decorator`::" msgstr "" -"Jeśli zostanie podana, *doc* będzie docstringiem właściwości atrybut. W " -"przeciwnym razie właściwość skopiuje docstring *fget* (jeśli istnieje). " -"Umożliwia to łatwe tworzenie właściwości tylko do odczytu przy użyciu :func:" -"`property` jako :term:`dekorator`::" +"Jeśli zostanie podana, *doc* będzie docstringiem atrybutu właściwości. W " +"przeciwnym razie właściwość skopiuje docstring *fget* (jeśli istnieje). " +"Umożliwia to łatwe tworzenie właściwości tylko do odczytu przy " +"użyciu :deco:`property` jako :term:`dekoratora `::" msgid "" "class Parrot:\n" @@ -3016,8 +3016,8 @@ msgstr "" "zawierają nazwę typu obiektu wraz z dodatkowymi informacjami, często " "zawierającymi nazwę i adres obiektu. Klasa może kontrolować co funkcja " "zwraca dla swoich instancji, definiując metodę :meth:`~object.__repr__`. " -"Jeśli :func:`sys.displayhook` nie jest dostępna, ta funkcja będzie rzucona :" -"exc:`RuntimeError` ." +"Jeśli :func:`sys.displayhook` nie jest dostępna, ta funkcja będzie " +"rzucona :exc:`RuntimeError` ." msgid "This class has a custom representation that can be evaluated::" msgstr "Ta klasa ma niestandardową reprezentację, którą można ocenić::" @@ -3078,11 +3078,11 @@ msgstr "" "``None``. W przeciwnym razie zwracana wartość ma ten sam typ co *number*." msgid "" -"For a general Python object ``number``, ``round`` delegates to ``number." -"__round__``." +"For a general Python object ``number``, ``round`` delegates to " +"``number.__round__``." msgstr "" -"Dla ogólnego obiektu Python ``number`` , ``round`` deleguje do ``number." -"__round__``." +"Dla ogólnego obiektu Python ``number`` , ``round`` deleguje do " +"``number.__round__``." msgid "" "The behavior of :func:`round` for floats can be surprising: for example, " @@ -3099,21 +3099,21 @@ msgstr "" msgid "" "Return a new :class:`set` object, optionally with elements taken from " -"*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-" -"set` for documentation about this class." +"*iterable*. :class:`set` is a built-in class. See also :ref:`types-set` " +"for documentation about this class." msgstr "" -"Zwraca nowy obiekt :class:`set`, opcjonalnie z elementami pobranymi z " -"*iterable*. ``set`` jest klasą wbudowana. Dokumentacja dotycząca tej klasy " -"znajduje się na stronach :class:`set` i :ref:`types-set`." +"Zwraca nowy obiekt :class:`set`, opcjonalnie z elementami z " +"*iterable*. :class:`set` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." msgid "" -"For other containers see the built-in :class:`frozenset`, :class:`list`, :" -"class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " -"module." +"For other containers see the built-" +"in :class:`frozenset`, :class:`list`, :class:`tuple`, and :class:`dict` " +"classes, as well as the :mod:`collections` module." msgstr "" -"Dla innych kontenerów zobacz klasy wbudowane :class:`frozenset` , :class:" -"`list`, :class:`tuple` i :class:`dict`, jak również :mod:`collections` " -"moduł ." +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`frozenset` , :class:`list`, :class:`tuple` " +"i :class:`dict`, jak również :mod:`collections` moduł ." msgid "" "This is the counterpart of :func:`getattr`. The arguments are an object, a " @@ -3129,17 +3129,17 @@ msgstr "" msgid "" "*name* need not be a Python identifier as defined in :ref:`identifiers` " -"unless the object chooses to enforce that, for example in a custom :meth:" -"`~object.__getattribute__` or via :attr:`~object.__slots__`. An attribute " -"whose name is not an identifier will not be accessible using the dot " -"notation, but is accessible through :func:`getattr` etc.." +"unless the object chooses to enforce that, for example in a " +"custom :meth:`~object.__getattribute__` or via :attr:`~object.__slots__`. An " +"attribute whose name is not an identifier will not be accessible using the " +"dot notation, but is accessible through :func:`getattr` etc.." msgstr "" -"*name* nie musi być identyfikatorem Pythona zdefiniowanym w :ref:" -"`identifiers`, chyba że obiekt zdecyduje się to wymusić, na przykład w " -"niestandardowym :meth:`~object.__getattribute__` lub poprzez :attr:`~object." -"__slots__`. Obiekt atrybut, którego nazwa nie jest identyfikatorem, nie " -"będzie dostępny przy użyciu notacji kropkowej, ale będzie dostępny za " -"pośrednictwem :func:`getattr` itd." +"*name* nie musi być identyfikatorem Pythona zdefiniowanym " +"w :ref:`identifiers`, chyba że obiekt zdecyduje się to wymusić, na przykład " +"w niestandardowym :meth:`~object.__getattribute__` lub " +"poprzez :attr:`~object.__slots__`. Obiekt atrybut, którego nazwa nie jest " +"identyfikatorem, nie będzie dostępny przy użyciu notacji kropkowej, ale " +"będzie dostępny za pośrednictwem :func:`getattr` itd." msgid "" "Since :ref:`private name mangling ` happens at " @@ -3164,15 +3164,15 @@ msgid "" "used. For example: ``a[start:stop:step]`` or ``a[start:stop, i]``." msgstr "" "Obiekty slice są również generowane, gdy używana jest :ref:`składnia " -"slicingu `. Na przykład: ``a[start:stop:step]`` lub ``a[start:" -"stop, i]``." +"slicingu `. Na przykład: ``a[start:stop:step]`` lub " +"``a[start:stop, i]``." msgid "" -"See :func:`itertools.islice` for an alternate version that returns an :term:" -"`iterator`." +"See :func:`itertools.islice` for an alternate version that returns " +"an :term:`iterator`." msgstr "" -"Zobacz :func:`itertools.islice` dla alternatywnej wersji, która zwraca :term:" -"`iterator`." +"Zobacz :func:`itertools.islice` dla alternatywnej wersji, która " +"zwraca :term:`iterator`." msgid "" "These read-only attributes are set to the argument values (or their " @@ -3184,11 +3184,13 @@ msgstr "" "jednak używane przez NumPy i inne zewnętrzne pakiety." msgid "" -"Slice objects are now :term:`hashable` (provided :attr:`~slice.start`, :attr:" -"`~slice.stop`, and :attr:`~slice.step` are hashable)." +"Slice objects are now :term:`hashable` " +"(provided :attr:`~slice.start`, :attr:`~slice.stop`, and :attr:`~slice.step` " +"are hashable)." msgstr "" -"Obiekty Slice są teraz :term:`hashable` (pod warunkiem, że :attr:`~slice." -"start`, :attr:`~slice.stop` i :attr:`~slice.step` są hashable)." +"Obiekty Slice są teraz :term:`hashable` (pod warunkiem, " +"że :attr:`~slice.start`, :attr:`~slice.stop` i :attr:`~slice.step` są " +"hashable)." msgid "Return a new sorted list from the items in *iterable*." msgstr "Zwraca nową posortowaną listę z elementów w *iterable*." @@ -3201,12 +3203,14 @@ msgstr "" msgid "" "*key* specifies a function of one argument that is used to extract a " -"comparison key from each element in *iterable* (for example, ``key=str." -"lower``). The default value is ``None`` (compare the elements directly)." +"comparison key from each element in *iterable* (for example, " +"``key=str.lower``). The default value is ``None`` (compare the elements " +"directly)." msgstr "" "*key* określa funkcje jednego argumentu, który jest używany do wyodrębnienia " -"klucza porównania z każdego elementu w *iterable* (na przykład ``key=str." -"lower``). Wartość domyślna to ``None`` (bezpośrednie porównanie elementów)." +"klucza porównania z każdego elementu w *iterable* (na przykład " +"``key=str.lower``). Wartość domyślna to ``None`` (bezpośrednie porównanie " +"elementów)." msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " @@ -3245,19 +3249,20 @@ msgid "" "method." msgstr "" "Algorytm sortowania używa tylko porównań ``<`` między elementami. Podczas " -"gdy zdefiniowanie metoda :meth:`~object.__lt__` wystarczy do sortowania, :" -"PEP:`8` zaleca zaimplementowanie wszystkich sześciu :ref:`bogatych porównań " -"`. Pomoże to uniknąć błędów podczas korzystania z tych samych " -"danych z innymi narzędziami porządkującymi, takimi jak :func:`max`, które " -"opierają się na innej metodzie bazowej. Zaimplementowanie wszystkich sześciu " -"porównań pomaga również uniknąć nieporozumień w przypadku porównań typów " -"mieszanych, które mogą wywoływać metodę :meth:`~object.__gt__`." +"gdy zdefiniowanie metoda :meth:`~object.__lt__` wystarczy do " +"sortowania, :PEP:`8` zaleca zaimplementowanie wszystkich " +"sześciu :ref:`bogatych porównań `. Pomoże to uniknąć błędów " +"podczas korzystania z tych samych danych z innymi narzędziami " +"porządkującymi, takimi jak :func:`max`, które opierają się na innej metodzie " +"bazowej. Zaimplementowanie wszystkich sześciu porównań pomaga również " +"uniknąć nieporozumień w przypadku porównań typów mieszanych, które mogą " +"wywoływać metodę :meth:`~object.__gt__`." msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -"Przykłady sortowania i krótki samouczek sortowania można znaleźć na stronie :" -"ref:`sortinghowto`." +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." msgid "Transform a method into a static method." msgstr "Przekształcenie metody w metodę statyczną." @@ -3279,17 +3284,17 @@ msgstr "" " def f(arg1, arg2, argN): ..." msgid "" -"The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:" -"`function` for details." +"The ``@staticmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." msgstr "" -"Forma ``@staticmethod`` to :term:`dekorator` funkcji -- zobacz :ref:" -"`function` po szczegóły." +"Forma ``@staticmethod`` to :term:`dekorator` funkcji -- " +"zobacz :ref:`function` po szczegóły." msgid "" "A static method can be called either on the class (such as ``C.f()``) or on " -"an instance (such as ``C().f()``). Moreover, the static method :term:" -"`descriptor` is also callable, so it can be used in the class definition " -"(such as ``f()``)." +"an instance (such as ``C().f()``). Moreover, the static " +"method :term:`descriptor` is also callable, so it can be used in the class " +"definition (such as ``f()``)." msgstr "" "Metoda statyczna może być wywołana na klasie (np. ``C.f()``) lub na " "instancji (np. ``C().f()``). Co więcej, metoda statyczna :term:`descriptor` " @@ -3298,12 +3303,12 @@ msgstr "" msgid "" "Static methods in Python are similar to those found in Java or C++. Also, " -"see :func:`classmethod` for a variant that is useful for creating alternate " +"see :deco:`classmethod` for a variant that is useful for creating alternate " "class constructors." msgstr "" -"Metody statyczne w Python są podobne do tych, które można znaleźć w Java lub " -"C++. Zobacz także :func:`classmethod`, aby zapoznać się z wariantem, który " -"jest przydatny do tworzenia alternatywnych konstruktorów klas." +"Metody statyczne w Pythonie są podobne do tych, które można znaleźć w Java " +"lub C++. Zobacz także :deco:`classmethod`, aby zapoznać się z wariantem, " +"który jest przydatny do tworzenia alternatywnych konstruktorów klas." msgid "" "Like all decorators, it is also possible to call ``staticmethod`` as a " @@ -3333,19 +3338,19 @@ msgstr "" msgid "For more information on static methods, see :ref:`types`." msgstr "" -"Więcej informacji na temat metod statycznych można znaleźć na stronie :ref:" -"`types`." +"Więcej informacji na temat metod statycznych można znaleźć na " +"stronie :ref:`types`." msgid "" -"Static methods now inherit the method attributes (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` and :attr:`~function.__annotations__`), have a new " -"``__wrapped__`` attribute, and are now callable as regular functions." +"Static methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`), have a new ``__wrapped__`` " +"attribute, and are now callable as regular functions." msgstr "" -"Metody statyczne dziedziczą teraz metodę atrybut (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` i :attr:`~function.__annotations__`), mają nową " -"``__wrapped__`` atrybut i są teraz wywoływane jako zwykła funkcja." +"Metody statyczne dziedziczą teraz metodę atrybut " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`), mają nową ``__wrapped__`` atrybut i są " +"teraz wywoływane jako zwykła funkcja." msgid "" "Return a :class:`str` version of *object*. See :func:`str` for details." @@ -3371,10 +3376,10 @@ msgstr "" msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " -"preferred, fast way to concatenate a sequence of strings is by calling ``''." -"join(sequence)``. To add floating-point values with extended precision, " -"see :func:`math.fsum`\\. To concatenate a series of iterables, consider " -"using :func:`itertools.chain`." +"preferred, fast way to concatenate a sequence of strings is by calling " +"``''.join(sequence)``. To add floating-point values with extended " +"precision, see :func:`math.fsum`\\. To concatenate a series of iterables, " +"consider using :func:`itertools.chain`." msgstr "" "W niektórych przypadkach istnieją dobra alternatywa dla :func:`sum`. " "Preferowanym, szybkim sposobem na łączyć sekwencji napisów jest wywołanie " @@ -3416,8 +3421,8 @@ msgstr "" "Wyszukiwanie rozpoczyna się od klasy zaraz po *type*." msgid "" -"For example, if :attr:`~type.__mro__` of *object_or_type* is ``D -> B -> C -" -"> A -> object`` and the value of *type* is ``B``, then :func:`super` " +"For example, if :attr:`~type.__mro__` of *object_or_type* is ``D -> B -> C " +"-> A -> object`` and the value of *type* is ``B``, then :func:`super` " "searches ``C -> A -> object``." msgstr "" "Na przykład, jeśli :attr:`~type.__mro__` z *object_or_type* jest ``D -> B -> " @@ -3426,14 +3431,14 @@ msgstr "" msgid "" "The :attr:`~type.__mro__` attribute of the class corresponding to " -"*object_or_type* lists the method resolution search order used by both :func:" -"`getattr` and :func:`super`. The attribute is dynamic and can change " -"whenever the inheritance hierarchy is updated." +"*object_or_type* lists the method resolution search order used by " +"both :func:`getattr` and :func:`super`. The attribute is dynamic and can " +"change whenever the inheritance hierarchy is updated." msgstr "" ":attr:`~type.__mro__` atrybut klasy odpowiadającej *object_or_type* wymienia " -"kolejność wyszukiwania metod używaną zarówno przez :func:`getattr` jak i :" -"func:`super`. Adres atrybut jest dynamiczny i może ulec zmianie przy każdej " -"aktualizacji hierarchii dziedziczenia." +"kolejność wyszukiwania metod używaną zarówno przez :func:`getattr` jak " +"i :func:`super`. Adres atrybut jest dynamiczny i może ulec zmianie przy " +"każdej aktualizacji hierarchii dziedziczenia." msgid "" "If the second argument is omitted, the super object returned is unbound. If " @@ -3516,8 +3521,9 @@ msgid "" "` in a parent or sibling class." msgstr "" "Oprócz wyszukiwania metod, :func:`super` działa również dla wyszukiwania " -"atrybut. Jednym z możliwych przypadków użycia jest wywołanie :term:" -"`descriptors ` w klasie nadrzędnej lub podrzędnej." +"atrybut. Jednym z możliwych przypadków użycia jest " +"wywołanie :term:`descriptors ` w klasie nadrzędnej lub " +"podrzędnej." msgid "" "Note that :func:`super` is implemented as part of the binding process for " @@ -3552,20 +3558,20 @@ msgstr "" "dostęp do bieżącej instancji dla zwykłych metod." msgid "" -"For practical suggestions on how to design cooperative classes using :func:" -"`super`, see `guide to using super() `_." +"For practical suggestions on how to design cooperative classes " +"using :func:`super`, see `guide to using super() `_." msgstr "" "Praktyczne sugestie dotyczące projektowania klas współpracujących przy " "użyciu :func:`super` można znaleźć w `poradniku korzystania z super() " "`_." msgid "" -":class:`super` objects are now :mod:`pickleable ` and :mod:" -"`copyable `." +":class:`super` objects are now :mod:`pickleable ` " +"and :mod:`copyable `." msgstr "" -"Obiekty :class:`super` współpracują teraz z modułami :mod:`pickle` i :mod:" -"`copy`." +"Obiekty :class:`super` współpracują teraz z modułami :mod:`pickle` " +"i :mod:`copy`." msgid "" "Rather than being a function, :class:`tuple` is actually an immutable " @@ -3576,8 +3582,8 @@ msgstr "" msgid "" "With one argument, return the type of an *object*. The return value is a " -"type object and generally the same object as returned by :attr:`object." -"__class__`." +"type object and generally the same object as returned " +"by :attr:`object.__class__`." msgstr "" "Z jednym argumentem, zwraca typ *obiektu*. Typ zwracanej wartość jest " "obiektem typu i generalnie jest to ten sam obiekt, który został zwrócony " @@ -3597,9 +3603,9 @@ msgid "" "tuple contains the base classes and becomes the :attr:`~type.__bases__` " "attribute; if empty, :class:`object`, the ultimate base of all classes, is " "added. The *dict* dictionary contains attribute and method definitions for " -"the class body; it may be copied or wrapped before becoming the :attr:`~type." -"__dict__` attribute. The following two statements create identical :class:`!" -"type` objects:" +"the class body; it may be copied or wrapped before becoming " +"the :attr:`~type.__dict__` attribute. The following two statements create " +"identical :class:`!type` objects:" msgstr "" "Z trzema argumentamy, zwracać nowy typ obiektu. Jest to zasadniczo " "dynamiczna forma :keyword:`class` instrukcja . *name* napis jest nazwą klasy " @@ -3629,9 +3635,20 @@ msgid "" "would." msgstr "" "Argument nazwane dostarczone do trzech formularzy argumenty są przekazywane " -"do odpowiedniego mechanizmu metaklas (zwykle :meth:`~object." -"__init_subclass__`) w taki sam sposób, jak słowa kluczowe w definicja klasy " -"(poza *metaclass*)." +"do odpowiedniego mechanizmu metaklas " +"(zwykle :meth:`~object.__init_subclass__`) w taki sam sposób, jak słowa " +"kluczowe w definicja klasy (poza *metaclass*)." + +msgid "" +"Unlike a :keyword:`class` statement, the three argument form does not call " +"the metaclass ``__prepare__`` method (see :ref:`prepare`). " +"Use :func:`types.new_class` to dynamically create a class using the " +"appropriate metaclass." +msgstr "" +"W przeciwieństwie do instrukcji :keyword:`class`, forma z trzema argumentami " +"nie wywołuje metody ``__prepare__`` metaklasy (zobacz :ref:`prepare`). Aby " +"dynamicznie utworzyć klasę przy użyciu odpowiedniej metaklasy, należy " +"skorzystać z :func:`types.new_class`." msgid "See also :ref:`class-customization`." msgstr "Zobacz także :ref:`class-customization`." @@ -3651,15 +3668,17 @@ msgstr "" "dowolnego innego obiektu z :attr:`!__dict__` atrybut ." msgid "" -"Objects such as modules and instances have an updateable :attr:`~object." -"__dict__` attribute; however, other objects may have write restrictions on " -"their :attr:`!__dict__` attributes (for example, classes use a :class:`types." -"MappingProxyType` to prevent direct dictionary updates)." +"Objects such as modules and instances have an " +"updateable :attr:`~object.__dict__` attribute; however, other objects may " +"have write restrictions on their :attr:`!__dict__` attributes (for example, " +"classes use a :class:`types.MappingProxyType` to prevent direct dictionary " +"updates)." msgstr "" -"Obiekty takie jak moduł i instancje mają możliwość aktualizacji :attr:" -"`~object.__dict__` atrybut; jednak inne obiekty mogą mieć ograniczenia " -"zapisu na ich :attr:`!__dict__` atrybut (na przykład klasy używają :class:" -"`types.MappingProxyType`, aby zapobiec bezpośrednim aktualizacjom słownika)." +"Obiekty takie jak moduł i instancje mają możliwość " +"aktualizacji :attr:`~object.__dict__` atrybut; jednak inne obiekty mogą mieć " +"ograniczenia zapisu na ich :attr:`!__dict__` atrybut (na przykład klasy " +"używają :class:`types.MappingProxyType`, aby zapobiec bezpośrednim " +"aktualizacjom słownika)." msgid "Without an argument, :func:`vars` acts like :func:`locals`." msgstr "Bez argumenta, :func:`vars` działa jak :func:`locals`." @@ -3714,8 +3733,8 @@ msgstr "" msgid "" "Another way to think of :func:`zip` is that it turns rows into columns, and " -"columns into rows. This is similar to `transposing a matrix `_." +"columns into rows. This is similar to `transposing a matrix `_." msgstr "" "Innym sposobem myślenia o :func:`zip` jest to, że zamienia wiersze w " "kolumny, a kolumny w wiersze. Jest to podobne do `przekształcania macierzy " @@ -3723,8 +3742,8 @@ msgstr "" msgid "" ":func:`zip` is lazy: The elements won't be processed until the iterable is " -"iterated on, e.g. by a :keyword:`!for` loop or by wrapping in a :class:" -"`list`." +"iterated on, e.g. by a :keyword:`!for` loop or by wrapping in " +"a :class:`list`." msgstr "" ":func:`zip` jest leniwy: Elementy nie będą przetwarzane, dopóki iterable nie " "zostanie poddany iteracji, np. przez pętlę :keyword:`!for` lub przez " @@ -3742,13 +3761,10 @@ msgstr "" "oferuje trzy różne podejścia do radzenia sobie z tym problemem:" msgid "" -"By default, :func:`zip` stops when the shortest iterable is exhausted. It " -"will ignore the remaining items in the longer iterables, cutting off the " -"result to the length of the shortest iterable::" +"By default, :func:`zip` stops when the shortest iterable " +"is :term:`exhausted`. It will ignore the remaining items in the longer " +"iterables, cutting off the result to the length of the shortest iterable::" msgstr "" -"Przez domyślny, :func:`zip` zatrzymuje się, gdy najkrótszy iterable jest " -"wyczerpany. Zignoruje pozostałe elementy w dłuższym iterable, obcinając " -"wynik do długości najkrótszego iterable::" msgid "" ">>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))\n" @@ -3775,10 +3791,8 @@ msgstr "" msgid "" "Unlike the default behavior, it raises a :exc:`ValueError` if one iterable " -"is exhausted before the others:" +"is :term:`exhausted` before the others:" msgstr "" -"W przeciwieństwie do domyślnego zachowania , rzuci :exc:`ValueError`, jeśli " -"jeden iterable zostanie wyczerpany przed innymi:" msgid "" "Without the ``strict=True`` argument, any bug that results in iterables of " @@ -3791,12 +3805,12 @@ msgstr "" msgid "" "Shorter iterables can be padded with a constant value to make all the " -"iterables have the same length. This is done by :func:`itertools." -"zip_longest`." +"iterables have the same length. This is done " +"by :func:`itertools.zip_longest`." msgstr "" "Krótsze iterable mogą być uzupełnione stałą wartością, aby wszystkie " -"iterable miały taką samą długość. Odbywa się to poprzez :func:`itertools." -"zip_longest`." +"iterable miały taką samą długość. Odbywa się to " +"poprzez :func:`itertools.zip_longest`." msgid "" "Edge cases: With a single iterable argument, :func:`zip` returns an iterator " @@ -3866,13 +3880,13 @@ msgid "" "discouraged in favor of :func:`importlib.import_module`." msgstr "" "Ten funkcja jest wywoływany przez :keyword:`import` instrukcja . Można go " -"zastąpić (importując :mod:`builtins` moduł i przypisując do ``builtins." -"__import__``) w celu zmiany semantyki :keyword:`!import` instrukcja , ale " -"jest to **bardżo** odradzane, ponieważ zwykle prostsze jest użycie haków " -"importu (zobacz :pep:`302`), aby osiągnąć te same cele i nie powoduje " -"problemów z kodem, który zakłada, że implementacja importu domyślny jest w " -"użyciu. Bezpośrednie użycie :func:`__import__` jest również odradzane na " -"korzyść :func:`importlib.import_module`." +"zastąpić (importując :mod:`builtins` moduł i przypisując do " +"``builtins.__import__``) w celu zmiany semantyki :keyword:`!import` " +"instrukcja , ale jest to **bardżo** odradzane, ponieważ zwykle prostsze jest " +"użycie haków importu (zobacz :pep:`302`), aby osiągnąć te same cele i nie " +"powoduje problemów z kodem, który zakłada, że implementacja importu domyślny " +"jest w użyciu. Bezpośrednie użycie :func:`__import__` jest również " +"odradzane na korzyść :func:`importlib.import_module`." msgid "" "The function imports the module *name*, potentially using the given " diff --git a/library/functools.po b/library/functools.po index 413e173b57..f10da1533d 100644 --- a/library/functools.po +++ b/library/functools.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -48,7 +48,7 @@ msgstr "" msgid "" "Returns the same as ``lru_cache(maxsize=None)``, creating a thin wrapper " "around a dictionary lookup for the function arguments. Because it never " -"needs to evict old values, this is smaller and faster than :func:`lru_cache` " +"needs to evict old values, this is smaller and faster than :deco:`lru_cache` " "with a size limit." msgstr "" @@ -83,7 +83,7 @@ msgstr "" msgid "" "Transform a method of a class into a property whose value is computed once " "and then cached as a normal attribute for the life of the instance. Similar " -"to :func:`property`, with the addition of caching. Useful for expensive " +"to :deco:`property`, with the addition of caching. Useful for expensive " "computed properties of instances that are otherwise effectively immutable." msgstr "" @@ -102,9 +102,9 @@ msgid "" msgstr "" msgid "" -"The mechanics of :func:`cached_property` are somewhat different from :func:" -"`property`. A regular property blocks attribute writes unless a setter is " -"defined. In contrast, a *cached_property* allows writes." +"The mechanics of :deco:`cached_property` are somewhat different " +"from :deco:`property`. A regular property blocks attribute writes unless a " +"setter is defined. In contrast, a *cached_property* allows writes." msgstr "" msgid "" @@ -147,15 +147,15 @@ msgstr "" msgid "" "If a mutable mapping is not available or if space-efficient key sharing is " -"desired, an effect similar to :func:`cached_property` can also be achieved " -"by stacking :func:`property` on top of :func:`lru_cache`. See :ref:`faq-" -"cache-method-calls` for more details on how this differs from :func:" -"`cached_property`." +"desired, an effect similar to :deco:`cached_property` can also be achieved " +"by stacking :deco:`property` on top of :deco:`lru_cache`. See :ref:`faq-" +"cache-method-calls` for more details on how this differs " +"from :deco:`cached_property`." msgstr "" msgid "" -"Prior to Python 3.12, ``cached_property`` included an undocumented lock to " -"ensure that in multi-threaded usage the getter function was guaranteed to " +"Prior to Python 3.12, :deco:`!cached_property` included an undocumented lock " +"to ensure that in multi-threaded usage the getter function was guaranteed to " "run only once per instance. However, the lock was per-property, not per-" "instance, which could result in unacceptably high lock contention. In Python " "3.12+ this locking is removed." @@ -163,11 +163,10 @@ msgstr "" msgid "" "Transform an old-style comparison function to a :term:`key function`. Used " -"with tools that accept key functions (such as :func:`sorted`, :func:`min`, :" -"func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`, :func:" -"`itertools.groupby`). This function is primarily used as a transition tool " -"for programs being converted from Python 2 which supported the use of " -"comparison functions." +"with tools that accept key functions (such " +"as :func:`sorted`, :func:`min`, :func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`, :func:`itertools.groupby`). " +"This function is primarily used as a transition tool for programs being " +"converted from Python 2 which supported the use of comparison functions." msgstr "" msgid "" @@ -184,8 +183,8 @@ msgstr "" msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -"Przykłady sortowania i krótki samouczek sortowania można znaleźć na stronie :" -"ref:`sortinghowto`." +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." msgid "" "Decorator to wrap a function with a memoizing callable that saves up to the " @@ -257,9 +256,9 @@ msgid "" msgstr "" msgid "" -"The original underlying function is accessible through the :attr:" -"`__wrapped__` attribute. This is useful for introspection, for bypassing " -"the cache, or for rewrapping the function with a different cache." +"The original underlying function is accessible through " +"the :attr:`__wrapped__` attribute. This is useful for introspection, for " +"bypassing the cache, or for rewrapping the function with a different cache." msgstr "" msgid "" @@ -312,9 +311,10 @@ msgid "" msgstr "" msgid "" -"Example of efficiently computing `Fibonacci numbers `_ using a cache to implement a `dynamic " -"programming `_ technique::" +"Example of efficiently computing `Fibonacci numbers `_ using a cache to implement a " +"`dynamic programming `_ " +"technique::" msgstr "" msgid "" @@ -347,9 +347,10 @@ msgid "" msgstr "" msgid "" -"The class must define one of :meth:`~object.__lt__`, :meth:`~object." -"__le__`, :meth:`~object.__gt__`, or :meth:`~object.__ge__`. In addition, the " -"class should supply an :meth:`~object.__eq__` method." +"The class must define one " +"of :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"or :meth:`~object.__ge__`. In addition, the class should supply " +"an :meth:`~object.__eq__` method." msgstr "" msgid "" @@ -454,10 +455,11 @@ msgid "" msgstr "" msgid "" -"If :func:`!partial` is applied to an existing :func:`!partial` object, :data:" -"`!Placeholder` sentinels of the input object are filled in with new " -"positional arguments. A placeholder can be retained by inserting a new :data:" -"`!Placeholder` sentinel to the place held by a previous :data:`!Placeholder`:" +"If :func:`!partial` is applied to an existing :ref:`partial object `, :data:`!Placeholder` sentinels of the input object are filled in " +"with new positional arguments. A placeholder can be retained by inserting a " +"new :data:`!Placeholder` sentinel to the place held by a previous :data:`!" +"Placeholder`:" msgstr "" msgid "" @@ -483,9 +485,9 @@ msgid "Added support for :data:`Placeholder` in positional arguments." msgstr "" msgid "" -"Return a new :class:`partialmethod` descriptor which behaves like :class:" -"`partial` except that it is designed to be used as a method definition " -"rather than being directly callable." +"Return a new :class:`partialmethod` descriptor which behaves " +"like :class:`partial` except that it is designed to be used as a method " +"definition rather than being directly callable." msgstr "" msgid "" @@ -494,19 +496,19 @@ msgid "" msgstr "" msgid "" -"When *func* is a descriptor (such as a normal Python function, :func:" -"`classmethod`, :func:`staticmethod`, :func:`~abc.abstractmethod` or another " -"instance of :class:`partialmethod`), calls to ``__get__`` are delegated to " -"the underlying descriptor, and an appropriate :ref:`partial object` returned as the result." +"When *func* is a descriptor (such as a normal Python " +"function, :func:`classmethod`, :func:`staticmethod`, :func:`~abc.abstractmethod` " +"or another instance of :class:`partialmethod`), calls to ``__get__`` are " +"delegated to the underlying descriptor, and an appropriate :ref:`partial " +"object` returned as the result." msgstr "" msgid "" "When *func* is a non-descriptor callable, an appropriate bound method is " "created dynamically. This behaves like a normal Python function when used as " "a method: the *self* argument will be inserted as the first positional " -"argument, even before the *args* and *keywords* supplied to the :class:" -"`partialmethod` constructor." +"argument, even before the *args* and *keywords* supplied to " +"the :class:`partialmethod` constructor." msgstr "" msgid "" @@ -567,8 +569,8 @@ msgid "*initial* is now supported as a keyword argument." msgstr "" msgid "" -"Transform a function into a :term:`single-dispatch ` :term:" -"`generic function`." +"Transform a function into a :term:`single-dispatch ` :term:`generic function`." msgstr "" msgid "" @@ -727,9 +729,9 @@ msgstr "" msgid "" "Where there is no registered implementation for a specific type, its method " "resolution order is used to find a more generic implementation. The original " -"function decorated with ``@singledispatch`` is registered for the base :" -"class:`object` type, which means it is used if no better implementation is " -"found." +"function decorated with ``@singledispatch`` is registered for the " +"base :class:`object` type, which means it is used if no better " +"implementation is found." msgstr "" msgid "" @@ -785,13 +787,13 @@ msgid "" msgstr "" msgid "" -"The :func:`~singledispatch.register` attribute now supports :class:`typing." -"Union` as a type annotation." +"The :func:`~singledispatch.register` attribute now " +"supports :class:`typing.Union` as a type annotation." msgstr "" msgid "" -"Transform a method into a :term:`single-dispatch ` :term:" -"`generic function`." +"Transform a method into a :term:`single-dispatch ` :term:`generic function`." msgstr "" msgid "" @@ -817,8 +819,8 @@ msgid "" msgstr "" msgid "" -"``@singledispatchmethod`` supports nesting with other decorators such as :" -"deco:`classmethod`. Note that to allow for ``dispatcher.register``, " +"``@singledispatchmethod`` supports nesting with other decorators such " +"as :deco:`classmethod`. Note that to allow for ``dispatcher.register``, " "``singledispatchmethod`` must be the *outer most* decorator. Here is the " "``Negator`` class with the ``neg`` methods bound to the class, rather than " "an instance of the class::" @@ -843,8 +845,8 @@ msgid "" msgstr "" msgid "" -"The same pattern can be used for other similar decorators: :deco:" -"`staticmethod`, :deco:`~abc.abstractmethod`, and others." +"The same pattern can be used for other similar " +"decorators: :deco:`staticmethod`, :deco:`~abc.abstractmethod`, and others." msgstr "" msgid "" @@ -854,17 +856,16 @@ msgid "" "function and which attributes of the wrapper function are updated with the " "corresponding attributes from the original function. The default values for " "these arguments are the module level constants ``WRAPPER_ASSIGNMENTS`` " -"(which assigns to the wrapper function's :attr:`~function.__module__`, :attr:" -"`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function." -"__annotations__`, :attr:`~function.__type_params__`, and :attr:`~function." -"__doc__`, the documentation string) and ``WRAPPER_UPDATES`` (which updates " -"the wrapper function's :attr:`~function.__dict__`, i.e. the instance " -"dictionary)." +"(which assigns to the wrapper " +"function's :attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__annotations__`, :attr:`~function.__type_params__`, " +"and :attr:`~function.__doc__`, the documentation string) and " +"``WRAPPER_UPDATES`` (which updates the wrapper " +"function's :attr:`~function.__dict__`, i.e. the instance dictionary)." msgstr "" msgid "" "To allow access to the original function for introspection and other " -"purposes (e.g. bypassing a caching decorator such as :func:`lru_cache`), " +"purposes (e.g. bypassing a caching decorator such as :deco:`lru_cache`), " "this function automatically adds a ``__wrapped__`` attribute to the wrapper " "that refers to the function being wrapped." msgstr "" @@ -886,15 +887,15 @@ msgid "" msgstr "" msgid "" -"The ``__wrapped__`` attribute is now automatically added. The :attr:" -"`~function.__annotations__` attribute is now copied by default. Missing " -"attributes no longer trigger an :exc:`AttributeError`." +"The ``__wrapped__`` attribute is now automatically added. " +"The :attr:`~function.__annotations__` attribute is now copied by default. " +"Missing attributes no longer trigger an :exc:`AttributeError`." msgstr "" msgid "" "The ``__wrapped__`` attribute now always refers to the wrapped function, " -"even if that function defined a ``__wrapped__`` attribute. (see :issue:" -"`17482`)" +"even if that function defined a ``__wrapped__`` attribute. " +"(see :issue:`17482`)" msgstr "" msgid "" @@ -963,7 +964,7 @@ msgstr "" msgid "" ":class:`partial` objects are like :ref:`function objects ` in that they are callable, weak referenceable, and can have " -"attributes. There are some important differences. For instance, the :attr:" -"`~definition.__name__` and :attr:`~definition.__doc__` attributes are not " -"created automatically." +"attributes. There are some important differences. For instance, " +"the :attr:`~definition.__name__` and :attr:`~definition.__doc__` attributes " +"are not created automatically." msgstr "" diff --git a/library/gc.po b/library/gc.po index 5757239033..ff4f31af5f 100644 --- a/library/gc.po +++ b/library/gc.po @@ -126,9 +126,9 @@ msgid "" "examined. If generation ``0`` has been examined more than *threshold1* " "times since generation ``1`` has been examined, then generation ``1`` is " "examined as well. With the third generation, things are a bit more " -"complicated, see `Collecting the oldest generation `_ for more " -"information." +"complicated, see `Collecting the oldest generation `_ " +"for more information." msgstr "" msgid "" @@ -169,13 +169,14 @@ msgstr "" msgid "" "Return a list of objects directly referred to by any of the arguments. The " -"referents returned are those objects visited by the arguments' C-level :c:" -"member:`~PyTypeObject.tp_traverse` methods (if any), and may not be all " -"objects actually directly reachable. :c:member:`~PyTypeObject.tp_traverse` " -"methods are supported only by objects that support garbage collection, and " -"are only required to visit objects that may be involved in a cycle. So, for " -"example, if an integer is directly reachable from an argument, that integer " -"object may or may not appear in the result list." +"referents returned are those objects visited by the arguments' C-" +"level :c:member:`~PyTypeObject.tp_traverse` methods (if any), and may not be " +"all objects actually directly " +"reachable. :c:member:`~PyTypeObject.tp_traverse` methods are supported only " +"by objects that support garbage collection, and are only required to visit " +"objects that may be involved in a cycle. So, for example, if an integer is " +"directly reachable from an argument, that integer object may or may not " +"appear in the result list." msgstr "" msgid "" @@ -239,15 +240,15 @@ msgid "" msgstr "" msgid "" -"If this list is non-empty at :term:`interpreter shutdown`, a :exc:" -"`ResourceWarning` is emitted, which is silent by default. If :const:" -"`DEBUG_UNCOLLECTABLE` is set, in addition all uncollectable objects are " -"printed." +"If this list is non-empty at :term:`interpreter shutdown`, " +"a :exc:`ResourceWarning` is emitted, which is silent by default. " +"If :const:`DEBUG_UNCOLLECTABLE` is set, in addition all uncollectable " +"objects are printed." msgstr "" msgid "" -"Following :pep:`442`, objects with a :meth:`__del__` method don't end up in :" -"attr:`gc.garbage` anymore." +"Following :pep:`442`, objects with a :meth:`__del__` method don't end up " +"in :attr:`gc.garbage` anymore." msgstr "" msgid "" diff --git a/library/getopt.po b/library/getopt.po index 655cf83721..cc286eee2b 100644 --- a/library/getopt.po +++ b/library/getopt.po @@ -38,8 +38,8 @@ msgid "" msgstr "" msgid "" -"This module helps scripts to parse the command line arguments in ``sys." -"argv``. It supports the same conventions as the Unix :c:func:`getopt` " +"This module helps scripts to parse the command line arguments in " +"``sys.argv``. It supports the same conventions as the Unix :c:func:`getopt` " "function (including the special meanings of arguments of the form '``-``' " "and '``--``'). Long options similar to those supported by GNU software may " "be used as well via an optional third argument." @@ -53,8 +53,8 @@ msgid "" "to be parsed, without the leading reference to the running program. " "Typically, this means ``sys.argv[1:]``. *shortopts* is the string of option " "letters that the script wants to recognize, with options that require an " -"argument followed by a colon (``':'``; i.e., the same format that Unix :c:" -"func:`getopt` uses)." +"argument followed by a colon (``':'``; i.e., the same format that " +"Unix :c:func:`getopt` uses)." msgstr "" msgid "" @@ -81,9 +81,9 @@ msgid "" "value)`` pairs; the second is the list of program arguments left after the " "option list was stripped (this is a trailing slice of *args*). Each option-" "and-value pair returned has the option as its first element, prefixed with a " -"hyphen for short options (e.g., ``'-x'``) or two hyphens for long options (e." -"g., ``'--long-option'``), and the option argument as its second element, or " -"an empty string if the option has no argument. The options occur in the " +"hyphen for short options (e.g., ``'-x'``) or two hyphens for long options " +"(e.g., ``'--long-option'``), and the option argument as its second element, " +"or an empty string if the option has no argument. The options occur in the " "list in the same order in which they were found, thus allowing multiple " "occurrences. Long and short options may be mixed." msgstr "" @@ -125,8 +125,8 @@ msgstr "" msgid "" "Note that an equivalent command line interface could be produced with less " -"code and more informative help and error messages by using the :mod:" -"`argparse` module::" +"code and more informative help and error messages by using " +"the :mod:`argparse` module::" msgstr "" msgid "Module :mod:`argparse`" diff --git a/library/getpass.po b/library/getpass.po index 816d38bd81..4780eb8ea8 100644 --- a/library/getpass.po +++ b/library/getpass.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -58,14 +58,14 @@ msgid "" msgstr "" msgid "" -"If echo free input is unavailable getpass() falls back to printing a warning " -"message to *stream* and reading from ``sys.stdin`` and issuing a :exc:" -"`GetPassWarning`." +"If echo-free input is unavailable, :func:`~getpass.getpass` falls back to " +"printing a warning message to *stream* and reading from :data:`sys.stdin` " +"and issuing a :exc:`GetPassWarning`." msgstr "" msgid "" -"If you call getpass from within IDLE, the input may be done in the terminal " -"you launched IDLE from rather than the idle window itself." +"If you call :func:`~getpass.getpass` from within IDLE, the input may be done " +"in the terminal you launched IDLE from rather than the idle window itself." msgstr "" msgid "" @@ -86,11 +86,12 @@ msgid "Return the \"login name\" of the user." msgstr "" msgid "" -"This function checks the environment variables :envvar:`LOGNAME`, :envvar:" -"`USER`, :envvar:`!LNAME` and :envvar:`USERNAME`, in order, and returns the " -"value of the first one which is set to a non-empty string. If none are set, " -"the login name from the password database is returned on systems which " -"support the :mod:`pwd` module, otherwise, an :exc:`OSError` is raised." +"This function checks the environment " +"variables :envvar:`LOGNAME`, :envvar:`USER`, :envvar:`!LNAME` " +"and :envvar:`USERNAME`, in order, and returns the value of the first one " +"which is set to a non-empty string. If none are set, the login name from " +"the password database is returned on systems which support the :mod:`pwd` " +"module, otherwise, an :exc:`OSError` is raised." msgstr "" msgid "In general, this function should be preferred over :func:`os.getlogin`." diff --git a/library/gettext.po b/library/gettext.po index 9182e46c12..3b04dd246c 100644 --- a/library/gettext.po +++ b/library/gettext.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -57,12 +57,13 @@ msgid "" msgstr "" msgid "" -"Bind the *domain* to the locale directory *localedir*. More concretely, :" -"mod:`!gettext` will look for binary :file:`.mo` files for the given domain " -"using the path (on Unix): :file:`{localedir}/{language}/LC_MESSAGES/{domain}." -"mo`, where *language* is searched for in the environment variables :envvar:" -"`LANGUAGE`, :envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, and :envvar:`LANG` " -"respectively." +"Bind the *domain* to the locale directory *localedir*. More " +"concretely, :mod:`!gettext` will look for binary :file:`.mo` files for the " +"given domain using the path (on Unix): :file:`{localedir}/{language}/" +"LC_MESSAGES/{domain}.mo`, where *language* is searched for in the " +"environment " +"variables :envvar:`LANGUAGE`, :envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, " +"and :envvar:`LANG` respectively." msgstr "" msgid "" @@ -108,7 +109,7 @@ msgstr "" msgid "" "Similar to the corresponding functions without the ``p`` in the prefix (that " -"is, :func:`gettext`, :func:`dgettext`, :func:`ngettext`, :func:`dngettext`), " +"is, :func:`~gettext.gettext`, :func:`dgettext`, :func:`ngettext`, :func:`dngettext`), " "but the translation is restricted to the given message *context*." msgstr "" @@ -152,11 +153,12 @@ msgstr "" msgid "" "If *localedir* is not given, then the default system locale directory is " "used. [#]_ If *languages* is not given, then the following environment " -"variables are searched: :envvar:`LANGUAGE`, :envvar:`LC_ALL`, :envvar:" -"`LC_MESSAGES`, and :envvar:`LANG`. The first one returning a non-empty " -"value is used for the *languages* variable. The environment variables should " -"contain a colon separated list of languages, which will be split on the " -"colon to produce the expected list of language code strings." +"variables are " +"searched: :envvar:`LANGUAGE`, :envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, " +"and :envvar:`LANG`. The first one returning a non-empty value is used for " +"the *languages* variable. The environment variables should contain a colon " +"separated list of languages, which will be split on the colon to produce the " +"expected list of language code strings." msgstr "" msgid "" @@ -192,8 +194,8 @@ msgstr "" msgid "" "If no :file:`.mo` file is found, this function raises :exc:`OSError` if " -"*fallback* is false (which is the default), and returns a :class:" -"`NullTranslations` instance if *fallback* is true." +"*fallback* is false (which is the default), and returns " +"a :class:`NullTranslations` instance if *fallback* is true." msgstr "" msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." @@ -204,8 +206,8 @@ msgstr "" msgid "" "This installs the function :func:`!_` in Python's builtins namespace, based " -"on *domain* and *localedir* which are passed to the function :func:" -"`translation`." +"on *domain* and *localedir* which are passed to the " +"function :func:`translation`." msgstr "" msgid "" @@ -305,9 +307,9 @@ msgid "" msgstr "" msgid "" -"Note that this is only one way, albeit the most convenient way, to make the :" -"func:`!_` function available to your application. Because it affects the " -"entire application globally, and specifically the built-in namespace, " +"Note that this is only one way, albeit the most convenient way, to make " +"the :func:`!_` function available to your application. Because it affects " +"the entire application globally, and specifically the built-in namespace, " "localized modules should never install :func:`!_`. Instead, they should use " "this code to make :func:`!_` available to their module::" msgstr "" @@ -330,17 +332,17 @@ msgid "The :class:`GNUTranslations` class" msgstr "" msgid "" -"The :mod:`!gettext` module provides one additional class derived from :class:" -"`NullTranslations`: :class:`GNUTranslations`. This class overrides :meth:`!" -"_parse` to enable reading GNU :program:`gettext` format :file:`.mo` files in " -"both big-endian and little-endian format." +"The :mod:`!gettext` module provides one additional class derived " +"from :class:`NullTranslations`: :class:`GNUTranslations`. This class " +"overrides :meth:`!_parse` to enable reading GNU :program:`gettext` " +"format :file:`.mo` files in both big-endian and little-endian format." msgstr "" msgid "" ":class:`GNUTranslations` parses optional metadata out of the translation " "catalog. It is convention with GNU :program:`gettext` to include metadata as " -"the translation for the empty string. This metadata is in :rfc:`822`\\ -" -"style ``key: value`` pairs, and should contain the ``Project-Id-Version`` " +"the translation for the empty string. This metadata is in :rfc:`822`\\ " +"-style ``key: value`` pairs, and should contain the ``Project-Id-Version`` " "key. If the key ``Content-Type`` is found, then the ``charset`` property is " "used to initialize the \"protected\" :attr:`!_charset` instance variable, " "defaulting to ``None`` if not found. If the charset encoding is specified, " @@ -384,9 +386,9 @@ msgstr "" msgid "" "If the message id is not found in the catalog, and a fallback is specified, " -"the request is forwarded to the fallback's :meth:`~NullTranslations." -"ngettext` method. Otherwise, when *n* is 1 *singular* is returned, and " -"*plural* is returned in all other cases." +"the request is forwarded to the " +"fallback's :meth:`~NullTranslations.ngettext` method. Otherwise, when *n* " +"is 1 *singular* is returned, and *plural* is returned in all other cases." msgstr "" msgid "Here is an example::" @@ -488,7 +490,7 @@ msgid "" "In order to prepare your code for I18N, you need to look at all the strings " "in your files. Any string that needs to be translated should be marked by " "wrapping it in ``_('...')`` --- that is, a call to the function :func:`_ " -"`. For example::" +"`. For example::" msgstr "" msgid "" @@ -517,32 +519,33 @@ msgid "" msgstr "" msgid "" -"(Python also includes pure-Python versions of these programs, called :" -"program:`pygettext.py` and :program:`msgfmt.py`; some Python distributions " -"will install them for you. :program:`pygettext.py` is similar to :program:" -"`xgettext`, but only understands Python source code and cannot handle other " -"programming languages such as C or C++. :program:`pygettext.py` supports a " -"command-line interface similar to :program:`xgettext`; for details on its " -"use, run ``pygettext.py --help``. :program:`msgfmt.py` is binary compatible " -"with GNU :program:`msgfmt`. With these two programs, you may not need the " -"GNU :program:`gettext` package to internationalize your Python applications.)" +"(Python also includes pure-Python versions of these programs, " +"called :program:`pygettext.py` and :program:`msgfmt.py`; some Python " +"distributions will install them for you. :program:`pygettext.py` is similar " +"to :program:`xgettext`, but only understands Python source code and cannot " +"handle other programming languages such as C or C++. :program:`pygettext.py` " +"supports a command-line interface similar to :program:`xgettext`; for " +"details on its use, run ``pygettext.py --help``. :program:`msgfmt.py` is " +"binary compatible with GNU :program:`msgfmt`. With these two programs, you " +"may not need the GNU :program:`gettext` package to internationalize your " +"Python applications.)" msgstr "" msgid "" -":program:`xgettext`, :program:`pygettext`, and similar tools generate :file:" -"`.po` files that are message catalogs. They are structured human-readable " -"files that contain every marked string in the source code, along with a " -"placeholder for the translated versions of these strings." +":program:`xgettext`, :program:`pygettext`, and similar tools " +"generate :file:`.po` files that are message catalogs. They are structured " +"human-readable files that contain every marked string in the source code, " +"along with a placeholder for the translated versions of these strings." msgstr "" msgid "" "Copies of these :file:`.po` files are then handed over to the individual " "human translators who write translations for every supported natural " -"language. They send back the completed language-specific versions as a :" -"file:`.po` file that's compiled into a machine-readable :file:" -"`.mo` binary catalog file using the :program:`msgfmt` program. The :file:`." -"mo` files are used by the :mod:`!gettext` module for the actual translation " -"processing at run-time." +"language. They send back the completed language-specific versions as " +"a :file:`.po` file that's compiled into a machine-" +"readable :file:`.mo` binary catalog file using the :program:`msgfmt` " +"program. The :file:`.mo` files are used by the :mod:`!gettext` module for " +"the actual translation processing at run-time." msgstr "" msgid "" @@ -556,8 +559,8 @@ msgstr "" msgid "" "If you are localizing your module, you must take care not to make global " -"changes, e.g. to the built-in namespace. You should not use the GNU :program:" -"`gettext` API but instead the class-based API." +"changes, e.g. to the built-in namespace. You should not use the " +"GNU :program:`gettext` API but instead the class-based API." msgstr "" msgid "" @@ -594,8 +597,8 @@ msgid "" msgstr "" msgid "" -"If you need to set the locale directory, you can pass it into the :func:" -"`install` function::" +"If you need to set the locale directory, you can pass it into " +"the :func:`install` function::" msgstr "" msgid "" diff --git a/library/glob.po b/library/glob.po index 01555f089f..e0cbbd113c 100644 --- a/library/glob.po +++ b/library/glob.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,10 +43,10 @@ msgid "" msgstr "" msgid "" -"Files beginning with a dot (``.``) can only be matched by patterns that also " -"start with a dot, unlike :func:`fnmatch.fnmatch` or :func:`pathlib.Path." -"glob`. For tilde and shell variable expansion, use :func:`os.path." -"expanduser` and :func:`os.path.expandvars`." +"By default, files beginning with a dot (``.``) can only be matched by " +"patterns that also start with a dot, unlike :func:`fnmatch.fnmatch` " +"or :func:`pathlib.Path.glob`. For tilde and shell variable expansion, " +"use :func:`os.path.expanduser` and :func:`os.path.expandvars`." msgstr "" msgid "" @@ -60,18 +60,18 @@ msgstr "" msgid "" "Return a possibly empty list of path names that match *pathname*, which must " "be a string containing a path specification. *pathname* can be either " -"absolute (like :file:`/usr/src/Python-1.5/Makefile`) or relative (like :file:" -"`../../Tools/\\*/\\*.gif`), and can contain shell-style wildcards. Broken " -"symlinks are included in the results (as in the shell). Whether or not the " -"results are sorted depends on the file system. If a file that satisfies " -"conditions is removed or added during the call of this function, whether a " -"path name for that file will be included is unspecified." +"absolute (like :file:`/usr/src/Python-1.5/Makefile`) or relative " +"(like :file:`../../Tools/\\*/\\*.gif`), and can contain shell-style " +"wildcards. Broken symlinks are included in the results (as in the shell). " +"Whether or not the results are sorted depends on the file system. If a file " +"that satisfies conditions is removed or added during the call of this " +"function, whether a path name for that file will be included is unspecified." msgstr "" msgid "" "If *root_dir* is not ``None``, it should be a :term:`path-like object` " -"specifying the root directory for searching. It has the same effect on :" -"func:`!glob` as changing the current directory before calling it. If " +"specifying the root directory for searching. It has the same effect " +"on :func:`!glob` as changing the current directory before calling it. If " "*pathname* is relative, the result will contain paths relative to *root_dir*." msgstr "" @@ -88,8 +88,8 @@ msgid "" msgstr "" msgid "" -"If *include_hidden* is true, \"``**``\" pattern will match hidden " -"directories." +"If *include_hidden* is true, wildcards can match path segments that begin " +"with a dot (``.``)." msgstr "" msgid "" @@ -128,30 +128,31 @@ msgid "Added the *include_hidden* parameter." msgstr "" msgid "" -"Return an :term:`iterator` which yields the same values as :func:`glob` " -"without actually storing them all simultaneously." +"Return an :term:`iterator` which yields the same values " +"as :func:`~glob.glob` without actually storing them all simultaneously." msgstr "" msgid "" "Escape all special characters (``'?'``, ``'*'`` and ``'['``). This is useful " "if you want to match an arbitrary literal string that may have special " "characters in it. Special characters in drive/UNC sharepoints are not " -"escaped, e.g. on Windows ``escape('//?/c:/Quo vadis?.txt')`` returns ``'//?/" -"c:/Quo vadis[?].txt'``." +"escaped, for example on Windows ``escape('//?/c:/Quo vadis?.txt')`` returns " +"``'//?/c:/Quo vadis[?].txt'``." msgstr "" msgid "" -"Convert the given path specification to a regular expression for use with :" -"func:`re.match`. The path specification can contain shell-style wildcards." +"Convert the given path specification to a regular expression for use " +"with :func:`re.match`. The path specification can contain shell-style " +"wildcards." msgstr "" msgid "For example:" msgstr "Na przykład::" msgid "" -"Path separators and segments are meaningful to this function, unlike :func:" -"`fnmatch.translate`. By default wildcards do not match path separators, and " -"``*`` pattern segments match precisely one path segment." +"Path separators and segments are meaningful to this function, " +"unlike :func:`fnmatch.translate`. By default wildcards do not match path " +"separators, and ``*`` pattern segments match precisely one path segment." msgstr "" msgid "" @@ -178,9 +179,10 @@ msgid "Examples" msgstr "Przykłady" msgid "" -"Consider a directory containing the following files: :file:`1.gif`, :file:`2." -"txt`, :file:`card.gif` and a subdirectory :file:`sub` which contains only " -"the file :file:`3.txt`. :func:`glob` will produce the following results. " +"Consider a directory containing the following " +"files: :file:`1.gif`, :file:`2.txt`, :file:`card.gif` and a " +"subdirectory :file:`sub` which contains only the " +"file :file:`3.txt`. :func:`~glob.glob` will produce the following results. " "Notice how any leading components of the path are preserved. ::" msgstr "" @@ -200,8 +202,8 @@ msgstr "" msgid "" "If the directory contains files starting with ``.`` they won't be matched by " -"default. For example, consider a directory containing :file:`card.gif` and :" -"file:`.card.gif`::" +"default. For example, consider a directory containing :file:`card.gif` " +"and :file:`.card.gif`::" msgstr "" msgid "" diff --git a/library/graphlib.po b/library/graphlib.po index 716045310a..ced8f86299 100644 --- a/library/graphlib.po +++ b/library/graphlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -78,8 +78,8 @@ msgstr "" msgid "" "In case just an immediate sorting of the nodes in the graph is required and " -"no parallelism is involved, the convenience method :meth:`TopologicalSorter." -"static_order` can be used directly:" +"no parallelism is involved, the convenience " +"method :meth:`TopologicalSorter.static_order` can be used directly:" msgstr "" msgid "" @@ -141,16 +141,16 @@ msgstr "" msgid "" "Mark the graph as finished and check for cycles in the graph. If any cycle " -"is detected, :exc:`CycleError` will be raised, but :meth:`~TopologicalSorter." -"get_ready` can still be used to obtain as many nodes as possible until " -"cycles block more progress. After a call to this function, the graph cannot " -"be modified, and therefore no more nodes can be added using :meth:" -"`~TopologicalSorter.add`." +"is detected, :exc:`CycleError` will be raised, " +"but :meth:`~TopologicalSorter.get_ready` can still be used to obtain as many " +"nodes as possible until cycles block more progress. After a call to this " +"function, the graph cannot be modified, and therefore no more nodes can be " +"added using :meth:`~TopologicalSorter.add`." msgstr "" msgid "" -"A :exc:`ValueError` will be raised if the sort has been started by :meth:`~." -"static_order` or :meth:`~.get_ready`." +"A :exc:`ValueError` will be raised if the sort has been started " +"by :meth:`~.static_order` or :meth:`~.get_ready`." msgstr "" msgid "" @@ -161,10 +161,10 @@ msgstr "" msgid "" "Returns ``True`` if more progress can be made and ``False`` otherwise. " "Progress can be made if cycles do not block the resolution and either there " -"are still nodes ready that haven't yet been returned by :meth:" -"`TopologicalSorter.get_ready` or the number of nodes marked :meth:" -"`TopologicalSorter.done` is less than the number that have been returned by :" -"meth:`TopologicalSorter.get_ready`." +"are still nodes ready that haven't yet been returned " +"by :meth:`TopologicalSorter.get_ready` or the number of nodes " +"marked :meth:`TopologicalSorter.done` is less than the number that have been " +"returned by :meth:`TopologicalSorter.get_ready`." msgstr "" msgid "" @@ -186,8 +186,8 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`ValueError` if called without calling :meth:`~TopologicalSorter." -"prepare` previously." +"Raises :exc:`ValueError` if called without " +"calling :meth:`~TopologicalSorter.prepare` previously." msgstr "" msgid "" @@ -199,9 +199,9 @@ msgstr "" msgid "" "Raises :exc:`ValueError` if any node in *nodes* has already been marked as " "processed by a previous call to this method or if a node was not added to " -"the graph by using :meth:`TopologicalSorter.add`, if called without calling :" -"meth:`~TopologicalSorter.prepare` or if node has not yet been returned by :" -"meth:`~TopologicalSorter.get_ready`." +"the graph by using :meth:`TopologicalSorter.add`, if called without " +"calling :meth:`~TopologicalSorter.prepare` or if node has not yet been " +"returned by :meth:`~TopologicalSorter.get_ready`." msgstr "" msgid "" @@ -214,9 +214,9 @@ msgstr "" msgid "" "Returns an iterator object which will iterate over nodes in a topological " -"order. When using this method, :meth:`~TopologicalSorter.prepare` and :meth:" -"`~TopologicalSorter.done` should not be called. This method is equivalent " -"to::" +"order. When using this method, :meth:`~TopologicalSorter.prepare` " +"and :meth:`~TopologicalSorter.done` should not be called. This method is " +"equivalent to::" msgstr "" msgid "" @@ -249,9 +249,9 @@ msgstr "" msgid "" "This is due to the fact that \"0\" and \"2\" are in the same level in the " -"graph (they would have been returned in the same call to :meth:" -"`~TopologicalSorter.get_ready`) and the order between them is determined by " -"the order of insertion." +"graph (they would have been returned in the same call " +"to :meth:`~TopologicalSorter.get_ready`) and the order between them is " +"determined by the order of insertion." msgstr "" msgid "If any cycle is detected, :exc:`CycleError` will be raised." @@ -270,9 +270,10 @@ msgid "" msgstr "" msgid "" -"The detected cycle can be accessed via the second element in the :attr:" -"`~BaseException.args` attribute of the exception instance and consists in a " -"list of nodes, such that each node is, in the graph, an immediate " -"predecessor of the next node in the list. In the reported list, the first " -"and the last node will be the same, to make it clear that it is cyclic." +"The detected cycle can be accessed via the second element in " +"the :attr:`~BaseException.args` attribute of the exception instance and " +"consists in a list of nodes, such that each node is, in the graph, an " +"immediate predecessor of the next node in the list. In the reported list, " +"the first and the last node will be the same, to make it clear that it is " +"cyclic." msgstr "" diff --git a/library/grp.po b/library/grp.po index 6002a4c433..5a6b57fcbc 100644 --- a/library/grp.po +++ b/library/grp.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -91,16 +91,16 @@ msgid "" "members of the group they are in according to the password database. Check " "both databases to get complete membership information. Also note that a " "``gr_name`` that starts with a ``+`` or ``-`` is likely to be a YP/NIS " -"reference and may not be accessible via :func:`getgrnam` or :func:" -"`getgrgid`.)" +"reference and may not be accessible via :func:`getgrnam` " +"or :func:`getgrgid`.)" msgstr "" msgid "It defines the following items:" msgstr "" msgid "" -"Return the group database entry for the given numeric group ID. :exc:" -"`KeyError` is raised if the entry asked for cannot be found." +"Return the group database entry for the given numeric group " +"ID. :exc:`KeyError` is raised if the entry asked for cannot be found." msgstr "" msgid "" diff --git a/library/gzip.po b/library/gzip.po index 409b84f355..24965ad323 100644 --- a/library/gzip.po +++ b/library/gzip.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,8 +43,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "The data compression is provided by the :mod:`zlib` module." msgstr "Kompresję danych zapewnia moduł :mod:`zlib`." @@ -52,15 +52,15 @@ msgstr "Kompresję danych zapewnia moduł :mod:`zlib`." msgid "" "The :mod:`!gzip` module provides the :class:`GzipFile` class, as well as " "the :func:`.open`, :func:`compress` and :func:`decompress` convenience " -"functions. The :class:`GzipFile` class reads and writes :program:`gzip`\\ -" -"format files, automatically compressing or decompressing the data so that it " -"looks like an ordinary :term:`file object`." +"functions. The :class:`GzipFile` class reads and writes :program:`gzip`\\ " +"-format files, automatically compressing or decompressing the data so that " +"it looks like an ordinary :term:`file object`." msgstr "" msgid "" -"Note that additional file formats which can be decompressed by the :program:" -"`gzip` and :program:`gunzip` programs, such as those produced by :program:" -"`compress` and :program:`pack`, are not supported by this module." +"Note that additional file formats which can be decompressed by " +"the :program:`gzip` and :program:`gunzip` programs, such as those produced " +"by :program:`compress` and :program:`pack`, are not supported by this module." msgstr "" msgid "The module defines the following items:" @@ -72,8 +72,9 @@ msgid "" msgstr "" msgid "" -"The *filename* argument can be an actual filename (a :class:`str` or :class:" -"`bytes` object), or an existing file object to read from or write to." +"The *filename* argument can be an actual filename (a :class:`str` " +"or :class:`bytes` object), or an existing file object to read from or write " +"to." msgstr "" msgid "" @@ -83,8 +84,8 @@ msgid "" msgstr "" msgid "" -"The *compresslevel* argument is an integer from 0 to 9, as for the :class:" -"`GzipFile` constructor." +"The *compresslevel* argument is an integer from 0 to 9, as for " +"the :class:`GzipFile` constructor." msgstr "" msgid "" @@ -94,8 +95,8 @@ msgid "" msgstr "" msgid "" -"For text mode, a :class:`GzipFile` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"For text mode, a :class:`GzipFile` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" @@ -111,16 +112,16 @@ msgid "Accepts a :term:`path-like object`." msgstr "" msgid "" -"An exception raised for invalid gzip files. It inherits from :exc:" -"`OSError`. :exc:`EOFError` and :exc:`zlib.error` can also be raised for " -"invalid gzip files." +"An exception raised for invalid gzip files. It inherits " +"from :exc:`OSError`. :exc:`EOFError` and :exc:`zlib.error` can also be " +"raised for invalid gzip files." msgstr "" msgid "" "Constructor for the :class:`GzipFile` class, which simulates most of the " -"methods of a :term:`file object`, with the exception of the :meth:`~io." -"IOBase.truncate` method. At least one of *fileobj* and *filename* must be " -"given a non-trivial value." +"methods of a :term:`file object`, with the exception of " +"the :meth:`~io.IOBase.truncate` method. At least one of *fileobj* and " +"*filename* must be given a non-trivial value." msgstr "" msgid "" @@ -162,9 +163,13 @@ msgstr "" msgid "" "The optional *mtime* argument is the timestamp requested by gzip. The time " -"is in Unix format, i.e., seconds since 00:00:00 UTC, January 1, 1970. If " -"*mtime* is omitted or ``None``, the current time is used. Use *mtime* = 0 to " -"generate a compressed stream that does not depend on creation time." +"is in Unix format, i.e., seconds since 00:00:00 UTC, January 1, 1970. Set " +"*mtime* to ``0`` to generate a compressed stream that does not depend on " +"creation time. If *mtime* is omitted or ``None``, the current time is used; " +"however, if the current time is outside the range 00:00:00 UTC, January 1, " +"1970 through 06:28:15 UTC, February 7, 2106, or explicitly passed *mtime* " +"argument is outside the range ``0`` to ``2**32-1``, then the value ``0`` is " +"used instead." msgstr "" msgid "" @@ -175,14 +180,14 @@ msgid "" "Calling a :class:`GzipFile` object's :meth:`!close` method does not close " "*fileobj*, since you might wish to append more material after the compressed " "data. This also allows you to pass an :class:`io.BytesIO` object opened for " -"writing as *fileobj*, and retrieve the resulting memory buffer using the :" -"class:`io.BytesIO` object's :meth:`~io.BytesIO.getvalue` method." +"writing as *fileobj*, and retrieve the resulting memory buffer using " +"the :class:`io.BytesIO` object's :meth:`~io.BytesIO.getvalue` method." msgstr "" msgid "" ":class:`GzipFile` supports the :class:`io.BufferedIOBase` interface, " -"including iteration and the :keyword:`with` statement. Only the :meth:`~io." -"IOBase.truncate` method isn't implemented." +"including iteration and the :keyword:`with` statement. Only " +"the :meth:`~io.IOBase.truncate` method isn't implemented." msgstr "" msgid ":class:`GzipFile` also provides the following method and attribute:" @@ -194,9 +199,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`GzipFile`, it may change the position of the underlying file object (e.g. " -"if the :class:`GzipFile` was constructed with the *fileobj* parameter)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`GzipFile`, it may change the position of the underlying file " +"object (e.g. if the :class:`GzipFile` was constructed with the *fileobj* " +"parameter)." msgstr "" msgid "``'rb'`` for reading and ``'wb'`` for writing." @@ -260,10 +266,10 @@ msgstr "" msgid "" "Speed is improved by compressing all data at once instead of in a streamed " -"fashion. Calls with *mtime* set to ``0`` are delegated to :func:`zlib." -"compress` for better speed. In this situation the output may contain a gzip " -"header \"OS\" byte value other than 255 \"unknown\" as supplied by the " -"underlying zlib implementation." +"fashion. Calls with *mtime* set to ``0`` are delegated " +"to :func:`zlib.compress` for better speed. In this situation the output may " +"contain a gzip header \"OS\" byte value other than 255 \"unknown\" as " +"supplied by the underlying zlib implementation." msgstr "" msgid "" @@ -345,7 +351,7 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The :mod:`!gzip` module provides a simple command line interface to compress " diff --git a/library/hashlib.po b/library/hashlib.po index 78bca27863..4d3c665c49 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,8 +38,8 @@ msgid "" msgstr "" msgid "" -"If you want the adler32 or crc32 hash functions, they are available in the :" -"mod:`zlib` module." +"If you want the adler32 or crc32 hash functions, they are available in " +"the :mod:`zlib` module." msgstr "" msgid "Hash algorithms" @@ -47,36 +47,35 @@ msgstr "" msgid "" "There is one constructor method named for each type of :dfn:`hash`. All " -"return a hash object with the same simple interface. For example: use :func:" -"`sha256` to create a SHA-256 hash object. You can now feed this object with :" -"term:`bytes-like objects ` (normally :class:`bytes`) " -"using the :meth:`update` method. At any point you can ask it " -"for the :dfn:`digest` of the concatenation of the data fed to it so far " -"using the :meth:`digest()` or :meth:`hexdigest()` methods." +"return a hash object with the same simple interface. For example: " +"use :func:`sha256` to create a SHA-256 hash object. You can now feed this " +"object with :term:`bytes-like objects ` " +"(normally :class:`bytes`) using the :meth:`update` method. At " +"any point you can ask it for the :dfn:`digest` of the concatenation of the " +"data fed to it so far using the :meth:`digest()` " +"or :meth:`hexdigest()` methods." msgstr "" msgid "" "To allow multithreading, the Python :term:`GIL` is released while computing " -"a hash supplied more than 2047 bytes of data at once in its constructor or :" -"meth:`.update` method." +"a hash supplied more than 2047 bytes of data at once in its constructor " +"or :meth:`.update` method." msgstr "" msgid "" -"Constructors for hash algorithms that are always present in this module are :" -"func:`sha1`, :func:`sha224`, :func:`sha256`, :func:`sha384`, :func:" -"`sha512`, :func:`sha3_224`, :func:`sha3_256`, :func:`sha3_384`, :func:" -"`sha3_512`, :func:`shake_128`, :func:`shake_256`, :func:`blake2b`, and :func:" -"`blake2s`. :func:`md5` is normally available as well, though it may be " -"missing or blocked if you are using a rare \"FIPS compliant\" build of " -"Python. These correspond to :data:`algorithms_guaranteed`." +"Constructors for hash algorithms that are always present in this module " +"are :func:`sha1`, :func:`sha224`, :func:`sha256`, :func:`sha384`, :func:`sha512`, :func:`sha3_224`, :func:`sha3_256`, :func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256`, :func:`blake2b`, " +"and :func:`blake2s`. :func:`md5` is normally available as well, though it " +"may be missing or blocked if you are using a rare \"FIPS compliant\" build " +"of Python. These correspond to :data:`algorithms_guaranteed`." msgstr "" msgid "" -"Additional algorithms may also be available if your Python distribution's :" -"mod:`!hashlib` was linked against a build of OpenSSL that provides others. " -"Others *are not guaranteed available* on all installations and will only be " -"accessible by name via :func:`new`. See :data:`algorithms_available`." +"Additional algorithms may also be available if your Python " +"distribution's :mod:`!hashlib` was linked against a build of OpenSSL that " +"provides others. Others *are not guaranteed available* on all installations " +"and will only be accessible by name via :func:`new`. " +"See :data:`algorithms_available`." msgstr "" msgid "" @@ -86,9 +85,9 @@ msgid "" msgstr "" msgid "" -"SHA3 (Keccak) and SHAKE constructors :func:`sha3_224`, :func:`sha3_256`, :" -"func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256` were " -"added. :func:`blake2b` and :func:`blake2s` were added." +"SHA3 (Keccak) and SHAKE " +"constructors :func:`sha3_224`, :func:`sha3_256`, :func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256` " +"were added. :func:`blake2b` and :func:`blake2s` were added." msgstr "" msgid "" @@ -123,8 +122,7 @@ msgid "" ">>> m.update(b\" the spammish repetition\")\n" ">>> m.digest()\n" "b'\\x03\\x1e\\xdd}Ae\\x15\\x93\\xc5\\xfe\\\\" -"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:" -"\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" +"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" ">>> m.hexdigest()\n" "'031edd7d41651593c5fe5c006fa5752b37fddff7bc4e843aa6af0c950f4b9406'" msgstr "" @@ -134,8 +132,7 @@ msgstr "" ">>> m.update(b\" the spammish repetition\")\n" ">>> m.digest()\n" "b'\\x03\\x1e\\xdd}Ae\\x15\\x93\\xc5\\xfe\\\\" -"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:" -"\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" +"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" ">>> m.hexdigest()\n" "'031edd7d41651593c5fe5c006fa5752b37fddff7bc4e843aa6af0c950f4b9406'" @@ -175,8 +172,8 @@ msgstr "" msgid "" "A set containing the names of the hash algorithms that are available in the " -"running Python interpreter. These names will be recognized when passed to :" -"func:`new`. :attr:`algorithms_guaranteed` will always be a subset. The " +"running Python interpreter. These names will be recognized when passed " +"to :func:`new`. :attr:`algorithms_guaranteed` will always be a subset. The " "same algorithm may appear multiple times in this set under different names " "(thanks to OpenSSL)." msgstr "" @@ -276,15 +273,15 @@ msgid "" "*fileobj* must be a file-like object opened for reading in binary mode. It " "accepts file objects from builtin :func:`open`, :class:`~io.BytesIO` " "instances, SocketIO objects from :meth:`socket.socket.makefile`, and " -"similar. *fileobj* must be opened in blocking mode, otherwise a :exc:" -"`BlockingIOError` may be raised." +"similar. *fileobj* must be opened in blocking mode, otherwise " +"a :exc:`BlockingIOError` may be raised." msgstr "" msgid "" -"The function may bypass Python's I/O and use the file descriptor from :meth:" -"`~io.IOBase.fileno` directly. *fileobj* must be assumed to be in an unknown " -"state after this function returns or raises. It is up to the caller to close " -"*fileobj*." +"The function may bypass Python's I/O and use the file descriptor " +"from :meth:`~io.IOBase.fileno` directly. *fileobj* must be assumed to be in " +"an unknown state after this function returns or raises. It is up to the " +"caller to close *fileobj*." msgstr "" msgid "" @@ -542,10 +539,11 @@ msgstr "" msgid "" "To calculate hash of some data, you should first construct a hash object by " -"calling the appropriate constructor function (:func:`blake2b` or :func:" -"`blake2s`), then update it with the data by calling :meth:`~hash.update` on " -"the object, and, finally, get the digest out of the object by calling :meth:" -"`~hash.digest` (or :meth:`~hash.hexdigest` for hex-encoded string)." +"calling the appropriate constructor function (:func:`blake2b` " +"or :func:`blake2s`), then update it with the data by " +"calling :meth:`~hash.update` on the object, and, finally, get the digest out " +"of the object by calling :meth:`~hash.digest` (or :meth:`~hash.hexdigest` " +"for hex-encoded string)." msgstr "" msgid "" @@ -578,9 +576,9 @@ msgstr "" msgid "" "Keyed hashing can be used for authentication as a faster and simpler " -"replacement for `Hash-based message authentication code `_ (HMAC). BLAKE2 can be securely used in prefix-MAC " -"mode thanks to the indifferentiability property inherited from BLAKE." +"replacement for `Hash-based message authentication code `_ (HMAC). BLAKE2 can be securely used in prefix-" +"MAC mode thanks to the indifferentiability property inherited from BLAKE." msgstr "" msgid "" diff --git a/library/heapq.po b/library/heapq.po index 4f9ec001a0..8e5b9d4eae 100644 --- a/library/heapq.po +++ b/library/heapq.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -73,8 +73,8 @@ msgid "" "index for a node and the indexes for its children slightly less obvious, but " "is more suitable since Python uses zero-based indexing. (b) Textbooks often " "focus on max-heaps, due to their suitability for in-place sorting. Our " -"implementation favors min-heaps as they better correspond to Python :class:" -"`lists `." +"implementation favors min-heaps as they better correspond to " +"Python :class:`lists `." msgstr "" msgid "" @@ -96,8 +96,8 @@ msgstr "" msgid "" "To create a heap, use a list initialized as ``[]``, or transform an existing " -"list into a min-heap or max-heap using the :func:`heapify` or :func:" -"`heapify_max` functions, respectively." +"list into a min-heap or max-heap using the :func:`heapify` " +"or :func:`heapify_max` functions, respectively." msgstr "" msgid "The following functions are provided for min-heaps:" @@ -124,8 +124,8 @@ msgstr "" msgid "" "Pop and return the smallest item from the *heap*, and also push the new " -"*item*. The heap size doesn't change. If the heap is empty, :exc:" -"`IndexError` is raised." +"*item*. The heap size doesn't change. If the heap is " +"empty, :exc:`IndexError` is raised." msgstr "" msgid "" @@ -161,14 +161,14 @@ msgstr "" msgid "" "Push *item* on the max-heap *heap*, then pop and return the largest item " -"from *heap*. The combined action runs more efficiently than :func:" -"`heappush_max` followed by a separate call to :func:`heappop_max`." +"from *heap*. The combined action runs more efficiently " +"than :func:`heappush_max` followed by a separate call to :func:`heappop_max`." msgstr "" msgid "" "Pop and return the largest item from the max-heap *heap* and also push the " -"new *item*. The max-heap size doesn't change. If the max-heap is empty, :exc:" -"`IndexError` is raised." +"new *item*. The max-heap size doesn't change. If the max-heap is " +"empty, :exc:`IndexError` is raised." msgstr "" msgid "" @@ -225,16 +225,16 @@ msgid "" "Return a list with the *n* smallest elements from the dataset defined by " "*iterable*. *key*, if provided, specifies a function of one argument that " "is used to extract a comparison key from each element in *iterable* (for " -"example, ``key=str.lower``). Equivalent to: ``sorted(iterable, key=key)[:" -"n]``." +"example, ``key=str.lower``). Equivalent to: ``sorted(iterable, key=key)" +"[:n]``." msgstr "" msgid "" "The latter two functions perform best for smaller values of *n*. For larger " "values, it is more efficient to use the :func:`sorted` function. Also, when " -"``n==1``, it is more efficient to use the built-in :func:`min` and :func:" -"`max` functions. If repeated usage of these functions is required, consider " -"turning the iterable into an actual heap." +"``n==1``, it is more efficient to use the built-in :func:`min` " +"and :func:`max` functions. If repeated usage of these functions is " +"required, consider turning the iterable into an actual heap." msgstr "" msgid "Basic Examples" diff --git a/library/hmac.po b/library/hmac.po index a5d71f9c9d..fddbe941b9 100644 --- a/library/hmac.po +++ b/library/hmac.po @@ -59,8 +59,8 @@ msgid "" "Return digest of *msg* for given secret *key* and *digest*. The function is " "equivalent to ``HMAC(key, msg, digest).digest()``, but uses an optimized C " "or inline implementation, which is faster for messages that fit into memory. " -"The parameters *key*, *msg*, and *digest* have the same meaning as in :func:" -"`~hmac.new`." +"The parameters *key*, *msg*, and *digest* have the same meaning as " +"in :func:`~hmac.new`." msgstr "" msgid "" @@ -74,8 +74,8 @@ msgstr "" msgid "" "Update the hmac object with *msg*. Repeated calls are equivalent to a " -"single call with the concatenation of all the arguments: ``m.update(a); m." -"update(b)`` is equivalent to ``m.update(a + b)``." +"single call with the concatenation of all the arguments: ``m.update(a); " +"m.update(b)`` is equivalent to ``m.update(a + b)``." msgstr "" msgid "Parameter *msg* can be of any type supported by :mod:`hashlib`." @@ -90,9 +90,9 @@ msgstr "" msgid "" "When comparing the output of :meth:`digest` to an externally supplied digest " -"during a verification routine, it is recommended to use the :func:" -"`compare_digest` function instead of the ``==`` operator to reduce the " -"vulnerability to timing attacks." +"during a verification routine, it is recommended to use " +"the :func:`compare_digest` function instead of the ``==`` operator to reduce " +"the vulnerability to timing attacks." msgstr "" msgid "" @@ -103,9 +103,9 @@ msgstr "" msgid "" "When comparing the output of :meth:`hexdigest` to an externally supplied " -"digest during a verification routine, it is recommended to use the :func:" -"`compare_digest` function instead of the ``==`` operator to reduce the " -"vulnerability to timing attacks." +"digest during a verification routine, it is recommended to use " +"the :func:`compare_digest` function instead of the ``==`` operator to reduce " +"the vulnerability to timing attacks." msgstr "" msgid "" @@ -138,8 +138,8 @@ msgid "" "Return ``a == b``. This function uses an approach designed to prevent " "timing analysis by avoiding content-based short circuiting behaviour, making " "it appropriate for cryptography. *a* and *b* must both be of the same type: " -"either :class:`str` (ASCII only, as e.g. returned by :meth:`HMAC." -"hexdigest`), or a :term:`bytes-like object`." +"either :class:`str` (ASCII only, as e.g. returned " +"by :meth:`HMAC.hexdigest`), or a :term:`bytes-like object`." msgstr "" msgid "" diff --git a/library/html.entities.po b/library/html.entities.po index bc2d8c81dc..e3c125a0d6 100644 --- a/library/html.entities.po +++ b/library/html.entities.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,8 +30,9 @@ msgid "**Source code:** :source:`Lib/html/entities.py`" msgstr "**Kod źródłowy:** :source:`Lib/html/entities.py`" msgid "" -"This module defines four dictionaries, :data:`html5`, :data:" -"`name2codepoint`, :data:`codepoint2name`, and :data:`entitydefs`." +"This module defines four " +"dictionaries, :data:`html5`, :data:`name2codepoint`, :data:`codepoint2name`, " +"and :data:`entitydefs`." msgstr "" msgid "" @@ -39,8 +40,8 @@ msgid "" "equivalent Unicode character(s), e.g. ``html5['gt;'] == '>'``. Note that the " "trailing semicolon is included in the name (e.g. ``'gt;'``), however some of " "the names are accepted by the standard even without the semicolon: in this " -"case the name is present with and without the ``';'``. See also :func:`html." -"unescape`." +"case the name is present with and without the ``';'``. See " +"also :func:`html.unescape`." msgstr "" msgid "" diff --git a/library/html.parser.po b/library/html.parser.po index 7eb29f7e1f..e437269daa 100644 --- a/library/html.parser.po +++ b/library/html.parser.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -76,9 +76,9 @@ msgid "Example HTML Parser Application" msgstr "" msgid "" -"As a basic example, below is a simple HTML parser that uses the :class:" -"`HTMLParser` class to print out start tags, end tags, and data as they are " -"encountered:" +"As a basic example, below is a simple HTML parser that uses " +"the :class:`HTMLParser` class to print out start tags, end tags, and data as " +"they are encountered:" msgstr "" msgid "" @@ -125,8 +125,8 @@ msgstr "" msgid "" "Feed some text to the parser. It is processed insofar as it consists of " -"complete elements; incomplete data is buffered until more data is fed or :" -"meth:`close` is called. *data* must be :class:`str`." +"complete elements; incomplete data is buffered until more data is fed " +"or :meth:`close` is called. *data* must be :class:`str`." msgstr "" msgid "" @@ -154,8 +154,8 @@ msgstr "" msgid "" "The following methods are called when data or markup elements are " "encountered and they are meant to be overridden in a subclass. The base " -"class implementations do nothing (except for :meth:`~HTMLParser." -"handle_startendtag`):" +"class implementations do nothing (except " +"for :meth:`~HTMLParser.handle_startendtag`):" msgstr "" msgid "" @@ -174,8 +174,8 @@ msgstr "" msgid "" "For instance, for the tag ````, this method " -"would be called as ``handle_starttag('a', [('href', 'https://www.cwi." -"nl/')])``." +"would be called as ``handle_starttag('a', [('href', 'https://" +"www.cwi.nl/')])``." msgstr "" msgid "" @@ -194,8 +194,8 @@ msgid "" "Similar to :meth:`handle_starttag`, but called when the parser encounters an " "XHTML-style empty tag (````). This method may be overridden by " "subclasses which require this particular lexical information; the default " -"implementation simply calls :meth:`handle_starttag` and :meth:" -"`handle_endtag`." +"implementation simply calls :meth:`handle_starttag` " +"and :meth:`handle_endtag`." msgstr "" msgid "" @@ -318,8 +318,8 @@ msgstr "" msgid "" ">>> parser.feed('')\n" -"Decl : DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://www.w3." -"org/TR/html4/strict.dtd\"" +"Decl : DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://" +"www.w3.org/TR/html4/strict.dtd\"" msgstr "" msgid "Parsing an element with a few attributes and a title:" @@ -402,8 +402,8 @@ msgid "" msgstr "" msgid "" -"Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, but :meth:" -"`~HTMLParser.handle_data` might be called more than once if " +"Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, " +"but :meth:`~HTMLParser.handle_data` might be called more than once if " "*convert_charrefs* is false:" msgstr "" diff --git a/library/html.po b/library/html.po index 0ef6204c57..9d185dd6f0 100644 --- a/library/html.po +++ b/library/html.po @@ -41,11 +41,11 @@ msgid "" msgstr "" msgid "" -"Convert all named and numeric character references (e.g. ``>``, ``>" -"``, ``>``) in the string *s* to the corresponding Unicode characters. " -"This function uses the rules defined by the HTML 5 standard for both valid " -"and invalid character references, and the :data:`list of HTML 5 named " -"character references `." +"Convert all named and numeric character references (e.g. ``>``, " +"``>``, ``>``) in the string *s* to the corresponding Unicode " +"characters. This function uses the rules defined by the HTML 5 standard for " +"both valid and invalid character references, and the :data:`list of HTML 5 " +"named character references `." msgstr "" msgid "Submodules in the ``html`` package are:" diff --git a/library/http.client.po b/library/http.client.po index 8ab4d102e7..6d6be05f7b 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,8 +31,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/http/client.py`" msgid "" "This module defines classes that implement the client side of the HTTP and " -"HTTPS protocols. It is normally not used directly --- the module :mod:" -"`urllib.request` uses it to handle URLs that use HTTP and HTTPS." +"HTTPS protocols. It is normally not used directly --- the " +"module :mod:`urllib.request` uses it to handle URLs that use HTTP and HTTPS." msgstr "" msgid "" @@ -106,8 +106,8 @@ msgid "*source_address*, *context* and *check_hostname* were added." msgstr "" msgid "" -"This class now supports HTTPS virtual hosts if possible (that is, if :const:" -"`ssl.HAS_SNI` is true)." +"This class now supports HTTPS virtual hosts if possible (that is, " +"if :const:`ssl.HAS_SNI` is true)." msgstr "" msgid "" @@ -117,8 +117,8 @@ msgstr "" msgid "" "This class now performs all the necessary certificate and hostname checks by " -"default. To revert to the previous, unverified, behavior :func:`!ssl." -"_create_unverified_context` can be passed to the *context* parameter." +"default. To revert to the previous, unverified, behavior :func:`!" +"ssl._create_unverified_context` can be passed to the *context* parameter." msgstr "" msgid "" @@ -129,8 +129,8 @@ msgstr "" msgid "" "This class now sends an ALPN extension with protocol indicator ``http/1.1`` " -"when no *context* is given. Custom *context* should set ALPN protocols with :" -"meth:`~ssl.SSLContext.set_alpn_protocols`." +"when no *context* is given. Custom *context* should set ALPN protocols " +"with :meth:`~ssl.SSLContext.set_alpn_protocols`." msgstr "" msgid "" @@ -159,9 +159,10 @@ msgstr "" msgid "" "This function returns an instance of :class:`http.client.HTTPMessage` that " -"holds the header fields, but no payload (the same as :attr:`HTTPResponse." -"msg` and :attr:`http.server.BaseHTTPRequestHandler.headers`). After " -"returning, the file pointer *fp* is ready to read the HTTP body." +"holds the header fields, but no payload (the same " +"as :attr:`HTTPResponse.msg` " +"and :attr:`http.server.BaseHTTPRequestHandler.headers`). After returning, " +"the file pointer *fp* is ready to read the HTTP body." msgstr "" msgid "" @@ -175,8 +176,8 @@ msgid "The following exceptions are raised as appropriate:" msgstr "" msgid "" -"The base class of the other exceptions in this module. It is a subclass of :" -"exc:`Exception`." +"The base class of the other exceptions in this module. It is a subclass " +"of :exc:`Exception`." msgstr "" msgid "A subclass of :exc:`HTTPException`." @@ -247,16 +248,16 @@ msgstr "" msgid "" "If *body* is specified, the specified data is sent after the headers are " -"finished. It may be a :class:`str`, a :term:`bytes-like object`, an open :" -"term:`file object`, or an iterable of :class:`bytes`. If *body* is a " +"finished. It may be a :class:`str`, a :term:`bytes-like object`, an " +"open :term:`file object`, or an iterable of :class:`bytes`. If *body* is a " "string, it is encoded as ISO-8859-1, the default for HTTP. If it is a bytes-" "like object, the bytes are sent as is. If it is a :term:`file object`, the " "contents of the file is sent; this file object should support at least the " -"``read()`` method. If the file object is an instance of :class:`io." -"TextIOBase`, the data returned by the ``read()`` method will be encoded as " -"ISO-8859-1, otherwise the data returned by ``read()`` is sent as is. If " -"*body* is an iterable, the elements of the iterable are sent as is until the " -"iterable is exhausted." +"``read()`` method. If the file object is an instance " +"of :class:`io.TextIOBase`, the data returned by the ``read()`` method will " +"be encoded as ISO-8859-1, otherwise the data returned by ``read()`` is sent " +"as is. If *body* is an iterable, the elements of the iterable are sent as " +"is until the iterable is :term:`exhausted`." msgstr "" msgid "" @@ -308,9 +309,9 @@ msgid "" msgstr "" msgid "" -"Note that you must have read the whole response or call :meth:`close` if :" -"meth:`getresponse` raised an non-:exc:`ConnectionError` exception before you " -"can send a new request to the server." +"Note that you must have read the whole response or call :meth:`close` " +"if :meth:`getresponse` raised an non-:exc:`ConnectionError` exception before " +"you can send a new request to the server." msgstr "" msgid "*body* can now be an iterable." @@ -329,9 +330,9 @@ msgid "" msgstr "" msgid "" -"If a :exc:`ConnectionError` or subclass is raised, the :class:" -"`HTTPConnection` object will be ready to reconnect when a new request is " -"sent." +"If a :exc:`ConnectionError` or subclass is raised, " +"the :class:`HTTPConnection` object will be ready to reconnect when a new " +"request is sent." msgstr "" msgid "" @@ -360,7 +361,8 @@ msgstr "" msgid "" "The *headers* argument should be a mapping of extra HTTP headers to send " -"with the CONNECT request." +"with the CONNECT request. Non-string header values are converted to strings " +"via :func:`str`." msgstr "" msgid "" @@ -455,11 +457,11 @@ msgid "" "*message_body* will be chunk-encoded as specified in :rfc:`7230`, Section " "3.3.1. How the data is encoded is dependent on the type of *message_body*. " "If *message_body* implements the :ref:`buffer interface ` the " -"encoding will result in a single chunk. If *message_body* is a :class:" -"`collections.abc.Iterable`, each iteration of *message_body* will result in " -"a chunk. If *message_body* is a :term:`file object`, each call to ``." -"read()`` will result in a chunk. The method automatically signals the end of " -"the chunk-encoded data immediately after *message_body*." +"encoding will result in a single chunk. If *message_body* is " +"a :class:`collections.abc.Iterable`, each iteration of *message_body* will " +"result in a chunk. If *message_body* is a :term:`file object`, each call to " +"``.read()`` will result in a chunk. The method automatically signals the end " +"of the chunk-encoded data immediately after *message_body*." msgstr "" msgid "" @@ -473,8 +475,9 @@ msgid "Added chunked encoding support and the *encode_chunked* parameter." msgstr "" msgid "" -"Send data to the server. This should be used directly only after the :meth:" -"`endheaders` method has been called and before :meth:`getresponse` is called." +"Send data to the server. This should be used directly only after " +"the :meth:`endheaders` method has been called and before :meth:`getresponse` " +"is called." msgstr "" msgid "" @@ -519,8 +522,8 @@ msgstr "" msgid "" "A :class:`http.client.HTTPMessage` instance containing the response " -"headers. :class:`http.client.HTTPMessage` is a subclass of :class:`email." -"message.Message`." +"headers. :class:`http.client.HTTPMessage` is a subclass " +"of :class:`email.message.Message`." msgstr "" msgid "" @@ -533,8 +536,8 @@ msgid "" msgstr "" msgid "" -"Headers of the response in the form of an :class:`email.message." -"EmailMessage` instance." +"Headers of the response in the form of " +"an :class:`email.message.EmailMessage` instance." msgstr "" msgid "Status code returned by server." @@ -626,8 +629,8 @@ msgid "" "302 Found\n" ">>> data = response.read()\n" ">>> data\n" -"b'Redirecting to https://bugs." -"python.org/issue12524'\n" +"b'Redirecting to https://" +"bugs.python.org/issue12524'\n" ">>> conn.close()" msgstr "" diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po index 4297a39121..23b85415b5 100644 --- a/library/http.cookiejar.po +++ b/library/http.cookiejar.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,11 +38,11 @@ msgid "" msgstr "" msgid "" -"Both the regular Netscape cookie protocol and the protocol defined by :rfc:" -"`2965` are handled. RFC 2965 handling is switched off by default. :rfc:" -"`2109` cookies are parsed as Netscape cookies and subsequently treated " -"either as Netscape or RFC 2965 cookies according to the 'policy' in effect. " -"Note that the great majority of cookies on the internet are Netscape " +"Both the regular Netscape cookie protocol and the protocol defined " +"by :rfc:`2965` are handled. RFC 2965 handling is switched off by " +"default. :rfc:`2109` cookies are parsed as Netscape cookies and subsequently " +"treated either as Netscape or RFC 2965 cookies according to the 'policy' in " +"effect. Note that the great majority of cookies on the internet are Netscape " "cookies. :mod:`!http.cookiejar` attempts to follow the de-facto Netscape " "cookie protocol (which differs substantially from that set out in the " "original Netscape specification), including taking note of the ``max-age`` " @@ -50,11 +50,11 @@ msgid "" msgstr "" msgid "" -"The various named parameters found in :mailheader:`Set-Cookie` and :" -"mailheader:`Set-Cookie2` headers (eg. ``domain`` and ``expires``) are " -"conventionally referred to as :dfn:`attributes`. To distinguish them from " -"Python attributes, the documentation for this module uses the term :dfn:" -"`cookie-attribute` instead." +"The various named parameters found in :mailheader:`Set-Cookie` " +"and :mailheader:`Set-Cookie2` headers (for example, ``domain`` and " +"``expires``) are conventionally referred to as :dfn:`attributes`. To " +"distinguish them from Python attributes, the documentation for this module " +"uses the term :dfn:`cookie-attribute` instead." msgstr "" msgid "The module defines the following exception:" @@ -111,31 +111,31 @@ msgstr "" msgid "" "Constructor arguments should be passed as keyword arguments only. " "*blocked_domains* is a sequence of domain names that we never accept cookies " -"from, nor return cookies to. *allowed_domains* if not :const:`None`, this is " -"a sequence of the only domains for which we accept and return cookies. " +"from, nor return cookies to. *allowed_domains* if not ``None``, this is a " +"sequence of the only domains for which we accept and return cookies. " "*secure_protocols* is a sequence of protocols for which secure cookies can " "be added to. By default *https* and *wss* (secure websocket) are considered " -"secure protocols. For all other arguments, see the documentation for :class:" -"`CookiePolicy` and :class:`DefaultCookiePolicy` objects." +"secure protocols. For all other arguments, see the documentation " +"for :class:`CookiePolicy` and :class:`DefaultCookiePolicy` objects." msgstr "" msgid "" ":class:`DefaultCookiePolicy` implements the standard accept / reject rules " -"for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (ie. " -"cookies received in a :mailheader:`Set-Cookie` header with a version cookie-" -"attribute of 1) are treated according to the RFC 2965 rules. However, if " -"RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` is ``True``, " -"RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` instance to " -"Netscape cookies, by setting the :attr:`version` attribute of the :class:" -"`Cookie` instance to 0. :class:`DefaultCookiePolicy` also provides some " -"parameters to allow some fine-tuning of policy." +"for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (that " +"is, cookies received in a :mailheader:`Set-Cookie` header with a version " +"cookie-attribute of 1) are treated according to the RFC 2965 rules. " +"However, if RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` " +"is ``True``, RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` " +"instance to Netscape cookies, by setting the :attr:`~Cookie.version` " +"attribute of the :class:`Cookie` instance to 0. :class:`DefaultCookiePolicy` " +"also provides some parameters to allow some fine-tuning of policy." msgstr "" msgid "" "This class represents Netscape, :rfc:`2109` and :rfc:`2965` cookies. It is " -"not expected that users of :mod:`!http.cookiejar` construct their own :class:" -"`Cookie` instances. Instead, if necessary, call :meth:`make_cookies` on a :" -"class:`CookieJar` instance." +"not expected that users of :mod:`!http.cookiejar` construct their " +"own :class:`Cookie` instances. Instead, if necessary, " +"call :meth:`~CookieJar.make_cookies` on a :class:`CookieJar` instance." msgstr "" msgid "Module :mod:`urllib.request`" @@ -185,7 +185,7 @@ msgstr "" msgid ":rfc:`2964` - Use of HTTP State Management" msgstr "" -msgid "CookieJar and FileCookieJar Objects" +msgid "CookieJar and FileCookieJar objects" msgstr "" msgid "" @@ -200,49 +200,56 @@ msgid "Add correct :mailheader:`Cookie` header to *request*." msgstr "" msgid "" -"If policy allows (ie. the :attr:`rfc2965` and :attr:`hide_cookie2` " -"attributes of the :class:`CookieJar`'s :class:`CookiePolicy` instance are " -"true and false respectively), the :mailheader:`Cookie2` header is also added " -"when appropriate." +"If policy allows (that is, the :attr:`~CookiePolicy.rfc2965` " +"and :attr:`~CookiePolicy.hide_cookie2` attributes of " +"the :class:`CookieJar`'s :class:`CookiePolicy` instance are true and false " +"respectively), the :mailheader:`Cookie2` header is also added when " +"appropriate." msgstr "" msgid "" "The *request* object (usually a :class:`urllib.request.Request` instance) " -"must support the methods :meth:`get_full_url`, :meth:`has_header`, :meth:" -"`get_header`, :meth:`header_items`, :meth:`add_unredirected_header` and the " -"attributes :attr:`host`, :attr:`!type`, :attr:`unverifiable` and :attr:" -"`origin_req_host` as documented by :mod:`urllib.request`." +"must support the " +"methods :meth:`~urllib.request.Request.get_full_url`, :meth:`~urllib.request.Request.has_header`, :meth:`~urllib.request.Request.get_header`, :meth:`~urllib.request.Request.header_items`, :meth:`~urllib.request.Request.add_unredirected_header` " +"and the " +"attributes :attr:`~urllib.request.Request.host`, :attr:`~urllib.request.Request.type`, :attr:`~urllib.request.Request.unverifiable` " +"and :attr:`~urllib.request.Request.origin_req_host` as documented " +"by :mod:`urllib.request`." msgstr "" msgid "" -"*request* object needs :attr:`origin_req_host` attribute. Dependency on a " -"deprecated method :meth:`get_origin_req_host` has been removed." +"*request* object needs :attr:`~urllib.request.Request.origin_req_host` " +"attribute. Dependency on a deprecated method :meth:`!get_origin_req_host` " +"has been removed." msgstr "" msgid "" -"Extract cookies from HTTP *response* and store them in the :class:" -"`CookieJar`, where allowed by policy." +"Extract cookies from HTTP *response* and store them in " +"the :class:`CookieJar`, where allowed by policy." msgstr "" msgid "" -"The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` and :" -"mailheader:`Set-Cookie2` headers in the *response* argument, and store " +"The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` " +"and :mailheader:`Set-Cookie2` headers in the *response* argument, and store " "cookies as appropriate (subject to the :meth:`CookiePolicy.set_ok` method's " "approval)." msgstr "" msgid "" -"The *response* object (usually the result of a call to :meth:`urllib.request." -"urlopen`, or similar) should support an :meth:`info` method, which returns " +"The *response* object (usually the result of a call " +"to :meth:`urllib.request.urlopen`, or similar) should support " +"an :meth:`~http.client.HTTPResponse.info` method, which returns " "an :class:`email.message.Message` instance." msgstr "" msgid "" "The *request* object (usually a :class:`urllib.request.Request` instance) " -"must support the method :meth:`get_full_url` and the attributes :attr:" -"`host`, :attr:`unverifiable` and :attr:`origin_req_host`, as documented by :" -"mod:`urllib.request`. The request is used to set default values for cookie-" -"attributes as well as for checking that the cookie is allowed to be set." +"must support the method :meth:`~urllib.request.Request.get_full_url` and the " +"attributes :attr:`~urllib.request.Request.host`, :attr:`~urllib.request.Request.unverifiable` " +"and :attr:`~urllib.request.Request.origin_req_host`, as documented " +"by :mod:`urllib.request`. The request is used to set default values for " +"cookie-attributes as well as for checking that the cookie is allowed to be " +"set." msgstr "" msgid "Set the :class:`CookiePolicy` instance to be used." @@ -283,16 +290,16 @@ msgid "Discard all session cookies." msgstr "" msgid "" -"Discards all contained cookies that have a true :attr:`discard` attribute " -"(usually because they had either no ``max-age`` or ``expires`` cookie-" -"attribute, or an explicit ``discard`` cookie-attribute). For interactive " -"browsers, the end of a session usually corresponds to closing the browser " -"window." +"Discards all contained cookies that have a true :attr:`~Cookie.discard` " +"attribute (usually because they had either no ``max-age`` or ``expires`` " +"cookie-attribute, or an explicit ``discard`` cookie-attribute). For " +"interactive browsers, the end of a session usually corresponds to closing " +"the browser window." msgstr "" msgid "" -"Note that the :meth:`save` method won't save session cookies anyway, unless " -"you ask otherwise by passing a true *ignore_discard* argument." +"Note that the :meth:`~FileCookieJar.save` method won't save session cookies " +"anyway, unless you ask otherwise by passing a true *ignore_discard* argument." msgstr "" msgid ":class:`FileCookieJar` implements the following additional methods:" @@ -308,9 +315,10 @@ msgstr "" msgid "" "*filename* is the name of file in which to save cookies. If *filename* is " -"not specified, :attr:`self.filename` is used (whose default is the value " -"passed to the constructor, if any); if :attr:`self.filename` is :const:" -"`None`, :exc:`ValueError` is raised." +"not specified, :attr:`self.filename ` is used (whose " +"default is the value passed to the constructor, if any); " +"if :attr:`self.filename ` is " +"``None``, :exc:`ValueError` is raised." msgstr "" msgid "" @@ -320,8 +328,8 @@ msgstr "" msgid "" "The file is overwritten if it already exists, thus wiping all the cookies it " -"contains. Saved cookies can be restored later using the :meth:`load` or :" -"meth:`revert` methods." +"contains. Saved cookies can be restored later using the :meth:`load` " +"or :meth:`revert` methods." msgstr "" msgid "Load cookies from a file." @@ -334,9 +342,9 @@ msgid "Arguments are as for :meth:`save`." msgstr "" msgid "" -"The named file must be in the format understood by the class, or :exc:" -"`LoadError` will be raised. Also, :exc:`OSError` may be raised, for example " -"if the file does not exist." +"The named file must be in the format understood by the class, " +"or :exc:`LoadError` will be raised. Also, :exc:`OSError` may be raised, for " +"example if the file does not exist." msgstr "" msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." @@ -403,7 +411,7 @@ msgid "" "file." msgstr "" -msgid "CookiePolicy Objects" +msgid "CookiePolicy objects" msgstr "" msgid "" @@ -418,8 +426,8 @@ msgstr "" msgid "" "*cookie* is a :class:`Cookie` instance. *request* is an object implementing " -"the interface defined by the documentation for :meth:`CookieJar." -"extract_cookies`." +"the interface defined by the documentation " +"for :meth:`CookieJar.extract_cookies`." msgstr "" msgid "" @@ -428,8 +436,8 @@ msgstr "" msgid "" "*cookie* is a :class:`Cookie` instance. *request* is an object implementing " -"the interface defined by the documentation for :meth:`CookieJar." -"add_cookie_header`." +"the interface defined by the documentation " +"for :meth:`CookieJar.add_cookie_header`." msgstr "" msgid "" @@ -444,12 +452,13 @@ msgid "" msgstr "" msgid "" -"If :meth:`domain_return_ok` returns true for the cookie domain, :meth:" -"`path_return_ok` is called for the cookie path. Otherwise, :meth:" -"`path_return_ok` and :meth:`return_ok` are never called for that cookie " -"domain. If :meth:`path_return_ok` returns true, :meth:`return_ok` is called " -"with the :class:`Cookie` object itself for a full check. Otherwise, :meth:" -"`return_ok` is never called for that cookie path." +"If :meth:`domain_return_ok` returns true for the cookie " +"domain, :meth:`path_return_ok` is called for the cookie path. " +"Otherwise, :meth:`path_return_ok` and :meth:`return_ok` are never called for " +"that cookie domain. If :meth:`path_return_ok` returns " +"true, :meth:`return_ok` is called with the :class:`Cookie` object itself for " +"a full check. Otherwise, :meth:`return_ok` is never called for that cookie " +"path." msgstr "" msgid "" @@ -469,10 +478,10 @@ msgid "See the documentation for :meth:`domain_return_ok`." msgstr "" msgid "" -"In addition to implementing the methods above, implementations of the :class:" -"`CookiePolicy` interface must also supply the following attributes, " -"indicating which protocols should be used, and how. All of these attributes " -"may be assigned to." +"In addition to implementing the methods above, implementations of " +"the :class:`CookiePolicy` interface must also supply the following " +"attributes, indicating which protocols should be used, and how. All of " +"these attributes may be assigned to." msgstr "" msgid "Implement Netscape protocol." @@ -494,7 +503,7 @@ msgid "" "to be useful)." msgstr "" -msgid "DefaultCookiePolicy Objects" +msgid "DefaultCookiePolicy objects" msgstr "" msgid "Implements the standard rules for accepting and returning cookies." @@ -535,10 +544,11 @@ msgid "" "A domain blocklist and allowlist is provided (both off by default). Only " "domains not in the blocklist and present in the allowlist (if the allowlist " "is active) participate in cookie setting and returning. Use the " -"*blocked_domains* constructor argument, and :meth:`blocked_domains` and :" -"meth:`set_blocked_domains` methods (and the corresponding argument and " -"methods for *allowed_domains*). If you set an allowlist, you can turn it " -"off again by setting it to :const:`None`." +"*blocked_domains* constructor argument, " +"and :meth:`~DefaultCookiePolicy.blocked_domains` " +"and :meth:`~DefaultCookiePolicy.set_blocked_domains` methods (and the " +"corresponding argument and methods for *allowed_domains*). If you set an " +"allowlist, you can turn it off again by setting it to ``None``." msgstr "" msgid "" @@ -546,11 +556,12 @@ msgid "" "cookie domain to be matched. For example, ``\"example.com\"`` matches a " "blocklist entry of ``\"example.com\"``, but ``\"www.example.com\"`` does " "not. Domains that do start with a dot are matched by more specific domains " -"too. For example, both ``\"www.example.com\"`` and ``\"www.coyote.example." -"com\"`` match ``\".example.com\"`` (but ``\"example.com\"`` itself does " -"not). IP addresses are an exception, and must match exactly. For example, " -"if blocked_domains contains ``\"192.168.1.2\"`` and ``\".168.1.2\"``, " -"192.168.1.2 is blocked, but 193.168.1.2 is not." +"too. For example, both ``\"www.example.com\"`` and " +"``\"www.coyote.example.com\"`` match ``\".example.com\"`` (but " +"``\"example.com\"`` itself does not). IP addresses are an exception, and " +"must match exactly. For example, if blocked_domains contains " +"``\"192.168.1.2\"`` and ``\".168.1.2\"``, 192.168.1.2 is blocked, but " +"193.168.1.2 is not." msgstr "" msgid "" @@ -568,10 +579,10 @@ msgid "" "cookies." msgstr "" -msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)." +msgid "Return ``None``, or the sequence of allowed domains (as a tuple)." msgstr "" -msgid "Set the sequence of allowed domains, or :const:`None`." +msgid "Set the sequence of allowed domains, or ``None``." msgstr "" msgid "" @@ -587,12 +598,12 @@ msgstr "" msgid "" "If true, request that the :class:`CookieJar` instance downgrade :rfc:`2109` " -"cookies (ie. cookies received in a :mailheader:`Set-Cookie` header with a " -"version cookie-attribute of 1) to Netscape cookies by setting the version " -"attribute of the :class:`Cookie` instance to 0. The default value is :const:" -"`None`, in which case RFC 2109 cookies are downgraded if and only if :rfc:" -"`2965` handling is turned off. Therefore, RFC 2109 cookies are downgraded " -"by default." +"cookies (that is, cookies received in a :mailheader:`Set-Cookie` header with " +"a version cookie-attribute of 1) to Netscape cookies by setting the version " +"attribute of the :class:`Cookie` instance to 0. The default value is " +"``None``, in which case RFC 2109 cookies are downgraded if and only " +"if :rfc:`2965` handling is turned off. Therefore, RFC 2109 cookies are " +"downgraded by default." msgstr "" msgid "General strictness switches:" @@ -641,16 +652,16 @@ msgid "" msgstr "" msgid "" -"When setting cookies, the 'host prefix' must not contain a dot (eg. ``www." -"foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` " +"When setting cookies, the 'host prefix' must not contain a dot (for example, " +"``www.foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` " "contains a dot)." msgstr "" msgid "" "Cookies that did not explicitly specify a ``domain`` cookie-attribute can " -"only be returned to a domain equal to the domain that set the cookie (eg. " -"``spam.example.com`` won't be returned cookies from ``example.com`` that had " -"no ``domain`` cookie-attribute)." +"only be returned to a domain equal to the domain that set the cookie (for " +"example, ``spam.example.com`` won't be returned cookies from ``example.com`` " +"that had no ``domain`` cookie-attribute)." msgstr "" msgid "When setting cookies, require a full :rfc:`2965` domain-match." @@ -662,14 +673,14 @@ msgid "" msgstr "" msgid "" -"Equivalent to 0 (ie. all of the above Netscape domain strictness flags " +"Equivalent to 0 (that is, all of the above Netscape domain strictness flags " "switched off)." msgstr "" msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``." msgstr "" -msgid "Cookie Objects" +msgid "Cookie objects" msgstr "" msgid "" @@ -689,52 +700,52 @@ msgid "" msgstr "" msgid "" -"Integer or :const:`None`. Netscape cookies have :attr:`version` 0. :rfc:" -"`2965` and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. " -"However, note that :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies " -"to Netscape cookies, in which case :attr:`version` is 0." +"Integer or ``None``. Netscape cookies have :attr:`version` 0. :rfc:`2965` " +"and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. However, " +"note that :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies to " +"Netscape cookies, in which case :attr:`version` is 0." msgstr "" msgid "Cookie name (a string)." msgstr "" -msgid "Cookie value (a string), or :const:`None`." +msgid "Cookie value (a string), or ``None``." msgstr "" msgid "" -"String representing a port or a set of ports (eg. '80', or '80,8080'), or :" -"const:`None`." +"String representing a port or a set of ports (for example, '80', or " +"'80,8080'), or ``None``." msgstr "" msgid "Cookie domain (a string)." msgstr "" -msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." +msgid "Cookie path (a string, for example, ``'/acme/rocket_launchers'``)." msgstr "" msgid "``True`` if cookie should only be returned over a secure connection." msgstr "" msgid "" -"Integer expiry date in seconds since epoch, or :const:`None`. See also the :" -"meth:`is_expired` method." +"Integer expiry date in seconds since epoch, or ``None``. See also " +"the :meth:`is_expired` method." msgstr "" msgid "``True`` if this is a session cookie." msgstr "" msgid "" -"String comment from the server explaining the function of this cookie, or :" -"const:`None`." +"String comment from the server explaining the function of this cookie, or " +"``None``." msgstr "" msgid "" "URL linking to a comment from the server explaining the function of this " -"cookie, or :const:`None`." +"cookie, or ``None``." msgstr "" msgid "" -"``True`` if this cookie was received as an :rfc:`2109` cookie (ie. the " +"``True`` if this cookie was received as an :rfc:`2109` cookie (that is, the " "cookie arrived in a :mailheader:`Set-Cookie` header, and the value of the " "Version cookie-attribute in that header was 1). This attribute is provided " "because :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape " @@ -789,8 +800,8 @@ msgstr "" msgid "" "import http.cookiejar, urllib.request\n" "cj = http.cookiejar.CookieJar()\n" -"opener = urllib.request.build_opener(urllib.request." -"HTTPCookieProcessor(cj))\n" +"opener = " +"urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))\n" "r = opener.open(\"http://example.com/\")" msgstr "" @@ -803,10 +814,10 @@ msgstr "" msgid "" "import os, http.cookiejar, urllib.request\n" "cj = http.cookiejar.MozillaCookieJar()\n" -"cj.load(os.path.join(os.path.expanduser(\"~\"), \".netscape\", \"cookies." -"txt\"))\n" -"opener = urllib.request.build_opener(urllib.request." -"HTTPCookieProcessor(cj))\n" +"cj.load(os.path.join(os.path.expanduser(\"~\"), \".netscape\", " +"\"cookies.txt\"))\n" +"opener = " +"urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))\n" "r = opener.open(\"http://example.com/\")" msgstr "" @@ -824,7 +835,7 @@ msgid "" " rfc2965=True, strict_ns_domain=Policy.DomainStrict,\n" " blocked_domains=[\"ads.net\", \".ads.net\"])\n" "cj = CookieJar(policy)\n" -"opener = urllib.request.build_opener(urllib.request." -"HTTPCookieProcessor(cj))\n" +"opener = " +"urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))\n" "r = opener.open(\"http://example.com/\")" msgstr "" diff --git a/library/http.cookies.po b/library/http.cookies.po index 6ad6e55402..04dddf0d82 100644 --- a/library/http.cookies.po +++ b/library/http.cookies.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -37,12 +37,12 @@ msgid "" msgstr "" msgid "" -"The module formerly strictly applied the parsing rules described in the :rfc:" -"`2109` and :rfc:`2068` specifications. It has since been discovered that " -"MSIE 3.0x didn't follow the character rules outlined in those specs; many " -"current-day browsers and servers have also relaxed parsing rules when it " -"comes to cookie handling. As a result, this module now uses parsing rules " -"that are a bit less strict than they once were." +"The module formerly strictly applied the parsing rules described in " +"the :rfc:`2109` and :rfc:`2068` specifications. It has since been " +"discovered that MSIE 3.0x didn't follow the character rules outlined in " +"those specs; many current-day browsers and servers have also relaxed parsing " +"rules when it comes to cookie handling. As a result, this module now uses " +"parsing rules that are a bit less strict than they once were." msgstr "" msgid "" @@ -76,19 +76,20 @@ msgid "If *input* is given, it is passed to the :meth:`load` method." msgstr "" msgid "" -"This class derives from :class:`BaseCookie` and overrides :meth:`~BaseCookie." -"value_decode` and :meth:`~BaseCookie.value_encode`. :class:`!SimpleCookie` " -"supports strings as cookie values. When setting the value, :class:`!" -"SimpleCookie` calls the builtin :func:`str` to convert the value to a " -"string. Values received from HTTP are kept as strings." +"This class derives from :class:`BaseCookie` and " +"overrides :meth:`~BaseCookie.value_decode` " +"and :meth:`~BaseCookie.value_encode`. :class:`!SimpleCookie` supports " +"strings as cookie values. When setting the value, :class:`!SimpleCookie` " +"calls the builtin :func:`str` to convert the value to a string. Values " +"received from HTTP are kept as strings." msgstr "" msgid "Module :mod:`http.cookiejar`" msgstr "" msgid "" -"HTTP cookie handling for web *clients*. The :mod:`http.cookiejar` and :mod:" -"`!http.cookies` modules do not depend on each other." +"HTTP cookie handling for web *clients*. The :mod:`http.cookiejar` " +"and :mod:`!http.cookies` modules do not depend on each other." msgstr "" msgid ":rfc:`2109` - HTTP State Management Mechanism" @@ -102,8 +103,8 @@ msgstr "" msgid "" "Return a tuple ``(real_value, coded_value)`` from a string representation. " -"``real_value`` can be any type. This method does no decoding in :class:" -"`BaseCookie` --- it exists so it can be overridden." +"``real_value`` can be any type. This method does no decoding " +"in :class:`BaseCookie` --- it exists so it can be overridden." msgstr "" msgid "" @@ -113,8 +114,8 @@ msgid "" msgstr "" msgid "" -"In general, it should be the case that :meth:`value_encode` and :meth:" -"`value_decode` are inverses on the range of *value_decode*." +"In general, it should be the case that :meth:`value_encode` " +"and :meth:`value_decode` are inverses on the range of *value_decode*." msgstr "" msgid "" @@ -192,8 +193,9 @@ msgid "" msgstr "" msgid "" -"Attributes :attr:`~Morsel.key`, :attr:`~Morsel.value` and :attr:`~Morsel." -"coded_value` are read-only. Use :meth:`~Morsel.set` for setting them." +"Attributes :attr:`~Morsel.key`, :attr:`~Morsel.value` " +"and :attr:`~Morsel.coded_value` are read-only. Use :meth:`~Morsel.set` for " +"setting them." msgstr "" msgid "Added support for the :attr:`samesite` attribute." diff --git a/library/http.po b/library/http.po index 3624d98dc5..ff2d21987b 100644 --- a/library/http.po +++ b/library/http.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,8 +40,8 @@ msgid "" msgstr "" msgid "" -":mod:`http.server` contains basic HTTP server classes based on :mod:" -"`socketserver`" +":mod:`http.server` contains basic HTTP server classes based " +"on :mod:`socketserver`" msgstr "" msgid "" @@ -86,8 +86,8 @@ msgstr "" msgid "" "Supported, `IANA-registered status codes `_ available in :class:`http." -"HTTPStatus` are:" +"http-status-codes/http-status-codes.xhtml>`_ available " +"in :class:`http.HTTPStatus` are:" msgstr "" msgid "Code" diff --git a/library/http.server.po b/library/http.server.po index ccb47b6798..72d4c526aa 100644 --- a/library/http.server.po +++ b/library/http.server.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,8 +34,8 @@ msgid "This module defines classes for implementing HTTP servers." msgstr "" msgid "" -":mod:`!http.server` is not recommended for production. It only implements :" -"ref:`basic security checks `." +":mod:`!http.server` is not recommended for production. It only " +"implements :ref:`basic security checks `." msgstr "" msgid "Availability" @@ -60,9 +61,16 @@ msgstr "" msgid "" "This class builds on the :class:`~socketserver.TCPServer` class by storing " -"the server address as instance variables named :attr:`server_name` and :attr:" -"`server_port`. The server is accessible by the handler, typically through " -"the handler's :attr:`server` instance variable." +"the server address as instance variables named :attr:`server_name` " +"and :attr:`server_port`. The server is accessible by the handler, typically " +"through the handler's :attr:`~socketserver.BaseRequestHandler.server` " +"instance variable." +msgstr "" + +msgid "The HTTP server's fully qualified domain name." +msgstr "" + +msgid "The HTTP server's port number obtained from *server_address*." msgstr "" msgid "" @@ -80,7 +88,7 @@ msgstr "" msgid "" "The *certfile* argument is the path to the SSL certificate chain file, and " -"the *keyfile* is the path to file containing the private key." +"the *keyfile* is the path to the file containing the private key." msgstr "" msgid "" @@ -153,18 +161,18 @@ msgstr "" msgid "" "Contains the string representation of the HTTP request line. The terminating " -"CRLF is stripped. This attribute should be set by :meth:" -"`handle_one_request`. If no valid request line was processed, it should be " -"set to the empty string." +"CRLF is stripped. This attribute should be set " +"by :meth:`handle_one_request`. If no valid request line was processed, it " +"should be set to the empty string." msgstr "" msgid "Contains the command (request type). For example, ``'GET'``." msgstr "" msgid "" -"Contains the request path. If query component of the URL is present, then " -"``path`` includes the query. Using the terminology of :rfc:`3986`, ``path`` " -"here includes ``hier-part`` and the ``query``." +"Contains the request path. If the query component of the URL is present, " +"then ``path`` includes the query. Using the terminology of :rfc:`3986`, " +"``path`` here includes ``hier-part`` and the ``query``." msgstr "" msgid "" @@ -203,15 +211,15 @@ msgid "" msgstr "" msgid "" -"Contains the Python system version, in a form usable by the :attr:" -"`version_string` method and the :attr:`server_version` class variable. For " -"example, ``'Python/1.4'``." +"Contains the Python system version, in a form usable by " +"the :attr:`version_string` method and the :attr:`server_version` class " +"variable. For example, ``'Python/1.4'``." msgstr "" msgid "" "Specifies a format string that should be used by :meth:`send_error` method " "for building an error response to the client. The string is filled by " -"default with variables from :attr:`responses` based on the status code that " +"default with variables from :attr:`responses` based on the status code " "passed to :meth:`send_error`." msgstr "" @@ -232,8 +240,8 @@ msgstr "" msgid "" "Specifies an :class:`email.message.Message`\\ -like class to parse HTTP " -"headers. Typically, this is not overridden, and it defaults to :class:`http." -"client.HTTPMessage`." +"headers. Typically, this is not overridden, and it defaults " +"to :class:`http.client.HTTPMessage`." msgstr "" msgid "" @@ -260,10 +268,10 @@ msgstr "" msgid "" "When an HTTP/1.1 conformant server receives an ``Expect: 100-continue`` " -"request header it responds back with a ``100 Continue`` followed by ``200 " -"OK`` headers. This method can be overridden to raise an error if the server " -"does not want the client to continue. For example, the server can choose to " -"send ``417 Expectation Failed`` as a response header and ``return False``." +"request header it responds with a ``100 Continue`` followed by ``200 OK`` " +"headers. This method can be overridden to raise an error if the server does " +"not want the client to continue. For example, the server can choose to send " +"``417 Expectation Failed`` as a response header and ``return False``." msgstr "" msgid "" @@ -304,8 +312,8 @@ msgid "" "Adds the HTTP header to an internal buffer which will be written to the " "output stream when either :meth:`end_headers` or :meth:`flush_headers` is " "invoked. *keyword* should specify the header keyword, with *value* " -"specifying its value. Note that, after the send_header calls are done, :meth:" -"`end_headers` MUST BE called in order to complete the operation." +"specifying its value. Note that, after the send_header calls are " +"done, :meth:`end_headers` MUST BE called in order to complete the operation." msgstr "" msgid "This method does not reject input containing CRLF sequences." @@ -316,9 +324,9 @@ msgstr "" msgid "" "Sends the response header only, used for the purposes when ``100 Continue`` " -"response is sent by the server to the client. The headers not buffered and " -"sent directly the output stream.If the *message* is not specified, the HTTP " -"message corresponding the response *code* is sent." +"response is sent by the server to the client. The headers are not buffered " +"and sent directly the output stream. If the *message* is not specified, the " +"HTTP message corresponding the response *code* is sent." msgstr "" msgid "This method does not reject *message* containing CRLF sequences." @@ -352,14 +360,14 @@ msgstr "" msgid "" "Logs an arbitrary message to ``sys.stderr``. This is typically overridden to " "create custom error logging mechanisms. The *format* argument is a standard " -"printf-style format string, where the additional arguments to :meth:" -"`log_message` are applied as inputs to the formatting. The client ip address " -"and current date and time are prefixed to every message logged." +"printf-style format string, where the additional arguments " +"to :meth:`log_message` are applied as inputs to the formatting. The client " +"IP address and current date and time are prefixed to every message logged." msgstr "" msgid "" -"Returns the server software's version string. This is a combination of the :" -"attr:`server_version` and :attr:`sys_version` attributes." +"Returns the server software's version string. This is a combination of " +"the :attr:`server_version` and :attr:`sys_version` attributes." msgstr "" msgid "" @@ -395,14 +403,14 @@ msgid "The *directory* parameter accepts a :term:`path-like object`." msgstr "" msgid "" -"A lot of the work, such as parsing the request, is done by the base class :" -"class:`BaseHTTPRequestHandler`. This class implements the :func:`do_GET` " -"and :func:`do_HEAD` functions." +"A lot of the work, such as parsing the request, is done by the base " +"class :class:`BaseHTTPRequestHandler`. This class implements " +"the :func:`do_GET` and :func:`do_HEAD` functions." msgstr "" msgid "" -"The following are defined as class-level attributes of :class:" -"`SimpleHTTPRequestHandler`:" +"The following are defined as class-level attributes " +"of :class:`SimpleHTTPRequestHandler`:" msgstr "" msgid "" @@ -410,6 +418,12 @@ msgid "" "defined at the module level." msgstr "" +msgid "Specifies the filenames that are treated as directory index pages." +msgstr "" + +msgid "Defaults to ``(\"index.html\", \"index.htm\")``." +msgstr "" + msgid "" "A dictionary mapping suffixes into MIME types, contains custom overrides for " "the default system mappings. The mapping is used case-insensitively, and so " @@ -437,12 +451,12 @@ msgid "" msgstr "" msgid "" -"If the request was mapped to a directory, the directory is checked for a " -"file named ``index.html`` or ``index.htm`` (in that order). If found, the " -"file's contents are returned; otherwise a directory listing is generated by " -"calling the :meth:`list_directory` method. This method uses :func:`os." -"listdir` to scan the directory, and returns a ``404`` error response if the :" -"func:`~os.listdir` fails." +"If the request was mapped to a directory, the directory is checked for an " +"index page as specified by :attr:`index_pages`. If found, the file's " +"contents are returned; otherwise a directory listing is generated by calling " +"the :meth:`list_directory` method. This method uses :func:`os.listdir` to " +"scan the directory, and returns a ``404`` error response if " +"the :func:`~os.listdir` fails." msgstr "" msgid "" @@ -467,17 +481,42 @@ msgid "" msgstr "" msgid "" -"For example usage, see the implementation of the ``test`` function in :" -"source:`Lib/http/server.py`." +"For example usage, see the implementation of the ``test`` function " +"in :source:`Lib/http/server.py`." msgstr "" msgid "Support of the ``'If-Modified-Since'`` header." msgstr "" +msgid "Helper to list the contents of *path* when no index page is present." +msgstr "" + +msgid "" +"This returns either a :term:`file-like object` (which must be closed by the " +"caller) or ``None`` to indicate an error, in which case the caller has " +"nothing further to do. In either case, the headers are sent." +msgstr "" + +msgid "Guess the type of the file at the given *path*." +msgstr "" + +msgid "" +"This returns a string of the form ``type/subtype``, usable for a MIME " +"Content-type header." +msgstr "" + msgid "" -"The :class:`SimpleHTTPRequestHandler` class can be used in the following " -"manner in order to create a very basic webserver serving files relative to " -"the current directory::" +"The default implementation looks the file's extension up " +"in :attr:`extensions_map`, falling back to :func:`mimetypes.guess_file_type` " +"and then to ``'application/octet-stream'``." +msgstr "" + +msgid "Add :func:`mimetypes.guess_file_type` as a fallback." +msgstr "" + +msgid "" +"The :class:`SimpleHTTPRequestHandler` class can be used to create a very " +"basic webserver serving files relative to the current directory as follows::" msgstr "" msgid "" @@ -496,7 +535,7 @@ msgstr "" msgid "" ":class:`SimpleHTTPRequestHandler` can also be subclassed to enhance " "behavior, such as using different index file names by overriding the class " -"attribute :attr:`index_pages`." +"attribute :attr:`~SimpleHTTPRequestHandler.index_pages`." msgstr "" msgid "" @@ -519,9 +558,10 @@ msgid "" msgstr "" msgid "" -"The :func:`do_GET` and :func:`do_HEAD` functions are modified to run CGI " -"scripts and serve the output, instead of serving files, if the request leads " -"to somewhere below the ``cgi_directories`` path." +"The :func:`~SimpleHTTPRequestHandler.do_GET` " +"and :func:`~SimpleHTTPRequestHandler.do_HEAD` functions are modified to run " +"CGI scripts and serve the output, instead of serving files, if the request " +"leads to somewhere below the ``cgi_directories`` path." msgstr "" msgid "The :class:`CGIHTTPRequestHandler` defines the following data member:" @@ -550,12 +590,12 @@ msgid "" ":class:`CGIHTTPRequestHandler` is being removed in 3.15. CGI has not been " "considered a good way to do things for well over a decade. This code has " "been unmaintained for a while now and sees very little practical use. " -"Retaining it could lead to further :ref:`security considerations `." +"Retaining it could lead to further :ref:`security considerations " +"`." msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" ":mod:`!http.server` can also be invoked directly using the :option:`-m` " @@ -617,8 +657,8 @@ msgid "python -m http.server --cgi" msgstr "" msgid "" -":mod:`!http.server` command line ``--cgi`` support is being removed because :" -"class:`CGIHTTPRequestHandler` is being removed." +":mod:`!http.server` command line ``--cgi`` support is being removed " +"because :class:`CGIHTTPRequestHandler` is being removed." msgstr "" msgid "" @@ -654,23 +694,23 @@ msgstr "" msgid "" ":class:`SimpleHTTPRequestHandler` will follow symbolic links when handling " -"requests, this makes it possible for files outside of the specified " +"requests which makes it possible for files outside of the specified " "directory to be served." msgstr "" msgid "" -"Methods :meth:`BaseHTTPRequestHandler.send_header` and :meth:" -"`BaseHTTPRequestHandler.send_response_only` assume sanitized input and do " -"not perform input validation such as checking for the presence of CRLF " -"sequences. Untrusted input may result in HTTP Header injection attacks." +"Methods :meth:`BaseHTTPRequestHandler.send_header` " +"and :meth:`BaseHTTPRequestHandler.send_response_only` assume sanitized input " +"and do not perform input validation such as checking for the presence of " +"CRLF sequences. Untrusted input may result in HTTP header injection attacks." msgstr "" msgid "" "Earlier versions of Python did not scrub control characters from the log " -"messages emitted to stderr from ``python -m http.server`` or the default :" -"class:`BaseHTTPRequestHandler` ``.log_message`` implementation. This could " -"allow remote clients connecting to your server to send nefarious control " -"codes to your terminal." +"messages emitted to stderr from ``python -m http.server`` or the " +"default :class:`BaseHTTPRequestHandler` ``.log_message`` implementation. " +"This could allow remote clients connecting to your server to send nefarious " +"control codes to your terminal." msgstr "" msgid "Control characters are scrubbed in stderr logs." diff --git a/library/idle.po b/library/idle.po index 7e54889e94..5353ea74f2 100644 --- a/library/idle.po +++ b/library/idle.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# Stan Ulbrych, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Stan Ulbrych, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -73,8 +73,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "Menus" msgstr "" @@ -222,7 +222,7 @@ msgid "" msgstr "" msgid "Copy" -msgstr "" +msgstr "Kopiuj" msgid "Copy selection into the system-wide clipboard." msgstr "" @@ -279,8 +279,9 @@ msgid "Show Completions" msgstr "" msgid "" -"Open a scrollable list allowing selection of existing names. See :ref:" -"`Completions ` in the Editing and Navigation section below." +"Open a scrollable list allowing selection of existing names. " +"See :ref:`Completions ` in the Editing and Navigation section " +"below." msgstr "" msgid "Expand Word" @@ -747,11 +748,11 @@ msgid "" "attributes of classes or functions, or filenames. Each request method " "displays a completion box with existing names. (See tab completions below " "for an exception.) For any box, change the name being completed and the item " -"highlighted in the box by typing and deleting characters; by hitting :kbd:" -"`Up`, :kbd:`Down`, :kbd:`PageUp`, :kbd:`PageDown`, :kbd:`Home`, and :kbd:" -"`End` keys; and by a single click within the box. Close the box with :kbd:" -"`Escape`, :kbd:`Enter`, and double :kbd:`Tab` keys or clicks outside the " -"box. A double click within the box selects and closes." +"highlighted in the box by typing and deleting characters; by " +"hitting :kbd:`Up`, :kbd:`Down`, :kbd:`PageUp`, :kbd:`PageDown`, :kbd:`Home`, " +"and :kbd:`End` keys; and by a single click within the box. Close the box " +"with :kbd:`Escape`, :kbd:`Enter`, and double :kbd:`Tab` keys or clicks " +"outside the box. A double click within the box selects and closes." msgstr "" msgid "" @@ -759,20 +760,20 @@ msgid "" "interval. This defaults to 2 seconds; customize it in the settings dialog. " "(To prevent auto popups, set the delay to a large number of milliseconds, " "such as 100000000.) For imported module names or class or function " -"attributes, type '.'. For filenames in the root directory, type :data:`os." -"sep` or :data:`os.altsep` immediately after an opening quote. (On Windows, " -"one can specify a drive first.) Move into subdirectories by typing a " -"directory name and a separator." +"attributes, type '.'. For filenames in the root directory, " +"type :data:`os.sep` or :data:`os.altsep` immediately after an opening " +"quote. (On Windows, one can specify a drive first.) Move into " +"subdirectories by typing a directory name and a separator." msgstr "" msgid "" "Instead of waiting, or after a box is closed, open a completion box " -"immediately with Show Completions on the Edit menu. The default hot key is :" -"kbd:`C-space`. If one types a prefix for the desired name before opening " -"the box, the first match or near miss is made visible. The result is the " -"same as if one enters a prefix after the box is displayed. Show Completions " -"after a quote completes filenames in the current directory instead of a root " -"directory." +"immediately with Show Completions on the Edit menu. The default hot key " +"is :kbd:`C-space`. If one types a prefix for the desired name before " +"opening the box, the first match or near miss is made visible. The result is " +"the same as if one enters a prefix after the box is displayed. Show " +"Completions after a quote completes filenames in the current directory " +"instead of a root directory." msgstr "" msgid "" @@ -886,9 +887,9 @@ msgstr "" msgid "" "Submit a single-line statement for execution by hitting :kbd:`Return` with " -"the cursor anywhere on the line. If a line is extended with Backslash (:kbd:" -"`\\\\`), the cursor must be on the last physical line. Submit a multi-line " -"compound statement by entering a blank line after the statement." +"the cursor anywhere on the line. If a line is extended with Backslash " +"(:kbd:`\\\\`), the cursor must be on the last physical line. Submit a multi-" +"line compound statement by entering a blank line after the statement." msgstr "" msgid "" @@ -941,11 +942,11 @@ msgid "" msgstr "" msgid "" -"IDLE also highlights the :ref:`soft keywords ` :keyword:" -"`match`, :keyword:`case `, and :keyword:`_ ` in " -"pattern-matching statements. However, this highlighting is not perfect and " -"will be incorrect in some rare cases, including some ``_``-s in ``case`` " -"patterns." +"IDLE also highlights the :ref:`soft keywords ` :keyword:`match`, :keyword:`case `, and :keyword:`_ " +"` in pattern-matching statements. However, this " +"highlighting is not perfect and will be incorrect in some rare cases, " +"including some ``_``-s in ``case`` patterns." msgstr "" msgid "" @@ -960,13 +961,13 @@ msgstr "" msgid "" "Upon startup with the ``-s`` option, IDLE will execute the file referenced " -"by the environment variables :envvar:`IDLESTARTUP` or :envvar:" -"`PYTHONSTARTUP`. IDLE first checks for ``IDLESTARTUP``; if ``IDLESTARTUP`` " -"is present the file referenced is run. If ``IDLESTARTUP`` is not present, " -"IDLE checks for ``PYTHONSTARTUP``. Files referenced by these environment " -"variables are convenient places to store functions that are used frequently " -"from the IDLE shell, or for executing import statements to import common " -"modules." +"by the environment variables :envvar:`IDLESTARTUP` " +"or :envvar:`PYTHONSTARTUP`. IDLE first checks for ``IDLESTARTUP``; if " +"``IDLESTARTUP`` is present the file referenced is run. If ``IDLESTARTUP`` " +"is not present, IDLE checks for ``PYTHONSTARTUP``. Files referenced by " +"these environment variables are convenient places to store functions that " +"are used frequently from the IDLE shell, or for executing import statements " +"to import common modules." msgstr "" msgid "" @@ -1013,8 +1014,9 @@ msgid "Run the specified file in the shell window." msgstr "" msgid "" -"Run the startup file (as defined by the environment variables :envvar:" -"`IDLESTARTUP` or :envvar:`PYTHONSTARTUP`) before opening the shell window." +"Run the startup file (as defined by the environment " +"variables :envvar:`IDLESTARTUP` or :envvar:`PYTHONSTARTUP`) before opening " +"the shell window." msgstr "" msgid "Set the title of the shell window." @@ -1029,10 +1031,10 @@ msgid "If arguments are provided:" msgstr "" msgid "" -"If ``-``, ``-c``, or ``-r`` is used, all arguments are placed in ``sys." -"argv[1:]``, and ``sys.argv[0]`` is set to ``''``, ``'-c'``, or ``'-r'`` " -"respectively. No editor window is opened, even if that is the default set in " -"the *Options* dialog." +"If ``-``, ``-c``, or ``-r`` is used, all arguments are placed in " +"``sys.argv[1:]``, and ``sys.argv[0]`` is set to ``''``, ``'-c'``, or ``'-" +"r'`` respectively. No editor window is opened, even if that is the default " +"set in the *Options* dialog." msgstr "" msgid "" @@ -1094,8 +1096,8 @@ msgid "" msgstr "" msgid "" -"When IDLE first starts, it attempts to read user configuration files in ``~/." -"idlerc/`` (~ is one's home directory). If there is a problem, an error " +"When IDLE first starts, it attempts to read user configuration files in " +"``~/.idlerc/`` (~ is one's home directory). If there is a problem, an error " "message should be displayed. Leaving aside random disk glitches, this can " "be prevented by never editing the files by hand. Instead, use the " "configuration dialog, under Options. Once there is an error in a user " @@ -1134,8 +1136,8 @@ msgid "" "user interface process that runs the shell and editor. In the execution " "process, it replaces ``sys.stdin``, ``sys.stdout``, and ``sys.stderr`` with " "objects that get input from and send output to the Shell window. The " -"original values stored in ``sys.__stdin__``, ``sys.__stdout__``, and ``sys." -"__stderr__`` are not touched, but may be ``None``." +"original values stored in ``sys.__stdin__``, ``sys.__stdout__``, and " +"``sys.__stderr__`` are not touched, but may be ``None``." msgstr "" msgid "" @@ -1152,9 +1154,9 @@ msgstr "" msgid "" "IDLE's standard stream replacements are not inherited by subprocesses " "created in the execution process, whether directly by user code or by " -"modules such as multiprocessing. If such subprocess use ``input`` from sys." -"stdin or ``print`` or ``write`` to sys.stdout or sys.stderr, IDLE should be " -"started in a command line window. (On Windows, use ``python`` or ``py`` " +"modules such as multiprocessing. If such subprocess use ``input`` from " +"sys.stdin or ``print`` or ``write`` to sys.stdout or sys.stderr, IDLE should " +"be started in a command line window. (On Windows, use ``python`` or ``py`` " "rather than ``pythonw`` or ``pyw``.) The secondary subprocess will then be " "attached to that window for input and output." msgstr "" @@ -1189,9 +1191,9 @@ msgstr "" msgid "" "When a program outputs text, the result is determined by the corresponding " -"output device. When IDLE executes user code, ``sys.stdout`` and ``sys." -"stderr`` are connected to the display area of IDLE's Shell. Some of its " -"features are inherited from the underlying Tk Text widget. Others are " +"output device. When IDLE executes user code, ``sys.stdout`` and " +"``sys.stderr`` are connected to the display area of IDLE's Shell. Some of " +"its features are inherited from the underlying Tk Text widget. Others are " "programmed additions. Where it matters, Shell is designed for development " "rather than production runs." msgstr "" @@ -1267,13 +1269,13 @@ msgstr "" msgid "" "IDLE is intentionally different from standard Python in order to facilitate " -"development of tkinter programs. Enter ``import tkinter as tk; root = tk." -"Tk()`` in standard Python and nothing appears. Enter the same in IDLE and a " -"tk window appears. In standard Python, one must also enter ``root." -"update()`` to see the window. IDLE does the equivalent in the background, " -"about 20 times a second, which is about every 50 milliseconds. Next enter " -"``b = tk.Button(root, text='button'); b.pack()``. Again, nothing visibly " -"changes in standard Python until one enters ``root.update()``." +"development of tkinter programs. Enter ``import tkinter as tk; root = " +"tk.Tk()`` in standard Python and nothing appears. Enter the same in IDLE " +"and a tk window appears. In standard Python, one must also enter " +"``root.update()`` to see the window. IDLE does the equivalent in the " +"background, about 20 times a second, which is about every 50 milliseconds. " +"Next enter ``b = tk.Button(root, text='button'); b.pack()``. Again, nothing " +"visibly changes in standard Python until one enters ``root.update()``." msgstr "" msgid "" diff --git a/library/imaplib.po b/library/imaplib.po index 8cbe6e68bf..52bf43526b 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,11 +30,11 @@ msgid "**Source code:** :source:`Lib/imaplib.py`" msgstr "**Kod źródłowy:** :source:`Lib/imaplib.py`" msgid "" -"This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and :" -"class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and " -"implement a large subset of the IMAP4rev1 client protocol as defined in :rfc:" -"`2060`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but note " -"that the ``STATUS`` command is not supported in IMAP4." +"This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` " +"and :class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server " +"and implement a large subset of the IMAP4rev1 client protocol as defined " +"in :rfc:`3501`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, " +"but note that the ``STATUS`` command is not supported in IMAP4." msgstr "" msgid "Availability" @@ -62,8 +62,8 @@ msgstr "" msgid "" "The :class:`IMAP4` class supports the :keyword:`with` statement. When used " -"like this, the IMAP4 ``LOGOUT`` command is issued automatically when the :" -"keyword:`!with` statement exits. E.g.::" +"like this, the IMAP4 ``LOGOUT`` command is issued automatically when " +"the :keyword:`!with` statement exits. E.g.::" msgstr "" msgid "" @@ -115,6 +115,12 @@ msgid "" "for best practices." msgstr "" +msgid "" +"With the default *ssl_context*, the connection is encrypted but the server " +"certificate and hostname are not verified. To verify them, pass a context " +"created by :func:`ssl.create_default_context`." +msgstr "" + msgid "" "The optional *timeout* parameter specifies a timeout in seconds for the " "connection attempt. If timeout is not given or is ``None``, the global " @@ -125,8 +131,9 @@ msgid "*ssl_context* parameter was added." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -137,17 +144,17 @@ msgstr "" msgid "" "This is a subclass derived from :class:`IMAP4` that connects to the ``stdin/" -"stdout`` file descriptors created by passing *command* to ``subprocess." -"Popen()``." +"stdout`` file descriptors created by passing *command* to " +"``subprocess.Popen()``." msgstr "" msgid "The following utility functions are defined:" msgstr "" msgid "" -"Parse an IMAP4 ``INTERNALDATE`` string and return corresponding local time. " -"The return value is a :class:`time.struct_time` tuple or ``None`` if the " -"string has wrong format." +"Parse a :term:`bytes-like object` containing an IMAP4 ``INTERNALDATE`` " +"response and return the corresponding local time. The return value is " +"a :class:`time.struct_time` tuple or ``None`` if the input has wrong format." msgstr "" msgid "" @@ -155,7 +162,10 @@ msgid "" "set [``A`` .. ``P``]." msgstr "" -msgid "Converts an IMAP4 ``FLAGS`` response to a tuple of individual flags." +msgid "" +"Converts a :term:`bytes-like object` containing an IMAP4 ``FLAGS`` response " +"to a tuple of individual flags as :class:`bytes`. The return value is an " +"empty tuple if the input has wrong format." msgstr "" msgid "" @@ -164,9 +174,9 @@ msgid "" "double-quotes). The *date_time* argument can be a number (int or float) " "representing seconds since epoch (as returned by :func:`time.time`), a 9-" "tuple representing local time an instance of :class:`time.struct_time` (as " -"returned by :func:`time.localtime`), an aware instance of :class:`datetime." -"datetime`, or a double-quoted string. In the last case, it is assumed to " -"already be in the correct format." +"returned by :func:`time.localtime`), an aware instance " +"of :class:`datetime.datetime`, or a double-quoted string. In the last case, " +"it is assumed to already be in the correct format." msgstr "" msgid "" @@ -203,7 +213,10 @@ msgid "" "string is quoted. However, the *password* argument to the ``LOGIN`` command " "is always quoted. If you want to avoid having an argument string quoted (eg: " "the *flags* argument to ``STORE``) then enclose the string in parentheses " -"(eg: ``r'(\\Deleted)'``)." +"(eg: ``r'(\\Deleted)'``). In general, pass arguments unquoted and let the " +"module quote them as needed. An argument that is already enclosed in double " +"quotes is left unchanged, so that code which quotes arguments itself keeps " +"working." msgstr "" msgid "" @@ -228,6 +241,12 @@ msgstr "" msgid "Append *message* to named mailbox." msgstr "" +msgid "" +"*flags* may be ``None`` or a string of IMAP flag tokens. Multiple flags are " +"separated by spaces, for example ``r'\\Seen \\Answered'``. If *flags* is not " +"already enclosed in parentheses, parentheses are added automatically." +msgstr "" + msgid "Authenticate command --- requires response processing." msgstr "" @@ -277,8 +296,8 @@ msgstr "" msgid "" "Enable *capability* (see :rfc:`5161`). Most capabilities do not need to be " -"enabled. Currently only the ``UTF8=ACCEPT`` capability is supported (see :" -"RFC:`6855`)." +"enabled. Currently only the ``UTF8=ACCEPT`` capability is supported " +"(see :RFC:`6855`)." msgstr "" msgid "The :meth:`enable` method itself, and :RFC:`6855` support." @@ -322,9 +341,9 @@ msgid "" msgstr "" msgid "" -"The returned object sends the ``IDLE`` command when activated by the :" -"keyword:`with` statement, produces IMAP untagged responses via the :term:" -"`iterator` protocol, and sends ``DONE`` upon context exit." +"The returned object sends the ``IDLE`` command when activated by " +"the :keyword:`with` statement, produces IMAP untagged responses via " +"the :term:`iterator` protocol, and sends ``DONE`` upon context exit." msgstr "" msgid "" @@ -342,8 +361,8 @@ msgstr "" msgid "" "The *duration* argument sets a maximum duration (in seconds) to keep idling, " -"after which any ongoing iteration will stop. It can be an :class:`int` or :" -"class:`float`, or ``None`` for no time limit. Callers wishing to avoid " +"after which any ongoing iteration will stop. It can be an :class:`int` " +"or :class:`float`, or ``None`` for no time limit. Callers wishing to avoid " "inactivity timeouts on servers that impose them should keep this at most 29 " "minutes (1740 seconds). Requires a socket connection; *duration* must be " "``None`` on :class:`IMAP4_stream` connections." @@ -395,10 +414,10 @@ msgid "" msgstr "" msgid "" -"The iterator returned by :meth:`IMAP4.idle` is usable only within a :keyword:" -"`with` statement. Before or after that context, unsolicited responses are " -"collected internally whenever a command finishes, and can be retrieved with :" -"meth:`IMAP4.response`." +"The iterator returned by :meth:`IMAP4.idle` is usable only within " +"a :keyword:`with` statement. Before or after that context, unsolicited " +"responses are collected internally whenever a command finishes, and can be " +"retrieved with :meth:`IMAP4.response`." msgstr "" msgid "" @@ -453,12 +472,12 @@ msgid "" "Opens socket to *port* at *host*. The optional *timeout* parameter specifies " "a timeout in seconds for the connection attempt. If timeout is not given or " "is ``None``, the global default socket timeout is used. Also note that if " -"the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to reject creating a non-blocking socket. This method is " -"implicitly called by the :class:`IMAP4` constructor. The connection objects " -"established by this method will be used in the :meth:`IMAP4.read`, :meth:" -"`IMAP4.readline`, :meth:`IMAP4.send`, and :meth:`IMAP4.shutdown` methods. " -"You may override this method." +"the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to reject creating a non-blocking socket. This method " +"is implicitly called by the :class:`IMAP4` constructor. The connection " +"objects established by this method will be used in " +"the :meth:`IMAP4.read`, :meth:`IMAP4.readline`, :meth:`IMAP4.send`, " +"and :meth:`IMAP4.shutdown` methods. You may override this method." msgstr "" msgid "" @@ -504,8 +523,8 @@ msgid "" "case no ``CHARSET`` will be specified in the request to the server. The " "IMAP protocol requires that at least one criterion be specified; an " "exception will be raised when the server returns an error. *charset* must " -"be ``None`` if the ``UTF8=ACCEPT`` capability was enabled using the :meth:" -"`enable` command." +"be ``None`` if the ``UTF8=ACCEPT`` capability was enabled using " +"the :meth:`enable` command." msgstr "" msgid "Example::" @@ -583,8 +602,9 @@ msgid "" msgstr "" msgid "" -"The method now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The method now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "Request named status conditions for *mailbox*." @@ -592,7 +612,7 @@ msgstr "" msgid "" "Alters flag dispositions for messages in mailbox. *command* is specified by " -"section 6.4.6 of :rfc:`2060` as being one of \"FLAGS\", \"+FLAGS\", or \"-" +"section 6.4.6 of :rfc:`3501` as being one of \"FLAGS\", \"+FLAGS\", or \"-" "FLAGS\", optionally with a suffix of \".SILENT\"." msgstr "" @@ -609,10 +629,10 @@ msgstr "" msgid "" "Creating flags containing ']' (for example: \"[test]\") violates :rfc:`3501` " "(the IMAP protocol). However, imaplib has historically allowed creation of " -"such tags, and popular IMAP servers, such as Gmail, accept and produce such " -"flags. There are non-Python programs which also create such tags. Although " -"it is an RFC violation and IMAP clients and servers are supposed to be " -"strict, imaplib still continues to allow such tags to be created for " +"such flags, and popular IMAP servers, such as Gmail, accept and produce such " +"flags. There are non-Python programs which also create such flags. " +"Although it is an RFC violation and IMAP clients and servers are supposed to " +"be strict, imaplib still continues to allow such flags to be created for " "backward compatibility reasons, and as of Python 3.6, handles them if they " "are sent from the server, since this improves real-world compatibility." msgstr "" @@ -668,6 +688,19 @@ msgstr "" msgid "The following attributes are defined on instances of :class:`IMAP4`:" msgstr "" +msgid "A tuple of the capabilities advertised by the server, in upper case." +msgstr "" + +msgid "" +"It is set when the connection is established, and refreshed after a " +"successful :meth:`~IMAP4.login`, :meth:`~IMAP4.authenticate` " +"or :meth:`~IMAP4.starttls`, because the server can advertise different " +"capabilities in different connection states." +msgstr "" + +msgid "Refreshed after :meth:`~IMAP4.login` and :meth:`~IMAP4.authenticate`." +msgstr "" + msgid "" "The most recent supported protocol in the ``CAPABILITY`` response from the " "server." @@ -680,8 +713,9 @@ msgid "" msgstr "" msgid "" -"Boolean value that is normally ``False``, but is set to ``True`` if an :meth:" -"`enable` command is successfully issued for the ``UTF8=ACCEPT`` capability." +"Boolean value that is normally ``False``, but is set to ``True`` if " +"an :meth:`enable` command is successfully issued for the ``UTF8=ACCEPT`` " +"capability." msgstr "" msgid "IMAP4 Example" @@ -706,6 +740,12 @@ msgid "" "M.logout()" msgstr "" +msgid "" +"A ``FETCH`` response may contain additional or unsolicited data " +"(see :rfc:`3501`, section 7.4.2), so production code should inspect the " +"whole response rather than rely on ``data[0][1]``." +msgstr "" + msgid "IMAP4" msgstr "" diff --git a/library/importlib.metadata.po b/library/importlib.metadata.po index ece27afbd2..98eebea470 100644 --- a/library/importlib.metadata.po +++ b/library/importlib.metadata.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -46,9 +46,9 @@ msgstr "" msgid "" "``importlib.metadata`` operates on third-party *distribution packages* " -"installed into Python's ``site-packages`` directory via tools such as :pypi:" -"`pip`. Specifically, it works with distributions with discoverable ``dist-" -"info`` or ``egg-info`` directories, and metadata defined by the `Core " +"installed into Python's ``site-packages`` directory via tools such " +"as :pypi:`pip`. Specifically, it works with distributions with discoverable " +"``dist-info`` or ``egg-info`` directories, and metadata defined by the `Core " "metadata specifications `_." msgstr "" @@ -58,9 +58,9 @@ msgid "" "level *import package* names that can be imported inside Python code. One " "*distribution package* can contain multiple *import packages* (and single " "modules), and one top-level *import package* may map to multiple " -"*distribution packages* if it is a namespace package. You can use :ref:" -"`packages_distributions() ` to get a mapping between " -"them." +"*distribution packages* if it is a namespace package. You can " +"use :ref:`packages_distributions() ` to get a mapping " +"between them." msgstr "" msgid "" @@ -76,8 +76,8 @@ msgid "" "The documentation for ``importlib_metadata``, which supplies a backport of " "``importlib.metadata``. This includes an `API reference `__ for this module's classes and " -"functions, as well as a `migration guide `__ for existing users of " +"functions, as well as a `migration guide `__ for existing users of " "``pkg_resources``." msgstr "" @@ -110,14 +110,15 @@ msgstr "" msgid "" "You can also get a collection of entry points selectable by properties of " "the EntryPoint (typically 'group' or 'name'), such as ``console_scripts``, " -"``distutils.commands`` and others. Each group contains a collection of :ref:" -"`EntryPoint ` objects." +"``distutils.commands`` and others. Each group contains a collection " +"of :ref:`EntryPoint ` objects." msgstr "" msgid "You can get the :ref:`metadata for a distribution `::" msgstr "" msgid "" +">>> from importlib.metadata import metadata\n" ">>> list(metadata('wheel'))\n" "['Metadata-Version', 'Name', 'Version', 'Summary', 'Home-page', 'Author', " "'Author-email', 'Maintainer', 'Maintainer-email', 'License', 'Project-URL', " @@ -129,9 +130,9 @@ msgid "" msgstr "" msgid "" -"You can also get a :ref:`distribution's version number `, list its :" -"ref:`constituent files `, and get a list of the distribution's :ref:" -"`requirements`." +"You can also get a :ref:`distribution's version number `, list " +"its :ref:`constituent files `, and get a list of the " +"distribution's :ref:`requirements`." msgstr "" msgid "" @@ -157,10 +158,10 @@ msgid "" msgstr "" msgid "" -"Note: it is not currently possible to query for entry points based on their :" -"attr:`!EntryPoint.dist` attribute (as different :class:`!Distribution` " -"instances do not currently compare equal, even if they have the same " -"attributes)" +"Note: it is not currently possible to query for entry points based on " +"their :attr:`!EntryPoint.dist` attribute (as different :class:`!" +"Distribution` instances do not currently compare equal, even if they have " +"the same attributes)" msgstr "" msgid "Details of a collection of installed entry points." @@ -177,10 +178,10 @@ msgstr "" msgid "" "Each :class:`!EntryPoint` instance has ``.name``, ``.group``, and ``.value`` " -"attributes and a ``.load()`` method to resolve the value. There are also ``." -"module``, ``.attr``, and ``.extras`` attributes for getting the components " -"of the ``.value`` attribute, and ``.dist`` for obtaining information " -"regarding the distribution package that provides the entry point." +"attributes and a ``.load()`` method to resolve the value. There are also " +"``.module``, ``.attr``, and ``.extras`` attributes for getting the " +"components of the ``.value`` attribute, and ``.dist`` for obtaining " +"information regarding the distribution package that provides the entry point." msgstr "" msgid "Query all entry points::" @@ -266,13 +267,13 @@ msgid "" "3.6 and Python 3.10. Prior to those changes, ``entry_points`` accepted no " "parameters and always returned a dictionary of entry points, keyed by group. " "With ``importlib_metadata`` 5.0 and Python 3.12, ``entry_points`` always " -"returns an ``EntryPoints`` object. See :pypi:`backports." -"entry_points_selectable` for compatibility options." +"returns an ``EntryPoints`` object. " +"See :pypi:`backports.entry_points_selectable` for compatibility options." msgstr "" msgid "" -"``EntryPoint`` objects no longer present a tuple-like interface (:meth:" -"`~object.__getitem__`)." +"``EntryPoint`` objects no longer present a tuple-like interface " +"(:meth:`~object.__getitem__`)." msgstr "" msgid "Distribution metadata" @@ -290,8 +291,8 @@ msgstr "" msgid "" "A concrete implementation of the `PackageMetadata protocol `_." +"importlib-metadata.readthedocs.io/en/latest/" +"api.html#importlib_metadata.PackageMetadata>`_." msgstr "" msgid "" @@ -348,9 +349,9 @@ msgid "Distribution versions" msgstr "" msgid "" -"Return the installed distribution package `version `__ for the named " -"distribution package." +"Return the installed distribution package `version `__ for " +"the named distribution package." msgstr "" msgid "" @@ -384,10 +385,10 @@ msgid "" msgstr "" msgid "" -"The :func:`!files` function takes a `Distribution Package `_ name and returns " -"all of the files installed by this distribution. Each file is reported as a :" -"class:`PackagePath` instance. For example::" +"The :func:`!files` function takes a `Distribution Package `_ name " +"and returns all of the files installed by this distribution. Each file is " +"reported as a :class:`PackagePath` instance. For example::" msgstr "" msgid "" @@ -427,12 +428,13 @@ msgid "" msgstr "" msgid "" -"In the case where the metadata file listing files (``RECORD`` or ``SOURCES." -"txt``) is missing, :func:`!files` will return :const:`None`. The caller may " -"wish to wrap calls to :func:`!files` in `always_iterable `_ or otherwise guard against this condition if the target " -"distribution is not known to have the metadata present." +"In the case where the metadata file listing files (``RECORD`` or " +"``SOURCES.txt``) is missing, :func:`!files` will return :const:`None`. The " +"caller may wish to wrap calls to :func:`!files` in `always_iterable `_ or otherwise guard against this " +"condition if the target distribution is not known to have the metadata " +"present." msgstr "" msgid "Distribution requirements" @@ -469,11 +471,11 @@ msgid "" msgstr "" msgid "" -"A convenience method to resolve the `Distribution Package `_ name (or names, " -"in the case of a namespace package) that provide each importable top-level " -"Python module or `Import Package `_::" +"A convenience method to resolve the `Distribution Package `_ name " +"(or names, in the case of a namespace package) that provide each importable " +"top-level Python module or `Import Package `_::" msgstr "" msgid "" @@ -513,9 +515,9 @@ msgid "" "usage, you can get all of that information from the :class:`!Distribution` " "class. :class:`!Distribution` is an abstract object that represents the " "metadata for a Python `Distribution Package `_. You can get the concrete :" -"class:`!Distribution` subclass instance for an installed distribution " -"package by calling the :func:`distribution` function::" +"latest/glossary/#term-Distribution-Package>`_. You can get the " +"concrete :class:`!Distribution` subclass instance for an installed " +"distribution package by calling the :func:`distribution` function::" msgstr "" msgid "" @@ -567,10 +569,11 @@ msgstr "" msgid "" "By default, this package provides built-in support for discovery of metadata " -"for file system and zip file `Distribution Package `_\\s. This metadata " -"finder search defaults to ``sys.path``, but varies slightly in how it " -"interprets those values from how other import machinery does. In particular:" +"for file system and zip file `Distribution Package `_\\s. " +"This metadata finder search defaults to ``sys.path``, but varies slightly in " +"how it interprets those values from how other import machinery does. In " +"particular:" msgstr "" msgid "" @@ -595,12 +598,12 @@ msgstr "" msgid "" "Because `Distribution Package `_ metadata is not available through :" -"data:`sys.path` searches, or package loaders directly, the metadata for a " -"distribution is found through import system :ref:`finders `_ metadata is not available " +"through :data:`sys.path` searches, or package loaders directly, the metadata " +"for a distribution is found through import system :ref:`finders `. To find a distribution package's metadata, ``importlib.metadata`` " -"queries the list of :term:`meta path finders ` on :data:" -"`sys.meta_path`." +"queries the list of :term:`meta path finders ` " +"on :data:`sys.meta_path`." msgstr "" msgid "" @@ -610,8 +613,8 @@ msgstr "" msgid "" "The abstract class :py:class:`importlib.abc.MetaPathFinder` defines the " -"interface expected of finders by Python's import system. ``importlib." -"metadata`` extends this protocol by looking for an optional " +"interface expected of finders by Python's import system. " +"``importlib.metadata`` extends this protocol by looking for an optional " "``find_distributions`` callable on the finders from :data:`sys.meta_path` " "and presents this extended interface as the ``DistributionFinder`` abstract " "base class, which defines this abstract method::" diff --git a/library/importlib.po b/library/importlib.po index 4ebb7b9456..a7591ecb78 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -79,8 +79,8 @@ msgstr "" msgid "" "Original specification of packages. Some semantics have changed since the " -"writing of this document (e.g. redirecting based on ``None`` in :data:`sys." -"modules`)." +"writing of this document (e.g. redirecting based on ``None`` " +"in :data:`sys.modules`)." msgstr "" msgid "The :func:`.__import__` function" @@ -188,11 +188,11 @@ msgid "" msgstr "" msgid "" -"The :func:`import_module` function acts as a simplifying wrapper around :" -"func:`importlib.__import__`. This means all semantics of the function are " -"derived from :func:`importlib.__import__`. The most important difference " -"between these two functions is that :func:`import_module` returns the " -"specified package or module (e.g. ``pkg.mod``), while :func:`__import__` " +"The :func:`import_module` function acts as a simplifying wrapper " +"around :func:`importlib.__import__`. This means all semantics of the " +"function are derived from :func:`importlib.__import__`. The most important " +"difference between these two functions is that :func:`import_module` returns " +"the specified package or module (e.g. ``pkg.mod``), while :func:`__import__` " "returns the top-level package or module (e.g. ``pkg``)." msgstr "" @@ -285,11 +285,11 @@ msgid "" msgstr "" msgid "" -"If a module imports objects from another module using :keyword:`from` ... :" -"keyword:`import` ..., calling :func:`reload` for the other module does not " -"redefine the objects imported from it --- one way around this is to re-" -"execute the :keyword:`!from` statement, another is to use :keyword:`!import` " -"and qualified names (*module.name*) instead." +"If a module imports objects from another module " +"using :keyword:`from` ... :keyword:`import` ..., calling :func:`reload` for " +"the other module does not redefine the objects imported from it --- one way " +"around this is to re-execute the :keyword:`!from` statement, another is to " +"use :keyword:`!import` and qualified names (*module.name*) instead." msgstr "" msgid "" @@ -300,14 +300,15 @@ msgid "" msgstr "" msgid "" -":exc:`ModuleNotFoundError` is raised when the module being reloaded lacks a :" -"class:`~importlib.machinery.ModuleSpec`." +":exc:`ModuleNotFoundError` is raised when the module being reloaded lacks " +"a :class:`~importlib.machinery.ModuleSpec`." msgstr "" msgid "" "This function is not thread-safe. Calling it from multiple threads can " -"result in unexpected behavior. It's recommended to use the :class:`threading." -"Lock` or other synchronization primitives for thread-safe module reloading." +"result in unexpected behavior. It's recommended to use " +"the :class:`threading.Lock` or other synchronization primitives for thread-" +"safe module reloading." msgstr "" msgid ":mod:`!importlib.abc` -- Abstract base classes related to import" @@ -366,24 +367,25 @@ msgstr "" msgid "" "An abstract base class representing a :term:`path entry finder`. Though it " "bears some similarities to :class:`MetaPathFinder`, ``PathEntryFinder`` is " -"meant for use only within the path-based import subsystem provided by :class:" -"`importlib.machinery.PathFinder`." +"meant for use only within the path-based import subsystem provided " +"by :class:`importlib.machinery.PathFinder`." msgstr "" msgid "" "An abstract method for finding a :term:`spec ` for the " -"specified module. The finder will search for the module only within the :" -"term:`path entry` to which it is assigned. If a spec cannot be found, " +"specified module. The finder will search for the module only within " +"the :term:`path entry` to which it is assigned. If a spec cannot be found, " "``None`` is returned. When passed in, ``target`` is a module object that " -"the finder may use to make a more educated guess about what spec to return. :" -"func:`importlib.util.spec_from_loader` may be useful for implementing " -"concrete ``PathEntryFinders``." +"the finder may use to make a more educated guess about what spec to " +"return. :func:`importlib.util.spec_from_loader` may be useful for " +"implementing concrete ``PathEntryFinders``." msgstr "" msgid "" "An optional method which, when called, should invalidate any internal cache " -"used by the finder. Used by :meth:`importlib.machinery.PathFinder." -"invalidate_caches` when invalidating the caches of all cached finders." +"used by the finder. Used " +"by :meth:`importlib.machinery.PathFinder.invalidate_caches` when " +"invalidating the caches of all cached finders." msgstr "" msgid "" @@ -392,12 +394,12 @@ msgid "" msgstr "" msgid "" -"Loaders that wish to support resource reading should implement a :meth:" -"`get_resource_reader` method as specified by :class:`importlib.resources.abc." -"ResourceReader`." +"Loaders that wish to support resource reading should implement a :meth:`!" +"get_resource_reader` method as specified " +"by :class:`importlib.resources.abc.ResourceReader`." msgstr "" -msgid "Introduced the optional :meth:`get_resource_reader` method." +msgid "Introduced the optional :meth:`!get_resource_reader` method." msgstr "" msgid "" @@ -412,16 +414,17 @@ msgstr "" msgid "" "An abstract method that executes the module in its own namespace when a " "module is imported or reloaded. The module should already be initialized " -"when :meth:`exec_module` is called. When this method exists, :meth:" -"`create_module` must be defined." +"when :meth:`exec_module` is called. When this method " +"exists, :meth:`create_module` must be defined." msgstr "" msgid ":meth:`create_module` must also be defined." msgstr "" msgid "" -"A legacy method for loading a module. If the module cannot be loaded, :exc:" -"`ImportError` is raised, otherwise the loaded module is returned." +"A legacy method for loading a module. If the module cannot be " +"loaded, :exc:`ImportError` is raised, otherwise the loaded module is " +"returned." msgstr "" msgid "" @@ -468,9 +471,9 @@ msgid "" msgstr "" msgid "" -"The recommended API for loading a module is :meth:`exec_module` (and :meth:" -"`create_module`). Loaders should implement it instead of :meth:" -"`load_module`. The import machinery takes care of all the other " +"The recommended API for loading a module is :meth:`exec_module` " +"(and :meth:`create_module`). Loaders should implement it instead " +"of :meth:`load_module`. The import machinery takes care of all the other " "responsibilities of :meth:`load_module` when :meth:`exec_module` is " "implemented." msgstr "" @@ -479,14 +482,15 @@ msgid "*Superseded by TraversableResources*" msgstr "" msgid "" -"An abstract base class for a :term:`loader` which implements the optional :" -"pep:`302` protocol for loading arbitrary resources from the storage back-end." +"An abstract base class for a :term:`loader` which implements the " +"optional :pep:`302` protocol for loading arbitrary resources from the " +"storage back-end." msgstr "" msgid "" -"This ABC is deprecated in favour of supporting resource loading through :" -"class:`importlib.resources.abc.TraversableResources`. This class exists for " -"backwards compatibility only with other ABCs in this module." +"This ABC is deprecated in favour of supporting resource loading " +"through :class:`importlib.resources.abc.TraversableResources`. This class " +"exists for backwards compatibility only with other ABCs in this module." msgstr "" msgid "" @@ -494,16 +498,17 @@ msgid "" "Loaders that have a file-like storage back-end that allows storing arbitrary " "data can implement this abstract method to give direct access to the data " "stored. :exc:`OSError` is to be raised if the *path* cannot be found. The " -"*path* is expected to be constructed using a module's :attr:`~module." -"__file__` attribute or an item from a package's :attr:`~module.__path__`." +"*path* is expected to be constructed using a " +"module's :attr:`~module.__file__` attribute or an item from a " +"package's :attr:`~module.__path__`." msgstr "" msgid "Raises :exc:`OSError` instead of :exc:`NotImplementedError`." msgstr "" msgid "" -"An abstract base class for a :term:`loader` which implements the optional :" -"pep:`302` protocol for loaders that inspect modules." +"An abstract base class for a :term:`loader` which implements the " +"optional :pep:`302` protocol for loaders that inspect modules." msgstr "" msgid "" @@ -541,10 +546,10 @@ msgid "Create a code object from Python source." msgstr "" msgid "" -"The *data* argument can be whatever the :func:`compile` function supports (i." -"e. string or bytes). The *path* argument should be the \"path\" to where the " -"source code originated from, which can be an abstract concept (e.g. location " -"in a zip file)." +"The *data* argument can be whatever the :func:`compile` function supports " +"(i.e. string or bytes). The *path* argument should be the \"path\" to where " +"the source code originated from, which can be an abstract concept (e.g. " +"location in a zip file)." msgstr "" msgid "" @@ -582,9 +587,9 @@ msgid "" msgstr "" msgid "" -"An abstract base class which inherits from :class:`ResourceLoader` and :" -"class:`ExecutionLoader`, providing concrete implementations of :meth:" -"`ResourceLoader.get_data` and :meth:`ExecutionLoader.get_filename`." +"An abstract base class which inherits from :class:`ResourceLoader` " +"and :class:`ExecutionLoader`, providing concrete implementations " +"of :meth:`ResourceLoader.get_data` and :meth:`ExecutionLoader.get_filename`." msgstr "" msgid "" @@ -612,8 +617,8 @@ msgstr "" msgid "" "An abstract base class for implementing source (and optionally bytecode) " -"file loading. The class inherits from both :class:`ResourceLoader` and :" -"class:`ExecutionLoader`, requiring the implementation of:" +"file loading. The class inherits from both :class:`ResourceLoader` " +"and :class:`ExecutionLoader`, requiring the implementation of:" msgstr "" msgid ":meth:`ResourceLoader.get_data`" @@ -629,9 +634,9 @@ msgstr "" msgid "" "The abstract methods defined by this class are to add optional bytecode file " -"support. Not implementing these optional methods (or causing them to raise :" -"exc:`NotImplementedError`) causes the loader to only work with source code. " -"Implementing the methods allows the loader to work with source *and* " +"support. Not implementing these optional methods (or causing them to " +"raise :exc:`NotImplementedError`) causes the loader to only work with source " +"code. Implementing the methods allows the loader to work with source *and* " "bytecode files; it does not allow for *sourceless* loading where only " "bytecode is provided. Bytecode files are an optimization to speed up " "loading by removing the parsing step of Python's compiler, and so no " @@ -677,8 +682,9 @@ msgid "" msgstr "" msgid "" -"When writing to the path fails because the path is read-only (:const:`errno." -"EACCES`/:exc:`PermissionError`), do not propagate the exception." +"When writing to the path fails because the path is read-only " +"(:const:`errno.EACCES`/:exc:`PermissionError`), do not propagate the " +"exception." msgstr "" msgid "No longer raises :exc:`NotImplementedError` when called." @@ -701,9 +707,9 @@ msgstr "" msgid "" "Concrete implementation of :meth:`InspectLoader.is_package`. A module is " -"determined to be a package if its file path (as provided by :meth:" -"`ExecutionLoader.get_filename`) is a file named ``__init__`` when the file " -"extension is removed **and** the module name itself does not end in " +"determined to be a package if its file path (as provided " +"by :meth:`ExecutionLoader.get_filename`) is a file named ``__init__`` when " +"the file extension is removed **and** the module name itself does not end in " "``__init__``." msgstr "" @@ -753,14 +759,15 @@ msgid "" "Returns a combined list of strings representing all file suffixes for " "modules recognized by the standard import machinery. This is a helper for " "code which simply needs to know if a filesystem path potentially refers to a " -"module without needing any details on the kind of module (for example, :func:" -"`inspect.getmodulename`)." +"module without needing any details on the kind of module (for " +"example, :func:`inspect.getmodulename`)." msgstr "" msgid "" "An :term:`importer` for built-in modules. All known built-in modules are " -"listed in :data:`sys.builtin_module_names`. This class implements the :class:" -"`importlib.abc.MetaPathFinder` and :class:`importlib.abc.InspectLoader` ABCs." +"listed in :data:`sys.builtin_module_names`. This class implements " +"the :class:`importlib.abc.MetaPathFinder` " +"and :class:`importlib.abc.InspectLoader` ABCs." msgstr "" msgid "" @@ -769,17 +776,20 @@ msgid "" msgstr "" msgid "" -"As part of :pep:`489`, the builtin importer now implements :meth:`Loader." -"create_module` and :meth:`Loader.exec_module`" +"As part of :pep:`489`, the builtin importer now " +"implements :meth:`Loader.create_module ` " +"and :meth:`Loader.exec_module `" msgstr "" msgid "" -"An :term:`importer` for frozen modules. This class implements the :class:" -"`importlib.abc.MetaPathFinder` and :class:`importlib.abc.InspectLoader` ABCs." +"An :term:`importer` for frozen modules. This class implements " +"the :class:`importlib.abc.MetaPathFinder` " +"and :class:`importlib.abc.InspectLoader` ABCs." msgstr "" msgid "" -"Gained :meth:`~Loader.create_module` and :meth:`~Loader.exec_module` methods." +"Gained :meth:`~importlib.abc.Loader.create_module` " +"and :meth:`~importlib.abc.Loader.exec_module` methods." msgstr "" msgid "" @@ -801,20 +811,21 @@ msgstr "" msgid "" "Class method that attempts to find a :term:`spec ` for the " "module specified by *fullname* on :data:`sys.path` or, if defined, on " -"*path*. For each path entry that is searched, :data:`sys." -"path_importer_cache` is checked. If a non-false object is found then it is " -"used as the :term:`path entry finder` to look for the module being searched " -"for. If no entry is found in :data:`sys.path_importer_cache`, then :data:" -"`sys.path_hooks` is searched for a finder for the path entry and, if found, " -"is stored in :data:`sys.path_importer_cache` along with being queried about " -"the module. If no finder is ever found then ``None`` is both stored in the " -"cache and returned." +"*path*. For each path entry that is " +"searched, :data:`sys.path_importer_cache` is checked. If a non-false object " +"is found then it is used as the :term:`path entry finder` to look for the " +"module being searched for. If no entry is found " +"in :data:`sys.path_importer_cache`, then :data:`sys.path_hooks` is searched " +"for a finder for the path entry and, if found, is stored " +"in :data:`sys.path_importer_cache` along with being queried about the " +"module. If no finder is ever found then ``None`` is both stored in the cache " +"and returned." msgstr "" msgid "" "If the current working directory -- represented by an empty string -- is no " -"longer valid then ``None`` is returned but no value is cached in :data:`sys." -"path_importer_cache`." +"longer valid then ``None`` is returned but no value is cached " +"in :data:`sys.path_importer_cache`." msgstr "" msgid "" @@ -876,8 +887,8 @@ msgid "" msgstr "" msgid "" -"If the argument to the closure is not an existing directory, :exc:" -"`ImportError` is raised." +"If the argument to the closure is not an existing " +"directory, :exc:`ImportError` is raised." msgstr "" msgid "" @@ -963,8 +974,8 @@ msgid "Path to the extension module." msgstr "" msgid "" -"Creates the module object from the given specification in accordance with :" -"pep:`489`." +"Creates the module object from the given specification in accordance " +"with :pep:`489`." msgstr "" msgid "Initializes the given module object in accordance with :pep:`489`." @@ -1005,13 +1016,13 @@ msgid "" "the *values* are usually equivalent, they can differ since there is no " "synchronization between the two objects. For example, it is possible to " "update the module's :attr:`~module.__file__` at runtime and this will not be " -"automatically reflected in the module's :attr:`__spec__.origin `, and vice versa." +"automatically reflected in the module's :attr:`__spec__.origin " +"`, and vice versa." msgstr "" msgid "" -"The module's fully qualified name (see :attr:`module.__name__`). The :term:" -"`finder` should always set this attribute to a non-empty string." +"The module's fully qualified name (see :attr:`module.__name__`). " +"The :term:`finder` should always set this attribute to a non-empty string." msgstr "" msgid "" @@ -1020,11 +1031,12 @@ msgid "" msgstr "" msgid "" -"The location the :term:`loader` should use to load the module (see :attr:" -"`module.__file__`). For example, for modules loaded from a ``.py`` file this " -"is the filename. The :term:`finder` should always set this attribute to a " -"meaningful value for the :term:`loader` to use. In the uncommon case that " -"there is not one (like for namespace packages), it should be set to ``None``." +"The location the :term:`loader` should use to load the module " +"(see :attr:`module.__file__`). For example, for modules loaded from a " +"``.py`` file this is the filename. The :term:`finder` should always set this " +"attribute to a meaningful value for the :term:`loader` to use. In the " +"uncommon case that there is not one (like for namespace packages), it should " +"be set to ``None``." msgstr "" msgid "" @@ -1047,9 +1059,10 @@ msgid "" msgstr "" msgid "" -"The filename of a compiled version of the module's code (see :attr:`module." -"__cached__`). The :term:`finder` should always set this attribute but it may " -"be ``None`` for modules that do not need compiled code stored." +"The filename of a compiled version of the module's code " +"(see :attr:`module.__cached__`). The :term:`finder` should always set this " +"attribute but it may be ``None`` for modules that do not need compiled code " +"stored." msgstr "" msgid "" @@ -1082,27 +1095,27 @@ msgid "" "binaries are *not* packaged as ``.so`` files on ``sys.path``, but as " "individual standalone frameworks. To discover those frameworks, this loader " "is registered against the ``.fwork`` file extension, with a ``.fwork`` file " -"acting as a placeholder in the original location of the binary on ``sys." -"path``. The ``.fwork`` file contains the path of the actual binary in the " -"``Frameworks`` folder, relative to the app bundle. To allow for resolving a " -"framework-packaged binary back to the original location, the framework is " -"expected to contain a ``.origin`` file that contains the location of the ``." -"fwork`` file, relative to the app bundle." +"acting as a placeholder in the original location of the binary on " +"``sys.path``. The ``.fwork`` file contains the path of the actual binary in " +"the ``Frameworks`` folder, relative to the app bundle. To allow for " +"resolving a framework-packaged binary back to the original location, the " +"framework is expected to contain a ``.origin`` file that contains the " +"location of the ``.fwork`` file, relative to the app bundle." msgstr "" msgid "" "For example, consider the case of an import ``from foo.bar import _whiz``, " "where ``_whiz`` is implemented with the binary module ``sources/foo/bar/" -"_whiz.abi3.so``, with ``sources`` being the location registered on ``sys." -"path``, relative to the application bundle. This module *must* be " +"_whiz.abi3.so``, with ``sources`` being the location registered on " +"``sys.path``, relative to the application bundle. This module *must* be " "distributed as ``Frameworks/foo.bar._whiz.framework/foo.bar._whiz`` " "(creating the framework name from the full import path of the module), with " "an ``Info.plist`` file in the ``.framework`` directory identifying the " "binary as a framework. The ``foo.bar._whiz`` module would be represented in " "the original location with a ``sources/foo/bar/_whiz.abi3.fwork`` marker " "file, containing the path ``Frameworks/foo.bar._whiz/foo.bar._whiz``. The " -"framework would also contain ``Frameworks/foo.bar._whiz.framework/foo.bar." -"_whiz.origin``, containing the path to the ``.fwork`` file." +"framework would also contain ``Frameworks/foo.bar._whiz.framework/" +"foo.bar._whiz.origin``, containing the path to the ``.fwork`` file." msgstr "" msgid "" @@ -1149,9 +1162,9 @@ msgid "" "Return the :pep:`3147`/:pep:`488` path to the byte-compiled file associated " "with the source *path*. For example, if *path* is ``/foo/bar/baz.py`` the " "return value would be ``/foo/bar/__pycache__/baz.cpython-32.pyc`` for Python " -"3.2. The ``cpython-32`` string comes from the current magic tag (see :func:" -"`get_tag`; if :attr:`sys.implementation.cache_tag` is not defined then :exc:" -"`NotImplementedError` will be raised)." +"3.2. The ``cpython-32`` string comes from the current magic tag " +"(see :attr:`sys.implementation.cache_tag `; if it is not " +"defined then :exc:`NotImplementedError` will be raised)." msgstr "" msgid "" @@ -1161,9 +1174,9 @@ msgid "" "``/foo/bar/__pycache__/baz.cpython-32.pyc``. ``None`` causes the " "interpreter's optimization level to be used. Any other value's string " "representation is used, so ``/foo/bar/baz.py`` with an *optimization* of " -"``2`` will lead to the bytecode path of ``/foo/bar/__pycache__/baz." -"cpython-32.opt-2.pyc``. The string representation of *optimization* can only " -"be alphanumeric, else :exc:`ValueError` is raised." +"``2`` will lead to the bytecode path of ``/foo/bar/__pycache__/" +"baz.cpython-32.opt-2.pyc``. The string representation of *optimization* can " +"only be alphanumeric, else :exc:`ValueError` is raised." msgstr "" msgid "" @@ -1184,17 +1197,18 @@ msgstr "" msgid "" "Given the *path* to a :pep:`3147` file name, return the associated source " -"code file path. For example, if *path* is ``/foo/bar/__pycache__/baz." -"cpython-32.pyc`` the returned path would be ``/foo/bar/baz.py``. *path* " +"code file path. For example, if *path* is ``/foo/bar/__pycache__/" +"baz.cpython-32.pyc`` the returned path would be ``/foo/bar/baz.py``. *path* " "need not exist, however if it does not conform to :pep:`3147` or :pep:`488` " -"format, a :exc:`ValueError` is raised. If :attr:`sys.implementation." -"cache_tag` is not defined, :exc:`NotImplementedError` is raised." +"format, a :exc:`ValueError` is raised. " +"If :attr:`sys.implementation.cache_tag ` is not " +"defined, :exc:`NotImplementedError` is raised." msgstr "" msgid "" "Decode the given bytes representing source code and return it as a string " -"with universal newlines (as required by :meth:`importlib.abc.InspectLoader." -"get_source`)." +"with universal newlines (as required " +"by :meth:`importlib.abc.InspectLoader.get_source`)." msgstr "" msgid "Resolve a relative module name to an absolute one." @@ -1202,15 +1216,17 @@ msgstr "" msgid "" "If **name** has no leading dots, then **name** is simply returned. This " -"allows for usage such as ``importlib.util.resolve_name('sys', __spec__." -"parent)`` without doing a check to see if the **package** argument is needed." +"allows for usage such as ``importlib.util.resolve_name('sys', " +"__spec__.parent)`` without doing a check to see if the **package** argument " +"is needed." msgstr "" msgid "" ":exc:`ImportError` is raised if **name** is a relative module name but " -"**package** is a false value (e.g. ``None`` or the empty string). :exc:" -"`ImportError` is also raised if a relative name would escape its containing " -"package (e.g. requesting ``..bacon`` from within the ``spam`` package)." +"**package** is a false value (e.g. ``None`` or the empty " +"string). :exc:`ImportError` is also raised if a relative name would escape " +"its containing package (e.g. requesting ``..bacon`` from within the ``spam`` " +"package)." msgstr "" msgid "" @@ -1232,7 +1248,9 @@ msgid "" "automatically imported." msgstr "" -msgid "**name** and **package** work the same as for :func:`import_module`." +msgid "" +"**name** and **package** work the same as " +"for :func:`importlib.import_module`." msgstr "" msgid "" @@ -1262,9 +1280,10 @@ msgstr "" msgid "" "A factory function for creating a :class:`~importlib.machinery.ModuleSpec` " "instance based on a loader. The parameters have the same meaning as they do " -"for ModuleSpec. The function uses available :term:`loader` APIs, such as :" -"meth:`InspectLoader.is_package`, to fill in any missing information on the " -"spec." +"for ModuleSpec. The function uses available :term:`loader` APIs, such " +"as :meth:`InspectLoader.is_package " +"`, to fill in any missing " +"information on the spec." msgstr "" msgid "" @@ -1311,15 +1330,16 @@ msgid "" msgstr "" msgid "" -"This class **only** works with loaders that define :meth:`~importlib.abc." -"Loader.exec_module` as control over what module type is used for the module " -"is required. For those same reasons, the loader's :meth:`~importlib.abc." -"Loader.create_module` method must return ``None`` or a type for which its " -"``__class__`` attribute can be mutated along with not using :term:`slots " -"<__slots__>`. Finally, modules which substitute the object placed into :data:" -"`sys.modules` will not work as there is no way to properly replace the " -"module references throughout the interpreter safely; :exc:`ValueError` is " -"raised if such a substitution is detected." +"This class **only** works with loaders that " +"define :meth:`~importlib.abc.Loader.exec_module` as control over what module " +"type is used for the module is required. For those same reasons, the " +"loader's :meth:`~importlib.abc.Loader.create_module` method must return " +"``None`` or a type for which its ``__class__`` attribute can be mutated " +"along with not using :term:`slots <__slots__>`. Finally, modules which " +"substitute the object placed into :data:`sys.modules` will not work as there " +"is no way to properly replace the module references throughout the " +"interpreter safely; :exc:`ValueError` is raised if such a substitution is " +"detected." msgstr "" msgid "" @@ -1332,8 +1352,8 @@ msgstr "" msgid "" "Began calling :meth:`~importlib.abc.Loader.create_module`, removing the " -"compatibility warning for :class:`importlib.machinery.BuiltinImporter` and :" -"class:`importlib.machinery.ExtensionFileLoader`." +"compatibility warning for :class:`importlib.machinery.BuiltinImporter` " +"and :class:`importlib.machinery.ExtensionFileLoader`." msgstr "" msgid "" @@ -1374,8 +1394,8 @@ msgid "" msgstr "" msgid "" -"Note that if ``name`` is a submodule (contains a dot), :func:`importlib.util." -"find_spec` will import the parent module. ::" +"Note that if ``name`` is a submodule (contains a " +"dot), :func:`importlib.util.find_spec` will import the parent module. ::" msgstr "" msgid "" @@ -1402,11 +1422,11 @@ msgstr "" msgid "" "This recipe should be used with caution: it is an approximation of an import " -"statement where the file path is specified directly, rather than :data:`sys." -"path` being searched. Alternatives should first be considered first, such as " -"modifying :data:`sys.path` when a proper module is required, or using :func:" -"`runpy.run_path` when the global namespace resulting from running a Python " -"file is appropriate." +"statement where the file path is specified directly, rather " +"than :data:`sys.path` being searched. Alternatives should first be " +"considered first, such as modifying :data:`sys.path` when a proper module is " +"required, or using :func:`runpy.run_path` when the global namespace " +"resulting from running a Python file is appropriate." msgstr "" msgid "" @@ -1465,16 +1485,17 @@ msgid "Setting up an importer" msgstr "" msgid "" -"For deep customizations of import, you typically want to implement an :term:" -"`importer`. This means managing both the :term:`finder` and :term:`loader` " -"side of things. For finders there are two flavours to choose from depending " -"on your needs: a :term:`meta path finder` or a :term:`path entry finder`. " -"The former is what you would put on :data:`sys.meta_path` while the latter " -"is what you create using a :term:`path entry hook` on :data:`sys.path_hooks` " -"which works with :data:`sys.path` entries to potentially create a finder. " -"This example will show you how to register your own importers so that import " -"will use them (for creating an importer for yourself, read the documentation " -"for the appropriate classes defined within this package)::" +"For deep customizations of import, you typically want to implement " +"an :term:`importer`. This means managing both the :term:`finder` " +"and :term:`loader` side of things. For finders there are two flavours to " +"choose from depending on your needs: a :term:`meta path finder` or " +"a :term:`path entry finder`. The former is what you would put " +"on :data:`sys.meta_path` while the latter is what you create using " +"a :term:`path entry hook` on :data:`sys.path_hooks` which works " +"with :data:`sys.path` entries to potentially create a finder. This example " +"will show you how to register your own importers so that import will use " +"them (for creating an importer for yourself, read the documentation for the " +"appropriate classes defined within this package)::" msgstr "" msgid "" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po index da49c2d8d9..b88e1aed05 100644 --- a/library/importlib.resources.abc.po +++ b/library/importlib.resources.abc.po @@ -46,23 +46,23 @@ msgid "" msgstr "" msgid "" -"For any of methods of this class, a *resource* argument is expected to be a :" -"term:`path-like object` which represents conceptually just a file name. This " -"means that no subdirectory paths should be included in the *resource* " +"For any of methods of this class, a *resource* argument is expected to be " +"a :term:`path-like object` which represents conceptually just a file name. " +"This means that no subdirectory paths should be included in the *resource* " "argument. This is because the location of the package the reader is for, " "acts as the \"directory\". Hence the metaphor for directories and file names " "is packages and resources, respectively. This is also why instances of this " "class are expected to directly correlate to a specific package (instead of " "potentially representing multiple packages or a module)." msgstr "" -"Для будь-якого методу цього класу очікується, що аргумент *resource* буде :" -"term:`path-like object`, який концептуально представляє лише ім’я файлу. Це " -"означає, що шляхи підкаталогів не повинні включатися в аргумент *resource*. " -"Це пояснюється тим, що місце розташування пакета, для якого призначений " -"зчитувач, діє як \"каталог\". Тому метафорою для каталогів і імен файлів є " -"пакети та ресурси відповідно. Ось чому очікується, що екземпляри цього класу " -"безпосередньо співвідносяться з певним пакетом (замість того, щоб потенційно " -"представляти кілька пакетів або модуль)." +"Для будь-якого методу цього класу очікується, що аргумент *resource* " +"буде :term:`path-like object`, який концептуально представляє лише ім’я " +"файлу. Це означає, що шляхи підкаталогів не повинні включатися в аргумент " +"*resource*. Це пояснюється тим, що місце розташування пакета, для якого " +"призначений зчитувач, діє як \"каталог\". Тому метафорою для каталогів і " +"імен файлів є пакети та ресурси відповідно. Ось чому очікується, що " +"екземпляри цього класу безпосередньо співвідносяться з певним пакетом " +"(замість того, щоб потенційно представляти кілька пакетів або модуль)." msgid "" "Loaders that wish to support resource reading are expected to provide a " @@ -93,29 +93,29 @@ msgid "Returns the file system path to the *resource*." msgstr "Повертає шлях файлової системи до *ресурсу*." msgid "" -"If the resource does not concretely exist on the file system, raise :exc:" -"`FileNotFoundError`." +"If the resource does not concretely exist on the file system, " +"raise :exc:`FileNotFoundError`." msgstr "" -"Якщо ресурс конкретно не існує у файловій системі, викликайте :exc:" -"`FileNotFoundError`." +"Якщо ресурс конкретно не існує у файловій системі, " +"викликайте :exc:`FileNotFoundError`." msgid "" -"Returns ``True`` if the named *name* is considered a resource. :exc:" -"`FileNotFoundError` is raised if *name* does not exist." +"Returns ``True`` if the named *name* is considered a " +"resource. :exc:`FileNotFoundError` is raised if *name* does not exist." msgstr "" -"Повертає ``True``, якщо назване *ім’я* вважається ресурсом. :exc:" -"`FileNotFoundError` виникає, якщо *name* не існує." +"Повертає ``True``, якщо назване *ім’я* вважається " +"ресурсом. :exc:`FileNotFoundError` виникає, якщо *name* не існує." msgid "" "Returns an :term:`iterable` of strings over the contents of the package. Do " "note that it is not required that all names returned by the iterator be " -"actual resources, e.g. it is acceptable to return names for which :meth:" -"`is_resource` would be false." +"actual resources, e.g. it is acceptable to return names for " +"which :meth:`is_resource` would be false." msgstr "" "Повертає :term:`iterable` рядків над вмістом пакета. Зауважте, що не " "обов’язково, щоб усі імена, які повертає ітератор, були фактичними " -"ресурсами, наприклад. прийнятно повертати імена, для яких :meth:" -"`is_resource` буде false." +"ресурсами, наприклад. прийнятно повертати імена, для " +"яких :meth:`is_resource` буде false." msgid "" "Allowing non-resource names to be returned is to allow for situations where " @@ -139,8 +139,8 @@ msgid "" msgstr "" msgid "" -"For a representation of the object on the file-system, use :meth:`importlib." -"resources.as_file`." +"For a representation of the object on the file-system, " +"use :meth:`importlib.resources.as_file`." msgstr "" msgid "Abstract. The base name of this object without any parent references." @@ -156,8 +156,8 @@ msgid "Return ``True`` if self is a file." msgstr "" msgid "" -"Traverse directories according to *pathsegments* and return the result as :" -"class:`!Traversable`." +"Traverse directories according to *pathsegments* and return the result " +"as :class:`!Traversable`." msgstr "" msgid "" @@ -195,12 +195,12 @@ msgid "" "suitable for reading (same as :attr:`pathlib.Path.open`)." msgstr "" "*mode* може бути \"r\" або \"rb\", щоб відкрити як текстовий або двійковий " -"файл. Повертає дескриптор, придатний для читання (те саме, що :attr:`pathlib." -"Path.open`)." +"файл. Повертає дескриптор, придатний для читання (те саме, " +"що :attr:`pathlib.Path.open`)." msgid "" -"When opening as text, accepts encoding parameters such as those accepted by :" -"class:`io.TextIOWrapper`." +"When opening as text, accepts encoding parameters such as those accepted " +"by :class:`io.TextIOWrapper`." msgstr "" msgid "Read contents of self as bytes." @@ -210,11 +210,12 @@ msgid "Read contents of self as text." msgstr "Прочитати вміст себе як текст." msgid "" -"An abstract base class for resource readers capable of serving the :meth:" -"`importlib.resources.files` interface. Subclasses :class:`ResourceReader` " -"and provides concrete implementations of the :class:`!ResourceReader`'s " -"abstract methods. Therefore, any loader supplying :class:`!" -"TraversableResources` also supplies :class:`!ResourceReader`." +"An abstract base class for resource readers capable of serving " +"the :meth:`importlib.resources.files` interface. " +"Subclasses :class:`ResourceReader` and provides concrete implementations of " +"the :class:`!ResourceReader`'s abstract methods. Therefore, any loader " +"supplying :class:`!TraversableResources` also supplies :class:`!" +"ResourceReader`." msgstr "" msgid "" diff --git a/library/importlib.resources.po b/library/importlib.resources.po index 8752c387a4..ff10f780c8 100644 --- a/library/importlib.resources.po +++ b/library/importlib.resources.po @@ -80,8 +80,8 @@ msgid "" msgstr "" msgid "" -"Represents an anchor for resources, either a :class:`module object ` or a module name as a string. Defined as ``Union[str, " +"Represents an anchor for resources, either a :class:`module object " +"` or a module name as a string. Defined as ``Union[str, " "ModuleType]``." msgstr "" @@ -101,9 +101,10 @@ msgstr "" msgid "" "*package* parameter was renamed to *anchor*. *anchor* can now be a non-" "package module and if omitted will default to the caller's module. *package* " -"is still accepted for compatibility but will raise a :exc:" -"`DeprecationWarning`. Consider passing the anchor positionally or using " -"``importlib_resources >= 5.10`` for a compatible interface on older Pythons." +"is still accepted for compatibility but will raise " +"a :exc:`DeprecationWarning`. Consider passing the anchor positionally or " +"using ``importlib_resources >= 5.10`` for a compatible interface on older " +"Pythons." msgstr "" msgid "" @@ -138,8 +139,9 @@ msgid "For all the following functions:" msgstr "" msgid "" -"*anchor* is an :class:`~importlib.resources.Anchor`, as in :func:`~importlib." -"resources.files`. Unlike in ``files``, it may not be omitted." +"*anchor* is an :class:`~importlib.resources.Anchor`, as " +"in :func:`~importlib.resources.files`. Unlike in ``files``, it may not be " +"omitted." msgstr "" msgid "" diff --git a/library/index.po b/library/index.po index f190fca35f..558c5c57bc 100644 --- a/library/index.po +++ b/library/index.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -23,43 +24,48 @@ msgstr "" "(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" -msgid "The Python Standard Library" +msgid "The Python standard library" msgstr "Biblioteka standardowa Pythona" msgid "" -"While :ref:`reference-index` describes the exact syntax and semantics of the " -"Python language, this library reference manual describes the standard " -"library that is distributed with Python. It also describes some of the " -"optional components that are commonly included in Python distributions." +"This library reference manual describes the standard library distributed " +"with Python. It also describes some of the optional components that are " +"commonly included in Python distributions." msgstr "" -"W odróżnieniu od :ref:`dokumentacji języka Python `, która " -"opisuje dokładną składnię i semantykę języka Python, ta dokumentacja opisuje " -"bibliotekę standardową, która jest rozpowszechniana z Pythonem. Opisuje " -"również niektóre opcjonalne komponenty, które często są zawarte w " -"dystrybucjach Pythona." +"Ta dokumentacja opisuje bibliotekę standardową, która jest rozpowszechniana " +"z Pythonem. Opisuje również niektóre opcjonalne komponenty, które często są " +"zawarte w dystrybucjach Pythona." msgid "" -"Python's standard library is very extensive, offering a wide range of " -"facilities as indicated by the long table of contents listed below. The " -"library contains built-in modules (written in C) that provide access to " -"system functionality such as file I/O that would otherwise be inaccessible " -"to Python programmers, as well as modules written in Python that provide " +"Elsewhere, :ref:`reference-index` describes the exact syntax and semantics " +"of the Python language, and :ref:`builtins-index` describes the built-in " +"functions." +msgstr "" +"Inne miejsce, strona :ref:`reference-index`, opisuje dokładną strukturę " +"składni oraz semantykę języka Python, a strona :ref:`builtins-index` omawia " +"wbudowane funkcje." + +msgid "" +"Python's standard library is extensive, offering a wide range of facilities " +"as indicated by the long table of contents listed below. The library " +"contains built-in modules (written in C) that provide access to system " +"functionality such as file I/O that would otherwise be inaccessible to " +"Python programmers, as well as modules written in Python that provide " "standardized solutions for many problems that occur in everyday programming. " "Some of these modules are explicitly designed to encourage and enhance the " "portability of Python programs by abstracting away platform-specifics into " "platform-neutral APIs." msgstr "" -"Biblioteka standardowa Pythona jest bardzo obszerna i oferuje szeroki " -"wachlarz narzędzi, co widać w długości spisu treści poniżej. Biblioteka " -"zawiera wbudowane moduły (napisane w C), które dają dostęp do " -"funkcjonalności systemowych, takich jak pliki wejścia/wyjścia, które w " -"przeciwnym przypadku byłyby niedostępne dla programistów Pythona. Zawiera " -"również moduły napisane w Pythonie, które dostarczają ustandaryzowane " -"rozwiązania wielu problemów, które napotyka się podczas programowania na co " -"dzień. Niektóre z tych modułów są bezpośrednio zaprojektowane tak, by " -"zachęcać i zwiększać przenośność programów napisanych w Pythonie przez " -"dodawanie abstrakcji nad specyfikami platform i tworzenie API neutralnych " -"platformowo." +"Biblioteka standardowa Pythona jest obszerna i oferuje szeroki wachlarz " +"narzędzi, co widać w długości spisu treści poniżej. Biblioteka zawiera " +"wbudowane moduły (napisane w C), które dają dostęp do funkcjonalności " +"systemowych, takich jak pliki wejścia/wyjścia, które w przeciwnym przypadku " +"byłyby niedostępne dla programistów Pythona. Zawiera również moduły napisane " +"w Pythonie, które dostarczają ustandaryzowane rozwiązania wielu problemów, " +"które napotyka się podczas programowania na co dzień. Niektóre z tych " +"modułów są bezpośrednio zaprojektowane tak, by zachęcać i zwiększać " +"przenośność programów napisanych w Pythonie przez dodawanie abstrakcji nad " +"specyfikami platform i tworzenie API neutralnych platformowo." msgid "" "The Python installers for the Windows platform usually include the entire " diff --git a/library/inspect.po b/library/inspect.po index bd1ed6b756..769dfef2c7 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -50,10 +51,10 @@ msgstr "" msgid "" "The :func:`getmembers` function retrieves the members of an object such as a " "class or module. The functions whose names begin with \"is\" are mainly " -"provided as convenient choices for the second argument to :func:" -"`getmembers`. They also help you determine when you can expect to find the " -"following special attributes (see :ref:`import-mod-attrs` for module " -"attributes):" +"provided as convenient choices for the second argument " +"to :func:`getmembers`. They also help you determine when you can expect to " +"find the following special attributes (see :ref:`import-mod-attrs` for " +"module attributes):" msgstr "" msgid "Type" @@ -486,7 +487,9 @@ msgstr "" msgid "original name of this function or method" msgstr "" -msgid "instance to which a method is bound, or ``None``" +msgid "" +"instance to which a method is bound, or module object a function was defined " +"in, or ``None``" msgstr "" msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators." @@ -568,10 +571,56 @@ msgid "" "Python code." msgstr "" +msgid "" +"This function returns ``False`` for :ref:`generic aliases ` of classes, such as ``list[int]``." +msgstr "" + msgid "Return ``True`` if the object is a bound method written in Python." msgstr "" -msgid "Return ``True`` if the object is a :term:`package`." +msgid "For example, given this class::" +msgstr "" + +msgid "" +">>> class Greeter:\n" +"... def say_hello(self):\n" +"... print('hello!')" +msgstr "" + +msgid "" +"A bound method (also known as an *instance method*) is created when " +"accessing ``say_hello`` (a :term:`function` defined in the ``Greeter`` " +"namespace) through an instance of the ``Greeter`` class::" +msgstr "" + +msgid "" +">>> instance = Greeter()\n" +"\n" +">>> instance.say_hello\n" +">\n" +">>> ismethod(instance.say_hello)\n" +"True\n" +">>> isfunction(instance.say_hello)\n" +"False" +msgstr "" + +msgid "" +"Accessing ``say_hello`` through the ``Greeter`` class will return the " +"function itself. For this function, :func:`ismethod` will return ``False``, " +"but :func:`isfunction` will return ``True``::" +msgstr "" + +msgid "" +">>> Greeter.say_hello\n" +"\n" +">>> ismethod(Greeter.say_hello)\n" +"False\n" +">>> isfunction(Greeter.say_hello)\n" +"True" +msgstr "" + +msgid "See :ref:`typesmethods` for details." msgstr "" msgid "" @@ -579,14 +628,30 @@ msgid "" "created by a :term:`lambda` expression." msgstr "" +msgid "See the note for :func:`~inspect.ismethod` for an example." +msgstr "" + +msgid "Return ``True`` if the object is a :term:`package`." +msgstr "" + msgid "Return ``True`` if the object is a Python generator function." msgstr "" +msgid "" +"It also returns ``True`` for bound methods created from Python generator " +"functions (see :ref:`typesmethods` for more information)." +msgstr "" + msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a Python generator function." msgstr "" +msgid "" +":term:`Duck-typed ` function-like objects now return ``True`` " +"if their code object has the :data:`CO_GENERATOR` flag." +msgstr "" + msgid "" "Functions wrapped in :func:`functools.partialmethod` now return ``True`` if " "the wrapped function is a Python generator function." @@ -598,8 +663,8 @@ msgstr "" msgid "" "Return ``True`` if the object is a :term:`coroutine function` (a function " "defined with an :keyword:`async def` syntax), a :func:`functools.partial` " -"wrapping a :term:`coroutine function`, or a sync function marked with :func:" -"`markcoroutinefunction`." +"wrapping a :term:`coroutine function`, or a sync function marked " +"with :func:`markcoroutinefunction`." msgstr "" msgid "" @@ -607,6 +672,11 @@ msgid "" "wrapped function is a :term:`coroutine function`." msgstr "" +msgid "" +":term:`Duck-typed ` function-like objects now return ``True`` " +"if their code object has the :data:`CO_COROUTINE` flag." +msgstr "" + msgid "" "Sync functions marked with :func:`markcoroutinefunction` now return ``True``." msgstr "" @@ -628,13 +698,13 @@ msgstr "" msgid "" "When possible, using an :keyword:`async def` function is preferred. Also " -"acceptable is calling the function and testing the return with :func:" -"`iscoroutine`." +"acceptable is calling the function and testing the return " +"with :func:`iscoroutine`." msgstr "" msgid "" -"Return ``True`` if the object is a :term:`coroutine` created by an :keyword:" -"`async def` function." +"Return ``True`` if the object is a :term:`coroutine` created by " +"an :keyword:`async def` function." msgstr "" msgid "" @@ -682,6 +752,11 @@ msgid "" "wrapped function is an :term:`asynchronous generator` function." msgstr "" +msgid "" +":term:`Duck-typed ` function-like objects now return ``True`` " +"if their code object has the :data:`CO_ASYNC_GENERATOR` flag." +msgstr "" + msgid "" "Functions wrapped in :func:`functools.partialmethod` now return ``True`` if " "the wrapped function is a :term:`asynchronous generator` function." @@ -711,8 +786,9 @@ msgid "" msgstr "" msgid "" -"These are instances of :class:`~types.MethodWrapperType`, such as :meth:" -"`~object.__str__`, :meth:`~object.__eq__` and :meth:`~object.__repr__`." +"These are instances of :class:`~types.MethodWrapperType`, such " +"as :meth:`~object.__str__`, :meth:`~object.__eq__` " +"and :meth:`~object.__repr__`." msgstr "" msgid "" @@ -724,9 +800,8 @@ msgid "Return ``True`` if the object is an abstract base class." msgstr "" msgid "" -"Return ``True`` if the object is a method descriptor, but not if :func:" -"`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are " -"true." +"Return ``True`` if the object is a method descriptor, but not " +"if :func:`isclass`, :func:`ismethod` or :func:`isfunction` is true." msgstr "" msgid "" @@ -738,59 +813,81 @@ msgid "" msgstr "" msgid "" -"Methods implemented via descriptors that also pass one of the other tests " -"return ``False`` from the :func:`ismethoddescriptor` test, simply because " -"the other tests promise more -- you can, e.g., count on having the :attr:" -"`~method.__func__` attribute (etc) when an object passes :func:`ismethod`." +"Method descriptors that also pass any of the other tests (:func:`!" +"isclass`, :func:`!ismethod` or :func:`!isfunction`) make this function " +"return ``False``, simply because those other tests promise more -- you can, " +"for example, count on having the :attr:`~method.__func__` attribute when an " +"object passes :func:`ismethod`." msgstr "" msgid "" -"This function no longer incorrectly reports objects with :meth:`~object." -"__get__` and :meth:`~object.__delete__`, but not :meth:`~object.__set__`, as " -"being method descriptors (such objects are data descriptors, not method " -"descriptors)." +"This function no longer incorrectly reports objects " +"with :meth:`~object.__get__` and :meth:`~object.__delete__`, but " +"not :meth:`~object.__set__`, as being method descriptors (such objects are " +"data descriptors, not method descriptors)." msgstr "" -msgid "Return ``True`` if the object is a data descriptor." +msgid "" +"Return ``True`` if the object is a data descriptor, but not " +"if :func:`isclass`, :func:`ismethod` or :func:`isfunction` is true." msgstr "" msgid "" -"Data descriptors have a :attr:`~object.__set__` or a :attr:`~object." -"__delete__` method. Examples are properties (defined in Python), getsets, " -"and members. The latter two are defined in C and there are more specific " -"tests available for those types, which is robust across Python " -"implementations. Typically, data descriptors will also have :attr:" -"`~definition.__name__` and :attr:`!__doc__` attributes (properties, getsets, " -"and members have both of these attributes), but this is not guaranteed." +"Data descriptors always have a :meth:`~object.__set__` method and/or " +"a :meth:`~object.__delete__` method. Optionally, they may also have " +"a :meth:`~object.__get__` method." +msgstr "" + +msgid "" +"Examples of data descriptors are :func:`properties `, getsets and " +"member descriptors. Note that for the latter two (defined only in C " +"extension modules), more specific tests are " +"available: :func:`isgetsetdescriptor` and :func:`ismemberdescriptor`, " +"respectively." +msgstr "" + +msgid "" +"While data descriptors may also have :attr:`~definition.__name__` " +"and :attr:`!__doc__` attributes (as properties, getsets and member " +"descriptors do), this is not necessarily the case in general." +msgstr "" + +msgid "" +"This function now reports objects with only a :meth:`~object.__set__` method " +"as being data descriptors (the presence of :meth:`~object.__get__` is no " +"longer required for that). Moreover, objects " +"with :meth:`~object.__delete__`, but not :meth:`~object.__set__`, are now " +"properly recognized as data descriptors as well, which was not the case " +"previously." msgstr "" msgid "Return ``True`` if the object is a getset descriptor." msgstr "" msgid "" -"getsets are attributes defined in extension modules via :c:type:" -"`PyGetSetDef` structures. For Python implementations without such types, " -"this method will always return ``False``." +"getsets are attributes defined in extension modules " +"via :c:type:`PyGetSetDef` structures. For Python implementations without " +"such types, this method will always return ``False``." msgstr "" msgid "Return ``True`` if the object is a member descriptor." msgstr "" msgid "" -"Member descriptors are attributes defined in extension modules via :c:type:" -"`PyMemberDef` structures. For Python implementations without such types, " -"this method will always return ``False``." +"Member descriptors are attributes defined in extension modules " +"via :c:type:`PyMemberDef` structures. For Python implementations without " +"such types, this method will always return ``False``." msgstr "" msgid "Retrieving source code" msgstr "" msgid "" -"Get the documentation string for an object, cleaned up with :func:" -"`cleandoc`. If the documentation string for an object is not provided and " -"the object is a class, a method, a property or a descriptor, retrieve the " -"documentation string from the inheritance hierarchy. Return ``None`` if the " -"documentation string is invalid or missing." +"Get the documentation string for an object, cleaned up " +"with :func:`cleandoc`. If the documentation string for an object is not " +"provided and the object is a class, a method, a property or a descriptor, " +"retrieve the documentation string from the inheritance hierarchy. Return " +"``None`` if the documentation string is invalid or missing." msgstr "" msgid "Documentation strings are now inherited if not overridden." @@ -806,8 +903,9 @@ msgstr "" msgid "" "Return the name of the (text or binary) file in which an object was defined. " -"This will fail with a :exc:`TypeError` if the object is a built-in module, " -"class, or function." +"An :exc:`OSError` is raised if the source code cannot be retrieved. This " +"will fail with a :exc:`TypeError` if the object is a built-in module, class, " +"or function." msgstr "" msgid "" @@ -817,7 +915,8 @@ msgstr "" msgid "" "Return the name of the Python source file in which an object was defined or " -"``None`` if no way can be identified to get the source. This will fail with " +"``None`` if no way can be identified to get the source. An :exc:`OSError` " +"is raised if the source code cannot be retrieved. This will fail with " "a :exc:`TypeError` if the object is a built-in module, class, or function." msgstr "" @@ -893,23 +992,25 @@ msgstr "" msgid "" "If some of the annotations are strings (e.g., because ``from __future__ " "import annotations`` was used), :func:`signature` will attempt to " -"automatically un-stringize the annotations using :func:`annotationlib." -"get_annotations`. The *globals*, *locals*, and *eval_str* parameters are " -"passed into :func:`!annotationlib.get_annotations` when resolving the " -"annotations; see the documentation for :func:`!annotationlib." -"get_annotations` for instructions on how to use these parameters. A member " -"of the :class:`annotationlib.Format` enum can be passed to the " -"*annotation_format* parameter to control the format of the returned " -"annotations. For example, use ``annotation_format=annotationlib.Format." -"STRING`` to return annotations in string format." +"automatically un-stringize the annotations " +"using :func:`annotationlib.get_annotations`. The *globals*, *locals*, and " +"*eval_str* parameters are passed into :func:`!annotationlib.get_annotations` " +"when resolving the annotations; see the documentation for :func:`!" +"annotationlib.get_annotations` for instructions on how to use these " +"parameters. A member of the :class:`annotationlib.Format` enum can be passed " +"to the *annotation_format* parameter to control the format of the returned " +"annotations. For example, use " +"``annotation_format=annotationlib.Format.STRING`` to return annotations in " +"string format." msgstr "" msgid "" -"Raises :exc:`ValueError` if no signature can be provided, and :exc:" -"`TypeError` if that type of object is not supported. Also, if the " +"Raises :exc:`ValueError` if no signature can be provided, " +"and :exc:`TypeError` if that type of object is not supported. Also, if the " "annotations are stringized, and *eval_str* is not false, the ``eval()`` " -"call(s) to un-stringize the annotations in :func:`annotationlib." -"get_annotations` could potentially raise any kind of exception." +"call(s) to un-stringize the annotations " +"in :func:`annotationlib.get_annotations` could potentially raise any kind of " +"exception." msgstr "" msgid "" @@ -974,9 +1075,9 @@ msgid "A special class-level marker to specify absence of a return annotation." msgstr "" msgid "" -"An ordered mapping of parameters' names to the corresponding :class:" -"`Parameter` objects. Parameters appear in strict definition order, " -"including keyword-only parameters." +"An ordered mapping of parameters' names to the " +"corresponding :class:`Parameter` objects. Parameters appear in strict " +"definition order, including keyword-only parameters." msgstr "" msgid "" @@ -1004,11 +1105,11 @@ msgid "" msgstr "" msgid "" -"Create a new :class:`Signature` instance based on the instance :meth:" -"`replace` was invoked on. It is possible to pass different *parameters* and/" -"or *return_annotation* to override the corresponding properties of the base " -"signature. To remove ``return_annotation`` from the copied :class:`!" -"Signature`, pass in :attr:`Signature.empty`." +"Create a new :class:`Signature` instance based on the " +"instance :meth:`replace` was invoked on. It is possible to pass different " +"*parameters* and/or *return_annotation* to override the corresponding " +"properties of the base signature. To remove ``return_annotation`` from the " +"copied :class:`!Signature`, pass in :attr:`Signature.empty`." msgstr "" msgid "" @@ -1022,8 +1123,8 @@ msgid "" msgstr "" msgid "" -":class:`Signature` objects are also supported by the generic function :func:" -"`copy.replace`." +":class:`Signature` objects are also supported by the generic " +"function :func:`copy.replace`." msgstr "" msgid "Create a string representation of the :class:`Signature` object." @@ -1038,9 +1139,9 @@ msgstr "" msgid "" "If *quote_annotation_strings* is False, :term:`annotations ` in " "the signature are displayed without opening and closing quotation marks if " -"they are strings. This is useful if the signature was created with the :attr:" -"`~annotationlib.Format.STRING` format or if ``from __future__ import " -"annotations`` was used." +"they are strings. This is useful if the signature was created with " +"the :attr:`~annotationlib.Format.STRING` format or if ``from __future__ " +"import annotations`` was used." msgstr "" msgid "The *unquote_annotations* parameter was added." @@ -1066,8 +1167,8 @@ msgstr "" msgid "" ":class:`!Parameter` objects are *immutable*. Instead of modifying a :class:`!" -"Parameter` object, you can use :meth:`Parameter.replace` or :func:`copy." -"replace` to create a modified copy." +"Parameter` object, you can use :meth:`Parameter.replace` " +"or :func:`copy.replace` to create a modified copy." msgstr "" msgid "Parameter objects are now picklable and :term:`hashable`." @@ -1105,8 +1206,9 @@ msgstr "" msgid "" "Describes how argument values are bound to the parameter. The possible " -"values are accessible via :class:`Parameter` (like ``Parameter." -"KEYWORD_ONLY``), and support comparison and ordering, in the following order:" +"values are accessible via :class:`Parameter` (like " +"``Parameter.KEYWORD_ONLY``), and support comparison and ordering, in the " +"following order:" msgstr "" msgid "Name" @@ -1212,8 +1314,8 @@ msgid "" msgstr "" msgid "" -":class:`Parameter` objects are also supported by the generic function :func:" -"`copy.replace`." +":class:`Parameter` objects are also supported by the generic " +"function :func:`copy.replace`." msgstr "" msgid "" @@ -1229,8 +1331,8 @@ msgstr "" msgid "" "A mutable mapping of parameters' names to arguments' values. Contains only " -"explicitly bound arguments. Changes in :attr:`arguments` will reflect in :" -"attr:`args` and :attr:`kwargs`." +"explicitly bound arguments. Changes in :attr:`arguments` will reflect " +"in :attr:`args` and :attr:`kwargs`." msgstr "" msgid "" @@ -1240,24 +1342,24 @@ msgstr "" msgid "" "Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` " -"relied on a default value are skipped. However, if needed, use :meth:" -"`BoundArguments.apply_defaults` to add them." +"relied on a default value are skipped. However, if needed, " +"use :meth:`BoundArguments.apply_defaults` to add them." msgstr "" msgid "" -":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :" -"class:`collections.OrderedDict`." +":attr:`arguments` is now of type :class:`dict`. Formerly, it was of " +"type :class:`collections.OrderedDict`." msgstr "" msgid "" -"A tuple of positional arguments values. Dynamically computed from the :attr:" -"`arguments` attribute." +"A tuple of positional arguments values. Dynamically computed from " +"the :attr:`arguments` attribute." msgstr "" msgid "" -"A dict of keyword arguments values. Dynamically computed from the :attr:" -"`arguments` attribute. Arguments that can be passed positionally are " -"included in :attr:`args` instead." +"A dict of keyword arguments values. Dynamically computed from " +"the :attr:`arguments` attribute. Arguments that can be passed positionally " +"are included in :attr:`args` instead." msgstr "" msgid "A reference to the parent :class:`Signature` object." @@ -1316,8 +1418,8 @@ msgid "" msgstr "" msgid "" -"Get the names and default values of a Python function's parameters. A :term:" -"`named tuple` is returned:" +"Get the names and default values of a Python function's parameters. " +"A :term:`named tuple` is returned:" msgstr "" msgid "" @@ -1355,27 +1457,28 @@ msgid "" msgstr "" msgid "" -"This method was previously documented as deprecated in favour of :func:" -"`signature` in Python 3.5, but that decision has been reversed in order to " -"restore a clearly supported standard interface for single-source Python 2/3 " -"code migrating away from the legacy :func:`!getargspec` API." +"This method was previously documented as deprecated in favour " +"of :func:`signature` in Python 3.5, but that decision has been reversed in " +"order to restore a clearly supported standard interface for single-source " +"Python 2/3 code migrating away from the legacy :func:`!getargspec` API." msgstr "" msgid "" -"Get information about arguments passed into a particular frame. A :term:" -"`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is returned. " -"*args* is a list of the argument names. *varargs* and *keywords* are the " -"names of the ``*`` and ``**`` arguments or ``None``. *locals* is the locals " -"dictionary of the given frame." +"Get information about arguments passed into a particular frame. " +"A :term:`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is " +"returned. *args* is a list of the argument names. *varargs* and *keywords* " +"are the names of the ``*`` and ``**`` arguments or ``None``. *locals* is " +"the locals dictionary of the given frame." msgstr "" msgid "This function was inadvertently marked as deprecated in Python 3.5." msgstr "" msgid "" -"Format a pretty argument spec from the four values returned by :func:" -"`getargvalues`. The format\\* arguments are the corresponding optional " -"formatting functions that are called to turn names and values into strings." +"Format a pretty argument spec from the four values returned " +"by :func:`getargvalues`. The format\\* arguments are the corresponding " +"optional formatting functions that are called to turn names and values into " +"strings." msgstr "" msgid "" @@ -1432,17 +1535,17 @@ msgid "" msgstr "" msgid "" -"Get the object wrapped by *func*. It follows the chain of :attr:" -"`__wrapped__` attributes returning the last object in the chain." +"Get the object wrapped by *func*. It follows the chain " +"of :attr:`__wrapped__` attributes returning the last object in the chain." msgstr "" msgid "" "*stop* is an optional callback accepting an object in the wrapper chain as " "its sole argument that allows the unwrapping to be terminated early if the " "callback returns a true value. If the callback never returns a true value, " -"the last object in the chain is returned as usual. For example, :func:" -"`signature` uses this to stop unwrapping if any object in the chain has a " -"``__signature__`` attribute defined." +"the last object in the chain is returned as usual. For " +"example, :func:`signature` uses this to stop unwrapping if any object in the " +"chain has a ``__signature__`` attribute defined." msgstr "" msgid ":exc:`ValueError` is raised if a cycle is encountered." @@ -1457,8 +1560,8 @@ msgid "" msgstr "" msgid "" -"This function may execute arbitrary code contained in annotations. See :ref:" -"`annotationlib-security` for more information." +"This function may execute arbitrary code contained in annotations. " +"See :ref:`annotationlib-security` for more information." msgstr "" msgid "" @@ -1562,9 +1665,10 @@ msgstr "" msgid "" "Though the cycle detector will catch these, destruction of the frames (and " -"local variables) can be made deterministic by removing the cycle in a :" -"keyword:`finally` clause. This is also important if the cycle detector was " -"disabled when Python was compiled or using :func:`gc.disable`. For example::" +"local variables) can be made deterministic by removing the cycle in " +"a :keyword:`finally` clause. This is also important if the cycle detector " +"was disabled when Python was compiled or using :func:`gc.disable`. For " +"example::" msgstr "" msgid "" @@ -1647,14 +1751,14 @@ msgstr "" msgid "" "Both :func:`getattr` and :func:`hasattr` can trigger code execution when " "fetching or checking for the existence of attributes. Descriptors, like " -"properties, will be invoked and :meth:`~object.__getattr__` and :meth:" -"`~object.__getattribute__` may be called." +"properties, will be invoked and :meth:`~object.__getattr__` " +"and :meth:`~object.__getattribute__` may be called." msgstr "" msgid "" "For cases where you want passive introspection, like documentation tools, " -"this can be inconvenient. :func:`getattr_static` has the same signature as :" -"func:`getattr` but avoids executing code when it fetches attributes." +"this can be inconvenient. :func:`getattr_static` has a similar signature " +"as :func:`getattr` but avoids executing code when it fetches attributes." msgstr "" msgid "" @@ -1758,10 +1862,10 @@ msgstr "" msgid "" "Get current state of an asynchronous generator object. The function is " -"intended to be used with asynchronous iterator objects created by :keyword:" -"`async def` functions which use the :keyword:`yield` statement, but will " -"accept any asynchronous generator-like object that has ``ag_running`` and " -"``ag_frame`` attributes." +"intended to be used with asynchronous iterator objects created " +"by :keyword:`async def` functions which use the :keyword:`yield` statement, " +"but will accept any asynchronous generator-like object that has " +"``ag_running`` and ``ag_frame`` attributes." msgstr "" msgid "AGEN_CREATED: Waiting to start execution." @@ -1882,15 +1986,15 @@ msgstr "" msgid "" "This is an :class:`enum.IntFlag` that represents the flags that can be " -"passed to the :meth:`~object.__buffer__` method of objects implementing the :" -"ref:`buffer protocol `." +"passed to the :meth:`~object.__buffer__` method of objects implementing " +"the :ref:`buffer protocol `." msgstr "" msgid "The meaning of the flags is explained at :ref:`buffer-request-types`." msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The :mod:`!inspect` module also provides a basic introspection capability " diff --git a/library/internet.po b/library/internet.po index 31879a4d84..5ab41ba3f1 100644 --- a/library/internet.po +++ b/library/internet.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,9 +29,9 @@ msgstr "" msgid "" "The modules described in this chapter implement internet protocols and " "support for related technology. They are all implemented in Python. Most of " -"these modules require the presence of the system-dependent module :mod:" -"`socket`, which is currently supported on most popular platforms. Here is " -"an overview:" +"these modules require the presence of the system-dependent " +"module :mod:`socket`, which is currently supported on most popular " +"platforms. Here is an overview:" msgstr "" msgid "WWW" diff --git a/library/intro.po b/library/intro.po index a16ef0d11d..c8b516c48f 100644 --- a/library/intro.po +++ b/library/intro.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -26,61 +26,37 @@ msgstr "" msgid "Introduction" msgstr "Wprowadzenie" -msgid "The \"Python library\" contains several different kinds of components." -msgstr "" - -msgid "" -"It contains data types that would normally be considered part of the " -"\"core\" of a language, such as numbers and lists. For these types, the " -"Python language core defines the form of literals and places some " -"constraints on their semantics, but does not fully define the semantics. " -"(On the other hand, the language core does define syntactic properties like " -"the spelling and priorities of operators.)" -msgstr "" - -msgid "" -"The library also contains built-in functions and exceptions --- objects that " -"can be used by all Python code without the need of an :keyword:`import` " -"statement. Some of these are defined by the core language, but many are not " -"essential for the core semantics and are only described here." -msgstr "" - -msgid "" -"The bulk of the library, however, consists of a collection of modules. There " -"are many ways to dissect this collection. Some modules are written in C and " -"built in to the Python interpreter; others are written in Python and " -"imported in source form. Some modules provide interfaces that are highly " -"specific to Python, like printing a stack trace; some provide interfaces " -"that are specific to particular operating systems, such as access to " -"specific hardware; others provide interfaces that are specific to a " -"particular application domain, like the World Wide Web. Some modules are " -"available in all versions and ports of Python; others are only available " -"when the underlying system supports or requires them; yet others are " -"available only when a particular configuration option was chosen at the time " -"when Python was compiled and installed." -msgstr "" - msgid "" -"This manual is organized \"from the inside out:\" it first describes the " -"built-in functions, data types and exceptions, and finally the modules, " -"grouped in chapters of related modules." +"The Python standard library consists of a collection of modules. There are " +"many ways to dissect this collection. Most modules are written in Python, " +"but some are written in C. All can be imported into your program to add " +"functionality. Some modules provide interfaces that are highly specific to " +"Python, like printing a stack trace; some provide interfaces that are " +"specific to particular operating systems, such as access to specific " +"hardware; others provide interfaces that are specific to a particular " +"application domain, like web development. Some modules are available in all " +"versions and ports of Python; others are only available when the underlying " +"system supports or requires them; yet others are available only when a " +"particular configuration option was chosen at the time when Python was " +"compiled and installed." msgstr "" msgid "" -"This means that if you start reading this manual from the start, and skip to " -"the next chapter when you get bored, you will get a reasonable overview of " -"the available modules and application areas that are supported by the Python " +"If you start reading this manual from the start, and skip to the next " +"chapter when you get bored, you will get a reasonable overview of the " +"available modules and application areas that are supported by the Python " "library. Of course, you don't *have* to read it like a novel --- you can " "also browse the table of contents (in front of the manual), or look for a " "specific function, module or term in the index (in the back). And finally, " -"if you enjoy learning about random subjects, you choose a random page number " -"(see module :mod:`random`) and read a section or two. Regardless of the " -"order in which you read the sections of this manual, it helps to start with " -"chapter :ref:`built-in-funcs`, as the remainder of the manual assumes " -"familiarity with this material." +"if you enjoy learning about random subjects, you choose a random page and " +"read a section or two. Regardless of the order in which you read the " +"sections of this manual, it helps to first read :ref:`built-in-funcs`, as " +"the remainder of this section assumes familiarity with this material." msgstr "" -msgid "Let the show begin!" +msgid "" +"The built-in functions and classes (which can be used without " +"an :keyword:`import` statement) are described in :ref:`builtins-index`." msgstr "" msgid "Notes on availability" @@ -138,10 +114,11 @@ msgstr "" msgid "" "Process-related APIs are not available or always fail with an error. That " -"includes APIs that spawn new processes (:func:`~os.fork`, :func:`~os." -"execve`), wait for processes (:func:`~os.waitpid`), send signals (:func:`~os." -"kill`), or otherwise interact with processes. The :mod:`subprocess` is " -"importable but does not work." +"includes APIs that spawn new processes " +"(:func:`~os.fork`, :func:`~os.execve`), wait for processes " +"(:func:`~os.waitpid`), send signals (:func:`~os.kill`), or otherwise " +"interact with processes. The :mod:`subprocess` is importable but does not " +"work." msgstr "" msgid "" @@ -175,10 +152,10 @@ msgstr "" msgid "" "Mobile platforms can only use Python in \"embedded\" mode. There is no " -"Python REPL, and no ability to use separate executables such as :program:" -"`python` or :program:`pip`. To add Python code to your mobile app, you must " -"use the :ref:`Python embedding API `. For more details, see :ref:" -"`using-android` and :ref:`using-ios`." +"Python REPL, and no ability to use separate executables such " +"as :program:`python` or :program:`pip`. To add Python code to your mobile " +"app, you must use the :ref:`Python embedding API `. For more " +"details, see :ref:`using-android` and :ref:`using-ios`." msgstr "" msgid "Subprocesses:" @@ -187,8 +164,8 @@ msgstr "" msgid "" "On Android, creating subprocesses is possible but `officially unsupported " "`__. In " -"particular, Android does not support any part of the System V IPC API, so :" -"mod:`multiprocessing` is not available." +"particular, Android does not support any part of the System V IPC API, " +"so :mod:`multiprocessing` is not available." msgstr "" msgid "" @@ -212,8 +189,8 @@ msgstr "" msgid "" "On Android, the native ``stdout`` and ``stderr`` are not connected to " "anything, so Python installs its own streams which redirect messages to the " -"system log. These can be seen under the tags ``python.stdout`` and ``python." -"stderr`` respectively." +"system log. These can be seen under the tags ``python.stdout`` and " +"``python.stderr`` respectively." msgstr "" msgid "" @@ -232,6 +209,6 @@ msgid "" msgstr "" msgid "" -"As a result, Python modules that involve console manipulation (such as :mod:" -"`curses` and :mod:`readline`) are not available on mobile platforms." +"As a result, Python modules that involve console manipulation (such " +"as :mod:`curses` and :mod:`readline`) are not available on mobile platforms." msgstr "" diff --git a/library/io.po b/library/io.po index c137c5c3ac..6eb01ed2dc 100644 --- a/library/io.po +++ b/library/io.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -52,8 +52,8 @@ msgstr "" msgid "" "All streams are careful about the type of data you give to them. For " "example giving a :class:`str` object to the :meth:`!write` method of a " -"binary stream will raise a :exc:`TypeError`. So will giving a :class:" -"`bytes` object to the :meth:`!write` method of a text stream." +"binary stream will raise a :exc:`TypeError`. So will giving " +"a :class:`bytes` object to the :meth:`!write` method of a text stream." msgstr "" msgid "" @@ -93,8 +93,8 @@ msgid "" msgstr "" msgid "" -"The text stream API is described in detail in the documentation of :class:" -"`TextIOBase`." +"The text stream API is described in detail in the documentation " +"of :class:`TextIOBase`." msgstr "" msgid "Binary I/O" @@ -124,8 +124,8 @@ msgid "f = io.BytesIO(b\"some initial binary data: \\x00\\x01\")" msgstr "" msgid "" -"The binary stream API is described in detail in the docs of :class:" -"`BufferedIOBase`." +"The binary stream API is described in detail in the docs " +"of :class:`BufferedIOBase`." msgstr "" msgid "" @@ -150,6 +150,15 @@ msgid "" "The raw stream API is described in detail in the docs of :class:`RawIOBase`." msgstr "" +msgid "" +"Raw I/O is a low-level interface and methods generally must have their " +"return values checked and be explicitly retried to ensure an operation " +"completes. For instance :meth:`~RawIOBase.write` returns the number of bytes " +"written which may be less than the number of bytes provided (a partial " +"write). High-level I/O objects like :ref:`binary-io` and :ref:`text-io` " +"implement retry behavior." +msgstr "" + msgid "Text Encoding" msgstr "" @@ -199,18 +208,19 @@ msgid "See :pep:`597` for more details." msgstr "" msgid "" -"To find where the default locale encoding is used, you can enable the :" -"option:`-X warn_default_encoding <-X>` command line option or set the :" -"envvar:`PYTHONWARNDEFAULTENCODING` environment variable, which will emit an :" -"exc:`EncodingWarning` when the default encoding is used." +"To find where the default locale encoding is used, you can enable " +"the :option:`-X warn_default_encoding <-X>` command line option or set " +"the :envvar:`PYTHONWARNDEFAULTENCODING` environment variable, which will " +"emit an :exc:`EncodingWarning` when the default encoding is used." msgstr "" msgid "" "If you are providing an API that uses :func:`open` or :class:`TextIOWrapper` " -"and passes ``encoding=None`` as a parameter, you can use :func:" -"`text_encoding` so that callers of the API will emit an :exc:" -"`EncodingWarning` if they don't pass an ``encoding``. However, please " -"consider using UTF-8 by default (i.e. ``encoding=\"utf-8\"``) for new APIs." +"and passes ``encoding=None`` as a parameter, you can " +"use :func:`text_encoding` so that callers of the API will emit " +"an :exc:`EncodingWarning` if they don't pass an ``encoding``. However, " +"please consider using UTF-8 by default (i.e. ``encoding=\"utf-8\"``) for new " +"APIs." msgstr "" msgid "High-level Module Interface" @@ -218,8 +228,8 @@ msgstr "" msgid "" "An int containing the default buffer size used by the module's buffered I/O " -"classes. :func:`open` uses the file's blksize (as obtained by :func:`os." -"stat`) if possible." +"classes. :func:`open` uses the file's blksize (as obtained " +"by :func:`os.stat`) if possible." msgstr "" msgid "This is an alias for the builtin :func:`open` function." @@ -240,16 +250,16 @@ msgid "*path* should be a :class:`str` and an absolute path." msgstr "" msgid "" -"The behavior of this function may be overridden by an earlier call to the :c:" -"func:`PyFile_SetOpenCodeHook`. However, assuming that *path* is a :class:" -"`str` and an absolute path, ``open_code(path)`` should always behave the " -"same as ``open(path, 'rb')``. Overriding the behavior is intended for " -"additional validation or preprocessing of the file." +"The behavior of this function may be overridden by an earlier call to " +"the :c:func:`PyFile_SetOpenCodeHook`. However, assuming that *path* is " +"a :class:`str` and an absolute path, ``open_code(path)`` should always " +"behave the same as ``open(path, 'rb')``. Overriding the behavior is intended " +"for additional validation or preprocessing of the file." msgstr "" msgid "" -"This is a helper function for callables that use :func:`open` or :class:" -"`TextIOWrapper` and have an ``encoding=None`` parameter." +"This is a helper function for callables that use :func:`open` " +"or :class:`TextIOWrapper` and have an ``encoding=None`` parameter." msgstr "" msgid "" @@ -259,9 +269,10 @@ msgid "" msgstr "" msgid "" -"This function emits an :class:`EncodingWarning` if :data:`sys.flags." -"warn_default_encoding ` is true and *encoding* is ``None``. " -"*stacklevel* specifies where the warning is emitted. For example::" +"This function emits an :class:`EncodingWarning` " +"if :data:`sys.flags.warn_default_encoding ` is true and " +"*encoding* is ``None``. *stacklevel* specifies where the warning is emitted. " +"For example::" msgstr "" msgid "" @@ -315,8 +326,8 @@ msgstr "" msgid "" "The abstract base classes also provide default implementations of some " "methods in order to help implementation of concrete stream classes. For " -"example, :class:`BufferedIOBase` provides unoptimized implementations of :" -"meth:`!readinto` and :meth:`!readline`." +"example, :class:`BufferedIOBase` provides unoptimized implementations " +"of :meth:`!readinto` and :meth:`!readline`." msgstr "" msgid "" @@ -329,18 +340,20 @@ msgstr "" msgid "" "The :class:`RawIOBase` ABC extends :class:`IOBase`. It deals with the " -"reading and writing of bytes to a stream. :class:`FileIO` subclasses :class:" -"`RawIOBase` to provide an interface to files in the machine's file system." +"reading and writing of bytes to a stream. :class:`FileIO` " +"subclasses :class:`RawIOBase` to provide an interface to files in the " +"machine's file system." msgstr "" msgid "" "The :class:`BufferedIOBase` ABC extends :class:`IOBase`. It deals with " -"buffering on a raw binary stream (:class:`RawIOBase`). Its subclasses, :" -"class:`BufferedWriter`, :class:`BufferedReader`, and :class:`BufferedRWPair` " -"buffer raw binary streams that are writable, readable, and both readable and " -"writable, respectively. :class:`BufferedRandom` provides a buffered " -"interface to seekable streams. Another :class:`BufferedIOBase` subclass, :" -"class:`BytesIO`, is a stream of in-memory bytes." +"buffering on a raw binary stream (:class:`RawIOBase`). Its " +"subclasses, :class:`BufferedWriter`, :class:`BufferedReader`, " +"and :class:`BufferedRWPair` buffer raw binary streams that are writable, " +"readable, and both readable and writable, " +"respectively. :class:`BufferedRandom` provides a buffered interface to " +"seekable streams. Another :class:`BufferedIOBase` " +"subclass, :class:`BytesIO`, is a stream of in-memory bytes." msgstr "" msgid "" @@ -352,8 +365,8 @@ msgid "" msgstr "" msgid "" -"Argument names are not part of the specification, and only the arguments of :" -"func:`open` are intended to be used as keyword arguments." +"Argument names are not part of the specification, and only the arguments " +"of :func:`open` are intended to be used as keyword arguments." msgstr "" msgid "" @@ -433,9 +446,10 @@ msgid "" msgstr "" msgid "" -"The basic type used for binary data read from or written to a file is :class:" -"`bytes`. Other :term:`bytes-like objects ` are accepted " -"as method arguments too. Text I/O classes work with :class:`str` data." +"The basic type used for binary data read from or written to a file " +"is :class:`bytes`. Other :term:`bytes-like objects ` are " +"accepted as method arguments too. Text I/O classes work with :class:`str` " +"data." msgstr "" msgid "" @@ -452,9 +466,10 @@ msgid "" msgstr "" msgid "" -":class:`IOBase` is also a context manager and therefore supports the :" -"keyword:`with` statement. In this example, *file* is closed after the :" -"keyword:`!with` statement's suite is finished---even if an exception occurs::" +":class:`IOBase` is also a context manager and therefore supports " +"the :keyword:`with` statement. In this example, *file* is closed after " +"the :keyword:`!with` statement's suite is finished---even if an exception " +"occurs::" msgstr "" msgid "" @@ -551,14 +566,15 @@ msgid "The :data:`!SEEK_*` constants." msgstr "" msgid "" -"Some operating systems could support additional values, like :const:`os." -"SEEK_HOLE` or :const:`os.SEEK_DATA`. The valid values for a file could " -"depend on it being open in text or binary mode." +"Some operating systems could support additional values, " +"like :const:`os.SEEK_HOLE` or :const:`os.SEEK_DATA`. The valid values for a " +"file could depend on it being open in text or binary mode." msgstr "" msgid "" -"Return ``True`` if the stream supports random access. If ``False``, :meth:" -"`seek`, :meth:`tell` and :meth:`truncate` will raise :exc:`OSError`." +"Return ``True`` if the stream supports random access. If " +"``False``, :meth:`seek`, :meth:`tell` and :meth:`truncate` will " +"raise :exc:`OSError`." msgstr "" msgid "Return the current stream position." @@ -587,8 +603,8 @@ msgstr "" msgid "" "Prepare for object destruction. :class:`IOBase` provides a default " -"implementation of this method that calls the instance's :meth:`~IOBase." -"close` method." +"implementation of this method that calls the " +"instance's :meth:`~IOBase.close` method." msgstr "" msgid "Base class for raw binary streams. It inherits from :class:`IOBase`." @@ -602,15 +618,20 @@ msgid "" msgstr "" msgid "" -":class:`RawIOBase` provides these methods in addition to those from :class:" -"`IOBase`:" +":class:`RawIOBase` provides these methods in addition to those " +"from :class:`IOBase`:" msgstr "" msgid "" "Read up to *size* bytes from the object and return them. As a convenience, " -"if *size* is unspecified or -1, all bytes until EOF are returned. Otherwise, " -"only one system call is ever made. Fewer than *size* bytes may be returned " -"if the operating system call returns fewer than *size* bytes." +"if *size* is unspecified or -1, all bytes until EOF are returned." +msgstr "" + +msgid "" +"Attempts to make only one system call but will retry if interrupted and the " +"signal handler does not raise an exception (see :pep:`475` for the " +"rationale). This means fewer than *size* bytes may be returned if the " +"operating system call returns fewer than *size* bytes." msgstr "" msgid "" @@ -628,11 +649,22 @@ msgid "" "calls to the stream if necessary." msgstr "" +msgid "" +"If ``0`` bytes are returned this indicates end of file. If the object is in " +"non-blocking mode and the underlying :meth:`read` returns ``None`` " +"indicating no bytes are available, ``None`` is returned." +msgstr "" + msgid "" "Read bytes into a pre-allocated, writable :term:`bytes-like object` *b*, and " -"return the number of bytes read. For example, *b* might be a :class:" -"`bytearray`. If the object is in non-blocking mode and no bytes are " -"available, ``None`` is returned." +"return the number of bytes read. For example, *b* might be " +"a :class:`bytearray`." +msgstr "" + +msgid "" +"If ``0`` is returned and ``len(b)`` is not ``0``, this indicates end of " +"file. If the object is in non-blocking mode and no bytes are available, " +"``None`` is returned." msgstr "" msgid "" @@ -645,15 +677,24 @@ msgid "" "the implementation should only access *b* during the method call." msgstr "" +msgid "" +"This function does not ensure all bytes are written or an exception is " +"thrown. Callers may implement that behavior by checking the return value " +"and, if it is less than the length of *b*, looping with additional write " +"calls until all unwritten bytes are written. High-level I/O objects " +"like :ref:`binary-io` and :ref:`text-io` implement retry behavior." +msgstr "" + msgid "" "Base class for binary streams that support some kind of buffering. It " "inherits from :class:`IOBase`." msgstr "" msgid "" -"The main difference with :class:`RawIOBase` is that methods :meth:`read`, :" -"meth:`readinto` and :meth:`write` will try (respectively) to read as much " -"input as requested or to emit all provided data." +"The main difference with :class:`RawIOBase` is that " +"methods :meth:`read`, :meth:`readinto` and :meth:`write` will try " +"(respectively) to read as much input as requested or to emit all provided " +"data." msgstr "" msgid "" @@ -669,9 +710,9 @@ msgid "" msgstr "" msgid "" -"A typical :class:`BufferedIOBase` implementation should not inherit from a :" -"class:`RawIOBase` implementation, but wrap one, like :class:`BufferedWriter` " -"and :class:`BufferedReader` do." +"A typical :class:`BufferedIOBase` implementation should not inherit from " +"a :class:`RawIOBase` implementation, but wrap one, " +"like :class:`BufferedWriter` and :class:`BufferedReader` do." msgstr "" msgid "" @@ -680,9 +721,9 @@ msgid "" msgstr "" msgid "" -"The underlying raw stream (a :class:`RawIOBase` instance) that :class:" -"`BufferedIOBase` deals with. This is not part of the :class:" -"`BufferedIOBase` API and may not exist on some implementations." +"The underlying raw stream (a :class:`RawIOBase` instance) " +"that :class:`BufferedIOBase` deals with. This is not part of " +"the :class:`BufferedIOBase` API and may not exist on some implementations." msgstr "" msgid "Separate the underlying raw stream from the buffer and return it." @@ -705,23 +746,24 @@ msgstr "" msgid "" "Fewer bytes may be returned than requested. An empty :class:`bytes` object " "is returned if the stream is already at EOF. More than one read may be made " -"and calls may be retried if specific errors are encountered, see :meth:`os." -"read` and :pep:`475` for more details. Less than size bytes being returned " -"does not imply that EOF is imminent." +"and calls may be retried if specific errors are encountered, " +"see :meth:`os.read` and :pep:`475` for more details. Less than size bytes " +"being returned does not imply that EOF is imminent." msgstr "" msgid "" -"When reading as much as possible the default implementation will use ``raw." -"readall`` if available (which should implement :meth:`RawIOBase.readall`), " -"otherwise will read in a loop until read returns ``None``, an empty :class:" -"`bytes`, or a non-retryable error. For most streams this is to EOF, but for " -"non-blocking streams more data may become available." +"When reading as much as possible the default implementation will use " +"``raw.readall`` if available (which should " +"implement :meth:`RawIOBase.readall`), otherwise will read in a loop until " +"read returns ``None``, an empty :class:`bytes`, or a non-retryable error. " +"For most streams this is to EOF, but for non-blocking streams more data may " +"become available." msgstr "" msgid "" "When the underlying raw stream is non-blocking, implementations may either " -"raise :exc:`BlockingIOError` or return ``None`` if no data is available. :" -"mod:`!io` implementations return ``None``." +"raise :exc:`BlockingIOError` or return ``None`` if no data is " +"available. :mod:`!io` implementations return ``None``." msgstr "" msgid "" @@ -733,8 +775,8 @@ msgstr "" msgid "" "Read bytes into a pre-allocated, writable :term:`bytes-like object` *b* and " -"return the number of bytes read. For example, *b* might be a :class:" -"`bytearray`." +"return the number of bytes read. For example, *b* might be " +"a :class:`bytearray`." msgstr "" msgid "" @@ -749,9 +791,9 @@ msgstr "" msgid "" "Read bytes into a pre-allocated, writable :term:`bytes-like object` *b*, " -"using at most one call to the underlying raw stream's :meth:`~RawIOBase." -"read` (or :meth:`~RawIOBase.readinto`) method. Return the number of bytes " -"read." +"using at most one call to the underlying raw " +"stream's :meth:`~RawIOBase.read` (or :meth:`~RawIOBase.readinto`) method. " +"Return the number of bytes read." msgstr "" msgid "" @@ -778,7 +820,11 @@ msgstr "" msgid "" "A raw binary stream representing an OS-level file containing bytes data. It " -"inherits from :class:`RawIOBase`." +"inherits from :class:`RawIOBase` and implements its low-level access design. " +"This means :meth:`~RawIOBase.write` does not guarantee all bytes are written " +"and :meth:`~RawIOBase.read` may read less bytes than requested even when " +"more bytes may be present in the underlying file. To get \"write all\" and " +"\"read at least\" behavior, use :ref:`binary-io`." msgstr "" msgid "The *name* can be one of two things:" @@ -807,12 +853,6 @@ msgid "" "``'+'`` to the mode to allow simultaneous reading and writing." msgstr "" -msgid "" -"The :meth:`~RawIOBase.read` (when called with a positive argument), :meth:" -"`~RawIOBase.readinto` and :meth:`~RawIOBase.write` methods on this class " -"will only make one system call." -msgstr "" - msgid "" "A custom opener can be used by passing a callable as *opener*. The " "underlying file descriptor for the file object is then obtained by calling " @@ -829,6 +869,14 @@ msgid "" "parameter." msgstr "" +msgid "" +":class:`FileIO` is a low-level I/O object and members, such " +"as :meth:`~RawIOBase.read` and :meth:`~RawIOBase.write`, need to have their " +"return values checked explicitly in a retry loop to implement \"write all\" " +"and \"read at least\" behavior. High-level I/O objects :ref:`binary-io` " +"and :ref:`text-io` implement retry behavior." +msgstr "" + msgid "The *opener* parameter was added. The ``'x'`` mode was added." msgstr "" @@ -836,8 +884,8 @@ msgid "The file is now non-inheritable." msgstr "Plik nie jest teraz dziedziczony." msgid "" -":class:`FileIO` provides these data attributes in addition to those from :" -"class:`RawIOBase` and :class:`IOBase`:" +":class:`FileIO` provides these data attributes in addition to those " +"from :class:`RawIOBase` and :class:`IOBase`:" msgstr "" msgid "The mode as given in the constructor." @@ -857,9 +905,9 @@ msgid "" msgstr "" msgid "" -"A binary stream using an in-memory bytes buffer. It inherits from :class:" -"`BufferedIOBase`. The buffer is discarded when the :meth:`~IOBase.close` " -"method is called." +"A binary stream using an in-memory bytes buffer. It inherits " +"from :class:`BufferedIOBase`. The buffer is discarded when " +"the :meth:`~IOBase.close` method is called." msgstr "" msgid "" @@ -906,8 +954,8 @@ msgstr "" msgid "" "A buffered binary stream providing higher-level access to a readable, non " -"seekable :class:`RawIOBase` raw binary stream. It inherits from :class:" -"`BufferedIOBase`." +"seekable :class:`RawIOBase` raw binary stream. It inherits " +"from :class:`BufferedIOBase`." msgstr "" msgid "" @@ -918,8 +966,8 @@ msgstr "" msgid "" "The constructor creates a :class:`BufferedReader` for the given readable " -"*raw* stream and *buffer_size*. If *buffer_size* is omitted, :data:" -"`DEFAULT_BUFFER_SIZE` is used." +"*raw* stream and *buffer_size*. If *buffer_size* is " +"omitted, :data:`DEFAULT_BUFFER_SIZE` is used." msgstr "" msgid "" @@ -938,14 +986,14 @@ msgid "" msgstr "" msgid "" -"In :class:`BufferedReader` this is the same as :meth:`io.BufferedIOBase." -"read1`" +"In :class:`BufferedReader` this is the same " +"as :meth:`io.BufferedIOBase.read1`" msgstr "" msgid "" "A buffered binary stream providing higher-level access to a writeable, non " -"seekable :class:`RawIOBase` raw binary stream. It inherits from :class:" -"`BufferedIOBase`." +"seekable :class:`RawIOBase` raw binary stream. It inherits " +"from :class:`BufferedIOBase`." msgstr "" msgid "" @@ -970,8 +1018,8 @@ msgstr "" msgid "" "The constructor creates a :class:`BufferedWriter` for the given writeable " -"*raw* stream. If the *buffer_size* is not given, it defaults to :data:" -"`DEFAULT_BUFFER_SIZE`." +"*raw* stream. If the *buffer_size* is not given, it defaults " +"to :data:`DEFAULT_BUFFER_SIZE`." msgstr "" msgid "" @@ -980,51 +1028,51 @@ msgid "" msgstr "" msgid "" -"Force bytes held in the buffer into the raw stream. A :exc:" -"`BlockingIOError` should be raised if the raw stream blocks." +"Force bytes held in the buffer into the raw stream. " +"A :exc:`BlockingIOError` should be raised if the raw stream blocks." msgstr "" msgid "" "Write the :term:`bytes-like object`, *b*, and return the number of bytes " -"written. When in non-blocking mode, a :exc:`BlockingIOError` with :attr:" -"`BlockingIOError.characters_written` set is raised if the buffer needs to be " -"written out but the raw stream blocks." +"written. When in non-blocking mode, a :exc:`BlockingIOError` " +"with :attr:`BlockingIOError.characters_written` set is raised if the buffer " +"needs to be written out but the raw stream blocks." msgstr "" msgid "" -"A buffered binary stream providing higher-level access to a seekable :class:" -"`RawIOBase` raw binary stream. It inherits from :class:`BufferedReader` " -"and :class:`BufferedWriter`." +"A buffered binary stream implementing :class:`BufferedIOBase` interfaces " +"providing higher-level access to a seekable :class:`RawIOBase` raw binary " +"stream." msgstr "" msgid "" "The constructor creates a reader and writer for a seekable raw stream, given " -"in the first argument. If the *buffer_size* is omitted it defaults to :data:" -"`DEFAULT_BUFFER_SIZE`." +"in the first argument. If the *buffer_size* is omitted it defaults " +"to :data:`DEFAULT_BUFFER_SIZE`." msgstr "" msgid "" -":class:`BufferedRandom` is capable of anything :class:`BufferedReader` or :" -"class:`BufferedWriter` can do. In addition, :meth:`~IOBase.seek` and :meth:" -"`~IOBase.tell` are guaranteed to be implemented." +":class:`BufferedRandom` is capable of anything :class:`BufferedReader` " +"or :class:`BufferedWriter` can do. In addition, :meth:`~IOBase.seek` " +"and :meth:`~IOBase.tell` are guaranteed to be implemented." msgstr "" msgid "" -"A buffered binary stream providing higher-level access to two non seekable :" -"class:`RawIOBase` raw binary streams---one readable, the other writeable. It " -"inherits from :class:`BufferedIOBase`." +"A buffered binary stream providing higher-level access to two non " +"seekable :class:`RawIOBase` raw binary streams---one readable, the other " +"writeable. It inherits from :class:`BufferedIOBase`." msgstr "" msgid "" "*reader* and *writer* are :class:`RawIOBase` objects that are readable and " -"writeable respectively. If the *buffer_size* is omitted it defaults to :" -"data:`DEFAULT_BUFFER_SIZE`." +"writeable respectively. If the *buffer_size* is omitted it defaults " +"to :data:`DEFAULT_BUFFER_SIZE`." msgstr "" msgid "" ":class:`BufferedRWPair` implements all of :class:`BufferedIOBase`\\'s " -"methods except for :meth:`~BufferedIOBase.detach`, which raises :exc:" -"`UnsupportedOperation`." +"methods except for :meth:`~BufferedIOBase.detach`, which " +"raises :exc:`UnsupportedOperation`." msgstr "" msgid "" @@ -1058,9 +1106,10 @@ msgid "" msgstr "" msgid "" -"The underlying binary buffer (a :class:`BufferedIOBase` or :class:" -"`RawIOBase` instance) that :class:`TextIOBase` deals with. This is not part " -"of the :class:`TextIOBase` API and may not exist in some implementations." +"The underlying binary buffer (a :class:`BufferedIOBase` " +"or :class:`RawIOBase` instance) that :class:`TextIOBase` deals with. This is " +"not part of the :class:`TextIOBase` API and may not exist in some " +"implementations." msgstr "" msgid "" @@ -1075,13 +1124,13 @@ msgstr "" msgid "" "Some :class:`TextIOBase` implementations, like :class:`StringIO`, may not " -"have the concept of an underlying buffer and calling this method will raise :" -"exc:`UnsupportedOperation`." +"have the concept of an underlying buffer and calling this method will " +"raise :exc:`UnsupportedOperation`." msgstr "" msgid "" -"Read and return at most *size* characters from the stream as a single :class:" -"`str`. If *size* is negative or ``None``, reads until EOF." +"Read and return at most *size* characters from the stream as a " +"single :class:`str`. If *size* is negative or ``None``, reads until EOF." msgstr "" msgid "" @@ -1127,9 +1176,9 @@ msgid "" msgstr "" msgid "" -"A buffered text stream providing higher-level access to a :class:" -"`BufferedIOBase` buffered binary stream. It inherits from :class:" -"`TextIOBase`." +"A buffered text stream providing higher-level access to " +"a :class:`BufferedIOBase` buffered binary stream. It inherits " +"from :class:`TextIOBase`." msgstr "" msgid "" @@ -1160,10 +1209,10 @@ msgid "" msgstr "" msgid "" -"When reading input from the stream, if *newline* is ``None``, :term:" -"`universal newlines` mode is enabled. Lines in the input can end in " -"``'\\n'``, ``'\\r'``, or ``'\\r\\n'``, and these are translated into " -"``'\\n'`` before being returned to the caller. If *newline* is ``''``, " +"When reading input from the stream, if *newline* is " +"``None``, :term:`universal newlines` mode is enabled. Lines in the input " +"can end in ``'\\n'``, ``'\\r'``, or ``'\\r\\n'``, and these are translated " +"into ``'\\n'`` before being returned to the caller. If *newline* is ``''``, " "universal newlines mode is enabled, but line endings are returned to the " "caller untranslated. If *newline* has any of the other legal values, input " "lines are only terminated by the given string, and the line ending is " @@ -1172,10 +1221,10 @@ msgstr "" msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " -"characters written are translated to the system default line separator, :" -"data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no translation " -"takes place. If *newline* is any of the other legal values, any ``'\\n'`` " -"characters written are translated to the given string." +"characters written are translated to the system default line " +"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no " +"translation takes place. If *newline* is any of the other legal values, any " +"``'\\n'`` characters written are translated to the given string." msgstr "" "Podczas zapisywania danych wyjściowych do strumienia, jeśli *newline* ma " "wartość ``None``, wszelkie zapisane ``'\\n'`` znaki są tłumaczone na " @@ -1191,9 +1240,9 @@ msgstr "" msgid "" "If *write_through* is ``True``, calls to :meth:`~BufferedIOBase.write` are " -"guaranteed not to be buffered: any data written on the :class:" -"`TextIOWrapper` object is immediately handled to its underlying binary " -"*buffer*." +"guaranteed not to be buffered: any data written on " +"the :class:`TextIOWrapper` object is immediately handled to its underlying " +"binary *buffer*." msgstr "" msgid "The *write_through* argument has been added." @@ -1284,8 +1333,8 @@ msgid "" msgstr "" msgid "" -"A text stream using an in-memory text buffer. It inherits from :class:" -"`TextIOBase`." +"A text stream using an in-memory text buffer. It inherits " +"from :class:`TextIOBase`." msgstr "" msgid "" @@ -1294,10 +1343,10 @@ msgstr "" msgid "" "The initial value of the buffer can be set by providing *initial_value*. If " -"newline translation is enabled, newlines will be encoded as if by :meth:" -"`~TextIOBase.write`. The stream is positioned at the start of the buffer " -"which emulates opening an existing file in a ``w+`` mode, making it ready " -"for an immediate write from the beginning or for a write that would " +"newline translation is enabled, newlines will be encoded as if " +"by :meth:`~TextIOBase.write`. The stream is positioned at the start of the " +"buffer which emulates opening an existing file in a ``w+`` mode, making it " +"ready for an immediate write from the beginning or for a write that would " "overwrite the initial value. To emulate opening a file in an ``a+`` mode " "ready for appending, use ``f.seek(0, io.SEEK_END)`` to reposition the stream " "at the end of the buffer." @@ -1310,8 +1359,8 @@ msgid "" msgstr "" msgid "" -":class:`StringIO` provides this method in addition to those from :class:" -"`TextIOBase` and :class:`IOBase`:" +":class:`StringIO` provides this method in addition to those " +"from :class:`TextIOBase` and :class:`IOBase`:" msgstr "" msgid "" @@ -1419,9 +1468,9 @@ msgid "" "Text I/O over a binary storage (such as a file) is significantly slower than " "binary I/O over the same storage, because it requires conversions between " "unicode and binary data using a character codec. This can become noticeable " -"handling huge amounts of text data like large log files. Also, :meth:" -"`~TextIOBase.tell` and :meth:`~TextIOBase.seek` are both quite slow due to " -"the reconstruction algorithm used." +"handling huge amounts of text data like large log files. " +"Also, :meth:`~TextIOBase.tell` and :meth:`~TextIOBase.seek` are both quite " +"slow due to the reconstruction algorithm used." msgstr "" msgid "" @@ -1439,10 +1488,10 @@ msgid "" msgstr "" msgid "" -"Binary buffered objects (instances of :class:`BufferedReader`, :class:" -"`BufferedWriter`, :class:`BufferedRandom` and :class:`BufferedRWPair`) " -"protect their internal structures using a lock; it is therefore safe to call " -"them from multiple threads at once." +"Binary buffered objects (instances " +"of :class:`BufferedReader`, :class:`BufferedWriter`, :class:`BufferedRandom` " +"and :class:`BufferedRWPair`) protect their internal structures using a lock; " +"it is therefore safe to call them from multiple threads at once." msgstr "" msgid ":class:`TextIOWrapper` objects are not thread-safe." @@ -1452,13 +1501,13 @@ msgid "Reentrancy" msgstr "" msgid "" -"Binary buffered objects (instances of :class:`BufferedReader`, :class:" -"`BufferedWriter`, :class:`BufferedRandom` and :class:`BufferedRWPair`) are " -"not reentrant. While reentrant calls will not happen in normal situations, " -"they can arise from doing I/O in a :mod:`signal` handler. If a thread tries " -"to re-enter a buffered object which it is already accessing, a :exc:" -"`RuntimeError` is raised. Note this doesn't prohibit a different thread " -"from entering the buffered object." +"Binary buffered objects (instances " +"of :class:`BufferedReader`, :class:`BufferedWriter`, :class:`BufferedRandom` " +"and :class:`BufferedRWPair`) are not reentrant. While reentrant calls will " +"not happen in normal situations, they can arise from doing I/O in " +"a :mod:`signal` handler. If a thread tries to re-enter a buffered object " +"which it is already accessing, a :exc:`RuntimeError` is raised. Note this " +"doesn't prohibit a different thread from entering the buffered object." msgstr "" msgid "" diff --git a/library/ipaddress.po b/library/ipaddress.po index b319b10caa..45382620e8 100644 --- a/library/ipaddress.po +++ b/library/ipaddress.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,8 +43,8 @@ msgid "" msgstr "" msgid "" -"This is the full module API reference—for an overview and introduction, see :" -"ref:`ipaddress-howto`." +"This is the full module API reference—for an overview and introduction, " +"see :ref:`ipaddress-howto`." msgstr "" msgid "Convenience factory functions" @@ -77,9 +77,9 @@ msgid "" "Return an :class:`IPv4Interface` or :class:`IPv6Interface` object depending " "on the IP address passed as argument. *address* is a string or integer " "representing the IP address. Either IPv4 or IPv6 addresses may be supplied; " -"integers less than ``2**32`` will be considered to be IPv4 by default. A :" -"exc:`ValueError` is raised if *address* does not represent a valid IPv4 or " -"IPv6 address." +"integers less than ``2**32`` will be considered to be IPv4 by default. " +"A :exc:`ValueError` is raised if *address* does not represent a valid IPv4 " +"or IPv6 address." msgstr "" msgid "" @@ -262,8 +262,8 @@ msgid "" msgstr "" msgid "" -"``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) or :RFC:" -"`2373` (for IPv6)." +"``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) " +"or :RFC:`2373` (for IPv6)." msgstr "" msgid "" @@ -280,13 +280,13 @@ msgstr "" msgid "" "For IPv6, ``fec0::/10`` a former Site-Local scoped address prefix is " -"currently excluded from that list (see :attr:`~IPv6Address.is_site_local` & :" -"rfc:`3879`)." +"currently excluded from that list (see :attr:`~IPv6Address.is_site_local` " +"& :rfc:`3879`)." msgstr "" msgid "" -"``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) or :RFC:" -"`2373` (for IPv6)." +"``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) " +"or :RFC:`2373` (for IPv6)." msgstr "" msgid "" @@ -294,8 +294,8 @@ msgid "" msgstr "" msgid "" -":class:`IPv4Address` object representing the IPv4-mapped IPv6 address. See :" -"RFC:`4291`." +":class:`IPv6Address` object representing the IPv4-mapped IPv6 address. " +"See :RFC:`4291`." msgstr "" msgid "" @@ -362,15 +362,15 @@ msgstr "" msgid "" "``True`` if the address is reserved for site-local usage. Note that the " -"site-local address space has been deprecated by :RFC:`3879`. Use :attr:" -"`~IPv4Address.is_private` to test if this address is in the space of unique " -"local addresses as defined by :RFC:`4193`." +"site-local address space has been deprecated by :RFC:`3879`. " +"Use :attr:`~IPv4Address.is_private` to test if this address is in the space " +"of unique local addresses as defined by :RFC:`4193`." msgstr "" msgid "" -"For addresses that appear to be IPv4 mapped addresses in the range ``::" -"FFFF:0:0/96`` as defined by :RFC:`4291`, this property reports the embedded " -"IPv4 address. For any other address, this property will be ``None``." +"For addresses that appear to be IPv4 mapped addresses in the range " +"``::FFFF:0:0/96`` as defined by :RFC:`4291`, this property reports the " +"embedded IPv4 address. For any other address, this property will be ``None``." msgstr "" msgid "" @@ -513,10 +513,10 @@ msgstr "" msgid "" "All attributes implemented by address objects are implemented by network " "objects as well. In addition, network objects implement additional " -"attributes. All of these are common between :class:`IPv4Network` and :class:" -"`IPv6Network`, so to avoid duplication they are only documented for :class:" -"`IPv4Network`. Network objects are :term:`hashable`, so they can be used as " -"keys in dictionaries." +"attributes. All of these are common between :class:`IPv4Network` " +"and :class:`IPv6Network`, so to avoid duplication they are only documented " +"for :class:`IPv4Network`. Network objects are :term:`hashable`, so they can " +"be used as keys in dictionaries." msgstr "" msgid "" @@ -565,9 +565,9 @@ msgid "" msgstr "" msgid "" -"If *strict* is ``True`` and host bits are set in the supplied address, then :" -"exc:`ValueError` is raised. Otherwise, the host bits are masked out to " -"determine the appropriate network address." +"If *strict* is ``True`` and host bits are set in the supplied address, " +"then :exc:`ValueError` is raised. Otherwise, the host bits are masked out " +"to determine the appropriate network address." msgstr "" msgid "" @@ -643,8 +643,9 @@ msgstr "" msgid "" "Computes the network definitions resulting from removing the given *network* " -"from this one. Returns an iterator of network objects. Raises :exc:" -"`ValueError` if *network* is not completely contained in this network." +"from this one. Returns an iterator of network objects. " +"Raises :exc:`ValueError` if *network* is not completely contained in this " +"network." msgstr "" msgid "" @@ -693,14 +694,15 @@ msgid "" msgstr "" msgid "" -"Note that currently expanded netmasks are not supported. That means ``2001:" -"db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` is not." +"Note that currently expanded netmasks are not supported. That means " +"``2001:db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` " +"is not." msgstr "" msgid "" "An integer that fits into 128 bits. This is equivalent to a single-address " -"network, with the network address being *address* and the mask being " -"``/128``." +"network, with the network address being *address* and the mask being ``/" +"128``." msgstr "" msgid "" @@ -886,33 +888,33 @@ msgstr "" msgid "" "Represent an address as 4 packed bytes in network (big-endian) order. " -"*address* is an integer representation of an IPv4 IP address. A :exc:" -"`ValueError` is raised if the integer is negative or too large to be an IPv4 " -"IP address." +"*address* is an integer representation of an IPv4 IP address. " +"A :exc:`ValueError` is raised if the integer is negative or too large to be " +"an IPv4 IP address." msgstr "" msgid "" "Represent an address as 16 packed bytes in network (big-endian) order. " -"*address* is an integer representation of an IPv6 IP address. A :exc:" -"`ValueError` is raised if the integer is negative or too large to be an IPv6 " -"IP address." +"*address* is an integer representation of an IPv6 IP address. " +"A :exc:`ValueError` is raised if the integer is negative or too large to be " +"an IPv6 IP address." msgstr "" msgid "" "Return an iterator of the summarized network range given the first and last " -"IP addresses. *first* is the first :class:`IPv4Address` or :class:" -"`IPv6Address` in the range and *last* is the last :class:`IPv4Address` or :" -"class:`IPv6Address` in the range. A :exc:`TypeError` is raised if *first* " -"or *last* are not IP addresses or are not of the same version. A :exc:" -"`ValueError` is raised if *last* is not greater than *first* or if *first* " -"address version is not 4 or 6." +"IP addresses. *first* is the first :class:`IPv4Address` " +"or :class:`IPv6Address` in the range and *last* is the " +"last :class:`IPv4Address` or :class:`IPv6Address` in the range. " +"A :exc:`TypeError` is raised if *first* or *last* are not IP addresses or " +"are not of the same version. A :exc:`ValueError` is raised if *last* is not " +"greater than *first* or if *first* address version is not 4 or 6." msgstr "" msgid "" -"Return an iterator of the collapsed :class:`IPv4Network` or :class:" -"`IPv6Network` objects. *addresses* is an :term:`iterable` of :class:" -"`IPv4Network` or :class:`IPv6Network` objects. A :exc:`TypeError` is raised " -"if *addresses* contains mixed version objects." +"Return an iterator of the collapsed :class:`IPv4Network` " +"or :class:`IPv6Network` objects. *addresses* is an :term:`iterable` " +"of :class:`IPv4Network` or :class:`IPv6Network` objects. A :exc:`TypeError` " +"is raised if *addresses* contains mixed version objects." msgstr "" msgid "" diff --git a/library/ipc.po b/library/ipc.po index a7ce7cf8d0..b0fc7bb993 100644 --- a/library/ipc.po +++ b/library/ipc.po @@ -32,9 +32,9 @@ msgid "" msgstr "" msgid "" -"Some modules only work for two processes that are on the same machine, e.g. :" -"mod:`signal` and :mod:`mmap`. Other modules support networking protocols " -"that two or more processes can use to communicate across machines." +"Some modules only work for two processes that are on the same machine, " +"e.g. :mod:`signal` and :mod:`mmap`. Other modules support networking " +"protocols that two or more processes can use to communicate across machines." msgstr "" msgid "The list of modules described in this chapter is:" diff --git a/library/itertools.po b/library/itertools.po index b72063fd20..1a72d102fb 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -406,8 +406,8 @@ msgstr "" msgid "" "Loops over the input iterable and accumulates data into tuples up to size " "*n*. The input is consumed lazily, just enough to fill a batch. The result " -"is yielded as soon as the batch is full or when the input iterable is " -"exhausted:" +"is yielded as soon as the batch is full or when the input iterable " +"is :term:`exhausted`:" msgstr "" msgid "" @@ -433,10 +433,10 @@ msgid "Added the *strict* option." msgstr "" msgid "" -"Make an iterator that returns elements from the first iterable until it is " -"exhausted, then proceeds to the next iterable, until all of the iterables " -"are exhausted. This combines multiple data sources into a single iterator. " -"Roughly equivalent to::" +"Make an iterator that returns elements from the first iterable until it " +"is :term:`exhausted`, then proceeds to the next iterable, until all of the " +"iterables are exhausted. This combines multiple data sources into a single " +"iterator. Roughly equivalent to::" msgstr "" msgid "" @@ -463,9 +463,9 @@ msgstr "" msgid "" "The output is a subsequence of :func:`product` keeping only entries that are " -"subsequences of the *iterable*. The length of the output is given by :func:" -"`math.comb` which computes ``n! / r! / (n - r)!`` when ``0 ≤ r ≤ n`` or zero " -"when ``r > n``." +"subsequences of the *iterable*. The length of the output is given " +"by :func:`math.comb` which computes ``n! / r! / (n - r)!`` when ``0 ≤ r ≤ " +"n`` or zero when ``r > n``." msgstr "" msgid "" @@ -552,7 +552,7 @@ msgstr "" msgid "" "Make an iterator that returns elements from *data* where the corresponding " "element in *selectors* is true. Stops when either the *data* or *selectors* " -"iterables have been exhausted. Roughly equivalent to::" +"iterables have been :term:`exhausted`. Roughly equivalent to::" msgstr "" msgid "" @@ -563,8 +563,8 @@ msgstr "" msgid "" "Make an iterator that returns evenly spaced values beginning with *start*. " -"Can be used with :func:`map` to generate consecutive data points or with :" -"func:`zip` to add sequence numbers. Roughly equivalent to::" +"Can be used with :func:`map` to generate consecutive data points or " +"with :func:`zip` to add sequence numbers. Roughly equivalent to::" msgstr "" msgid "" @@ -588,8 +588,8 @@ msgstr "" msgid "" "Make an iterator returning elements from the *iterable* and saving a copy of " -"each. When the iterable is exhausted, return elements from the saved copy. " -"Repeats indefinitely. Roughly equivalent to::" +"each. When the iterable is :term:`exhausted`, return elements from the " +"saved copy. Repeats indefinitely. Roughly equivalent to::" msgstr "" msgid "" @@ -672,9 +672,9 @@ msgstr "" msgid "" "The returned group is itself an iterator that shares the underlying iterable " -"with :func:`groupby`. Because the source is shared, when the :func:" -"`groupby` object is advanced, the previous group is no longer visible. So, " -"if that data is needed later, it should be stored as a list::" +"with :func:`groupby`. Because the source is shared, when " +"the :func:`groupby` object is advanced, the previous group is no longer " +"visible. So, if that data is needed later, it should be stored as a list::" msgstr "" msgid "" @@ -735,8 +735,9 @@ msgid "" msgstr "" msgid "" -"If *stop* is ``None``, iteration continues until the input is exhausted, if " -"at all. Otherwise, it stops at the specified position." +"If *stop* is ``None``, iteration continues until the input " +"is :term:`exhausted`, if at all. Otherwise, it stops at the specified " +"position." msgstr "" msgid "" @@ -794,8 +795,8 @@ msgid "" msgstr "" msgid "" -"Return successive *r* length `permutations of elements `_ from the *iterable*." +"Return successive *r* length `permutations of elements `_ from the *iterable*." msgstr "" msgid "" @@ -805,9 +806,9 @@ msgstr "" msgid "" "The output is a subsequence of :func:`product` where entries with repeated " -"elements have been filtered out. The length of the output is given by :func:" -"`math.perm` which computes ``n! / (n - r)!`` when ``0 ≤ r ≤ n`` or zero when " -"``r > n``." +"elements have been filtered out. The length of the output is given " +"by :func:`math.perm` which computes ``n! / (n - r)!`` when ``0 ≤ r ≤ n`` or " +"zero when ``r > n``." msgstr "" msgid "" @@ -967,9 +968,10 @@ msgid "" "Note, the element that first fails the predicate condition is consumed from " "the input iterator and there is no way to access it. This could be an issue " "if an application wants to further consume the input iterator after " -"*takewhile* has been run to exhaustion. To work around this problem, " -"consider using `more-itertools before_and_after() `_ instead." +"*takewhile* has been run to :term:`exhaustion `. To work around " +"this problem, consider using `more-itertools before_and_after() `__ instead." msgstr "" msgid "Return *n* independent iterators from a single iterable." @@ -1013,9 +1015,9 @@ msgstr "" msgid "" "When the input *iterable* is already a tee iterator object, all members of " "the return tuple are constructed as if they had been produced by the " -"upstream :func:`tee` call. This \"flattening step\" allows nested :func:" -"`tee` calls to share the same underlying data chain and to have a single " -"update step rather than a chain of calls." +"upstream :func:`tee` call. This \"flattening step\" allows " +"nested :func:`tee` calls to share the same underlying data chain and to have " +"a single update step rather than a chain of calls." msgstr "" msgid "The flattening property makes tee iterators efficiently peekable:" @@ -1048,8 +1050,8 @@ msgstr "" msgid "" "This itertool may require significant auxiliary storage (depending on how " "much temporary data needs to be stored). In general, if one iterator uses " -"most or all of the data before another iterator starts, it is faster to use :" -"func:`list` instead of :func:`tee`." +"most or all of the data before another iterator starts, it is faster to " +"use :func:`list` instead of :func:`tee`." msgstr "" msgid "Make an iterator that aggregates elements from each of the *iterables*." @@ -1060,7 +1062,7 @@ msgid "" "*fillvalue*. If not specified, *fillvalue* defaults to ``None``." msgstr "" -msgid "Iteration continues until the longest iterable is exhausted." +msgid "Iteration continues until the longest iterable is :term:`exhausted`." msgstr "" msgid "" @@ -1088,9 +1090,9 @@ msgid "" msgstr "" msgid "" -"If one of the iterables is potentially infinite, then the :func:" -"`zip_longest` function should be wrapped with something that limits the " -"number of calls (for example :func:`islice` or :func:`takewhile`)." +"If one of the iterables is potentially infinite, then " +"the :func:`zip_longest` function should be wrapped with something that " +"limits the number of calls (for example :func:`islice` or :func:`takewhile`)." msgstr "" msgid "Itertools Recipes" @@ -1107,9 +1109,9 @@ msgid "" "``chain.from_iterable`` is related to the concept of flattening. The " "recipes also give ideas about ways that the tools can be combined — for " "example, how ``starmap()`` and ``repeat()`` can work together. The recipes " -"also show patterns for using itertools with the :mod:`operator` and :mod:" -"`collections` modules as well as with the built-in itertools such as " -"``map()``, ``filter()``, ``reversed()``, and ``enumerate()``." +"also show patterns for using itertools with the :mod:`operator` " +"and :mod:`collections` modules as well as with the built-in itertools such " +"as ``map()``, ``filter()``, ``reversed()``, and ``enumerate()``." msgstr "" msgid "" diff --git a/library/json.po b/library/json.po index 755443dadb..b2a29be455 100644 --- a/library/json.po +++ b/library/json.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,12 +31,12 @@ msgid "**Source code:** :source:`Lib/json/__init__.py`" msgstr "**Kod źródłowy:** :source:`Lib/json/__init__.py`" msgid "" -"`JSON (JavaScript Object Notation) `_, specified by :rfc:" -"`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, specified " +"by :rfc:`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, is a " -"lightweight data interchange format inspired by `JavaScript `_ object literal syntax (although it is not a " -"strict subset of JavaScript [#rfc-errata]_ )." +"lightweight data interchange format inspired by `JavaScript `_ object literal syntax (although it is " +"not a strict subset of JavaScript [#rfc-errata]_ )." msgstr "" msgid "" @@ -51,8 +52,8 @@ msgid "" msgstr "" msgid "" -"This module exposes an API familiar to users of the standard library :mod:" -"`marshal` and :mod:`pickle` modules." +"This module exposes an API familiar to users of the standard " +"library :mod:`marshal` and :mod:`pickle` modules." msgstr "" msgid "Encoding basic Python object hierarchies::" @@ -105,8 +106,8 @@ msgid "" ">>> import json\n" ">>> def custom_json(obj):\n" "... if isinstance(obj, complex):\n" -"... return {'__complex__': True, 'real': obj.real, 'imag': obj." -"imag}\n" +"... return {'__complex__': True, 'real': obj.real, 'imag': " +"obj.imag}\n" "... raise TypeError(f'Cannot serialize object of {type(obj)}')\n" "...\n" ">>> json.dumps(1 + 2j, default=custom_json)\n" @@ -221,9 +222,9 @@ msgid "" msgstr "" msgid "" -"If ``True``, keys that are not of a basic type (:class:`str`, :class:`int`, :" -"class:`float`, :class:`bool`, ``None``) will be skipped instead of raising " -"a :exc:`TypeError`. Default ``False``." +"If ``True``, keys that are not of a basic type " +"(:class:`str`, :class:`int`, :class:`float`, :class:`bool`, ``None``) will " +"be skipped instead of raising a :exc:`TypeError`. Default ``False``." msgstr "" msgid "" @@ -258,7 +259,7 @@ msgid "" "be pretty-printed with that indent level. A positive integer indents that " "many spaces per level; a string (such as ``\"\\t\"``) is used to indent each " "level. If zero, negative, or ``\"\"`` (the empty string), only newlines are " -"inserted. If ``None`` (the default), the most compact representation is used." +"inserted. If ``None`` (the default), no newlines are inserted." msgstr "" msgid "" @@ -270,14 +271,24 @@ msgstr "" msgid "" "A function that is called for objects that can't otherwise be serialized. It " -"should return a JSON encodable version of the object or raise a :exc:" -"`TypeError`. If ``None`` (the default), :exc:`!TypeError` is raised." +"should return a JSON encodable version of the object or raise " +"a :exc:`TypeError`. If ``None`` (the default), :exc:`!TypeError` is raised." msgstr "" msgid "" "If ``True``, dictionaries will be outputted sorted by key. Default ``False``." msgstr "" +msgid "" +"Keys in key/value pairs of JSON are always of the type :class:`str`. When a " +"dictionary is converted into JSON, all the keys of the dictionary are " +"converted to strings. As a result of this, if a dictionary is converted into " +"JSON and then back into a dictionary, the dictionary may not equal the " +"original one. That is, ``loads(dumps(x)) != x`` if x has non-string keys. " +"*sort_keys* sorts the keys before they are converted to strings, so numeric " +"keys are sorted by value, not by their string representation." +msgstr "" + msgid "Allow strings for *indent* in addition to integers." msgstr "" @@ -290,16 +301,8 @@ msgstr "" msgid "" "Serialize *obj* to a JSON formatted :class:`str` using this :ref:`conversion " -"table `. The arguments have the same meaning as in :func:" -"`dump`." -msgstr "" - -msgid "" -"Keys in key/value pairs of JSON are always of the type :class:`str`. When a " -"dictionary is converted into JSON, all the keys of the dictionary are " -"coerced to strings. As a result of this, if a dictionary is converted into " -"JSON and then back into a dictionary, the dictionary may not equal the " -"original one. That is, ``loads(dumps(x)) != x`` if x has non-string keys." +"table `. The arguments have the same meaning as " +"in :func:`dump`." msgstr "" msgid "" @@ -314,8 +317,8 @@ msgstr "" msgid "" "If set, a custom JSON decoder. Additional keyword arguments to :func:`!load` " -"will be passed to the constructor of *cls*. If ``None`` (the default), :" -"class:`!JSONDecoder` is used." +"will be passed to the constructor of *cls*. If ``None`` (the " +"default), :class:`!JSONDecoder` is used." msgstr "" msgid "" @@ -337,15 +340,15 @@ msgstr "" msgid "" "If set, a function that is called with the string of every JSON float to be " "decoded. If ``None`` (the default), it is equivalent to ``float(num_str)``. " -"This can be used to parse JSON floats into custom datatypes, for example :" -"class:`decimal.Decimal`." +"This can be used to parse JSON floats into custom datatypes, for " +"example :class:`decimal.Decimal`." msgstr "" msgid "" "If set, a function that is called with the string of every JSON int to be " "decoded. If ``None`` (the default), it is equivalent to ``int(num_str)``. " -"This can be used to parse JSON integers into custom datatypes, for example :" -"class:`float`." +"This can be used to parse JSON integers into custom datatypes, for " +"example :class:`float`." msgstr "" msgid "" @@ -468,16 +471,16 @@ msgstr "" msgid "" "*object_hook* is an optional function that will be called with the result of " "every JSON object decoded and its return value will be used in place of the " -"given :class:`dict`. This can be used to provide custom deserializations (e." -"g. to support `JSON-RPC `_ class hinting)." +"given :class:`dict`. This can be used to provide custom deserializations " +"(e.g. to support `JSON-RPC `_ class hinting)." msgstr "" msgid "" "*object_pairs_hook* is an optional function that will be called with the " "result of every JSON object decoded with an ordered list of pairs. The " -"return value of *object_pairs_hook* will be used instead of the :class:" -"`dict`. This feature can be used to implement custom decoders. If " -"*object_hook* is also defined, the *object_pairs_hook* takes priority." +"return value of *object_pairs_hook* will be used instead of " +"the :class:`dict`. This feature can be used to implement custom decoders. " +"If *object_hook* is also defined, the *object_pairs_hook* takes priority." msgstr "" msgid "Added support for *object_pairs_hook*." @@ -511,8 +514,8 @@ msgid "" msgstr "" msgid "" -"If the data being deserialized is not a valid JSON document, a :exc:" -"`JSONDecodeError` will be raised." +"If the data being deserialized is not a valid JSON document, " +"a :exc:`JSONDecodeError` will be raised." msgstr "" msgid "All parameters are now :ref:`keyword-only `." @@ -558,17 +561,17 @@ msgid "Added support for int- and float-derived Enum classes." msgstr "" msgid "" -"To extend this to recognize other objects, subclass and implement a :meth:" -"`~JSONEncoder.default` method with another method that returns a " +"To extend this to recognize other objects, subclass and implement " +"a :meth:`~JSONEncoder.default` method with another method that returns a " "serializable object for ``o`` if possible, otherwise it should call the " "superclass implementation (to raise :exc:`TypeError`)." msgstr "" msgid "" "If *skipkeys* is false (the default), a :exc:`TypeError` will be raised when " -"trying to encode keys that are not :class:`str`, :class:`int`, :class:" -"`float`, :class:`bool` or ``None``. If *skipkeys* is true, such items are " -"simply skipped." +"trying to encode keys that are " +"not :class:`str`, :class:`int`, :class:`float`, :class:`bool` or ``None``. " +"If *skipkeys* is true, such items are simply skipped." msgstr "" msgid "" @@ -618,19 +621,19 @@ msgstr "" msgid "" "If specified, *default* should be a function that gets called for objects " "that can't otherwise be serialized. It should return a JSON encodable " -"version of the object or raise a :exc:`TypeError`. If not specified, :exc:" -"`TypeError` is raised." +"version of the object or raise a :exc:`TypeError`. If not " +"specified, :exc:`TypeError` is raised." msgstr "" msgid "" "Implement this method in a subclass such that it returns a serializable " -"object for *o*, or calls the base implementation (to raise a :exc:" -"`TypeError`)." +"object for *o*, or calls the base implementation (to raise " +"a :exc:`TypeError`)." msgstr "" msgid "" -"For example, to support arbitrary iterators, you could implement :meth:" -"`~JSONEncoder.default` like this::" +"For example, to support arbitrary iterators, you could " +"implement :meth:`~JSONEncoder.default` like this::" msgstr "" msgid "" @@ -752,8 +755,8 @@ msgid "" "The RFC does not explicitly forbid JSON strings which contain byte sequences " "that don't correspond to valid Unicode characters (e.g. unpaired UTF-16 " "surrogates), but it does note that they may cause interoperability problems. " -"By default, this module accepts and outputs (when present in the original :" -"class:`str`) code points for such sequences." +"By default, this module accepts and outputs (when present in the " +"original :class:`str`) code points for such sequences." msgstr "" msgid "Infinite and NaN Number Values" @@ -858,7 +861,7 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "**Source code:** :source:`Lib/json/tool.py`" msgstr "**Kod źródłowy:** :source:`Lib/json/tool.py`" @@ -870,8 +873,9 @@ msgid "" msgstr "" msgid "" -"If the optional ``infile`` and ``outfile`` arguments are not specified, :" -"data:`sys.stdin` and :data:`sys.stdout` will be used respectively:" +"If the optional ``infile`` and ``outfile`` arguments are not " +"specified, :data:`sys.stdin` and :data:`sys.stdout` will be used " +"respectively:" msgstr "" msgid "" diff --git a/library/keyword.po b/library/keyword.po index d5dda6d39b..8406e264e4 100644 --- a/library/keyword.po +++ b/library/keyword.po @@ -30,8 +30,8 @@ msgid "**Source code:** :source:`Lib/keyword.py`" msgstr "" msgid "" -"This module allows a Python program to determine if a string is a :ref:" -"`keyword ` or :ref:`soft keyword `." +"This module allows a Python program to determine if a string is " +"a :ref:`keyword ` or :ref:`soft keyword `." msgstr "" msgid "Return ``True`` if *s* is a Python :ref:`keyword `." @@ -39,8 +39,9 @@ msgstr "" msgid "" "Sequence containing all the :ref:`keywords ` defined for the " -"interpreter. If any keywords are defined to only be active when particular :" -"mod:`__future__` statements are in effect, these will be included as well." +"interpreter. If any keywords are defined to only be active when " +"particular :mod:`__future__` statements are in effect, these will be " +"included as well." msgstr "" msgid "Return ``True`` if *s* is a Python :ref:`soft keyword `." diff --git a/library/linecache.po b/library/linecache.po index 1d7c9272f2..f00bb55c0c 100644 --- a/library/linecache.po +++ b/library/linecache.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,9 +32,9 @@ msgstr "**Kod źródłowy:** :source:`Lib/linecache.py`" msgid "" "The :mod:`!linecache` module allows one to get any line from a Python source " "file, while attempting to optimize internally, using a cache, the common " -"case where many lines are read from a single file. This is used by the :mod:" -"`traceback` module to retrieve source lines for inclusion in the formatted " -"traceback." +"case where many lines are read from a single file. This is used by " +"the :mod:`traceback` module to retrieve source lines for inclusion in the " +"formatted traceback." msgstr "" msgid "" @@ -59,12 +59,12 @@ msgid "" msgstr "" msgid "" -"If a file named *filename* is not found, the function first checks for a :" -"pep:`302` ``__loader__`` in *module_globals*. If there is such a loader and " -"it defines a ``get_source`` method, then that determines the source lines " -"(if ``get_source()`` returns ``None``, then ``''`` is returned). Finally, if " -"*filename* is a relative filename, it is looked up relative to the entries " -"in the module search path, ``sys.path``." +"If a file named *filename* is not found, the function first checks for " +"a :pep:`302` ``__loader__`` in *module_globals*. If there is such a loader " +"and it defines a ``get_source`` method, then that determines the source " +"lines (if ``get_source()`` returns ``None``, then ``''`` is returned). " +"Finally, if *filename* is a relative filename, it is looked up relative to " +"the entries in the module search path, ``sys.path``." msgstr "" msgid "Support *filename* of frozen modules." diff --git a/library/locale.po b/library/locale.po index 50d9ae130c..6878e2ec02 100644 --- a/library/locale.po +++ b/library/locale.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -55,8 +55,9 @@ msgid "" "setting for the *category*. The available categories are listed in the data " "description below. *locale* may be a :ref:`string `, or a pair, " "language code and encoding. An empty string specifies the user's default " -"settings. If the modification of the locale fails, the exception :exc:" -"`Error` is raised. If successful, the new locale setting is returned." +"settings. If the modification of the locale fails, the " +"exception :exc:`Error` is raised. If successful, the new locale setting is " +"returned." msgstr "" msgid "" @@ -131,9 +132,9 @@ msgstr "" msgid "" "Sequence of numbers specifying which relative positions the " -"``'thousands_sep'`` is expected. If the sequence is terminated with :const:" -"`CHAR_MAX`, no further grouping is performed. If the sequence terminates " -"with a ``0``, the last group size is repeatedly used." +"``'thousands_sep'`` is expected. If the sequence is terminated " +"with :const:`CHAR_MAX`, no further grouping is performed. If the sequence " +"terminates with a ``0``, the last group size is repeatedly used." msgstr "" msgid "``'thousands_sep'``" @@ -388,8 +389,8 @@ msgid "" "the ``E`` modifier in their format strings causes the :func:`time.strftime` " "function to use this information. The format of the returned string is " "specified in *The Open Group Base Specifications Issue 8*, paragraph " -"`7.3.5.2 LC_TIME C-Language Access `_." +"`7.3.5.2 LC_TIME C-Language Access `_." msgstr "" msgid "" @@ -455,9 +456,9 @@ msgstr "" msgid "" "Returns the current setting for the given locale category as a tuple " -"containing the language code and encoding. *category* may be one of the :" -"const:`!LC_\\*` values except :const:`LC_ALL`. It defaults to :const:" -"`LC_CTYPE`." +"containing the language code and encoding. *category* may be one of " +"the :const:`!LC_\\*` values except :const:`LC_ALL`. It defaults " +"to :const:`LC_CTYPE`." msgstr "" msgid "" @@ -485,8 +486,8 @@ msgid "" msgstr "" msgid "" -"The function now always returns ``\"utf-8\"`` on Android or if the :ref:" -"`Python UTF-8 Mode ` is enabled." +"The function now always returns ``\"utf-8\"`` on Android or if " +"the :ref:`Python UTF-8 Mode ` is enabled." msgstr "" msgid "Get the current :term:`locale encoding`:" @@ -578,13 +579,13 @@ msgid "" msgstr "" msgid "" -"Converts a string into a normalized number string, following the :const:" -"`LC_NUMERIC` settings." +"Converts a string into a normalized number string, following " +"the :const:`LC_NUMERIC` settings." msgstr "" msgid "" -"Converts a normalized number string into a formatted string following the :" -"const:`LC_NUMERIC` settings." +"Converts a normalized number string into a formatted string following " +"the :const:`LC_NUMERIC` settings." msgstr "" msgid "" @@ -613,13 +614,13 @@ msgid "" msgstr "" msgid "" -"Locale category for sorting strings. The functions :func:`strcoll` and :" -"func:`strxfrm` of the :mod:`!locale` module are affected." +"Locale category for sorting strings. The functions :func:`strcoll` " +"and :func:`strxfrm` of the :mod:`!locale` module are affected." msgstr "" msgid "" -"Locale category for the formatting of time. The function :func:`time." -"strftime` follows these conventions." +"Locale category for the formatting of time. The " +"function :func:`time.strftime` follows these conventions." msgstr "" msgid "" @@ -640,10 +641,10 @@ msgid "" msgstr "" msgid "" -"Locale category for formatting numbers. The functions :func:" -"`format_string`, :func:`atoi`, :func:`atof` and :func:`.str` of the :mod:`!" -"locale` module are affected by that category. All other numeric formatting " -"operations are not affected." +"Locale category for formatting numbers. The " +"functions :func:`format_string`, :func:`atoi`, :func:`atof` and :func:`.str` " +"of the :mod:`!locale` module are affected by that category. All other " +"numeric formatting operations are not affected." msgstr "" msgid "" @@ -656,8 +657,8 @@ msgid "" msgstr "" msgid "" -"This is a symbolic constant used for different values returned by :func:" -"`localeconv`." +"This is a symbolic constant used for different values returned " +"by :func:`localeconv`." msgstr "" msgid "Background, details, hints, tips and caveats" @@ -672,9 +673,9 @@ msgstr "" msgid "" "Initially, when a program is started, the locale is the ``C`` locale, no " -"matter what the user's preferred locale is. There is one exception: the :" -"data:`LC_CTYPE` category is changed at startup to set the current locale " -"encoding to the user's preferred locale encoding. The program must " +"matter what the user's preferred locale is. There is one exception: " +"the :data:`LC_CTYPE` category is changed at startup to set the current " +"locale encoding to the user's preferred locale encoding. The program must " "explicitly say that it wants the user's preferred locale settings for other " "categories by calling ``setlocale(LC_ALL, '')``." msgstr "" @@ -698,8 +699,8 @@ msgstr "" msgid "" "The only way to perform numeric operations according to the locale is to use " -"the special functions defined by this module: :func:`atof`, :func:`atoi`, :" -"func:`format_string`, :func:`.str`." +"the special functions defined by this " +"module: :func:`atof`, :func:`atoi`, :func:`format_string`, :func:`.str`." msgstr "" msgid "" @@ -759,14 +760,14 @@ msgid "The \"C\" locale is supported on all platforms." msgstr "" msgid "" -"`IEEE Std 1003.1-2024; 8.2 Internationalization Variables `_" +"`IEEE Std 1003.1-2024; 8.2 Internationalization Variables `_" msgstr "" msgid "" -"`UCRT Locale names, Languages, and Country/Region strings `_" +"`UCRT Locale names, Languages, and Country/Region strings `_" msgstr "" msgid "" @@ -788,9 +789,9 @@ msgid "" "When Python code uses the :mod:`!locale` module to change the locale, this " "also affects the embedding application. If the embedding application " "doesn't want this to happen, it should remove the :mod:`!_locale` extension " -"module (which does all the work) from the table of built-in modules in the :" -"file:`config.c` file, and make sure that the :mod:`!_locale` module is not " -"accessible as a shared library." +"module (which does all the work) from the table of built-in modules in " +"the :file:`config.c` file, and make sure that the :mod:`!_locale` module is " +"not accessible as a shared library." msgstr "" msgid "Access to message catalogs" @@ -798,8 +799,8 @@ msgstr "" msgid "" "The locale module exposes the C library's gettext interface on systems that " -"provide this interface. It consists of the functions :func:`gettext`, :func:" -"`dgettext`, :func:`dcgettext`, :func:`textdomain`, :func:`bindtextdomain`, " +"provide this interface. It consists of the " +"functions :func:`~locale.gettext`, :func:`dgettext`, :func:`dcgettext`, :func:`textdomain`, :func:`bindtextdomain`, " "and :func:`bind_textdomain_codeset`. These are similar to the same " "functions in the :mod:`gettext` module, but use the C library's binary " "format for message catalogs, and the C library's search algorithms for " diff --git a/library/logging.config.po b/library/logging.config.po index b9128a4f6f..b1e6a044c3 100644 --- a/library/logging.config.po +++ b/library/logging.config.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -62,10 +62,10 @@ msgid "" msgstr "" msgid "" -"If an error is encountered during configuration, this function will raise a :" -"exc:`ValueError`, :exc:`TypeError`, :exc:`AttributeError` or :exc:" -"`ImportError` with a suitably descriptive message. The following is a " -"(possibly incomplete) list of conditions which will raise an error:" +"If an error is encountered during configuration, this function will raise " +"a :exc:`ValueError`, :exc:`TypeError`, :exc:`AttributeError` " +"or :exc:`ImportError` with a suitably descriptive message. The following is " +"a (possibly incomplete) list of conditions which will raise an error:" msgstr "" msgid "" @@ -90,11 +90,11 @@ msgstr "" msgid "" "Parsing is performed by the :class:`DictConfigurator` class, whose " -"constructor is passed the dictionary used for configuration, and has a :meth:" -"`configure` method. The :mod:`!logging.config` module has a callable " -"attribute :attr:`dictConfigClass` which is initially set to :class:" -"`DictConfigurator`. You can replace the value of :attr:`dictConfigClass` " -"with a suitable implementation of your own." +"constructor is passed the dictionary used for configuration, and has " +"a :meth:`configure` method. The :mod:`!logging.config` module has a " +"callable attribute :attr:`dictConfigClass` which is initially set " +"to :class:`DictConfigurator`. You can replace the value " +"of :attr:`dictConfigClass` with a suitable implementation of your own." msgstr "" msgid "" @@ -112,9 +112,9 @@ msgid "" "For example, a subclass of :class:`DictConfigurator` could call " "``DictConfigurator.__init__()`` in its own :meth:`__init__`, then set up " "custom prefixes which would be usable in the subsequent :meth:`configure` " -"call. :attr:`dictConfigClass` would be bound to this new subclass, and then :" -"func:`dictConfig` could be called exactly as in the default, uncustomized " -"state." +"call. :attr:`dictConfigClass` would be bound to this new subclass, and " +"then :func:`dictConfig` could be called exactly as in the default, " +"uncustomized state." msgstr "" msgid "" @@ -127,22 +127,22 @@ msgid "" msgstr "" msgid "" -"It will raise :exc:`FileNotFoundError` if the file doesn't exist and :exc:" -"`RuntimeError` if the file is invalid or empty." +"It will raise :exc:`FileNotFoundError` if the file doesn't exist " +"and :exc:`RuntimeError` if the file is invalid or empty." msgstr "" msgid "Parameters" msgstr "parametry" msgid "" -"A filename, or a file-like object, or an instance derived from :class:" -"`~configparser.RawConfigParser`. If a :class:`!RawConfigParser`-derived " -"instance is passed, it is used as is. Otherwise, a :class:`~configparser." -"ConfigParser` is instantiated, and the configuration read by it from the " -"object passed in ``fname``. If that has a :meth:`readline` method, it is " -"assumed to be a file-like object and read using :meth:`~configparser." -"ConfigParser.read_file`; otherwise, it is assumed to be a filename and " -"passed to :meth:`~configparser.ConfigParser.read`." +"A filename, or a file-like object, or an instance derived " +"from :class:`~configparser.RawConfigParser`. If a :class:`!RawConfigParser`-" +"derived instance is passed, it is used as is. Otherwise, " +"a :class:`~configparser.ConfigParser` is instantiated, and the configuration " +"read by it from the object passed in ``fname``. If that has " +"a :meth:`readline` method, it is assumed to be a file-like object and read " +"using :meth:`~configparser.ConfigParser.read_file`; otherwise, it is assumed " +"to be a filename and passed to :meth:`~configparser.ConfigParser.read`." msgstr "" msgid "" @@ -187,13 +187,13 @@ msgstr "" msgid "" "Starts up a socket server on the specified port, and listens for new " -"configurations. If no port is specified, the module's default :const:" -"`DEFAULT_LOGGING_CONFIG_PORT` is used. Logging configurations will be sent " -"as a file suitable for processing by :func:`dictConfig` or :func:" -"`fileConfig`. Returns a :class:`~threading.Thread` instance on which you can " -"call :meth:`~threading.Thread.start` to start the server, and which you can :" -"meth:`~threading.Thread.join` when appropriate. To stop the server, call :" -"func:`stopListening`." +"configurations. If no port is specified, the module's " +"default :const:`DEFAULT_LOGGING_CONFIG_PORT` is used. Logging configurations " +"will be sent as a file suitable for processing by :func:`dictConfig` " +"or :func:`fileConfig`. Returns a :class:`~threading.Thread` instance on " +"which you can call :meth:`~threading.Thread.start` to start the server, and " +"which you can :meth:`~threading.Thread.join` when appropriate. To stop the " +"server, call :func:`stopListening`." msgstr "" msgid "" @@ -296,8 +296,8 @@ msgid "" "All other keys are optional, but if present they will be interpreted as " "described below. In all cases below where a 'configuring dict' is " "mentioned, it will be checked for the special ``'()'`` key to see if a " -"custom instantiation is required. If so, the mechanism described in :ref:" -"`logging-config-dict-userdef` below is used to create an instance; " +"custom instantiation is required. If so, the mechanism described " +"in :ref:`logging-config-dict-userdef` below is used to create an instance; " "otherwise, the context is used to determine what to instantiate." msgstr "" @@ -330,11 +330,11 @@ msgstr "" msgid "" "An optional ``class`` key indicates the name of the formatter's class (as a " -"dotted module and class name). The instantiation arguments are as for :" -"class:`~logging.Formatter`, thus this key is most useful for instantiating a " -"customised subclass of :class:`~logging.Formatter`. For example, the " -"alternative class might present exception tracebacks in an expanded or " -"condensed format. If your formatter requires different or extra " +"dotted module and class name). The instantiation arguments are as " +"for :class:`~logging.Formatter`, thus this key is most useful for " +"instantiating a customised subclass of :class:`~logging.Formatter`. For " +"example, the alternative class might present exception tracebacks in an " +"expanded or condensed format. If your formatter requires different or extra " "configuration keys, you should use :ref:`logging-config-dict-userdef`." msgstr "" @@ -398,11 +398,11 @@ msgid "" msgstr "" msgid "" -"the handler with id ``console`` is instantiated as a :class:`logging." -"StreamHandler`, using ``sys.stdout`` as the underlying stream. The handler " -"with id ``file`` is instantiated as a :class:`logging.handlers." -"RotatingFileHandler` with the keyword arguments ``filename='logconfig.log', " -"maxBytes=1024, backupCount=3``." +"the handler with id ``console`` is instantiated as " +"a :class:`logging.StreamHandler`, using ``sys.stdout`` as the underlying " +"stream. The handler with id ``file`` is instantiated as " +"a :class:`logging.handlers.RotatingFileHandler` with the keyword arguments " +"``filename='logconfig.log', maxBytes=1024, backupCount=3``." msgstr "" msgid "" @@ -439,8 +439,8 @@ msgid "" "*incremental* - whether the configuration is to be interpreted as " "incremental to the existing configuration. This value defaults to " "``False``, which means that the specified configuration replaces the " -"existing configuration with the same semantics as used by the existing :func:" -"`fileConfig` API." +"existing configuration with the same semantics as used by the " +"existing :func:`fileConfig` API." msgstr "" msgid "" @@ -450,9 +450,9 @@ msgstr "" msgid "" "*disable_existing_loggers* - whether any existing non-root loggers are to be " -"disabled. This setting mirrors the parameter of the same name in :func:" -"`fileConfig`. If absent, this parameter defaults to ``True``. This value is " -"ignored if *incremental* is ``True``." +"disabled. This setting mirrors the parameter of the same name " +"in :func:`fileConfig`. If absent, this parameter defaults to ``True``. This " +"value is ignored if *incremental* is ``True``." msgstr "" msgid "Incremental Configuration" @@ -537,12 +537,12 @@ msgstr "" msgid "" "The ids for loggers are the logger names which would be used " -"programmatically to obtain a reference to those loggers, e.g. ``foo.bar." -"baz``. The ids for Formatters and Filters can be any string value (such as " -"``brief``, ``precise`` above) and they are transient, in that they are only " -"meaningful for processing the configuration dictionary and used to determine " -"connections between objects, and are not persisted anywhere when the " -"configuration call is complete." +"programmatically to obtain a reference to those loggers, e.g. " +"``foo.bar.baz``. The ids for Formatters and Filters can be any string value " +"(such as ``brief``, ``precise`` above) and they are transient, in that they " +"are only meaningful for processing the configuration dictionary and used to " +"determine connections between objects, and are not persisted anywhere when " +"the configuration call is complete." msgstr "" msgid "" @@ -592,9 +592,9 @@ msgid "" "The above YAML snippet defines three formatters. The first, with id " "``brief``, is a standard :class:`logging.Formatter` instance with the " "specified format string. The second, with id ``default``, has a longer " -"format and also defines the time format explicitly, and will result in a :" -"class:`logging.Formatter` initialized with those two format strings. Shown " -"in Python source form, the ``brief`` and ``default`` formatters have " +"format and also defines the time format explicitly, and will result in " +"a :class:`logging.Formatter` initialized with those two format strings. " +"Shown in Python source form, the ``brief`` and ``default`` formatters have " "configuration sub-dictionaries::" msgstr "" @@ -680,7 +680,7 @@ msgid "" " 'bar' : 'baz',\n" " 'spam' : 99.9,\n" " 'answer' : 42,\n" -" '.' {\n" +" '.' : {\n" " 'foo': 'bar',\n" " 'baz': 'bozz'\n" " }\n" @@ -717,9 +717,9 @@ msgid "" "named ``bar``, problems would result, because the configuration of ``bar`` " "would be attempted before that of ``foo``, and ``foo`` would not yet have " "been configured. However, if the dependent handler were named ``foobar``, it " -"would be configured after ``foo``, with the result that ``cfg://handlers." -"foo`` would resolve to configured handler ``foo``, and not its configuration " -"dictionary." +"would be configured after ``foo``, with the result that ``cfg://" +"handlers.foo`` would resolve to configured handler ``foo``, and not its " +"configuration dictionary." msgstr "" msgid "Access to external objects" @@ -733,10 +733,10 @@ msgid "" "text file, there is no standard way to distinguish ``sys.stderr`` from the " "literal string ``'sys.stderr'``. To facilitate this distinction, the " "configuration system looks for certain special prefixes in string values and " -"treat them specially. For example, if the literal string ``'ext://sys." -"stderr'`` is provided as a value in the configuration, then the ``ext://`` " -"will be stripped off and the remainder of the value processed using normal " -"import mechanisms." +"treat them specially. For example, if the literal string ``'ext://" +"sys.stderr'`` is provided as a value in the configuration, then the ``ext://" +"`` will be stripped off and the remainder of the value processed using " +"normal import mechanisms." msgstr "" msgid "" @@ -763,15 +763,16 @@ msgstr "" msgid "" "However, a more generic mechanism is needed for user-defined objects which " -"are not known to the :mod:`logging` module. For example, consider :class:" -"`logging.handlers.MemoryHandler`, which takes a ``target`` argument which is " -"another handler to delegate to. Since the system already knows about this " -"class, then in the configuration, the given ``target`` just needs to be the " -"object id of the relevant target handler, and the system will resolve to the " -"handler from the id. If, however, a user defines a ``my.package.MyHandler`` " -"which has an ``alternate`` handler, the configuration system would not know " -"that the ``alternate`` referred to a handler. To cater for this, a generic " -"resolution system allows the user to specify:" +"are not known to the :mod:`logging` module. For example, " +"consider :class:`logging.handlers.MemoryHandler`, which takes a ``target`` " +"argument which is another handler to delegate to. Since the system already " +"knows about this class, then in the configuration, the given ``target`` just " +"needs to be the object id of the relevant target handler, and the system " +"will resolve to the handler from the id. If, however, a user defines a " +"``my.package.MyHandler`` which has an ``alternate`` handler, the " +"configuration system would not know that the ``alternate`` referred to a " +"handler. To cater for this, a generic resolution system allows the user to " +"specify:" msgstr "" msgid "" @@ -788,8 +789,8 @@ msgid "" "The literal string ``'cfg://handlers.file'`` will be resolved in an " "analogous way to strings with the ``ext://`` prefix, but looking in the " "configuration itself rather than the import namespace. The mechanism allows " -"access by dot or by index, in a similar way to that provided by ``str." -"format``. Thus, given the following snippet:" +"access by dot or by index, in a similar way to that provided by " +"``str.format``. Thus, given the following snippet:" msgstr "" msgid "" @@ -809,15 +810,15 @@ msgid "" "dict with key ``handlers``, the string ``'cfg://handlers.email`` would " "resolve to the dict with key ``email`` in the ``handlers`` dict, and so on. " "The string ``'cfg://handlers.email.toaddrs[1]`` would resolve to " -"``'dev_team@domain.tld'`` and the string ``'cfg://handlers.email." -"toaddrs[0]'`` would resolve to the value ``'support_team@domain.tld'``. The " -"``subject`` value could be accessed using either ``'cfg://handlers.email." -"subject'`` or, equivalently, ``'cfg://handlers.email[subject]'``. The " -"latter form only needs to be used if the key contains spaces or non-" -"alphanumeric characters. Please note that the characters ``[`` and ``]`` are " -"not allowed in the keys. If an index value consists only of decimal digits, " -"access will be attempted using the corresponding integer value, falling back " -"to the string value if needed." +"``'dev_team@domain.tld'`` and the string ``'cfg://" +"handlers.email.toaddrs[0]'`` would resolve to the value " +"``'support_team@domain.tld'``. The ``subject`` value could be accessed using " +"either ``'cfg://handlers.email.subject'`` or, equivalently, ``'cfg://" +"handlers.email[subject]'``. The latter form only needs to be used if the " +"key contains spaces or non-alphanumeric characters. Please note that the " +"characters ``[`` and ``]`` are not allowed in the keys. If an index value " +"consists only of decimal digits, access will be attempted using the " +"corresponding integer value, falling back to the string value if needed." msgstr "" msgid "" @@ -835,12 +836,13 @@ msgstr "" msgid "" "Import resolution, by default, uses the builtin :func:`__import__` function " "to do its importing. You may want to replace this with your own importing " -"mechanism: if so, you can replace the :attr:`importer` attribute of the :" -"class:`DictConfigurator` or its superclass, the :class:`BaseConfigurator` " -"class. However, you need to be careful because of the way functions are " -"accessed from classes via descriptors. If you are using a Python callable to " -"do your imports, and you want to define it at class level rather than " -"instance level, you need to wrap it with :func:`staticmethod`. For example::" +"mechanism: if so, you can replace the :attr:`importer` attribute of " +"the :class:`DictConfigurator` or its superclass, " +"the :class:`BaseConfigurator` class. However, you need to be careful because " +"of the way functions are accessed from classes via descriptors. If you are " +"using a Python callable to do your imports, and you want to define it at " +"class level rather than instance level, you need to wrap it " +"with :func:`staticmethod`. For example::" msgstr "" msgid "" @@ -860,14 +862,14 @@ msgstr "" msgid "" "If you want to configure a :class:`~logging.handlers.QueueHandler`, noting " -"that this is normally used in conjunction with a :class:`~logging.handlers." -"QueueListener`, you can configure both together. After the configuration, " -"the ``QueueListener`` instance will be available as the :attr:`~logging." -"handlers.QueueHandler.listener` attribute of the created handler, and that " -"in turn will be available to you using :func:`~logging.getHandlerByName` and " -"passing the name you have used for the ``QueueHandler`` in your " -"configuration. The dictionary schema for configuring the pair is shown in " -"the example YAML snippet below." +"that this is normally used in conjunction with " +"a :class:`~logging.handlers.QueueListener`, you can configure both together. " +"After the configuration, the ``QueueListener`` instance will be available as " +"the :attr:`~logging.handlers.QueueHandler.listener` attribute of the created " +"handler, and that in turn will be available to you " +"using :func:`~logging.getHandlerByName` and passing the name you have used " +"for the ``QueueHandler`` in your configuration. The dictionary schema for " +"configuring the pair is shown in the example YAML snippet below." msgstr "" msgid "" @@ -904,9 +906,9 @@ msgstr "" msgid "" "A string that resolves to a callable which, when called with no arguments, " -"returns the queue instance to use. That callable could be a :class:`queue." -"Queue` subclass or a function which returns a suitable queue instance, such " -"as ``my.module.queue_factory()``." +"returns the queue instance to use. That callable could be " +"a :class:`queue.Queue` subclass or a function which returns a suitable queue " +"instance, such as ``my.module.queue_factory()``." msgstr "" msgid "" @@ -956,16 +958,17 @@ msgstr "" msgid "" "Any custom queue handler and listener classes will need to be defined with " -"the same initialization signatures as :class:`~logging.handlers." -"QueueHandler` and :class:`~logging.handlers.QueueListener`." +"the same initialization signatures " +"as :class:`~logging.handlers.QueueHandler` " +"and :class:`~logging.handlers.QueueListener`." msgstr "" msgid "Configuration file format" msgstr "" msgid "" -"The configuration file format understood by :func:`fileConfig` is based on :" -"mod:`configparser` functionality. The file must contain sections called " +"The configuration file format understood by :func:`fileConfig` is based " +"on :mod:`configparser` functionality. The file must contain sections called " "``[loggers]``, ``[handlers]`` and ``[formatters]`` which identify by name " "the entities of each type which are defined in the file. For each such " "entity, there is a separate section which identifies how that entity is " @@ -983,12 +986,12 @@ msgid "" "The :func:`fileConfig` API is older than the :func:`dictConfig` API and does " "not provide functionality to cover certain aspects of logging. For example, " "you cannot configure :class:`~logging.Filter` objects, which provide for " -"filtering of messages beyond simple integer levels, using :func:" -"`fileConfig`. If you need to have instances of :class:`~logging.Filter` in " -"your logging configuration, you will need to use :func:`dictConfig`. Note " -"that future enhancements to configuration functionality will be added to :" -"func:`dictConfig`, so it's worth considering transitioning to this newer API " -"when it's convenient to do so." +"filtering of messages beyond simple integer levels, " +"using :func:`fileConfig`. If you need to have instances " +"of :class:`~logging.Filter` in your logging configuration, you will need to " +"use :func:`dictConfig`. Note that future enhancements to configuration " +"functionality will be added to :func:`dictConfig`, so it's worth considering " +"transitioning to this newer API when it's convenient to do so." msgstr "" msgid "Examples of these sections in the file are given below." @@ -1069,9 +1072,9 @@ msgid "" msgstr "" msgid "" -"The ``class`` entry indicates the handler's class (as determined by :func:" -"`eval` in the ``logging`` package's namespace). The ``level`` is interpreted " -"as for loggers, and ``NOTSET`` is taken to mean 'log everything'." +"The ``class`` entry indicates the handler's class (as determined " +"by :func:`eval` in the ``logging`` package's namespace). The ``level`` is " +"interpreted as for loggers, and ``NOTSET`` is taken to mean 'log everything'." msgstr "" msgid "" @@ -1119,8 +1122,8 @@ msgid "" "class=handlers.SysLogHandler\n" "level=ERROR\n" "formatter=form05\n" -"args=(('localhost', handlers.SYSLOG_UDP_PORT), handlers.SysLogHandler." -"LOG_USER)\n" +"args=(('localhost', handlers.SYSLOG_UDP_PORT), " +"handlers.SysLogHandler.LOG_USER)\n" "\n" "[handler_hand06]\n" "class=handlers.NTEventLogHandler\n" @@ -1181,8 +1184,8 @@ msgid "" "Due to the use of :func:`eval` as described above, there are potential " "security risks which result from using the :func:`listen` to send and " "receive configurations via sockets. The risks are limited to where multiple " -"users with no mutual trust run code on the same machine; see the :func:" -"`listen` documentation for more information." +"users with no mutual trust run code on the same machine; see " +"the :func:`listen` documentation for more information." msgstr "" msgid "Module :mod:`logging`" diff --git a/library/logging.handlers.po b/library/logging.handlers.po index 1cc3849603..0d8d442acc 100644 --- a/library/logging.handlers.po +++ b/library/logging.handlers.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -44,9 +44,9 @@ msgstr "" msgid "" "The following useful handlers are provided in the package. Note that three " -"of the handlers (:class:`StreamHandler`, :class:`FileHandler` and :class:" -"`NullHandler`) are actually defined in the :mod:`logging` module itself, but " -"have been documented here along with the other handlers." +"of the handlers (:class:`StreamHandler`, :class:`FileHandler` " +"and :class:`NullHandler`) are actually defined in the :mod:`logging` module " +"itself, but have been documented here along with the other handlers." msgstr "" msgid "StreamHandler" @@ -55,27 +55,27 @@ msgstr "" msgid "" "The :class:`StreamHandler` class, located in the core :mod:`logging` " "package, sends logging output to streams such as *sys.stdout*, *sys.stderr* " -"or any file-like object (or, more precisely, any object which supports :meth:" -"`write` and :meth:`flush` methods)." +"or any file-like object (or, more precisely, any object which " +"supports :meth:`write` and :meth:`flush` methods)." msgstr "" msgid "" "Returns a new instance of the :class:`StreamHandler` class. If *stream* is " -"specified, the instance will use it for logging output; otherwise, *sys." -"stderr* will be used." +"specified, the instance will use it for logging output; otherwise, " +"*sys.stderr* will be used." msgstr "" msgid "" "If a formatter is specified, it is used to format the record. The record is " "then written to the stream followed by :attr:`terminator`. If exception " -"information is present, it is formatted using :func:`traceback." -"print_exception` and appended to the stream." +"information is present, it is formatted " +"using :func:`traceback.print_exception` and appended to the stream." msgstr "" msgid "" -"Flushes the stream by calling its :meth:`flush` method. Note that the :meth:" -"`close` method is inherited from :class:`~logging.Handler` and so does no " -"output, so an explicit :meth:`flush` call may be needed at times." +"Flushes the stream by calling its :meth:`flush` method. Note that " +"the :meth:`close` method is inherited from :class:`~logging.Handler` and so " +"does no output, so an explicit :meth:`flush` call may be needed at times." msgstr "" msgid "" @@ -167,18 +167,18 @@ msgid "" msgstr "" msgid "" -"See :ref:`library-config` for more information on how to use :class:" -"`NullHandler`." +"See :ref:`library-config` for more information on how to " +"use :class:`NullHandler`." msgstr "" msgid "WatchedFileHandler" msgstr "" msgid "" -"The :class:`WatchedFileHandler` class, located in the :mod:`!logging." -"handlers` module, is a :class:`FileHandler` which watches the file it is " -"logging to. If the file changes, it is closed and reopened using the file " -"name." +"The :class:`WatchedFileHandler` class, located in the :mod:`!" +"logging.handlers` module, is a :class:`FileHandler` which watches the file " +"it is logging to. If the file changes, it is closed and reopened using the " +"file name." msgstr "" msgid "" @@ -223,11 +223,11 @@ msgid "BaseRotatingHandler" msgstr "" msgid "" -"The :class:`BaseRotatingHandler` class, located in the :mod:`!logging." -"handlers` module, is the base class for the rotating file handlers, :class:" -"`RotatingFileHandler` and :class:`TimedRotatingFileHandler`. You should not " -"need to instantiate this class, but it has attributes and methods you may " -"need to override." +"The :class:`BaseRotatingHandler` class, located in the :mod:`!" +"logging.handlers` module, is the base class for the rotating file " +"handlers, :class:`RotatingFileHandler` " +"and :class:`TimedRotatingFileHandler`. You should not need to instantiate " +"this class, but it has attributes and methods you may need to override." msgstr "" msgid "The parameters are as for :class:`FileHandler`. The attributes are:" @@ -256,10 +256,10 @@ msgid "" "determining the oldest files to delete. For this to happen, the filenames " "should be sortable using the date/time portion of the filename, and a namer " "needs to respect this. (If a namer is wanted that doesn't respect this " -"scheme, it will need to be used in a subclass of :class:" -"`TimedRotatingFileHandler` which overrides the :meth:" -"`~TimedRotatingFileHandler.getFilesToDelete` method to fit in with the " -"custom naming scheme.)" +"scheme, it will need to be used in a subclass " +"of :class:`TimedRotatingFileHandler` which overrides " +"the :meth:`~TimedRotatingFileHandler.getFilesToDelete` method to fit in with " +"the custom naming scheme.)" msgstr "" msgid "" @@ -298,17 +298,17 @@ msgid "" msgstr "" msgid "" -"The destination filename. This is normally what the source is rotated to, e." -"g. 'test.log.1'." +"The destination filename. This is normally what the source is rotated to, " +"e.g. 'test.log.1'." msgstr "" msgid "" "The reason the attributes exist is to save you having to subclass - you can " -"use the same callables for instances of :class:`RotatingFileHandler` and :" -"class:`TimedRotatingFileHandler`. If either the namer or rotator callable " -"raises an exception, this will be handled in the same way as any other " -"exception during an :meth:`emit` call, i.e. via the :meth:`handleError` " -"method of the handler." +"use the same callables for instances of :class:`RotatingFileHandler` " +"and :class:`TimedRotatingFileHandler`. If either the namer or rotator " +"callable raises an exception, this will be handled in the same way as any " +"other exception during an :meth:`emit` call, i.e. via " +"the :meth:`handleError` method of the handler." msgstr "" msgid "" @@ -323,8 +323,8 @@ msgid "RotatingFileHandler" msgstr "" msgid "" -"The :class:`RotatingFileHandler` class, located in the :mod:`!logging." -"handlers` module, supports rotation of disk log files." +"The :class:`RotatingFileHandler` class, located in the :mod:`!" +"logging.handlers` module, supports rotation of disk log files." msgstr "" msgid "" @@ -338,20 +338,21 @@ msgid "" msgstr "" msgid "" -"You can use the *maxBytes* and *backupCount* values to allow the file to :" -"dfn:`rollover` at a predetermined size. When the size is about to be " +"You can use the *maxBytes* and *backupCount* values to allow the file " +"to :dfn:`rollover` at a predetermined size. When the size is about to be " "exceeded, the file is closed and a new file is silently opened for output. " "Rollover occurs whenever the current log file is nearly *maxBytes* in " "length; but if either of *maxBytes* or *backupCount* is zero, rollover never " "occurs, so you generally want to set *backupCount* to at least 1, and have a " "non-zero *maxBytes*. When *backupCount* is non-zero, the system will save " "old log files by appending the extensions '.1', '.2' etc., to the filename. " -"For example, with a *backupCount* of 5 and a base file name of :file:`app." -"log`, you would get :file:`app.log`, :file:`app.log.1`, :file:`app.log.2`, " -"up to :file:`app.log.5`. The file being written to is always :file:`app." -"log`. When this file is filled, it is closed and renamed to :file:`app." -"log.1`, and if files :file:`app.log.1`, :file:`app.log.2`, etc. exist, then " -"they are renamed to :file:`app.log.2`, :file:`app.log.3` etc. respectively." +"For example, with a *backupCount* of 5 and a base file name " +"of :file:`app.log`, you would " +"get :file:`app.log`, :file:`app.log.1`, :file:`app.log.2`, up " +"to :file:`app.log.5`. The file being written to is always :file:`app.log`. " +"When this file is filled, it is closed and renamed to :file:`app.log.1`, and " +"if files :file:`app.log.1`, :file:`app.log.2`, etc. exist, then they are " +"renamed to :file:`app.log.2`, :file:`app.log.3` etc. respectively." msgstr "" msgid "Does a rollover, as described above." @@ -371,9 +372,9 @@ msgid "TimedRotatingFileHandler" msgstr "TimedRotatingFileHandler" msgid "" -"The :class:`TimedRotatingFileHandler` class, located in the :mod:`!logging." -"handlers` module, supports rotation of disk log files at certain timed " -"intervals." +"The :class:`TimedRotatingFileHandler` class, located in the :mod:`!" +"logging.handlers` module, supports rotation of disk log files at certain " +"timed intervals." msgstr "" msgid "" @@ -471,8 +472,8 @@ msgid "" msgstr "" msgid "" -"If *delay* is true, then file opening is deferred until the first call to :" -"meth:`emit`." +"If *delay* is true, then file opening is deferred until the first call " +"to :meth:`emit`." msgstr "" msgid "" @@ -548,8 +549,9 @@ msgid "" "Pickles the record's attribute dictionary and writes it to the socket in " "binary format. If there is an error with the socket, silently drops the " "packet. If the connection was previously lost, re-establishes the " -"connection. To unpickle the record at the receiving end into a :class:" -"`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` function." +"connection. To unpickle the record at the receiving end into " +"a :class:`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` " +"function." msgstr "" msgid "" @@ -560,8 +562,8 @@ msgstr "" msgid "" "This is a factory method which allows subclasses to define the precise type " -"of socket they want. The default implementation creates a TCP socket (:const:" -"`socket.SOCK_STREAM`)." +"of socket they want. The default implementation creates a TCP socket " +"(:const:`socket.SOCK_STREAM`)." msgstr "" msgid "" @@ -586,8 +588,8 @@ msgstr "" msgid "" "Send a pickled byte-string *packet* to the socket. The format of the sent " -"byte-string is as described in the documentation for :meth:`~SocketHandler." -"makePickle`." +"byte-string is as described in the documentation " +"for :meth:`~SocketHandler.makePickle`." msgstr "" msgid "" @@ -656,8 +658,9 @@ msgstr "" msgid "" "Pickles the record's attribute dictionary and writes it to the socket in " "binary format. If there is an error with the socket, silently drops the " -"packet. To unpickle the record at the receiving end into a :class:`~logging." -"LogRecord`, use the :func:`~logging.makeLogRecord` function." +"packet. To unpickle the record at the receiving end into " +"a :class:`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` " +"function." msgstr "" msgid "" @@ -685,25 +688,26 @@ msgid "" "``('localhost', 514)`` is used. The address is used to open a socket. An " "alternative to providing a ``(host, port)`` tuple is providing an address as " "a string, for example '/dev/log'. In this case, a Unix domain socket is used " -"to send the message to the syslog. If *facility* is not specified, :const:" -"`LOG_USER` is used. The type of socket opened depends on the *socktype* " -"argument, which defaults to :const:`socket.SOCK_DGRAM` and thus opens a UDP " -"socket. To open a TCP socket (for use with the newer syslog daemons such as " -"rsyslog), specify a value of :const:`socket.SOCK_STREAM`. If *timeout* is " -"specified, it sets a timeout (in seconds) for the socket operations. This " -"can help prevent the program from hanging indefinitely if the syslog server " -"is unreachable. By default, *timeout* is ``None``, meaning no timeout is " -"applied." +"to send the message to the syslog. If *facility* is not " +"specified, :const:`LOG_USER` is used. The type of socket opened depends on " +"the *socktype* argument, which defaults to :const:`socket.SOCK_DGRAM` and " +"thus opens a UDP socket. To open a TCP socket (for use with the newer syslog " +"daemons such as rsyslog), specify a value of :const:`socket.SOCK_STREAM`. If " +"*timeout* is specified, it sets a timeout (in seconds) for the socket " +"operations. This can help prevent the program from hanging indefinitely if " +"the syslog server is unreachable. By default, *timeout* is ``None``, meaning " +"no timeout is applied." msgstr "" msgid "" -"Note that if your server is not listening on UDP port 514, :class:" -"`SysLogHandler` may appear not to work. In that case, check what address you " -"should be using for a domain socket - it's system dependent. For example, on " -"Linux it's usually '/dev/log' but on OS/X it's '/var/run/syslog'. You'll " -"need to check your platform and use the appropriate address (you may need to " -"do this check at runtime if your application needs to run on several " -"platforms). On Windows, you pretty much have to use the UDP option." +"Note that if your server is not listening on UDP port " +"514, :class:`SysLogHandler` may appear not to work. In that case, check what " +"address you should be using for a domain socket - it's system dependent. For " +"example, on Linux it's usually '/dev/log' but on OS/X it's '/var/run/" +"syslog'. You'll need to check your platform and use the appropriate address " +"(you may need to do this check at runtime if your application needs to run " +"on several platforms). On Windows, you pretty much have to use the UDP " +"option." msgstr "" msgid "" @@ -969,10 +973,10 @@ msgid "NTEventLogHandler" msgstr "" msgid "" -"The :class:`NTEventLogHandler` class, located in the :mod:`!logging." -"handlers` module, supports sending logging messages to a local Windows NT, " -"Windows 2000 or Windows XP event log. Before you can use it, you need Mark " -"Hammond's Win32 extensions for Python installed." +"The :class:`NTEventLogHandler` class, located in the :mod:`!" +"logging.handlers` module, supports sending logging messages to a local " +"Windows NT, Windows 2000 or Windows XP event log. Before you can use it, you " +"need Mark Hammond's Win32 extensions for Python installed." msgstr "" msgid "" @@ -980,14 +984,14 @@ msgid "" "*appname* is used to define the application name as it appears in the event " "log. An appropriate registry entry is created using this name. The *dllname* " "should give the fully qualified pathname of a .dll or .exe which contains " -"message definitions to hold in the log (if not specified, ``'win32service." -"pyd'`` is used - this is installed with the Win32 extensions and contains " -"some basic placeholder message definitions. Note that use of these " -"placeholders will make your event logs big, as the entire message source is " -"held in the log. If you want slimmer logs, you have to pass in the name of " -"your own .dll or .exe which contains the message definitions you want to use " -"in the event log). The *logtype* is one of ``'Application'``, ``'System'`` " -"or ``'Security'``, and defaults to ``'Application'``." +"message definitions to hold in the log (if not specified, " +"``'win32service.pyd'`` is used - this is installed with the Win32 extensions " +"and contains some basic placeholder message definitions. Note that use of " +"these placeholders will make your event logs big, as the entire message " +"source is held in the log. If you want slimmer logs, you have to pass in the " +"name of your own .dll or .exe which contains the message definitions you " +"want to use in the event log). The *logtype* is one of ``'Application'``, " +"``'System'`` or ``'Security'``, and defaults to ``'Application'``." msgstr "" msgid "" @@ -1012,10 +1016,11 @@ msgid "" "Returns the event type for the record. Override this if you want to specify " "your own types. This version does a mapping using the handler's typemap " "attribute, which is set up in :meth:`__init__` to a dictionary which " -"contains mappings for :const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :" -"const:`ERROR` and :const:`CRITICAL`. If you are using your own levels, you " -"will either need to override this method or place a suitable dictionary in " -"the handler's *typemap* attribute." +"contains mappings " +"for :const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :const:`ERROR` " +"and :const:`CRITICAL`. If you are using your own levels, you will either " +"need to override this method or place a suitable dictionary in the handler's " +"*typemap* attribute." msgstr "" msgid "" @@ -1049,8 +1054,8 @@ msgid "" "*secure* argument. This will only be used when authentication credentials " "are supplied. The tuple should be either an empty tuple, or a single-value " "tuple with the name of a keyfile, or a 2-value tuple with the names of the " -"keyfile and certificate file. (This tuple is passed to the :meth:`smtplib." -"SMTP.starttls` method.)" +"keyfile and certificate file. (This tuple is passed to " +"the :meth:`smtplib.SMTP.starttls` method.)" msgstr "" msgid "" @@ -1080,11 +1085,11 @@ msgid "" msgstr "" msgid "" -":class:`MemoryHandler` is a subclass of the more general :class:" -"`BufferingHandler`, which is an abstract class. This buffers logging records " -"in memory. Whenever each record is added to the buffer, a check is made by " -"calling :meth:`shouldFlush` to see if the buffer should be flushed. If it " -"should, then :meth:`flush` is expected to do the flushing." +":class:`MemoryHandler` is a subclass of the more " +"general :class:`BufferingHandler`, which is an abstract class. This buffers " +"logging records in memory. Whenever each record is added to the buffer, a " +"check is made by calling :meth:`shouldFlush` to see if the buffer should be " +"flushed. If it should, then :meth:`flush` is expected to do the flushing." msgstr "" msgid "" @@ -1093,8 +1098,8 @@ msgid "" msgstr "" msgid "" -"Append the record to the buffer. If :meth:`shouldFlush` returns true, call :" -"meth:`flush` to process the buffer." +"Append the record to the buffer. If :meth:`shouldFlush` returns true, " +"call :meth:`flush` to process the buffer." msgstr "" msgid "" @@ -1151,13 +1156,13 @@ msgid "" "Returns a new instance of the :class:`HTTPHandler` class. The *host* can be " "of the form ``host:port``, should you need to use a specific port number. " "If no *method* is specified, ``GET`` is used. If *secure* is true, a HTTPS " -"connection will be used. The *context* parameter may be set to a :class:`ssl." -"SSLContext` instance to configure the SSL settings used for the HTTPS " -"connection. If *credentials* is specified, it should be a 2-tuple consisting " -"of userid and password, which will be placed in a HTTP 'Authorization' " -"header using Basic authentication. If you specify credentials, you should " -"also specify secure=True so that your userid and password are not passed in " -"cleartext across the wire." +"connection will be used. The *context* parameter may be set to " +"a :class:`ssl.SSLContext` instance to configure the SSL settings used for " +"the HTTPS connection. If *credentials* is specified, it should be a 2-tuple " +"consisting of userid and password, which will be placed in a HTTP " +"'Authorization' header using Basic authentication. If you specify " +"credentials, you should also specify secure=True so that your userid and " +"password are not passed in cleartext across the wire." msgstr "" msgid "The *context* parameter was added." @@ -1165,16 +1170,16 @@ msgstr "" msgid "" "Provides a dictionary, based on ``record``, which is to be URL-encoded and " -"sent to the web server. The default implementation just returns ``record." -"__dict__``. This method can be overridden if e.g. only a subset of :class:" -"`~logging.LogRecord` is to be sent to the web server, or if more specific " -"customization of what's sent to the server is required." +"sent to the web server. The default implementation just returns " +"``record.__dict__``. This method can be overridden if e.g. only a subset " +"of :class:`~logging.LogRecord` is to be sent to the web server, or if more " +"specific customization of what's sent to the server is required." msgstr "" msgid "" -"Sends the record to the web server as a URL-encoded dictionary. The :meth:" -"`mapLogRecord` method is used to convert the record to the dictionary to be " -"sent." +"Sends the record to the web server as a URL-encoded dictionary. " +"The :meth:`mapLogRecord` method is used to convert the record to the " +"dictionary to be sent." msgstr "" msgid "" @@ -1214,26 +1219,28 @@ msgid "" msgstr "" msgid "" -"If you are using :mod:`multiprocessing`, you should avoid using :class:" -"`~queue.SimpleQueue` and instead use :class:`multiprocessing.Queue`." +"If you are using :mod:`multiprocessing`, you should avoid " +"using :class:`~queue.SimpleQueue` and instead " +"use :class:`multiprocessing.Queue`." msgstr "" msgid "" "The :mod:`multiprocessing` module uses an internal logger created and " -"accessed via :meth:`~multiprocessing.get_logger`. :class:`multiprocessing." -"Queue` will log ``DEBUG`` level messages upon items being queued. If those " -"log messages are processed by a :class:`QueueHandler` using the same :class:" -"`multiprocessing.Queue` instance, it will cause a deadlock or infinite " -"recursion." +"accessed " +"via :meth:`~multiprocessing.get_logger`. :class:`multiprocessing.Queue` will " +"log ``DEBUG`` level messages upon items being queued. If those log messages " +"are processed by a :class:`QueueHandler` using the " +"same :class:`multiprocessing.Queue` instance, it will cause a deadlock or " +"infinite recursion." msgstr "" msgid "" -"Enqueues the result of preparing the LogRecord. Should an exception occur (e." -"g. because a bounded queue has filled up), the :meth:`~logging.Handler." -"handleError` method is called to handle the error. This can result in the " -"record silently being dropped (if :data:`logging.raiseExceptions` is " -"``False``) or a message printed to ``sys.stderr`` (if :data:`logging." -"raiseExceptions` is ``True``)." +"Enqueues the result of preparing the LogRecord. Should an exception occur " +"(e.g. because a bounded queue has filled up), " +"the :meth:`~logging.Handler.handleError` method is called to handle the " +"error. This can result in the record silently being dropped " +"(if :data:`logging.raiseExceptions` is ``False``) or a message printed to " +"``sys.stderr`` (if :data:`logging.raiseExceptions` is ``True``)." msgstr "" msgid "" @@ -1244,10 +1251,11 @@ msgstr "" msgid "" "The base implementation formats the record to merge the message, arguments, " "exception and stack information, if present. It also removes unpickleable " -"items from the record in-place. Specifically, it overwrites the record's :" -"attr:`msg` and :attr:`message` attributes with the merged message (obtained " -"by calling the handler's :meth:`format` method), and sets the :attr:`args`, :" -"attr:`exc_info` and :attr:`exc_text` attributes to ``None``." +"items from the record in-place. Specifically, it overwrites the " +"record's :attr:`msg` and :attr:`message` attributes with the merged message " +"(obtained by calling the handler's :meth:`format` method), and sets " +"the :attr:`args`, :attr:`exc_info` and :attr:`exc_text` attributes to " +"``None``." msgstr "" msgid "" @@ -1260,8 +1268,8 @@ msgid "" "The base implementation formats the message with arguments, sets the " "``message`` and ``msg`` attributes to the formatted message and sets the " "``args`` and ``exc_text`` attributes to ``None`` to allow pickling and to " -"prevent further attempts at formatting. This means that a handler on the :" -"class:`QueueListener` side won't have the information to do custom " +"prevent further attempts at formatting. This means that a handler on " +"the :class:`QueueListener` side won't have the information to do custom " "formatting, e.g. of exceptions. You may wish to subclass ``QueueHandler`` " "and override this method to e.g. avoid setting ``exc_text`` to ``None``. " "Note that the ``message`` / ``msg`` / ``args`` changes are related to " @@ -1291,9 +1299,9 @@ msgid "" "module, supports receiving logging messages from a queue, such as those " "implemented in the :mod:`queue` or :mod:`multiprocessing` modules. The " "messages are received from a queue in an internal thread and passed, on the " -"same thread, to one or more handlers for processing. While :class:" -"`QueueListener` is not itself a handler, it is documented here because it " -"works hand-in-hand with :class:`QueueHandler`." +"same thread, to one or more handlers for processing. " +"While :class:`QueueListener` is not itself a handler, it is documented here " +"because it works hand-in-hand with :class:`QueueHandler`." msgstr "" msgid "" @@ -1311,8 +1319,8 @@ msgid "" "will handle entries placed on the queue. The queue can be any queue-like " "object; it's passed as-is to the :meth:`dequeue` method, which needs to know " "how to get messages from it. The queue is not *required* to have the task " -"tracking API (though it's used if available), which means that you can use :" -"class:`~queue.SimpleQueue` instances for *queue*." +"tracking API (though it's used if available), which means that you can " +"use :class:`~queue.SimpleQueue` instances for *queue*." msgstr "" msgid "" @@ -1326,9 +1334,10 @@ msgid "The ``respect_handler_level`` argument was added." msgstr "" msgid "" -":class:`QueueListener` can now be used as a context manager via :keyword:" -"`with`. When entering the context, the listener is started. When exiting the " -"context, the listener is stopped. :meth:`~contextmanager.__enter__` returns " +":class:`QueueListener` can now be used as a context manager " +"via :keyword:`with`. When entering the context, the listener is started. " +"When exiting the context, the listener is " +"stopped. :meth:`~contextmanager.__enter__` returns " "the :class:`QueueListener` object." msgstr "" @@ -1354,8 +1363,8 @@ msgstr "" msgid "" "This just loops through the handlers offering them the record to handle. The " -"actual object passed to the handlers is that which is returned from :meth:" -"`prepare`." +"actual object passed to the handlers is that which is returned " +"from :meth:`prepare`." msgstr "" msgid "Starts the listener." diff --git a/library/logging.po b/library/logging.po index 97247111ff..ceeb01818f 100644 --- a/library/logging.po +++ b/library/logging.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -158,14 +158,14 @@ msgid "" "are all descendants of ``foo``. In addition, all loggers are descendants of " "the root logger. The logger name hierarchy is analogous to the Python " "package hierarchy, and identical to it if you organise your loggers on a per-" -"module basis using the recommended construction ``logging." -"getLogger(__name__)``. That's because in a module, ``__name__`` is the " -"module's name in the Python package namespace." +"module basis using the recommended construction " +"``logging.getLogger(__name__)``. That's because in a module, ``__name__`` " +"is the module's name in the Python package namespace." msgstr "" msgid "" -"This is the logger's name, and is the value that was passed to :func:" -"`getLogger` to obtain the logger." +"This is the logger's name, and is the value that was passed " +"to :func:`getLogger` to obtain the logger." msgstr "" msgid "This attribute should be treated as read-only." @@ -286,25 +286,27 @@ msgstr "" msgid "" "Indicates if a message of severity *level* would be processed by this " -"logger. This method checks first the module-level level set by ``logging." -"disable(level)`` and then the logger's effective level as determined by :" -"meth:`getEffectiveLevel`." +"logger. This method checks first the module-level level set by " +"``logging.disable(level)`` and then the logger's effective level as " +"determined by :meth:`getEffectiveLevel`." msgstr "" msgid "" -"Indicates the effective level for this logger. If a value other than :const:" -"`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise, the " -"hierarchy is traversed towards the root until a value other than :const:" -"`NOTSET` is found, and that value is returned. The value returned is an " -"integer, typically one of :const:`logging.DEBUG`, :const:`logging.INFO` etc." +"Indicates the effective level for this logger. If a value other " +"than :const:`NOTSET` has been set using :meth:`setLevel`, it is returned. " +"Otherwise, the hierarchy is traversed towards the root until a value other " +"than :const:`NOTSET` is found, and that value is returned. The value " +"returned is an integer, typically one " +"of :const:`logging.DEBUG`, :const:`logging.INFO` etc." msgstr "" msgid "" "Returns a logger which is a descendant to this logger, as determined by the " "suffix. Thus, ``logging.getLogger('abc').getChild('def.ghi')`` would return " -"the same logger as would be returned by ``logging.getLogger('abc.def." -"ghi')``. This is a convenience method, useful when the parent logger is " -"named using e.g. ``__name__`` rather than a literal string." +"the same logger as would be returned by " +"``logging.getLogger('abc.def.ghi')``. This is a convenience method, useful " +"when the parent logger is named using e.g. ``__name__`` rather than a " +"literal string." msgstr "" msgid "" @@ -366,18 +368,18 @@ msgstr "" msgid "" "The third optional keyword argument is *stacklevel*, which defaults to " "``1``. If greater than 1, the corresponding number of stack frames are " -"skipped when computing the line number and function name set in the :class:" -"`LogRecord` created for the logging event. This can be used in logging " -"helpers so that the function name, filename and line number recorded are not " -"the information for the helper function/method, but rather its caller. The " -"name of this parameter mirrors the equivalent one in the :mod:`warnings` " -"module." +"skipped when computing the line number and function name set in " +"the :class:`LogRecord` created for the logging event. This can be used in " +"logging helpers so that the function name, filename and line number recorded " +"are not the information for the helper function/method, but rather its " +"caller. The name of this parameter mirrors the equivalent one in " +"the :mod:`warnings` module." msgstr "" msgid "" "The fourth keyword argument is *extra* which can be used to pass a " -"dictionary which is used to populate the :attr:`~object.__dict__` of the :" -"class:`LogRecord` created for the logging event with user-defined " +"dictionary which is used to populate the :attr:`~object.__dict__` of " +"the :class:`LogRecord` created for the logging event with user-defined " "attributes. These custom attributes can then be used as you like. For " "example, they could be incorporated into logged messages. For example::" msgstr "" @@ -406,12 +408,12 @@ msgstr "" msgid "" "If you choose to use these attributes in logged messages, you need to " -"exercise some care. In the above example, for instance, the :class:" -"`Formatter` has been set up with a format string which expects 'clientip' " -"and 'user' in the attribute dictionary of the :class:`LogRecord`. If these " -"are missing, the message will not be logged because a string formatting " -"exception will occur. So in this case, you always need to pass the *extra* " -"dictionary with these keys." +"exercise some care. In the above example, for instance, " +"the :class:`Formatter` has been set up with a format string which expects " +"'clientip' and 'user' in the attribute dictionary of the :class:`LogRecord`. " +"If these are missing, the message will not be logged because a string " +"formatting exception will occur. So in this case, you always need to pass " +"the *extra* dictionary with these keys." msgstr "" msgid "" @@ -519,8 +521,8 @@ msgid "" "Handles a record by passing it to all handlers associated with this logger " "and its ancestors (until a false value of *propagate* is found). This method " "is used for unpickled records received from a socket, as well as those " -"created locally. Logger-level filtering is applied using :meth:`~Logger." -"filter`." +"created locally. Logger-level filtering is applied " +"using :meth:`~Logger.filter`." msgstr "" msgid "" @@ -612,16 +614,16 @@ msgid "Handler Objects" msgstr "" msgid "" -"Handlers have the following attributes and methods. Note that :class:" -"`Handler` is never instantiated directly; this class acts as a base for more " -"useful subclasses. However, the :meth:`!__init__` method in subclasses needs " -"to call :meth:`Handler.__init__`." +"Handlers have the following attributes and methods. Note " +"that :class:`Handler` is never instantiated directly; this class acts as a " +"base for more useful subclasses. However, the :meth:`!__init__` method in " +"subclasses needs to call :meth:`Handler.__init__`." msgstr "" msgid "" "Initializes the :class:`Handler` instance by setting its level, setting the " -"list of filters to the empty list and creating a lock (using :meth:" -"`createLock`) for serializing access to an I/O mechanism." +"list of filters to the empty list and creating a lock " +"(using :meth:`createLock`) for serializing access to an I/O mechanism." msgstr "" msgid "" @@ -647,8 +649,8 @@ msgid "" msgstr "" msgid "" -"Sets the formatter for this handler to *fmt*. The *fmt* argument must be a :" -"class:`Formatter` instance or ``None``." +"Sets the formatter for this handler to *fmt*. The *fmt* argument must be " +"a :class:`Formatter` instance or ``None``." msgstr "" msgid "Adds the specified filter *filter* to this handler." @@ -689,14 +691,15 @@ msgstr "" msgid "" "This method should be called from handlers when an exception is encountered " -"during an :meth:`emit` call. If the module-level attribute :data:" -"`raiseExceptions` is ``False``, exceptions get silently ignored. This is " -"what is mostly wanted for a logging system - most users will not care about " -"errors in the logging system, they are more interested in application " -"errors. You could, however, replace this with a custom handler if you wish. " -"The specified record is the one which was being processed when the exception " -"occurred. (The default value of :data:`raiseExceptions` is ``True``, as that " -"is more useful during development)." +"during an :meth:`emit` call. If the module-level " +"attribute :data:`raiseExceptions` is ``False``, exceptions get silently " +"ignored. This is what is mostly wanted for a logging system - most users " +"will not care about errors in the logging system, they are more interested " +"in application errors. You could, however, replace this with a custom " +"handler if you wish. The specified record is the one which was being " +"processed when the exception occurred. (The default value " +"of :data:`raiseExceptions` is ``True``, as that is more useful during " +"development)." msgstr "" msgid "" @@ -706,8 +709,8 @@ msgstr "" msgid "" "Do whatever it takes to actually log the specified logging record. This " -"version is intended to be implemented by subclasses and so raises a :exc:" -"`NotImplementedError`." +"version is intended to be implemented by subclasses and so raises " +"a :exc:`NotImplementedError`." msgstr "" msgid "" @@ -749,9 +752,9 @@ msgstr "parametry" msgid "" "A format string in the given *style* for the logged output as a whole. The " -"possible mapping keys are drawn from the :class:`LogRecord` object's :ref:" -"`logrecord-attributes`. If not specified, ``'%(message)s'`` is used, which " -"is just the logged message." +"possible mapping keys are drawn from the :class:`LogRecord` " +"object's :ref:`logrecord-attributes`. If not specified, ``'%(message)s'`` is " +"used, which is just the logged message." msgstr "" msgid "" @@ -771,8 +774,8 @@ msgstr "" msgid "" "If ``True`` (the default), incorrect or mismatched *fmt* and *style* will " -"raise a :exc:`ValueError`; for example, ``logging.Formatter('%(asctime)s - " -"%(message)s', style='{')``." +"raise a :exc:`ValueError`; for example, ``logging.Formatter('%(asctime)s - %" +"(message)s', style='{')``." msgstr "" msgid "" @@ -795,11 +798,11 @@ msgid "" "dictionary, a couple of preparatory steps are carried out. The *message* " "attribute of the record is computed using *msg* % *args*. If the formatting " "string contains ``'(asctime)'``, :meth:`formatTime` is called to format the " -"event time. If there is exception information, it is formatted using :meth:" -"`formatException` and appended to the message. Note that the formatted " -"exception information is cached in attribute *exc_text*. This is useful " -"because the exception information can be pickled and sent across the wire, " -"but you should be careful if you have more than one :class:`Formatter` " +"event time. If there is exception information, it is formatted " +"using :meth:`formatException` and appended to the message. Note that the " +"formatted exception information is cached in attribute *exc_text*. This is " +"useful because the exception information can be pickled and sent across the " +"wire, but you should be careful if you have more than one :class:`Formatter` " "subclass which customizes the formatting of exception information. In this " "case, you will have to clear the cached value (by setting the *exc_text* " "attribute to ``None``) after a formatter has done its formatting, so that " @@ -816,12 +819,12 @@ msgid "" "This method should be called from :meth:`format` by a formatter which wants " "to make use of a formatted time. This method can be overridden in formatters " "to provide for any specific requirement, but the basic behavior is as " -"follows: if *datefmt* (a string) is specified, it is used with :func:`time." -"strftime` to format the creation time of the record. Otherwise, the format " -"'%Y-%m-%d %H:%M:%S,uuu' is used, where the uuu part is a millisecond value " -"and the other letters are as per the :func:`time.strftime` documentation. " -"An example time in this format is ``2003-01-23 00:29:50,411``. The " -"resulting string is returned." +"follows: if *datefmt* (a string) is specified, it is used " +"with :func:`time.strftime` to format the creation time of the record. " +"Otherwise, the format '%Y-%m-%d %H:%M:%S,uuu' is used, where the uuu part is " +"a millisecond value and the other letters are as per " +"the :func:`time.strftime` documentation. An example time in this format is " +"``2003-01-23 00:29:50,411``. The resulting string is returned." msgstr "" msgid "" @@ -858,9 +861,9 @@ msgid "" msgstr "" msgid "" -"Formats the specified stack information (a string as returned by :func:" -"`traceback.print_stack`, but with the last newline removed) as a string. " -"This default implementation just returns the input value." +"Formats the specified stack information (a string as returned " +"by :func:`traceback.print_stack`, but with the last newline removed) as a " +"string. This default implementation just returns the input value." msgstr "" msgid "" @@ -935,8 +938,8 @@ msgid "" "You don't need to create specialized ``Filter`` classes, or use other " "classes with a ``filter`` method: you can use a function (or other callable) " "as a filter. The filtering logic will check to see if the filter object has " -"a ``filter`` attribute: if it does, it's assumed to be a ``Filter`` and its :" -"meth:`~Filter.filter` method is called. Otherwise, it's assumed to be a " +"a ``filter`` attribute: if it does, it's assumed to be a ``Filter`` and " +"its :meth:`~Filter.filter` method is called. Otherwise, it's assumed to be a " "callable and called with the record as the single parameter. The returned " "value should conform to that returned by :meth:`~Filter.filter`." msgstr "" @@ -963,10 +966,10 @@ msgid "LogRecord Objects" msgstr "" msgid "" -":class:`LogRecord` instances are created automatically by the :class:" -"`Logger` every time something is logged, and can be created manually via :" -"func:`makeLogRecord` (for example, from a pickled event received over the " -"wire)." +":class:`LogRecord` instances are created automatically by " +"the :class:`Logger` every time something is logged, and can be created " +"manually via :func:`makeLogRecord` (for example, from a pickled event " +"received over the wire)." msgstr "" msgid "Contains all the information pertinent to the event being logged." @@ -987,8 +990,8 @@ msgstr "" msgid "" "The :ref:`numeric level ` of the logging event (such as ``10`` for " "``DEBUG``, ``20`` for ``INFO``, etc). Note that this is converted to *two* " -"attributes of the LogRecord: :attr:`!levelno` for the numeric value and :" -"attr:`!levelname` for the corresponding level name." +"attributes of the LogRecord: :attr:`!levelno` for the numeric value " +"and :attr:`!levelname` for the corresponding level name." msgstr "" msgid "" @@ -1010,8 +1013,9 @@ msgid "" msgstr "" msgid "" -"An exception tuple with the current exception information, as returned by :" -"func:`sys.exc_info`, or ``None`` if no exception information is available." +"An exception tuple with the current exception information, as returned " +"by :func:`sys.exc_info`, or ``None`` if no exception information is " +"available." msgstr "" msgid "" @@ -1039,8 +1043,8 @@ msgid "" msgstr "" msgid "" -"This functionality can be used to inject your own values into a :class:" -"`LogRecord` at creation time. You can use the following pattern::" +"This functionality can be used to inject your own values into " +"a :class:`LogRecord` at creation time. You can use the following pattern::" msgstr "" msgid "" @@ -1075,8 +1079,8 @@ msgstr "" msgid "" "If you are using {}-formatting (:func:`str.format`), you can use ``{attrname}" -"`` as the placeholder in the format string. If you are using $-formatting (:" -"class:`string.Template`), use the form ``${attrname}``. In both cases, of " +"`` as the placeholder in the format string. If you are using $-formatting " +"(:class:`string.Template`), use the form ``${attrname}``. In both cases, of " "course, replace ``attrname`` with the actual attribute name you want to use." msgstr "" @@ -1128,8 +1132,8 @@ msgid "``%(created)f``" msgstr "``%(created)f``" msgid "" -"Time when the :class:`LogRecord` was created (as returned by :func:`time." -"time_ns` / 1e9)." +"Time when the :class:`LogRecord` was created (as returned " +"by :func:`time.time_ns` / 1e9)." msgstr "" msgid "exc_info" @@ -1144,8 +1148,9 @@ msgid "exc_text" msgstr "" msgid "" -"Exception information formatted as a string. This is set when :meth:" -"`Formatter.format` is invoked, or ``None`` if no exception has occurred." +"Exception information formatted as a string. This is set " +"when :meth:`Formatter.format` is invoked, or ``None`` if no exception has " +"occurred." msgstr "" msgid "filename" @@ -1184,8 +1189,8 @@ msgid "``%(levelno)s``" msgstr "``%(levelno)s``" msgid "" -"Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" -"`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." +"Numeric logging level for the message " +"(:const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." msgstr "" msgid "lineno" @@ -1204,8 +1209,8 @@ msgid "``%(message)s``" msgstr "``%(message)s``" msgid "" -"The logged message, computed as ``msg % args``. This is set when :meth:" -"`Formatter.format` is invoked." +"The logged message, computed as ``msg % args``. This is set " +"when :meth:`Formatter.format` is invoked." msgstr "" msgid "module" @@ -1332,18 +1337,19 @@ msgstr "" msgid "" ":class:`LoggerAdapter` instances are used to conveniently pass contextual " -"information into logging calls. For a usage example, see the section on :ref:" -"`adding contextual information to your logging output `." +"information into logging calls. For a usage example, see the section " +"on :ref:`adding contextual information to your logging output `." msgstr "" msgid "" "Returns an instance of :class:`LoggerAdapter` initialized with an " "underlying :class:`Logger` instance, an optional dict-like object (*extra*), " "and an optional boolean (*merge_extra*) indicating whether or not the " -"*extra* argument of individual log calls should be merged with the :class:" -"`LoggerAdapter` extra. The default behavior is to ignore the *extra* " -"argument of individual log calls and only use the one of the :class:" -"`LoggerAdapter` instance" +"*extra* argument of individual log calls should be merged with " +"the :class:`LoggerAdapter` extra. The default behavior is to ignore the " +"*extra* argument of individual log calls and only use the one of " +"the :class:`LoggerAdapter` instance" msgstr "" msgid "" @@ -1362,19 +1368,17 @@ msgstr "" msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " -"methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" -"meth:`~Logger.warning`, :meth:`~Logger.error`, :meth:`~Logger.exception`, :" -"meth:`~Logger.critical`, :meth:`~Logger.log`, :meth:`~Logger.isEnabledFor`, :" -"meth:`~Logger.getEffectiveLevel`, :meth:`~Logger.setLevel` and :meth:" -"`~Logger.hasHandlers`. These methods have the same signatures as their " -"counterparts in :class:`Logger`, so you can use the two types of instances " -"interchangeably." +"methods " +"of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :meth:`~Logger.warning`, :meth:`~Logger.error`, :meth:`~Logger.exception`, :meth:`~Logger.critical`, :meth:`~Logger.log`, :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:`~Logger.setLevel` " +"and :meth:`~Logger.hasHandlers`. These methods have the same signatures as " +"their counterparts in :class:`Logger`, so you can use the two types of " +"instances interchangeably." msgstr "" msgid "" -"The :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:" -"`~Logger.setLevel` and :meth:`~Logger.hasHandlers` methods were added to :" -"class:`LoggerAdapter`. These methods delegate to the underlying logger." +"The :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:`~Logger.setLevel` " +"and :meth:`~Logger.hasHandlers` methods were added " +"to :class:`LoggerAdapter`. These methods delegate to the underlying logger." msgstr "" msgid "" @@ -1463,8 +1467,9 @@ msgid "" msgstr "" msgid "" -"The only difference is that if the root logger has no handlers, then :func:" -"`basicConfig` is called, prior to calling ``debug`` on the root logger." +"The only difference is that if the root logger has no handlers, " +"then :func:`basicConfig` is called, prior to calling ``debug`` on the root " +"logger." msgstr "" msgid "" @@ -1521,10 +1526,10 @@ msgid "" "useful. Its effect is to disable all logging calls of severity *level* and " "below, so that if you call it with a value of INFO, then all INFO and DEBUG " "events would be discarded, whereas those of severity WARNING and above would " -"be processed according to the logger's effective level. If ``logging." -"disable(logging.NOTSET)`` is called, it effectively removes this overriding " -"level, so that logging output again depends on the effective levels of " -"individual loggers." +"be processed according to the logger's effective level. If " +"``logging.disable(logging.NOTSET)`` is called, it effectively removes this " +"overriding level, so that logging output again depends on the effective " +"levels of individual loggers." msgstr "" msgid "" @@ -1535,8 +1540,8 @@ msgid "" msgstr "" msgid "" -"The *level* parameter was defaulted to level ``CRITICAL``. See :issue:" -"`28524` for more information about this change." +"The *level* parameter was defaulted to level ``CRITICAL``. " +"See :issue:`28524` for more information about this change." msgstr "" msgid "" @@ -1549,8 +1554,8 @@ msgid "" msgstr "" msgid "" -"If you are thinking of defining your own levels, please see the section on :" -"ref:`custom-levels`." +"If you are thinking of defining your own levels, please see the section " +"on :ref:`custom-levels`." msgstr "" msgid "" @@ -1563,12 +1568,13 @@ msgid "Returns the textual or numeric representation of logging level *level*." msgstr "" msgid "" -"If *level* is one of the predefined levels :const:`CRITICAL`, :const:" -"`ERROR`, :const:`WARNING`, :const:`INFO` or :const:`DEBUG` then you get the " -"corresponding string. If you have associated levels with names using :func:" -"`addLevelName` then the name you have associated with *level* is returned. " -"If a numeric value corresponding to one of the defined levels is passed in, " -"the corresponding string representation is returned." +"If *level* is one of the predefined " +"levels :const:`CRITICAL`, :const:`ERROR`, :const:`WARNING`, :const:`INFO` " +"or :const:`DEBUG` then you get the corresponding string. If you have " +"associated levels with names using :func:`addLevelName` then the name you " +"have associated with *level* is returned. If a numeric value corresponding " +"to one of the defined levels is passed in, the corresponding string " +"representation is returned." msgstr "" msgid "" @@ -1585,9 +1591,9 @@ msgstr "" msgid "" "Levels are internally integers (as they need to be compared in the logging " "logic). This function is used to convert between an integer level and the " -"level name displayed in the formatted log output by means of the " -"``%(levelname)s`` format specifier (see :ref:`logrecord-attributes`), and " -"vice versa." +"level name displayed in the formatted log output by means of the ``%" +"(levelname)s`` format specifier (see :ref:`logrecord-attributes`), and vice " +"versa." msgstr "" msgid "" @@ -1607,17 +1613,18 @@ msgstr "" msgid "" "Creates and returns a new :class:`LogRecord` instance whose attributes are " -"defined by *attrdict*. This function is useful for taking a pickled :class:" -"`LogRecord` attribute dictionary, sent over a socket, and reconstituting it " -"as a :class:`LogRecord` instance at the receiving end." +"defined by *attrdict*. This function is useful for taking a " +"pickled :class:`LogRecord` attribute dictionary, sent over a socket, and " +"reconstituting it as a :class:`LogRecord` instance at the receiving end." msgstr "" msgid "" -"Does basic configuration for the logging system by creating a :class:" -"`StreamHandler` with a default :class:`Formatter` and adding it to the root " -"logger. The functions :func:`debug`, :func:`info`, :func:`warning`, :func:" -"`error` and :func:`critical` will call :func:`basicConfig` automatically if " -"no handlers are defined for the root logger." +"Does basic configuration for the logging system by creating " +"a :class:`StreamHandler` with a default :class:`Formatter` and adding it to " +"the root logger. The " +"functions :func:`debug`, :func:`info`, :func:`warning`, :func:`error` " +"and :func:`critical` will call :func:`basicConfig` automatically if no " +"handlers are defined for the root logger." msgstr "" msgid "" @@ -1728,8 +1735,9 @@ msgid "" "If this keyword argument is specified along with *filename*, its value is " "used when the :class:`FileHandler` is created, and thus used when opening " "the output file. If not specified, the value 'backslashreplace' is used. " -"Note that if ``None`` is specified, it will be passed as such to :func:" -"`open`, which means that it will be treated the same as passing 'errors'." +"Note that if ``None`` is specified, it will be passed as such " +"to :func:`open`, which means that it will be treated the same as passing " +"'errors'." msgstr "" msgid "The *style* argument was added." @@ -1761,8 +1769,8 @@ msgstr "" msgid "" "Tells the logging system to use the class *klass* when instantiating a " "logger. The class should define :meth:`!__init__` such that only a name " -"argument is required, and the :meth:`!__init__` should call :meth:`!Logger." -"__init__`. This function is typically called before any loggers are " +"argument is required, and the :meth:`!__init__` should call :meth:`!" +"Logger.__init__`. This function is typically called before any loggers are " "instantiated by applications which need to use custom logger behavior. After " "this call, as at any other time, do not instantiate loggers directly using " "the subclass: continue to use the :func:`logging.getLogger` API to get your " @@ -1843,13 +1851,13 @@ msgid "Module-Level Attributes" msgstr "" msgid "" -"A \"handler of last resort\" is available through this attribute. This is a :" -"class:`StreamHandler` writing to ``sys.stderr`` with a level of ``WARNING``, " -"and is used to handle logging events in the absence of any logging " -"configuration. The end result is to just print the message to ``sys." -"stderr``. This replaces the earlier error message saying that \"no handlers " -"could be found for logger XYZ\". If you need the earlier behaviour for some " -"reason, ``lastResort`` can be set to ``None``." +"A \"handler of last resort\" is available through this attribute. This is " +"a :class:`StreamHandler` writing to ``sys.stderr`` with a level of " +"``WARNING``, and is used to handle logging events in the absence of any " +"logging configuration. The end result is to just print the message to " +"``sys.stderr``. This replaces the earlier error message saying that \"no " +"handlers could be found for logger XYZ\". If you need the earlier behaviour " +"for some reason, ``lastResort`` can be set to ``None``." msgstr "" msgid "Used to see if exceptions during handling should be propagated." @@ -1881,14 +1889,14 @@ msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " "formatted using :func:`warnings.formatwarning` and the resulting string " -"logged to a logger named ``'py.warnings'`` with a severity of :const:" -"`WARNING`." +"logged to a logger named ``'py.warnings'`` with a severity " +"of :const:`WARNING`." msgstr "" msgid "" "If *capture* is ``False``, the redirection of warnings to the logging system " -"will stop, and warnings will be redirected to their original destinations (i." -"e. those in effect before ``captureWarnings(True)`` was called)." +"will stop, and warnings will be redirected to their original destinations " +"(i.e. those in effect before ``captureWarnings(True)`` was called)." msgstr "" msgid "Module :mod:`logging.config`" @@ -1912,8 +1920,8 @@ msgid "" msgstr "" msgid "" -"`Original Python logging package `_" +"`Original Python logging package `_" msgstr "" msgid "" diff --git a/library/lzma.po b/library/lzma.po index 01b4bac1c7..9dadf75626 100644 --- a/library/lzma.po +++ b/library/lzma.po @@ -4,17 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,10 +38,10 @@ msgid "" msgstr "" msgid "" -"The interface provided by this module is very similar to that of the :mod:" -"`bz2` module. Note that :class:`LZMAFile` and :class:`bz2.BZ2File` are *not* " -"thread-safe, so if you need to use a single :class:`LZMAFile` instance from " -"multiple threads, it is necessary to protect it with a lock." +"The interface provided by this module is very similar to that of " +"the :mod:`bz2` module. Note that :class:`LZMAFile` and :class:`bz2.BZ2File` " +"are *not* thread-safe, so if you need to use a single :class:`LZMAFile` " +"instance from multiple threads, it is necessary to protect it with a lock." msgstr "" msgid "" @@ -52,8 +52,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "" "This exception is raised when an error occurs during compression or " @@ -69,10 +69,10 @@ msgid "" msgstr "" msgid "" -"The *filename* argument can be either an actual file name (given as a :class:" -"`str`, :class:`bytes` or :term:`path-like ` object), in " -"which case the named file is opened, or it can be an existing file object to " -"read from or write to." +"The *filename* argument can be either an actual file name (given as " +"a :class:`str`, :class:`bytes` or :term:`path-like ` " +"object), in which case the named file is opened, or it can be an existing " +"file object to read from or write to." msgstr "" msgid "" @@ -100,8 +100,8 @@ msgid "" msgstr "" msgid "" -"For text mode, a :class:`LZMAFile` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"For text mode, a :class:`LZMAFile` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" @@ -117,10 +117,10 @@ msgstr "" msgid "" "An :class:`LZMAFile` can wrap an already-open :term:`file object`, or " "operate directly on a named file. The *filename* argument specifies either " -"the file object to wrap, or the name of the file to open (as a :class:" -"`str`, :class:`bytes` or :term:`path-like ` object). When " -"wrapping an existing file object, the wrapped file will not be closed when " -"the :class:`LZMAFile` is closed." +"the file object to wrap, or the name of the file to open (as " +"a :class:`str`, :class:`bytes` or :term:`path-like ` " +"object). When wrapping an existing file object, the wrapped file will not be " +"closed when the :class:`LZMAFile` is closed." msgstr "" msgid "" @@ -142,9 +142,10 @@ msgid "" msgstr "" msgid "" -":class:`LZMAFile` supports all the members specified by :class:`io." -"BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io." -"IOBase.truncate`. Iteration and the :keyword:`with` statement are supported." +":class:`LZMAFile` supports all the members specified " +"by :class:`io.BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` " +"and :meth:`~io.IOBase.truncate`. Iteration and the :keyword:`with` statement " +"are supported." msgstr "" msgid "The following method and attributes are also provided:" @@ -157,10 +158,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`LZMAFile`, it may change the position of the underlying file object (e.g. " -"if the :class:`LZMAFile` was constructed by passing a file object for " -"*filename*)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`LZMAFile`, it may change the position of the underlying file " +"object (e.g. if the :class:`LZMAFile` was constructed by passing a file " +"object for *filename*)." msgstr "" msgid "``'rb'`` for reading and ``'wb'`` for writing." @@ -187,59 +188,22 @@ msgid "" msgstr "" msgid "" -"For a more convenient way of compressing a single chunk of data, see :func:" -"`compress`." +"For a more convenient way of compressing a single chunk of data, " +"see :func:`compress`." msgstr "" msgid "" "The *format* argument specifies what container format should be used. " -"Possible values are:" -msgstr "" - -msgid ":const:`FORMAT_XZ`: The ``.xz`` container format." -msgstr "" - -msgid "This is the default format." -msgstr "" - -msgid ":const:`FORMAT_ALONE`: The legacy ``.lzma`` container format." -msgstr "" - -msgid "" -"This format is more limited than ``.xz`` -- it does not support integrity " -"checks or multiple filters." -msgstr "" - -msgid ":const:`FORMAT_RAW`: A raw data stream, not using any container format." -msgstr "" - -msgid "" -"This format specifier does not support integrity checks, and requires that " -"you always specify a custom filter chain (for both compression and " -"decompression). Additionally, data compressed in this manner cannot be " -"decompressed using :const:`FORMAT_AUTO` (see :class:`LZMADecompressor`)." +"Possible values are :const:`FORMAT_XZ` (the default), :const:`FORMAT_ALONE` " +"and :const:`FORMAT_RAW`." msgstr "" msgid "" "The *check* argument specifies the type of integrity check to include in the " "compressed data. This check is used when decompressing, to ensure that the " -"data has not been corrupted. Possible values are:" -msgstr "" - -msgid "" -":const:`CHECK_NONE`: No integrity check. This is the default (and the only " -"acceptable value) for :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." -msgstr "" - -msgid ":const:`CHECK_CRC32`: 32-bit Cyclic Redundancy Check." -msgstr "" - -msgid "" -":const:`CHECK_CRC64`: 64-bit Cyclic Redundancy Check. This is the default " -"for :const:`FORMAT_XZ`." -msgstr "" - -msgid ":const:`CHECK_SHA256`: 256-bit Secure Hash Algorithm." +"data has not been corrupted. Possible values " +"are :const:`CHECK_NONE`, :const:`CHECK_CRC32`, :const:`CHECK_CRC64` (the " +"default for :const:`FORMAT_XZ`) and :const:`CHECK_SHA256`." msgstr "" msgid "" @@ -254,18 +218,19 @@ msgstr "" msgid "" "The *preset* argument (if provided) should be an integer between ``0`` and " -"``9`` (inclusive), optionally OR-ed with the constant :const:" -"`PRESET_EXTREME`. If neither *preset* nor *filters* are given, the default " -"behavior is to use :const:`PRESET_DEFAULT` (preset level ``6``). Higher " -"presets produce smaller output, but make the compression process slower." +"``9`` (inclusive), optionally OR-ed with the " +"constant :const:`PRESET_EXTREME`. If neither *preset* nor *filters* are " +"given, the default behavior is to use :const:`PRESET_DEFAULT` (preset level " +"``6``). Higher presets produce smaller output, but make the compression " +"process slower." msgstr "" msgid "" "In addition to being more CPU-intensive, compression with higher presets " "also requires much more memory (and produces output that needs more memory " -"to decompress). With preset ``9`` for example, the overhead for an :class:" -"`LZMACompressor` object can be as high as 800 MiB. For this reason, it is " -"generally best to stick with the default preset." +"to decompress). With preset ``9`` for example, the overhead for " +"an :class:`LZMACompressor` object can be as high as 800 MiB. For this " +"reason, it is generally best to stick with the default preset." msgstr "" msgid "" @@ -276,9 +241,9 @@ msgstr "" msgid "" "Compress *data* (a :class:`bytes` object), returning a :class:`bytes` object " "containing compressed data for at least part of the input. Some of *data* " -"may be buffered internally, for use in later calls to :meth:`compress` and :" -"meth:`flush`. The returned data should be concatenated with the output of " -"any previous calls to :meth:`compress`." +"may be buffered internally, for use in later calls to :meth:`compress` " +"and :meth:`flush`. The returned data should be concatenated with the output " +"of any previous calls to :meth:`compress`." msgstr "" msgid "" @@ -302,8 +267,8 @@ msgstr "" msgid "" "The *format* argument specifies the container format that should be used. " "The default is :const:`FORMAT_AUTO`, which can decompress both ``.xz`` and " -"``.lzma`` files. Other possible values are :const:`FORMAT_XZ`, :const:" -"`FORMAT_ALONE`, and :const:`FORMAT_RAW`." +"``.lzma`` files. Other possible values " +"are :const:`FORMAT_XZ`, :const:`FORMAT_ALONE`, and :const:`FORMAT_RAW`." msgstr "" msgid "" @@ -315,9 +280,9 @@ msgstr "" msgid "" "The *filters* argument specifies the filter chain that was used to create " -"the stream being decompressed. This argument is required if *format* is :" -"const:`FORMAT_RAW`, but should not be used for other formats. See :ref:" -"`filter-chain-specs` for more information about filter chains." +"the stream being decompressed. This argument is required if *format* " +"is :const:`FORMAT_RAW`, but should not be used for other formats. " +"See :ref:`filter-chain-specs` for more information about filter chains." msgstr "" msgid "" @@ -349,18 +314,18 @@ msgid "" msgstr "" msgid "" -"Attempting to decompress data after the end of stream is reached raises an :" -"exc:`EOFError`. Any data found after the end of the stream is ignored and " -"saved in the :attr:`~.unused_data` attribute." +"Attempting to decompress data after the end of stream is reached raises " +"an :exc:`EOFError`. Any data found after the end of the stream is ignored " +"and saved in the :attr:`~.unused_data` attribute." msgstr "" msgid "Added the *max_length* parameter." msgstr "" msgid "" -"The ID of the integrity check used by the input stream. This may be :const:" -"`CHECK_UNKNOWN` until enough of the input has been decoded to determine what " -"integrity check it uses." +"The ID of the integrity check used by the input stream. This may " +"be :const:`CHECK_UNKNOWN` until enough of the input has been decoded to " +"determine what integrity check it uses." msgstr "" msgid "``True`` if the end-of-stream marker has been reached." @@ -410,9 +375,10 @@ msgid "" msgstr "" msgid "" -":const:`CHECK_NONE` and :const:`CHECK_CRC32` are always supported. :const:" -"`CHECK_CRC64` and :const:`CHECK_SHA256` may be unavailable if you are using " -"a version of :program:`liblzma` that was compiled with a limited feature set." +":const:`CHECK_NONE` and :const:`CHECK_CRC32` are always " +"supported. :const:`CHECK_CRC64` and :const:`CHECK_SHA256` may be unavailable " +"if you are using a version of :program:`liblzma` that was compiled with a " +"limited feature set." msgstr "" msgid "Specifying custom filter chains" @@ -432,8 +398,8 @@ msgid ":const:`FILTER_LZMA1` (for use with :const:`FORMAT_ALONE`)" msgstr "" msgid "" -":const:`FILTER_LZMA2` (for use with :const:`FORMAT_XZ` and :const:" -"`FORMAT_RAW`)" +":const:`FILTER_LZMA2` (for use with :const:`FORMAT_XZ` " +"and :const:`FORMAT_RAW`)" msgstr "" msgid "Delta filter:" @@ -445,23 +411,23 @@ msgstr ":const:`FILTER_DELTA`" msgid "Branch-Call-Jump (BCJ) filters:" msgstr "" -msgid ":const:`FILTER_X86`" -msgstr ":const:`FILTER_X86`" +msgid ":const:`!FILTER_X86`" +msgstr "" -msgid ":const:`FILTER_IA64`" -msgstr ":const:`FILTER_IA64`" +msgid ":const:`!FILTER_IA64`" +msgstr "" -msgid ":const:`FILTER_ARM`" -msgstr ":const:`FILTER_ARM`" +msgid ":const:`!FILTER_ARM`" +msgstr "" -msgid ":const:`FILTER_ARMTHUMB`" -msgstr ":const:`FILTER_ARMTHUMB`" +msgid ":const:`!FILTER_ARMTHUMB`" +msgstr "" -msgid ":const:`FILTER_POWERPC`" -msgstr ":const:`FILTER_POWERPC`" +msgid ":const:`!FILTER_POWERPC`" +msgstr "" -msgid ":const:`FILTER_SPARC`" -msgstr ":const:`FILTER_SPARC`" +msgid ":const:`!FILTER_SPARC`" +msgstr "" msgid "" "A filter chain can consist of up to 4 filters, and cannot be empty. The last " @@ -504,8 +470,9 @@ msgid "" msgstr "" msgid "" -"``mf``: What match finder to use -- :const:`MF_HC3`, :const:`MF_HC4`, :const:" -"`MF_BT2`, :const:`MF_BT3`, or :const:`MF_BT4`." +"``mf``: What match finder to use " +"-- :const:`MF_HC3`, :const:`MF_HC4`, :const:`MF_BT2`, :const:`MF_BT3`, " +"or :const:`MF_BT4`." msgstr "" msgid "" @@ -530,6 +497,99 @@ msgid "" "data. The default is 0." msgstr "" +msgid "Constants" +msgstr "Stały" + +msgid "" +"The following module-level constants are provided for use as the *format*, " +"*check*, *preset* and *filters* arguments of the classes and functions above." +msgstr "" + +msgid "Container formats:" +msgstr "" + +msgid "The ``.xz`` container format." +msgstr "" + +msgid "" +"The legacy ``.lzma`` container format. This format is more limited than " +"``.xz`` -- it does not support integrity checks or multiple filters." +msgstr "" + +msgid "" +"A raw data stream, not using any container format. This format specifier " +"does not support integrity checks, and requires that you always specify a " +"custom filter chain (for both compression and decompression). Additionally, " +"data compressed in this manner cannot be decompressed " +"using :const:`FORMAT_AUTO`." +msgstr "" + +msgid "" +"Used for decompression only. The container format is detected " +"automatically, so that both ``.xz`` and ``.lzma`` files can be decompressed." +msgstr "" + +msgid "Integrity checks:" +msgstr "" + +msgid "" +"No integrity check. This is the default (and the only acceptable value) " +"for :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." +msgstr "" + +msgid "A 32-bit Cyclic Redundancy Check." +msgstr "" + +msgid "" +"A 64-bit Cyclic Redundancy Check. This is the default " +"for :const:`FORMAT_XZ`." +msgstr "" + +msgid "A 256-bit Secure Hash Algorithm." +msgstr "" + +msgid "" +"The integrity check used by a stream could not yet be determined. This may " +"be the value of the :attr:`LZMADecompressor.check` attribute until enough of " +"the input has been decoded." +msgstr "" + +msgid "The largest supported integrity-check ID." +msgstr "" + +msgid "Compression presets:" +msgstr "" + +msgid "The default compression preset, equivalent to preset level ``6``." +msgstr "" + +msgid "" +"A flag that may be bitwise OR-ed with a preset level (``0`` to ``9``) to " +"select a slower but more thorough variant of that preset." +msgstr "" + +msgid "Filter IDs and options:" +msgstr "" + +msgid "" +"The LZMA1 and LZMA2 compression filters. :const:`FILTER_LZMA1` is for use " +"with :const:`FORMAT_ALONE`, while :const:`FILTER_LZMA2` is for use " +"with :const:`FORMAT_XZ` and :const:`FORMAT_RAW`." +msgstr "" + +msgid "The delta filter." +msgstr "" + +msgid "" +"Compression modes that may be used as the ``mode`` option of a filter " +"specifier (see :ref:`filter-chain-specs`)." +msgstr "" + +msgid "" +"Match finders that may be used as the ``mf`` option of a filter specifier " +"(see :ref:`filter-chain-specs`)." +msgstr "" + msgid "Examples" msgstr "Przykłady" diff --git a/library/mailbox.po b/library/mailbox.po index 6b9faf9ab3..4aa5c29eae 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,11 +31,19 @@ msgstr "**Kod źródłowy:** :source:`Lib/mailbox.py`" msgid "" "This module defines two classes, :class:`Mailbox` and :class:`Message`, for " -"accessing and manipulating on-disk mailboxes and the messages they contain. :" -"class:`!Mailbox` offers a dictionary-like mapping from keys to messages. :" -"class:`!Message` extends the :mod:`email.message` module's :class:`~email." -"message.Message` class with format-specific state and behavior. Supported " -"mailbox formats are Maildir, mbox, MH, Babyl, and MMDF." +"accessing and manipulating on-disk mailboxes and the messages they " +"contain. :class:`!Mailbox` offers a dictionary-like mapping from keys to " +"messages. :class:`!Message` extends the :mod:`email.message` " +"module's :class:`~email.message.Message` class with format-specific state " +"and behavior. Supported mailbox formats are Maildir, mbox, MH, Babyl, and " +"MMDF." +msgstr "" + +msgid "" +"The :mod:`!mailbox` module is designed for use in trusted environments, " +"where data from untrusted sources is never passed to the module's API calls " +"and only trusted users have access to the filesystems accessible to the " +"module." msgstr "" msgid "Module :mod:`email`" @@ -52,8 +60,9 @@ msgstr "" msgid "" "The :class:`!Mailbox` class defines an interface and is not intended to be " -"instantiated. Instead, format-specific subclasses should inherit from :" -"class:`!Mailbox` and your code should instantiate a particular subclass." +"instantiated. Instead, format-specific subclasses should inherit " +"from :class:`!Mailbox` and your code should instantiate a particular " +"subclass." msgstr "" msgid "" @@ -95,8 +104,8 @@ msgstr "" msgid "" "Be very cautious when modifying mailboxes that might be simultaneously " "changed by some other process. The safest mailbox format to use for such " -"tasks is :class:`Maildir`; try to avoid using single-file formats such as :" -"class:`mbox` for concurrent writing. If you're modifying a mailbox, you " +"tasks is :class:`Maildir`; try to avoid using single-file formats such " +"as :class:`mbox` for concurrent writing. If you're modifying a mailbox, you " "*must* lock it by calling the :meth:`lock` and :meth:`unlock` methods " "*before* reading any messages in the file or making any changes by adding or " "deleting a message. Failing to lock the mailbox runs the risk of losing " @@ -111,13 +120,13 @@ msgid "" msgstr "" msgid "" -"Parameter *message* may be a :class:`Message` instance, an :class:`email." -"message.Message` instance, a string, a byte string, or a file-like object " -"(which should be open in binary mode). If *message* is an instance of the " -"appropriate format-specific :class:`Message` subclass (e.g., if it's an :" -"class:`mboxMessage` instance and this is an :class:`mbox` instance), its " -"format-specific information is used. Otherwise, reasonable defaults for " -"format-specific information are used." +"Parameter *message* may be a :class:`Message` instance, " +"an :class:`email.message.Message` instance, a string, a byte string, or a " +"file-like object (which should be open in binary mode). If *message* is an " +"instance of the appropriate format-specific :class:`Message` subclass (e.g., " +"if it's an :class:`mboxMessage` instance and this is an :class:`mbox` " +"instance), its format-specific information is used. Otherwise, reasonable " +"defaults for format-specific information are used." msgstr "" msgid "Support for binary input was added." @@ -129,14 +138,14 @@ msgstr "" msgid "" "If no such message exists, a :exc:`KeyError` exception is raised if the " "method was called as :meth:`remove` or :meth:`__delitem__` but no exception " -"is raised if the method was called as :meth:`discard`. The behavior of :meth:" -"`discard` may be preferred if the underlying mailbox format supports " -"concurrent modification by other processes." +"is raised if the method was called as :meth:`discard`. The behavior " +"of :meth:`discard` may be preferred if the underlying mailbox format " +"supports concurrent modification by other processes." msgstr "" msgid "" -"Replace the message corresponding to *key* with *message*. Raise a :exc:" -"`KeyError` exception if no message already corresponds to *key*." +"Replace the message corresponding to *key* with *message*. Raise " +"a :exc:`KeyError` exception if no message already corresponds to *key*." msgstr "" msgid "" @@ -160,9 +169,9 @@ msgstr "" msgid "" "Return an :term:`iterator` over representations of all messages. The " -"messages are represented as instances of the appropriate format-specific :" -"class:`Message` subclass unless a custom message factory was specified when " -"the :class:`!Mailbox` instance was initialized." +"messages are represented as instances of the appropriate format-" +"specific :class:`Message` subclass unless a custom message factory was " +"specified when the :class:`!Mailbox` instance was initialized." msgstr "" msgid "" @@ -190,18 +199,18 @@ msgstr "" msgid "" "Return a representation of the message corresponding to *key*. If no such " -"message exists, *default* is returned if the method was called as :meth:" -"`get` and a :exc:`KeyError` exception is raised if the method was called as :" -"meth:`!__getitem__`. The message is represented as an instance of the " -"appropriate format-specific :class:`Message` subclass unless a custom " +"message exists, *default* is returned if the method was called " +"as :meth:`get` and a :exc:`KeyError` exception is raised if the method was " +"called as :meth:`!__getitem__`. The message is represented as an instance of " +"the appropriate format-specific :class:`Message` subclass unless a custom " "message factory was specified when the :class:`!Mailbox` instance was " "initialized." msgstr "" msgid "" "Return a representation of the message corresponding to *key* as an instance " -"of the appropriate format-specific :class:`Message` subclass, or raise a :" -"exc:`KeyError` exception if no such message exists." +"of the appropriate format-specific :class:`Message` subclass, or raise " +"a :exc:`KeyError` exception if no such message exists." msgstr "" msgid "" @@ -249,18 +258,18 @@ msgstr "" msgid "" "Return a representation of the message corresponding to *key* and delete the " "message. If no such message exists, return *default*. The message is " -"represented as an instance of the appropriate format-specific :class:" -"`Message` subclass unless a custom message factory was specified when the :" -"class:`!Mailbox` instance was initialized." +"represented as an instance of the appropriate format-" +"specific :class:`Message` subclass unless a custom message factory was " +"specified when the :class:`!Mailbox` instance was initialized." msgstr "" msgid "" "Return an arbitrary (*key*, *message*) pair, where *key* is a key and " "*message* is a message representation, and delete the corresponding message. " "If the mailbox is empty, raise a :exc:`KeyError` exception. The message is " -"represented as an instance of the appropriate format-specific :class:" -"`Message` subclass unless a custom message factory was specified when the :" -"class:`!Mailbox` instance was initialized." +"represented as an instance of the appropriate format-" +"specific :class:`Message` subclass unless a custom message factory was " +"specified when the :class:`!Mailbox` instance was initialized." msgstr "" msgid "" @@ -269,8 +278,8 @@ msgid "" "and *message*, the message corresponding to *key* is set to *message* as if " "by using :meth:`__setitem__`. As with :meth:`__setitem__`, each *key* must " "already correspond to a message in the mailbox or else a :exc:`KeyError` " -"exception will be raised, so in general it is incorrect for *arg* to be a :" -"class:`!Mailbox` instance." +"exception will be raised, so in general it is incorrect for *arg* to be " +"a :class:`!Mailbox` instance." msgstr "" msgid "Unlike with dictionaries, keyword arguments are not supported." @@ -330,19 +339,20 @@ msgid "" msgstr "" msgid "" -"Maildir mailboxes contain three subdirectories, namely: :file:`tmp`, :file:" -"`new`, and :file:`cur`. Messages are created momentarily in the :file:`tmp` " -"subdirectory and then moved to the :file:`new` subdirectory to finalize " -"delivery. A mail user agent may subsequently move the message to the :file:" -"`cur` subdirectory and store information about the state of the message in a " -"special \"info\" section appended to its file name." +"Maildir mailboxes contain three subdirectories, " +"namely: :file:`tmp`, :file:`new`, and :file:`cur`. Messages are created " +"momentarily in the :file:`tmp` subdirectory and then moved to " +"the :file:`new` subdirectory to finalize delivery. A mail user agent may " +"subsequently move the message to the :file:`cur` subdirectory and store " +"information about the state of the message in a special \"info\" section " +"appended to its file name." msgstr "" msgid "" "Folders of the style introduced by the Courier mail transfer agent are also " "supported. Any subdirectory of the main mailbox is considered a folder if " -"``'.'`` is the first character in its name. Folder names are represented by :" -"class:`!Maildir` without the leading ``'.'``. Each folder is itself a " +"``'.'`` is the first character in its name. Folder names are represented " +"by :class:`!Maildir` without the leading ``'.'``. Each folder is itself a " "Maildir mailbox but should not contain other folders. Instead, a logical " "nesting is indicated using ``'.'`` to delimit levels, e.g., " "\"Archived.2005.07\"." @@ -406,11 +416,12 @@ msgid "" msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.get_flags` method instead, because changes made by the " -"message's :meth:`~MaildirMessage.set_flags`, :meth:`~MaildirMessage." -"add_flag` and :meth:`~MaildirMessage.remove_flag` methods are not reflected " -"here until the mailbox's :meth:`__setitem__` method is called." +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.get_flags` method instead, because changes made " +"by the " +"message's :meth:`~MaildirMessage.set_flags`, :meth:`~MaildirMessage.add_flag` " +"and :meth:`~MaildirMessage.remove_flag` methods are not reflected here until " +"the mailbox's :meth:`__setitem__` method is called." msgstr "" msgid "" @@ -429,10 +440,10 @@ msgid "but faster, because it does not open the message file." msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.set_flags` method instead, because changes made with this " -"mailbox method will not be visible to the message object's method, :meth:" -"`~MaildirMessage.get_flags`." +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.set_flags` method instead, because changes made " +"with this mailbox method will not be visible to the message object's " +"method, :meth:`~MaildirMessage.get_flags`." msgstr "" msgid "" @@ -442,9 +453,9 @@ msgid "" msgstr "" msgid "" -"Considerations for using this method versus the message object's :meth:" -"`~MaildirMessage.add_flag` method are similar to those for :meth:" -"`set_flags`; see the discussion there." +"Considerations for using this method versus the message " +"object's :meth:`~MaildirMessage.add_flag` method are similar to those " +"for :meth:`set_flags`; see the discussion there." msgstr "" msgid "" @@ -454,9 +465,9 @@ msgid "" msgstr "" msgid "" -"Considerations for using this method versus the message object's :meth:" -"`~MaildirMessage.remove_flag` method are similar to those for :meth:" -"`set_flags`; see the discussion there." +"Considerations for using this method versus the message " +"object's :meth:`~MaildirMessage.remove_flag` method are similar to those " +"for :meth:`set_flags`; see the discussion there." msgstr "" msgid "" @@ -467,15 +478,15 @@ msgid "" msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.get_info` method instead, because changes made by the " -"message's :meth:`~MaildirMessage.set_info` method are not reflected here " +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.get_info` method instead, because changes made by " +"the message's :meth:`~MaildirMessage.set_info` method are not reflected here " "until the mailbox's :meth:`__setitem__` method is called." msgstr "" msgid "" "Set the info of the message corresponding to *key* to *info*. Calling " -"``some_mailbox.set_info(key, flags)`` is similar to ::" +"``some_mailbox.set_info(key, info)`` is similar to ::" msgstr "" msgid "" @@ -485,10 +496,10 @@ msgid "" msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.set_info` method instead, because changes made with this " -"mailbox method will not be visible to the message object's method, :meth:" -"`~MaildirMessage.get_info`." +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.set_info` method instead, because changes made " +"with this mailbox method will not be visible to the message object's " +"method, :meth:`~MaildirMessage.get_info`." msgstr "" msgid "" @@ -562,8 +573,8 @@ msgstr "" msgid "" "Several variations of the mbox format exist to address perceived " "shortcomings in the original. In the interest of compatibility, :class:`!" -"mbox` implements the original format, which is sometimes referred to as :dfn:" -"`mboxo`. This means that the :mailheader:`Content-Length` header, if " +"mbox` implements the original format, which is sometimes referred to " +"as :dfn:`mboxo`. This means that the :mailheader:`Content-Length` header, if " "present, is ignored and that any occurrences of \"From \" at the beginning " "of a line in a message body are transformed to \">From \" when storing the " "message, although occurrences of \">From \" are not transformed to \"From \" " @@ -582,14 +593,14 @@ msgid "" msgstr "" msgid "" -"Using the file after calling :meth:`~Mailbox.flush` or :meth:`~Mailbox." -"close` on the :class:`!mbox` instance may yield unpredictable results or " -"raise an exception." +"Using the file after calling :meth:`~Mailbox.flush` " +"or :meth:`~Mailbox.close` on the :class:`!mbox` instance may yield " +"unpredictable results or raise an exception." msgstr "" msgid "" -"Three locking mechanisms are used---dot locking and, if available, the :c:" -"func:`!flock` and :c:func:`!lockf` system calls." +"Three locking mechanisms are used---dot locking and, if available, " +"the :c:func:`!flock` and :c:func:`!lockf` system calls." msgstr "" msgid "" @@ -671,8 +682,8 @@ msgstr "" msgid "" "Re-define the sequences that exist in the mailbox based upon *sequences*, a " -"dictionary of names mapped to key lists, like returned by :meth:" -"`get_sequences`." +"dictionary of names mapped to key lists, like returned " +"by :meth:`get_sequences`." msgstr "" msgid "" @@ -696,11 +707,11 @@ msgid "" msgstr "" msgid "" -"Three locking mechanisms are used---dot locking and, if available, the :c:" -"func:`!flock` and :c:func:`!lockf` system calls. For MH mailboxes, locking " -"the mailbox means locking the :file:`.mh_sequences` file and, only for the " -"duration of any operations that affect them, locking individual message " -"files." +"Three locking mechanisms are used---dot locking and, if available, " +"the :c:func:`!flock` and :c:func:`!lockf` system calls. For MH mailboxes, " +"locking the mailbox means locking the :file:`.mh_sequences` file and, only " +"for the duration of any operations that affect them, locking individual " +"message files." msgstr "" msgid "" @@ -722,8 +733,8 @@ msgid "`nmh - Message Handling System `_" msgstr "" msgid "" -"Home page of :program:`nmh`, an updated version of the original :program:" -"`mh`." +"Home page of :program:`nmh`, an updated version of the " +"original :program:`mh`." msgstr "" msgid "" @@ -841,9 +852,9 @@ msgid "" msgstr "" msgid "" -"Using the file after calling :meth:`~Mailbox.flush` or :meth:`~Mailbox." -"close` on the :class:`!MMDF` instance may yield unpredictable results or " -"raise an exception." +"Using the file after calling :meth:`~Mailbox.flush` " +"or :meth:`~Mailbox.close` on the :class:`!MMDF` instance may yield " +"unpredictable results or raise an exception." msgstr "" msgid "" @@ -867,9 +878,9 @@ msgid ":class:`!Message` objects" msgstr "" msgid "" -"A subclass of the :mod:`email.message` module's :class:`~email.message." -"Message`. Subclasses of :class:`!mailbox.Message` add mailbox-format-" -"specific state and behavior." +"A subclass of the :mod:`email.message` " +"module's :class:`~email.message.Message`. Subclasses of :class:`!" +"mailbox.Message` add mailbox-format-specific state and behavior." msgstr "" msgid "" @@ -877,9 +888,9 @@ msgid "" "state. If *message* is an :class:`email.message.Message` instance, its " "contents are copied; furthermore, any format-specific information is " "converted insofar as possible if *message* is a :class:`!Message` instance. " -"If *message* is a string, a byte string, or a file, it should contain an :" -"rfc:`5322`\\ -compliant message, which is read and parsed. Files should be " -"open in binary mode, but text mode files are accepted for backward " +"If *message* is a string, a byte string, or a file, it should contain " +"an :rfc:`5322`\\ -compliant message, which is read and parsed. Files should " +"be open in binary mode, but text mode files are accepted for backward " "compatibility." msgstr "" @@ -913,16 +924,16 @@ msgid "" msgstr "" msgid "" -"Typically, a mail user agent application moves all of the messages in the :" -"file:`new` subdirectory to the :file:`cur` subdirectory after the first time " -"the user opens and closes the mailbox, recording that the messages are old " -"whether or not they've actually been read. Each message in :file:`cur` has " -"an \"info\" section added to its file name to store information about its " -"state. (Some mail readers may also add an \"info\" section to messages in :" -"file:`new`.) The \"info\" section may take one of two forms: it may contain " -"\"2,\" followed by a list of standardized flags (e.g., \"2,FR\") or it may " -"contain \"1,\" followed by so-called experimental information. Standard " -"flags for Maildir messages are as follows:" +"Typically, a mail user agent application moves all of the messages in " +"the :file:`new` subdirectory to the :file:`cur` subdirectory after the first " +"time the user opens and closes the mailbox, recording that the messages are " +"old whether or not they've actually been read. Each message in :file:`cur` " +"has an \"info\" section added to its file name to store information about " +"its state. (Some mail readers may also add an \"info\" section to messages " +"in :file:`new`.) The \"info\" section may take one of two forms: it may " +"contain \"2,\" followed by a list of standardized flags (e.g., \"2,FR\") or " +"it may contain \"1,\" followed by so-called experimental information. " +"Standard flags for Maildir messages are as follows:" msgstr "" msgid "Flag" @@ -1053,10 +1064,10 @@ msgid "Set \"info\" to *info*, which should be a string." msgstr "" msgid "" -"When a :class:`!MaildirMessage` instance is created based upon an :class:" -"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " -"and :mailheader:`X-Status` headers are omitted and the following conversions " -"take place:" +"When a :class:`!MaildirMessage` instance is created based upon " +"an :class:`mboxMessage` or :class:`MMDFMessage` instance, " +"the :mailheader:`Status` and :mailheader:`X-Status` headers are omitted and " +"the following conversions take place:" msgstr "" msgid "Resulting state" @@ -1090,8 +1101,8 @@ msgid "D flag" msgstr "" msgid "" -"When a :class:`!MaildirMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When a :class:`!MaildirMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`MHMessage` state" @@ -1113,8 +1124,8 @@ msgid "\"replied\" sequence" msgstr "" msgid "" -"When a :class:`!MaildirMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When a :class:`!MaildirMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`BabylMessage` state" @@ -1197,8 +1208,8 @@ msgid "" "leading \"From \" or trailing newline. For convenience, *time_* may be " "specified and will be formatted appropriately and appended to *from_*. If " "*time_* is specified, it should be a :class:`time.struct_time` instance, a " -"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to use :" -"func:`time.gmtime`)." +"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to " +"use :func:`time.gmtime`)." msgstr "" msgid "" @@ -1227,9 +1238,9 @@ msgid "" msgstr "" msgid "" -"When an :class:`!mboxMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, a \"From \" line is generated based upon the :" -"class:`MaildirMessage` instance's delivery date, and the following " +"When an :class:`!mboxMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, a \"From \" line is generated based upon " +"the :class:`MaildirMessage` instance's delivery date, and the following " "conversions take place:" msgstr "" @@ -1237,22 +1248,22 @@ msgid ":class:`MaildirMessage` state" msgstr "" msgid "" -"When an :class:`!mboxMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When an :class:`!mboxMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid "R flag and O flag" msgstr "" msgid "" -"When an :class:`!mboxMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When an :class:`!mboxMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When a :class:`!mboxMessage` instance is created based upon an :class:" -"`MMDFMessage` instance, the \"From \" line is copied and all flags directly " -"correspond:" +"When a :class:`!mboxMessage` instance is created based upon " +"an :class:`MMDFMessage` instance, the \"From \" line is copied and all flags " +"directly correspond:" msgstr "" msgid ":class:`MMDFMessage` state" @@ -1269,9 +1280,9 @@ msgstr "" msgid "" "MH messages do not support marks or flags in the traditional sense, but they " "do support sequences, which are logical groupings of arbitrary messages. " -"Some mail reading programs (although not the standard :program:`mh` and :" -"program:`nmh`) use sequences in much the same way flags are used with other " -"formats, as follows:" +"Some mail reading programs (although not the standard :program:`mh` " +"and :program:`nmh`) use sequences in much the same way flags are used with " +"other formats, as follows:" msgstr "" msgid "Sequence" @@ -1305,26 +1316,26 @@ msgid "Remove *sequence* from the list of sequences that include this message." msgstr "" msgid "" -"When an :class:`!MHMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, the following conversions take place:" +"When an :class:`!MHMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, the following conversions take place:" msgstr "" msgid "no S flag" msgstr "" msgid "" -"When an :class:`!MHMessage` instance is created based upon an :class:" -"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " -"and :mailheader:`X-Status` headers are omitted and the following conversions " -"take place:" +"When an :class:`!MHMessage` instance is created based upon " +"an :class:`mboxMessage` or :class:`MMDFMessage` instance, " +"the :mailheader:`Status` and :mailheader:`X-Status` headers are omitted and " +"the following conversions take place:" msgstr "" msgid "no R flag" msgstr "" msgid "" -"When an :class:`!MHMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When an :class:`!MHMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`!BabylMessage` objects" @@ -1401,8 +1412,8 @@ msgstr "" msgid "" "Set the message's visible headers to be the same as the headers in " -"*message*. Parameter *visible* should be a :class:`Message` instance, an :" -"class:`email.message.Message` instance, a string, or a file-like object " +"*message*. Parameter *visible* should be a :class:`Message` instance, " +"an :class:`email.message.Message` instance, a string, or a file-like object " "(which should be open in text mode)." msgstr "" @@ -1412,30 +1423,30 @@ msgid "" "updates the visible headers as follows: each visible header with a " "corresponding original header is set to the value of the original header, " "each visible header without a corresponding original header is removed, and " -"any of :mailheader:`Date`, :mailheader:`From`, :mailheader:`Reply-To`, :" -"mailheader:`To`, :mailheader:`CC`, and :mailheader:`Subject` that are " +"any of :mailheader:`Date`, :mailheader:`From`, :mailheader:`Reply-" +"To`, :mailheader:`To`, :mailheader:`CC`, and :mailheader:`Subject` that are " "present in the original headers but not the visible headers are added to the " "visible headers." msgstr "" msgid "" -"When a :class:`!BabylMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, the following conversions take place:" +"When a :class:`!BabylMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, the following conversions take place:" msgstr "" msgid "\"forwarded\" label" msgstr "" msgid "" -"When a :class:`!BabylMessage` instance is created based upon an :class:" -"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " -"and :mailheader:`X-Status` headers are omitted and the following conversions " -"take place:" +"When a :class:`!BabylMessage` instance is created based upon " +"an :class:`mboxMessage` or :class:`MMDFMessage` instance, " +"the :mailheader:`Status` and :mailheader:`X-Status` headers are omitted and " +"the following conversions take place:" msgstr "" msgid "" -"When a :class:`!BabylMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When a :class:`!BabylMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`!MMDFMessage` objects" @@ -1464,26 +1475,26 @@ msgid "" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, a \"From \" line is generated based upon the :" -"class:`MaildirMessage` instance's delivery date, and the following " +"When an :class:`!MMDFMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, a \"From \" line is generated based upon " +"the :class:`MaildirMessage` instance's delivery date, and the following " "conversions take place:" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When an :class:`!MMDFMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When an :class:`!MMDFMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon an :class:" -"`mboxMessage` instance, the \"From \" line is copied and all flags directly " -"correspond:" +"When an :class:`!MMDFMessage` instance is created based upon " +"an :class:`mboxMessage` instance, the \"From \" line is copied and all flags " +"directly correspond:" msgstr "" msgid ":class:`mboxMessage` state" diff --git a/library/marshal.po b/library/marshal.po index 523b37e9a8..8976263ab1 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,15 +39,16 @@ msgid "" "This is not a general \"persistence\" module. For general persistence and " "transfer of Python objects through RPC calls, see the modules :mod:`pickle` " "and :mod:`shelve`. The :mod:`!marshal` module exists mainly to support " -"reading and writing the \"pseudo-compiled\" code for Python modules of :file:" -"`.pyc` files. Therefore, the Python maintainers reserve the right to modify " -"the marshal format in backward incompatible ways should the need arise. The " -"format of code objects is not compatible between Python versions, even if " -"the version of the format is the same. De-serializing a code object in the " -"incorrect Python version has undefined behavior. If you're serializing and " -"de-serializing Python objects, use the :mod:`pickle` module instead -- the " -"performance is comparable, version independence is guaranteed, and pickle " -"supports a substantially wider range of objects than marshal." +"reading and writing the \"pseudo-compiled\" code for Python modules " +"of :file:`.pyc` files. Therefore, the Python maintainers reserve the right " +"to modify the marshal format in backward incompatible ways should the need " +"arise. The format of code objects is not compatible between Python versions, " +"even if the version of the format is the same. De-serializing a code object " +"in the incorrect Python version has undefined behavior. If you're " +"serializing and de-serializing Python objects, use the :mod:`pickle` module " +"instead -- the performance is comparable, version independence is " +"guaranteed, and pickle supports a substantially wider range of objects than " +"marshal." msgstr "" msgid "" @@ -88,8 +89,8 @@ msgid "" msgstr "" msgid "" -":class:`code` objects, if *allow_code* is true. See note above about version " -"dependence." +":class:`code ` objects, if *allow_code* is true. See note " +"above about version dependence." msgstr "" msgid "" @@ -114,10 +115,10 @@ msgid "" msgstr "" msgid "" -"If the value has (or contains an object that has) an unsupported type, a :" -"exc:`ValueError` exception is raised --- but garbage data will also be " -"written to the file. The object will not be properly read back by :func:" -"`load`. :ref:`Code objects ` are only supported if " +"If the value has (or contains an object that has) an unsupported type, " +"a :exc:`ValueError` exception is raised --- but garbage data will also be " +"written to the file. The object will not be properly read back " +"by :func:`load`. :ref:`Code objects ` are only supported if " "*allow_code* is true." msgstr "" @@ -137,9 +138,9 @@ msgstr "" msgid "" "Read one value from the open file and return it. If no valid value is read " "(e.g. because the data has a different Python version's incompatible marshal " -"format), raise :exc:`EOFError`, :exc:`ValueError` or :exc:`TypeError`. :ref:" -"`Code objects ` are only supported if *allow_code* is true. " -"The file must be a readable :term:`binary file`." +"format), raise :exc:`EOFError`, :exc:`ValueError` " +"or :exc:`TypeError`. :ref:`Code objects ` are only supported " +"if *allow_code* is true. The file must be a readable :term:`binary file`." msgstr "" msgid "" @@ -148,8 +149,9 @@ msgid "" msgstr "" msgid "" -"If an object containing an unsupported type was marshalled with :func:" -"`dump`, :func:`load` will substitute ``None`` for the unmarshallable type." +"If an object containing an unsupported type was marshalled " +"with :func:`dump`, :func:`load` will substitute ``None`` for the " +"unmarshallable type." msgstr "" msgid "" @@ -172,9 +174,9 @@ msgstr "" msgid "" "Convert the :term:`bytes-like object` to a value. If no valid value is " -"found, raise :exc:`EOFError`, :exc:`ValueError` or :exc:`TypeError`. :ref:" -"`Code objects ` are only supported if *allow_code* is true. " -"Extra bytes in the input are ignored." +"found, raise :exc:`EOFError`, :exc:`ValueError` " +"or :exc:`TypeError`. :ref:`Code objects ` are only supported " +"if *allow_code* is true. Extra bytes in the input are ignored." msgstr "" msgid "" diff --git a/library/math.po b/library/math.po index f3f64a72a8..f07f051e97 100644 --- a/library/math.po +++ b/library/math.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -422,8 +422,8 @@ msgid ":func:`lgamma(x) `" msgstr ":func:`lgamma(x) `" msgid "" -"Natural logarithm of the absolute value of the `Gamma function `_ at *x*" +"Natural logarithm of the absolute value of the `Gamma function `_ at *x*" msgstr "" msgid "**Constants**" @@ -478,8 +478,8 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`TypeError` if either of the arguments are not integers. Raises :" -"exc:`ValueError` if either of the arguments are negative." +"Raises :exc:`TypeError` if either of the arguments are not integers. " +"Raises :exc:`ValueError` if either of the arguments are negative." msgstr "" msgid "Return factorial of the nonnegative integer *n*." @@ -542,8 +542,8 @@ msgstr "" msgid "" "Return the ceiling of *x*, the smallest integer greater than or equal to " -"*x*. If *x* is not a float, delegates to :meth:`x.__ceil__ `, which should return an :class:`~numbers.Integral` value." +"*x*. If *x* is not a float, delegates to :meth:`x.__ceil__ " +"`, which should return an :class:`~numbers.Integral` value." msgstr "" msgid "Return the absolute value of *x*." @@ -622,8 +622,8 @@ msgid "" "Return *x* with the fractional part removed, leaving the integer part. This " "rounds toward 0: ``trunc()`` is equivalent to :func:`floor` for positive " "*x*, and equivalent to :func:`ceil` for negative *x*. If *x* is not a float, " -"delegates to :meth:`x.__trunc__ `, which should return an :" -"class:`~numbers.Integral` value." +"delegates to :meth:`x.__trunc__ `, which should return " +"an :class:`~numbers.Integral` value." msgstr "" msgid "" @@ -644,10 +644,11 @@ msgid "" msgstr "" msgid "" -"Return the mantissa and exponent of *x* as the pair ``(m, e)``. *m* is a " -"float and *e* is an integer such that ``x == m * 2**e`` exactly. If *x* is " -"zero, returns ``(0.0, 0)``, otherwise ``0.5 <= abs(m) < 1``. This is used " -"to \"pick apart\" the internal representation of a float in a portable way." +"Return the mantissa and exponent of *x* as the pair ``(m, e)``. If *x* is a " +"finite nonzero number, then *m* is a float with ``0.5 <= abs(m) < 1.0`` and " +"an integer *e* is such that ``x == m * 2**e`` exactly. Else, return ``(x, " +"0)``. This is used to \"pick apart\" the internal representation of a float " +"in a portable way." msgstr "" msgid "" @@ -712,8 +713,8 @@ msgid "" msgstr "" msgid "" -"Return ``x * (2**i)``. This is essentially the inverse of function :func:" -"`frexp`." +"Return ``x * (2**i)``. This is essentially the inverse of " +"function :func:`frexp`." msgstr "" msgid "Return the floating-point value *steps* steps after *x* towards *y*." @@ -757,8 +758,8 @@ msgstr "" msgid "" "If *x* is equal to zero, return the smallest positive *denormalized* " -"representable float (smaller than the minimum positive *normalized* float, :" -"data:`sys.float_info.min `)." +"representable float (smaller than the minimum positive *normalized* " +"float, :data:`sys.float_info.min `)." msgstr "" msgid "" @@ -777,8 +778,8 @@ msgid "ULP stands for \"Unit in the Last Place\"." msgstr "" msgid "" -"See also :func:`math.nextafter` and :data:`sys.float_info.epsilon `." +"See also :func:`math.nextafter` and :data:`sys.float_info.epsilon " +"`." msgstr "" msgid "Power, exponential and logarithmic functions" @@ -885,9 +886,9 @@ msgstr "" msgid "" "For further discussion and two alternative approaches, see the `ASPN " -"cookbook recipes for accurate floating-point summation `_\\." +"cookbook recipes for accurate floating-point summation `_\\." msgstr "" msgid "" @@ -970,8 +971,8 @@ msgid "" "``pi``. The vector in the plane from the origin to point ``(x, y)`` makes " "this angle with the positive X axis. The point of :func:`atan2` is that the " "signs of both inputs are known to it, so it can compute the correct quadrant " -"for the angle. For example, ``atan(1)`` and ``atan2(1, 1)`` are both " -"``pi/4``, but ``atan2(-1, -1)`` is ``-3*pi/4``." +"for the angle. For example, ``atan(1)`` and ``atan2(1, 1)`` are both ``pi/" +"4``, but ``atan2(-1, -1)`` is ``-3*pi/4``." msgstr "" msgid "Return the cosine of *x* radians." @@ -1020,8 +1021,8 @@ msgstr "" msgid "" "The :func:`erf` function can be used to compute traditional statistical " -"functions such as the `cumulative standard normal distribution `_::" +"functions such as the `cumulative standard normal distribution `_::" msgstr "" msgid "" @@ -1066,8 +1067,8 @@ msgid "" msgstr "" msgid "" -"A floating-point positive infinity. (For negative infinity, use ``-math." -"inf``.) Equivalent to the output of ``float('inf')``." +"A floating-point positive infinity. (For negative infinity, use ``-" +"math.inf``.) Equivalent to the output of ``float('inf')``." msgstr "" msgid "" @@ -1085,15 +1086,15 @@ msgstr "" msgid "" "The :mod:`!math` module consists mostly of thin wrappers around the platform " "C math library functions. Behavior in exceptional cases follows Annex F of " -"the C99 standard where appropriate. The current implementation will raise :" -"exc:`ValueError` for invalid operations like ``sqrt(-1.0)`` or ``log(0.0)`` " -"(where C99 Annex F recommends signaling invalid operation or divide-by-" -"zero), and :exc:`OverflowError` for results that overflow (for example, " -"``exp(1000.0)``). A NaN will not be returned from any of the functions " -"above unless one or more of the input arguments was a NaN; in that case, " -"most functions will return a NaN, but (again following C99 Annex F) there " -"are some exceptions to this rule, for example ``pow(float('nan'), 0.0)`` or " -"``hypot(float('nan'), float('inf'))``." +"the C99 standard where appropriate. The current implementation will " +"raise :exc:`ValueError` for invalid operations like ``sqrt(-1.0)`` or " +"``log(0.0)`` (where C99 Annex F recommends signaling invalid operation or " +"divide-by-zero), and :exc:`OverflowError` for results that overflow (for " +"example, ``exp(1000.0)``). A NaN will not be returned from any of the " +"functions above unless one or more of the input arguments was a NaN; in that " +"case, most functions will return a NaN, but (again following C99 Annex F) " +"there are some exceptions to this rule, for example ``pow(float('nan'), " +"0.0)`` or ``hypot(float('nan'), float('inf'))``." msgstr "" msgid "" diff --git a/library/mimetypes.po b/library/mimetypes.po index 987f08bc20..d64131fe93 100644 --- a/library/mimetypes.po +++ b/library/mimetypes.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -62,8 +62,8 @@ msgstr "" msgid "" "*encoding* is ``None`` for no encoding or the name of the program used to " "encode (e.g. :program:`compress` or :program:`gzip`). The encoding is " -"suitable for use as a :mailheader:`Content-Encoding` header, **not** as a :" -"mailheader:`Content-Transfer-Encoding` header. The mappings are table " +"suitable for use as a :mailheader:`Content-Encoding` header, **not** as " +"a :mailheader:`Content-Transfer-Encoding` header. The mappings are table " "driven. Encoding suffixes are case sensitive; type suffixes are first tried " "case sensitively, then case insensitively." msgstr "" @@ -84,14 +84,13 @@ msgid "Added support for *url* being a :term:`path-like object`." msgstr "" msgid "" -"Passing a file path instead of URL is :term:`soft deprecated`. Use :func:" -"`guess_file_type` for this." +"Passing a file path instead of URL. Use :func:`guess_file_type` for this." msgstr "" msgid "" -"Guess the type of a file based on its path, given by *path*. Similar to the :" -"func:`guess_type` function, but accepts a path instead of URL. Path can be a " -"string, a bytes object or a :term:`path-like object`." +"Guess the type of a file based on its path, given by *path*. Similar to " +"the :func:`guess_type` function, but accepts a path instead of URL. Path can " +"be a string, a bytes object or a :term:`path-like object`." msgstr "" msgid "" @@ -103,16 +102,16 @@ msgid "" msgstr "" msgid "" -"The optional *strict* argument has the same meaning as with the :func:" -"`guess_type` function." +"The optional *strict* argument has the same meaning as with " +"the :func:`guess_type` function." msgstr "" msgid "" "Guess the extension for a file based on its MIME type, given by *type*. The " "return value is a string giving a filename extension, including the leading " "dot (``'.'``). The extension is not guaranteed to have been associated with " -"any particular data stream, but would be mapped to the MIME type *type* by :" -"func:`guess_type` and :func:`guess_file_type`. If no extension can be " +"any particular data stream, but would be mapped to the MIME type *type* " +"by :func:`guess_type` and :func:`guess_file_type`. If no extension can be " "guessed for *type*, ``None`` is returned." msgstr "" @@ -146,10 +145,11 @@ msgid "Previously, Windows registry settings were ignored." msgstr "" msgid "" -"Load the type map given in the file *filename*, if it exists. The type map " -"is returned as a dictionary mapping filename extensions, including the " -"leading dot (``'.'``), to strings of the form ``'type/subtype'``. If the " -"file *filename* does not exist or cannot be read, ``None`` is returned." +"Load the type map given in the file named by *file*, if it exists. *file* " +"must be a string specifying the name of the file to read. The type map is " +"returned as a dictionary mapping file extensions, including the leading dot " +"(``'.'``), to strings of the form ``'type/subtype'``. If the file does not " +"exist or cannot be read, ``None`` is returned." msgstr "" msgid "" @@ -178,8 +178,9 @@ msgstr "" msgid "" "Dictionary mapping suffixes to suffixes. This is used to allow recognition " "of encoded files for which the encoding and the type are indicated by the " -"same extension. For example, the :file:`.tgz` extension is mapped to :file:" -"`.tar.gz` to allow the encoding and type to be recognized separately." +"same extension. For example, the :file:`.tgz` extension is mapped " +"to :file:`.tar.gz` to allow the encoding and type to be recognized " +"separately." msgstr "" msgid "Dictionary mapping filename extensions to encoding types." @@ -220,11 +221,12 @@ msgstr "" msgid "" "This class represents a MIME-types database. By default, it provides access " -"to the same database as the rest of this module. The initial database is a " -"copy of that provided by the module, and may be extended by loading " -"additional :file:`mime.types`\\ -style files into the database using the :" -"meth:`read` or :meth:`readfp` methods. The mapping dictionaries may also be " -"cleared before loading additional data if the default data is not desired." +"to the same database as the rest of this module. The initial database is " +"created from Python's built-in MIME type tables. It may be extended by " +"loading additional :file:`mime.types`\\ -style files into the database using " +"the :meth:`read` or :meth:`readfp` methods. The mapping dictionaries may " +"also be cleared before loading additional data if the default data is not " +"desired." msgstr "" msgid "" @@ -235,28 +237,30 @@ msgstr "" msgid "" "Dictionary mapping suffixes to suffixes. This is used to allow recognition " "of encoded files for which the encoding and the type are indicated by the " -"same extension. For example, the :file:`.tgz` extension is mapped to :file:" -"`.tar.gz` to allow the encoding and type to be recognized separately. This " -"is initially a copy of the global :data:`suffix_map` defined in the module." +"same extension. For example, the :file:`.tgz` extension is mapped " +"to :file:`.tar.gz` to allow the encoding and type to be recognized " +"separately. This is initialized with some predefined values." msgstr "" msgid "" -"Dictionary mapping filename extensions to encoding types. This is initially " -"a copy of the global :data:`encodings_map` defined in the module." +"Dictionary mapping filename extensions to encoding types. This is " +"initialized with some predefined values." msgstr "" msgid "" "Tuple containing two dictionaries, mapping filename extensions to MIME " "types: the first dictionary is for the non-standards types and the second " -"one is for the standard types. They are initialized by :data:`common_types` " -"and :data:`types_map`." +"one is for the standard types. They are initialized with some predefined " +"values and MIME type information loaded from files specified by the " +"*filenames* argument." msgstr "" msgid "" "Tuple containing two dictionaries, mapping MIME types to a list of filename " "extensions: the first dictionary is for the non-standards types and the " -"second one is for the standard types. They are initialized by :data:" -"`common_types` and :data:`types_map`." +"second one is for the standard types. They are initialized with some " +"predefined values and MIME type information loaded from files specified by " +"the *filenames* argument." msgstr "" msgid "" @@ -280,8 +284,8 @@ msgid "" msgstr "" msgid "" -"Load MIME information from a file named *filename*. This uses :meth:" -"`readfp` to parse the file." +"Load MIME information from a file named *filename*. This " +"uses :meth:`readfp` to parse the file." msgstr "" msgid "" @@ -347,7 +351,7 @@ msgstr "" msgid "" "For each ``type`` entry, the script writes a line into the standard output " "stream. If an unknown type occurs, it writes an error message into the " -"standard error stream and exits with the return code ``1``." +"standard output stream and exits with the return code ``1``." msgstr "" msgid "Command-line example" @@ -373,7 +377,7 @@ msgid "" "\n" "$ # get a MIME type for a rare file extension\n" "$ python -m mimetypes filename.pict\n" -"error: unknown extension of filename.pict\n" +"error: media type unknown for filename.pict\n" "\n" "$ # now look in the extended database built into Python\n" "$ python -m mimetypes --lenient filename.pict\n" @@ -395,7 +399,8 @@ msgid "" "$ python -m mimetypes filename.sh filename.nc filename.xxx filename.txt\n" "type: application/x-sh encoding: None\n" "type: application/x-netcdf encoding: None\n" -"error: unknown extension of filename.xxx\n" +"error: media type unknown for filename.xxx\n" +"type: text/plain encoding: None\n" "\n" "$ # try to feed an unknown MIME type\n" "$ python -m mimetypes --extension audio/aac audio/opus audio/future audio/x-" diff --git a/library/mmap.po b/library/mmap.po index 62d1dc42a0..037d1629a9 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,14 +35,14 @@ msgid "" msgstr "" msgid "" -"Memory-mapped file objects behave like both :class:`bytearray` and like :" -"term:`file objects `. You can use mmap objects in most places " -"where :class:`bytearray` are expected; for example, you can use the :mod:" -"`re` module to search through a memory-mapped file. You can also change a " -"single byte by doing ``obj[index] = 97``, or change a subsequence by " -"assigning to a slice: ``obj[i1:i2] = b'...'``. You can also read and write " -"data starting at the current file position, and :meth:`seek` through the " -"file to different positions." +"Memory-mapped file objects behave like both :class:`bytearray` and " +"like :term:`file objects `. You can use mmap objects in most " +"places where :class:`bytearray` are expected; for example, you can use " +"the :mod:`re` module to search through a memory-mapped file. You can also " +"change a single byte by doing ``obj[index] = 97``, or change a subsequence " +"by assigning to a slice: ``obj[i1:i2] = b'...'``. You can also read and " +"write data starting at the current file position, " +"and :meth:`~mmap.mmap.seek` through the file to different positions." msgstr "" msgid "" @@ -71,10 +71,10 @@ msgid "" "Unix and Windows. If *access* is not specified, Windows mmap returns a " "write-through mapping. The initial memory values for all three access types " "are taken from the specified file. Assignment to an :const:`ACCESS_READ` " -"memory map raises a :exc:`TypeError` exception. Assignment to an :const:" -"`ACCESS_WRITE` memory map affects both memory and the underlying file. " -"Assignment to an :const:`ACCESS_COPY` memory map affects memory but does not " -"update the underlying file." +"memory map raises a :exc:`TypeError` exception. Assignment to " +"an :const:`ACCESS_WRITE` memory map affects both memory and the underlying " +"file. Assignment to an :const:`ACCESS_COPY` memory map affects memory but " +"does not update the underlying file." msgstr "" msgid "Added :const:`ACCESS_DEFAULT` constant." @@ -107,8 +107,8 @@ msgstr "" msgid "" "*offset* may be specified as a non-negative integer offset. mmap references " "will be relative to the offset from the beginning of the file. *offset* " -"defaults to 0. *offset* must be a multiple of the :const:" -"`ALLOCATIONGRANULARITY`." +"defaults to 0. *offset* must be a multiple of " +"the :const:`ALLOCATIONGRANULARITY`." msgstr "" msgid "" @@ -119,8 +119,8 @@ msgstr "" msgid "" "**(Unix version)** Maps *length* bytes from the file specified by the file " "descriptor *fileno*, and returns a mmap object. If *length* is ``0``, the " -"maximum length of the map will be the current size of the file when :class:" -"`~mmap.mmap` is called." +"maximum length of the map will be the current size of the file " +"when :class:`~mmap.mmap` is called." msgstr "" msgid "" @@ -136,8 +136,8 @@ msgstr "" msgid "" "*prot*, if specified, gives the desired memory protection; the two most " "useful values are :const:`PROT_READ` and :const:`PROT_WRITE`, to specify " -"that the pages may be read or written. *prot* defaults to :const:`PROT_READ " -"\\| PROT_WRITE`." +"that the pages may be read or written. *prot* defaults " +"to :const:`PROT_READ` \\| :const:`PROT_WRITE`." msgstr "" msgid "" @@ -157,9 +157,9 @@ msgstr "" msgid "" "If *trackfd* is ``False``, the file descriptor specified by *fileno* will " "not be duplicated, and the resulting :class:`!mmap` object will not be " -"associated with the map's underlying file. This means that the :meth:`~mmap." -"mmap.size` and :meth:`~mmap.mmap.resize` methods will fail. This mode is " -"useful to limit the number of open file descriptors." +"associated with the map's underlying file. This means that " +"the :meth:`~mmap.mmap.size` and :meth:`~mmap.mmap.resize` methods will fail. " +"This mode is useful to limit the number of open file descriptors." msgstr "" msgid "" @@ -199,8 +199,8 @@ msgid "" msgstr "" msgid "" -":class:`~mmap.mmap` can also be used as a context manager in a :keyword:" -"`with` statement::" +":class:`~mmap.mmap` can also be used as a context manager in " +"a :keyword:`with` statement::" msgstr "" msgid "" @@ -260,8 +260,8 @@ msgid "" "use of this call there is no guarantee that changes are written back before " "the object is destroyed. If *offset* and *size* are specified, only changes " "to the given range of bytes will be flushed to disk; otherwise, the whole " -"extent of the mapping is flushed. *offset* must be a multiple of the :const:" -"`PAGESIZE` or :const:`ALLOCATIONGRANULARITY`." +"extent of the mapping is flushed. *offset* must be a multiple of " +"the :const:`PAGESIZE` or :const:`ALLOCATIONGRANULARITY`." msgstr "" msgid "" @@ -277,10 +277,11 @@ msgstr "" msgid "" "Send advice *option* to the kernel about the memory region beginning at " -"*start* and extending *length* bytes. *option* must be one of the :ref:" -"`MADV_* constants ` available on the system. If *start* " -"and *length* are omitted, the entire mapping is spanned. On some systems " -"(including Linux), *start* must be a multiple of the :const:`PAGESIZE`." +"*start* and extending *length* bytes. *option* must be one of " +"the :ref:`MADV_* constants ` available on the system. If " +"*start* and *length* are omitted, the entire mapping is spanned. On some " +"systems (including Linux), *start* must be a multiple of " +"the :const:`PAGESIZE`." msgstr "" msgid "Availability: Systems with the ``madvise()`` system call." @@ -317,9 +318,9 @@ msgid "Resizes the map and the underlying file, if any." msgstr "" msgid "" -"Resizing a map created with *access* of :const:`ACCESS_READ` or :const:" -"`ACCESS_COPY`, will raise a :exc:`TypeError` exception. Resizing a map " -"created with *trackfd* set to ``False``, will raise a :exc:`ValueError` " +"Resizing a map created with *access* of :const:`ACCESS_READ` " +"or :const:`ACCESS_COPY`, will raise a :exc:`TypeError` exception. Resizing a " +"map created with *trackfd* set to ``False``, will raise a :exc:`ValueError` " "exception." msgstr "" @@ -345,8 +346,8 @@ msgstr "" msgid "" "Set the file's current position. *whence* argument is optional and defaults " "to ``os.SEEK_SET`` or ``0`` (absolute file positioning); other values are " -"``os.SEEK_CUR`` or ``1`` (seek relative to the current position) and ``os." -"SEEK_END`` or ``2`` (seek relative to the file's end)." +"``os.SEEK_CUR`` or ``1`` (seek relative to the current position) and " +"``os.SEEK_END`` or ``2`` (seek relative to the file's end)." msgstr "" msgid "Return the new absolute position instead of ``None``." @@ -384,7 +385,40 @@ msgid "" "exception." msgstr "" -msgid "MADV_* Constants" +msgid "ACCESS_* constants" +msgstr "" + +msgid "" +"These constants specify the access mode for a memory " +"mapping. :const:`ACCESS_READ` provides read-only " +"access, :const:`ACCESS_WRITE` provides write-through access, " +"and :const:`ACCESS_COPY` provides copy-on-write " +"access. :const:`ACCESS_DEFAULT` defers to the *prot* argument " +"of :class:`~mmap.mmap`." +msgstr "" + +msgid "Page size constants" +msgstr "" + +msgid "" +":const:`PAGESIZE` is the system memory page size in " +"bytes. :const:`ALLOCATIONGRANULARITY` is the minimum alignment in bytes " +"required for the *offset* argument of :class:`~mmap.mmap`. On " +"Unix, :const:`ALLOCATIONGRANULARITY` is equal to :const:`PAGESIZE`." +msgstr "" + +msgid "PROT_* constants" +msgstr "" + +msgid "" +"Memory protection flags accepted by the *prot* argument " +"of :class:`~mmap.mmap`. :const:`PROT_READ` allows pages to be " +"read, :const:`PROT_WRITE` allows pages to be written, and :const:`PROT_EXEC` " +"allows pages to be executed. Values can be combined using the bitwise OR " +"operator. Not every option is present on every system." +msgstr "" + +msgid "MADV_* constants" msgstr "" msgid "" @@ -395,14 +429,14 @@ msgstr "" msgid "Availability: Systems with the madvise() system call." msgstr "" -msgid "MAP_* Constants" +msgid "MAP_* constants" msgstr "" msgid "" -"These are the various flags that can be passed to :meth:`mmap.mmap`. :data:" -"`MAP_ALIGNED_SUPER` is only available at FreeBSD and :data:`MAP_CONCEAL` is " -"only available at OpenBSD. Note that some options might not be present on " -"some systems." +"These are the various flags that can be passed " +"to :meth:`mmap.mmap`. :data:`MAP_ALIGNED_SUPER` is only available at " +"FreeBSD and :data:`MAP_CONCEAL` is only available at OpenBSD. Note that " +"some options might not be present on some systems." msgstr "" msgid "Added :data:`MAP_POPULATE` constant." @@ -415,8 +449,6 @@ msgid "Added :data:`MAP_ALIGNED_SUPER` and :data:`MAP_CONCEAL` constants." msgstr "" msgid "" -"Added :data:`MAP_32BIT`, :data:`MAP_HASSEMAPHORE`, :data:`MAP_JIT`, :data:" -"`MAP_NOCACHE`, :data:`MAP_NOEXTEND`, :data:`MAP_NORESERVE`, :data:" -"`MAP_RESILIENT_CODESIGN`, :data:`MAP_RESILIENT_MEDIA`, :data:`MAP_TPRO`, :" -"data:`MAP_TRANSLATED_ALLOW_EXECUTE`, and :data:`MAP_UNIX03` constants." +"Added :data:`MAP_32BIT`, :data:`MAP_HASSEMAPHORE`, :data:`MAP_JIT`, :data:`MAP_NOCACHE`, :data:`MAP_NOEXTEND`, :data:`MAP_NORESERVE`, :data:`MAP_RESILIENT_CODESIGN`, :data:`MAP_RESILIENT_MEDIA`, :data:`MAP_TPRO`, :data:`MAP_TRANSLATED_ALLOW_EXECUTE`, " +"and :data:`MAP_UNIX03` constants." msgstr "" diff --git a/library/msvcrt.po b/library/msvcrt.po index 60986127d4..0777d543a8 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,7 +30,8 @@ msgid "" "These functions provide access to some useful capabilities on Windows " "platforms. Some higher-level modules use these functions to build the " "Windows implementations of their services. For example, the :mod:`getpass` " -"module uses this in the implementation of the :func:`getpass` function." +"module uses this in the implementation of the :func:`~getpass.getpass` " +"function." msgstr "" msgid "" @@ -87,16 +88,16 @@ msgstr "" msgid "" "Set the line-end translation mode for the file descriptor *fd*. To set it to " -"text mode, *flags* should be :const:`os.O_TEXT`; for binary, it should be :" -"const:`os.O_BINARY`." +"text mode, *flags* should be :const:`os.O_TEXT`; for binary, it should " +"be :const:`os.O_BINARY`." msgstr "" msgid "" "Create a C runtime file descriptor from the file handle *handle*. The " -"*flags* parameter should be a bitwise OR of :const:`os.O_APPEND`, :const:`os." -"O_RDONLY`, :const:`os.O_TEXT` and :const:`os.O_NOINHERIT`. The returned file " -"descriptor may be used as a parameter to :func:`os.fdopen` to create a file " -"object." +"*flags* parameter should be a bitwise OR " +"of :const:`os.O_APPEND`, :const:`os.O_RDONLY`, :const:`os.O_TEXT` " +"and :const:`os.O_NOINHERIT`. The returned file descriptor may be used as a " +"parameter to :func:`os.fdopen` to create a file object." msgstr "" msgid "" @@ -201,8 +202,8 @@ msgid "" "Specifies the destination or destinations for a specific report type " "generated by :c:func:`!_CrtDbgReport` in the MS VC++ runtime. *type* must be " "one of the :const:`!CRT_\\*` constants listed below. *mode* must be one of " -"the :const:`!CRTDBG_\\*` constants listed below. Only available in :ref:" -"`debug build of Python `." +"the :const:`!CRTDBG_\\*` constants listed below. Only available " +"in :ref:`debug build of Python `." msgstr "" msgid "" diff --git a/library/multiprocessing.po b/library/multiprocessing.po index c04b6c227a..122e839035 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -51,14 +52,14 @@ msgid "" msgstr "" msgid "" -"The :mod:`!multiprocessing` module also introduces the :class:" -"`~multiprocessing.pool.Pool` object which offers a convenient means of " -"parallelizing the execution of a function across multiple input values, " -"distributing the input data across processes (data parallelism). The " -"following example demonstrates the common practice of defining such " +"The :mod:`!multiprocessing` module also introduces " +"the :class:`~multiprocessing.pool.Pool` object which offers a convenient " +"means of parallelizing the execution of a function across multiple input " +"values, distributing the input data across processes (data parallelism). " +"The following example demonstrates the common practice of defining such " "functions in a module so that child processes can successfully import that " -"module. This basic example of data parallelism using :class:" -"`~multiprocessing.pool.Pool`, ::" +"module. This basic example of data parallelism " +"using :class:`~multiprocessing.pool.Pool`, ::" msgstr "" msgid "" @@ -88,20 +89,20 @@ msgstr "" msgid "" ":class:`concurrent.futures.ProcessPoolExecutor` offers a higher level " "interface to push tasks to a background process without blocking execution " -"of the calling process. Compared to using the :class:`~multiprocessing.pool." -"Pool` interface directly, the :mod:`concurrent.futures` API more readily " -"allows the submission of work to the underlying process pool to be separated " -"from waiting for the results." +"of the calling process. Compared to using " +"the :class:`~multiprocessing.pool.Pool` interface directly, " +"the :mod:`concurrent.futures` API more readily allows the submission of work " +"to the underlying process pool to be separated from waiting for the results." msgstr "" msgid "The :class:`Process` class" msgstr "" msgid "" -"In :mod:`!multiprocessing`, processes are spawned by creating a :class:" -"`Process` object and then calling its :meth:`~Process.start` method. :class:" -"`Process` follows the API of :class:`threading.Thread`. A trivial example " -"of a multiprocess program is ::" +"In :mod:`!multiprocessing`, processes are spawned by creating " +"a :class:`Process` object and then calling its :meth:`~Process.start` " +"method. :class:`Process` follows the API of :class:`threading.Thread`. A " +"trivial example of a multiprocess program is ::" msgstr "" msgid "" @@ -147,10 +148,10 @@ msgid "" msgstr "" msgid "" -"The arguments to :class:`Process` usually need to be unpickleable from " -"within the child process. If you tried typing the above example directly " -"into a REPL it could lead to an :exc:`AttributeError` in the child process " -"trying to locate the *f* function in the ``__main__`` module." +"The arguments to :class:`Process` usually need to be picklable so they can " +"be passed to the child process. If you tried typing the above example " +"directly into a REPL it could lead to an :exc:`AttributeError` in the child " +"process trying to locate the *f* function in the ``__main__`` module." msgstr "" msgid "Contexts and start methods" @@ -192,15 +193,15 @@ msgstr "" msgid "" "This is no longer the default start method on any platform. Code that " -"requires *fork* must explicitly specify that via :func:`get_context` or :" -"func:`set_start_method`." +"requires *fork* must explicitly specify that via :func:`get_context` " +"or :func:`set_start_method`." msgstr "" msgid "" -"If Python is able to detect that your process has multiple threads, the :" -"func:`os.fork` function that this start method calls internally will raise " -"a :exc:`DeprecationWarning`. Use a different start method. See the :func:`os." -"fork` documentation for further explanation." +"If Python is able to detect that your process has multiple threads, " +"the :func:`os.fork` function that this start method calls internally will " +"raise a :exc:`DeprecationWarning`. Use a different start method. See " +"the :func:`os.fork` documentation for further explanation." msgstr "" msgid "*forkserver*" @@ -217,12 +218,22 @@ msgstr "" msgid "" "Available on POSIX platforms which support passing file descriptors over " -"Unix pipes such as Linux. The default on those." +"Unix pipes such as Linux. The default on those, unless there is no writable " +"temporary directory (see :func:`tempfile.gettempdir`), which the fork server " +"requires; *spawn* is the default in that case." msgstr "" msgid "This became the default start method on POSIX platforms." msgstr "" +msgid "" +"*spawn* is now the default start method when there is no writable temporary " +"directory, for example on a read-only file system. Previously *forkserver* " +"remained the default there and starting a process failed with " +"an :exc:`OSError`. The default is determined when it is first needed rather " +"than when :mod:`!multiprocessing` is imported. See :gh:`155717`." +msgstr "" + msgid "" "*spawn* added on all POSIX platforms, and *forkserver* added for some POSIX " "platforms. Child processes no longer inherit all of the parents inheritable " @@ -244,15 +255,15 @@ msgstr "" msgid "" "On POSIX using the *spawn* or *forkserver* start methods will also start a " "*resource tracker* process which tracks the unlinked named system resources " -"(such as named semaphores or :class:`~multiprocessing.shared_memory." -"SharedMemory` objects) created by processes of the program. When all " -"processes have exited the resource tracker unlinks any remaining tracked " -"object. Usually there should be none, but if a process was killed by a " -"signal there may be some \"leaked\" resources. (Neither leaked semaphores " -"nor shared memory segments will be automatically unlinked until the next " -"reboot. This is problematic for both objects because the system allows only " -"a limited number of named semaphores, and shared memory segments occupy some " -"space in the main memory.)" +"(such as named semaphores " +"or :class:`~multiprocessing.shared_memory.SharedMemory` objects) created by " +"processes of the program. When all processes have exited the resource " +"tracker unlinks any remaining tracked object. Usually there should be none, " +"but if a process was killed by a signal there may be some \"leaked\" " +"resources. (Neither leaked semaphores nor shared memory segments will be " +"automatically unlinked until the next reboot. This is problematic for both " +"objects because the system allows only a limited number of named semaphores, " +"and shared memory segments occupy some space in the main memory.)" msgstr "" msgid "" @@ -308,12 +319,12 @@ msgid "" msgstr "" msgid "" -"Libraries using :mod:`!multiprocessing` or :class:`~concurrent.futures." -"ProcessPoolExecutor` should be designed to allow their users to provide " -"their own multiprocessing context. Using a specific context of your own " -"within a library can lead to incompatibilities with the rest of the library " -"user's application. Always document if your library requires a specific " -"start method." +"Libraries using :mod:`!multiprocessing` " +"or :class:`~concurrent.futures.ProcessPoolExecutor` should be designed to " +"allow their users to provide their own multiprocessing context. Using a " +"specific context of your own within a library can lead to incompatibilities " +"with the rest of the library user's application. Always document if your " +"library requires a specific start method." msgstr "" msgid "" @@ -383,16 +394,17 @@ msgstr "" msgid "" "The two connection objects returned by :func:`Pipe` represent the two ends " -"of the pipe. Each connection object has :meth:`~Connection.send` and :meth:" -"`~Connection.recv` methods (among others). Note that data in a pipe may " -"become corrupted if two processes (or threads) try to read from or write to " -"the *same* end of the pipe at the same time. Of course there is no risk of " -"corruption from processes using different ends of the pipe at the same time." +"of the pipe. Each connection object has :meth:`~Connection.send` " +"and :meth:`~Connection.recv` methods (among others). Note that data in a " +"pipe may become corrupted if two processes (or threads) try to read from or " +"write to the *same* end of the pipe at the same time. Of course there is no " +"risk of corruption from processes using different ends of the pipe at the " +"same time." msgstr "" msgid "" -"The :meth:`~Connection.send` method serializes the object and :meth:" -"`~Connection.recv` re-creates the object." +"The :meth:`~Connection.send` method serializes the object " +"and :meth:`~Connection.recv` re-creates the object." msgstr "" msgid "Synchronization between processes" @@ -444,8 +456,8 @@ msgid "**Shared memory**" msgstr "" msgid "" -"Data can be stored in a shared memory map using :class:`Value` or :class:" -"`Array`. For example, the following code ::" +"Data can be stored in a shared memory map using :class:`Value` " +"or :class:`Array`. For example, the following code ::" msgstr "" msgid "" @@ -484,9 +496,9 @@ msgid "" msgstr "" msgid "" -"For more flexibility in using shared memory one can use the :mod:" -"`multiprocessing.sharedctypes` module which supports the creation of " -"arbitrary ctypes objects allocated from shared memory." +"For more flexibility in using shared memory one can use " +"the :mod:`multiprocessing.sharedctypes` module which supports the creation " +"of arbitrary ctypes objects allocated from shared memory." msgstr "" msgid "**Server process**" @@ -499,11 +511,9 @@ msgid "" msgstr "" msgid "" -"A manager returned by :func:`Manager` will support types :class:`list`, :" -"class:`dict`, :class:`set`, :class:`~managers.Namespace`, :class:`Lock`, :" -"class:`RLock`, :class:`Semaphore`, :class:`BoundedSemaphore`, :class:" -"`Condition`, :class:`Event`, :class:`Barrier`, :class:`Queue`, :class:" -"`Value` and :class:`Array`. For example, ::" +"A manager returned by :func:`Manager` will support " +"types :class:`list`, :class:`dict`, :class:`set`, :class:`~managers.Namespace`, :class:`Lock`, :class:`RLock`, :class:`Semaphore`, :class:`BoundedSemaphore`, :class:`Condition`, :class:`Event`, :class:`Barrier`, :class:`Queue`, :class:`Value` " +"and :class:`Array`. For example, ::" msgstr "" msgid "" @@ -596,8 +606,8 @@ msgid "" " try:\n" " print(res.get(timeout=1))\n" " except TimeoutError:\n" -" print(\"We lacked patience and got a multiprocessing." -"TimeoutError\")\n" +" print(\"We lacked patience and got a " +"multiprocessing.TimeoutError\")\n" "\n" " print(\"For the moment, the pool remains available for more work\")\n" "\n" @@ -647,11 +657,11 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "" -"The :mod:`!multiprocessing` package mostly replicates the API of the :mod:" -"`threading` module." +"The :mod:`!multiprocessing` package mostly replicates the API of " +"the :mod:`threading` module." msgstr "" msgid "Global start method" @@ -675,22 +685,22 @@ msgid ":class:`Process` and exceptions" msgstr "" msgid "" -"Process objects represent activity that is run in a separate process. The :" -"class:`Process` class has equivalents of all the methods of :class:" -"`threading.Thread`." +"Process objects represent activity that is run in a separate process. " +"The :class:`Process` class has equivalents of all the methods " +"of :class:`threading.Thread`." msgstr "" msgid "" "The constructor should always be called with keyword arguments. *group* " -"should always be ``None``; it exists solely for compatibility with :class:" -"`threading.Thread`. *target* is the callable object to be invoked by the :" -"meth:`run` method. It defaults to ``None``, meaning nothing is called. " -"*name* is the process name (see :attr:`name` for more details). *args* is " -"the argument tuple for the target invocation. *kwargs* is a dictionary of " -"keyword arguments for the target invocation. If provided, the keyword-only " -"*daemon* argument sets the process :attr:`daemon` flag to ``True`` or " -"``False``. If ``None`` (the default), this flag will be inherited from the " -"creating process." +"should always be ``None``; it exists solely for compatibility " +"with :class:`threading.Thread`. *target* is the callable object to be " +"invoked by the :meth:`run` method. It defaults to ``None``, meaning nothing " +"is called. *name* is the process name (see :attr:`name` for more details). " +"*args* is the argument tuple for the target invocation. *kwargs* is a " +"dictionary of keyword arguments for the target invocation. If provided, the " +"keyword-only *daemon* argument sets the process :attr:`daemon` flag to " +"``True`` or ``False``. If ``None`` (the default), this flag will be " +"inherited from the creating process." msgstr "" msgid "" @@ -707,9 +717,9 @@ msgstr "" msgid "" "In general, all arguments to :class:`Process` must be picklable. This is " -"frequently observed when trying to create a :class:`Process` or use a :class:" -"`concurrent.futures.ProcessPoolExecutor` from a REPL with a locally defined " -"*target* function." +"frequently observed when trying to create a :class:`Process` or use " +"a :class:`concurrent.futures.ProcessPoolExecutor` from a REPL with a locally " +"defined *target* function." msgstr "" msgid "" @@ -808,9 +818,9 @@ msgstr "" msgid "" "The initial name is set by the constructor. If no explicit name is provided " -"to the constructor, a name of the form 'Process-N\\ :sub:`1`:N\\ :sub:" -"`2`:...:N\\ :sub:`k`' is constructed, where each N\\ :sub:`k` is the N-th " -"child of its parent." +"to the constructor, a name of the form 'Process-" +"N\\ :sub:`1`:N\\ :sub:`2`:...:N\\ :sub:`k`' is constructed, where each " +"N\\ :sub:`k` is the N-th child of its parent." msgstr "" msgid "Return whether the process is alive." @@ -822,8 +832,8 @@ msgid "" msgstr "" msgid "" -"The process's daemon flag, a Boolean value. This must be set before :meth:" -"`start` is called." +"The process's daemon flag, a Boolean value. This must be set " +"before :meth:`start` is called." msgstr "" msgid "The initial value is inherited from the creating process." @@ -891,9 +901,9 @@ msgid "" msgstr "" msgid "" -"You can use this value if you want to wait on several events at once using :" -"func:`multiprocessing.connection.wait`. Otherwise calling :meth:`join` is " -"simpler." +"You can use this value if you want to wait on several events at once " +"using :func:`multiprocessing.connection.wait`. Otherwise " +"calling :meth:`join` is simpler." msgstr "" msgid "" @@ -908,10 +918,10 @@ msgid "" msgstr "" msgid "" -"By default, this terminates the child process by raising :exc:" -"`KeyboardInterrupt`. This behavior can be altered by setting the respective " -"signal handler in the child process :func:`signal.signal` for :py:const:" -"`~signal.SIGINT`." +"By default, this terminates the child process by " +"raising :exc:`KeyboardInterrupt`. This behavior can be altered by setting " +"the respective signal handler in the child process :func:`signal.signal` " +"for :py:const:`~signal.SIGINT`." msgstr "" msgid "" @@ -921,15 +931,16 @@ msgstr "" msgid "" "Note: the default behavior will also set :attr:`exitcode` to ``1`` as if an " -"uncaught exception was raised in the child process. To have a different :" -"attr:`exitcode` you may simply catch :exc:`KeyboardInterrupt` and call " -"``exit(your_code)``." +"uncaught exception was raised in the child process. To have a " +"different :attr:`exitcode` you may simply catch :exc:`KeyboardInterrupt` and " +"call ``exit(your_code)``." msgstr "" msgid "" -"Terminate the process. On POSIX this is done using the :py:const:`~signal." -"SIGTERM` signal; on Windows :c:func:`!TerminateProcess` is used. Note that " -"exit handlers and finally clauses, etc., will not be executed." +"Terminate the process. On POSIX this is done using " +"the :py:const:`~signal.SIGTERM` signal; on Windows :c:func:`!" +"TerminateProcess` is used. Note that exit handlers and finally clauses, " +"etc., will not be executed." msgstr "" msgid "" @@ -956,9 +967,10 @@ msgid "" msgstr "" msgid "" -"Note that the :meth:`start`, :meth:`join`, :meth:`is_alive`, :meth:" -"`terminate` and :attr:`exitcode` methods should only be called by the " -"process that created the process object." +"Note that " +"the :meth:`start`, :meth:`join`, :meth:`is_alive`, :meth:`terminate` " +"and :attr:`exitcode` methods should only be called by the process that " +"created the process object." msgstr "" msgid "Example usage of some of the methods of :class:`Process`:" @@ -1018,23 +1030,23 @@ msgid "" "The :class:`Queue`, :class:`SimpleQueue` and :class:`JoinableQueue` types " "are multi-producer, multi-consumer :abbr:`FIFO (first-in, first-out)` queues " "modelled on the :class:`queue.Queue` class in the standard library. They " -"differ in that :class:`Queue` lacks the :meth:`~queue.Queue.task_done` and :" -"meth:`~queue.Queue.join` methods introduced into Python 2.5's :class:`queue." -"Queue` class." +"differ in that :class:`Queue` lacks the :meth:`~queue.Queue.task_done` " +"and :meth:`~queue.Queue.join` methods introduced into Python " +"2.5's :class:`queue.Queue` class." msgstr "" msgid "" -"If you use :class:`JoinableQueue` then you **must** call :meth:" -"`JoinableQueue.task_done` for each task removed from the queue or else the " -"semaphore used to count the number of unfinished tasks may eventually " -"overflow, raising an exception." +"If you use :class:`JoinableQueue` then you **must** " +"call :meth:`JoinableQueue.task_done` for each task removed from the queue or " +"else the semaphore used to count the number of unfinished tasks may " +"eventually overflow, raising an exception." msgstr "" msgid "" "One difference from other Python queue implementations, is that :mod:`!" -"multiprocessing` queues serializes all objects that are put into them using :" -"mod:`pickle`. The object returned by the get method is a re-created object " -"that does not share memory with the original object." +"multiprocessing` queues serializes all objects that are put into them " +"using :mod:`pickle`. The object returned by the get method is a re-created " +"object that does not share memory with the original object." msgstr "" msgid "" @@ -1043,9 +1055,10 @@ msgid "" msgstr "" msgid "" -":mod:`!multiprocessing` uses the usual :exc:`queue.Empty` and :exc:`queue." -"Full` exceptions to signal a timeout. They are not available in the :mod:`!" -"multiprocessing` namespace so you need to import them from :mod:`queue`." +":mod:`!multiprocessing` uses the usual :exc:`queue.Empty` " +"and :exc:`queue.Full` exceptions to signal a timeout. They are not " +"available in the :mod:`!multiprocessing` namespace so you need to import " +"them from :mod:`queue`." msgstr "" msgid "" @@ -1078,9 +1091,9 @@ msgstr "" msgid "" "As mentioned above, if a child process has put items on a queue (and it has " -"not used :meth:`JoinableQueue.cancel_join_thread `), then that process will not terminate until all " -"buffered items have been flushed to the pipe." +"not used :meth:`JoinableQueue.cancel_join_thread " +"`), then that process will not " +"terminate until all buffered items have been flushed to the pipe." msgstr "" msgid "" @@ -1092,18 +1105,19 @@ msgid "" msgstr "" msgid "" -"Note that a queue created using a manager does not have this issue. See :" -"ref:`multiprocessing-programming`." +"Note that a queue created using a manager does not have this issue. " +"See :ref:`multiprocessing-programming`." msgstr "" msgid "" -"For an example of the usage of queues for interprocess communication see :" -"ref:`multiprocessing-examples`." +"For an example of the usage of queues for interprocess communication " +"see :ref:`multiprocessing-examples`." msgstr "" msgid "" -"Returns a pair ``(conn1, conn2)`` of :class:`~multiprocessing.connection." -"Connection` objects representing the ends of a pipe." +"Returns a pair ``(conn1, conn2)`` " +"of :class:`~multiprocessing.connection.Connection` objects representing the " +"ends of a pipe." msgstr "" msgid "" @@ -1137,8 +1151,8 @@ msgstr "" msgid "" ":class:`Queue` implements all the methods of :class:`queue.Queue` except " -"for :meth:`~queue.Queue.task_done`, :meth:`~queue.Queue.join`, and :meth:" -"`~queue.Queue.shutdown`." +"for :meth:`~queue.Queue.task_done`, :meth:`~queue.Queue.join`, " +"and :meth:`~queue.Queue.shutdown`." msgstr "" msgid "" @@ -1175,8 +1189,8 @@ msgid "" msgstr "" msgid "" -"If the queue is closed, :exc:`ValueError` is raised instead of :exc:" -"`AssertionError`." +"If the queue is closed, :exc:`ValueError` is raised instead " +"of :exc:`AssertionError`." msgstr "" msgid "Equivalent to ``put(obj, False)``." @@ -1188,30 +1202,31 @@ msgid "" "necessary until an item is available. If *timeout* is a positive number, it " "blocks at most *timeout* seconds and raises the :exc:`queue.Empty` exception " "if no item was available within that time. Otherwise (block is ``False``), " -"return an item if one is immediately available, else raise the :exc:`queue." -"Empty` exception (*timeout* is ignored in that case)." +"return an item if one is immediately available, else raise " +"the :exc:`queue.Empty` exception (*timeout* is ignored in that case)." msgstr "" msgid "" -"If the queue is closed, :exc:`ValueError` is raised instead of :exc:" -"`OSError`." +"If the queue is closed, :exc:`ValueError` is raised instead " +"of :exc:`OSError`." msgstr "" msgid "Equivalent to ``get(False)``." msgstr "" msgid "" -":class:`multiprocessing.Queue` has a few additional methods not found in :" -"class:`queue.Queue`. These methods are usually unnecessary for most code:" +":class:`multiprocessing.Queue` has a few additional methods not found " +"in :class:`queue.Queue`. These methods are usually unnecessary for most " +"code:" msgstr "" msgid "Close the queue: release internal resources." msgstr "" msgid "" -"A queue must not be used anymore after it is closed. For example, :meth:" -"`~Queue.get`, :meth:`~Queue.put` and :meth:`~Queue.empty` methods must no " -"longer be called." +"A queue must not be used anymore after it is closed. For " +"example, :meth:`~Queue.get`, :meth:`~Queue.put` and :meth:`~Queue.empty` " +"methods must no longer be called." msgstr "" msgid "" @@ -1227,8 +1242,8 @@ msgstr "" msgid "" "By default if a process is not the creator of the queue then on exit it will " -"attempt to join the queue's background thread. The process can call :meth:" -"`cancel_join_thread` to make :meth:`join_thread` do nothing." +"attempt to join the queue's background thread. The process can " +"call :meth:`cancel_join_thread` to make :meth:`join_thread` do nothing." msgstr "" msgid "" @@ -1259,8 +1274,9 @@ msgid "" msgstr "" msgid "" -"A queue must not be used anymore after it is closed. For example, :meth:" -"`get`, :meth:`put` and :meth:`empty` methods must no longer be called." +"A queue must not be used anymore after it is closed. For " +"example, :meth:`get`, :meth:`put` and :meth:`empty` methods must no longer " +"be called." msgstr "" msgid "Return ``True`` if the queue is empty, ``False`` otherwise." @@ -1325,8 +1341,8 @@ msgstr "" msgid "" "This number is not equivalent to the number of CPUs the current process can " -"use. The number of usable CPUs can be obtained with :func:`os." -"process_cpu_count` (or ``len(os.sched_getaffinity(0))``)." +"use. The number of usable CPUs can be obtained " +"with :func:`os.process_cpu_count` (or ``len(os.sched_getaffinity(0))``)." msgstr "" msgid "" @@ -1393,8 +1409,8 @@ msgstr "" msgid "" "Returns a list of the supported start methods, the first of which is the " "default. The possible start methods are ``'fork'``, ``'spawn'`` and " -"``'forkserver'``. Not all platforms support all methods. See :ref:" -"`multiprocessing-start-methods`." +"``'forkserver'``. Not all platforms support all methods. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" @@ -1407,8 +1423,8 @@ msgid "" "the global start method has not been set, this will set it to the system " "default See :ref:`global-start-method` for more details. Otherwise *method* " "should be ``'fork'``, ``'spawn'``, ``'forkserver'``. :exc:`ValueError` is " -"raised if the specified start method is not available. See :ref:" -"`multiprocessing-start-methods`." +"raised if the specified start method is not available. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "Return the name of start method used for starting processes." @@ -1416,8 +1432,8 @@ msgstr "" msgid "" "If the global start method is not set and *allow_none* is ``False``, the " -"global start method is set to the default, and its name is returned. See :" -"ref:`global-start-method` for more details." +"global start method is set to the default, and its name is returned. " +"See :ref:`global-start-method` for more details." msgstr "" msgid "" @@ -1463,17 +1479,17 @@ msgid "" msgstr "" msgid "" -"Only meaningful when using the ``'forkserver'`` start method. See :ref:" -"`multiprocessing-start-methods`." +"Only meaningful when using the ``'forkserver'`` start method. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" "Set the method which should be used to start child processes. The *method* " -"argument can be ``'fork'``, ``'spawn'`` or ``'forkserver'``. Raises :exc:" -"`RuntimeError` if the start method has already been set and *force* is not " -"``True``. If *method* is ``None`` and *force* is ``True`` then the start " -"method is set to ``None``. If *method* is ``None`` and *force* is ``False`` " -"then the context is set to the default context." +"argument can be ``'fork'``, ``'spawn'`` or ``'forkserver'``. " +"Raises :exc:`RuntimeError` if the start method has already been set and " +"*force* is not ``True``. If *method* is ``None`` and *force* is ``True`` " +"then the start method is set to ``None``. If *method* is ``None`` and " +"*force* is ``False`` then the context is set to the default context." msgstr "" msgid "" @@ -1485,10 +1501,9 @@ msgid "See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" -":mod:`!multiprocessing` contains no analogues of :func:`threading." -"active_count`, :func:`threading.enumerate`, :func:`threading.settrace`, :" -"func:`threading.setprofile`, :class:`threading.Timer`, or :class:`threading." -"local`." +":mod:`!multiprocessing` contains no analogues " +"of :func:`threading.active_count`, :func:`threading.enumerate`, :func:`threading.settrace`, :func:`threading.setprofile`, :class:`threading.Timer`, " +"or :class:`threading.local`." msgstr "" msgid "Connection Objects" @@ -1500,8 +1515,8 @@ msgid "" msgstr "" msgid "" -"Connection objects are usually created using :func:`Pipe ` -- see also :ref:`multiprocessing-listeners-clients`." +"Connection objects are usually created using :func:`Pipe " +"` -- see also :ref:`multiprocessing-listeners-clients`." msgstr "" msgid "" @@ -1515,9 +1530,10 @@ msgid "" msgstr "" msgid "" -"Return an object sent from the other end of the connection using :meth:" -"`send`. Blocks until there is something to receive. Raises :exc:`EOFError` " -"if there is nothing left to receive and the other end was closed." +"Return an object sent from the other end of the connection " +"using :meth:`send`. Blocks until there is something to receive. " +"Raises :exc:`EOFError` if there is nothing left to receive and the other end " +"was closed." msgstr "" msgid "Return the file descriptor or handle used by the connection." @@ -1539,8 +1555,8 @@ msgid "" msgstr "" msgid "" -"Note that multiple connection objects may be polled at once by using :func:" -"`multiprocessing.connection.wait`." +"Note that multiple connection objects may be polled at once by " +"using :func:`multiprocessing.connection.wait`." msgstr "" msgid "Send byte data from a :term:`bytes-like object` as a complete message." @@ -1549,25 +1565,25 @@ msgstr "" msgid "" "If *offset* is given then data is read from that position in *buf*. If " "*size* is given then that many bytes will be read from *buf*. Very large " -"buffers (approximately 32 MiB+, though it depends on the OS) may raise a :" -"exc:`ValueError` exception" +"buffers (approximately 32 MiB+, though it depends on the OS) may raise " +"a :exc:`ValueError` exception" msgstr "" msgid "" "Return a complete message of byte data sent from the other end of the " -"connection as a string. Blocks until there is something to receive. Raises :" -"exc:`EOFError` if there is nothing left to receive and the other end has " -"closed." +"connection as a string. Blocks until there is something to receive. " +"Raises :exc:`EOFError` if there is nothing left to receive and the other end " +"has closed." msgstr "" msgid "" -"If *maxlength* is specified and the message is longer than *maxlength* then :" -"exc:`OSError` is raised and the connection will no longer be readable." +"If *maxlength* is specified and the message is longer than *maxlength* " +"then :exc:`OSError` is raised and the connection will no longer be readable." msgstr "" msgid "" -"This function used to raise :exc:`IOError`, which is now an alias of :exc:" -"`OSError`." +"This function used to raise :exc:`IOError`, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" @@ -1595,9 +1611,10 @@ msgid "" msgstr "" msgid "" -"Connection objects also now support the context management protocol -- see :" -"ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " -"connection object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." +"Connection objects also now support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns " +"the connection object, and :meth:`~contextmanager.__exit__` " +"calls :meth:`close`." msgstr "" msgid "For example:" @@ -1631,8 +1648,8 @@ msgstr "" msgid "" "Therefore, unless the connection object was produced using :func:`Pipe` you " "should only use the :meth:`~Connection.recv` and :meth:`~Connection.send` " -"methods after performing some sort of authentication. See :ref:" -"`multiprocessing-auth-keys`." +"methods after performing some sort of authentication. " +"See :ref:`multiprocessing-auth-keys`." msgstr "" msgid "" @@ -1646,8 +1663,8 @@ msgstr "" msgid "" "Generally synchronization primitives are not as necessary in a multiprocess " -"program as they are in a multithreaded program. See the documentation for :" -"mod:`threading` module." +"program as they are in a multithreaded program. See the documentation " +"for :mod:`threading` module." msgstr "" msgid "" @@ -1659,8 +1676,8 @@ msgid "A barrier object: a clone of :class:`threading.Barrier`." msgstr "" msgid "" -"A bounded semaphore object: a close analog of :class:`threading." -"BoundedSemaphore`." +"A bounded semaphore object: a close analog " +"of :class:`threading.BoundedSemaphore`." msgstr "" msgid "" @@ -1694,10 +1711,10 @@ msgid "" "A non-recursive lock object: a close analog of :class:`threading.Lock`. Once " "a process or thread has acquired a lock, subsequent attempts to acquire it " "from any process or thread will block until it is released; any process or " -"thread may release it. The concepts and behaviors of :class:`threading." -"Lock` as it applies to threads are replicated here in :class:" -"`multiprocessing.Lock` as it applies to either processes or threads, except " -"as noted." +"thread may release it. The concepts and behaviors " +"of :class:`threading.Lock` as it applies to threads are replicated here " +"in :class:`multiprocessing.Lock` as it applies to either processes or " +"threads, except as noted." msgstr "" msgid "" @@ -1792,9 +1809,9 @@ msgid "" msgstr "" msgid "" -"Use and behaviors of the *timeout* argument are the same as in :meth:`Lock." -"acquire`. Note that some of these behaviors of *timeout* differ from the " -"implemented behaviors in :meth:`threading.RLock.acquire`." +"Use and behaviors of the *timeout* argument are the same as " +"in :meth:`Lock.acquire`. Note that some of these behaviors of *timeout* " +"differ from the implemented behaviors in :meth:`threading.RLock.acquire`." msgstr "" msgid "" @@ -1807,8 +1824,8 @@ msgid "" msgstr "" msgid "" -"Only call this method when the calling process or thread owns the lock. An :" -"exc:`AssertionError` is raised if this method is called by a process or " +"Only call this method when the calling process or thread owns the lock. " +"An :exc:`AssertionError` is raised if this method is called by a process or " "thread other than the owner or if the lock is in an unlocked (unowned) " "state. Note that the type of exception raised in this situation differs " "from the implemented behavior in :meth:`threading.RLock.release`." @@ -1827,9 +1844,9 @@ msgstr "" msgid "" "Some of this package's functionality requires a functioning shared semaphore " -"implementation on the host operating system. Without one, the :mod:" -"`multiprocessing.synchronize` module will be disabled, and attempts to " -"import it will result in an :exc:`ImportError`. See :issue:`3770` for " +"implementation on the host operating system. Without one, " +"the :mod:`multiprocessing.synchronize` module will be disabled, and attempts " +"to import it will result in an :exc:`ImportError`. See :issue:`3770` for " "additional information." msgstr "" @@ -1849,8 +1866,9 @@ msgstr "" msgid "" "*typecode_or_type* determines the type of the returned object: it is either " -"a ctypes type or a one character typecode of the kind used by the :mod:" -"`array` module. *\\*args* is passed on to the constructor for the type." +"a ctypes type or a one character typecode of the kind used by " +"the :mod:`array` module. *\\*args* is passed on to the constructor for the " +"type." msgstr "" msgid "" @@ -1903,11 +1921,11 @@ msgstr "" msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " -"synchronize access to the value. If *lock* is a :class:`Lock` or :class:" -"`RLock` object then that will be used to synchronize access to the value. " -"If *lock* is ``False`` then access to the returned object will not be " -"automatically protected by a lock, so it will not necessarily be \"process-" -"safe\"." +"synchronize access to the value. If *lock* is a :class:`Lock` " +"or :class:`RLock` object then that will be used to synchronize access to the " +"value. If *lock* is ``False`` then access to the returned object will not " +"be automatically protected by a lock, so it will not necessarily be " +"\"process-safe\"." msgstr "" msgid "Note that *lock* is a keyword only argument." @@ -1915,7 +1933,10 @@ msgstr "" msgid "" "Note that an array of :data:`ctypes.c_char` has *value* and *raw* attributes " -"which allow one to use it to store and retrieve strings." +"which can both be used to store and retrieve byte strings. While *raw* " +"allows interaction with a :class:`bytes` object the full size of the array, " +"reading *value* will terminate after a null byte, like most programming " +"languages handle strings." msgstr "" msgid "The :mod:`!multiprocessing.sharedctypes` module" @@ -1948,18 +1969,18 @@ msgid "" msgstr "" msgid "" -"Note that setting and getting an element is potentially non-atomic -- use :" -"func:`Array` instead to make sure that access is automatically synchronized " -"using a lock." +"Note that setting and getting an element is potentially non-atomic -- " +"use :func:`Array` instead to make sure that access is automatically " +"synchronized using a lock." msgstr "" msgid "Return a ctypes object allocated from shared memory." msgstr "" msgid "" -"Note that setting and getting the value is potentially non-atomic -- use :" -"func:`Value` instead to make sure that access is automatically synchronized " -"using a lock." +"Note that setting and getting the value is potentially non-atomic -- " +"use :func:`Value` instead to make sure that access is automatically " +"synchronized using a lock." msgstr "" msgid "" @@ -1976,11 +1997,11 @@ msgstr "" msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " -"synchronize access to the value. If *lock* is a :class:`~multiprocessing." -"Lock` or :class:`~multiprocessing.RLock` object then that will be used to " -"synchronize access to the value. If *lock* is ``False`` then access to the " -"returned object will not be automatically protected by a lock, so it will " -"not necessarily be \"process-safe\"." +"synchronize access to the value. If *lock* is " +"a :class:`~multiprocessing.Lock` or :class:`~multiprocessing.RLock` object " +"then that will be used to synchronize access to the value. If *lock* is " +"``False`` then access to the returned object will not be automatically " +"protected by a lock, so it will not necessarily be \"process-safe\"." msgstr "" msgid "" @@ -2005,14 +2026,14 @@ msgstr "" msgid "" "Return a process-safe wrapper object for a ctypes object which uses *lock* " -"to synchronize access. If *lock* is ``None`` (the default) then a :class:" -"`multiprocessing.RLock` object is created automatically." +"to synchronize access. If *lock* is ``None`` (the default) then " +"a :class:`multiprocessing.RLock` object is created automatically." msgstr "" msgid "" "A synchronized wrapper will have two methods in addition to those of the " -"object it wraps: :meth:`get_obj` returns the wrapped object and :meth:" -"`get_lock` returns the lock object used for synchronization." +"object it wraps: :meth:`get_obj` returns the wrapped object " +"and :meth:`get_lock` returns the lock object used for synchronization." msgstr "" msgid "" @@ -2140,17 +2161,17 @@ msgstr "" msgid "" "Manager processes will be shutdown as soon as they are garbage collected or " -"their parent process exits. The manager classes are defined in the :mod:" -"`multiprocessing.managers` module:" +"their parent process exits. The manager classes are defined in " +"the :mod:`multiprocessing.managers` module:" msgstr "" msgid "Create a BaseManager object." msgstr "" msgid "" -"Once created one should call :meth:`start` or ``get_server()." -"serve_forever()`` to ensure that the manager object refers to a started " -"manager process." +"Once created one should call :meth:`start` or " +"``get_server().serve_forever()`` to ensure that the manager object refers to " +"a started manager process." msgstr "" msgid "" @@ -2187,8 +2208,8 @@ msgstr "" msgid "" "Returns a :class:`Server` object which represents the actual server under " -"the control of the Manager. The :class:`Server` object supports the :meth:" -"`serve_forever` method::" +"the control of the Manager. The :class:`Server` object supports " +"the :meth:`serve_forever` method::" msgstr "" msgid "" @@ -2214,8 +2235,8 @@ msgstr "" ">>> m.connect()" msgid "" -"Stop the process used by the manager. This is only available if :meth:" -"`start` has been used to start the server process." +"Stop the process used by the manager. This is only available " +"if :meth:`start` has been used to start the server process." msgstr "" msgid "This can be called multiple times." @@ -2246,21 +2267,22 @@ msgstr "" msgid "" "*exposed* is used to specify a sequence of method names which proxies for " -"this typeid should be allowed to access using :meth:`BaseProxy." -"_callmethod`. (If *exposed* is ``None`` then :attr:`proxytype._exposed_` is " -"used instead if it exists.) In the case where no exposed list is specified, " -"all \"public methods\" of the shared object will be accessible. (Here a " -"\"public method\" means any attribute which has a :meth:`~object.__call__` " -"method and whose name does not begin with ``'_'``.)" +"this typeid should be allowed to access " +"using :meth:`BaseProxy._callmethod`. (If *exposed* is ``None`` " +"then :attr:`proxytype._exposed_` is used instead if it exists.) In the case " +"where no exposed list is specified, all \"public methods\" of the shared " +"object will be accessible. (Here a \"public method\" means any attribute " +"which has a :meth:`~object.__call__` method and whose name does not begin " +"with ``'_'``.)" msgstr "" msgid "" "*method_to_typeid* is a mapping used to specify the return type of those " "exposed methods which should return a proxy. It maps method names to typeid " -"strings. (If *method_to_typeid* is ``None`` then :attr:`proxytype." -"_method_to_typeid_` is used instead if it exists.) If a method's name is " -"not a key of this mapping or if the mapping is ``None`` then the object " -"returned by the method will be copied by value." +"strings. (If *method_to_typeid* is ``None`` " +"then :attr:`proxytype._method_to_typeid_` is used instead if it exists.) If " +"a method's name is not a key of this mapping or if the mapping is ``None`` " +"then the object returned by the method will be copied by value." msgstr "" msgid "" @@ -2276,9 +2298,9 @@ msgid "The address used by the manager." msgstr "" msgid "" -"Manager objects support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the server " -"process (if it has not already started) and then returns the manager " +"Manager objects support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the " +"server process (if it has not already started) and then returns the manager " "object. :meth:`~contextmanager.__exit__` calls :meth:`shutdown`." msgstr "" @@ -2289,8 +2311,8 @@ msgstr "" msgid "" "A subclass of :class:`BaseManager` which can be used for the synchronization " -"of processes. Objects of this type are returned by :func:`multiprocessing." -"Manager`." +"of processes. Objects of this type are returned " +"by :func:`multiprocessing.Manager`." msgstr "" msgid "" @@ -2314,8 +2336,8 @@ msgid "" msgstr "" msgid "" -"If *lock* is supplied then it should be a proxy for a :class:`threading." -"Lock` or :class:`threading.RLock` object." +"If *lock* is supplied then it should be a proxy for " +"a :class:`threading.Lock` or :class:`threading.RLock` object." msgstr "" msgid "" @@ -2539,9 +2561,9 @@ msgstr "" msgid "" "An important feature of proxy objects is that they are picklable so they can " -"be passed between processes. As such, a referent can contain :ref:" -"`multiprocessing-proxy_objects`. This permits nesting of these managed " -"lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" +"be passed between processes. As such, a referent can " +"contain :ref:`multiprocessing-proxy_objects`. This permits nesting of these " +"managed lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" msgstr "" msgid "" @@ -2595,9 +2617,9 @@ msgid "" msgstr "" msgid "" -"This approach is perhaps less convenient than employing nested :ref:" -"`multiprocessing-proxy_objects` for most use cases but also demonstrates a " -"level of control over the synchronization." +"This approach is perhaps less convenient than employing " +"nested :ref:`multiprocessing-proxy_objects` for most use cases but also " +"demonstrates a level of control over the synchronization." msgstr "" msgid "" @@ -2645,10 +2667,10 @@ msgid "" msgstr "" msgid "" -"If an exception is raised by the call, then is re-raised by :meth:" -"`_callmethod`. If some other exception is raised in the manager's process " -"then this is converted into a :exc:`RemoteError` exception and is raised by :" -"meth:`_callmethod`." +"If an exception is raised by the call, then is re-raised " +"by :meth:`_callmethod`. If some other exception is raised in the manager's " +"process then this is converted into a :exc:`RemoteError` exception and is " +"raised by :meth:`_callmethod`." msgstr "" msgid "" @@ -2729,11 +2751,12 @@ msgstr "" msgid "" "*context* can be used to specify the context used for starting the worker " -"processes. Usually a pool is created using the function :func:" -"`multiprocessing.Pool` or the :meth:`Pool` method of a context object. In " -"both cases *context* is set appropriately. If ``None``, calling this " -"function will have the side effect of setting the current global start " -"method if it has not been set already. See the :func:`get_context` function." +"processes. Usually a pool is created using the " +"function :func:`multiprocessing.Pool` or the :meth:`Pool` method of a " +"context object. In both cases *context* is set appropriately. If ``None``, " +"calling this function will have the side effect of setting the current " +"global start method if it has not been set already. See " +"the :func:`get_context` function." msgstr "" msgid "" @@ -2742,10 +2765,10 @@ msgid "" msgstr "" msgid "" -":class:`multiprocessing.pool` objects have internal resources that need to " -"be properly managed (like any other resource) by using the pool as a context " -"manager or by calling :meth:`close` and :meth:`terminate` manually. Failure " -"to do this can lead to the process hanging on finalization." +":class:`~multiprocessing.pool.Pool` objects have internal resources that " +"need to be properly managed (like any other resource) by using the pool as a " +"context manager or by calling :meth:`close` and :meth:`terminate` manually. " +"Failure to do this can lead to the process hanging on finalization." msgstr "" msgid "" @@ -2761,8 +2784,8 @@ msgid "Added the *context* parameter." msgstr "" msgid "" -"*processes* uses :func:`os.process_cpu_count` by default, instead of :func:" -"`os.cpu_count`." +"*processes* uses :func:`os.process_cpu_count` by default, instead " +"of :func:`os.cpu_count`." msgstr "" msgid "" @@ -2783,8 +2806,8 @@ msgid "" msgstr "" msgid "" -"A variant of the :meth:`apply` method which returns a :class:" -"`~multiprocessing.pool.AsyncResult` object." +"A variant of the :meth:`apply` method which returns " +"a :class:`~multiprocessing.pool.AsyncResult` object." msgstr "" msgid "" @@ -2824,11 +2847,11 @@ msgid "" msgstr "" msgid "" -"A variant of the :meth:`.map` method which returns a :class:" -"`~multiprocessing.pool.AsyncResult` object." +"A variant of the :meth:`.map` method which returns " +"a :class:`~multiprocessing.pool.AsyncResult` object." msgstr "" -msgid "A lazier version of :meth:`.map`." +msgid "An iterator-based version of :meth:`.map`." msgstr "" msgid "" @@ -2878,26 +2901,27 @@ msgid "" msgstr "" msgid "" -"Wait for the worker processes to exit. One must call :meth:`close` or :meth:" -"`terminate` before using :meth:`join`." +"Wait for the worker processes to exit. One must call :meth:`close` " +"or :meth:`terminate` before using :meth:`join`." msgstr "" msgid "" -"Pool objects now support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the pool " -"object, and :meth:`~contextmanager.__exit__` calls :meth:`terminate`." +"Pool objects now support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns " +"the pool object, and :meth:`~contextmanager.__exit__` " +"calls :meth:`terminate`." msgstr "" msgid "" -"The class of the result returned by :meth:`Pool.apply_async` and :meth:`Pool." -"map_async`." +"The class of the result returned by :meth:`Pool.apply_async` " +"and :meth:`Pool.map_async`." msgstr "" msgid "" "Return the result when it arrives. If *timeout* is not ``None`` and the " -"result does not arrive within *timeout* seconds then :exc:`multiprocessing." -"TimeoutError` is raised. If the remote call raised an exception then that " -"exception will be reraised by :meth:`get`." +"result does not arrive within *timeout* seconds " +"then :exc:`multiprocessing.TimeoutError` is raised. If the remote call " +"raised an exception then that exception will be reraised by :meth:`get`." msgstr "" msgid "Wait until the result is available or until *timeout* seconds pass." @@ -2907,13 +2931,13 @@ msgid "Return whether the call has completed." msgstr "" msgid "" -"Return whether the call completed without raising an exception. Will raise :" -"exc:`ValueError` if the result is not ready." +"Return whether the call completed without raising an exception. Will " +"raise :exc:`ValueError` if the result is not ready." msgstr "" msgid "" -"If the result is not ready, :exc:`ValueError` is raised instead of :exc:" -"`AssertionError`." +"If the result is not ready, :exc:`ValueError` is raised instead " +"of :exc:`AssertionError`." msgstr "" msgid "The following example demonstrates the use of a pool::" @@ -2942,16 +2966,16 @@ msgid "" "computer is *very* slow\n" "\n" " result = pool.apply_async(time.sleep, (10,))\n" -" print(result.get(timeout=1)) # raises multiprocessing." -"TimeoutError" +" print(result.get(timeout=1)) # raises " +"multiprocessing.TimeoutError" msgstr "" msgid "Listeners and Clients" msgstr "" msgid "" -"Usually message passing between processes is done using queues or by using :" -"class:`~Connection` objects returned by :func:`~multiprocessing.Pipe`." +"Usually message passing between processes is done using queues or by " +"using :class:`~Connection` objects returned by :func:`~multiprocessing.Pipe`." msgstr "" msgid "" @@ -2979,8 +3003,8 @@ msgid "" msgstr "" msgid "" -"If a welcome message is not received, then :exc:`~multiprocessing." -"AuthenticationError` is raised." +"If a welcome message is not received, " +"then :exc:`~multiprocessing.AuthenticationError` is raised." msgstr "" msgid "" @@ -2997,9 +3021,9 @@ msgstr "" msgid "" "If *authkey* is given and not ``None``, it should be a byte string and will " "be used as the secret key for an HMAC-based authentication challenge. No " -"authentication is done if *authkey* is ``None``. :exc:`~multiprocessing." -"AuthenticationError` is raised if authentication fails. See :ref:" -"`multiprocessing-auth-keys`." +"authentication is done if *authkey* is " +"``None``. :exc:`~multiprocessing.AuthenticationError` is raised if " +"authentication fails. See :ref:`multiprocessing-auth-keys`." msgstr "" msgid "" @@ -3061,9 +3085,10 @@ msgid "" msgstr "" msgid "" -"Listener objects now support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " -"listener object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." +"Listener objects now support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns " +"the listener object, and :meth:`~contextmanager.__exit__` " +"calls :meth:`close`." msgstr "" msgid "" @@ -3085,8 +3110,8 @@ msgid "a connected and readable :class:`socket.socket` object; or" msgstr "" msgid "" -"the :attr:`~multiprocessing.Process.sentinel` attribute of a :class:" -"`~multiprocessing.Process` object." +"the :attr:`~multiprocessing.Process.sentinel` attribute of " +"a :class:`~multiprocessing.Process` object." msgstr "" msgid "" @@ -3095,17 +3120,18 @@ msgid "" msgstr "" msgid "" -"**POSIX**: ``wait(object_list, timeout)`` almost equivalent ``select." -"select(object_list, [], [], timeout)``. The difference is that, if :func:" -"`select.select` is interrupted by a signal, it can raise :exc:`OSError` with " -"an error number of ``EINTR``, whereas :func:`wait` will not." +"**POSIX**: ``wait(object_list, timeout)`` almost equivalent " +"``select.select(object_list, [], [], timeout)``. The difference is that, " +"if :func:`select.select` is interrupted by a signal, it can " +"raise :exc:`OSError` with an error number of ``EINTR``, whereas :func:`wait` " +"will not." msgstr "" msgid "" "**Windows**: An item in *object_list* must either be an integer handle which " "is waitable (according to the definition used by the documentation of the " -"Win32 function ``WaitForMultipleObjects()``) or it can be an object with a :" -"meth:`~io.IOBase.fileno` method which returns a socket handle or pipe " +"Win32 function ``WaitForMultipleObjects()``) or it can be an object with " +"a :meth:`~io.IOBase.fileno` method which returns a socket handle or pipe " "handle. (Note that pipe handles and socket handles are **not** waitable " "handles.)" msgstr "" @@ -3240,17 +3266,17 @@ msgstr "" msgid "" "If authentication is requested but no authentication key is specified then " -"the return value of ``current_process().authkey`` is used (see :class:" -"`~multiprocessing.Process`). This value will be automatically inherited by " -"any :class:`~multiprocessing.Process` object that the current process " -"creates. This means that (by default) all processes of a multi-process " -"program will share a single authentication key which can be used when " -"setting up connections between themselves." +"the return value of ``current_process().authkey`` is used " +"(see :class:`~multiprocessing.Process`). This value will be automatically " +"inherited by any :class:`~multiprocessing.Process` object that the current " +"process creates. This means that (by default) all processes of a multi-" +"process program will share a single authentication key which can be used " +"when setting up connections between themselves." msgstr "" msgid "" -"Suitable authentication keys can also be generated by using :func:`os." -"urandom`." +"Suitable authentication keys can also be generated by " +"using :func:`os.urandom`." msgstr "" msgid "" @@ -3269,10 +3295,10 @@ msgid "Logging" msgstr "Logowanie" msgid "" -"Some support for logging is available. Note, however, that the :mod:" -"`logging` package does not use process shared locks so it is possible " -"(depending on the handler type) for messages from different processes to get " -"mixed up." +"Some support for logging is available. Note, however, that " +"the :mod:`logging` package does not use process shared locks so it is " +"possible (depending on the handler type) for messages from different " +"processes to get mixed up." msgstr "" msgid "" @@ -3330,10 +3356,10 @@ msgid "" msgstr "" msgid "" -"In particular, the ``Pool`` function provided by :mod:`!multiprocessing." -"dummy` returns an instance of :class:`ThreadPool`, which is a subclass of :" -"class:`Pool` that supports all the same method calls but uses a pool of " -"worker threads rather than worker processes." +"In particular, the ``Pool`` function provided by :mod:`!" +"multiprocessing.dummy` returns an instance of :class:`ThreadPool`, which is " +"a subclass of :class:`Pool` that supports all the same method calls but uses " +"a pool of worker threads rather than worker processes." msgstr "" msgid "" @@ -3341,8 +3367,8 @@ msgid "" "can be submitted. :class:`ThreadPool` instances are fully interface " "compatible with :class:`Pool` instances, and their resources must also be " "properly managed, either by using the pool as a context manager or by " -"calling :meth:`~multiprocessing.pool.Pool.close` and :meth:`~multiprocessing." -"pool.Pool.terminate` manually." +"calling :meth:`~multiprocessing.pool.Pool.close` " +"and :meth:`~multiprocessing.pool.Pool.terminate` manually." msgstr "" msgid "" @@ -3356,19 +3382,19 @@ msgstr "" msgid "" "A :class:`ThreadPool` shares the same interface as :class:`Pool`, which is " -"designed around a pool of processes and predates the introduction of the :" -"class:`concurrent.futures` module. As such, it inherits some operations " -"that don't make sense for a pool backed by threads, and it has its own type " -"for representing the status of asynchronous jobs, :class:`AsyncResult`, that " -"is not understood by any other libraries." +"designed around a pool of processes and predates the introduction of " +"the :class:`concurrent.futures` module. As such, it inherits some " +"operations that don't make sense for a pool backed by threads, and it has " +"its own type for representing the status of asynchronous " +"jobs, :class:`AsyncResult`, that is not understood by any other libraries." msgstr "" msgid "" -"Users should generally prefer to use :class:`concurrent.futures." -"ThreadPoolExecutor`, which has a simpler interface that was designed around " -"threads from the start, and which returns :class:`concurrent.futures.Future` " -"instances that are compatible with many other libraries, including :mod:" -"`asyncio`." +"Users should generally prefer to " +"use :class:`concurrent.futures.ThreadPoolExecutor`, which has a simpler " +"interface that was designed around threads from the start, and which " +"returns :class:`concurrent.futures.Future` instances that are compatible " +"with many other libraries, including :mod:`asyncio`." msgstr "" msgid "Programming guidelines" @@ -3425,9 +3451,9 @@ msgid "" "zombie. There should never be very many because each time a new process " "starts (or :func:`~multiprocessing.active_children` is called) all completed " "processes which have not yet been joined will be joined. Also calling a " -"finished process's :meth:`Process.is_alive ` will join the process. Even so it is probably good practice to " -"explicitly join all the processes that you start." +"finished process's :meth:`Process.is_alive " +"` will join the process. Even so it is " +"probably good practice to explicitly join all the processes that you start." msgstr "" msgid "Better to inherit than pickle/unpickle" @@ -3453,9 +3479,9 @@ msgid "" msgstr "" msgid "" -"Therefore it is probably best to only consider using :meth:`Process." -"terminate ` on processes which never use " -"any shared resources." +"Therefore it is probably best to only consider " +"using :meth:`Process.terminate ` on " +"processes which never use any shared resources." msgstr "" msgid "Joining processes that use queues" @@ -3464,9 +3490,10 @@ msgstr "" msgid "" "Bear in mind that a process that has put items in a queue will wait before " "terminating until all the buffered items are fed by the \"feeder\" thread to " -"the underlying pipe. (The child process can call the :meth:`Queue." -"cancel_join_thread ` method of the " -"queue to avoid this behaviour.)" +"the underlying pipe. (The child process can call " +"the :meth:`Queue.cancel_join_thread " +"` method of the queue to avoid " +"this behaviour.)" msgstr "" msgid "" @@ -3495,8 +3522,8 @@ msgid "" msgstr "" msgid "" -"A fix here would be to swap the last two lines (or simply remove the ``p." -"join()`` line)." +"A fix here would be to swap the last two lines (or simply remove the " +"``p.join()`` line)." msgstr "" msgid "Explicitly pass resources to child processes" @@ -3570,9 +3597,10 @@ msgid "" "Which solves the fundamental issue of processes colliding with each other " "resulting in a bad file descriptor error, but introduces a potential danger " "to applications which replace :func:`sys.stdin` with a \"file-like object\" " -"with output buffering. This danger is that if multiple processes call :meth:" -"`~io.IOBase.close` on this file-like object, it could result in the same " -"data being flushed to the object multiple times, resulting in corruption." +"with output buffering. This danger is that if multiple processes " +"call :meth:`~io.IOBase.close` on this file-like object, it could result in " +"the same data being flushed to the object multiple times, resulting in " +"corruption." msgstr "" msgid "" @@ -3619,8 +3647,8 @@ msgstr "" msgid "" "Bear in mind that if code run in a child process tries to access a global " "variable, then the value it sees (if any) may not be the same as the value " -"in the parent process at the time that :meth:`Process.start ` was called." +"in the parent process at the time that :meth:`Process.start " +"` was called." msgstr "" msgid "" @@ -3888,8 +3916,8 @@ msgid "" " try:\n" " print(list(pool.imap(f, list(range(10)))))\n" " except ZeroDivisionError:\n" -" print('\\tGot ZeroDivisionError as expected from list(pool." -"imap())')\n" +" print('\\tGot ZeroDivisionError as expected from " +"list(pool.imap())')\n" " else:\n" " raise AssertionError('expected ZeroDivisionError')\n" "\n" @@ -3907,8 +3935,8 @@ msgid "" " raise AssertionError('expected ZeroDivisionError')\n" "\n" " assert i == 9\n" -" print('\\tGot ZeroDivisionError as expected from IMapIterator." -"next()')\n" +" print('\\tGot ZeroDivisionError as expected from " +"IMapIterator.next()')\n" " print()\n" "\n" " #\n" diff --git a/library/multiprocessing.shared_memory.po b/library/multiprocessing.shared_memory.po index c9ee1db031..1de67e437d 100644 --- a/library/multiprocessing.shared_memory.po +++ b/library/multiprocessing.shared_memory.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,9 +36,9 @@ msgid "" "management of shared memory to be accessed by one or more processes on a " "multicore or symmetric multiprocessor (SMP) machine. To assist with the " "life-cycle management of shared memory especially across distinct processes, " -"a :class:`~multiprocessing.managers.BaseManager` subclass, :class:" -"`~multiprocessing.managers.SharedMemoryManager`, is also provided in the :" -"mod:`multiprocessing.managers` module." +"a :class:`~multiprocessing.managers.BaseManager` " +"subclass, :class:`~multiprocessing.managers.SharedMemoryManager`, is also " +"provided in the :mod:`multiprocessing.managers` module." msgstr "" msgid "" @@ -116,19 +116,21 @@ msgid "Added the *track* parameter." msgstr "" msgid "" -"Close the file descriptor/handle to the shared memory from this instance. :" -"meth:`close` should be called once access to the shared memory block from " -"this instance is no longer needed. Depending on operating system, the " -"underlying memory may or may not be freed even if all handles to it have " -"been closed. To ensure proper cleanup, use the :meth:`unlink` method." +"Close the file descriptor/handle to the shared memory from this " +"instance. :meth:`close` should be called once access to the shared memory " +"block from this instance is no longer needed. Depending on operating " +"system, the underlying memory may or may not be freed even if all handles to " +"it have been closed. To ensure proper cleanup, use the :meth:`unlink` " +"method." msgstr "" msgid "" "Delete the underlying shared memory block. This should be called only once " "per shared memory block regardless of the number of handles to it, even in " "other processes. :meth:`unlink` and :meth:`close` can be called in any " -"order, but trying to access data inside a shared memory block after :meth:" -"`unlink` may result in memory access errors, depending on platform." +"order, but trying to access data inside a shared memory block " +"after :meth:`unlink` may result in memory access errors, depending on " +"platform." msgstr "" msgid "" @@ -175,9 +177,9 @@ msgid "" msgstr "" msgid "" -"The following example demonstrates a practical use of the :class:" -"`SharedMemory` class with `NumPy arrays `_, accessing " -"the same :class:`!numpy.ndarray` from two distinct Python shells:" +"The following example demonstrates a practical use of " +"the :class:`SharedMemory` class with `NumPy arrays `_, " +"accessing the same :class:`!numpy.ndarray` from two distinct Python shells:" msgstr "" msgid "" @@ -235,19 +237,22 @@ msgid "" "SharedMemoryManager` instance causes a new process to be started. This new " "process's sole purpose is to manage the life cycle of all shared memory " "blocks created through it. To trigger the release of all shared memory " -"blocks managed by that process, call :meth:`~multiprocessing.managers." -"BaseManager.shutdown` on the instance. This triggers a :meth:" -"`~multiprocessing.shared_memory.SharedMemory.unlink` call on all of the :" -"class:`SharedMemory` objects managed by that process and then stops the " -"process itself. By creating :class:`!SharedMemory` instances through a :" -"class:`!SharedMemoryManager`, we avoid the need to manually track and " -"trigger the freeing of shared memory resources." +"blocks managed by that process, " +"call :meth:`~multiprocessing.managers.BaseManager.shutdown` on the instance. " +"This triggers a :meth:`~multiprocessing.shared_memory.SharedMemory.unlink` " +"call on all of the :class:`~multiprocessing.shared_memory.SharedMemory` " +"objects managed by that process and then stops the process itself. By " +"creating :class:`!SharedMemory` instances through a :class:`!" +"SharedMemoryManager`, we avoid the need to manually track and trigger the " +"freeing of shared memory resources." msgstr "" msgid "" -"This class provides methods for creating and returning :class:`SharedMemory` " -"instances and for creating a list-like object (:class:`ShareableList`) " -"backed by shared memory." +"This class provides methods for creating and " +"returning :class:`~multiprocessing.shared_memory.SharedMemory` instances and " +"for creating a list-like object " +"(:class:`~multiprocessing.shared_memory.ShareableList`) backed by shared " +"memory." msgstr "" msgid "" @@ -258,18 +263,19 @@ msgid "" msgstr "" msgid "" -"Create and return a new :class:`SharedMemory` object with the specified " -"*size* in bytes." +"Create and return a new :class:`~multiprocessing.shared_memory.SharedMemory` " +"object with the specified *size* in bytes." msgstr "" msgid "" -"Create and return a new :class:`ShareableList` object, initialized by the " -"values from the input *sequence*." +"Create and return a " +"new :class:`~multiprocessing.shared_memory.ShareableList` object, " +"initialized by the values from the input *sequence*." msgstr "" msgid "" -"The following example demonstrates the basic mechanisms of a :class:" -"`~multiprocessing.managers.SharedMemoryManager`:" +"The following example demonstrates the basic mechanisms of " +"a :class:`~multiprocessing.managers.SharedMemoryManager`:" msgstr "" msgid "" @@ -308,8 +314,8 @@ msgid "" msgstr "" msgid "" -"When using a :class:`~multiprocessing.managers.SharedMemoryManager` in a :" -"keyword:`with` statement, the shared memory blocks created using that " +"When using a :class:`~multiprocessing.managers.SharedMemoryManager` in " +"a :keyword:`with` statement, the shared memory blocks created using that " "manager are all released when the :keyword:`!with` statement's code block " "finishes execution." msgstr "" @@ -353,16 +359,16 @@ msgstr "" msgid "" "*name* is the unique name for the requested shared memory, as described in " -"the definition for :class:`SharedMemory`. When attaching to an existing :" -"class:`!ShareableList`, specify its shared memory block's unique name while " -"leaving *sequence* set to ``None``." +"the definition for :class:`SharedMemory`. When attaching to an " +"existing :class:`!ShareableList`, specify its shared memory block's unique " +"name while leaving *sequence* set to ``None``." msgstr "" msgid "" "A known issue exists for :class:`bytes` and :class:`str` values. If they end " "with ``\\x00`` nul bytes or characters, those may be *silently stripped* " -"when fetching them by index from the :class:`!ShareableList`. This ``." -"rstrip(b'\\x00')`` behavior is considered a bug and may go away in the " +"when fetching them by index from the :class:`!ShareableList`. This " +"``.rstrip(b'\\x00')`` behavior is considered a bug and may go away in the " "future. See :gh:`106939`." msgstr "" diff --git a/library/netrc.po b/library/netrc.po index 955cec0365..6c84568380 100644 --- a/library/netrc.po +++ b/library/netrc.po @@ -42,20 +42,20 @@ msgid "" "be read. Otherwise, a :exc:`FileNotFoundError` exception will be raised. " "Parse errors will raise :exc:`NetrcParseError` with diagnostic information " "including the file name, line number, and terminating token. If no argument " -"is specified on a POSIX system, the presence of passwords in the :file:`." -"netrc` file will raise a :exc:`NetrcParseError` if the file ownership or " -"permissions are insecure (owned by a user other than the user running the " -"process, or accessible for read or write by any other user). This implements " -"security behavior equivalent to that of ftp and other programs that use :" -"file:`.netrc`." +"is specified on a POSIX system, the presence of passwords in " +"the :file:`.netrc` file will raise a :exc:`NetrcParseError` if the file " +"ownership or permissions are insecure (owned by a user other than the user " +"running the process, or accessible for read or write by any other user). " +"This implements security behavior equivalent to that of ftp and other " +"programs that use :file:`.netrc`." msgstr "" msgid "Added the POSIX permission check." msgstr "" msgid "" -":func:`os.path.expanduser` is used to find the location of the :file:`." -"netrc` file when *file* is not passed as argument." +":func:`os.path.expanduser` is used to find the location of " +"the :file:`.netrc` file when *file* is not passed as argument." msgstr "" msgid "" @@ -70,9 +70,9 @@ msgstr "" msgid "" "Exception raised by the :class:`~netrc.netrc` class when syntactical errors " "are encountered in source text. Instances of this exception provide three " -"interesting attributes: :attr:`msg` is a textual explanation of the error, :" -"attr:`filename` is the name of the source file, and :attr:`lineno` gives the " -"line number on which the error was found." +"interesting attributes: :attr:`msg` is a textual explanation of the " +"error, :attr:`filename` is the name of the source file, and :attr:`lineno` " +"gives the line number on which the error was found." msgstr "" msgid "netrc Objects" diff --git a/library/numbers.po b/library/numbers.po index c1f80a47d9..605dc75e86 100644 --- a/library/numbers.po +++ b/library/numbers.po @@ -30,10 +30,10 @@ msgid "**Source code:** :source:`Lib/numbers.py`" msgstr "" msgid "" -"The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of numeric :term:" -"`abstract base classes ` which progressively define " -"more operations. None of the types defined in this module are intended to " -"be instantiated." +"The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of " +"numeric :term:`abstract base classes ` which " +"progressively define more operations. None of the types defined in this " +"module are intended to be instantiated." msgstr "" msgid "" @@ -46,9 +46,9 @@ msgstr "" msgid "" "Subclasses of this type describe complex numbers and include the operations " -"that work on the built-in :class:`complex` type. These are: conversions to :" -"class:`complex` and :class:`bool`, :attr:`.real`, :attr:`.imag`, ``+``, ``-" -"``, ``*``, ``/``, ``**``, :func:`abs`, :meth:`conjugate`, ``==``, and ``!" +"that work on the built-in :class:`complex` type. These are: conversions " +"to :class:`complex` and :class:`bool`, :attr:`.real`, :attr:`.imag`, ``+``, " +"``-``, ``*``, ``/``, ``**``, :func:`abs`, :meth:`conjugate`, ``==``, and ``!" "=``. All except ``-`` and ``!=`` are abstract." msgstr "" @@ -69,26 +69,27 @@ msgid "" msgstr "" msgid "" -"In short, those are: a conversion to :class:`float`, :func:`math.trunc`, :" -"func:`round`, :func:`math.floor`, :func:`math.ceil`, :func:`divmod`, ``//``, " -"``%``, ``<``, ``<=``, ``>``, and ``>=``." +"In short, those are: a conversion " +"to :class:`float`, :func:`math.trunc`, :func:`round`, :func:`math.floor`, :func:`math.ceil`, :func:`divmod`, " +"``//``, ``%``, ``<``, ``<=``, ``>``, and ``>=``." msgstr "" msgid "" -"Real also provides defaults for :func:`complex`, :attr:`~Complex.real`, :" -"attr:`~Complex.imag`, and :meth:`~Complex.conjugate`." +"Real also provides defaults " +"for :func:`complex`, :attr:`~Complex.real`, :attr:`~Complex.imag`, " +"and :meth:`~Complex.conjugate`." msgstr "" msgid "" -"Subtypes :class:`Real` and adds :attr:`~Rational.numerator` and :attr:" -"`~Rational.denominator` properties. It also provides a default for :func:" -"`float`." +"Subtypes :class:`Real` and adds :attr:`~Rational.numerator` " +"and :attr:`~Rational.denominator` properties. It also provides a default " +"for :func:`float`." msgstr "" msgid "" "The :attr:`~Rational.numerator` and :attr:`~Rational.denominator` values " -"should be instances of :class:`Integral` and should be in lowest terms with :" -"attr:`~Rational.denominator` positive." +"should be instances of :class:`Integral` and should be in lowest terms " +"with :attr:`~Rational.denominator` positive." msgstr "" msgid "Abstract." @@ -96,9 +97,10 @@ msgstr "" msgid "" "Subtypes :class:`Rational` and adds a conversion to :class:`int`. Provides " -"defaults for :func:`float`, :attr:`~Rational.numerator`, and :attr:" -"`~Rational.denominator`. Adds abstract methods for :func:`pow` with modulus " -"and bit-string operations: ``<<``, ``>>``, ``&``, ``^``, ``|``, ``~``." +"defaults for :func:`float`, :attr:`~Rational.numerator`, " +"and :attr:`~Rational.denominator`. Adds abstract methods for :func:`pow` " +"with modulus and bit-string operations: ``<<``, ``>>``, ``&``, ``^``, ``|``, " +"``~``." msgstr "" msgid "Notes for type implementors" @@ -107,8 +109,8 @@ msgstr "" msgid "" "Implementors should be careful to make equal numbers equal and hash them to " "the same values. This may be subtle if there are two different extensions of " -"the real numbers. For example, :class:`fractions.Fraction` implements :func:" -"`hash` as follows::" +"the real numbers. For example, :class:`fractions.Fraction` " +"implements :func:`hash` as follows::" msgstr "" msgid "Adding More Numeric ABCs" @@ -132,10 +134,10 @@ msgid "" msgstr "" msgid "" -"There are 5 different cases for a mixed-type operation on subclasses of :" -"class:`Complex`. I'll refer to all of the above code that doesn't refer to " -"``MyIntegral`` and ``OtherTypeIKnowAbout`` as \"boilerplate\". ``a`` will be " -"an instance of ``A``, which is a subtype of :class:`Complex` (``a : A <: " +"There are 5 different cases for a mixed-type operation on subclasses " +"of :class:`Complex`. I'll refer to all of the above code that doesn't refer " +"to ``MyIntegral`` and ``OtherTypeIKnowAbout`` as \"boilerplate\". ``a`` will " +"be an instance of ``A``, which is a subtype of :class:`Complex` (``a : A <: " "Complex``), and ``b : B <: Complex``. I'll consider ``a + b``:" msgstr "" @@ -145,9 +147,9 @@ msgstr "" msgid "" "If ``A`` falls back to the boilerplate code, and it were to return a value " "from :meth:`__add__`, we'd miss the possibility that ``B`` defines a more " -"intelligent :meth:`__radd__`, so the boilerplate should return :const:" -"`NotImplemented` from :meth:`__add__`. (Or ``A`` may not implement :meth:" -"`__add__` at all.)" +"intelligent :meth:`__radd__`, so the boilerplate should " +"return :const:`NotImplemented` from :meth:`__add__`. (Or ``A`` may not " +"implement :meth:`__add__` at all.)" msgstr "" msgid "" @@ -168,13 +170,14 @@ msgstr "" msgid "" "If ``A <: Complex`` and ``B <: Real`` without sharing any other knowledge, " -"then the appropriate shared operation is the one involving the built in :" -"class:`complex`, and both :meth:`__radd__` s land there, so ``a+b == b+a``." +"then the appropriate shared operation is the one involving the built " +"in :class:`complex`, and both :meth:`__radd__` s land there, so ``a+b == " +"b+a``." msgstr "" msgid "" "Because most of the operations on any given type will be very similar, it " "can be useful to define a helper function which generates the forward and " -"reverse instances of any given operator. For example, :class:`fractions." -"Fraction` uses::" +"reverse instances of any given operator. For " +"example, :class:`fractions.Fraction` uses::" msgstr "" diff --git a/library/numeric.po b/library/numeric.po index 176caa5bd2..0f0b4b6e80 100644 --- a/library/numeric.po +++ b/library/numeric.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,8 +30,8 @@ msgid "" "The modules described in this chapter provide numeric and math-related " "functions and data types. The :mod:`numbers` module defines an abstract " "hierarchy of numeric types. The :mod:`math` and :mod:`cmath` modules contain " -"various mathematical functions for floating-point and complex numbers. The :" -"mod:`decimal` module supports exact representations of decimal numbers, " +"various mathematical functions for floating-point and complex numbers. " +"The :mod:`decimal` module supports exact representations of decimal numbers, " "using arbitrary precision arithmetic." msgstr "" diff --git a/library/operator.po b/library/operator.po index 34f6f4f301..7878b94545 100644 --- a/library/operator.po +++ b/library/operator.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,12 +31,12 @@ msgstr "**Kod źródłowy:** :source:`Lib/operator.py`" msgid "" "The :mod:`!operator` module exports a set of efficient functions " -"corresponding to the intrinsic operators of Python. For example, ``operator." -"add(x, y)`` is equivalent to the expression ``x+y``. Many function names are " -"those used for special methods, without the double underscores. For " -"backward compatibility, many of these have a variant with the double " -"underscores kept. The variants without the double underscores are preferred " -"for clarity." +"corresponding to the intrinsic operators of Python. For example, " +"``operator.add(x, y)`` is equivalent to the expression ``x+y``. Many " +"function names are those used for special methods, without the double " +"underscores. For backward compatibility, many of these have a variant with " +"the double underscores kept. The variants without the double underscores are " +"preferred for clarity." msgstr "" msgid "" @@ -55,8 +55,8 @@ msgid "" "``eq(a, b)`` is equivalent to ``a == b``, ``ne(a, b)`` is equivalent to ``a !" "= b``, ``gt(a, b)`` is equivalent to ``a > b`` and ``ge(a, b)`` is " "equivalent to ``a >= b``. Note that these functions can return any value, " -"which may or may not be interpretable as a Boolean value. See :ref:" -"`comparisons` for more information about rich comparisons." +"which may or may not be interpretable as a Boolean value. " +"See :ref:`comparisons` for more information about rich comparisons." msgstr "" msgid "" @@ -67,8 +67,8 @@ msgstr "" msgid "" "Return the outcome of :keyword:`not` *obj*. (Note that there is no :meth:`!" "__not__` method for object instances; only the interpreter core defines this " -"operation. The result is affected by the :meth:`~object.__bool__` and :meth:" -"`~object.__len__` methods.)" +"operation. The result is affected by the :meth:`~object.__bool__` " +"and :meth:`~object.__len__` methods.)" msgstr "" msgid "" @@ -97,7 +97,7 @@ msgstr "" msgid "Return ``a + b``, for *a* and *b* numbers." msgstr "" -msgid "Return the bitwise and of *a* and *b*." +msgid "Return ``a & b``." msgstr "" msgid "Return ``a // b``." @@ -111,18 +111,16 @@ msgid "" "have been an instance of a subclass of ``int``." msgstr "" -msgid "" -"Return the bitwise inverse of the number *obj*. This is equivalent to " -"``~obj``." +msgid "Return ``~obj``." msgstr "" -msgid "Return *a* shifted left by *b*." +msgid "Return ``a << b``." msgstr "" msgid "Return ``a % b``." msgstr "" -msgid "Return ``a * b``, for *a* and *b* numbers." +msgid "Return ``a * b``." msgstr "" msgid "Return ``a @ b``." @@ -131,16 +129,16 @@ msgstr "" msgid "Return *obj* negated (``-obj``)." msgstr "" -msgid "Return the bitwise or of *a* and *b*." +msgid "Return ``a | b``." msgstr "" -msgid "Return *obj* positive (``+obj``)." +msgid "Return ``+obj``." msgstr "" -msgid "Return ``a ** b``, for *a* and *b* numbers." +msgid "Return ``a ** b``." msgstr "" -msgid "Return *a* shifted right by *b*." +msgid "Return ``a >> b``." msgstr "" msgid "Return ``a - b``." @@ -151,7 +149,7 @@ msgid "" "\"true\" division." msgstr "" -msgid "Return the bitwise exclusive or of *a* and *b*." +msgid "Return ``a ^ b``." msgstr "" msgid "" @@ -209,8 +207,8 @@ msgid "After ``f = attrgetter('name')``, the call ``f(b)`` returns ``b.name``." msgstr "" msgid "" -"After ``f = attrgetter('name', 'date')``, the call ``f(b)`` returns ``(b." -"name, b.date)``." +"After ``f = attrgetter('name', 'date')``, the call ``f(b)`` returns " +"``(b.name, b.date)``." msgstr "" msgid "" @@ -267,9 +265,10 @@ msgid "" msgstr "" msgid "" -"The items can be any type accepted by the operand's :meth:`~object." -"__getitem__` method. Dictionaries accept any :term:`hashable` value. " -"Lists, tuples, and strings accept an index or a slice:" +"The items can be any type accepted by the " +"operand's :meth:`~object.__getitem__` method. Dictionaries accept " +"any :term:`hashable` value. Lists, tuples, and strings accept an index or a " +"slice:" msgstr "" msgid "" @@ -358,7 +357,7 @@ msgstr "``a // b``" msgid "``floordiv(a, b)``" msgstr "``floordiv(a, b)``" -msgid "Bitwise And" +msgid "Bitwise And, or Intersection" msgstr "" msgid "``a & b``" @@ -367,7 +366,7 @@ msgstr "``a & b``" msgid "``and_(a, b)``" msgstr "``and_(a, b)``" -msgid "Bitwise Exclusive Or" +msgid "Bitwise Exclusive Or, or Symmetric Difference" msgstr "" msgid "``a ^ b``" @@ -376,7 +375,7 @@ msgstr "``a ^ b``" msgid "``xor(a, b)``" msgstr "``xor(a, b)``" -msgid "Bitwise Inversion" +msgid "Bitwise Inversion, or Complement" msgstr "" msgid "``~ a``" @@ -385,7 +384,7 @@ msgstr "``~ a``" msgid "``invert(a)``" msgstr "``invert(a)``" -msgid "Bitwise Or" +msgid "Bitwise Or, or Union" msgstr "" msgid "``a | b``" diff --git a/library/optparse.po b/library/optparse.po index a08bfdb48c..45e06c3a7a 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,31 +36,26 @@ msgid "The standard library includes three argument parsing libraries:" msgstr "" msgid "" -":mod:`getopt`: a module that closely mirrors the procedural C ``getopt`` " -"API. Included in the standard library since before the initial Python 1.0 " -"release." +":mod:`getopt`: a module that closely mirrors the procedural C ``getopt`` API." msgstr "" msgid "" ":mod:`!optparse`: a declarative replacement for ``getopt`` that provides " "equivalent functionality without requiring each application to implement its " -"own procedural option parsing logic. Included in the standard library since " -"the Python 2.3 release." +"own procedural option parsing logic." msgstr "" msgid "" ":mod:`argparse`: a more opinionated alternative to ``optparse`` that " "provides more functionality by default, at the expense of reduced " -"application flexibility in controlling exactly how arguments are processed. " -"Included in the standard library since the Python 2.7 and Python 3.2 " -"releases." +"application flexibility in controlling exactly how arguments are processed." msgstr "" msgid "" -"In the absence of more specific argument parsing design constraints, :mod:" -"`argparse` is the recommended choice for implementing command line " -"applications, as it offers the highest level of baseline functionality with " -"the least application level code." +"In the absence of more specific argument parsing design " +"constraints, :mod:`argparse` is the recommended choice for implementing " +"command line applications, as it offers the highest level of baseline " +"functionality with the least application level code." msgstr "" msgid "" @@ -77,8 +72,8 @@ msgstr "" msgid "" "an application is already using :mod:`!optparse` and doesn't want to risk " -"the subtle behavioural changes that may arise when migrating to :mod:" -"`argparse`" +"the subtle behavioural changes that may arise when migrating " +"to :mod:`argparse`" msgstr "" msgid "" @@ -197,12 +192,12 @@ msgstr "Wprowadzenie" msgid "" ":mod:`!optparse` is a more convenient, flexible, and powerful library for " -"parsing command-line options than the minimalist :mod:`getopt` module. :mod:" -"`!optparse` uses a more declarative style of command-line parsing: you " -"create an instance of :class:`OptionParser`, populate it with options, and " -"parse the command line. :mod:`!optparse` allows users to specify options in " -"the conventional GNU/POSIX syntax, and additionally generates usage and help " -"messages for you." +"parsing command-line options than the minimalist :mod:`getopt` " +"module. :mod:`!optparse` uses a more declarative style of command-line " +"parsing: you create an instance of :class:`OptionParser`, populate it with " +"options, and parse the command line. :mod:`!optparse` allows users to " +"specify options in the conventional GNU/POSIX syntax, and additionally " +"generates usage and help messages for you." msgstr "" msgid "Here's an example of using :mod:`!optparse` in a simple script::" @@ -301,10 +296,10 @@ msgid "" msgstr "" msgid "" -"It is occasionally desirable to substitute an argument list other than ``sys." -"argv[1:]``, so you should read \"argument\" as \"an element of ``sys." -"argv[1:]``, or of some other list provided as a substitute for ``sys." -"argv[1:]``\"." +"It is occasionally desirable to substitute an argument list other than " +"``sys.argv[1:]``, so you should read \"argument\" as \"an element of " +"``sys.argv[1:]``, or of some other list provided as a substitute for " +"``sys.argv[1:]``\"." msgstr "" msgid "option" @@ -313,10 +308,10 @@ msgstr "" msgid "" "an argument used to supply extra information to guide or customize the " "execution of a program. There are many different syntaxes for options; the " -"traditional Unix syntax is a hyphen (\"-\") followed by a single letter, e." -"g. ``-x`` or ``-F``. Also, traditional Unix syntax allows multiple options " -"to be merged into a single argument, e.g. ``-x -F`` is equivalent to ``-" -"xF``. The GNU project introduced ``--`` followed by a series of hyphen-" +"traditional Unix syntax is a hyphen (\"-\") followed by a single letter, " +"e.g. ``-x`` or ``-F``. Also, traditional Unix syntax allows multiple " +"options to be merged into a single argument, e.g. ``-x -F`` is equivalent to " +"``-xF``. The GNU project introduced ``--`` followed by a series of hyphen-" "separated words, e.g. ``--file`` or ``--dry-run``. These are the only two " "option syntaxes provided by :mod:`!optparse`." msgstr "" @@ -553,9 +548,9 @@ msgid "(options, args) = parser.parse_args()" msgstr "" msgid "" -"(If you like, you can pass a custom argument list to :meth:`~OptionParser." -"parse_args`, but that's rarely necessary: by default it uses ``sys." -"argv[1:]``.)" +"(If you like, you can pass a custom argument list " +"to :meth:`~OptionParser.parse_args`, but that's rarely necessary: by default " +"it uses ``sys.argv[1:]``.)" msgstr "" msgid ":meth:`~OptionParser.parse_args` returns two values:" @@ -574,9 +569,9 @@ msgstr "" msgid "" "This tutorial section only covers the four most important option " -"attributes: :attr:`~Option.action`, :attr:`~Option.type`, :attr:`~Option." -"dest` (destination), and :attr:`~Option.help`. Of these, :attr:`~Option." -"action` is the most fundamental." +"attributes: :attr:`~Option.action`, :attr:`~Option.type`, :attr:`~Option.dest` " +"(destination), and :attr:`~Option.help`. Of these, :attr:`~Option.action` is " +"the most fundamental." msgstr "" msgid "Understanding option actions" @@ -585,10 +580,10 @@ msgstr "" msgid "" "Actions tell :mod:`!optparse` what to do when it encounters an option on the " "command line. There is a fixed set of actions hard-coded into :mod:`!" -"optparse`; adding new actions is an advanced topic covered in section :ref:" -"`optparse-extending-optparse`. Most actions tell :mod:`!optparse` to store " -"a value in some variable---for example, take a string from the command line " -"and store it in an attribute of ``options``." +"optparse`; adding new actions is an advanced topic covered in " +"section :ref:`optparse-extending-optparse`. Most actions tell :mod:`!" +"optparse` to store a value in some variable---for example, take a string " +"from the command line and store it in an attribute of ``options``." msgstr "" msgid "" @@ -701,8 +696,8 @@ msgstr "" msgid "" "When :mod:`!optparse` encounters ``-v`` on the command line, it sets " -"``options.verbose`` to ``True``; when it encounters ``-q``, ``options." -"verbose`` is set to ``False``." +"``options.verbose`` to ``True``; when it encounters ``-q``, " +"``options.verbose`` is set to ``False``." msgstr "" msgid "Other actions" @@ -736,8 +731,8 @@ msgid "call a specified function" msgstr "" msgid "" -"These are covered in section :ref:`optparse-reference-guide`, and section :" -"ref:`optparse-option-callbacks`." +"These are covered in section :ref:`optparse-reference-guide`, and " +"section :ref:`optparse-option-callbacks`." msgstr "" msgid "Default values" @@ -792,8 +787,8 @@ msgstr "" msgid "" "A clearer way to specify default values is the :meth:`set_defaults` method " -"of OptionParser, which you can call at any time before calling :meth:" -"`~OptionParser.parse_args`::" +"of OptionParser, which you can call at any time before " +"calling :meth:`~OptionParser.parse_args`::" msgstr "" msgid "" @@ -951,19 +946,20 @@ msgid "description, optional, is a long description of the group" msgstr "" msgid "" -":class:`OptionGroup` inherits from :class:`OptionContainer` (like :class:" -"`OptionParser`) and so the :meth:`add_option` method can be used to add an " -"option to the group." +":class:`OptionGroup` inherits from :class:`OptionContainer` " +"(like :class:`OptionParser`) and so the :meth:`add_option` method can be " +"used to add an option to the group." msgstr "" msgid "" -"Once all the options are declared, using the :class:`OptionParser` method :" -"meth:`add_option_group` the group is added to the previously defined parser." +"Once all the options are declared, using the :class:`OptionParser` " +"method :meth:`add_option_group` the group is added to the previously defined " +"parser." msgstr "" msgid "" -"Continuing with the parser defined in the previous section, adding an :class:" -"`OptionGroup` to a parser is easy::" +"Continuing with the parser defined in the previous section, adding " +"an :class:`OptionGroup` to a parser is easy::" msgstr "" msgid "" @@ -1052,8 +1048,8 @@ msgstr "" msgid "" "Return the :class:`OptionGroup` to which the short or long option string " -"*opt_str* (e.g. ``'-o'`` or ``'--option'``) belongs. If there's no such :" -"class:`OptionGroup`, return ``None``." +"*opt_str* (e.g. ``'-o'`` or ``'--option'``) belongs. If there's no " +"such :class:`OptionGroup`, return ``None``." msgstr "" msgid "Printing a version string" @@ -1112,8 +1108,9 @@ msgid "" "about: programmer errors and user errors. Programmer errors are usually " "erroneous calls to :func:`OptionParser.add_option`, e.g. invalid option " "strings, unknown option attributes, missing option attributes, etc. These " -"are dealt with in the usual way: raise an exception (either :exc:`optparse." -"OptionError` or :exc:`TypeError`) and let the program crash." +"are dealt with in the usual way: raise an exception " +"(either :exc:`optparse.OptionError` or :exc:`TypeError`) and let the program " +"crash." msgstr "" msgid "" @@ -1167,14 +1164,14 @@ msgstr "" msgid "" ":mod:`!optparse`\\ -generated error messages take care always to mention the " -"option involved in the error; be sure to do the same when calling :func:" -"`OptionParser.error` from your application code." +"option involved in the error; be sure to do the same when " +"calling :func:`OptionParser.error` from your application code." msgstr "" msgid "" "If :mod:`!optparse`'s default error-handling behaviour does not suit your " -"needs, you'll need to subclass OptionParser and override its :meth:" -"`~OptionParser.exit` and/or :meth:`~OptionParser.error` methods." +"needs, you'll need to subclass OptionParser and override " +"its :meth:`~OptionParser.exit` and/or :meth:`~OptionParser.error` methods." msgstr "" msgid "Putting it all together" @@ -1316,8 +1313,9 @@ msgstr "" msgid "" "There are several ways to populate the parser with options. The preferred " -"way is by using :meth:`OptionParser.add_option`, as shown in section :ref:" -"`optparse-tutorial`. :meth:`add_option` can be called in one of two ways:" +"way is by using :meth:`OptionParser.add_option`, as shown in " +"section :ref:`optparse-tutorial`. :meth:`add_option` can be called in one " +"of two ways:" msgstr "" msgid "pass it an Option instance (as returned by :func:`make_option`)" @@ -1346,10 +1344,10 @@ msgstr "" msgid "" "(:func:`make_option` is a factory function for creating Option instances; " -"currently it is an alias for the Option constructor. A future version of :" -"mod:`!optparse` may split Option into several classes, and :func:" -"`make_option` will pick the right class to instantiate. Do not instantiate " -"Option directly.)" +"currently it is an alias for the Option constructor. A future version " +"of :mod:`!optparse` may split Option into several classes, " +"and :func:`make_option` will pick the right class to instantiate. Do not " +"instantiate Option directly.)" msgstr "" msgid "Defining options" @@ -1362,8 +1360,8 @@ msgid "" msgstr "" msgid "" -"The canonical way to create an :class:`Option` instance is with the :meth:" -"`add_option` method of :class:`OptionParser`." +"The canonical way to create an :class:`Option` instance is with " +"the :meth:`add_option` method of :class:`OptionParser`." msgstr "" msgid "To define an option with only a short option string::" @@ -1430,16 +1428,17 @@ msgid "" msgstr "" msgid "" -"As you can see, most actions involve storing or updating a value somewhere. :" -"mod:`!optparse` always creates a special object for this, conventionally " -"called ``options``, which is an instance of :class:`optparse.Values`." +"As you can see, most actions involve storing or updating a value " +"somewhere. :mod:`!optparse` always creates a special object for this, " +"conventionally called ``options``, which is an instance " +"of :class:`optparse.Values`." msgstr "" msgid "" "An object holding parsed argument names and values as attributes. Normally " "created by calling when calling :meth:`OptionParser.parse_args`, and can be " -"overridden by a custom subclass passed to the *values* argument of :meth:" -"`OptionParser.parse_args` (as described in :ref:`optparse-parsing-" +"overridden by a custom subclass passed to the *values* argument " +"of :meth:`OptionParser.parse_args` (as described in :ref:`optparse-parsing-" "arguments`)." msgstr "" @@ -1504,9 +1503,9 @@ msgid "" msgstr "" msgid "" -"The following option attributes may be passed as keyword arguments to :meth:" -"`OptionParser.add_option`. If you pass an option attribute that is not " -"relevant to a particular option, or fail to pass a required option " +"The following option attributes may be passed as keyword arguments " +"to :meth:`OptionParser.add_option`. If you pass an option attribute that is " +"not relevant to a particular option, or fail to pass a required option " "attribute, :mod:`!optparse` raises :exc:`OptionError`." msgstr "" @@ -1548,8 +1547,8 @@ msgstr "" msgid "" "How many arguments of type :attr:`~Option.type` should be consumed when this " -"option is seen. If > 1, :mod:`!optparse` will store a tuple of values to :" -"attr:`~Option.dest`." +"option is seen. If > 1, :mod:`!optparse` will store a tuple of values " +"to :attr:`~Option.dest`." msgstr "" msgid "For actions that store a constant value, the constant value to store." @@ -1594,14 +1593,14 @@ msgid "" msgstr "" msgid "" -"``\"store\"`` [relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:" -"`~Option.nargs`, :attr:`~Option.choices`]" +"``\"store\"`` " +"[relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:`~Option.nargs`, :attr:`~Option.choices`]" msgstr "" msgid "" "The option must be followed by an argument, which is converted to a value " -"according to :attr:`~Option.type` and stored in :attr:`~Option.dest`. If :" -"attr:`~Option.nargs` > 1, multiple arguments will be consumed from the " +"according to :attr:`~Option.type` and stored in :attr:`~Option.dest`. " +"If :attr:`~Option.nargs` > 1, multiple arguments will be consumed from the " "command line; all will be converted according to :attr:`~Option.type` and " "stored to :attr:`~Option.dest` as a tuple. See the :ref:`optparse-standard-" "option-types` section." @@ -1647,8 +1646,8 @@ msgid "" msgstr "" msgid "" -"``\"store_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" -"`~Option.dest`]" +"``\"store_const\"`` [required: :attr:`~Option.const`; " +"relevant: :attr:`~Option.dest`]" msgstr "" msgid "The value :attr:`~Option.const` is stored in :attr:`~Option.dest`." @@ -1673,8 +1672,8 @@ msgid "``\"store_true\"`` [relevant: :attr:`~Option.dest`]" msgstr "" msgid "" -"A special case of ``\"store_const\"`` that stores ``True`` to :attr:`~Option." -"dest`." +"A special case of ``\"store_const\"`` that stores ``True`` " +"to :attr:`~Option.dest`." msgstr "" msgid "``\"store_false\"`` [relevant: :attr:`~Option.dest`]" @@ -1689,8 +1688,8 @@ msgid "" msgstr "" msgid "" -"``\"append\"`` [relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:" -"`~Option.nargs`, :attr:`~Option.choices`]" +"``\"append\"`` " +"[relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:`~Option.nargs`, :attr:`~Option.choices`]" msgstr "" msgid "" @@ -1744,8 +1743,8 @@ msgid "" msgstr "" msgid "" -"``\"append_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" -"`~Option.dest`]" +"``\"append_const\"`` [required: :attr:`~Option.const`; " +"relevant: :attr:`~Option.dest`]" msgstr "" msgid "" @@ -1784,9 +1783,8 @@ msgid "options.verbosity += 1" msgstr "" msgid "" -"``\"callback\"`` [required: :attr:`~Option.callback`; relevant: :attr:" -"`~Option.type`, :attr:`~Option.nargs`, :attr:`~Option.callback_args`, :attr:" -"`~Option.callback_kwargs`]" +"``\"callback\"`` [required: :attr:`~Option.callback`; " +"relevant: :attr:`~Option.type`, :attr:`~Option.nargs`, :attr:`~Option.callback_args`, :attr:`~Option.callback_kwargs`]" msgstr "" msgid "" @@ -1860,9 +1858,9 @@ msgid "" "Prints the version number supplied to the OptionParser to stdout and exits. " "The version number is actually formatted and printed by the " "``print_version()`` method of OptionParser. Generally only relevant if the " -"``version`` argument is supplied to the OptionParser constructor. As with :" -"attr:`~Option.help` options, you will rarely create ``version`` options, " -"since :mod:`!optparse` automatically adds them when needed." +"``version`` argument is supplied to the OptionParser constructor. As " +"with :attr:`~Option.help` options, you will rarely create ``version`` " +"options, since :mod:`!optparse` automatically adds them when needed." msgstr "" msgid "Standard option types" @@ -1907,19 +1905,19 @@ msgid "" msgstr "" msgid "" -"``\"choice\"`` options are a subtype of ``\"string\"`` options. The :attr:" -"`~Option.choices` option attribute (a sequence of strings) defines the set " -"of allowed option arguments. :func:`optparse.check_choice` compares user-" -"supplied option arguments against this master list and raises :exc:" -"`OptionValueError` if an invalid string is given." +"``\"choice\"`` options are a subtype of ``\"string\"`` options. " +"The :attr:`~Option.choices` option attribute (a sequence of strings) defines " +"the set of allowed option arguments. :func:`optparse.check_choice` compares " +"user-supplied option arguments against this master list and " +"raises :exc:`OptionValueError` if an invalid string is given." msgstr "" msgid "Parsing arguments" msgstr "Parsowanie argumentów" msgid "" -"The whole point of creating and populating an OptionParser is to call its :" -"meth:`~OptionParser.parse_args` method." +"The whole point of creating and populating an OptionParser is to call " +"its :meth:`~OptionParser.parse_args` method." msgstr "" msgid "Parse the command-line options found in *args*." @@ -2071,8 +2069,8 @@ msgid "``\"error\"`` (default)" msgstr "``\"error\"`` (default)" msgid "" -"assume option conflicts are a programming error and raise :exc:" -"`OptionConflictError`" +"assume option conflicts are a programming error and " +"raise :exc:`OptionConflictError`" msgstr "" msgid "``\"resolve\"``" @@ -2159,8 +2157,8 @@ msgstr "" msgid "" "Print the usage message for the current program (``self.usage``) to *file* " "(default stdout). Any occurrence of the string ``%prog`` in ``self.usage`` " -"is replaced with the name of the current program. Does nothing if ``self." -"usage`` is empty or not defined." +"is replaced with the name of the current program. Does nothing if " +"``self.usage`` is empty or not defined." msgstr "" msgid "" @@ -2169,11 +2167,11 @@ msgid "" msgstr "" msgid "" -"Set default values for several option destinations at once. Using :meth:" -"`set_defaults` is the preferred way to set default values for options, since " -"multiple options can share the same destination. For example, if several " -"\"mode\" options all set the same destination, any one of them can set the " -"default, and the last one wins::" +"Set default values for several option destinations at once. " +"Using :meth:`set_defaults` is the preferred way to set default values for " +"options, since multiple options can share the same destination. For " +"example, if several \"mode\" options all set the same destination, any one " +"of them can set the default, and the last one wins::" msgstr "" msgid "" @@ -2221,10 +2219,10 @@ msgid "Defining a callback option" msgstr "" msgid "" -"As always, the easiest way to define a callback option is by using the :meth:" -"`OptionParser.add_option` method. Apart from :attr:`~Option.action`, the " -"only option attribute you must specify is ``callback``, the function to " -"call::" +"As always, the easiest way to define a callback option is by using " +"the :meth:`OptionParser.add_option` method. Apart " +"from :attr:`~Option.action`, the only option attribute you must specify is " +"``callback``, the function to call::" msgstr "" msgid "parser.add_option(\"-c\", action=\"callback\", callback=my_callback)" @@ -2243,9 +2241,9 @@ msgstr "" msgid "" ":mod:`!optparse` always passes four particular arguments to your callback, " -"and it will only pass additional arguments if you specify them via :attr:" -"`~Option.callback_args` and :attr:`~Option.callback_kwargs`. Thus, the " -"minimal callback function signature is::" +"and it will only pass additional arguments if you specify them " +"via :attr:`~Option.callback_args` and :attr:`~Option.callback_kwargs`. " +"Thus, the minimal callback function signature is::" msgstr "" msgid "def my_callback(option, opt, value, parser):" @@ -2264,9 +2262,9 @@ msgstr ":attr:`~Option.type`" msgid "" "has its usual meaning: as with the ``\"store\"`` or ``\"append\"`` actions, " -"it instructs :mod:`!optparse` to consume one argument and convert it to :" -"attr:`~Option.type`. Rather than storing the converted value(s) anywhere, " -"though, :mod:`!optparse` passes it to your callback function." +"it instructs :mod:`!optparse` to consume one argument and convert it " +"to :attr:`~Option.type`. Rather than storing the converted value(s) " +"anywhere, though, :mod:`!optparse` passes it to your callback function." msgstr "" msgid ":attr:`~Option.nargs`" @@ -2320,10 +2318,10 @@ msgstr "" msgid "" "is the argument to this option seen on the command-line. :mod:`!optparse` " "will only expect an argument if :attr:`~Option.type` is set; the type of " -"``value`` will be the type implied by the option's type. If :attr:`~Option." -"type` for this option is ``None`` (no argument expected), then ``value`` " -"will be ``None``. If :attr:`~Option.nargs` > 1, ``value`` will be a tuple " -"of values of the appropriate type." +"``value`` will be the type implied by the option's type. " +"If :attr:`~Option.type` for this option is ``None`` (no argument expected), " +"then ``value`` will be ``None``. If :attr:`~Option.nargs` > 1, ``value`` " +"will be a tuple of values of the appropriate type." msgstr "" msgid "``parser``" @@ -2341,8 +2339,8 @@ msgid "" "the current list of leftover arguments, ie. arguments that have been " "consumed but are neither options nor option arguments. Feel free to modify " "``parser.largs``, e.g. by adding more arguments to it. (This list will " -"become ``args``, the second return value of :meth:`~OptionParser." -"parse_args`.)" +"become ``args``, the second return value " +"of :meth:`~OptionParser.parse_args`.)" msgstr "" msgid "``parser.rargs``" @@ -2366,16 +2364,16 @@ msgid "" msgstr "" msgid "" -"is a tuple of arbitrary positional arguments supplied via the :attr:`~Option." -"callback_args` option attribute." +"is a tuple of arbitrary positional arguments supplied via " +"the :attr:`~Option.callback_args` option attribute." msgstr "" msgid "``kwargs``" msgstr "``kwargs``" msgid "" -"is a dictionary of arbitrary keyword arguments supplied via :attr:`~Option." -"callback_kwargs`." +"is a dictionary of arbitrary keyword arguments supplied " +"via :attr:`~Option.callback_kwargs`." msgstr "" msgid "Raising errors in a callback" @@ -2481,8 +2479,9 @@ msgid "" "take a fixed number of arguments. Specifying that a callback option takes " "arguments is similar to defining a ``\"store\"`` or ``\"append\"`` option: " "if you define :attr:`~Option.type`, then the option takes one argument that " -"must be convertible to that type; if you further define :attr:`~Option." -"nargs`, then the option takes :attr:`~Option.nargs` arguments." +"must be convertible to that type; if you further " +"define :attr:`~Option.nargs`, then the option takes :attr:`~Option.nargs` " +"arguments." msgstr "" msgid "" @@ -2586,13 +2585,13 @@ msgstr "" msgid "" "To add new types, you need to define your own subclass of :mod:`!" "optparse`'s :class:`Option` class. This class has a couple of attributes " -"that define :mod:`!optparse`'s types: :attr:`~Option.TYPES` and :attr:" -"`~Option.TYPE_CHECKER`." +"that define :mod:`!optparse`'s types: :attr:`~Option.TYPES` " +"and :attr:`~Option.TYPE_CHECKER`." msgstr "" msgid "" -"A tuple of type names; in your subclass, simply define a new tuple :attr:" -"`TYPES` that builds on the standard one." +"A tuple of type names; in your subclass, simply define a new " +"tuple :attr:`TYPES` that builds on the standard one." msgstr "" msgid "" @@ -2661,8 +2660,8 @@ msgid "" msgstr "" msgid "" -"(If we didn't make a :func:`copy` of :attr:`Option.TYPE_CHECKER`, we would " -"end up modifying the :attr:`~Option.TYPE_CHECKER` attribute of :mod:`!" +"(If we didn't make a :func:`~copy.copy` of :attr:`Option.TYPE_CHECKER`, we " +"would end up modifying the :attr:`~Option.TYPE_CHECKER` attribute of :mod:`!" "optparse`'s Option class. This being Python, nothing stops you from doing " "that except good manners and common sense.)" msgstr "" @@ -2694,8 +2693,8 @@ msgid "Adding new actions" msgstr "" msgid "" -"Adding new actions is a bit trickier, because you have to understand that :" -"mod:`!optparse` has a couple of classifications for actions:" +"Adding new actions is a bit trickier, because you have to understand " +"that :mod:`!optparse` has a couple of classifications for actions:" msgstr "" msgid "\"store\" actions" @@ -2703,8 +2702,8 @@ msgstr "" msgid "" "actions that result in :mod:`!optparse` storing a value to an attribute of " -"the current OptionValues instance; these options require a :attr:`~Option." -"dest` attribute to be supplied to the Option constructor." +"the current OptionValues instance; these options require " +"a :attr:`~Option.dest` attribute to be supplied to the Option constructor." msgstr "" msgid "\"typed\" actions" @@ -2746,8 +2745,9 @@ msgid "" msgstr "" msgid "" -"In order to actually implement your new action, you must override Option's :" -"meth:`take_action` method and add a case that recognizes your action." +"In order to actually implement your new action, you must override " +"Option's :meth:`take_action` method and add a case that recognizes your " +"action." msgstr "" msgid "" @@ -2793,14 +2793,14 @@ msgstr "" msgid "" "``\"extend\"`` both expects a value on the command-line and stores that " -"value somewhere, so it goes in both :attr:`~Option.STORE_ACTIONS` and :attr:" -"`~Option.TYPED_ACTIONS`." +"value somewhere, so it goes in both :attr:`~Option.STORE_ACTIONS` " +"and :attr:`~Option.TYPED_ACTIONS`." msgstr "" msgid "" "to ensure that :mod:`!optparse` assigns the default type of ``\"string\"`` " -"to ``\"extend\"`` actions, we put the ``\"extend\"`` action in :attr:" -"`~Option.ALWAYS_TYPED_ACTIONS` as well." +"to ``\"extend\"`` actions, we put the ``\"extend\"`` action " +"in :attr:`~Option.ALWAYS_TYPED_ACTIONS` as well." msgstr "" msgid "" @@ -2826,8 +2826,8 @@ msgid "" "variable to be of a certain type (a list for the first two, an integer for " "the latter). Using :meth:`ensure_value` means that scripts using your " "action don't have to worry about setting a default value for the option " -"destinations in question; they can just leave the default as ``None`` and :" -"meth:`ensure_value` will take care of getting it right when it's needed." +"destinations in question; they can just leave the default as ``None`` " +"and :meth:`ensure_value` will take care of getting it right when it's needed." msgstr "" msgid "Exceptions" diff --git a/library/os.path.po b/library/os.path.po index b7e721e8c4..c0e58bd1b0 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -56,12 +56,12 @@ msgstr "" msgid "" "Since different operating systems have different path name conventions, " -"there are several versions of this module in the standard library. The :mod:" -"`!os.path` module is always the path module suitable for the operating " -"system Python is running on, and therefore usable for local paths. However, " -"you can also import and use the individual modules if you want to manipulate " -"a path that is *always* in one of the different formats. They all have the " -"same interface:" +"there are several versions of this module in the standard library. " +"The :mod:`!os.path` module is always the path module suitable for the " +"operating system Python is running on, and therefore usable for local " +"paths. However, you can also import and use the individual modules if you " +"want to manipulate a path that is *always* in one of the different formats. " +"They all have the same interface:" msgstr "" msgid ":mod:`!posixpath` for UNIX-style paths" @@ -71,10 +71,9 @@ msgid ":mod:`!ntpath` for Windows paths" msgstr "" msgid "" -":func:`exists`, :func:`lexists`, :func:`isdir`, :func:`isfile`, :func:" -"`islink`, and :func:`ismount` now return ``False`` instead of raising an " -"exception for paths that contain characters or bytes unrepresentable at the " -"OS level." +":func:`exists`, :func:`lexists`, :func:`isdir`, :func:`isfile`, :func:`islink`, " +"and :func:`ismount` now return ``False`` instead of raising an exception for " +"paths that contain characters or bytes unrepresentable at the OS level." msgstr "" msgid "" @@ -83,6 +82,21 @@ msgid "" "path))``." msgstr "" +msgid "" +"On Windows the path is normalized by the operating system, therefore the " +"result can differ from ``normpath(join(os.getcwd(), path))``. A drive-" +"relative path is resolved against the current directory of the specified " +"drive, and the drive letter is capitalized. Trailing dots and spaces are " +"stripped. For example::" +msgstr "" + +msgid "" +">>> os.path.abspath('c:spam')\n" +"'C:\\\\Temp\\\\spam'\n" +">>> os.path.abspath('c:/temp/spam. . .')\n" +"'c:\\\\temp\\\\spam'" +msgstr "" + msgid ":func:`os.path.join` and :func:`os.path.normpath`." msgstr "" @@ -156,8 +170,8 @@ msgstr "" msgid "" "Return ``True`` if *path* refers to an existing path, including broken " -"symbolic links. Equivalent to :func:`exists` on platforms lacking :func:" -"`os.lstat`." +"symbolic links. Equivalent to :func:`exists` on platforms " +"lacking :func:`os.lstat`." msgstr "" msgid "" @@ -166,10 +180,11 @@ msgid "" msgstr "" msgid "" -"On Unix, an initial ``~`` is replaced by the environment variable :envvar:" -"`HOME` if it is set; otherwise the current user's home directory is looked " -"up in the password directory through the built-in module :mod:`pwd`. An " -"initial ``~user`` is looked up directly in the password directory." +"On Unix, an initial ``~`` is replaced by the environment " +"variable :envvar:`HOME` if it is set; otherwise the current user's home " +"directory is looked up in the password directory through the built-in " +"module :mod:`pwd`. An initial ``~user`` is looked up directly in the " +"password directory." msgstr "" msgid "" @@ -202,9 +217,9 @@ msgstr "" msgid "" "Return the time of last access of *path*. The return value is a floating-" -"point number giving the number of seconds since the epoch (see the :mod:" -"`time` module). Raise :exc:`OSError` if the file does not exist or is " -"inaccessible." +"point number giving the number of seconds since the epoch (see " +"the :mod:`time` module). Raise :exc:`OSError` if the file does not exist " +"or is inaccessible." msgstr "" msgid "" @@ -359,9 +374,9 @@ msgid "" msgstr "" msgid "" -"Note that since there is a current directory for each drive, ``os.path." -"join(\"c:\", \"foo\")`` represents a path relative to the current directory " -"on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\\\foo`." +"Note that since there is a current directory for each drive, " +"``os.path.join(\"c:\", \"foo\")`` represents a path relative to the current " +"directory on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\\\foo`." msgstr "" msgid "Accepts a :term:`path-like object` for *path* and *paths*." @@ -395,7 +410,9 @@ msgid "" "symbolic links encountered in the path (if they are supported by the " "operating system). On Windows, this function will also resolve MS-DOS (also " "called 8.3) style names such as ``C:\\\\PROGRA~1`` to ``C:\\\\Program " -"Files``." +"Files``. The returned path uses the case reported by the operating system, " +"which can differ from the case of *path*, in particular the drive letter is " +"capitalized." msgstr "" msgid "" @@ -422,10 +439,10 @@ msgid "" msgstr "" msgid "" -"If *strict* is :py:data:`os.path.ALLOW_MISSING`, errors other than :exc:" -"`FileNotFoundError` are re-raised (as with ``strict=True``). Thus, the " -"returned path will not contain any symbolic links, but the named file and " -"some of its parent directories may be missing." +"If *strict* is :py:data:`os.path.ALLOW_MISSING`, errors other " +"than :exc:`FileNotFoundError` are re-raised (as with ``strict=True``). Thus, " +"the returned path will not contain any symbolic links, but the named file " +"and some of its parent directories may be missing." msgstr "" msgid "" @@ -483,9 +500,10 @@ msgstr "" msgid "" "Return ``True`` if the stat tuples *stat1* and *stat2* refer to the same " -"file. These structures may have been returned by :func:`os.fstat`, :func:`os." -"lstat`, or :func:`os.stat`. This function implements the underlying " -"comparison used by :func:`samefile` and :func:`sameopenfile`." +"file. These structures may have been returned " +"by :func:`os.fstat`, :func:`os.lstat`, or :func:`os.stat`. This function " +"implements the underlying comparison used by :func:`samefile` " +"and :func:`sameopenfile`." msgstr "" msgid "" @@ -496,8 +514,8 @@ msgid "" "*path* is empty, both *head* and *tail* are empty. Trailing slashes are " "stripped from *head* unless it is the root (one or more slashes only). In " "all cases, ``join(head, tail)`` returns a path to the same location as " -"*path* (but the strings may differ). Also see the functions :func:`join`, :" -"func:`dirname` and :func:`basename`." +"*path* (but the strings may differ). Also see the " +"functions :func:`join`, :func:`dirname` and :func:`basename`." msgstr "" msgid "" diff --git a/library/os.po b/library/os.po index e8763ec36d..ca4f638195 100644 --- a/library/os.po +++ b/library/os.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-15 18:55+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,10 +33,10 @@ msgid "" "This module provides a portable way of using operating system dependent " "functionality. If you just want to read or write a file see :func:`open`, " "if you want to manipulate paths, see the :mod:`os.path` module, and if you " -"want to read all the lines in all the files on the command line see the :mod:" -"`fileinput` module. For creating temporary files and directories see the :" -"mod:`tempfile` module, and for high-level file and directory handling see " -"the :mod:`shutil` module." +"want to read all the lines in all the files on the command line see " +"the :mod:`fileinput` module. For creating temporary files and directories " +"see the :mod:`tempfile` module, and for high-level file and directory " +"handling see the :mod:`shutil` module." msgstr "" msgid "Notes on the availability of these functions:" @@ -68,11 +68,11 @@ msgstr "" msgid "" "On WebAssembly platforms, Android and iOS, large parts of the :mod:`!os` " -"module are not available or behave differently. APIs related to processes (e." -"g. :func:`~os.fork`, :func:`~os.execve`) and resources (e.g. :func:`~os." -"nice`) are not available. Others like :func:`~os.getuid` and :func:`~os." -"getpid` are emulated or stubs. WebAssembly platforms also lack support for " -"signals (e.g. :func:`~os.kill`, :func:`~os.wait`)." +"module are not available or behave differently. APIs related to processes " +"(e.g. :func:`~os.fork`, :func:`~os.execve`) and resources " +"(e.g. :func:`~os.nice`) are not available. Others like :func:`~os.getuid` " +"and :func:`~os.getpid` are emulated or stubs. WebAssembly platforms also " +"lack support for signals (e.g. :func:`~os.kill`, :func:`~os.wait`)." msgstr "" msgid "" @@ -112,9 +112,9 @@ msgstr "" msgid "" "The :term:`filesystem encoding and error handler` are configured at Python " -"startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig." -"filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :" -"c:type:`PyConfig`." +"startup by the :c:func:`PyConfig_Read` function: " +"see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid "" @@ -128,8 +128,8 @@ msgstr "" msgid "" "The :term:`file system encoding ` " "must guarantee to successfully decode all bytes below 128. If the file " -"system encoding fails to provide this guarantee, API functions can raise :" -"exc:`UnicodeError`." +"system encoding fails to provide this guarantee, API functions can " +"raise :exc:`UnicodeError`." msgstr "" msgid "See also the :term:`locale encoding`." @@ -173,9 +173,9 @@ msgid "" msgstr "" msgid "" -"Note that the standard stream settings in UTF-8 mode can be overridden by :" -"envvar:`PYTHONIOENCODING` (just as they can be in the default locale-aware " -"mode)." +"Note that the standard stream settings in UTF-8 mode can be overridden " +"by :envvar:`PYTHONIOENCODING` (just as they can be in the default locale-" +"aware mode)." msgstr "" msgid "" @@ -224,8 +224,8 @@ msgid "" msgstr "" msgid "" -"See also the :ref:`UTF-8 mode on Windows ` and the :term:" -"`filesystem encoding and error handler`." +"See also the :ref:`UTF-8 mode on Windows ` and " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid ":pep:`686`" @@ -259,9 +259,9 @@ msgstr "" msgid "" "This mapping is captured the first time the :mod:`!os` module is imported, " "typically during Python startup as part of processing :file:`site.py`. " -"Changes to the environment made after this time are not reflected in :data:" -"`os.environ`, except for changes made by modifying :data:`os.environ` " -"directly." +"Changes to the environment made after this time are not reflected " +"in :data:`os.environ`, except for changes made by " +"modifying :data:`os.environ` directly." msgstr "" msgid "" @@ -293,10 +293,10 @@ msgid "" msgstr "" msgid "" -"You can delete items in this mapping to unset environment variables. :func:" -"`unsetenv` will be called automatically when an item is deleted from :data:" -"`os.environ`, and when one of the :meth:`pop` or :meth:`clear` methods is " -"called." +"You can delete items in this mapping to unset environment " +"variables. :func:`unsetenv` will be called automatically when an item is " +"deleted from :data:`os.environ`, and when one of the :meth:`pop` " +"or :meth:`clear` methods is called." msgstr "" msgid "The :func:`os.reload_environ` function." @@ -308,9 +308,9 @@ msgstr "" msgid "" "Bytes version of :data:`environ`: a :term:`mapping` object where both keys " -"and values are :class:`bytes` objects representing the process environment. :" -"data:`environ` and :data:`environb` are synchronized (modifying :data:" -"`environb` updates :data:`environ`, and vice versa)." +"and values are :class:`bytes` objects representing the process " +"environment. :data:`environ` and :data:`environb` are synchronized " +"(modifying :data:`environb` updates :data:`environ`, and vice versa)." msgstr "" msgid "" @@ -329,17 +329,18 @@ msgstr "" msgid "" "This function is not thread-safe. Calling it while the environment is being " -"modified in another thread is an undefined behavior. Reading from :data:`os." -"environ` or :data:`os.environb`, or calling :func:`os.getenv` while " -"reloading, may return an empty result." +"modified in another thread is an undefined behavior. Reading " +"from :data:`os.environ` or :data:`os.environb`, or calling :func:`os.getenv` " +"while reloading, may return an empty result." msgstr "" msgid "These functions are described in :ref:`os-file-dir`." msgstr "" msgid "" -"Encode :term:`path-like ` *filename* to the :term:" -"`filesystem encoding and error handler`; return :class:`bytes` unchanged." +"Encode :term:`path-like ` *filename* to " +"the :term:`filesystem encoding and error handler`; return :class:`bytes` " +"unchanged." msgstr "" msgid ":func:`fsdecode` is the reverse function." @@ -351,8 +352,9 @@ msgid "" msgstr "" msgid "" -"Decode the :term:`path-like ` *filename* from the :term:" -"`filesystem encoding and error handler`; return :class:`str` unchanged." +"Decode the :term:`path-like ` *filename* from " +"the :term:`filesystem encoding and error handler`; return :class:`str` " +"unchanged." msgstr "" msgid ":func:`fsencode` is the reverse function." @@ -383,10 +385,10 @@ msgstr "" msgid "" "Return the value of the environment variable *key* as a string if it exists, " -"or *default* if it doesn't. *key* is a string. Note that since :func:" -"`getenv` uses :data:`os.environ`, the mapping of :func:`getenv` is similarly " -"also captured on import, and the function may not reflect future environment " -"changes." +"or *default* if it doesn't. *key* is a string. Note that " +"since :func:`getenv` uses :data:`os.environ`, the mapping of :func:`getenv` " +"is similarly also captured on import, and the function may not reflect " +"future environment changes." msgstr "" msgid "" @@ -397,10 +399,10 @@ msgstr "" msgid "" "Return the value of the environment variable *key* as bytes if it exists, or " -"*default* if it doesn't. *key* must be bytes. Note that since :func:" -"`getenvb` uses :data:`os.environb`, the mapping of :func:`getenvb` is " -"similarly also captured on import, and the function may not reflect future " -"environment changes." +"*default* if it doesn't. *key* must be bytes. Note that " +"since :func:`getenvb` uses :data:`os.environb`, the mapping " +"of :func:`getenvb` is similarly also captured on import, and the function " +"may not reflect future environment changes." msgstr "" msgid "" @@ -453,17 +455,18 @@ msgid "" "access list for the user associated with the effective user id of the " "process; the group access list may change over the lifetime of the process, " "it is not affected by calls to :func:`setgroups`, and its length is not " -"limited to 16. The deployment target value, :const:" -"`MACOSX_DEPLOYMENT_TARGET`, can be obtained with :func:`sysconfig." -"get_config_var`." +"limited to 16. The deployment target " +"value, :const:`MACOSX_DEPLOYMENT_TARGET`, can be obtained " +"with :func:`sysconfig.get_config_var`." msgstr "" msgid "" "Return the name of the user logged in on the controlling terminal of the " -"process. For most purposes, it is more useful to use :func:`getpass." -"getuser` since the latter checks the environment variables :envvar:`LOGNAME` " -"or :envvar:`USERNAME` to find out who the user is, and falls back to ``pwd." -"getpwuid(os.getuid())[0]`` to get the login name of the current real user id." +"process. For most purposes, it is more useful to " +"use :func:`getpass.getuser` since the latter checks the environment " +"variables :envvar:`LOGNAME` or :envvar:`USERNAME` to find out who the user " +"is, and falls back to ``pwd.getpwuid(os.getuid())[0]`` to get the login name " +"of the current real user id." msgstr "" msgid "" @@ -487,13 +490,13 @@ msgid "Added support for Windows." msgstr "Dodane wsparcie dla Windowsa." msgid "" -"Get program scheduling priority. The value *which* is one of :const:" -"`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and *who* is " -"interpreted relative to *which* (a process identifier for :const:" -"`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, and a user " -"ID for :const:`PRIO_USER`). A zero value for *who* denotes (respectively) " -"the calling process, the process group of the calling process, or the real " -"user ID of the calling process." +"Get program scheduling priority. The value *which* is one " +"of :const:`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and " +"*who* is interpreted relative to *which* (a process identifier " +"for :const:`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, " +"and a user ID for :const:`PRIO_USER`). A zero value for *who* denotes " +"(respectively) the calling process, the process group of the calling " +"process, or the real user ID of the calling process." msgstr "" msgid "" @@ -521,17 +524,17 @@ msgstr "" msgid "" "Set the environment variable named *key* to the string *value*. Such " -"changes to the environment affect subprocesses started with :func:`os." -"system`, :func:`popen` or :func:`fork` and :func:`execv`." +"changes to the environment affect subprocesses started " +"with :func:`os.system`, :func:`popen` or :func:`fork` and :func:`execv`." msgstr "" msgid "" "Assignments to items in :data:`os.environ` are automatically translated into " "corresponding calls to :func:`putenv`; however, calls to :func:`putenv` " "don't update :data:`os.environ`, so it is actually preferable to assign to " -"items of :data:`os.environ`. This also applies to :func:`getenv` and :func:" -"`getenvb`, which respectively use :data:`os.environ` and :data:`os.environb` " -"in their implementations." +"items of :data:`os.environ`. This also applies to :func:`getenv` " +"and :func:`getenvb`, which respectively use :data:`os.environ` " +"and :data:`os.environb` in their implementations." msgstr "" msgid "See also the :func:`os.reload_environ` function." @@ -568,14 +571,15 @@ msgstr "" msgid "" "On macOS, the length of *groups* may not exceed the system-defined maximum " -"number of effective group ids, typically 16. See the documentation for :func:" -"`getgroups` for cases where it may not return the same group list set by " -"calling setgroups()." +"number of effective group ids, typically 16. See the documentation " +"for :func:`getgroups` for cases where it may not return the same group list " +"set by calling setgroups()." msgstr "" msgid "" -"Reassociate the current thread with a Linux namespace. See the :manpage:" -"`setns(2)` and :manpage:`namespaces(7)` man pages for more details." +"Reassociate the current thread with a Linux namespace. See " +"the :manpage:`setns(2)` and :manpage:`namespaces(7)` man pages for more " +"details." msgstr "" msgid "" @@ -587,13 +591,14 @@ msgid "" msgstr "" msgid "" -"Since Linux 5.8, *fd* may refer to a PID file descriptor obtained from :func:" -"`~os.pidfd_open`. In this case, ``setns()`` reassociates the calling thread " -"into one or more of the same namespaces as the thread referred to by *fd*. " -"This is subject to any constraints imposed by *nstype*, which is a bit mask " -"combining one or more of the :ref:`CLONE_NEW* constants `, e.g. ``setns(fd, os.CLONE_NEWUTS | os.CLONE_NEWPID)``. The caller's " -"memberships in unspecified namespaces are left unchanged." +"Since Linux 5.8, *fd* may refer to a PID file descriptor obtained " +"from :func:`~os.pidfd_open`. In this case, ``setns()`` reassociates the " +"calling thread into one or more of the same namespaces as the thread " +"referred to by *fd*. This is subject to any constraints imposed by *nstype*, " +"which is a bit mask combining one or more of the :ref:`CLONE_NEW* constants " +"`, e.g. ``setns(fd, os.CLONE_NEWUTS | " +"os.CLONE_NEWPID)``. The caller's memberships in unspecified namespaces are " +"left unchanged." msgstr "" msgid "" @@ -628,15 +633,15 @@ msgid "" msgstr "" msgid "" -"Set program scheduling priority. The value *which* is one of :const:" -"`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and *who* is " -"interpreted relative to *which* (a process identifier for :const:" -"`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, and a user " -"ID for :const:`PRIO_USER`). A zero value for *who* denotes (respectively) " -"the calling process, the process group of the calling process, or the real " -"user ID of the calling process. *priority* is a value in the range -20 to " -"19. The default priority is 0; lower priorities cause more favorable " -"scheduling." +"Set program scheduling priority. The value *which* is one " +"of :const:`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and " +"*who* is interpreted relative to *which* (a process identifier " +"for :const:`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, " +"and a user ID for :const:`PRIO_USER`). A zero value for *who* denotes " +"(respectively) the calling process, the process group of the calling " +"process, or the real user ID of the calling process. *priority* is a value " +"in the range -20 to 19. The default priority is 0; lower priorities cause " +"more favorable scheduling." msgstr "" msgid "Set the current process's real and effective group ids." @@ -680,52 +685,59 @@ msgstr "" msgid "" "Returns information identifying the current operating system. The return " -"value is an object with five attributes:" -msgstr "" - -msgid ":attr:`sysname` - operating system name" +"value is a :class:`uname_result`." msgstr "" -msgid ":attr:`nodename` - name of machine on network (implementation-defined)" +msgid "" +"On macOS, iOS and Android, this returns the *kernel* name and release (i.e., " +"``'Darwin'`` on macOS and iOS; ``'Linux'`` on " +"Android). :func:`platform.uname` can be used to get the user-facing " +"operating system name and release on iOS and Android." msgstr "" -msgid ":attr:`release` - operating system release" +msgid ":data:`sys.platform` which has finer granularity." msgstr "" -msgid ":attr:`version` - operating system version" +msgid "" +"Return type changed from a tuple to a tuple-like object with named " +"attributes." msgstr "" -msgid ":attr:`machine` - hardware identifier" +msgid "" +"Name and information about the system returned by :func:`os.uname`. These " +"attributes correspond to the members described in :manpage:`uname(2)`." msgstr "" msgid "" "For backwards compatibility, this object is also iterable, behaving like a " -"five-tuple containing :attr:`sysname`, :attr:`nodename`, :attr:`release`, :" -"attr:`version`, and :attr:`machine` in that order." +"five-tuple " +"containing :attr:`~uname_result.sysname`, :attr:`~uname_result.nodename`, :attr:`~uname_result.release`, :attr:`~uname_result.version`, " +"and :attr:`~uname_result.machine` in that order." msgstr "" -msgid "" -"Some systems truncate :attr:`nodename` to 8 characters or to the leading " -"component; a better way to get the hostname is :func:`socket.gethostname` " -"or even ``socket.gethostbyaddr(socket.gethostname())``." +msgid "Operating system name." msgstr "" msgid "" -"On macOS, iOS and Android, this returns the *kernel* name and version (i.e., " -"``'Darwin'`` on macOS and iOS; ``'Linux'`` on Android). :func:`platform." -"uname` can be used to get the user-facing operating system name and version " -"on iOS and Android." +"Name of machine on network. Some systems " +"truncate :attr:`~uname_result.nodename` to 8 characters or to the leading " +"component; a better way to get the hostname is :func:`socket.gethostname` or " +"even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -msgid "" -"Return type changed from a tuple to a tuple-like object with named " -"attributes." +msgid "Operating system release." +msgstr "" + +msgid "Operating system version." +msgstr "" + +msgid "Hardware identifier." msgstr "" msgid "" "Unset (delete) the environment variable named *key*. Such changes to the " -"environment affect subprocesses started with :func:`os.system`, :func:" -"`popen` or :func:`fork` and :func:`execv`." +"environment affect subprocesses started " +"with :func:`os.system`, :func:`popen` or :func:`fork` and :func:`execv`." msgstr "" msgid "" @@ -746,11 +758,11 @@ msgstr "" msgid "" "Disassociate parts of the process execution context, and move them into a " "newly created namespace. See the :manpage:`unshare(2)` man page for more " -"details. The *flags* argument is a bit mask, combining zero or more of the :" -"ref:`CLONE_* constants `, that specifies which parts " -"of the execution context should be unshared from their existing associations " -"and moved to a new namespace. If the *flags* argument is ``0``, no changes " -"are made to the calling process's execution context." +"details. The *flags* argument is a bit mask, combining zero or more of " +"the :ref:`CLONE_* constants `, that specifies which " +"parts of the execution context should be unshared from their existing " +"associations and moved to a new namespace. If the *flags* argument is ``0``, " +"no changes are made to the calling process's execution context." msgstr "" msgid "The :func:`~os.setns` function." @@ -766,8 +778,8 @@ msgid "File Object Creation" msgstr "" msgid "" -"These functions create new :term:`file objects `. (See also :" -"func:`~os.open` for opening file descriptors.)" +"These functions create new :term:`file objects `. (See " +"also :func:`~os.open` for opening file descriptors.)" msgstr "" msgid "" @@ -806,8 +818,8 @@ msgstr "" msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To close a " -"\"file object\" returned by the built-in function :func:`open` or by :func:" -"`popen` or :func:`fdopen`, use its :meth:`~io.IOBase.close` method." +"\"file object\" returned by the built-in function :func:`open` or " +"by :func:`popen` or :func:`fdopen`, use its :meth:`~io.IOBase.close` method." msgstr "" msgid "" @@ -832,8 +844,8 @@ msgstr "" msgid "" "In Linux kernel older than 5.3, the files pointed to by *src* and *dst* must " -"reside in the same filesystem, otherwise an :exc:`OSError` is raised with :" -"attr:`~OSError.errno` set to :const:`errno.EXDEV`." +"reside in the same filesystem, otherwise an :exc:`OSError` is raised " +"with :attr:`~OSError.errno` set to :const:`errno.EXDEV`." msgstr "" msgid "" @@ -876,8 +888,8 @@ msgid "On Unix, the function now implements the Python UTF-8 Mode." msgstr "" msgid "" -"Return a duplicate of file descriptor *fd*. The new file descriptor is :ref:" -"`non-inheritable `." +"Return a duplicate of file descriptor *fd*. The new file descriptor " +"is :ref:`non-inheritable `." msgstr "" msgid "" @@ -922,8 +934,9 @@ msgstr "" msgid "" "Change the owner and group id of the file given by *fd* to the numeric *uid* " -"and *gid*. To leave one of the ids unchanged, set it to -1. See :func:" -"`chown`. As of Python 3.3, this is equivalent to ``os.chown(fd, uid, gid)``." +"and *gid*. To leave one of the ids unchanged, set it to -1. " +"See :func:`chown`. As of Python 3.3, this is equivalent to ``os.chown(fd, " +"uid, gid)``." msgstr "" msgid "" @@ -936,9 +949,6 @@ msgid "" "of metadata." msgstr "" -msgid "This function is not available on MacOS." -msgstr "Ta funkcja nie jest dostępna w macOS." - msgid "" "Return system configuration information relevant to an open file. *name* " "specifies the configuration value to retrieve; it may be a string which is " @@ -952,8 +962,8 @@ msgstr "" msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " -"included in ``pathconf_names``, an :exc:`OSError` is raised with :const:" -"`errno.EINVAL` for the error number." +"included in ``pathconf_names``, an :exc:`OSError` is raised " +"with :const:`errno.EINVAL` for the error number." msgstr "" msgid "As of Python 3.3, this is equivalent to ``os.pathconf(fd, name)``." @@ -972,8 +982,8 @@ msgstr "" msgid "" "Return information about the filesystem containing the file associated with " -"file descriptor *fd*, like :func:`statvfs`. As of Python 3.3, this is " -"equivalent to ``os.statvfs(fd)``." +"file descriptor *fd* in a :class:`statvfs_result`, like :func:`statvfs`. As " +"of Python 3.3, this is equivalent to ``os.statvfs(fd)``." msgstr "" msgid "" @@ -990,8 +1000,8 @@ msgstr "" msgid "" "Truncate the file corresponding to file descriptor *fd*, so that it is at " -"most *length* bytes in size. As of Python 3.3, this is equivalent to ``os." -"truncate(fd, length)``." +"most *length* bytes in size. As of Python 3.3, this is equivalent to " +"``os.truncate(fd, length)``." msgstr "" msgid "" @@ -1003,8 +1013,8 @@ msgid "Added support for Windows" msgstr "" msgid "" -"Get the blocking mode of the file descriptor: ``False`` if the :data:" -"`O_NONBLOCK` flag is set, ``True`` if the flag is cleared." +"Get the blocking mode of the file descriptor: ``False`` if " +"the :data:`O_NONBLOCK` flag is set, ``True`` if the flag is cleared." msgstr "" msgid "See also :func:`set_blocking` and :meth:`socket.socket.setblocking`." @@ -1032,8 +1042,8 @@ msgstr "" msgid "" "Apply, test or remove a POSIX lock on an open file descriptor. *fd* is an " -"open file descriptor. *cmd* specifies the command to use - one of :data:" -"`F_LOCK`, :data:`F_TLOCK`, :data:`F_ULOCK` or :data:`F_TEST`. *len* " +"open file descriptor. *cmd* specifies the command to use - one " +"of :data:`F_LOCK`, :data:`F_TLOCK`, :data:`F_ULOCK` or :data:`F_TEST`. *len* " "specifies the section of the file to lock." msgstr "" @@ -1141,8 +1151,8 @@ msgstr "" msgid "" "For a description of the flag and mode values, see the C run-time " "documentation; flag constants (like :const:`O_RDONLY` and :const:`O_WRONLY`) " -"are defined in the :mod:`!os` module. In particular, on Windows adding :" -"const:`O_BINARY` is needed to open files in binary mode." +"are defined in the :mod:`!os` module. In particular, on Windows " +"adding :const:`O_BINARY` is needed to open files in binary mode." msgstr "" msgid "" @@ -1159,9 +1169,9 @@ msgstr "" msgid "" "This function is intended for low-level I/O. For normal usage, use the " -"built-in function :func:`open`, which returns a :term:`file object` with :" -"meth:`~io.BufferedIOBase.read` and :meth:`~io.BufferedIOBase.write` methods. " -"To wrap a file descriptor in a file object, use :func:`fdopen`." +"built-in function :func:`open`, which returns a :term:`file object` " +"with :meth:`~io.BufferedIOBase.read` and :meth:`~io.BufferedIOBase.write` " +"methods. To wrap a file descriptor in a file object, use :func:`fdopen`." msgstr "" msgid "Added the *dir_fd* parameter." @@ -1169,8 +1179,8 @@ msgstr "" msgid "" "If the system call is interrupted and the signal handler does not raise an " -"exception, the function now retries the system call instead of raising an :" -"exc:`InterruptedError` exception (see :pep:`475` for the rationale)." +"exception, the function now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" "Jeśli wywołanie systemowe zostanie przerwane, a program obsługi sygnału nie " "rzuci wyjątku, funkcji ponawia teraz wywołanie systemowe zamiast rzucenja " @@ -1180,12 +1190,12 @@ msgid "Accepts a :term:`path-like object`." msgstr "" msgid "" -"The following constants are options for the *flags* parameter to the :func:" -"`~os.open` function. They can be combined using the bitwise OR operator ``|" -"``. Some of them are not available on all platforms. For descriptions of " -"their availability and use, consult the :manpage:`open(2)` manual page on " -"Unix or `the MSDN `_ " -"on Windows." +"The following constants are options for the *flags* parameter to " +"the :func:`~os.open` function. They can be combined using the bitwise OR " +"operator ``|``. Some of them are not available on all platforms. For " +"descriptions of their availability and use, consult the :manpage:`open(2)` " +"manual page on Unix or `the MSDN `_ on Windows." msgstr "" msgid "The above constants are available on Unix and Windows." @@ -1204,8 +1214,8 @@ msgid "The above constants are only available on macOS." msgstr "" msgid "" -"Add :data:`O_EVTONLY`, :data:`O_FSYNC`, :data:`O_SYMLINK` and :data:" -"`O_NOFOLLOW_ANY` constants." +"Add :data:`O_EVTONLY`, :data:`O_FSYNC`, :data:`O_SYMLINK` " +"and :data:`O_NOFOLLOW_ANY` constants." msgstr "" msgid "" @@ -1236,9 +1246,9 @@ msgstr "" msgid "" "Create a pipe with *flags* set atomically. *flags* can be constructed by " -"ORing together one or more of these values: :data:`O_NONBLOCK`, :data:" -"`O_CLOEXEC`. Return a pair of file descriptors ``(r, w)`` usable for reading " -"and writing, respectively." +"ORing together one or more of these " +"values: :data:`O_NONBLOCK`, :data:`O_CLOEXEC`. Return a pair of file " +"descriptors ``(r, w)`` usable for reading and writing, respectively." msgstr "" msgid "" @@ -1250,10 +1260,9 @@ msgid "" "Announces an intention to access data in a specific pattern thus allowing " "the kernel to make optimizations. The advice applies to the region of the " "file specified by *fd* starting at *offset* and continuing for *len* bytes. " -"*advice* is one of :data:`POSIX_FADV_NORMAL`, :data:" -"`POSIX_FADV_SEQUENTIAL`, :data:`POSIX_FADV_RANDOM`, :data:" -"`POSIX_FADV_NOREUSE`, :data:`POSIX_FADV_WILLNEED` or :data:" -"`POSIX_FADV_DONTNEED`." +"*advice* is one " +"of :data:`POSIX_FADV_NORMAL`, :data:`POSIX_FADV_SEQUENTIAL`, :data:`POSIX_FADV_RANDOM`, :data:`POSIX_FADV_NOREUSE`, :data:`POSIX_FADV_WILLNEED` " +"or :data:`POSIX_FADV_DONTNEED`." msgstr "" msgid "" @@ -1287,10 +1296,11 @@ msgid "" msgstr "" msgid "" -"Read from a file descriptor *fd* at a position of *offset* into mutable :" -"term:`bytes-like objects ` *buffers*, leaving the file " -"offset unchanged. Transfer data into each buffer until it is full and then " -"move on to the next buffer in the sequence to hold the rest of the data." +"Read from a file descriptor *fd* at a position of *offset* into " +"mutable :term:`bytes-like objects ` *buffers*, leaving " +"the file offset unchanged. Transfer data into each buffer until it is full " +"and then move on to the next buffer in the sequence to hold the rest of the " +"data." msgstr "" msgid "" @@ -1328,8 +1338,8 @@ msgstr "" msgid "" "If some data was successfully read, it will return the number of bytes read. " -"If no bytes were read, it will return ``-1`` and set errno to :const:`errno." -"EAGAIN`." +"If no bytes were read, it will return ``-1`` and set errno " +"to :const:`errno.EAGAIN`." msgstr "" msgid "" @@ -1364,10 +1374,10 @@ msgstr "" msgid "" "Write the *buffers* contents to file descriptor *fd* at an offset *offset*, " -"leaving the file offset unchanged. *buffers* must be a sequence of :term:" -"`bytes-like objects `. Buffers are processed in array " -"order. Entire contents of the first buffer is written before proceeding to " -"the second, and so on." +"leaving the file offset unchanged. *buffers* must be a sequence " +"of :term:`bytes-like objects `. Buffers are processed in " +"array order. Entire contents of the first buffer is written before " +"proceeding to the second, and so on." msgstr "" msgid ":data:`RWF_DSYNC`" @@ -1437,9 +1447,10 @@ msgstr "" msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`os.pipe`. To read a " -"\"file object\" returned by the built-in function :func:`open`, or :data:" -"`sys.stdin`, use its member functions, for example :meth:`io.BufferedIOBase." -"readinto`, :meth:`io.BufferedIOBase.read`, or :meth:`io.TextIOBase.read`" +"\"file object\" returned by the built-in function :func:`open`, " +"or :data:`sys.stdin`, use its member functions, for " +"example :meth:`io.BufferedIOBase.readinto`, :meth:`io.BufferedIOBase.read`, " +"or :meth:`io.TextIOBase.read`" msgstr "" msgid "" @@ -1449,8 +1460,8 @@ msgid "" msgstr "" msgid "" -"The first function notation is supported by all platforms that define :func:" -"`sendfile`." +"The first function notation is supported by all platforms that " +"define :func:`sendfile`." msgstr "" msgid "" @@ -1481,8 +1492,8 @@ msgid "" msgstr "" msgid "" -"For a higher-level wrapper of :func:`sendfile`, see :meth:`socket.socket." -"sendfile`." +"For a higher-level wrapper of :func:`sendfile`, " +"see :meth:`socket.socket.sendfile`." msgstr "" msgid "Parameters *out* and *in* was renamed to *out_fd* and *in_fd*." @@ -1500,8 +1511,9 @@ msgid "" msgstr "" msgid "" -"Set the blocking mode of the specified file descriptor. Set the :data:" -"`O_NONBLOCK` flag if blocking is ``False``, clear the flag otherwise." +"Set the blocking mode of the specified file descriptor. Set " +"the :data:`O_NONBLOCK` flag if blocking is ``False``, clear the flag " +"otherwise." msgstr "" msgid "See also :func:`get_blocking` and :meth:`socket.socket.setblocking`." @@ -1540,8 +1552,8 @@ msgid "" "is ``None``, then *src* is read from the current position; respectively for " "*offset_dst*. The offset associated to the file descriptor that refers to a " "pipe must be ``None``. The files pointed to by *src* and *dst* must reside " -"in the same filesystem, otherwise an :exc:`OSError` is raised with :attr:" -"`~OSError.errno` set to :const:`errno.EXDEV`." +"in the same filesystem, otherwise an :exc:`OSError` is raised " +"with :attr:`~OSError.errno` set to :const:`errno.EXDEV`." msgstr "" msgid "" @@ -1600,9 +1612,9 @@ msgstr "" msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To write a " -"\"file object\" returned by the built-in function :func:`open` or by :func:" -"`popen` or :func:`fdopen`, or :data:`sys.stdout` or :data:`sys.stderr`, use " -"its :meth:`~io.TextIOBase.write` method." +"\"file object\" returned by the built-in function :func:`open` or " +"by :func:`popen` or :func:`fdopen`, or :data:`sys.stdout` " +"or :data:`sys.stderr`, use its :meth:`~io.TextIOBase.write` method." msgstr "" msgid "" @@ -1711,8 +1723,8 @@ msgstr "" msgid "" "You can check whether or not *path* can be specified as a file descriptor " "for a particular function on your platform using :data:`os.supports_fd`. If " -"this functionality is unavailable, using it will raise a :exc:" -"`NotImplementedError`." +"this functionality is unavailable, using it will raise " +"a :exc:`NotImplementedError`." msgstr "" msgid "" @@ -1755,10 +1767,10 @@ msgid "" "operations will use the effective uid/gid, therefore this routine can be " "used in a suid/sgid environment to test if the invoking user has the " "specified access to *path*. *mode* should be :const:`F_OK` to test the " -"existence of *path*, or it can be the inclusive OR of one or more of :const:" -"`R_OK`, :const:`W_OK`, and :const:`X_OK` to test permissions. Return :const:" -"`True` if access is allowed, :const:`False` if not. See the Unix man page :" -"manpage:`access(2)` for more information." +"existence of *path*, or it can be the inclusive OR of one or more " +"of :const:`R_OK`, :const:`W_OK`, and :const:`X_OK` to test permissions. " +"Return :const:`True` if access is allowed, :const:`False` if not. See the " +"Unix man page :manpage:`access(2)` for more information." msgstr "" msgid "" @@ -1826,8 +1838,9 @@ msgid "" msgstr "" msgid "" -"This function can raise :exc:`OSError` and subclasses such as :exc:" -"`FileNotFoundError`, :exc:`PermissionError`, and :exc:`NotADirectoryError`." +"This function can raise :exc:`OSError` and subclasses such " +"as :exc:`FileNotFoundError`, :exc:`PermissionError`, " +"and :exc:`NotADirectoryError`." msgstr "" msgid "" @@ -1835,14 +1848,19 @@ msgid "" "``path``." msgstr "" +msgid "" +"The :func:`contextlib.chdir` context manager, which changes the current " +"working directory on entering and restores the previous one on exit." +msgstr "" + msgid "" "Added support for specifying *path* as a file descriptor on some platforms." msgstr "" msgid "" "Set the flags of *path* to the numeric *flags*. *flags* may take a " -"combination (bitwise OR) of the following values (as defined in the :mod:" -"`stat` module):" +"combination (bitwise OR) of the following values (as defined in " +"the :mod:`stat` module):" msgstr "" msgid ":const:`stat.UF_NODUMP`" @@ -1957,9 +1975,9 @@ msgid ":const:`stat.S_IXOTH`" msgstr ":const:`stat.S_IXOTH`" msgid "" -"This function can support :ref:`specifying a file descriptor `, :" -"ref:`paths relative to directory descriptors ` and :ref:`not " -"following symlinks `." +"This function can support :ref:`specifying a file descriptor " +"`, :ref:`paths relative to directory descriptors ` " +"and :ref:`not following symlinks `." msgstr "" msgid "" @@ -2015,15 +2033,15 @@ msgstr "" msgid "" "Set the flags of *path* to the numeric *flags*, like :func:`chflags`, but do " -"not follow symbolic links. As of Python 3.3, this is equivalent to ``os." -"chflags(path, flags, follow_symlinks=False)``." +"not follow symbolic links. As of Python 3.3, this is equivalent to " +"``os.chflags(path, flags, follow_symlinks=False)``." msgstr "" msgid "" "Change the mode of *path* to the numeric *mode*. If path is a symlink, this " "affects the symlink rather than the target. See the docs for :func:`chmod` " -"for possible values of *mode*. As of Python 3.3, this is equivalent to ``os." -"chmod(path, mode, follow_symlinks=False)``." +"for possible values of *mode*. As of Python 3.3, this is equivalent to " +"``os.chmod(path, mode, follow_symlinks=False)``." msgstr "" msgid "" @@ -2042,8 +2060,8 @@ msgstr "" msgid "" "This function can support specifying *src_dir_fd* and/or *dst_dir_fd* to " -"supply :ref:`paths relative to directory descriptors `, and :ref:" -"`not following symlinks `. The default value of " +"supply :ref:`paths relative to directory descriptors `, " +"and :ref:`not following symlinks `. The default value of " "*follow_symlinks* is ``False`` on Windows." msgstr "" @@ -2123,10 +2141,10 @@ msgid "" msgstr "" msgid "" -"*volume* must be represented as a GUID path, like those returned by :func:" -"`os.listvolumes`. Volumes may be mounted in multiple locations or not at " -"all. In the latter case, the list will be empty. Mount points that are not " -"associated with a volume will not be returned by this function." +"*volume* must be represented as a GUID path, like those returned " +"by :func:`os.listvolumes`. Volumes may be mounted in multiple locations or " +"not at all. In the latter case, the list will be empty. Mount points that " +"are not associated with a volume will not be returned by this function." msgstr "" msgid "" @@ -2165,13 +2183,13 @@ msgstr "" msgid "" "Perform the equivalent of an :c:func:`!lstat` system call on the given path. " -"Similar to :func:`~os.stat`, but does not follow symbolic links. Return a :" -"class:`stat_result` object." +"Similar to :func:`~os.stat`, but does not follow symbolic links. Return " +"a :class:`stat_result` object." msgstr "" msgid "" -"On platforms that do not support symbolic links, this is an alias for :func:" -"`~os.stat`." +"On platforms that do not support symbolic links, this is an alias " +"for :func:`~os.stat`." msgstr "" msgid "" @@ -2190,8 +2208,8 @@ msgstr "" msgid "" "On Windows, now opens reparse points that represent another path (name " "surrogates), including symbolic links and directory junctions. Other kinds " -"of reparse points are resolved by the operating system as for :func:`~os." -"stat`." +"of reparse points are resolved by the operating system as " +"for :func:`~os.stat`." msgstr "" msgid "Create a directory named *path* with numeric mode *mode*." @@ -2260,10 +2278,10 @@ msgid "Added the *exist_ok* parameter." msgstr "" msgid "" -"Before Python 3.4.1, if *exist_ok* was ``True`` and the directory existed, :" -"func:`makedirs` would still raise an error if *mode* did not match the mode " -"of the existing directory. Since this behavior was impossible to implement " -"safely, it was removed in Python 3.4.1. See :issue:`21082`." +"Before Python 3.4.1, if *exist_ok* was ``True`` and the directory " +"existed, :func:`makedirs` would still raise an error if *mode* did not match " +"the mode of the existing directory. Since this behavior was impossible to " +"implement safely, it was removed in Python 3.4.1. See :issue:`21082`." msgstr "" msgid "" @@ -2288,21 +2306,21 @@ msgstr "" msgid "" "Create a filesystem node (file, device special file or named pipe) named " "*path*. *mode* specifies both the permissions to use and the type of node to " -"be created, being combined (bitwise OR) with one of ``stat.S_IFREG``, ``stat." -"S_IFCHR``, ``stat.S_IFBLK``, and ``stat.S_IFIFO`` (those constants are " -"available in :mod:`stat`). For ``stat.S_IFCHR`` and ``stat.S_IFBLK``, " -"*device* defines the newly created device special file (probably using :func:" -"`os.makedev`), otherwise it is ignored." +"be created, being combined (bitwise OR) with one of ``stat.S_IFREG``, " +"``stat.S_IFCHR``, ``stat.S_IFBLK``, and ``stat.S_IFIFO`` (those constants " +"are available in :mod:`stat`). For ``stat.S_IFCHR`` and ``stat.S_IFBLK``, " +"*device* defines the newly created device special file (probably " +"using :func:`os.makedev`), otherwise it is ignored." msgstr "" msgid "" -"Extract the device major number from a raw device number (usually the :attr:" -"`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." +"Extract the device major number from a raw device number (usually " +"the :attr:`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." msgstr "" msgid "" -"Extract the device minor number from a raw device number (usually the :attr:" -"`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." +"Extract the device minor number from a raw device number (usually " +"the :attr:`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." msgstr "" msgid "Compose a raw device number from the major and minor device numbers." @@ -2331,20 +2349,21 @@ msgstr "" msgid "" "Return a string representing the path to which the symbolic link points. " "The result may be either an absolute or relative pathname; if it is " -"relative, it may be converted to an absolute pathname using ``os.path." -"join(os.path.dirname(path), result)``." +"relative, it may be converted to an absolute pathname using " +"``os.path.join(os.path.dirname(path), result)``." msgstr "" msgid "" -"If the *path* is a string object (directly or indirectly through a :class:" -"`PathLike` interface), the result will also be a string object, and the call " -"may raise a UnicodeDecodeError. If the *path* is a bytes object (direct or " -"indirectly), the result will be a bytes object." +"If the *path* is a string object (directly or indirectly through " +"a :class:`PathLike` interface), the result will also be a string object, and " +"the call may raise a UnicodeDecodeError. If the *path* is a bytes object " +"(direct or indirectly), the result will be a bytes object." msgstr "" msgid "" -"When trying to resolve a path that may contain links, use :func:`~os.path." -"realpath` to properly handle recursion and platform differences." +"When trying to resolve a path that may contain links, " +"use :func:`~os.path.realpath` to properly handle recursion and platform " +"differences." msgstr "" msgid "Accepts a :term:`path-like object` on Unix." @@ -2360,9 +2379,9 @@ msgid "" msgstr "" msgid "" -"Remove (delete) the file *path*. If *path* is a directory, an :exc:" -"`OSError` is raised. Use :func:`rmdir` to remove directories. If the file " -"does not exist, a :exc:`FileNotFoundError` is raised." +"Remove (delete) the file *path*. If *path* is a directory, " +"an :exc:`OSError` is raised. Use :func:`rmdir` to remove directories. If " +"the file does not exist, a :exc:`FileNotFoundError` is raised." msgstr "" msgid "" @@ -2403,13 +2422,13 @@ msgstr "" msgid "" "On Windows, if *dst* exists a :exc:`FileExistsError` is always raised. The " -"operation may fail if *src* and *dst* are on different filesystems. Use :" -"func:`shutil.move` to support moves to a different filesystem." +"operation may fail if *src* and *dst* are on different filesystems. " +"Use :func:`shutil.move` to support moves to a different filesystem." msgstr "" msgid "" -"On Unix, if *src* is a file and *dst* is a directory or vice-versa, an :exc:" -"`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised " +"On Unix, if *src* is a file and *dst* is a directory or vice-versa, " +"an :exc:`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised " "respectively. If both are directories and *dst* is empty, *dst* will be " "silently replaced. If *dst* is a non-empty directory, an :exc:`OSError` is " "raised. If both are files, *dst* will be replaced silently if the user has " @@ -2424,8 +2443,8 @@ msgid "" msgstr "" msgid "" -"If you want cross-platform overwriting of the destination, use :func:" -"`replace`." +"If you want cross-platform overwriting of the destination, " +"use :func:`replace`." msgstr "" msgid "" @@ -2463,8 +2482,8 @@ msgstr "" msgid "" "Remove (delete) the directory *path*. If the directory does not exist or is " "not empty, a :exc:`FileNotFoundError` or an :exc:`OSError` is raised " -"respectively. In order to remove whole directory trees, :func:`shutil." -"rmtree` can be used." +"respectively. In order to remove whole directory " +"trees, :func:`shutil.rmtree` can be used." msgstr "" msgid "" @@ -2485,11 +2504,12 @@ msgid "" "Using :func:`scandir` instead of :func:`listdir` can significantly increase " "the performance of code that also needs file type or file attribute " "information, because :class:`os.DirEntry` objects expose this information if " -"the operating system provides it when scanning a directory. All :class:`os." -"DirEntry` methods may perform a system call, but :func:`~os.DirEntry.is_dir` " -"and :func:`~os.DirEntry.is_file` usually only require a system call for " -"symbolic links; :func:`os.DirEntry.stat` always requires a system call on " -"Unix but only requires one for symbolic links on Windows." +"the operating system provides it when scanning a directory. " +"All :class:`os.DirEntry` methods may perform a system call, " +"but :func:`~os.DirEntry.is_dir` and :func:`~os.DirEntry.is_file` usually " +"only require a system call for symbolic links; :func:`os.DirEntry.stat` " +"always requires a system call on Unix but only requires one for symbolic " +"links on Windows." msgstr "" msgid "" @@ -2505,6 +2525,13 @@ msgid "" "``path``." msgstr "" +msgid "" +"Sharing a :func:`scandir` iterator between threads will not corrupt the " +"iterator, but it is subject to :term:`race conditions `: " +"which entries each thread receives is unspecified, and closing the iterator " +"while another thread is iterating ends that iteration early." +msgstr "" + msgid "" "The :func:`scandir` iterator supports the :term:`context manager` protocol " "and has the following method:" @@ -2514,8 +2541,8 @@ msgid "Close the iterator and free acquired resources." msgstr "" msgid "" -"This is called automatically when the iterator is exhausted or garbage " -"collected, or when an error happens during iterating. However it is " +"This is called automatically when the iterator is :term:`exhausted` or " +"garbage collected, or when an error happens during iterating. However it is " "advisable to call it explicitly or use the :keyword:`with` statement." msgstr "" @@ -2538,16 +2565,16 @@ msgid "" "pubs.opengroup.org/onlinepubs/009695399/functions/opendir.html>`_ and " "`readdir() `_ functions. On Windows, it uses the Win32 `FindFirstFileW " -"`_ and `FindNextFileW `_ functions." +"`_ and `FindNextFileW `_ functions." msgstr "" msgid "" -"Added support for the :term:`context manager` protocol and the :func:" -"`~scandir.close` method. If a :func:`scandir` iterator is neither exhausted " -"nor explicitly closed a :exc:`ResourceWarning` will be emitted in its " -"destructor." +"Added support for the :term:`context manager` protocol and " +"the :func:`~scandir.close` method. If a :func:`scandir` iterator is neither " +"exhausted nor explicitly closed a :exc:`ResourceWarning` will be emitted in " +"its destructor." msgstr "" msgid "The function accepts a :term:`path-like object`." @@ -2586,6 +2613,11 @@ msgid "" "implements the :class:`PathLike` interface." msgstr "" +msgid "" +":class:`!DirEntry` objects are :ref:`generic ` over the type of " +"the path (:class:`str` or :class:`bytes`)." +msgstr "" + msgid "Attributes and methods on a ``os.DirEntry`` instance are as follows:" msgstr "" @@ -2595,31 +2627,38 @@ msgstr "" msgid "" "The :attr:`name` attribute will be ``bytes`` if the :func:`scandir` *path* " -"argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os." -"fsdecode` to decode byte filenames." +"argument is of type ``bytes`` and ``str`` otherwise. " +"Use :func:`~os.fsdecode` to decode byte filenames." msgstr "" msgid "" -"The entry's full path name: equivalent to ``os.path.join(scandir_path, entry." -"name)`` where *scandir_path* is the :func:`scandir` *path* argument. The " -"path is only absolute if the :func:`scandir` *path* argument was absolute. " -"If the :func:`scandir` *path* argument was a :ref:`file descriptor " +"The entry's path name: equivalent to ``os.path.join(scandir_path, " +"entry.name)`` where *scandir_path* is the original :func:`scandir` *path* " +"argument. Apart from the filename, the path preserves the " +"original :func:`scandir` argument. If the :func:`scandir` *path* argument " +"was relative, the :attr:`path` attribute is also relative. Changing the " +"current working directory after creating the :func:`scandir` iterator may " +"cause later uses of :attr:`path` to resolve differently. On some platforms, " +"the constructed path may not be valid if the original :func:`scandir` " +"argument was usable for enumeration but not for joining with the entry " +"name. If the :func:`scandir` *path* argument was a :ref:`file descriptor " "`, the :attr:`path` attribute is the same as the :attr:`name` " "attribute." msgstr "" msgid "" "The :attr:`path` attribute will be ``bytes`` if the :func:`scandir` *path* " -"argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os." -"fsdecode` to decode byte filenames." +"argument is of type ``bytes`` and ``str`` otherwise. " +"Use :func:`~os.fsdecode` to decode byte filenames." msgstr "" msgid "Return the inode number of the entry." msgstr "" msgid "" -"The result is cached on the ``os.DirEntry`` object. Use ``os.stat(entry." -"path, follow_symlinks=False).st_ino`` to fetch up-to-date information." +"The result is cached on the ``os.DirEntry`` object. Use " +"``os.stat(entry.path, follow_symlinks=False).st_ino`` to fetch up-to-date " +"information." msgstr "" msgid "" @@ -2655,8 +2694,8 @@ msgid "" msgstr "" msgid "" -"This method can raise :exc:`OSError`, such as :exc:`PermissionError`, but :" -"exc:`FileNotFoundError` is caught and not raised." +"This method can raise :exc:`OSError`, such as :exc:`PermissionError`, " +"but :exc:`FileNotFoundError` is caught and not raised." msgstr "" msgid "" @@ -2683,8 +2722,8 @@ msgid "" msgstr "" msgid "" -"The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." -"islink` to fetch up-to-date information." +"The result is cached on the ``os.DirEntry`` object. " +"Call :func:`os.path.islink` to fetch up-to-date information." msgstr "" msgid "" @@ -2701,8 +2740,8 @@ msgid "" msgstr "" msgid "" -"The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." -"isjunction` to fetch up-to-date information." +"The result is cached on the ``os.DirEntry`` object. " +"Call :func:`os.path.isjunction` to fetch up-to-date information." msgstr "" msgid "" @@ -2718,8 +2757,8 @@ msgid "" msgstr "" msgid "" -"On Windows, the ``st_ino``, ``st_dev`` and ``st_nlink`` attributes of the :" -"class:`stat_result` are always set to zero. Call :func:`os.stat` to get " +"On Windows, the ``st_ino``, ``st_dev`` and ``st_nlink`` attributes of " +"the :class:`stat_result` are always set to zero. Call :func:`os.stat` to get " "these attributes." msgstr "" @@ -2737,8 +2776,8 @@ msgid "" msgstr "" msgid "" -"Added support for the :class:`~os.PathLike` interface. Added support for :" -"class:`bytes` paths on Windows." +"Added support for the :class:`~os.PathLike` interface. Added support " +"for :class:`bytes` paths on Windows." msgstr "" msgid "" @@ -2749,11 +2788,11 @@ msgid "" msgstr "" msgid "" -"Get the status of a file or a file descriptor. Perform the equivalent of a :" -"c:func:`stat` system call on the given path. *path* may be specified as " -"either a string or bytes -- directly or indirectly through the :class:" -"`PathLike` interface -- or as an open file descriptor. Return a :class:" -"`stat_result` object." +"Get the status of a file or a file descriptor. Perform the equivalent of " +"a :c:func:`stat` system call on the given path. *path* may be specified as " +"either a string or bytes -- directly or indirectly through " +"the :class:`PathLike` interface -- or as an open file descriptor. Return " +"a :class:`stat_result` object." msgstr "" msgid "" @@ -2762,8 +2801,8 @@ msgid "" msgstr "" msgid "" -"This function can support :ref:`specifying a file descriptor ` and :" -"ref:`not following symlinks `." +"This function can support :ref:`specifying a file descriptor ` " +"and :ref:`not following symlinks `." msgstr "" msgid "" @@ -2773,10 +2812,10 @@ msgid "" "the operating system is unable to follow will be opened directly. When " "following a chain of multiple links, this may result in the original link " "being returned instead of the non-link that prevented full traversal. To " -"obtain stat results for the final path in this case, use the :func:`os.path." -"realpath` function to resolve the path name as far as possible and call :" -"func:`lstat` on the result. This does not apply to dangling symlinks or " -"junction points, which will raise the usual exceptions." +"obtain stat results for the final path in this case, use " +"the :func:`os.path.realpath` function to resolve the path name as far as " +"possible and call :func:`lstat` on the result. This does not apply to " +"dangling symlinks or junction points, which will raise the usual exceptions." msgstr "" msgid "Example::" @@ -2811,9 +2850,9 @@ msgid "" msgstr "" msgid "" -"Object whose attributes correspond roughly to the members of the :c:struct:" -"`stat` structure. It is used for the result of :func:`os.stat`, :func:`os." -"fstat` and :func:`os.lstat`." +"Object whose attributes correspond roughly to the members of " +"the :c:struct:`stat` structure. It is used for the result " +"of :func:`os.stat`, :func:`os.fstat` and :func:`os.lstat`." msgstr "" msgid "Attributes:" @@ -2903,24 +2942,25 @@ msgid "" msgstr "" msgid "" -"The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, :" -"attr:`st_ctime` and :attr:`st_birthtime` attributes depend on the operating " -"system and the file system. For example, on Windows systems using the FAT32 " -"file systems, :attr:`st_mtime` has 2-second resolution, and :attr:`st_atime` " -"has only 1-day resolution. See your operating system documentation for " -"details." +"The exact meaning and resolution of " +"the :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime` " +"and :attr:`st_birthtime` attributes depend on the operating system and the " +"file system. For example, on Windows systems using the FAT32 file " +"systems, :attr:`st_mtime` has 2-second resolution, and :attr:`st_atime` has " +"only 1-day resolution. See your operating system documentation for details." msgstr "" msgid "" -"Similarly, although :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:" -"`st_ctime_ns` and :attr:`st_birthtime_ns` are always expressed in " -"nanoseconds, many systems do not provide nanosecond precision. On systems " -"that do provide nanosecond precision, the floating-point object used to " -"store :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime` and :attr:" -"`st_birthtime` cannot preserve all of it, and as such will be slightly " -"inexact. If you need the exact timestamps you should always use :attr:" -"`st_atime_ns`, :attr:`st_mtime_ns`, :attr:`st_ctime_ns` and :attr:" -"`st_birthtime_ns`." +"Similarly, " +"although :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:`st_ctime_ns` " +"and :attr:`st_birthtime_ns` are always expressed in nanoseconds, many " +"systems do not provide nanosecond precision. On systems that do provide " +"nanosecond precision, the floating-point object used to " +"store :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime` " +"and :attr:`st_birthtime` cannot preserve all of it, and as such will be " +"slightly inexact. If you need the exact timestamps you should always " +"use :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:`st_ctime_ns` " +"and :attr:`st_birthtime_ns`." msgstr "" msgid "" @@ -2929,8 +2969,8 @@ msgid "" msgstr "" msgid "" -"Number of 512-byte blocks allocated for file. This may be smaller than :attr:" -"`st_size`/512 when the file has holes." +"Number of 512-byte blocks allocated for file. This may be smaller " +"than :attr:`st_size`/512 when the file has holes." msgstr "" msgid "" @@ -2979,15 +3019,15 @@ msgstr "" msgid "" "Windows file attributes: ``dwFileAttributes`` member of the " "``BY_HANDLE_FILE_INFORMATION`` structure returned by :c:func:`!" -"GetFileInformationByHandle`. See the :const:`!FILE_ATTRIBUTE_* ` constants in the :mod:`stat` module." +"GetFileInformationByHandle`. See the :const:`!FILE_ATTRIBUTE_* " +"` constants in the :mod:`stat` module." msgstr "" msgid "" -"When :attr:`st_file_attributes` has the :const:`~stat." -"FILE_ATTRIBUTE_REPARSE_POINT` set, this field contains the tag identifying " -"the type of reparse point. See the :const:`IO_REPARSE_TAG_* ` constants in the :mod:`stat` module." +"When :attr:`st_file_attributes` has " +"the :const:`~stat.FILE_ATTRIBUTE_REPARSE_POINT` set, this field contains the " +"tag identifying the type of reparse point. See the :const:`IO_REPARSE_TAG_* " +"` constants in the :mod:`stat` module." msgstr "" msgid "" @@ -2999,12 +3039,11 @@ msgstr "" msgid "" "For backward compatibility, a :class:`stat_result` instance is also " "accessible as a tuple of at least 10 integers giving the most important (and " -"portable) members of the :c:struct:`stat` structure, in the order :attr:" -"`st_mode`, :attr:`st_ino`, :attr:`st_dev`, :attr:`st_nlink`, :attr:" -"`st_uid`, :attr:`st_gid`, :attr:`st_size`, :attr:`st_atime`, :attr:" -"`st_mtime`, :attr:`st_ctime`. More items may be added at the end by some " -"implementations. For compatibility with older Python versions, accessing :" -"class:`stat_result` as a tuple always returns integers." +"portable) members of the :c:struct:`stat` structure, in the " +"order :attr:`st_mode`, :attr:`st_ino`, :attr:`st_dev`, :attr:`st_nlink`, :attr:`st_uid`, :attr:`st_gid`, :attr:`st_size`, :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime`. " +"More items may be added at the end by some implementations. For " +"compatibility with older Python versions, accessing :class:`stat_result` as " +"a tuple always returns integers." msgstr "" msgid "Windows now returns the file index as :attr:`st_ino` when available." @@ -3017,8 +3056,8 @@ msgid "Added the :attr:`st_reparse_tag` member on Windows." msgstr "" msgid "" -"On Windows, the :attr:`st_mode` member now identifies special files as :" -"const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate." +"On Windows, the :attr:`st_mode` member now identifies special files " +"as :const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate." msgstr "" msgid "" @@ -3042,44 +3081,95 @@ msgid "Added the :attr:`st_birthtime` member on Windows." msgstr "" msgid "" -"Perform a :c:func:`!statvfs` system call on the given path. The return " -"value is an object whose attributes describe the filesystem on the given " -"path, and correspond to the members of the :c:struct:`statvfs` structure, " -"namely: :attr:`f_bsize`, :attr:`f_frsize`, :attr:`f_blocks`, :attr:" -"`f_bfree`, :attr:`f_bavail`, :attr:`f_files`, :attr:`f_ffree`, :attr:" -"`f_favail`, :attr:`f_flag`, :attr:`f_namemax`, :attr:`f_fsid`." +"Perform a :manpage:`statvfs(3)` system call on the given path. The return " +"value is a :class:`statvfs_result` whose attributes describe the filesystem " +"on the given path and correspond to the members of the :c:struct:`statvfs` " +"structure." msgstr "" msgid "" -"Two module-level constants are defined for the :attr:`f_flag` attribute's " -"bit-flags: if :const:`ST_RDONLY` is set, the filesystem is mounted read-" -"only, and if :const:`ST_NOSUID` is set, the semantics of setuid/setgid bits " -"are disabled or not supported." +"Filesystem statistics returned by :func:`os.statvfs` " +"and :func:`os.fstatvfs`. See :manpage:`statvfs(3)` for more details." +msgstr "" + +msgid "Block size." +msgstr "" + +msgid "Fragment size." msgstr "" msgid "" -"Additional module-level constants are defined for GNU/glibc based systems. " -"These are :const:`ST_NODEV` (disallow access to device special files), :" -"const:`ST_NOEXEC` (disallow program execution), :const:`ST_SYNCHRONOUS` " -"(writes are synced at once), :const:`ST_MANDLOCK` (allow mandatory locks on " -"an FS), :const:`ST_WRITE` (write on file/directory/symlink), :const:" -"`ST_APPEND` (append-only file), :const:`ST_IMMUTABLE` (immutable file), :" -"const:`ST_NOATIME` (do not update access times), :const:`ST_NODIRATIME` (do " -"not update directory access times), :const:`ST_RELATIME` (update atime " -"relative to mtime/ctime)." +"Number of :attr:`~statvfs_result.f_frsize` sized blocks the filesystem can " +"contain." msgstr "" -msgid "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." +msgid "Number of free blocks." +msgstr "" + +msgid "Number of free blocks for unprivileged users." +msgstr "" + +msgid "Number of file entries, inodes, the filesystem can contain." +msgstr "" + +msgid "Number of free files entries." +msgstr "" + +msgid "Number of free file entries for unprivileged users." +msgstr "" + +msgid "" +"Bit-mask of mount flags. The following flags are " +"defined: :data:`ST_RDONLY`, :data:`ST_NOSUID`, :data:`ST_NODEV`, :data:`ST_NOEXEC`, :data:`ST_SYNCHRONOUS`, :data:`ST_MANDLOCK`, :data:`ST_WRITE`, :data:`ST_APPEND`, :data:`ST_IMMUTABLE`, :data:`ST_NOATIME`, :data:`ST_NODIRATIME`, " +"and :data:`ST_RELATIME`." msgstr "" msgid "" -"The :const:`ST_NODEV`, :const:`ST_NOEXEC`, :const:`ST_SYNCHRONOUS`, :const:" -"`ST_MANDLOCK`, :const:`ST_WRITE`, :const:`ST_APPEND`, :const:" -"`ST_IMMUTABLE`, :const:`ST_NOATIME`, :const:`ST_NODIRATIME`, and :const:" -"`ST_RELATIME` constants were added." +"Filesystem max filename length. OS specific limitations such " +"as :ref:`Windows MAX_PATH ` and those described in " +"Linux :manpage:`pathname(7)` may exist." +msgstr "" + +msgid "Filesystem ID." +msgstr "" + +msgid "The following flags are used in :attr:`statvfs_result.f_flag`." msgstr "" -msgid "Added the :attr:`f_fsid` attribute." +msgid "Read-only filesystem." +msgstr "" + +msgid "Setuid/setgid bits are disabled or not supported." +msgstr "" + +msgid "Disallow access to device special files." +msgstr "" + +msgid "Disallow program execution." +msgstr "" + +msgid "Writes are synced at once." +msgstr "" + +msgid "Allow mandatory locks on an FS." +msgstr "" + +msgid "Write on file/directory/symlink." +msgstr "" + +msgid "Append-only file." +msgstr "" + +msgid "Immutable file." +msgstr "" + +msgid "Do not update access times." +msgstr "" + +msgid "Do not update directory access times." +msgstr "" + +msgid "Update atime relative to mtime/ctime." msgstr "" msgid "" @@ -3112,8 +3202,8 @@ msgid "" "A :class:`set` object indicating whether :func:`os.access` permits " "specifying ``True`` for its *effective_ids* parameter on the local platform. " "(Specifying ``False`` for *effective_ids* is always supported on all " -"platforms.) If the local platform supports it, the collection will contain :" -"func:`os.access`; otherwise it will be empty." +"platforms.) If the local platform supports it, the collection will " +"contain :func:`os.access`; otherwise it will be empty." msgstr "" msgid "" @@ -3140,8 +3230,8 @@ msgstr "" msgid "" "To determine whether a particular function permits specifying an open file " "descriptor for its *path* parameter, use the ``in`` operator on " -"``supports_fd``. As an example, this expression evaluates to ``True`` if :" -"func:`os.chdir` accepts open file descriptors for *path* on your local " +"``supports_fd``. As an example, this expression evaluates to ``True`` " +"if :func:`os.chdir` accepts open file descriptors for *path* on your local " "platform::" msgstr "" @@ -3164,8 +3254,8 @@ msgid "" "To check whether a particular function accepts ``False`` for its " "*follow_symlinks* parameter, use the ``in`` operator on " "``supports_follow_symlinks``. As an example, this expression evaluates to " -"``True`` if you may specify ``follow_symlinks=False`` when calling :func:`os." -"stat` on the local platform::" +"``True`` if you may specify ``follow_symlinks=False`` when " +"calling :func:`os.stat` on the local platform::" msgstr "" msgid "os.stat in os.supports_follow_symlinks" @@ -3258,12 +3348,12 @@ msgid "It is an error to specify tuples for both *times* and *ns*." msgstr "" msgid "" -"Note that the exact times you set here may not be returned by a subsequent :" -"func:`~os.stat` call, depending on the resolution with which your operating " -"system records access and modification times; see :func:`~os.stat`. The best " -"way to preserve exact times is to use the *st_atime_ns* and *st_mtime_ns* " -"fields from the :func:`os.stat` result object with the *ns* parameter to :" -"func:`utime`." +"Note that the exact times you set here may not be returned by a " +"subsequent :func:`~os.stat` call, depending on the resolution with which " +"your operating system records access and modification times; " +"see :func:`~os.stat`. The best way to preserve exact times is to use the " +"*st_atime_ns* and *st_mtime_ns* fields from the :func:`os.stat` result " +"object with the *ns* parameter to :func:`utime`." msgstr "" msgid "" @@ -3476,10 +3566,10 @@ msgstr "" msgid "" "Create and return an event file descriptor. The file descriptors supports " -"raw :func:`read` and :func:`write` with a buffer size of 8, :func:`~select." -"select`, :func:`~select.poll` and similar. See man page :manpage:" -"`eventfd(2)` for more information. By default, the new file descriptor is :" -"ref:`non-inheritable `." +"raw :func:`read` and :func:`write` with a buffer size of " +"8, :func:`~select.select`, :func:`~select.poll` and similar. See man " +"page :manpage:`eventfd(2)` for more information. By default, the new file " +"descriptor is :ref:`non-inheritable `." msgstr "" msgid "" @@ -3495,8 +3585,8 @@ msgid "" msgstr "" msgid "" -"If :const:`EFD_SEMAPHORE` is specified and the event counter is non-zero, :" -"func:`eventfd_read` returns 1 and decrements the counter by one." +"If :const:`EFD_SEMAPHORE` is specified and the event counter is non-" +"zero, :func:`eventfd_read` returns 1 and decrements the counter by one." msgstr "" msgid "" @@ -3506,14 +3596,14 @@ msgid "" msgstr "" msgid "" -"If the event counter is zero and :const:`EFD_NONBLOCK` is not specified, :" -"func:`eventfd_read` blocks." +"If the event counter is zero and :const:`EFD_NONBLOCK` is not " +"specified, :func:`eventfd_read` blocks." msgstr "" msgid "" ":func:`eventfd_write` increments the event counter. Write blocks if the " -"write operation would increment the counter to a value larger than 2\\ :sup:" -"`64`\\ -\\ 2." +"write operation would increment the counter to a value larger than " +"2\\ :sup:`64`\\ -\\ 2." msgstr "" msgid "" @@ -3582,8 +3672,8 @@ msgid "" "The file descriptor's :func:`read` method can be called with a buffer size " "of 8. If the timer has already expired one or more times, :func:`read` " "returns the number of expirations with the host's endianness, which may be " -"converted to an :class:`int` by ``int.from_bytes(x, byteorder=sys." -"byteorder)``." +"converted to an :class:`int` by ``int.from_bytes(x, " +"byteorder=sys.byteorder)``." msgstr "" msgid "" @@ -3607,9 +3697,9 @@ msgstr "" msgid "" "If *clockid* is :const:`time.CLOCK_REALTIME`, a settable system-wide real-" -"time clock is used. If system clock is changed, timer setting need to be " -"updated. To cancel timer when system clock is changed, see :const:" -"`TFD_TIMER_CANCEL_ON_SET`." +"time clock is used. If the system clock is changed, the timer setting needs " +"to be updated. To cancel the timer when the system clock is changed, " +"see :const:`TFD_TIMER_CANCEL_ON_SET`." msgstr "" msgid "" @@ -3619,8 +3709,9 @@ msgid "" msgstr "" msgid "" -"If *clockid* is :const:`time.CLOCK_BOOTTIME`, same as :const:`time." -"CLOCK_MONOTONIC` except it includes any time that the system is suspended." +"If *clockid* is :const:`time.CLOCK_BOOTTIME`, it is the same " +"as :const:`time.CLOCK_MONOTONIC` except it includes any time that the system " +"is suspended." msgstr "" msgid "" @@ -3637,9 +3728,9 @@ msgstr ":const:`TFD_CLOEXEC`" msgid "" "If :const:`TFD_NONBLOCK` is not set as a flag, :func:`read` blocks until the " -"timer expires. If it is set as a flag, :func:`read` doesn't block, but If " +"timer expires. If it is set as a flag, :func:`read` doesn't block, but if " "there hasn't been an expiration since the last call to read, :func:`read` " -"raises :class:`OSError` with ``errno`` is set to :const:`errno.EAGAIN`." +"raises :class:`OSError` with ``errno`` set to :const:`errno.EAGAIN`." msgstr "" msgid ":const:`TFD_CLOEXEC` is always set by Python automatically." @@ -3675,14 +3766,12 @@ msgstr ":const:`TFD_TIMER_CANCEL_ON_SET`" msgid "" "The timer is disabled by setting *initial* to zero (``0``). If *initial* is " -"equal to or greater than zero, the timer is enabled. If *initial* is less " -"than zero, it raises an :class:`OSError` exception with ``errno`` set to :" -"const:`errno.EINVAL`" +"greater than zero, the timer is enabled. If *initial* is less than zero, it " +"raises an :class:`OSError` exception with ``errno`` set " +"to :const:`errno.EINVAL`." msgstr "" -msgid "" -"By default the timer will fire when *initial* seconds have elapsed. (If " -"*initial* is zero, timer will fire immediately.)" +msgid "By default the timer will fire when *initial* seconds have elapsed." msgstr "" msgid "" @@ -3696,16 +3785,16 @@ msgid "" "*interval* is zero, the timer only fires once, on the initial expiration. If " "*interval* is greater than zero, the timer fires every time *interval* " "seconds have elapsed since the previous expiration. If *interval* is less " -"than zero, it raises :class:`OSError` with ``errno`` set to :const:`errno." -"EINVAL`" +"than zero, it raises :class:`OSError` with ``errno`` set " +"to :const:`errno.EINVAL`." msgstr "" msgid "" -"If the :const:`TFD_TIMER_CANCEL_ON_SET` flag is set along with :const:" -"`TFD_TIMER_ABSTIME` and the clock for this timer is :const:`time." -"CLOCK_REALTIME`, the timer is marked as cancelable if the real-time clock is " -"changed discontinuously. Reading the descriptor is aborted with the error " -"ECANCELED." +"If the :const:`TFD_TIMER_CANCEL_ON_SET` flag is set along " +"with :const:`TFD_TIMER_ABSTIME` and the clock for this timer " +"is :const:`time.CLOCK_REALTIME`, the timer is marked as cancelable if the " +"real-time clock is changed discontinuously. Reading the descriptor is " +"aborted with the error :const:`errno.ECANCELED`." msgstr "" msgid "" @@ -3733,8 +3822,8 @@ msgid "" msgstr "" msgid "" -":manpage:`timerfd_create(2)`, :manpage:`timerfd_settime(2)`, :manpage:" -"`settimeofday(2)`, :manpage:`clock_settime(2)`, and :manpage:`date(1)`." +":manpage:`timerfd_create(2)`, :manpage:`timerfd_settime(2)`, :manpage:`settimeofday(2)`, :manpage:`clock_settime(2)`, " +"and :manpage:`date(1)`." msgstr "" msgid "" @@ -3762,9 +3851,9 @@ msgid "Similar to :func:`timerfd_gettime`, but return time as nanoseconds." msgstr "" msgid "" -"A flag for the :func:`timerfd_create` function, which sets the :const:" -"`O_NONBLOCK` status flag for the new timer file descriptor. If :const:" -"`TFD_NONBLOCK` is not set as a flag, :func:`read` blocks." +"A flag for the :func:`timerfd_create` function, which sets " +"the :const:`O_NONBLOCK` status flag for the new timer file descriptor. " +"If :const:`TFD_NONBLOCK` is not set as a flag, :func:`read` blocks." msgstr "" msgid "" @@ -3793,9 +3882,9 @@ msgstr "" msgid "" "Return the value of the extended filesystem attribute *attribute* for " -"*path*. *attribute* can be bytes or str (directly or indirectly through the :" -"class:`PathLike` interface). If it is str, it is encoded with the filesystem " -"encoding." +"*path*. *attribute* can be bytes or str (directly or indirectly through " +"the :class:`PathLike` interface). If it is str, it is encoded with the " +"filesystem encoding." msgstr "" msgid "" @@ -3820,9 +3909,9 @@ msgstr "" msgid "" "Removes the extended filesystem attribute *attribute* from *path*. " -"*attribute* should be bytes or str (directly or indirectly through the :" -"class:`PathLike` interface). If it is a string, it is encoded with the :term:" -"`filesystem encoding and error handler`." +"*attribute* should be bytes or str (directly or indirectly through " +"the :class:`PathLike` interface). If it is a string, it is encoded with " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "" @@ -3836,9 +3925,9 @@ msgid "" "indirectly through the :class:`PathLike` interface). If it is a str, it is " "encoded with the :term:`filesystem encoding and error handler`. *flags* may " "be :data:`XATTR_REPLACE` or :data:`XATTR_CREATE`. If :data:`XATTR_REPLACE` " -"is given and the attribute does not exist, ``ENODATA`` will be raised. If :" -"data:`XATTR_CREATE` is given and the attribute already exists, the attribute " -"will not be created and ``EEXISTS`` will be raised." +"is given and the attribute does not exist, ``ENODATA`` will be raised. " +"If :data:`XATTR_CREATE` is given and the attribute already exists, the " +"attribute will not be created and ``EEXISTS`` will be raised." msgstr "" msgid "" @@ -3886,8 +3975,8 @@ msgid "" "Generate a :const:`SIGABRT` signal to the current process. On Unix, the " "default behavior is to produce a core dump; on Windows, the process " "immediately returns an exit code of ``3``. Be aware that calling this " -"function will not call the Python signal handler registered for :const:" -"`SIGABRT` with :func:`signal.signal`." +"function will not call the Python signal handler registered " +"for :const:`SIGABRT` with :func:`signal.signal`." msgstr "" msgid "Add a path to the DLL search path." @@ -3905,9 +3994,9 @@ msgid "" msgstr "" msgid "" -"See the `Microsoft documentation `_ for more information about how " -"DLLs are loaded." +"See the `Microsoft documentation `_ for more information about how DLLs " +"are loaded." msgstr "" msgid "" @@ -3938,8 +4027,8 @@ msgstr "" msgid "" "The current process is replaced immediately. Open file objects and " "descriptors are not flushed, so if there may be data buffered on these open " -"files, you should flush them using :func:`~io.IOBase.flush` or :func:`os." -"fsync` before calling an :func:`exec\\* ` function." +"files, you should flush them using :func:`~io.IOBase.flush` " +"or :func:`os.fsync` before calling an :func:`exec\\* ` function." msgstr "" msgid "" @@ -3955,33 +4044,34 @@ msgid "" msgstr "" msgid "" -"The variants which include a \"p\" near the end (:func:`execlp`, :func:" -"`execlpe`, :func:`execvp`, and :func:`execvpe`) will use the :envvar:`PATH` " -"environment variable to locate the program *file*. When the environment is " -"being replaced (using one of the :func:`exec\\*e ` variants, " -"discussed in the next paragraph), the new environment is used as the source " -"of the :envvar:`PATH` variable. The other variants, :func:`execl`, :func:" -"`execle`, :func:`execv`, and :func:`execve`, will not use the :envvar:`PATH` " -"variable to locate the executable; *path* must contain an appropriate " -"absolute or relative path. Relative paths must include at least one slash, " -"even on Windows, as plain names will not be resolved." +"The variants which include a \"p\" near the end " +"(:func:`execlp`, :func:`execlpe`, :func:`execvp`, and :func:`execvpe`) will " +"use the :envvar:`PATH` environment variable to locate the program *file*. " +"When the environment is being replaced (using one of the :func:`exec\\*e " +"` variants, discussed in the next paragraph), the new environment is " +"used as the source of the :envvar:`PATH` variable. The other " +"variants, :func:`execl`, :func:`execle`, :func:`execv`, and :func:`execve`, " +"will not use the :envvar:`PATH` variable to locate the executable; *path* " +"must contain an appropriate absolute or relative path. Relative paths must " +"include at least one slash, even on Windows, as plain names will not be " +"resolved." msgstr "" msgid "" "For :func:`execle`, :func:`execlpe`, :func:`execve`, and :func:`execvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " "which is used to define the environment variables for the new process (these " -"are used instead of the current process' environment); the functions :func:" -"`execl`, :func:`execlp`, :func:`execv`, and :func:`execvp` all cause the new " -"process to inherit the environment of the current process." +"are used instead of the current process' environment); the " +"functions :func:`execl`, :func:`execlp`, :func:`execv`, and :func:`execvp` " +"all cause the new process to inherit the environment of the current process." msgstr "" msgid "" "For :func:`execve` on some platforms, *path* may also be specified as an " "open file descriptor. This functionality may not be supported on your " -"platform; you can check whether or not it is available using :data:`os." -"supports_fd`. If it is unavailable, using it will raise a :exc:" -"`NotImplementedError`." +"platform; you can check whether or not it is available " +"using :data:`os.supports_fd`. If it is unavailable, using it will raise " +"a :exc:`NotImplementedError`." msgstr "" msgid "" @@ -3990,8 +4080,8 @@ msgid "" msgstr "" msgid "" -"Added support for specifying *path* as an open file descriptor for :func:" -"`execve`." +"Added support for specifying *path* as an open file descriptor " +"for :func:`execve`." msgstr "" msgid "" @@ -4109,13 +4199,13 @@ msgid "" msgstr "" msgid "" -"Calling ``fork()`` in a subinterpreter is no longer supported (:exc:" -"`RuntimeError` is raised)." +"Calling ``fork()`` in a subinterpreter is no longer supported " +"(:exc:`RuntimeError` is raised)." msgstr "" msgid "" -"If Python is able to detect that your process has multiple threads, :func:" -"`os.fork` now raises a :exc:`DeprecationWarning`." +"If Python is able to detect that your process has multiple " +"threads, :func:`os.fork` now raises a :exc:`DeprecationWarning`." msgstr "" msgid "" @@ -4153,14 +4243,14 @@ msgid "" msgstr "" msgid "" -"Calling ``forkpty()`` in a subinterpreter is no longer supported (:exc:" -"`RuntimeError` is raised)." +"Calling ``forkpty()`` in a subinterpreter is no longer supported " +"(:exc:`RuntimeError` is raised)." msgstr "" msgid "" "If Python is able to detect that your process has multiple threads, this now " -"raises a :exc:`DeprecationWarning`. See the longer explanation on :func:`os." -"fork`." +"raises a :exc:`DeprecationWarning`. See the longer explanation " +"on :func:`os.fork`." msgstr "" msgid "" @@ -4169,10 +4259,10 @@ msgid "" msgstr "" msgid "" -"Windows: The :const:`signal.CTRL_C_EVENT` and :const:`signal." -"CTRL_BREAK_EVENT` signals are special signals which can only be sent to " -"console processes which share a common console window, e.g., some " -"subprocesses. Any other value for *sig* will cause the process to be " +"Windows: The :const:`signal.CTRL_C_EVENT` " +"and :const:`signal.CTRL_BREAK_EVENT` signals are special signals which can " +"only be sent to console processes which share a common console window, e.g., " +"some subprocesses. Any other value for *sig* will cause the process to be " "unconditionally killed by the TerminateProcess API, and the exit code will " "be set to *sig*." msgstr "" @@ -4222,9 +4312,9 @@ msgid "" "Open a pipe to or from command *cmd*. The return value is an open file " "object connected to the pipe, which can be read or written depending on " "whether *mode* is ``'r'`` (default) or ``'w'``. The *buffering* argument " -"have the same meaning as the corresponding argument to the built-in :func:" -"`open` function. The returned file object reads or writes text strings " -"rather than bytes." +"have the same meaning as the corresponding argument to the built-" +"in :func:`open` function. The returned file object reads or writes text " +"strings rather than bytes." msgstr "" msgid "" @@ -4256,9 +4346,9 @@ msgid "" msgstr "" msgid "" -":func:`popen` is a simple wrapper around :class:`subprocess.Popen`. Use :" -"class:`subprocess.Popen` or :func:`subprocess.run` to control options like " -"encodings." +":func:`popen` is a simple wrapper around :class:`subprocess.Popen`. " +"Use :class:`subprocess.Popen` or :func:`subprocess.run` to control options " +"like encodings." msgstr "" msgid "The :mod:`subprocess` module is recommended instead." @@ -4272,9 +4362,9 @@ msgid "" msgstr "" msgid "" -"The positional-only arguments *path*, *args*, and *env* are similar to :func:" -"`execve`. *env* is allowed to be ``None``, in which case current process' " -"environment is used." +"The positional-only arguments *path*, *args*, and *env* are similar " +"to :func:`execve`. *env* is allowed to be ``None``, in which case current " +"process' environment is used." msgstr "" msgid "" @@ -4320,8 +4410,8 @@ msgid "" "posix_spawn_file_actions_addopen`, :c:func:`!" "posix_spawn_file_actions_addclose`, :c:func:`!" "posix_spawn_file_actions_adddup2`, and :c:func:`!" -"posix_spawn_file_actions_addclosefrom_np` API calls used to prepare for the :" -"c:func:`!posix_spawn` call itself." +"posix_spawn_file_actions_addclosefrom_np` API calls used to prepare for " +"the :c:func:`!posix_spawn` call itself." msgstr "" msgid "" @@ -4344,9 +4434,9 @@ msgstr "" msgid "" "If the *setsid* argument is ``True``, it will create a new session ID for " -"``posix_spawn``. *setsid* requires :c:macro:`!POSIX_SPAWN_SETSID` or :c:" -"macro:`!POSIX_SPAWN_SETSID_NP` flag. Otherwise, :exc:`NotImplementedError` " -"is raised." +"``posix_spawn``. *setsid* requires :c:macro:`!POSIX_SPAWN_SETSID` " +"or :c:macro:`!POSIX_SPAWN_SETSID_NP` flag. " +"Otherwise, :exc:`NotImplementedError` is raised." msgstr "" msgid "" @@ -4395,9 +4485,9 @@ msgid "See :func:`posix_spawn` documentation." msgstr "" msgid "" -"Register callables to be executed when a new child process is forked using :" -"func:`os.fork` or similar process cloning APIs. The parameters are optional " -"and keyword-only. Each specifies a different call point." +"Register callables to be executed when a new child process is forked " +"using :func:`os.fork` or similar process cloning APIs. The parameters are " +"optional and keyword-only. Each specifies a different call point." msgstr "" msgid "*before* is a function called before forking a child process." @@ -4425,8 +4515,9 @@ msgstr "" msgid "" "Note that :c:func:`fork` calls made by third-party C code may not call those " -"functions, unless it explicitly calls :c:func:`PyOS_BeforeFork`, :c:func:" -"`PyOS_AfterFork_Parent` and :c:func:`PyOS_AfterFork_Child`." +"functions, unless it explicitly " +"calls :c:func:`PyOS_BeforeFork`, :c:func:`PyOS_AfterFork_Parent` " +"and :c:func:`PyOS_AfterFork_Child`." msgstr "" msgid "There is no way to unregister a function." @@ -4438,8 +4529,8 @@ msgstr "" msgid "" "(Note that the :mod:`subprocess` module provides more powerful facilities " "for spawning new processes and retrieving their results; using that module " -"is preferable to using these functions. Check especially the :ref:" -"`subprocess-replacements` section.)" +"is preferable to using these functions. Check especially " +"the :ref:`subprocess-replacements` section.)" msgstr "" msgid "" @@ -4467,26 +4558,27 @@ msgid "" msgstr "" msgid "" -"The variants which include a second \"p\" near the end (:func:`spawnlp`, :" -"func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) will use the :envvar:" -"`PATH` environment variable to locate the program *file*. When the " -"environment is being replaced (using one of the :func:`spawn\\*e ` " -"variants, discussed in the next paragraph), the new environment is used as " -"the source of the :envvar:`PATH` variable. The other variants, :func:" -"`spawnl`, :func:`spawnle`, :func:`spawnv`, and :func:`spawnve`, will not use " -"the :envvar:`PATH` variable to locate the executable; *path* must contain an " -"appropriate absolute or relative path." +"The variants which include a second \"p\" near the end " +"(:func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) " +"will use the :envvar:`PATH` environment variable to locate the program " +"*file*. When the environment is being replaced (using one of " +"the :func:`spawn\\*e ` variants, discussed in the next paragraph), " +"the new environment is used as the source of the :envvar:`PATH` variable. " +"The other variants, :func:`spawnl`, :func:`spawnle`, :func:`spawnv`, " +"and :func:`spawnve`, will not use the :envvar:`PATH` variable to locate the " +"executable; *path* must contain an appropriate absolute or relative path." msgstr "" msgid "" "For :func:`spawnle`, :func:`spawnlpe`, :func:`spawnve`, and :func:`spawnvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " "which is used to define the environment variables for the new process (they " -"are used instead of the current process' environment); the functions :func:" -"`spawnl`, :func:`spawnlp`, :func:`spawnv`, and :func:`spawnvp` all cause the " -"new process to inherit the environment of the current process. Note that " -"keys and values in the *env* dictionary must be strings; invalid keys or " -"values will cause the function to fail, with a return value of ``127``." +"are used instead of the current process' environment); the " +"functions :func:`spawnl`, :func:`spawnlp`, :func:`spawnv`, " +"and :func:`spawnvp` all cause the new process to inherit the environment of " +"the current process. Note that keys and values in the *env* dictionary must " +"be strings; invalid keys or values will cause the function to fail, with a " +"return value of ``127``." msgstr "" msgid "" @@ -4516,9 +4608,9 @@ msgstr "" msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " -"family of functions. If either of these values is given, the :func:" -"`spawn\\* ` functions will return as soon as the new process has " -"been created, with the process id as the return value." +"family of functions. If either of these values is given, " +"the :func:`spawn\\* ` functions will return as soon as the new " +"process has been created, with the process id as the return value." msgstr "" msgid "" @@ -4531,11 +4623,11 @@ msgstr "" msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " -"family of functions. These are less portable than those listed above. :" -"const:`P_DETACH` is similar to :const:`P_NOWAIT`, but the new process is " -"detached from the console of the calling process. If :const:`P_OVERLAY` is " -"used, the current process will be replaced; the :func:`spawn\\* ` " -"function will not return." +"family of functions. These are less portable than those listed " +"above. :const:`P_DETACH` is similar to :const:`P_NOWAIT`, but the new " +"process is detached from the console of the calling process. " +"If :const:`P_OVERLAY` is used, the current process will be replaced; " +"the :func:`spawn\\* ` function will not return." msgstr "" msgid "Start a file with its associated application." @@ -4543,9 +4635,9 @@ msgstr "" msgid "" "When *operation* is not specified, this acts like double-clicking the file " -"in Windows Explorer, or giving the file name as an argument to the :program:" -"`start` command from the interactive command shell: the file is opened with " -"whatever application (if any) its extension is associated." +"in Windows Explorer, or giving the file name as an argument to " +"the :program:`start` command from the interactive command shell: the file is " +"opened with whatever application (if any) its extension is associated." msgstr "" msgid "" @@ -4600,8 +4692,8 @@ msgid "" msgstr "" msgid "" -"Added the *arguments*, *cwd* and *show_cmd* arguments, and the ``os." -"startfile/2`` audit event." +"Added the *arguments*, *cwd* and *show_cmd* arguments, and the " +"``os.startfile/2`` audit event." msgstr "" msgid "" @@ -4621,10 +4713,10 @@ msgstr "" msgid "" "On Windows, the return value is that returned by the system shell after " -"running *command*. The shell is given by the Windows environment variable :" -"envvar:`COMSPEC`: it is usually :program:`cmd.exe`, which returns the exit " -"status of the command run; on systems using a non-native shell, consult your " -"shell documentation." +"running *command*. The shell is given by the Windows environment " +"variable :envvar:`COMSPEC`: it is usually :program:`cmd.exe`, which returns " +"the exit status of the command run; on systems using a non-native shell, " +"consult your shell documentation." msgstr "" msgid "" @@ -4672,8 +4764,8 @@ msgid "" msgstr "" msgid "" -"See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " +"See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " "GetProcessTimes MSDN `_ on Windows. On " "Windows, only :attr:`!user` and :attr:`!system` are known; the other " @@ -4700,28 +4792,28 @@ msgstr "" msgid "" "The other :func:`!wait*` functions documented below can be used to wait for " -"the completion of a specific child process and have more options. :func:" -"`waitpid` is the only one also available on Windows." +"the completion of a specific child process and have more " +"options. :func:`waitpid` is the only one also available on Windows." msgstr "" msgid "Wait for the completion of a child process." msgstr "" msgid "" -"*idtype* can be :data:`P_PID`, :data:`P_PGID`, :data:`P_ALL`, or (on Linux) :" -"data:`P_PIDFD`. The interpretation of *id* depends on it; see their " +"*idtype* can be :data:`P_PID`, :data:`P_PGID`, :data:`P_ALL`, or (on " +"Linux) :data:`P_PIDFD`. The interpretation of *id* depends on it; see their " "individual descriptions." msgstr "" msgid "" -"*options* is an OR combination of flags. At least one of :data:`WEXITED`, :" -"data:`WSTOPPED` or :data:`WCONTINUED` is required; :data:`WNOHANG` and :data:" -"`WNOWAIT` are additional optional flags." +"*options* is an OR combination of flags. At least one " +"of :data:`WEXITED`, :data:`WSTOPPED` or :data:`WCONTINUED` is " +"required; :data:`WNOHANG` and :data:`WNOWAIT` are additional optional flags." msgstr "" msgid "" -"The return value is an object representing the data contained in the :c:type:" -"`siginfo_t` structure with the following attributes:" +"The return value is an object representing the data contained in " +"the :c:type:`siginfo_t` structure with the following attributes:" msgstr "" msgid ":attr:`!si_pid` (process ID)" @@ -4784,9 +4876,9 @@ msgid "" "bits (shifting makes cross-platform use of the function easier). A *pid* " "less than or equal to ``0`` has no special meaning on Windows, and raises an " "exception. The value of integer *options* has no effect. *pid* can refer to " -"any process whose id is known, not necessarily a child process. The :func:" -"`spawn\\* ` functions called with :const:`P_NOWAIT` return suitable " -"process handles." +"any process whose id is known, not necessarily a child process. " +"The :func:`spawn\\* ` functions called with :const:`P_NOWAIT` return " +"suitable process handles." msgstr "" msgid "" @@ -4836,8 +4928,8 @@ msgid "The :data:`!P_PIDFD` constant." msgstr "" msgid "" -"This *options* flag for :func:`waitpid`, :func:`wait3`, :func:`wait4`, and :" -"func:`waitid` causes child processes to be reported if they have been " +"This *options* flag for :func:`waitpid`, :func:`wait3`, :func:`wait4`, " +"and :func:`waitid` causes child processes to be reported if they have been " "continued from a job control stop since they were last reported." msgstr "" @@ -4921,14 +5013,14 @@ msgid "" msgstr "" msgid "" -":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:" -"`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` functions." +":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` " +"functions." msgstr "" msgid "" -"The following functions take a process status code as returned by :func:" -"`system`, :func:`wait`, or :func:`waitpid` as a parameter. They may be used " -"to determine the disposition of a process." +"The following functions take a process status code as returned " +"by :func:`system`, :func:`wait`, or :func:`waitpid` as a parameter. They " +"may be used to determine the disposition of a process." msgstr "" msgid "" @@ -4940,9 +5032,9 @@ msgid "This function should be employed only if :func:`WIFSIGNALED` is true." msgstr "" msgid "" -"Return ``True`` if a stopped child has been resumed by delivery of :const:" -"`~signal.SIGCONT` (if the process has been continued from a job control " -"stop), otherwise return ``False``." +"Return ``True`` if a stopped child has been resumed by delivery " +"of :const:`~signal.SIGCONT` (if the process has been continued from a job " +"control stop), otherwise return ``False``." msgstr "" msgid "See :data:`WCONTINUED` option." @@ -5032,9 +5124,9 @@ msgid "" msgstr "" msgid "" -"This class represents tunable scheduling parameters used in :func:" -"`sched_setparam`, :func:`sched_setscheduler`, and :func:`sched_getparam`. It " -"is immutable." +"This class represents tunable scheduling parameters used " +"in :func:`sched_setparam`, :func:`sched_setscheduler`, " +"and :func:`sched_getparam`. It is immutable." msgstr "" msgid "At the moment, there is only one possible parameter:" @@ -5122,8 +5214,8 @@ msgstr "" msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " -"included in ``confstr_names``, an :exc:`OSError` is raised with :const:" -"`errno.EINVAL` for the error number." +"included in ``confstr_names``, an :exc:`OSError` is raised " +"with :const:`errno.EINVAL` for the error number." msgstr "" msgid "" @@ -5155,8 +5247,8 @@ msgstr "" msgid "" "Get the number of logical CPUs usable by the calling thread of the **current " -"process**. Returns ``None`` if undetermined. It can be less than :func:" -"`cpu_count` depending on the CPU affinity." +"process**. Returns ``None`` if undetermined. It can be less " +"than :func:`cpu_count` depending on the CPU affinity." msgstr "" msgid "" @@ -5201,22 +5293,22 @@ msgstr "" msgid "" "The constant string used by the operating system to refer to the current " -"directory. This is ``'.'`` for Windows and POSIX. Also available via :mod:" -"`os.path`." +"directory. This is ``'.'`` for Windows and POSIX. Also available " +"via :mod:`os.path`." msgstr "" msgid "" "The constant string used by the operating system to refer to the parent " -"directory. This is ``'..'`` for Windows and POSIX. Also available via :mod:" -"`os.path`." +"directory. This is ``'..'`` for Windows and POSIX. Also available " +"via :mod:`os.path`." msgstr "" msgid "" "The character used by the operating system to separate pathname components. " "This is ``'/'`` for POSIX and ``'\\\\'`` for Windows. Note that knowing " -"this is not sufficient to be able to parse or concatenate pathnames --- use :" -"func:`os.path.split` and :func:`os.path.join` --- but it is occasionally " -"useful. Also available via :mod:`os.path`." +"this is not sufficient to be able to parse or concatenate pathnames --- " +"use :func:`os.path.split` and :func:`os.path.join` --- but it is " +"occasionally useful. Also available via :mod:`os.path`." msgstr "" msgid "" @@ -5238,17 +5330,17 @@ msgid "" msgstr "" msgid "" -"The default search path used by :func:`exec\\*p\\* ` and :func:" -"`spawn\\*p\\* ` if the environment doesn't have a ``'PATH'`` key. " -"Also available via :mod:`os.path`." +"The default search path used by :func:`exec\\*p\\* ` " +"and :func:`spawn\\*p\\* ` if the environment doesn't have a " +"``'PATH'`` key. Also available via :mod:`os.path`." msgstr "" msgid "" "The string used to separate (or, rather, terminate) lines on the current " "platform. This may be a single character, such as ``'\\n'`` for POSIX, or " -"multiple characters, for example, ``'\\r\\n'`` for Windows. Do not use *os." -"linesep* as a line terminator when writing files opened in text mode (the " -"default); use a single ``'\\n'`` instead, on all platforms." +"multiple characters, for example, ``'\\r\\n'`` for Windows. Do not use " +"*os.linesep* as a line terminator when writing files opened in text mode " +"(the default); use a single ``'\\n'`` instead, on all platforms." msgstr "" msgid "" @@ -5257,9 +5349,9 @@ msgid "" msgstr "" msgid "" -"Flags for use with the :func:`~sys.setdlopenflags` and :func:`~sys." -"getdlopenflags` functions. See the Unix manual page :manpage:`dlopen(3)` " -"for what the different flags mean." +"Flags for use with the :func:`~sys.setdlopenflags` " +"and :func:`~sys.getdlopenflags` functions. See the Unix manual " +"page :manpage:`dlopen(3)` for what the different flags mean." msgstr "" msgid "Random numbers" @@ -5284,8 +5376,8 @@ msgstr "" msgid "" "The flags argument is a bit mask that can contain zero or more of the " -"following values ORed together: :py:const:`os.GRND_RANDOM` and :py:data:" -"`GRND_NONBLOCK`." +"following values ORed together: :py:const:`os.GRND_RANDOM` " +"and :py:data:`GRND_NONBLOCK`." msgstr "" msgid "" diff --git a/library/pathlib.po b/library/pathlib.po index f13159bcf7..1b8907b141 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -72,8 +73,8 @@ msgid ":pep:`428`: The pathlib module -- object-oriented filesystem paths." msgstr "" msgid "" -"For low-level path manipulation on strings, you can also use the :mod:`os." -"path` module." +"For low-level path manipulation on strings, you can also use " +"the :mod:`os.path` module." msgstr "" msgid "Basic use" @@ -194,19 +195,19 @@ msgstr "" ">>> PurePath(Path('foo'), Path('bar'))\n" "PurePosixPath('foo/bar')" -msgid "When *pathsegments* is empty, the current directory is assumed::" +msgid "" +"When *pathsegments* is empty or consists only of empty strings, the current " +"directory is assumed::" msgstr "" msgid "" -">>> PurePath()\n" -"PurePosixPath('.')" +">>> PurePath(), PurePath('')\n" +"(PurePosixPath('.'), PurePosixPath('.'))" msgstr "" -">>> PurePath()\n" -"PurePosixPath('.')" msgid "" -"If a segment is an absolute path, all previous segments are ignored (like :" -"func:`os.path.join`)::" +"If a segment is an absolute path, all previous segments are ignored " +"(like :func:`os.path.join`)::" msgstr "" msgid "" @@ -221,8 +222,8 @@ msgstr "" "PureWindowsPath('d:bar')" msgid "" -"On Windows, the drive is not reset when a rooted relative path segment (e." -"g., ``r'\\foo'``) is encountered::" +"On Windows, the drive is not reset when a rooted relative path segment " +"(e.g., ``r'\\foo'``) is encountered::" msgstr "" msgid "" @@ -378,8 +379,8 @@ msgstr "" "PureWindowsPath('c:/Program Files')" msgid "" -"A path object can be used anywhere an object implementing :class:`os." -"PathLike` is accepted::" +"A path object can be used anywhere an object " +"implementing :class:`os.PathLike` is accepted::" msgstr "" msgid "" @@ -465,6 +466,26 @@ msgstr "" msgid "Methods and properties" msgstr "" +msgid "" +"The :attr:`~PurePath.parent`, :attr:`~PurePath.name`, :attr:`~PurePath.stem`, " +"and :attr:`~PurePath.suffix` properties describe different parts of a path. " +"For example, given::" +msgstr "" + +msgid ">>> p = PurePosixPath('/srv/holy/grail.tar.gz')" +msgstr "" + +msgid "" +"For p = PurePosixPath('/srv/holy/grail.tar.gz'), p.parent is\n" +"PurePosixPath('/srv/holy'), p.name is 'grail.tar.gz',\n" +"p.stem is 'grail.tar', and p.suffix is '.gz'." +msgstr "" + +msgid "" +"The stem excludes only the final suffix: in this example, it includes " +"``.tar``." +msgstr "" + msgid "Pure paths provide the following methods and properties:" msgstr "" @@ -530,8 +551,8 @@ msgstr "" "'\\\\'" msgid "" -"If the path starts with more than two successive slashes, :class:`~pathlib." -"PurePosixPath` collapses them::" +"If the path starts with more than two successive " +"slashes, :class:`~pathlib.PurePosixPath` collapses them::" msgstr "" msgid "" @@ -551,8 +572,8 @@ msgstr "" msgid "" "This behavior conforms to *The Open Group Base Specifications Issue 6*, " -"paragraph `4.11 Pathname Resolution `_:" +"paragraph `4.11 Pathname Resolution `_:" msgstr "" msgid "" @@ -851,19 +872,26 @@ msgid "" "True\n" ">>> PurePath('a/b.py').full_match('*.py')\n" "False\n" -">>> PurePath('/a/b/c.py').full_match('/a/**')\n" -"True\n" ">>> PurePath('/a/b/c.py').full_match('**/*.py')\n" -"True" -msgstr "" -">>> PurePath('a/b.py').full_match('a/*.py')\n" "True\n" -">>> PurePath('a/b.py').full_match('*.py')\n" -"False\n" ">>> PurePath('/a/b/c.py').full_match('/a/**')\n" -"True\n" -">>> PurePath('/a/b/c.py').full_match('**/*.py')\n" "True" +msgstr "" + +msgid "" +"Patterns ending in \"``/**``\", as in the example above, may surprise when " +"passed to ``full_match``. Even though \"``**``\" can match 0 segments, " +"\"``.../**``\" requires a separator to match. Hence \"``/a/**``\" does not " +"match path \"``/a``\". Since :class:`PurePath` drops trailing slashes, this " +"pattern also does not match \"``/a/``\"." +msgstr "" + +msgid "" +">>> PurePath('/a').full_match('/a/**')\n" +"False\n" +">>> PurePath('/a/').full_match('/a/**')\n" +"False" +msgstr "" msgid ":ref:`pathlib-pattern-language` documentation." msgstr "" @@ -942,8 +970,8 @@ msgstr "" msgid "" "When *walk_up* is false (the default), the path must start with *other*. " "When the argument is true, ``..`` entries may be added to form the relative " -"path. In all other cases, such as the paths referencing different drives, :" -"exc:`ValueError` is raised.::" +"path. In all other cases, such as the paths referencing different " +"drives, :exc:`ValueError` is raised.::" msgstr "" msgid "" @@ -1137,8 +1165,8 @@ msgstr "" "PosixPath('/etc/hosts')" msgid "" -"Raises :exc:`UnsupportedOperation` on Windows. In previous versions, :exc:" -"`NotImplementedError` was raised instead." +"Raises :exc:`UnsupportedOperation` on Windows. In previous " +"versions, :exc:`NotImplementedError` was raised instead." msgstr "" msgid "" @@ -1299,8 +1327,8 @@ msgstr "" msgid "" "Return a new path with expanded ``~`` and ``~user`` constructs, as returned " -"by :meth:`os.path.expanduser`. If a home directory can't be resolved, :exc:" -"`RuntimeError` is raised." +"by :meth:`os.path.expanduser`. If a home directory can't be " +"resolved, :exc:`RuntimeError` is raised." msgstr "" msgid "" @@ -1313,8 +1341,8 @@ msgstr "" "PosixPath('/home/eric/films/Monty Python')" msgid "" -"Return a new path object representing the current directory (as returned by :" -"func:`os.getcwd`)::" +"Return a new path object representing the current directory (as returned " +"by :func:`os.getcwd`)::" msgstr "" msgid "" @@ -1391,8 +1419,8 @@ msgid "" msgstr "" msgid "" -"Return the path to which the symbolic link points (as returned by :func:`os." -"readlink`)::" +"Return the path to which the symbolic link points (as returned " +"by :func:`os.readlink`)::" msgstr "" msgid "" @@ -1415,19 +1443,18 @@ msgid "Querying file type and status" msgstr "" msgid "" -":meth:`~Path.exists`, :meth:`~Path.is_dir`, :meth:`~Path.is_file`, :meth:" -"`~Path.is_mount`, :meth:`~Path.is_symlink`, :meth:`~Path.is_block_device`, :" -"meth:`~Path.is_char_device`, :meth:`~Path.is_fifo`, :meth:`~Path.is_socket` " +":meth:`~Path.exists`, :meth:`~Path.is_dir`, :meth:`~Path.is_file`, :meth:`~Path.is_mount`, :meth:`~Path.is_symlink`, :meth:`~Path.is_block_device`, :meth:`~Path.is_char_device`, :meth:`~Path.is_fifo`, :meth:`~Path.is_socket` " "now return ``False`` instead of raising an exception for paths that contain " "characters unrepresentable at the OS level." msgstr "" msgid "" -"The methods given above now return ``False`` instead of raising any :exc:" -"`OSError` exception from the operating system. In previous versions, some " -"kinds of :exc:`OSError` exception are raised, and others suppressed. The new " -"behaviour is consistent with :func:`os.path.exists`, :func:`os.path.isdir`, " -"etc. Use :meth:`~Path.stat` to retrieve the file status without suppressing " +"The methods given above now return ``False`` instead of raising " +"any :exc:`OSError` exception from the operating system. In previous " +"versions, some kinds of :exc:`OSError` exception are raised, and others " +"suppressed. The new behaviour is consistent " +"with :func:`os.path.exists`, :func:`os.path.isdir`, etc. " +"Use :meth:`~Path.stat` to retrieve the file status without suppressing " "exceptions." msgstr "" @@ -1464,8 +1491,8 @@ msgid "" msgstr "" msgid "" -"Return ``True`` if the path points to an existing file or directory. " -"``False`` will be returned if the path is invalid, inaccessible or missing. " +"Return ``True`` if the path points to an existing file or directory and " +"``False`` if the path is invalid, inaccessible or missing. " "Use :meth:`Path.stat` to distinguish between these cases." msgstr "" @@ -1475,15 +1502,8 @@ msgid "" msgstr "" msgid "" -">>> Path('.').exists()\n" +">>> Path('').exists() # The current directory.\n" "True\n" -">>> Path('setup.py').exists()\n" -"True\n" -">>> Path('/etc').exists()\n" -"True\n" -">>> Path('nonexistentfile').exists()\n" -"False" -msgstr "" ">>> Path('.').exists()\n" "True\n" ">>> Path('setup.py').exists()\n" @@ -1492,6 +1512,7 @@ msgstr "" "True\n" ">>> Path('nonexistentfile').exists()\n" "False" +msgstr "" msgid "" "Return ``True`` if the path points to a regular file. ``False`` will be " @@ -1520,8 +1541,8 @@ msgstr "" msgid "" "Return ``True`` if the path points to a symbolic link, even if that symlink " "is broken. ``False`` will be returned if the path is invalid, inaccessible " -"or missing, or if it points to something other than a symbolic link. Use :" -"meth:`Path.stat` to distinguish between these cases." +"or missing, or if it points to something other than a symbolic link. " +"Use :meth:`Path.stat` to distinguish between these cases." msgstr "" msgid "" @@ -1572,8 +1593,8 @@ msgstr "" msgid "" "Return whether this path points to the same file as *other_path*, which can " -"be either a Path object, or a string. The semantics are similar to :func:" -"`os.path.samefile` and :func:`os.path.samestat`." +"be either a Path object, or a string. The semantics are similar " +"to :func:`os.path.samefile` and :func:`os.path.samestat`." msgstr "" msgid "" @@ -1619,14 +1640,15 @@ msgid "" msgstr "" msgid "" -"To fetch up-to-date information, it's best to call :meth:`Path.is_dir`, :" -"meth:`~Path.is_file` and :meth:`~Path.is_symlink` rather than methods of " -"this attribute. There is no way to reset the cache; instead you can create a " -"new path object with an empty info cache via ``p = Path(p)``." +"To fetch up-to-date information, it's best to " +"call :meth:`Path.is_dir`, :meth:`~Path.is_file` and :meth:`~Path.is_symlink` " +"rather than methods of this attribute. There is no way to reset the cache; " +"instead you can create a new path object with an empty info cache via ``p = " +"Path(p)``." msgstr "" msgid "Reading and writing files" -msgstr "" +msgstr "Odczytywanie i zapisywanie plików" msgid "" "Open the file pointed to by the path, like the built-in :func:`open` " @@ -1729,8 +1751,8 @@ msgstr "" msgid "" ">>> sorted(Path('.').glob('*.py'))\n" -"[PosixPath('pathlib.py'), PosixPath('setup.py'), PosixPath('test_pathlib." -"py')]\n" +"[PosixPath('pathlib.py'), PosixPath('setup.py'), " +"PosixPath('test_pathlib.py')]\n" ">>> sorted(Path('.').glob('*/*.py'))\n" "[PosixPath('docs/conf.py')]\n" ">>> sorted(Path('.').glob('**/*.py'))\n" @@ -1780,8 +1802,8 @@ msgid "" msgstr "" msgid "" -"Glob the given relative *pattern* recursively. This is like calling :func:" -"`Path.glob` with \"``**/``\" added in front of the *pattern*." +"Glob the given relative *pattern* recursively. This is like " +"calling :func:`Path.glob` with \"``**/``\" added in front of the *pattern*." msgstr "" msgid ":ref:`pathlib-pattern-language` and :meth:`Path.glob` documentation." @@ -1824,14 +1846,15 @@ msgstr "" msgid "" "When *top_down* is true, the caller can modify the *dirnames* list in-place " -"(for example, using :keyword:`del` or slice assignment), and :meth:`Path." -"walk` will only recurse into the subdirectories whose names remain in " -"*dirnames*. This can be used to prune the search, or to impose a specific " -"order of visiting, or even to inform :meth:`Path.walk` about directories the " -"caller creates or renames before it resumes :meth:`Path.walk` again. " -"Modifying *dirnames* when *top_down* is false has no effect on the behavior " -"of :meth:`Path.walk` since the directories in *dirnames* have already been " -"generated by the time *dirnames* is yielded to the caller." +"(for example, using :keyword:`del` or slice assignment), " +"and :meth:`Path.walk` will only recurse into the subdirectories whose names " +"remain in *dirnames*. This can be used to prune the search, or to impose a " +"specific order of visiting, or even to inform :meth:`Path.walk` about " +"directories the caller creates or renames before it " +"resumes :meth:`Path.walk` again. Modifying *dirnames* when *top_down* is " +"false has no effect on the behavior of :meth:`Path.walk` since the " +"directories in *dirnames* have already been generated by the time *dirnames* " +"is yielded to the caller." msgstr "" msgid "" @@ -1852,8 +1875,9 @@ msgstr "" msgid "" "Be aware that setting *follow_symlinks* to true can lead to infinite " -"recursion if a link points to a parent directory of itself. :meth:`Path." -"walk` does not keep track of the directories it has already visited." +"recursion if a link points to a parent directory of " +"itself. :meth:`Path.walk` does not keep track of the directories it has " +"already visited." msgstr "" msgid "" @@ -1876,8 +1900,8 @@ msgstr "" msgid "" "from pathlib import Path\n" -"for root, dirs, files in Path(\"cpython/Lib/concurrent\")." -"walk(on_error=print):\n" +"for root, dirs, files in Path(\"cpython/Lib/" +"concurrent\").walk(on_error=print):\n" " print(\n" " root,\n" " \"consumes\",\n" @@ -1914,13 +1938,13 @@ msgid "" "Create a file at this given path. If *mode* is given, it is combined with " "the process's ``umask`` value to determine the file mode and access flags. " "If the file already exists, the function succeeds when *exist_ok* is true " -"(and its modification time is updated to the current time), otherwise :exc:" -"`FileExistsError` is raised." +"(and its modification time is updated to the current time), " +"otherwise :exc:`FileExistsError` is raised." msgstr "" msgid "" -"The :meth:`~Path.open`, :meth:`~Path.write_text` and :meth:`~Path." -"write_bytes` methods are often used to create files." +"The :meth:`~Path.open`, :meth:`~Path.write_text` " +"and :meth:`~Path.write_bytes` methods are often used to create files." msgstr "" msgid "" @@ -1936,8 +1960,8 @@ msgid "" msgstr "" msgid "" -"If *parents* is false (the default), a missing parent raises :exc:" -"`FileNotFoundError`." +"If *parents* is false (the default), a missing parent " +"raises :exc:`FileNotFoundError`." msgstr "" msgid "" @@ -2001,8 +2025,8 @@ msgid "Copying, moving and deleting" msgstr "" msgid "" -"Copy this file or directory tree to the given *target*, and return a new :" -"class:`!Path` instance pointing to *target*." +"Copy this file or directory tree to the given *target*, and return a " +"new :class:`!Path` instance pointing to *target*." msgstr "" msgid "" @@ -2029,16 +2053,17 @@ msgstr "" msgid "" "Copy this file or directory tree into the given *target_dir*, which should " -"be an existing directory. Other arguments are handled identically to :meth:" -"`Path.copy`. Returns a new :class:`!Path` instance pointing to the copy." +"be an existing directory. Other arguments are handled identically " +"to :meth:`Path.copy`. Returns a new :class:`!Path` instance pointing to the " +"copy." msgstr "" msgid "" -"Rename this file or directory to the given *target*, and return a new :class:" -"`!Path` instance pointing to *target*. On Unix, if *target* exists and is a " -"file, it will be replaced silently if the user has permission. On Windows, " -"if *target* exists, :exc:`FileExistsError` will be raised. *target* can be " -"either a string or another path object::" +"Rename this file or directory to the given *target*, and return a " +"new :class:`!Path` instance pointing to *target*. On Unix, if *target* " +"exists and is a file, it will be replaced silently if the user has " +"permission. On Windows, if *target* exists, :exc:`FileExistsError` will be " +"raised. *target* can be either a string or another path object::" msgstr "" msgid "" @@ -2054,8 +2079,8 @@ msgstr "" msgid "" "The target path may be absolute or relative. Relative paths are interpreted " -"relative to the current working directory, *not* the directory of the :class:" -"`!Path` object." +"relative to the current working directory, *not* the directory of " +"the :class:`!Path` object." msgstr "" msgid "" @@ -2067,14 +2092,14 @@ msgid "Added return value, return the new :class:`!Path` instance." msgstr "" msgid "" -"Rename this file or directory to the given *target*, and return a new :class:" -"`!Path` instance pointing to *target*. If *target* points to an existing " -"file or empty directory, it will be unconditionally replaced." +"Rename this file or directory to the given *target*, and return a " +"new :class:`!Path` instance pointing to *target*. If *target* points to an " +"existing file or empty directory, it will be unconditionally replaced." msgstr "" msgid "" -"Move this file or directory tree to the given *target*, and return a new :" -"class:`!Path` instance pointing to *target*." +"Move this file or directory tree to the given *target*, and return a " +"new :class:`!Path` instance pointing to *target*." msgstr "" msgid "" @@ -2085,9 +2110,9 @@ msgid "" msgstr "" msgid "" -"If both paths are on the same filesystem, the move is performed with :func:" -"`os.replace`. Otherwise, this path is copied (preserving metadata and " -"symlinks) and then deleted." +"If both paths are on the same filesystem, the move is performed " +"with :func:`os.replace`. Otherwise, this path is copied (preserving metadata " +"and symlinks) and then deleted." msgstr "" msgid "" @@ -2097,8 +2122,8 @@ msgid "" msgstr "" msgid "" -"Remove this file or symbolic link. If the path points to a directory, use :" -"func:`Path.rmdir` instead." +"Remove this file or symbolic link. If the path points to a directory, " +"use :func:`Path.rmdir` instead." msgstr "" msgid "" @@ -2183,14 +2208,17 @@ msgid "Pattern language" msgstr "" msgid "" -"The following wildcards are supported in patterns for :meth:`~PurePath." -"full_match`, :meth:`~Path.glob` and :meth:`~Path.rglob`:" +"The following wildcards are supported in patterns " +"for :meth:`~PurePath.full_match`, :meth:`~Path.glob` and :meth:`~Path.rglob`:" msgstr "" msgid "``**`` (entire segment)" msgstr "" -msgid "Matches any number of file or directory segments, including zero." +msgid "" +"Matches any number of file or directory segments, including zero. Note that " +"in :meth:`~PurePath.full_match`, \"``a/**``\" does not match \"``a``\", " +"whereas :meth:`~Path.glob` yields \"``a``\" for that pattern." msgstr "" msgid "``*`` (entire segment)" @@ -2284,16 +2312,16 @@ msgid "" msgstr "" msgid "" -"Globbing with a pattern that ends with a pathname components separator (:" -"data:`~os.sep` or :data:`~os.altsep`) returns only directories." +"Globbing with a pattern that ends with a pathname components separator " +"(:data:`~os.sep` or :data:`~os.altsep`) returns only directories." msgstr "" msgid "Comparison to the :mod:`glob` module" msgstr "" msgid "" -"The patterns accepted and results generated by :meth:`Path.glob` and :meth:" -"`Path.rglob` differ slightly from those by the :mod:`glob` module:" +"The patterns accepted and results generated by :meth:`Path.glob` " +"and :meth:`Path.rglob` differ slightly from those by the :mod:`glob` module:" msgstr "" msgid "" @@ -2319,8 +2347,8 @@ msgstr "" msgid "" "The values returned from pathlib's ``path.glob()`` and ``path.rglob()`` " -"include the *path* as a prefix, unlike the results of ``glob." -"glob(root_dir=path)``." +"include the *path* as a prefix, unlike the results of " +"``glob.glob(root_dir=path)``." msgstr "" msgid "" @@ -2335,22 +2363,22 @@ msgstr "" msgid "" "pathlib implements path operations using :class:`PurePath` and :class:`Path` " -"objects, and so it's said to be *object-oriented*. On the other hand, the :" -"mod:`os` and :mod:`os.path` modules supply functions that work with low-" +"objects, and so it's said to be *object-oriented*. On the other hand, " +"the :mod:`os` and :mod:`os.path` modules supply functions that work with low-" "level ``str`` and ``bytes`` objects, which is a more *procedural* approach. " "Some users consider the object-oriented style to be more readable." msgstr "" msgid "" -"Many functions in :mod:`os` and :mod:`os.path` support ``bytes`` paths and :" -"ref:`paths relative to directory descriptors `. These features " +"Many functions in :mod:`os` and :mod:`os.path` support ``bytes`` paths " +"and :ref:`paths relative to directory descriptors `. These features " "aren't available in pathlib." msgstr "" msgid "" -"Python's ``str`` and ``bytes`` types, and portions of the :mod:`os` and :mod:" -"`os.path` modules, are written in C and are very speedy. pathlib is written " -"in pure Python and is often slower, but rarely slow enough to matter." +"Python's ``str`` and ``bytes`` types, and portions of the :mod:`os` " +"and :mod:`os.path` modules, are written in C and are very speedy. pathlib is " +"written in pure Python and is often slower, but rarely slow enough to matter." msgstr "" msgid "" @@ -2390,8 +2418,8 @@ msgid "Corresponding tools" msgstr "" msgid "" -"Below is a table mapping various :mod:`os` functions to their corresponding :" -"class:`PurePath`/:class:`Path` equivalent." +"Below is a table mapping various :mod:`os` functions to their " +"corresponding :class:`PurePath`/:class:`Path` equivalent." msgstr "" msgid ":mod:`os` and :mod:`os.path`" @@ -2598,14 +2626,14 @@ msgstr "" msgid "" ":func:`os.path.expanduser` returns the path unchanged if the home directory " -"can't be resolved, whereas :meth:`Path.expanduser` raises :exc:" -"`RuntimeError`." +"can't be resolved, whereas :meth:`Path.expanduser` " +"raises :exc:`RuntimeError`." msgstr "" msgid "" ":func:`os.path.abspath` removes \"``..``\" components without resolving " -"symlinks, which may change the meaning of the path, whereas :meth:`Path." -"absolute` leaves any \"``..``\" components in the path." +"symlinks, which may change the meaning of the path, " +"whereas :meth:`Path.absolute` leaves any \"``..``\" components in the path." msgstr "" msgid "" @@ -2622,9 +2650,9 @@ msgid "" msgstr "" msgid "" -"A :class:`typing.Protocol` describing the :attr:`Path.info ` attribute. Implementations may return cached results from their " -"methods." +"A :class:`typing.Protocol` describing the :attr:`Path.info " +"` attribute. Implementations may return cached results " +"from their methods." msgstr "" msgid "" diff --git a/library/pdb.po b/library/pdb.po index 56f01d79f2..88d00b5659 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,9 +40,10 @@ msgid "" msgstr "" msgid "" -"The debugger is extensible -- it is actually defined as the class :class:" -"`Pdb`. This is currently undocumented but easily understood by reading the " -"source. The extension interface uses the modules :mod:`bdb` and :mod:`cmd`." +"The debugger is extensible -- it is actually defined as the " +"class :class:`Pdb`. This is currently undocumented but easily understood by " +"reading the source. The extension interface uses the modules :mod:`bdb` " +"and :mod:`cmd`." msgstr "" msgid "Module :mod:`faulthandler`" @@ -112,7 +114,7 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "You can also invoke :mod:`!pdb` from the command line to debug other " @@ -215,8 +217,8 @@ msgid "" "statement using :pdbcmd:`step` or :pdbcmd:`next` (all these commands are " "explained below). The optional *globals* and *locals* arguments specify the " "environment in which the code is executed; by default the dictionary of the " -"module :mod:`__main__` is used. (See the explanation of the built-in :func:" -"`exec` or :func:`eval` functions.)" +"module :mod:`__main__` is used. (See the explanation of the built-" +"in :func:`exec` or :func:`eval` functions.)" msgstr "" msgid "" @@ -317,15 +319,15 @@ msgstr "" msgid "" "By default, Pdb sets a handler for the SIGINT signal (which is sent when the " -"user presses :kbd:`Ctrl-C` on the console) when you give a :pdbcmd:" -"`continue` command. This allows you to break into the debugger again by " -"pressing :kbd:`Ctrl-C`. If you want Pdb not to touch the SIGINT handler, " -"set *nosigint* to true." +"user presses :kbd:`Ctrl-C` on the console) when you give " +"a :pdbcmd:`continue` command. This allows you to break into the debugger " +"again by pressing :kbd:`Ctrl-C`. If you want Pdb not to touch the SIGINT " +"handler, set *nosigint* to true." msgstr "" msgid "" -"The *readrc* argument defaults to true and controls whether Pdb will load ." -"pdbrc files from the filesystem." +"The *readrc* argument defaults to true and controls whether Pdb will " +"load .pdbrc files from the filesystem." msgstr "" msgid "" @@ -338,9 +340,9 @@ msgstr "" msgid "" "The *backend* argument specifies the backend to use for the debugger. If " -"``None`` is passed, the default backend will be used. See :func:" -"`set_default_backend`. Otherwise the supported backends are ``'settrace'`` " -"and ``'monitoring'``." +"``None`` is passed, the default backend will be used. " +"See :func:`set_default_backend`. Otherwise the supported backends are " +"``'settrace'`` and ``'monitoring'``." msgstr "" msgid "" @@ -478,8 +480,8 @@ msgid "" msgstr "" msgid "" -":file:`.pdbrc` can now contain commands that continue debugging, such as :" -"pdbcmd:`continue` or :pdbcmd:`next`. Previously, these commands had no " +":file:`.pdbrc` can now contain commands that continue debugging, such " +"as :pdbcmd:`continue` or :pdbcmd:`next`. Previously, these commands had no " "effect." msgstr "" @@ -611,13 +613,13 @@ msgid "" msgstr "" msgid "" -"Specifying any command resuming execution (currently :pdbcmd:`continue`, :" -"pdbcmd:`step`, :pdbcmd:`next`, :pdbcmd:`return`, :pdbcmd:`until`, :pdbcmd:" -"`jump`, :pdbcmd:`quit` and their abbreviations) terminates the command list " -"(as if that command was immediately followed by end). This is because any " -"time you resume execution (even with a simple next or step), you may " -"encounter another breakpoint—which could have its own command list, leading " -"to ambiguities about which list to execute." +"Specifying any command resuming execution " +"(currently :pdbcmd:`continue`, :pdbcmd:`step`, :pdbcmd:`next`, :pdbcmd:`return`, :pdbcmd:`until`, :pdbcmd:`jump`, :pdbcmd:`quit` " +"and their abbreviations) terminates the command list (as if that command was " +"immediately followed by end). This is because any time you resume execution " +"(even with a simple next or step), you may encounter another breakpoint—" +"which could have its own command list, leading to ambiguities about which " +"list to execute." msgstr "" msgid "" @@ -672,8 +674,8 @@ msgstr "" msgid "" "It should be noted that not all jumps are allowed -- for instance it is not " -"possible to jump into the middle of a :keyword:`for` loop or out of a :" -"keyword:`finally` clause." +"possible to jump into the middle of a :keyword:`for` loop or out of " +"a :keyword:`finally` clause." msgstr "" msgid "" @@ -829,8 +831,8 @@ msgid "" msgstr "" msgid "" -"As an example, here are two useful aliases (especially when placed in the :" -"file:`.pdbrc` file)::" +"As an example, here are two useful aliases (especially when placed in " +"the :file:`.pdbrc` file)::" msgstr "" msgid "" @@ -855,8 +857,8 @@ msgid "" msgstr "" msgid "" -"To set a global variable, you can prefix the assignment command with a :" -"keyword:`global` statement on the same line, e.g.:" +"To set a global variable, you can prefix the assignment command with " +"a :keyword:`global` statement on the same line, e.g.:" msgstr "" msgid "" @@ -867,8 +869,8 @@ msgstr "" msgid "" "Restart the debugged Python program. If *args* is supplied, it is split " "with :mod:`shlex` and the result is used as the new :data:`sys.argv`. " -"History, breakpoints, actions and debugger options are preserved. :pdbcmd:" -"`restart` is an alias for :pdbcmd:`run`." +"History, breakpoints, actions and debugger options are " +"preserved. :pdbcmd:`restart` is an alias for :pdbcmd:`run`." msgstr "" msgid "" @@ -889,9 +891,9 @@ msgstr "" msgid "" "A confirmation prompt will be shown if the debugger is invoked in " -"``'inline'`` mode. After the confirmation, the debugger will call :func:`sys." -"exit` immediately, instead of raising :exc:`bdb.BdbQuit` in the next trace " -"event." +"``'inline'`` mode. After the confirmation, the debugger will " +"call :func:`sys.exit` immediately, instead of raising :exc:`bdb.BdbQuit` in " +"the next trace event." msgstr "" msgid "" @@ -928,7 +930,7 @@ msgid "" "def inner(x):\n" " 1 / x\n" "\n" -" out()" +"out()" msgstr "" msgid "calling ``pdb.pm()`` will allow to move between exceptions::" diff --git a/library/pickle.po b/library/pickle.po index 32dd7cf5de..f15a2c4a1c 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,9 +34,9 @@ msgid "" "The :mod:`!pickle` module implements binary protocols for serializing and de-" "serializing a Python object structure. *\"Pickling\"* is the process " "whereby a Python object hierarchy is converted into a byte stream, and " -"*\"unpickling\"* is the inverse operation, whereby a byte stream (from a :" -"term:`binary file` or :term:`bytes-like object`) is converted back into an " -"object hierarchy. Pickling (and unpickling) is alternatively known as " +"*\"unpickling\"* is the inverse operation, whereby a byte stream (from " +"a :term:`binary file` or :term:`bytes-like object`) is converted back into " +"an object hierarchy. Pickling (and unpickling) is alternatively known as " "\"serialization\", \"marshalling,\" [#]_ or \"flattening\"; however, to " "avoid confusion, the terms used here are \"pickling\" and \"unpickling\"." msgstr "" @@ -68,8 +69,8 @@ msgstr "" msgid "" "Python has a more primitive serialization module called :mod:`marshal`, but " "in general :mod:`!pickle` should always be the preferred way to serialize " -"Python objects. :mod:`marshal` exists primarily to support Python's :file:`." -"pyc` files." +"Python objects. :mod:`marshal` exists primarily to support " +"Python's :file:`.pyc` files." msgstr "" msgid "" @@ -81,19 +82,19 @@ msgid "" ":mod:`marshal` cannot be used to serialize user-defined classes and their " "instances. :mod:`!pickle` can save and restore class instances " "transparently, however the class definition must be importable and live in " -"the same module as when the object was stored." +"the same module as when the object was pickled." msgstr "" msgid "" "The :mod:`marshal` serialization format is not guaranteed to be portable " -"across Python versions. Because its primary job in life is to support :file:" -"`.pyc` files, the Python implementers reserve the right to change the " -"serialization format in non-backwards compatible ways should the need arise. " -"The :mod:`!pickle` serialization format is guaranteed to be backwards " -"compatible across Python releases provided a compatible pickle protocol is " -"chosen and pickling and unpickling code deals with Python 2 to Python 3 type " -"differences if your data is crossing that unique breaking change language " -"boundary." +"across Python versions. Because its primary job in life is to " +"support :file:`.pyc` files, the Python implementers reserve the right to " +"change the serialization format in non-backwards compatible ways should the " +"need arise. The :mod:`!pickle` serialization format is guaranteed to be " +"backwards compatible across Python releases provided a compatible pickle " +"protocol is chosen and pickling and unpickling code deals with Python 2 to " +"Python 3 type differences if your data is crossing that unique breaking " +"change language boundary." msgstr "" msgid "Comparison with ``json``" @@ -122,8 +123,8 @@ msgid "" "JSON, by default, can only represent a subset of the Python built-in types, " "and no custom classes; pickle can represent an extremely large number of " "Python types (many of them automatically, by clever usage of Python's " -"introspection facilities; complex cases can be tackled by implementing :ref:" -"`specific object APIs `);" +"introspection facilities; complex cases can be tackled by " +"implementing :ref:`specific object APIs `);" msgstr "" msgid "" @@ -181,16 +182,16 @@ msgid "" msgstr "" msgid "" -"Protocol version 3 was added in Python 3.0. It has explicit support for :" -"class:`bytes` objects and cannot be unpickled by Python 2.x. This was the " -"default protocol in Python 3.0--3.7." +"Protocol version 3 was added in Python 3.0. It has explicit support " +"for :class:`bytes` objects and cannot be unpickled by Python 2.x. This was " +"the default protocol in Python 3.0--3.7." msgstr "" msgid "" "Protocol version 4 was added in Python 3.4. It adds support for very large " "objects, pickling more kinds of objects, and some data format " -"optimizations. This was the default protocol in Python 3.8--3.13. Refer to :" -"pep:`3154` for information about improvements brought by protocol 4." +"optimizations. This was the default protocol in Python 3.8--3.13. Refer " +"to :pep:`3154` for information about improvements brought by protocol 4." msgstr "" msgid "" @@ -218,10 +219,10 @@ msgstr "" msgid "" "To serialize an object hierarchy, you simply call the :func:`dumps` " -"function. Similarly, to de-serialize a data stream, you call the :func:" -"`loads` function. However, if you want more control over serialization and " -"de-serialization, you can create a :class:`Pickler` or an :class:`Unpickler` " -"object, respectively." +"function. Similarly, to de-serialize a data stream, you call " +"the :func:`loads` function. However, if you want more control over " +"serialization and de-serialization, you can create a :class:`Pickler` or " +"an :class:`Unpickler` object, respectively." msgstr "" msgid "The :mod:`!pickle` module provides the following constants:" @@ -229,17 +230,18 @@ msgstr "" msgid "" "An integer, the highest :ref:`protocol version ` " -"available. This value can be passed as a *protocol* value to functions :" -"func:`dump` and :func:`dumps` as well as the :class:`Pickler` constructor." +"available. This value can be passed as a *protocol* value to " +"functions :func:`dump` and :func:`dumps` as well as the :class:`Pickler` " +"constructor." msgstr "" msgid "" "An integer, the default :ref:`protocol version ` used for " "pickling. May be less than :data:`HIGHEST_PROTOCOL`. Currently the default " "protocol is 5, introduced in Python 3.8 and incompatible with previous " -"versions. This version introduces support for out-of-band buffers, where :" -"pep:`3118`-compatible data can be transmitted separately from the main " -"pickle stream." +"versions. This version introduces support for out-of-band buffers, " +"where :pep:`3118`-compatible data can be transmitted separately from the " +"main pickle stream." msgstr "" msgid "The default protocol is 3." @@ -313,8 +315,8 @@ msgid "The :mod:`!pickle` module defines three exceptions:" msgstr "" msgid "" -"Common base class for the other pickling exceptions. It inherits from :exc:" -"`Exception`." +"Common base class for the other pickling exceptions. It inherits " +"from :exc:`Exception`." msgstr "" msgid "" @@ -339,8 +341,8 @@ msgid "" msgstr "" msgid "" -"The :mod:`!pickle` module exports three classes, :class:`Pickler`, :class:" -"`Unpickler` and :class:`PickleBuffer`:" +"The :mod:`!pickle` module exports three " +"classes, :class:`Pickler`, :class:`Unpickler` and :class:`PickleBuffer`:" msgstr "" msgid "This takes a binary file for writing a pickle data stream." @@ -355,8 +357,8 @@ msgstr "" msgid "" "The *file* argument must have a write() method that accepts a single bytes " -"argument. It can thus be an on-disk file opened for binary writing, an :" -"class:`io.BytesIO` instance, or any other custom object that meets this " +"argument. It can thus be an on-disk file opened for binary writing, " +"an :class:`io.BytesIO` instance, or any other custom object that meets this " "interface." msgstr "" @@ -403,8 +405,8 @@ msgid "See :ref:`pickle-persistent` for details and examples of uses." msgstr "" msgid "" -"Add the default implementation of this method in the C implementation of :" -"class:`!Pickler`." +"Add the default implementation of this method in the C implementation " +"of :class:`!Pickler`." msgstr "" msgid "" @@ -417,12 +419,12 @@ msgstr "" msgid "" "By default, a pickler object will not have a :attr:`dispatch_table` " -"attribute, and it will instead use the global dispatch table managed by the :" -"mod:`copyreg` module. However, to customize the pickling for a specific " +"attribute, and it will instead use the global dispatch table managed by " +"the :mod:`copyreg` module. However, to customize the pickling for a specific " "pickler object one can set the :attr:`dispatch_table` attribute to a dict-" -"like object. Alternatively, if a subclass of :class:`Pickler` has a :attr:" -"`dispatch_table` attribute then this will be used as the default dispatch " -"table for instances of that class." +"like object. Alternatively, if a subclass of :class:`Pickler` has " +"a :attr:`dispatch_table` attribute then this will be used as the default " +"dispatch table for instances of that class." msgstr "" msgid "See :ref:`pickle-dispatch` for usage examples." @@ -432,8 +434,8 @@ msgid "" "Special reducer that can be defined in :class:`Pickler` subclasses. This " "method has priority over any reducer in the :attr:`dispatch_table`. It " "should conform to the same interface as a :meth:`~object.__reduce__` method, " -"and can optionally return :data:`NotImplemented` to fallback on :attr:" -"`dispatch_table`-registered reducers to pickle ``obj``." +"and can optionally return :data:`NotImplemented` to fallback " +"on :attr:`dispatch_table`-registered reducers to pickle ``obj``." msgstr "" msgid "For a detailed example, see :ref:`reducer_override`." @@ -469,10 +471,10 @@ msgstr "" msgid "" "The argument *file* must have three methods, a read() method that takes an " "integer argument, a readinto() method that takes a buffer argument and a " -"readline() method that requires no arguments, as in the :class:`io." -"BufferedIOBase` interface. Thus *file* can be an on-disk file opened for " -"binary reading, an :class:`io.BytesIO` object, or any other custom object " -"that meets this interface." +"readline() method that requires no arguments, as in " +"the :class:`io.BufferedIOBase` interface. Thus *file* can be an on-disk " +"file opened for binary reading, an :class:`io.BytesIO` object, or any other " +"custom object that meets this interface." msgstr "" msgid "" @@ -483,9 +485,9 @@ msgid "" "decode 8-bit string instances pickled by Python 2; these default to 'ASCII' " "and 'strict', respectively. The *encoding* can be 'bytes' to read these 8-" "bit string instances as bytes objects. Using ``encoding='latin1'`` is " -"required for unpickling NumPy arrays and instances of :class:`~datetime." -"datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by " -"Python 2." +"required for unpickling NumPy arrays and instances " +"of :class:`~datetime.datetime`, :class:`~datetime.date` " +"and :class:`~datetime.time` pickled by Python 2." msgstr "" msgid "" @@ -513,13 +515,13 @@ msgstr "" msgid "" "If defined, :meth:`persistent_load` should return the object specified by " -"the persistent ID *pid*. If an invalid persistent ID is encountered, an :" -"exc:`UnpicklingError` should be raised." +"the persistent ID *pid*. If an invalid persistent ID is encountered, " +"an :exc:`UnpicklingError` should be raised." msgstr "" msgid "" -"Add the default implementation of this method in the C implementation of :" -"class:`!Unpickler`." +"Add the default implementation of this method in the C implementation " +"of :class:`!Unpickler`." msgstr "" msgid "" @@ -531,8 +533,8 @@ msgstr "" msgid "" "Subclasses may override this to gain control over what type of objects and " -"how they can be loaded, potentially reducing security risks. Refer to :ref:" -"`pickle-restrict` for details." +"how they can be loaded, potentially reducing security risks. Refer " +"to :ref:`pickle-restrict` for details." msgstr "" msgid "" @@ -541,15 +543,15 @@ msgid "" msgstr "" msgid "" -"A wrapper for a buffer representing picklable data. *buffer* must be a :ref:" -"`buffer-providing ` object, such as a :term:`bytes-like " -"object` or a N-dimensional array." +"A wrapper for a buffer representing picklable data. *buffer* must be " +"a :ref:`buffer-providing ` object, such as a :term:`bytes-" +"like object` or a N-dimensional array." msgstr "" msgid "" ":class:`PickleBuffer` is itself a buffer provider, therefore it is possible " -"to pass it to other APIs expecting a buffer-providing object, such as :class:" -"`memoryview`." +"to pass it to other APIs expecting a buffer-providing object, such " +"as :class:`memoryview`." msgstr "" msgid "" @@ -575,8 +577,8 @@ msgid "The following types can be pickled:" msgstr "" msgid "" -"built-in constants (``None``, ``True``, ``False``, ``Ellipsis``, and :data:" -"`NotImplemented`);" +"built-in constants (``None``, ``True``, ``False``, ``Ellipsis``, " +"and :data:`NotImplemented`);" msgstr "" msgid "integers, floating-point numbers, complex numbers;" @@ -598,25 +600,26 @@ msgid "classes accessible from the top level of a module;" msgstr "" msgid "" -"instances of such classes for which the result of calling :meth:`~object." -"__getstate__` is picklable (see section :ref:`pickle-inst` for details)." +"instances of such classes for which the result of " +"calling :meth:`~object.__getstate__` is picklable (see section :ref:`pickle-" +"inst` for details)." msgstr "" msgid "" "Attempts to pickle unpicklable objects will raise the :exc:`PicklingError` " "exception; when this happens, an unspecified number of bytes may have " "already been written to the underlying file. Trying to pickle a highly " -"recursive data structure may exceed the maximum recursion depth, a :exc:" -"`RecursionError` will be raised in this case. You can carefully raise this " -"limit with :func:`sys.setrecursionlimit`." +"recursive data structure may exceed the maximum recursion depth, " +"a :exc:`RecursionError` will be raised in this case. You can carefully " +"raise this limit with :func:`sys.setrecursionlimit`." msgstr "" msgid "" -"Note that functions (built-in and user-defined) are pickled by fully :term:" -"`qualified name`, not by value. [#]_ This means that only the function name " -"is pickled, along with the name of the containing module and classes. " -"Neither the function's code, nor any of its function attributes are " -"pickled. Thus the defining module must be importable in the unpickling " +"Note that functions (built-in and user-defined) are pickled by " +"fully :term:`qualified name`, not by value. [#]_ This means that only the " +"function name is pickled, along with the name of the containing module and " +"classes. Neither the function's code, nor any of its function attributes " +"are pickled. Thus the defining module must be importable in the unpickling " "environment, and the module must contain the named object, otherwise an " "exception will be raised. [#]_" msgstr "" @@ -647,8 +650,8 @@ msgid "" "and still load objects that were created with an earlier version of the " "class. If you plan to have long-lived objects that will see many versions " "of a class, it may be worthwhile to put a version number in the objects so " -"that suitable conversions can be made by the class's :meth:`~object." -"__setstate__` method." +"that suitable conversions can be made by the " +"class's :meth:`~object.__setstate__` method." msgstr "" msgid "Pickling Class Instances" @@ -662,10 +665,11 @@ msgstr "" msgid "" "In most cases, no additional code is needed to make instances picklable. By " "default, pickle will retrieve the class and the attributes of an instance " -"via introspection. When a class instance is unpickled, its :meth:`~object." -"__init__` method is usually *not* invoked. The default behaviour first " -"creates an uninitialized instance and then restores the saved attributes. " -"The following code shows an implementation of this behaviour::" +"via introspection. When a class instance is unpickled, " +"its :meth:`~object.__init__` method is usually *not* invoked. The default " +"behaviour first creates an uninitialized instance and then restores the " +"saved attributes. The following code shows an implementation of this " +"behaviour::" msgstr "" msgid "" @@ -684,12 +688,12 @@ msgid "" msgstr "" msgid "" -"In protocols 2 and newer, classes that implement the :meth:" -"`__getnewargs_ex__` method can dictate the values passed to the :meth:" -"`__new__` method upon unpickling. The method must return a pair ``(args, " -"kwargs)`` where *args* is a tuple of positional arguments and *kwargs* a " -"dictionary of named arguments for constructing the object. Those will be " -"passed to the :meth:`__new__` method upon unpickling." +"In protocols 2 and newer, classes that implement " +"the :meth:`__getnewargs_ex__` method can dictate the values passed to " +"the :meth:`__new__` method upon unpickling. The method must return a pair " +"``(args, kwargs)`` where *args* is a tuple of positional arguments and " +"*kwargs* a dictionary of named arguments for constructing the object. Those " +"will be passed to the :meth:`__new__` method upon unpickling." msgstr "" msgid "" @@ -713,8 +717,8 @@ msgid "" msgstr "" msgid "" -"Before Python 3.6, :meth:`__getnewargs__` was called instead of :meth:" -"`__getnewargs_ex__` in protocols 2 and 3." +"Before Python 3.6, :meth:`__getnewargs__` was called instead " +"of :meth:`__getnewargs_ex__` in protocols 2 and 3." msgstr "" msgid "" @@ -725,32 +729,32 @@ msgid "" msgstr "" msgid "" -"For a class that has no instance :attr:`~object.__dict__` and no :attr:" -"`~object.__slots__`, the default state is ``None``." +"For a class that has no instance :attr:`~object.__dict__` and " +"no :attr:`~object.__slots__`, the default state is ``None``." msgstr "" msgid "" -"For a class that has an instance :attr:`~object.__dict__` and no :attr:" -"`~object.__slots__`, the default state is ``self.__dict__``." +"For a class that has an instance :attr:`~object.__dict__` and " +"no :attr:`~object.__slots__`, the default state is ``self.__dict__``." msgstr "" msgid "" -"For a class that has an instance :attr:`~object.__dict__` and :attr:`~object." -"__slots__`, the default state is a tuple consisting of two dictionaries: " -"``self.__dict__``, and a dictionary mapping slot names to slot values. Only " -"slots that have a value are included in the latter." +"For a class that has an instance :attr:`~object.__dict__` " +"and :attr:`~object.__slots__`, the default state is a tuple consisting of " +"two dictionaries: ``self.__dict__``, and a dictionary mapping slot names to " +"slot values. Only slots that have a value are included in the latter." msgstr "" msgid "" -"For a class that has :attr:`~object.__slots__` and no instance :attr:" -"`~object.__dict__`, the default state is a tuple whose first item is " -"``None`` and whose second item is a dictionary mapping slot names to slot " -"values described in the previous bullet." +"For a class that has :attr:`~object.__slots__` and no " +"instance :attr:`~object.__dict__`, the default state is a tuple whose first " +"item is ``None`` and whose second item is a dictionary mapping slot names to " +"slot values described in the previous bullet." msgstr "" msgid "" -"Added the default implementation of the ``__getstate__()`` method in the :" -"class:`object` class." +"Added the default implementation of the ``__getstate__()`` method in " +"the :class:`object` class." msgstr "" msgid "" @@ -761,29 +765,29 @@ msgid "" msgstr "" msgid "" -"If :meth:`__reduce__` returns a state with value ``None`` at pickling, the :" -"meth:`__setstate__` method will not be called upon unpickling." +"If :meth:`__reduce__` returns a state with value ``None`` at pickling, " +"the :meth:`__setstate__` method will not be called upon unpickling." msgstr "" msgid "" "Refer to the section :ref:`pickle-state` for more information about how to " -"use the methods :meth:`~object.__getstate__` and :meth:`~object." -"__setstate__`." +"use the methods :meth:`~object.__getstate__` " +"and :meth:`~object.__setstate__`." msgstr "" msgid "" -"At unpickling time, some methods like :meth:`~object.__getattr__`, :meth:" -"`~object.__getattribute__`, or :meth:`~object.__setattr__` may be called " -"upon the instance. In case those methods rely on some internal invariant " -"being true, the type should implement :meth:`~object.__new__` to establish " -"such an invariant, as :meth:`~object.__init__` is not called when unpickling " -"an instance." +"At unpickling time, some methods " +"like :meth:`~object.__getattr__`, :meth:`~object.__getattribute__`, " +"or :meth:`~object.__setattr__` may be called upon the instance. In case " +"those methods rely on some internal invariant being true, the type should " +"implement :meth:`~object.__new__` to establish such an invariant, " +"as :meth:`~object.__init__` is not called when unpickling an instance." msgstr "" msgid "" "As we shall see, pickle does not use directly the methods described above. " -"In fact, these methods are part of the copy protocol which implements the :" -"meth:`~object.__reduce__` special method. The copy protocol provides a " +"In fact, these methods are part of the copy protocol which implements " +"the :meth:`~object.__reduce__` special method. The copy protocol provides a " "unified interface for retrieving the data necessary for pickling and copying " "objects. [#]_" msgstr "" @@ -791,10 +795,11 @@ msgstr "" msgid "" "Although powerful, implementing :meth:`~object.__reduce__` directly in your " "classes is error prone. For this reason, class designers should use the " -"high-level interface (i.e., :meth:`~object.__getnewargs_ex__`, :meth:" -"`~object.__getstate__` and :meth:`~object.__setstate__`) whenever possible. " -"We will show, however, cases where using :meth:`!__reduce__` is the only " -"option or leads to more efficient pickling or both." +"high-level interface " +"(i.e., :meth:`~object.__getnewargs_ex__`, :meth:`~object.__getstate__` " +"and :meth:`~object.__setstate__`) whenever possible. We will show, however, " +"cases where using :meth:`!__reduce__` is the only option or leads to more " +"efficient pickling or both." msgstr "" msgid "" @@ -807,7 +812,10 @@ msgid "" "If a string is returned, the string should be interpreted as the name of a " "global variable. It should be the object's local name relative to its " "module; the pickle module searches the module namespace to determine the " -"object's module. This behaviour is typically useful for singletons." +"object's module: for a given ``obj`` to be pickled, the ``__module__`` " +"attribute is looked up on ``obj`` directly, which falls back to a lookup on " +"the type of ``obj`` if no ``__module__`` instance attribute is set. This " +"behaviour is typically useful for singletons." msgstr "" msgid "" @@ -827,18 +835,18 @@ msgid "" msgstr "" msgid "" -"Optionally, the object's state, which will be passed to the object's :meth:" -"`__setstate__` method as previously described. If the object has no such " -"method then, the value must be a dictionary and it will be added to the " -"object's :attr:`~object.__dict__` attribute." +"Optionally, the object's state, which will be passed to the " +"object's :meth:`__setstate__` method as previously described. If the object " +"has no such method then, the value must be a dictionary and it will be added " +"to the object's :attr:`~object.__dict__` attribute." msgstr "" msgid "" "Optionally, an iterator (and not a sequence) yielding successive items. " "These items will be appended to the object either using ``obj.append(item)`` " "or, in batch, using ``obj.extend(list_of_items)``. This is primarily used " -"for list subclasses, but may be used by other classes as long as they have :" -"meth:`~sequence.append` and :meth:`~sequence.extend` methods with the " +"for list subclasses, but may be used by other classes as long as they " +"have :meth:`~sequence.append` and :meth:`~sequence.extend` methods with the " "appropriate signature. (Whether :meth:`!append` or :meth:`!extend` is used " "depends on which pickle protocol version is used as well as the number of " "items to append, so both must be supported.)" @@ -855,8 +863,8 @@ msgid "" "Optionally, a callable with a ``(obj, state)`` signature. This callable " "allows the user to programmatically control the state-updating behavior of a " "specific object, instead of using ``obj``'s static :meth:`__setstate__` " -"method. If not ``None``, this callable will have priority over ``obj``'s :" -"meth:`__setstate__`." +"method. If not ``None``, this callable will have priority over " +"``obj``'s :meth:`__setstate__`." msgstr "" msgid "The optional sixth tuple item, ``(obj, state)``, was added." @@ -865,10 +873,11 @@ msgstr "" msgid "" "Alternatively, a :meth:`__reduce_ex__` method may be defined. The only " "difference is this method should take a single integer argument, the " -"protocol version. When defined, pickle will prefer it over the :meth:" -"`__reduce__` method. In addition, :meth:`__reduce__` automatically becomes " -"a synonym for the extended version. The main use for this method is to " -"provide backwards-compatible reduce values for older Python releases." +"protocol version. When defined, pickle will prefer it over " +"the :meth:`__reduce__` method. In addition, :meth:`__reduce__` " +"automatically becomes a synonym for the extended version. The main use for " +"this method is to provide backwards-compatible reduce values for older " +"Python releases." msgstr "" msgid "Persistence of External Objects" @@ -885,8 +894,8 @@ msgstr "" msgid "" "The resolution of such persistent IDs is not defined by the :mod:`!pickle` " "module; it will delegate this resolution to the user-defined methods on the " -"pickler and unpickler, :meth:`~Pickler.persistent_id` and :meth:`~Unpickler." -"persistent_load` respectively." +"pickler and unpickler, :meth:`~Pickler.persistent_id` " +"and :meth:`~Unpickler.persistent_load` respectively." msgstr "" msgid "" @@ -900,9 +909,9 @@ msgid "" msgstr "" msgid "" -"To unpickle external objects, the unpickler must have a custom :meth:" -"`~Unpickler.persistent_load` method that takes a persistent ID object and " -"returns the referenced object." +"To unpickle external objects, the unpickler must have a " +"custom :meth:`~Unpickler.persistent_load` method that takes a persistent ID " +"object and returns the referenced object." msgstr "" msgid "" @@ -972,8 +981,8 @@ msgid "" " # Initialize and populate our database.\n" " conn = sqlite3.connect(\":memory:\")\n" " cursor = conn.cursor()\n" -" cursor.execute(\"CREATE TABLE memos(key INTEGER PRIMARY KEY, task " -"TEXT)\")\n" +" cursor.execute(\"CREATE TABLE memos(key INTEGER PRIMARY KEY, task TEXT)" +"\")\n" " tasks = (\n" " 'give food to fish',\n" " 'prepare group meeting',\n" @@ -1147,17 +1156,17 @@ msgid "" msgstr "" msgid "" -"If both the :attr:`~Pickler.dispatch_table` and :meth:`~Pickler." -"reducer_override` are defined, then :meth:`~Pickler.reducer_override` method " -"takes priority." +"If both the :attr:`~Pickler.dispatch_table` " +"and :meth:`~Pickler.reducer_override` are defined, " +"then :meth:`~Pickler.reducer_override` method takes priority." msgstr "" msgid "" "For performance reasons, :meth:`~Pickler.reducer_override` may not be called " "for the following objects: ``None``, ``True``, ``False``, and exact " -"instances of :class:`int`, :class:`float`, :class:`bytes`, :class:`str`, :" -"class:`dict`, :class:`set`, :class:`frozenset`, :class:`list` and :class:" -"`tuple`." +"instances " +"of :class:`int`, :class:`float`, :class:`bytes`, :class:`str`, :class:`dict`, :class:`set`, :class:`frozenset`, :class:`list` " +"and :class:`tuple`." msgstr "" msgid "" @@ -1218,10 +1227,10 @@ msgid "Provider API" msgstr "" msgid "" -"The large data objects to be pickled must implement a :meth:`~object." -"__reduce_ex__` method specialized for protocol 5 and higher, which returns " -"a :class:`PickleBuffer` instance (instead of e.g. a :class:`bytes` object) " -"for any large data." +"The large data objects to be pickled must implement " +"a :meth:`~object.__reduce_ex__` method specialized for protocol 5 and " +"higher, which returns a :class:`PickleBuffer` instance (instead of e.g. " +"a :class:`bytes` object) for any large data." msgstr "" msgid "" @@ -1236,26 +1245,27 @@ msgid "Consumer API" msgstr "" msgid "" -"A communications system can enable custom handling of the :class:" -"`PickleBuffer` objects generated when serializing an object graph." +"A communications system can enable custom handling of " +"the :class:`PickleBuffer` objects generated when serializing an object graph." msgstr "" msgid "" -"On the sending side, it needs to pass a *buffer_callback* argument to :class:" -"`Pickler` (or to the :func:`dump` or :func:`dumps` function), which will be " -"called with each :class:`PickleBuffer` generated while pickling the object " -"graph. Buffers accumulated by the *buffer_callback* will not see their data " -"copied into the pickle stream, only a cheap marker will be inserted." +"On the sending side, it needs to pass a *buffer_callback* argument " +"to :class:`Pickler` (or to the :func:`dump` or :func:`dumps` function), " +"which will be called with each :class:`PickleBuffer` generated while " +"pickling the object graph. Buffers accumulated by the *buffer_callback* " +"will not see their data copied into the pickle stream, only a cheap marker " +"will be inserted." msgstr "" msgid "" -"On the receiving side, it needs to pass a *buffers* argument to :class:" -"`Unpickler` (or to the :func:`load` or :func:`loads` function), which is an " -"iterable of the buffers which were passed to *buffer_callback*. That " -"iterable should produce buffers in the same order as they were passed to " -"*buffer_callback*. Those buffers will provide the data expected by the " -"reconstructors of the objects whose pickling produced the original :class:" -"`PickleBuffer` objects." +"On the receiving side, it needs to pass a *buffers* argument " +"to :class:`Unpickler` (or to the :func:`load` or :func:`loads` function), " +"which is an iterable of the buffers which were passed to *buffer_callback*. " +"That iterable should produce buffers in the same order as they were passed " +"to *buffer_callback*. Those buffers will provide the data expected by the " +"reconstructors of the objects whose pickling produced the " +"original :class:`PickleBuffer` objects." msgstr "" msgid "" @@ -1370,16 +1380,16 @@ msgid "" msgstr "" msgid "" -"For this reason, you may want to control what gets unpickled by customizing :" -"meth:`Unpickler.find_class`. Unlike its name suggests, :meth:`Unpickler." -"find_class` is called whenever a global (i.e., a class or a function) is " -"requested. Thus it is possible to either completely forbid globals or " -"restrict them to a safe subset." +"For this reason, you may want to control what gets unpickled by " +"customizing :meth:`Unpickler.find_class`. Unlike its name " +"suggests, :meth:`Unpickler.find_class` is called whenever a global (i.e., a " +"class or a function) is requested. Thus it is possible to either completely " +"forbid globals or restrict them to a safe subset." msgstr "" msgid "" -"Here is an example of an unpickler allowing only few safe classes from the :" -"mod:`builtins` module to be loaded::" +"Here is an example of an unpickler allowing only few safe classes from " +"the :mod:`builtins` module to be loaded::" msgstr "" msgid "" @@ -1479,14 +1489,14 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The :mod:`!pickle` module can be invoked as a script from the command line, " "it will display contents of the pickle files. However, when the pickle file " "that you want to examine comes from an untrusted source, ``-m pickletools`` " -"is a safer option because it does not execute pickle bytecode, see :ref:" -"`pickletools CLI usage `." +"is a safer option because it does not execute pickle bytecode, " +"see :ref:`pickletools CLI usage `." msgstr "" msgid "python -m pickle pickle_file [pickle_file ...]" @@ -1541,8 +1551,8 @@ msgid "" msgstr "" msgid "" -"The exception raised will likely be an :exc:`ImportError` or an :exc:" -"`AttributeError` but it could be something else." +"The exception raised will likely be an :exc:`ImportError` or " +"an :exc:`AttributeError` but it could be something else." msgstr "" msgid "" diff --git a/library/pickletools.po b/library/pickletools.po index 6b36676c89..57f978117c 100644 --- a/library/pickletools.po +++ b/library/pickletools.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,9 +33,9 @@ msgid "" "This module contains various constants relating to the intimate details of " "the :mod:`pickle` module, some lengthy comments about the implementation, " "and a few useful functions for analyzing pickled data. The contents of this " -"module are useful for Python core developers who are working on the :mod:" -"`pickle`; ordinary users of the :mod:`pickle` module probably won't find " -"the :mod:`!pickletools` module relevant." +"module are useful for Python core developers who are working on " +"the :mod:`pickle`; ordinary users of the :mod:`pickle` module probably won't " +"find the :mod:`!pickletools` module relevant." msgstr "" msgid "Command-line usage" diff --git a/library/pkgutil.po b/library/pkgutil.po index e62f3dc9f3..20ea767c57 100644 --- a/library/pkgutil.po +++ b/library/pkgutil.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -49,19 +49,20 @@ msgstr "" msgid "" "For each directory on :data:`sys.path` that has a subdirectory that matches " -"the package name, add the subdirectory to the package's :attr:`~module." -"__path__`. This is useful if one wants to distribute different parts of a " -"single logical package as multiple directories." +"the package name, add the subdirectory to the " +"package's :attr:`~module.__path__`. This is useful if one wants to " +"distribute different parts of a single logical package as multiple " +"directories." msgstr "" msgid "" "It also looks for :file:`\\*.pkg` files beginning where ``*`` matches the " -"*name* argument. This feature is similar to :file:`\\*.pth` files (see the :" -"mod:`site` module for more information), except that it doesn't special-case " -"lines starting with ``import``. A :file:`\\*.pkg` file is trusted at face " -"value: apart from skipping blank lines and ignoring comments, all entries " -"found in a :file:`\\*.pkg` file are added to the path, regardless of whether " -"they exist on the filesystem (this is a feature)." +"*name* argument. This feature is similar to :file:`\\*.pth` files (see " +"the :mod:`site` module for more information), except that it doesn't special-" +"case lines starting with ``import``. A :file:`\\*.pkg` file is trusted at " +"face value: apart from skipping blank lines and ignoring comments, all " +"entries found in a :file:`\\*.pkg` file are added to the path, regardless of " +"whether they exist on the filesystem (this is a feature)." msgstr "" msgid "" @@ -71,11 +72,11 @@ msgid "" msgstr "" msgid "" -"It is assumed that :data:`sys.path` is a sequence. Items of :data:`sys." -"path` that are not strings referring to existing directories are ignored. " -"Unicode items on :data:`sys.path` that cause errors when used as filenames " -"may cause this function to raise an exception (in line with :func:`os.path." -"isdir` behavior)." +"It is assumed that :data:`sys.path` is a sequence. Items " +"of :data:`sys.path` that are not strings referring to existing directories " +"are ignored. Unicode items on :data:`sys.path` that cause errors when used " +"as filenames may cause this function to raise an exception (in line " +"with :func:`os.path.isdir` behavior)." msgstr "" msgid "Retrieve a :term:`finder` for the given *path_item*." @@ -87,8 +88,8 @@ msgid "" msgstr "" msgid "" -"The cache (or part of it) can be cleared manually if a rescan of :data:`sys." -"path_hooks` is necessary." +"The cache (or part of it) can be cleared manually if a rescan " +"of :data:`sys.path_hooks` is necessary." msgstr "" msgid "" @@ -102,8 +103,8 @@ msgstr "" msgid "" "If *fullname* contains a ``'.'``, the finders will be for the package " "containing *fullname*, otherwise they will be all registered top level " -"finders (i.e. those on both :data:`sys.meta_path` and :data:`sys." -"path_hooks`)." +"finders (i.e. those on both :data:`sys.meta_path` " +"and :data:`sys.path_hooks`)." msgstr "" msgid "" @@ -130,8 +131,8 @@ msgstr "" msgid "" "Only works for a :term:`finder` which defines an ``iter_modules()`` method. " "This interface is non-standard, so the module also provides implementations " -"for :class:`importlib.machinery.FileFinder` and :class:`zipimport." -"zipimporter`." +"for :class:`importlib.machinery.FileFinder` " +"and :class:`zipimport.zipimporter`." msgstr "" msgid "" @@ -148,9 +149,9 @@ msgstr "" msgid "" "*onerror* is a function which gets called with one argument (the name of the " "package which was being imported) if any exception occurs while trying to " -"import a package. If no *onerror* function is supplied, :exc:" -"`ImportError`\\s are caught and ignored, while all other exceptions are " -"propagated, terminating the search." +"import a package. If no *onerror* function is " +"supplied, :exc:`ImportError`\\s are caught and ignored, while all other " +"exceptions are propagated, terminating the search." msgstr "" msgid "Examples::" @@ -168,11 +169,11 @@ msgid "Get a resource from a package." msgstr "" msgid "" -"This is a wrapper for the :term:`loader` :meth:`get_data ` API. The *package* argument should be the name of " -"a package, in standard module format (``foo.bar``). The *resource* argument " -"should be in the form of a relative filename, using ``/`` as the path " -"separator." +"This is a wrapper for the :term:`loader` :meth:`get_data " +"` API. The *package* argument should " +"be the name of a package, in standard module format (``foo.bar``). The " +"*resource* argument should be in the form of a relative filename, using ``/" +"`` as the path separator." msgstr "" msgid "" @@ -181,9 +182,9 @@ msgid "" msgstr "" msgid "" -"This function uses the :term:`loader` method :func:`~importlib.abc." -"FileLoader.get_data` to support modules installed in the filesystem, but " -"also in zip files, databases, or elsewhere." +"This function uses the :term:`loader` " +"method :func:`~importlib.abc.FileLoader.get_data` to support modules " +"installed in the filesystem, but also in zip files, databases, or elsewhere." msgstr "" msgid "" @@ -200,9 +201,9 @@ msgid "" "Like the :func:`open` function, :func:`!get_data` can follow parent " "directories (``../``) and absolute paths (starting with ``/`` or ``C:/``, " "for example). It can open compilation/installation artifacts like ``.py`` " -"and ``.pyc`` files or files with :func:`reserved filenames `. To be compatible with non-filesystem loaders, avoid using " -"these features." +"and ``.pyc`` files or files with :func:`reserved filenames " +"`. To be compatible with non-filesystem loaders, avoid " +"using these features." msgstr "" msgid "" @@ -218,10 +219,11 @@ msgstr "" msgid "" "If the package cannot be located or loaded, or it uses a :term:`loader` " -"which does not support :meth:`get_data `, then ``None`` is returned. In particular, the :term:`loader` " -"for :term:`namespace packages ` does not support :meth:" -"`get_data `." +"which does not support :meth:`get_data " +"`, then ``None`` is returned. In " +"particular, the :term:`loader` for :term:`namespace packages ` does not support :meth:`get_data " +"`." msgstr "" msgid "" @@ -233,9 +235,9 @@ msgid "Resolve a name to an object." msgstr "" msgid "" -"This functionality is used in numerous places in the standard library (see :" -"issue:`12915`) - and equivalent functionality is also in widely used third-" -"party packages such as setuptools, Django and Pyramid." +"This functionality is used in numerous places in the standard library " +"(see :issue:`12915`) - and equivalent functionality is also in widely used " +"third-party packages such as setuptools, Django and Pyramid." msgstr "" msgid "" diff --git a/library/platform.po b/library/platform.po index a1fda1819e..530505f892 100644 --- a/library/platform.po +++ b/library/platform.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -168,6 +168,11 @@ msgid "" "is returned if the value cannot be determined." msgstr "" +msgid "" +"On iOS and Android, this is the user-facing OS release. To obtain the Darwin " +"or Linux kernel release, use :func:`os.uname`." +msgstr "" + msgid "" "Returns the system/OS name, such as ``'Linux'``, ``'Darwin'``, ``'Java'``, " "``'Windows'``. An empty string is returned if the value cannot be determined." @@ -190,23 +195,20 @@ msgid "" "string is returned if the value cannot be determined." msgstr "" -msgid "" -"On iOS and Android, this is the user-facing OS version. To obtain the Darwin " -"or Linux kernel version, use :func:`os.uname`." -msgstr "" - msgid "" "Fairly portable uname interface. Returns a :func:`~collections.namedtuple` " -"containing six attributes: :attr:`system`, :attr:`node`, :attr:`release`, :" -"attr:`version`, :attr:`machine`, and :attr:`processor`." +"containing six " +"attributes: :attr:`system`, :attr:`node`, :attr:`release`, :attr:`version`, :attr:`machine`, " +"and :attr:`processor`." msgstr "" msgid ":attr:`processor` is resolved late, on demand." msgstr "" msgid "" -"Note: the first two attribute names differ from the names presented by :func:" -"`os.uname`, where they are named :attr:`!sysname` and :attr:`!nodename`." +"Note: the first two attribute names differ from the names presented " +"by :func:`os.uname`, where they are named :attr:`!sysname` and :attr:`!" +"nodename`." msgstr "" msgid "Entries which cannot be determined are set to ``''``." @@ -257,8 +259,8 @@ msgid "" "As a hint: *ptype* is ``'Uniprocessor Free'`` on single processor NT " "machines and ``'Multiprocessor Free'`` on multi processor machines. The " "``'Free'`` refers to the OS version being free of debugging code. It could " -"also state ``'Checked'`` which means the OS version uses debugging code, i." -"e. code that checks arguments, ranges, etc." +"also state ``'Checked'`` which means the OS version uses debugging code, " +"i.e. code that checks arguments, ranges, etc." msgstr "" msgid "" @@ -291,8 +293,8 @@ msgid "iOS platform" msgstr "" msgid "" -"Get iOS version information and return it as a :func:`~collections." -"namedtuple` with the following attributes:" +"Get iOS version information and return it as " +"a :func:`~collections.namedtuple` with the following attributes:" msgstr "" msgid "``system`` is the OS name; either ``'iOS'`` or ``'iPadOS'``." @@ -393,8 +395,8 @@ msgstr "" msgid "" "``api_level`` - API level of the running device, as an integer (e.g. ``34`` " -"for Android 14). To get the API level which Python was built against, see :" -"func:`sys.getandroidapilevel`." +"for Android 14). To get the API level which Python was built against, " +"see :func:`sys.getandroidapilevel`." msgstr "" msgid "" @@ -418,8 +420,8 @@ msgid "" msgstr "" msgid "" -"Google maintains a `list of known model and device names `__." +"Google maintains a `list of known model and device names `__." msgstr "" msgid "Command-line usage" @@ -437,8 +439,8 @@ msgid "The following options are accepted:" msgstr "" msgid "" -"Print terse information about the platform. This is equivalent to calling :" -"func:`platform.platform` with the *terse* argument set to ``True``." +"Print terse information about the platform. This is equivalent to " +"calling :func:`platform.platform` with the *terse* argument set to ``True``." msgstr "" msgid "" diff --git a/library/plistlib.po b/library/plistlib.po index 1f3f09ed44..7ac651abaa 100644 --- a/library/plistlib.po +++ b/library/plistlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -42,13 +42,13 @@ msgid "" msgstr "" msgid "" -"To write out and to parse a plist file, use the :func:`dump` and :func:" -"`load` functions." +"To write out and to parse a plist file, use the :func:`dump` " +"and :func:`load` functions." msgstr "" msgid "" -"To work with plist data in bytes or string objects, use :func:`dumps` and :" -"func:`loads`." +"To work with plist data in bytes or string objects, use :func:`dumps` " +"and :func:`loads`." msgstr "" msgid "" @@ -172,8 +172,9 @@ msgid "" msgstr "" msgid "" -"Return *value* as a plist-formatted bytes object. See the documentation for :" -"func:`dump` for an explanation of the keyword arguments of this function." +"Return *value* as a plist-formatted bytes object. See the documentation " +"for :func:`dump` for an explanation of the keyword arguments of this " +"function." msgstr "" msgid "The following classes are available:" diff --git a/library/poplib.po b/library/poplib.po index f4fcaecee4..ccd3d83e6e 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,9 +31,9 @@ msgstr "**Kod źródłowy:** :source:`Lib/poplib.py`" msgid "" "This module defines a class, :class:`POP3`, which encapsulates a connection " -"to a POP3 server and implements the protocol as defined in :rfc:`1939`. The :" -"class:`POP3` class supports both the minimal and optional command sets from :" -"rfc:`1939`. The :class:`POP3` class also supports the ``STLS`` command " +"to a POP3 server and implements the protocol as defined in :rfc:`1939`. " +"The :class:`POP3` class supports both the minimal and optional command sets " +"from :rfc:`1939`. The :class:`POP3` class also supports the ``STLS`` command " "introduced in :rfc:`2595` to enable encrypted communication on an already " "established connection." msgstr "" @@ -47,8 +47,9 @@ msgstr "" msgid "" "Note that POP3, though widely supported, is obsolescent. The implementation " "quality of POP3 servers varies widely, and too many are quite poor. If your " -"mailserver supports IMAP, you would be better off using the :class:`imaplib." -"IMAP4` class, as IMAP servers tend to be better implemented." +"mailserver supports IMAP, you would be better off using " +"the :class:`imaplib.IMAP4` class, as IMAP servers tend to be better " +"implemented." msgstr "" msgid "Availability" @@ -76,14 +77,14 @@ msgid "" msgstr "" msgid "" -"All commands will raise an :ref:`auditing event ` ``poplib." -"putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes " -"about to be sent to the remote host." +"All commands will raise an :ref:`auditing event ` " +"``poplib.putline`` with arguments ``self`` and ``line``, where ``line`` is " +"the bytes about to be sent to the remote host." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket." +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket." msgstr "" msgid "" @@ -100,8 +101,9 @@ msgid "*context* parameter added." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -244,8 +246,9 @@ msgid "" msgstr "" msgid "" -"This method supports hostname checking via :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"This method supports hostname checking " +"via :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" diff --git a/library/posix.po b/library/posix.po index ec8f1ba806..4bd4506b12 100644 --- a/library/posix.po +++ b/library/posix.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,15 +36,15 @@ msgid "Availability" msgstr "Dostępność" msgid "" -"**Do not import this module directly.** Instead, import the module :mod:" -"`os`, which provides a *portable* version of this interface. On Unix, the :" -"mod:`os` module provides a superset of the :mod:`!posix` interface. On non-" -"Unix operating systems the :mod:`!posix` module is not available, but a " -"subset is always available through the :mod:`os` interface. Once :mod:`os` " -"is imported, there is *no* performance penalty in using it instead of :mod:`!" -"posix`. In addition, :mod:`os` provides some additional functionality, such " -"as automatically calling :func:`~os.putenv` when an entry in ``os.environ`` " -"is changed." +"**Do not import this module directly.** Instead, import the " +"module :mod:`os`, which provides a *portable* version of this interface. On " +"Unix, the :mod:`os` module provides a superset of the :mod:`!posix` " +"interface. On non-Unix operating systems the :mod:`!posix` module is not " +"available, but a subset is always available through the :mod:`os` " +"interface. Once :mod:`os` is imported, there is *no* performance penalty in " +"using it instead of :mod:`!posix`. In addition, :mod:`os` provides some " +"additional functionality, such as automatically calling :func:`~os.putenv` " +"when an entry in ``os.environ`` is changed." msgstr "" msgid "" @@ -57,10 +57,10 @@ msgstr "" msgid "" "Several operating systems (including AIX and Solaris) provide support for " -"files that are larger than 2 GiB from a C programming model where :c:expr:" -"`int` and :c:expr:`long` are 32-bit values. This is typically accomplished " -"by defining the relevant size and offset types as 64-bit values. Such files " -"are sometimes referred to as :dfn:`large files`." +"files that are larger than 2 GiB from a C programming model " +"where :c:expr:`int` and :c:expr:`long` are 32-bit values. This is typically " +"accomplished by defining the relevant size and offset types as 64-bit " +"values. Such files are sometimes referred to as :dfn:`large files`." msgstr "" msgid "" @@ -109,8 +109,8 @@ msgid "" "Modifying this dictionary does not affect the string environment passed on " "by :func:`~os.execv`, :func:`~os.popen` or :func:`~os.system`; if you need " "to change the environment, pass ``environ`` to :func:`~os.execve` or add " -"variable assignments and export statements to the command string for :func:" -"`~os.system` or :func:`~os.popen`." +"variable assignments and export statements to the command string " +"for :func:`~os.system` or :func:`~os.popen`." msgstr "" msgid "On Unix, keys and values are bytes." @@ -118,10 +118,10 @@ msgstr "" msgid "" "The :mod:`os` module provides an alternate implementation of ``environ`` " -"which updates the environment on modification. Note also that updating :data:" -"`os.environ` will render this dictionary obsolete. Use of the :mod:`os` " -"module version of this is recommended over direct access to the :mod:`!" -"posix` module." +"which updates the environment on modification. Note also that " +"updating :data:`os.environ` will render this dictionary obsolete. Use of " +"the :mod:`os` module version of this is recommended over direct access to " +"the :mod:`!posix` module." msgstr "" msgid "module" diff --git a/library/pprint.po b/library/pprint.po index 6cf8020fd2..cd756cd9bb 100644 --- a/library/pprint.po +++ b/library/pprint.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -55,9 +55,9 @@ msgstr "Zadania" msgid "" "Prints the formatted representation of *object*, followed by a newline. This " -"function may be used in the interactive interpreter instead of the :func:" -"`print` function for inspecting values. Tip: you can reassign ``print = " -"pprint.pp`` for use within a scope." +"function may be used in the interactive interpreter instead of " +"the :func:`print` function for inspecting values. Tip: you can reassign " +"``print = pprint.pp`` for use within a scope." msgstr "" msgid "Parameters" @@ -67,8 +67,9 @@ msgid "The object to be printed." msgstr "" msgid "" -"A file-like object to which the output will be written by calling its :meth:" -"`!write` method. If ``None`` (the default), :data:`sys.stdout` is used." +"A file-like object to which the output will be written by calling " +"its :meth:`!write` method. If ``None`` (the default), :data:`sys.stdout` is " +"used." msgstr "" msgid "The amount of indentation added for each nesting level." @@ -104,6 +105,12 @@ msgid "" "thousands separator, otherwise underscores are not displayed (the default)." msgstr "" +msgid "Added the *underscore_numbers* parameter." +msgstr "" + +msgid "No longer attempts to write to :data:`!sys.stdout` if it is ``None``." +msgstr "" + msgid "" "Alias for :func:`~pprint.pp` with *sort_dicts* set to ``True`` by default, " "which would automatically sort the dictionaries' keys, you might want to " @@ -131,11 +138,12 @@ msgstr "" msgid "" "Return a string representation of *object*, protected against recursion in " -"some common data structures, namely instances of :class:`dict`, :class:" -"`list` and :class:`tuple` or subclasses whose ``__repr__`` has not been " -"overridden. If the representation of object exposes a recursive entry, the " -"recursive reference will be represented as ````. The representation is not otherwise formatted." +"some common data structures, namely instances " +"of :class:`dict`, :class:`list` and :class:`tuple` or subclasses whose " +"``__repr__`` has not been overridden. If the representation of object " +"exposes a recursive entry, the recursive reference will be represented as " +"````. The representation is not " +"otherwise formatted." msgstr "" msgid "PrettyPrinter Objects" @@ -155,12 +163,6 @@ msgstr "" msgid "Added the *sort_dicts* parameter." msgstr "" -msgid "Added the *underscore_numbers* parameter." -msgstr "" - -msgid "No longer attempts to write to :data:`!sys.stdout` if it is ``None``." -msgstr "" - msgid ":class:`PrettyPrinter` instances have the following methods:" msgstr "" @@ -184,9 +186,9 @@ msgstr "" msgid "" "Determine if the formatted representation of the object is \"readable,\" or " "can be used to reconstruct the value using :func:`eval`. Note that this " -"returns ``False`` for recursive objects. If the *depth* parameter of the :" -"class:`PrettyPrinter` is set and the object is deeper than allowed, this " -"returns ``False``." +"returns ``False`` for recursive objects. If the *depth* parameter of " +"the :class:`PrettyPrinter` is set and the object is deeper than allowed, " +"this returns ``False``." msgstr "" msgid "Determine if the object requires a recursive representation." @@ -220,8 +222,8 @@ msgstr "Przykład" msgid "" "To demonstrate several uses of the :func:`~pprint.pp` function and its " -"parameters, let's fetch information about a project from `PyPI `_::" +"parameters, let's fetch information about a project from `PyPI `_::" msgstr "" msgid "" diff --git a/library/profile.po b/library/profile.po index 5ae94c4af5..72189a6557 100644 --- a/library/profile.po +++ b/library/profile.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -52,19 +53,20 @@ msgid "" msgstr "" msgid "" -":mod:`profile`, a pure Python module whose interface is imitated by :mod:" -"`cProfile`, but which adds significant overhead to profiled programs. If " -"you're trying to extend the profiler in some way, the task might be easier " -"with this module. Originally designed and written by Jim Roskind." +":mod:`profile`, a pure Python module whose interface is imitated " +"by :mod:`cProfile`, but which adds significant overhead to profiled " +"programs. If you're trying to extend the profiler in some way, the task " +"might be easier with this module. Originally designed and written by Jim " +"Roskind." msgstr "" msgid "" "The profiler modules are designed to provide an execution profile for a " -"given program, not for benchmarking purposes (for that, there is :mod:" -"`timeit` for reasonably accurate results). This particularly applies to " -"benchmarking Python code against C code: the profilers introduce overhead " -"for Python code, but not for C-level functions, and so the C code would seem " -"faster than any Python one." +"given program, not for benchmarking purposes (for that, there " +"is :mod:`timeit` for reasonably accurate results). This particularly " +"applies to benchmarking Python code against C code: the profilers introduce " +"overhead for Python code, but not for C-level functions, and so the C code " +"would seem faster than any Python one." msgstr "" msgid "Instant User's Manual" @@ -324,7 +326,7 @@ msgid "" msgstr "" msgid "exec(command, __main__.__dict__, __main__.__dict__)" -msgstr "" +msgstr "exec(komenda komendy, __main__.__dict__, __main__.__dict__)" msgid "" "and gathers profiling statistics from the execution. If no file name is " @@ -340,7 +342,7 @@ msgid "" msgstr "" msgid "exec(command, globals, locals)" -msgstr "" +msgstr "exec(komenda komendy, globalne, lokalne)" msgid "and gathers profiling statistics as in the :func:`run` function above." msgstr "" @@ -393,7 +395,7 @@ msgid "" msgstr "" msgid "Added context manager support." -msgstr "" +msgstr "Dodano obsługę menedżer wparcie" msgid "Start collecting profiling data. Only in :mod:`!cProfile`." msgstr "" @@ -481,19 +483,20 @@ msgid "" "printout to fit within (close to) 80 columns. This method modifies the " "object, and the stripped information is lost. After performing a strip " "operation, the object is considered to have its entries in a \"random\" " -"order, as it was just after object initialization and loading. If :meth:" -"`~pstats.Stats.strip_dirs` causes two function names to be indistinguishable " -"(they are on the same line of the same filename, and have the same function " -"name), then the statistics for these two entries are accumulated into a " -"single entry." +"order, as it was just after object initialization and loading. " +"If :meth:`~pstats.Stats.strip_dirs` causes two function names to be " +"indistinguishable (they are on the same line of the same filename, and have " +"the same function name), then the statistics for these two entries are " +"accumulated into a single entry." msgstr "" msgid "" "This method of the :class:`Stats` class accumulates additional profiling " "information into the current profiling object. Its arguments should refer " -"to filenames created by the corresponding version of :func:`profile.run` or :" -"func:`cProfile.run`. Statistics for identically named (re: file, line, name) " -"functions are automatically accumulated into single function statistics." +"to filenames created by the corresponding version of :func:`profile.run` " +"or :func:`cProfile.run`. Statistics for identically named (re: file, line, " +"name) functions are automatically accumulated into single function " +"statistics." msgstr "" msgid "" @@ -639,12 +642,12 @@ msgstr "" msgid "" "Note that all sorts on statistics are in descending order (placing most time " "consuming items first), where as name, file, and line number searches are in " -"ascending order (alphabetical). The subtle distinction between ``SortKey." -"NFL`` and ``SortKey.STDNAME`` is that the standard name is a sort of the " -"name as printed, which means that the embedded line numbers get compared in " -"an odd way. For example, lines 3, 20, and 40 would (if the file names were " -"the same) appear in the string order 20, 3 and 40. In contrast, ``SortKey." -"NFL`` does a numeric compare of the line numbers. In fact, " +"ascending order (alphabetical). The subtle distinction between " +"``SortKey.NFL`` and ``SortKey.STDNAME`` is that the standard name is a sort " +"of the name as printed, which means that the embedded line numbers get " +"compared in an odd way. For example, lines 3, 20, and 40 would (if the file " +"names were the same) appear in the string order 20, 3 and 40. In contrast, " +"``SortKey.NFL`` does a numeric compare of the line numbers. In fact, " "``sort_stats(SortKey.NFL)`` is the same as ``sort_stats(SortKey.NAME, " "SortKey.FILENAME, SortKey.LINE)``." msgstr "" @@ -672,9 +675,10 @@ msgid "" msgstr "" msgid "" -"The order of the printing is based on the last :meth:`~pstats.Stats." -"sort_stats` operation done on the object (subject to caveats in :meth:" -"`~pstats.Stats.add` and :meth:`~pstats.Stats.strip_dirs`)." +"The order of the printing is based on the " +"last :meth:`~pstats.Stats.sort_stats` operation done on the object (subject " +"to caveats in :meth:`~pstats.Stats.add` " +"and :meth:`~pstats.Stats.strip_dirs`)." msgstr "" msgid "" @@ -784,7 +788,7 @@ msgid "" msgstr "" msgid "Limitations" -msgstr "" +msgstr "Ograniczenia" msgid "" "One limitation has to do with accuracy of timing information. There is a " @@ -879,7 +883,7 @@ msgid "" msgstr "" msgid "Using a custom timer" -msgstr "" +msgstr "Korzystanie z niestandardowego timera" msgid "" "If you want to change how current time is determined (for example, to force " @@ -941,8 +945,8 @@ msgstr "" msgid "" "Python 3.3 adds several new functions in :mod:`time` that can be used to " -"make precise measurements of process or wall-clock time. For example, see :" -"func:`time.perf_counter`." +"make precise measurements of process or wall-clock time. For example, " +"see :func:`time.perf_counter`." msgstr "" msgid "deterministic profiling" diff --git a/library/pty.po b/library/pty.po index 8c73a49f56..f5bc03878c 100644 --- a/library/pty.po +++ b/library/pty.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pwd.po b/library/pwd.po index e3fcc38f96..aff4dea0bf 100644 --- a/library/pwd.po +++ b/library/pwd.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/py_compile.po b/library/py_compile.po index a26d90aad1..2770a2dce4 100644 --- a/library/py_compile.po +++ b/library/py_compile.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -64,9 +64,9 @@ msgid "" "The *doraise* and *quiet* arguments determine how errors are handled while " "compiling file. If *quiet* is 0 or 1, and *doraise* is false, the default " "behaviour is enabled: an error string is written to ``sys.stderr``, and the " -"function returns ``None`` instead of a path. If *doraise* is true, a :exc:" -"`PyCompileError` is raised instead. However if *quiet* is 2, no message is " -"written, and *doraise* has no effect." +"function returns ``None`` instead of a path. If *doraise* is true, " +"a :exc:`PyCompileError` is raised instead. However if *quiet* is 2, no " +"message is written, and *doraise* has no effect." msgstr "" msgid "" @@ -79,16 +79,16 @@ msgid "" msgstr "" msgid "" -"*optimize* controls the optimization level and is passed to the built-in :" -"func:`compile` function. The default of ``-1`` selects the optimization " +"*optimize* controls the optimization level and is passed to the built-" +"in :func:`compile` function. The default of ``-1`` selects the optimization " "level of the current interpreter." msgstr "" msgid "" "*invalidation_mode* should be a member of the :class:`PycInvalidationMode` " "enum and controls how the generated bytecode cache is invalidated at " -"runtime. The default is :attr:`PycInvalidationMode.CHECKED_HASH` if the :" -"envvar:`SOURCE_DATE_EPOCH` environment variable is set, otherwise the " +"runtime. The default is :attr:`PycInvalidationMode.CHECKED_HASH` if " +"the :envvar:`SOURCE_DATE_EPOCH` environment variable is set, otherwise the " "default is :attr:`PycInvalidationMode.TIMESTAMP`." msgstr "" @@ -109,8 +109,8 @@ msgstr "" msgid "" "The *invalidation_mode* parameter was added as specified in :pep:`552`. If " "the :envvar:`SOURCE_DATE_EPOCH` environment variable is set, " -"*invalidation_mode* will be forced to :attr:`PycInvalidationMode." -"CHECKED_HASH`." +"*invalidation_mode* will be forced " +"to :attr:`PycInvalidationMode.CHECKED_HASH`." msgstr "" msgid "" diff --git a/library/pyclbr.po b/library/pyclbr.po index e8dff6187f..940bf60048 100644 --- a/library/pyclbr.po +++ b/library/pyclbr.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pydoc.po b/library/pydoc.po index e481772475..c895ba9a72 100644 --- a/library/pydoc.po +++ b/library/pydoc.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -41,8 +41,8 @@ msgid "" "of the object, and recursively of its documentable members. If there is no " "docstring, :mod:`!pydoc` tries to obtain a description from the block of " "comment lines just above the definition of the class, function or method in " -"the source file, or at the top of the module (see :func:`inspect." -"getcomments`)." +"the source file, or at the top of the module " +"(see :func:`inspect.getcomments`)." msgstr "" msgid "" @@ -76,9 +76,10 @@ msgstr "" msgid "" "When printing output to the console, :program:`pydoc` attempts to paginate " -"the output for easier reading. If either the :envvar:`MANPAGER` or the :" -"envvar:`PAGER` environment variable is set, :program:`pydoc` will use its " -"value as a pagination program. When both are set, :envvar:`MANPAGER` is used." +"the output for easier reading. If either the :envvar:`MANPAGER` or " +"the :envvar:`PAGER` environment variable is set, :program:`pydoc` will use " +"its value as a pagination program. When both are set, :envvar:`MANPAGER` is " +"used." msgstr "" msgid "" @@ -96,11 +97,16 @@ msgstr "" msgid "" "You can also use :program:`pydoc` to start an HTTP server on the local " -"machine that will serve documentation to visiting web browsers. :program:" -"`python -m pydoc -p 1234` will start a HTTP server on port 1234, allowing " -"you to browse the documentation at ``http://localhost:1234/`` in your " -"preferred web browser. Specifying ``0`` as the port number will select an " -"arbitrary unused port." +"machine that will serve documentation to visiting web " +"browsers. :program:`python -m pydoc -p 1234` will start a HTTP server on " +"port 1234, allowing you to browse the documentation at ``http://" +"localhost:1234/`` in your preferred web browser. Specifying ``0`` as the " +"port number will select an arbitrary unused port." +msgstr "" + +msgid "" +"The :mod:`!pydoc` HTTP server is intended for local use during development " +"and is not suitable for production use." msgstr "" msgid "" @@ -127,11 +133,11 @@ msgid "" msgstr "" msgid "" -"Module docs for core modules are assumed to reside in ``https://docs.python." -"org/X.Y/library/`` where ``X`` and ``Y`` are the major and minor version " -"numbers of the Python interpreter. This can be overridden by setting the :" -"envvar:`!PYTHONDOCS` environment variable to a different URL or to a local " -"directory containing the Library Reference Manual pages." +"Module docs for core modules are assumed to reside in ``https://" +"docs.python.org/X.Y/library/`` where ``X`` and ``Y`` are the major and minor " +"version numbers of the Python interpreter. This can be overridden by " +"setting the :envvar:`!PYTHONDOCS` environment variable to a different URL or " +"to a local directory containing the Library Reference Manual pages." msgstr "" msgid "Added the ``-b`` option." @@ -141,8 +147,9 @@ msgid "The ``-g`` command line option was removed." msgstr "" msgid "" -":mod:`!pydoc` now uses :func:`inspect.signature` rather than :func:`inspect." -"getfullargspec` to extract signature information from callables." +":mod:`!pydoc` now uses :func:`inspect.signature` rather " +"than :func:`inspect.getfullargspec` to extract signature information from " +"callables." msgstr "" msgid "Added the ``-n`` option." diff --git a/library/pyexpat.po b/library/pyexpat.po index d7636657c7..17e5a74cd4 100644 --- a/library/pyexpat.po +++ b/library/pyexpat.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,12 +33,12 @@ msgstr "" msgid "" "The :mod:`!xml.parsers.expat` module is a Python interface to the Expat non-" -"validating XML parser. The module provides a single extension type, :class:" -"`xmlparser`, that represents the current state of an XML parser. After an :" -"class:`xmlparser` object has been created, various attributes of the object " -"can be set to handler functions. When an XML document is then fed to the " -"parser, the handler functions are called for the character data and markup " -"in the XML document." +"validating XML parser. The module provides a single extension " +"type, :class:`xmlparser`, that represents the current state of an XML " +"parser. After an :class:`xmlparser` object has been created, various " +"attributes of the object can be set to handler functions. When an XML " +"document is then fed to the parser, the handler functions are called for the " +"character data and markup in the XML document." msgstr "" msgid "" @@ -46,12 +46,14 @@ msgid "" "parser. Direct use of the :mod:`pyexpat` module is deprecated." msgstr "" -msgid "This module provides one exception and one type object:" +msgid "" +"This module provides the following exception, type object and data items:" msgstr "" msgid "" -"The exception raised when Expat reports an error. See section :ref:" -"`expaterror-objects` for more information on interpreting Expat errors." +"The exception raised when Expat reports an error. See " +"section :ref:`expaterror-objects` for more information on interpreting Expat " +"errors." msgstr "" msgid "Alias for :exc:`ExpatError`." @@ -60,6 +62,25 @@ msgstr "" msgid "The type of the return values from the :func:`ParserCreate` function." msgstr "" +msgid "" +"The version string of the Expat library loaded by the interpreter, like " +"``'expat_2.8.4'``." +msgstr "" + +msgid "" +"The version of the Expat library loaded by the interpreter, as a tuple of " +"three integers: major, minor and micro version." +msgstr "" + +msgid "" +"The list of the features with which the loaded Expat library was compiled, " +"as ``(name, value)`` pairs. The value is only meaningful for features which " +"have one, like ``'XML_CONTEXT_BYTES'`` or the default protection limits " +"``'XML_BLAP_ACT_THRES'`` and ``'XML_AT_MAX_AMP'``; for other features, like " +"``'XML_DTD'`` and ``'XML_NS'``, the value is ``0`` and only the presence of " +"the name is significant." +msgstr "" + msgid "The :mod:`!xml.parsers.expat` module contains two functions:" msgstr "" @@ -78,8 +99,8 @@ msgstr "" msgid "" "Parsers created through :func:`!ParserCreate` are called \"root\" parsers, " "in the sense that they do not have any parent parser attached. Non-root " -"parsers are created by :meth:`parser.ExternalEntityParserCreate `." +"parsers are created by :meth:`parser.ExternalEntityParserCreate " +"`." msgstr "" msgid "" @@ -122,10 +143,16 @@ msgid "" msgstr "" msgid "" -"Due to limitations in the ``Expat`` library used by :mod:`pyexpat`, the :" -"class:`xmlparser` instance returned can only be used to parse a single XML " -"document. Call ``ParserCreate`` for each document to provide unique parser " -"instances." +"*intern*, if given, must be a dictionary. It is used to intern the names of " +"elements and attributes, and is available as the :attr:`~xmlparser.intern` " +"attribute. By default a new empty dictionary is created for every parser." +msgstr "" + +msgid "" +"Due to limitations in the ``Expat`` library used by :mod:`pyexpat`, " +"the :class:`xmlparser` instance returned can only be used to parse a single " +"XML document. Call ``ParserCreate`` for each document to provide unique " +"parser instances." msgstr "" msgid "`The Expat XML Parser `_" @@ -141,53 +168,59 @@ msgid ":class:`xmlparser` objects have the following methods:" msgstr "" msgid "" -"Parses the contents of the string *data*, calling the appropriate handler " -"functions to process the parsed data. *isfinal* must be true on the final " -"call to this method; it allows the parsing of a single file in fragments, " -"not the submission of multiple files. *data* can be the empty string at any " -"time." +"Parses the contents of *data*, calling the appropriate handler functions to " +"process the parsed data. *data* can be a :term:`bytes-like object` or a " +"string. If it is a string, the encoding declaration in the XML data is " +"ignored, and the data is parsed as already decoded text. *isfinal* must be " +"true on the final call to this method; it allows the parsing of a single " +"file in fragments, not the submission of multiple files. *data* can be empty " +"at any time." msgstr "" msgid "" -"Parse XML data reading from the object *file*. *file* only needs to provide " -"the ``read(nbytes)`` method, returning the empty string when there's no more " -"data." +"Parse XML data reading from the object *file*. *file* only needs to provide " +"the ``read(nbytes)`` method, which returns bytes, and an empty bytes object " +"when there's no more data. Text files are not supported; use :meth:`Parse` " +"for data which is already decoded." msgstr "" msgid "" "Sets the base to be used for resolving relative URIs in system identifiers " "in declarations. Resolving relative identifiers is left to the application: " -"this value will be passed through as the *base* argument to the :func:" -"`ExternalEntityRefHandler`, :func:`NotationDeclHandler`, and :func:" -"`UnparsedEntityDeclHandler` functions." +"this value will be passed through as the *base* argument to " +"the :func:`ExternalEntityRefHandler`, :func:`NotationDeclHandler`, " +"and :func:`UnparsedEntityDeclHandler` functions." msgstr "" msgid "" -"Returns a string containing the base set by a previous call to :meth:" -"`SetBase`, or ``None`` if :meth:`SetBase` hasn't been called." +"Returns a string containing the base set by a previous call " +"to :meth:`SetBase`, or ``None`` if :meth:`SetBase` hasn't been called." msgstr "" msgid "" -"Returns the input data that generated the current event as a string. The " -"data is in the encoding of the entity which contains the text. When called " -"while an event handler is not active, the return value is ``None``." +"Returns the input data which generated the current event as a :class:`bytes` " +"object. The data is in the encoding of the entity which contains the text. " +"It extends to the end of the currently buffered input, therefore it can " +"contain also the data of the following events, and if the event was " +"generated by a large amount of text, not all of it may be available. When " +"called while an event handler is not active, the return value is ``None``." msgstr "" msgid "" "Create a \"child\" parser which can be used to parse an external parsed " "entity referred to by content parsed by the parent parser. The *context* " -"parameter should be the string passed to the :meth:" -"`ExternalEntityRefHandler` handler function, described below. The child " -"parser is created with the :attr:`ordered_attributes` and :attr:" -"`specified_attributes` set to the values of this parser." +"parameter should be the string passed to " +"the :meth:`ExternalEntityRefHandler` handler function, described below. The " +"child parser is created with the :attr:`ordered_attributes` " +"and :attr:`specified_attributes` set to the values of this parser." msgstr "" msgid "" "Control parsing of parameter entities (including the external DTD subset). " -"Possible *flag* values are :const:`XML_PARAM_ENTITY_PARSING_NEVER`, :const:" -"`XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE` and :const:" -"`XML_PARAM_ENTITY_PARSING_ALWAYS`. Return true if setting the flag was " -"successful." +"Possible *flag* values " +"are :const:`XML_PARAM_ENTITY_PARSING_NEVER`, :const:`XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE` " +"and :const:`XML_PARAM_ENTITY_PARSING_ALWAYS`. Return true if setting the " +"flag was successful." msgstr "" msgid "" @@ -195,8 +228,8 @@ msgid "" "call the :attr:`ExternalEntityRefHandler` with :const:`None` for all " "arguments to allow an alternate DTD to be loaded. If the document does not " "contain a document type declaration, the :attr:`ExternalEntityRefHandler` " -"will still be called, but the :attr:`StartDoctypeDeclHandler` and :attr:" -"`EndDoctypeDeclHandler` will not be called." +"will still be called, but the :attr:`StartDoctypeDeclHandler` " +"and :attr:`EndDoctypeDeclHandler` will not be called." msgstr "" msgid "" @@ -233,8 +266,8 @@ msgstr "" msgid "" "Note that :meth:`SetReparseDeferralEnabled` has been backported to some " -"prior releases of CPython as a security fix. Check for availability of :" -"meth:`SetReparseDeferralEnabled` using :func:`hasattr` if used in code " +"prior releases of CPython as a security fix. Check for availability " +"of :meth:`SetReparseDeferralEnabled` using :func:`hasattr` if used in code " "running across a variety of Python versions." msgstr "" @@ -244,47 +277,60 @@ msgid "" msgstr "" msgid "" -":class:`!xmlparser` objects have the following methods to mitigate some " -"common XML vulnerabilities." +":class:`!xmlparser` objects have the following methods to tune protections " +"against some common XML vulnerabilities." msgstr "" msgid "" -"Sets the number of allocated bytes of dynamic memory needed to activate " -"protection against disproportionate use of RAM." +"Sets the number of output bytes needed to activate protection against " +"`billion laughs`_ attacks." +msgstr "" + +msgid "" +"The number of output bytes includes amplification from entity expansion and " +"reading DTD files." msgstr "" msgid "" -"By default, parser objects have an allocation activation threshold of 64 " -"MiB, or equivalently 67,108,864 bytes." +"Parser objects usually have a protection activation threshold of 8 MiB, but " +"the actual default value depends on the underlying Expat library." msgstr "" msgid "" "An :exc:`ExpatError` is raised if this method is called on a |xml-non-root-" -"parser| parser. The corresponding :attr:`~ExpatError.lineno` and :attr:" -"`~ExpatError.offset` should not be used as they may have no special meaning." +"parser| parser. The corresponding :attr:`~ExpatError.lineno` " +"and :attr:`~ExpatError.offset` should not be used as they may have no " +"special meaning." msgstr "" msgid "" -"Sets the maximum amplification factor between direct input and bytes of " -"dynamic memory allocated." +"Activation thresholds below 4 MiB are known to break support for DITA 1.3 " +"payload and are hence not recommended." msgstr "" msgid "" -"The amplification factor is calculated as ``allocated / direct`` while " -"parsing, where ``direct`` is the number of bytes read from the primary " -"document in parsing and ``allocated`` is the number of bytes of dynamic " -"memory allocated in the parser hierarchy." +"Sets the maximum tolerated amplification factor for protection against " +"`billion laughs`_ attacks." +msgstr "" + +msgid "" +"The amplification factor is calculated as ``(direct + indirect) / direct`` " +"while parsing, where ``direct`` is the number of bytes read from the primary " +"document in parsing and ``indirect`` is the number of bytes added by " +"expanding entities and reading of external DTD files." msgstr "" msgid "" "The *max_factor* value must be a non-NaN :class:`float` value greater than " -"or equal to 1.0. Amplification factors greater than 100.0 can be observed " -"near the start of parsing even with benign files in practice. In particular, " -"the activation threshold should be carefully chosen to avoid false positives." +"or equal to 1.0. Peak amplifications of factor 15,000 for the entire payload " +"and of factor 30,000 in the middle of parsing have been observed with small " +"benign files in practice. In particular, the activation threshold should be " +"carefully chosen to avoid false positives." msgstr "" msgid "" -"By default, parser objects have a maximum amplification factor of 100.0." +"Parser objects usually have a maximum amplification factor of 100, but the " +"actual default value depends on the underlying Expat library." msgstr "" msgid "" @@ -294,6 +340,41 @@ msgid "" "should not be used as they may have no special meaning." msgstr "" +msgid "" +"The maximum amplification factor is only considered if the threshold that " +"can be adjusted " +"by :meth:`.SetBillionLaughsAttackProtectionActivationThreshold` is exceeded." +msgstr "" + +msgid "" +"Sets the number of allocated bytes of dynamic memory needed to activate " +"protection against disproportionate use of RAM." +msgstr "" + +msgid "" +"Parser objects usually have an allocation activation threshold of 64 MiB, " +"but the actual default value depends on the underlying Expat library." +msgstr "" + +msgid "" +"Sets the maximum amplification factor between direct input and bytes of " +"dynamic memory allocated." +msgstr "" + +msgid "" +"The amplification factor is calculated as ``allocated / direct`` while " +"parsing, where ``direct`` is the number of bytes read from the primary " +"document in parsing and ``allocated`` is the number of bytes of dynamic " +"memory allocated in the parser hierarchy." +msgstr "" + +msgid "" +"The *max_factor* value must be a non-NaN :class:`float` value greater than " +"or equal to 1.0. Amplification factors greater than 100.0 can be observed " +"near the start of parsing even with benign files in practice. In particular, " +"the activation threshold should be carefully chosen to avoid false positives." +msgstr "" + msgid "" "The maximum amplification factor is only considered if the threshold that " "can be adjusted by :meth:`.SetAllocTrackerActivationThreshold` is exceeded." @@ -310,12 +391,12 @@ msgstr "" msgid "" "Setting this to true causes the :class:`xmlparser` object to buffer textual " -"content returned by Expat to avoid multiple calls to the :meth:" -"`CharacterDataHandler` callback whenever possible. This can improve " -"performance substantially since Expat normally breaks character data into " -"chunks at every line ending. This attribute is false by default, and may be " -"changed at any time. Note that when it is false, data that does not contain " -"newlines may be chunked too." +"content returned by Expat to avoid multiple calls to " +"the :meth:`CharacterDataHandler` callback whenever possible. This can " +"improve performance substantially since Expat normally breaks character data " +"into chunks at every line ending. This attribute is false by default, and " +"may be changed at any time. Note that when it is false, data that does not " +"contain newlines may be chunked too." msgstr "" msgid "" @@ -343,20 +424,33 @@ msgid "" "time." msgstr "" +msgid "" +"The dictionary used to intern the names of elements and attributes. It is " +"either the dictionary passed as the *intern* argument " +"of :func:`ParserCreate`, or a new dictionary created for this parser." +msgstr "" + +msgid "" +"If set to a true value, and namespace processing is enabled, the namespace " +"prefix is reported as the third part of the expanded name, separated by the " +"namespace separator. Names which have no prefix are not affected. By " +"default, this attribute is false; it may be changed at any time." +msgstr "" + msgid "" "The following attributes contain values relating to the most recent error " "encountered by an :class:`xmlparser` object, and will only have correct " -"values once a call to :meth:`Parse` or :meth:`ParseFile` has raised an :exc:" -"`xml.parsers.expat.ExpatError` exception." +"values once a call to :meth:`Parse` or :meth:`ParseFile` has raised " +"an :exc:`xml.parsers.expat.ExpatError` exception." msgstr "" msgid "Byte index at which an error occurred." msgstr "" msgid "" -"Numeric code specifying the problem. This value can be passed to the :func:" -"`ErrorString` function, or compared to one of the constants defined in the " -"``errors`` object." +"Numeric code specifying the problem. This value can be passed to " +"the :func:`ErrorString` function, or compared to one of the constants " +"defined in the ``errors`` object." msgstr "" msgid "Column number at which an error occurred." @@ -384,11 +478,11 @@ msgid "Current line number in the parser input." msgstr "" msgid "" -"Here is the list of handlers that can be set. To set a handler on an :class:" -"`xmlparser` object *o*, use ``o.handlername = func``. *handlername* must be " -"taken from the following list, and *func* must be a callable object " -"accepting the correct number of arguments. The arguments are all strings, " -"unless otherwise stated." +"Here is the list of handlers that can be set. To set a handler on " +"an :class:`xmlparser` object *o*, use ``o.handlername = func``. " +"*handlername* must be taken from the following list, and *func* must be a " +"callable object accepting the correct number of arguments. The arguments " +"are all strings, unless otherwise stated." msgstr "" msgid "" @@ -397,8 +491,7 @@ msgid "" "the encoding of the document text, and an optional \"standalone\" " "declaration. *version* and *encoding* will be strings, and *standalone* will " "be ``1`` if the document is declared standalone, ``0`` if it is declared not " -"to be standalone, or ``-1`` if the standalone clause was omitted. This is " -"only available with Expat version 1.95.0 or newer." +"to be standalone, or ``-1`` if the standalone clause was omitted." msgstr "" msgid "" @@ -406,13 +499,10 @@ msgid "" "DOCTYPE ...``). The *doctypeName* is provided exactly as presented. The " "*systemId* and *publicId* parameters give the system and public identifiers " "if specified, or ``None`` if omitted. *has_internal_subset* will be true if " -"the document contains an internal document declaration subset. This requires " -"Expat version 1.2 or newer." +"the document contains an internal document declaration subset." msgstr "" -msgid "" -"Called when Expat is done parsing the document type declaration. This " -"requires Expat version 1.2 or newer." +msgid "Called when Expat is done parsing the document type declaration." msgstr "" msgid "" @@ -425,20 +515,22 @@ msgid "" "list declaration declares three attributes, this handler is called three " "times, once for each attribute. *elname* is the name of the element to " "which the declaration applies and *attname* is the name of the attribute " -"declared. The attribute type is a string passed as *type*; the possible " -"values are ``'CDATA'``, ``'ID'``, ``'IDREF'``, ... *default* gives the " -"default value for the attribute used when the attribute is not specified by " -"the document instance, or ``None`` if there is no default value " -"(``#IMPLIED`` values). If the attribute is required to be given in the " -"document instance, *required* will be true. This requires Expat version " -"1.95.0 or newer." +"declared. The The attribute type is a string passed as *type*: ``'CDATA'``, " +"``'ID'``, ``'IDREF'``, ``'IDREFS'``, ``'ENTITY'``, ``'ENTITIES'``, " +"``'NMTOKEN'`` or ``'NMTOKENS'``, an enumeration like ``'(x|y)'``, or a " +"notation list like ``'NOTATION(n1|n2)'``. *default* gives the default value " +"for the attribute used when the attribute is not specified by the document " +"instance, or ``None`` if there is no default value (``#IMPLIED`` values). " +"If the attribute is required to be given in the document instance, " +"*required* will be true." msgstr "" msgid "" "Called for the start of every element. *name* is a string containing the " -"element name, and *attributes* is the element attributes. If :attr:" -"`ordered_attributes` is true, this is a list (see :attr:`ordered_attributes` " -"for a full description). Otherwise it's a dictionary mapping names to values." +"element name, and *attributes* is the element attributes. " +"If :attr:`ordered_attributes` is true, this is a list " +"(see :attr:`ordered_attributes` for a full description). Otherwise it's a " +"dictionary mapping names to values." msgstr "" msgid "Called for the end of every element." @@ -450,19 +542,19 @@ msgstr "" msgid "" "Called for character data. This will be called for normal character data, " "CDATA marked content, and ignorable whitespace. Applications which must " -"distinguish these cases can use the :attr:`StartCdataSectionHandler`, :attr:" -"`EndCdataSectionHandler`, and :attr:`ElementDeclHandler` callbacks to " -"collect the required information. Note that the character data may be " -"chunked even if it is short and so you may receive more than one call to :" -"meth:`CharacterDataHandler`. Set the :attr:`buffer_text` instance attribute " -"to ``True`` to avoid that." +"distinguish these cases can use " +"the :attr:`StartCdataSectionHandler`, :attr:`EndCdataSectionHandler`, " +"and :attr:`ElementDeclHandler` callbacks to collect the required " +"information. Note that the character data may be chunked even if it is short " +"and so you may receive more than one call to :meth:`CharacterDataHandler`. " +"Set the :attr:`buffer_text` instance attribute to ``True`` to avoid that." msgstr "" msgid "" -"Called for unparsed (NDATA) entity declarations. This is only present for " -"version 1.2 of the Expat library; for more recent versions, use :attr:" -"`EntityDeclHandler` instead. (The underlying function in the Expat library " -"has been declared obsolete.)" +"Called for unparsed (NDATA) entity declarations. If this handler is not set, " +"such declarations are reported by :attr:`EntityDeclHandler`, which is " +"preferred for new code. (The underlying function in the Expat library has " +"been declared obsolete.)" msgstr "" msgid "" @@ -472,8 +564,7 @@ msgid "" "be ``None`` for parsed entities, and the name of the notation for unparsed " "entities. *is_parameter_entity* will be true if the entity is a parameter " "entity or false for general entities (most applications only need to be " -"concerned with general entities). This is only available starting with " -"version 1.95.0 of the Expat library." +"concerned with general entities)." msgstr "" msgid "" @@ -491,10 +582,10 @@ msgstr "" msgid "" "Called when the closing tag is reached for an element that contained a " "namespace declaration. This is called once for each namespace declaration " -"on the element in the reverse of the order for which the :attr:" -"`StartNamespaceDeclHandler` was called to indicate the start of each " -"namespace declaration's scope. Calls to this handler are made after the " -"corresponding :attr:`EndElementHandler` for the end of the element." +"on the element in the reverse of the order for which " +"the :attr:`StartNamespaceDeclHandler` was called to indicate the start of " +"each namespace declaration's scope. Calls to this handler are made after " +"the corresponding :attr:`EndElementHandler` for the end of the element." msgstr "" msgid "" @@ -503,9 +594,9 @@ msgid "" msgstr "" msgid "" -"Called at the start of a CDATA section. This and :attr:" -"`EndCdataSectionHandler` are needed to be able to identify the syntactical " -"start and end for CDATA sections." +"Called at the start of a CDATA section. This " +"and :attr:`EndCdataSectionHandler` are needed to be able to identify the " +"syntactical start and end for CDATA sections." msgstr "" msgid "Called at the end of a CDATA section." @@ -519,7 +610,7 @@ msgid "" msgstr "" msgid "" -"This is the same as the :func:`DefaultHandler`, but doesn't inhibit " +"This is the same as the :attr:`DefaultHandler`, but doesn't inhibit " "expansion of internal entities. The entity reference will not be passed to " "the default handler." msgstr "" @@ -537,8 +628,8 @@ msgid "" "Implementing a handler that accesses local files and/or the network may " "create a vulnerability to `external entity attacks `_ if :class:`xmlparser` is used with user-" -"provided XML content. Please reflect on your `threat model `_ before implementing this handler." +"provided XML content. Please reflect on your `threat model `_ before implementing this handler." msgstr "" msgid "" @@ -554,13 +645,21 @@ msgid "" "responsible for creating the sub-parser using " "``ExternalEntityParserCreate(context)``, initializing it with the " "appropriate callbacks, and parsing the entity. This handler should return " -"an integer; if it returns ``0``, the parser will raise an :const:" -"`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will continue." +"an integer; if it returns ``0``, the parser will raise " +"an :const:`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will " +"continue." msgstr "" msgid "" -"If this handler is not provided, external entities are reported by the :attr:" -"`DefaultHandler` callback, if provided." +"If this handler is not provided, external entities are reported by " +"the :attr:`DefaultHandler` callback, if provided." +msgstr "" + +msgid "" +"Called for entity references which are not expanded, because the parser did " +"not read the declaration of the entity. This happens when the external DTD " +"subset or an external parameter entity is not parsed. *is_parameter_entity* " +"is true for a parameter entity and false for a general entity." msgstr "" msgid "ExpatError Exceptions" @@ -570,9 +669,9 @@ msgid ":exc:`ExpatError` exceptions have a number of interesting attributes:" msgstr "" msgid "" -"Expat's internal error number for the specific error. The :data:`errors." -"messages ` dictionary maps these error " -"numbers to Expat's error messages. For example::" +"Expat's internal error number for the specific error. " +"The :data:`errors.messages ` dictionary " +"maps these error numbers to Expat's error messages. For example::" msgstr "" msgid "" @@ -658,8 +757,8 @@ msgid "" msgstr "" msgid "" -"The values of the first two fields are constants defined in the :mod:`!xml." -"parsers.expat.model` module. These constants can be collected in two " +"The values of the first two fields are constants defined in the :mod:`!" +"xml.parsers.expat.model` module. These constants can be collected in two " "groups: the model type group and the quantifier group." msgstr "" @@ -679,6 +778,15 @@ msgstr "" msgid "Elements which are declared to be ``EMPTY`` have this model type." msgstr "" +msgid "" +"The named element allows character data, optionally interspersed with the " +"named children; this is used for content models such as ``(#PCDATA)`` and " +"``(#PCDATA | A | B)*``." +msgstr "" + +msgid "The model names a single element, as for ``A``." +msgstr "" + msgid "" "Models which represent a series of models which follow one after the other " "are indicated with this model type. This is used for models such as ``(A, " @@ -709,8 +817,8 @@ msgid "" "of the :exc:`ExpatError` exception objects raised when an error has " "occurred. Since for backwards compatibility reasons, the constants' value is " "the error *message* and not the numeric error *code*, you do this by " -"comparing its :attr:`code` attribute with :samp:`errors.codes[errors." -"XML_ERROR_{CONSTANT_NAME}]`." +"comparing its :attr:`code` attribute " +"with :samp:`errors.codes[errors.XML_ERROR_{CONSTANT_NAME}]`." msgstr "" msgid "The ``errors`` module has the following attributes:" @@ -755,7 +863,7 @@ msgstr "" msgid "" "The document contains no elements (XML requires all documents to contain " -"exactly one top-level element).." +"exactly one top-level element)." msgstr "" msgid "Expat was not able to allocate memory internally." @@ -794,8 +902,8 @@ msgstr "" msgid "" "The parser determined that the document was not \"standalone\" though it " -"declared itself to be in the XML declaration, and the :attr:" -"`NotStandaloneHandler` was set and returned ``0``." +"declared itself to be in the XML declaration, and " +"the :attr:`NotStandaloneHandler` was set and returned ``0``." msgstr "" msgid "" @@ -806,8 +914,8 @@ msgstr "" msgid "" "A behavioral change was requested after parsing started that can only be " -"changed before parsing has started. This is (currently) only raised by :" -"meth:`UseForeignDTD`." +"changed before parsing has started. This is (currently) only raised " +"by :meth:`UseForeignDTD`." msgstr "" msgid "An undeclared prefix was found when namespace processing was enabled." @@ -821,7 +929,7 @@ msgstr "" msgid "A parameter entity contained incomplete markup." msgstr "" -msgid "The document contained no document element at all." +msgid "There was an error parsing the XML declaration." msgstr "" msgid "There was an error parsing a text declaration in an external entity." @@ -878,8 +986,8 @@ msgstr "Przypisy" msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See https://" -"www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://www.iana." -"org/assignments/character-sets/character-sets.xhtml." +"www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://" +"www.iana.org/assignments/character-sets/character-sets.xhtml." msgstr "" msgid "Expat" diff --git a/library/queue.po b/library/queue.po index 003daf0a0c..421a1ea074 100644 --- a/library/queue.po +++ b/library/queue.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -119,13 +119,19 @@ msgid "" msgstr "" msgid "" -"Exception raised when non-blocking :meth:`~Queue.get` (or :meth:`~Queue." -"get_nowait`) is called on a :class:`Queue` object which is empty." +"Simple queues are :ref:`generic ` over the type of their items." msgstr "" msgid "" -"Exception raised when non-blocking :meth:`~Queue.put` (or :meth:`~Queue." -"put_nowait`) is called on a :class:`Queue` object which is full." +"Exception raised when non-blocking :meth:`~Queue.get` " +"(or :meth:`~Queue.get_nowait`) is called on a :class:`Queue` object which is " +"empty." +msgstr "" + +msgid "" +"Exception raised when non-blocking :meth:`~Queue.put` " +"(or :meth:`~Queue.put_nowait`) is called on a :class:`Queue` object which is " +"full." msgstr "" msgid "" @@ -137,8 +143,8 @@ msgid "Queue Objects" msgstr "" msgid "" -"Queue objects (:class:`Queue`, :class:`LifoQueue`, or :class:" -"`PriorityQueue`) provide the public methods described below." +"Queue objects (:class:`Queue`, :class:`LifoQueue`, " +"or :class:`PriorityQueue`) provide the public methods described below." msgstr "" msgid "" @@ -191,8 +197,8 @@ msgid "" "Prior to 3.0 on POSIX systems, and for all versions on Windows, if *block* " "is true and *timeout* is ``None``, this operation goes into an " "uninterruptible wait on an underlying lock. This means that no exceptions " -"can occur, and in particular a SIGINT will not trigger a :exc:" -"`KeyboardInterrupt`." +"can occur, and in particular a SIGINT will not trigger " +"a :exc:`KeyboardInterrupt`." msgstr "" msgid "" @@ -210,8 +216,9 @@ msgstr "" msgid "" "Indicate that a formerly enqueued task is complete. Used by queue consumer " -"threads. For each :meth:`get` used to fetch a task, a subsequent call to :" -"meth:`task_done` tells the queue that the processing on the task is complete." +"threads. For each :meth:`get` used to fetch a task, a subsequent call " +"to :meth:`task_done` tells the queue that the processing on the task is " +"complete." msgstr "" msgid "" @@ -230,10 +237,10 @@ msgstr "" msgid "" "The count of unfinished tasks goes up whenever an item is added to the " -"queue. The count goes down whenever a consumer thread calls :meth:" -"`task_done` to indicate that the item was retrieved and all work on it is " -"complete. When the count of unfinished tasks drops to zero, :meth:`join` " -"unblocks." +"queue. The count goes down whenever a consumer thread " +"calls :meth:`task_done` to indicate that the item was retrieved and all work " +"on it is complete. When the count of unfinished tasks drops to " +"zero, :meth:`join` unblocks." msgstr "" msgid "Waiting for task completion" @@ -279,9 +286,9 @@ msgid "Put a :class:`Queue` instance into a shutdown mode." msgstr "" msgid "" -"The queue can no longer grow. Future calls to :meth:`~Queue.put` raise :exc:" -"`ShutDown`. Currently blocked callers of :meth:`~Queue.put` will be " -"unblocked and will raise :exc:`ShutDown` in the formerly blocked thread." +"The queue can no longer grow. Future calls to :meth:`~Queue.put` " +"raise :exc:`ShutDown`. Currently blocked callers of :meth:`~Queue.put` will " +"be unblocked and will raise :exc:`ShutDown` in the formerly blocked thread." msgstr "" msgid "" @@ -295,16 +302,17 @@ msgid "" msgstr "" msgid "" -"Once the queue is empty, future calls to :meth:`~Queue.get` will raise :exc:" -"`ShutDown`." +"Once the queue is empty, future calls to :meth:`~Queue.get` will " +"raise :exc:`ShutDown`." msgstr "" msgid "" "If *immediate* is true, the queue is terminated immediately. The queue is " "drained to be completely empty and the count of unfinished tasks is reduced " -"by the number of tasks drained. If unfinished tasks is zero, callers of :" -"meth:`~Queue.join` are unblocked. Also, blocked callers of :meth:`~Queue." -"get` are unblocked and will raise :exc:`ShutDown` because the queue is empty." +"by the number of tasks drained. If unfinished tasks is zero, callers " +"of :meth:`~Queue.join` are unblocked. Also, blocked callers " +"of :meth:`~Queue.get` are unblocked and will raise :exc:`ShutDown` because " +"the queue is empty." msgstr "" msgid "" @@ -347,8 +355,8 @@ msgid "" msgstr "" msgid "" -"Equivalent to ``put(item, block=False)``, provided for compatibility with :" -"meth:`Queue.put_nowait`." +"Equivalent to ``put(item, block=False)``, provided for compatibility " +"with :meth:`Queue.put_nowait`." msgstr "" msgid "Class :class:`multiprocessing.Queue`" @@ -361,7 +369,7 @@ msgstr "" msgid "" ":class:`collections.deque` is an alternative implementation of unbounded " -"queues with fast atomic :meth:`~collections.deque.append` and :meth:" -"`~collections.deque.popleft` operations that do not require locking and also " -"support indexing." +"queues with fast atomic :meth:`~collections.deque.append` " +"and :meth:`~collections.deque.popleft` operations that do not require " +"locking and also support indexing." msgstr "" diff --git a/library/quopri.po b/library/quopri.po index 413584bb34..f03f2115d1 100644 --- a/library/quopri.po +++ b/library/quopri.po @@ -50,13 +50,13 @@ msgstr "" msgid "" "Encode the contents of the *input* file and write the resulting quoted-" -"printable data to the *output* file. *input* and *output* must be :term:" -"`binary file objects `. *quotetabs*, a non-optional flag which " -"controls whether to encode embedded spaces and tabs; when true it encodes " -"such embedded whitespace, and when false it leaves them unencoded. Note that " -"spaces and tabs appearing at the end of lines are always encoded, as per :" -"rfc:`1521`. *header* is a flag which controls if spaces are encoded as " -"underscores as per :rfc:`1522`." +"printable data to the *output* file. *input* and *output* must " +"be :term:`binary file objects `. *quotetabs*, a non-optional " +"flag which controls whether to encode embedded spaces and tabs; when true it " +"encodes such embedded whitespace, and when false it leaves them unencoded. " +"Note that spaces and tabs appearing at the end of lines are always encoded, " +"as per :rfc:`1521`. *header* is a flag which controls if spaces are encoded " +"as underscores as per :rfc:`1522`." msgstr "" msgid "" diff --git a/library/random.po b/library/random.po index a132055b04..934ade8b29 100644 --- a/library/random.po +++ b/library/random.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -98,8 +98,8 @@ msgid "" "The global random number generator and instances of :class:`Random` are " "thread-safe. However, in the free-threaded build, concurrent calls to the " "global generator or to the same instance of :class:`Random` may encounter " -"contention and poor performance. Consider using separate instances of :class:" -"`Random` per thread instead." +"contention and poor performance. Consider using separate instances " +"of :class:`Random` per thread instead." msgstr "" msgid "Bookkeeping functions" @@ -119,9 +119,9 @@ msgid "If *a* is an int, its absolute value is used directly." msgstr "" msgid "" -"With version 2 (the default), a :class:`str`, :class:`bytes`, or :class:" -"`bytearray` object gets converted to an :class:`int` and all of its bits are " -"used." +"With version 2 (the default), a :class:`str`, :class:`bytes`, " +"or :class:`bytearray` object gets converted to an :class:`int` and all of " +"its bits are used." msgstr "" msgid "" @@ -135,8 +135,9 @@ msgid "" msgstr "" msgid "" -"The *seed* must be one of the following types: ``None``, :class:`int`, :" -"class:`float`, :class:`str`, :class:`bytes`, or :class:`bytearray`." +"The *seed* must be one of the following types: " +"``None``, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, " +"or :class:`bytearray`." msgstr "" msgid "" @@ -157,8 +158,8 @@ msgid "Generate *n* random bytes." msgstr "" msgid "" -"This method should not be used for generating security tokens. Use :func:" -"`secrets.token_bytes` instead." +"This method should not be used for generating security tokens. " +"Use :func:`secrets.token_bytes` instead." msgstr "" msgid "Functions for integers" @@ -189,8 +190,8 @@ msgstr "" msgid "" "Automatic conversion of non-integer types is no longer supported. Calls such " -"as ``randrange(10.0)`` and ``randrange(Fraction(10, 1))`` now raise a :exc:" -"`TypeError`." +"as ``randrange(10.0)`` and ``randrange(Fraction(10, 1))`` now raise " +"a :exc:`TypeError`." msgstr "" msgid "" @@ -201,8 +202,9 @@ msgstr "" msgid "" "Returns a non-negative Python integer with *k* random bits. This method is " "supplied with the Mersenne Twister generator and some other generators may " -"also provide it as an optional part of the API. When available, :meth:" -"`getrandbits` enables :meth:`randrange` to handle arbitrarily large ranges." +"also provide it as an optional part of the API. When " +"available, :meth:`getrandbits` enables :meth:`randrange` to handle " +"arbitrarily large ranges." msgstr "" msgid "This method now accepts zero for *k*." @@ -240,19 +242,19 @@ msgstr "" msgid "" "The *weights* or *cum_weights* can use any numeric type that interoperates " -"with the :class:`float` values returned by :func:`random` (that includes " -"integers, floats, and fractions but excludes decimals). Weights are assumed " -"to be non-negative and finite. A :exc:`ValueError` is raised if all weights " -"are zero." +"with the :class:`float` values returned by :func:`~random.random` (that " +"includes integers, floats, and fractions but excludes decimals). Weights " +"are assumed to be non-negative and finite. A :exc:`ValueError` is raised if " +"all weights are zero." msgstr "" msgid "" "For a given seed, the :func:`choices` function with equal weighting " -"typically produces a different sequence than repeated calls to :func:" -"`choice`. The algorithm used by :func:`choices` uses floating-point " -"arithmetic for internal consistency and speed. The algorithm used by :func:" -"`choice` defaults to integer arithmetic with repeated selections to avoid " -"small biases from round-off error." +"typically produces a different sequence than repeated calls " +"to :func:`choice`. The algorithm used by :func:`choices` uses floating-" +"point arithmetic for internal consistency and speed. The algorithm used " +"by :func:`choice` defaults to integer arithmetic with repeated selections to " +"avoid small biases from round-off error." msgstr "" msgid "Raises a :exc:`ValueError` if all weights are zero." @@ -329,9 +331,9 @@ msgid "The following function generates a discrete distribution." msgstr "" msgid "" -"`Binomial distribution `_. Return the number of successes for *n* independent trials with the " -"probability of success in each trial being *p*:" +"`Binomial distribution `_. Return the number of successes for *n* " +"independent trials with the probability of success in each trial being *p*:" msgstr "" msgid "Mathematically equivalent to::" @@ -462,8 +464,8 @@ msgstr "" msgid "" "Formerly the *seed* could be any hashable object. Now it is limited to: " -"``None``, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, or :" -"class:`bytearray`." +"``None``, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, " +"or :class:`bytearray`." msgstr "" msgid "" @@ -496,13 +498,13 @@ msgid "" msgstr "" msgid "" -"Override this method in subclasses to customise the :meth:`~random." -"getrandbits` behaviour of :class:`!Random` instances." +"Override this method in subclasses to customise " +"the :meth:`~random.getrandbits` behaviour of :class:`!Random` instances." msgstr "" msgid "" -"Override this method in subclasses to customise the :meth:`~random." -"randbytes` behaviour of :class:`!Random` instances." +"Override this method in subclasses to customise " +"the :meth:`~random.randbytes` behaviour of :class:`!Random` instances." msgstr "" msgid "" @@ -510,8 +512,8 @@ msgid "" "numbers from sources provided by the operating system. Not available on all " "systems. Does not rely on software state, and sequences are not " "reproducible. Accordingly, the :meth:`seed` method has no effect and is " -"ignored. The :meth:`getstate` and :meth:`setstate` methods raise :exc:" -"`NotImplementedError` if called." +"ignored. The :meth:`getstate` and :meth:`setstate` methods " +"raise :exc:`NotImplementedError` if called." msgstr "" msgid "Notes on Reproducibility" @@ -695,11 +697,11 @@ msgid "" msgstr "" msgid "" -"`Economics Simulation `_ a simulation of a marketplace by `Peter Norvig `_ that shows effective use of many of the tools and distributions " -"provided by this module (gauss, uniform, sample, betavariate, choice, " -"triangular, and randrange)." +"`Economics Simulation `_ a simulation of a marketplace by `Peter Norvig `_ that shows effective use of many of the tools and " +"distributions provided by this module (gauss, uniform, sample, betavariate, " +"choice, triangular, and randrange)." msgstr "" msgid "" @@ -741,8 +743,8 @@ msgid "" "def random_combination_with_replacement(iterable, r):\n" " \"Choose r elements with replacement. Order the result to match the " "iterable.\"\n" -" # Result will be in set(itertools." -"combinations_with_replacement(iterable, r)).\n" +" # Result will be in " +"set(itertools.combinations_with_replacement(iterable, r)).\n" " pool = tuple(iterable)\n" " n = len(pool)\n" " indices = sorted(random.choices(range(n), k=r))\n" @@ -825,8 +827,8 @@ msgstr "" msgid "" "`Generating Pseudo-random Floating-Point Values `_ a paper by Allen B. Downey describing " -"ways to generate more fine-grained floats than normally generated by :func:`." -"random`." +"ways to generate more fine-grained floats than normally generated " +"by :func:`.random`." msgstr "" msgid "Command-line usage" @@ -853,8 +855,8 @@ msgid "" msgstr "" msgid "" -"Print a random floating-point number between 0 and N inclusive, using :meth:" -"`uniform`." +"Print a random floating-point number between 0 and N inclusive, " +"using :meth:`uniform`." msgstr "" msgid "If no options are given, the output depends on the input:" diff --git a/library/re.po b/library/re.po index fba507150f..3f4ad28c8e 100644 --- a/library/re.po +++ b/library/re.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,12 +35,12 @@ msgid "" msgstr "" msgid "" -"Both patterns and strings to be searched can be Unicode strings (:class:" -"`str`) as well as 8-bit strings (:class:`bytes`). However, Unicode strings " -"and 8-bit strings cannot be mixed: that is, you cannot match a Unicode " -"string with a bytes pattern or vice-versa; similarly, when asking for a " -"substitution, the replacement string must be of the same type as both the " -"pattern and the search string." +"Both patterns and strings to be searched can be Unicode strings " +"(:class:`str`) as well as 8-bit strings (:class:`bytes`). However, Unicode " +"strings and 8-bit strings cannot be mixed: that is, you cannot match a " +"Unicode string with a bytes pattern or vice-versa; similarly, when asking " +"for a substitution, the replacement string must be of the same type as both " +"the pattern and the search string." msgstr "" msgid "" @@ -132,6 +132,9 @@ msgid "" "``'a'`` characters." msgstr "" +msgid "Special characters" +msgstr "" + msgid "The special characters are:" msgstr "" @@ -160,10 +163,10 @@ msgid "" "string, and in :const:`MULTILINE` mode also matches before a newline. " "``foo`` matches both 'foo' and 'foobar', while the regular expression " "``foo$`` matches only 'foo'. More interestingly, searching for ``foo.$`` in " -"``'foo1\\nfoo2\\n'`` matches 'foo2' normally, but 'foo1' in :const:" -"`MULTILINE` mode; searching for a single ``$`` in ``'foo\\n'`` will find two " -"(empty) matches: one just before the newline, and one at the end of the " -"string." +"``'foo1\\nfoo2\\n'`` matches 'foo2' normally, but 'foo1' " +"in :const:`MULTILINE` mode; searching for a single ``$`` in ``'foo\\n'`` " +"will find two (empty) matches: one just before the newline, and one at the " +"end of the string." msgstr "" msgid "``*``" @@ -330,12 +333,12 @@ msgid "" msgstr "" msgid "" -"Characters that are not within a range can be matched by :dfn:" -"`complementing` the set. If the first character of the set is ``'^'``, all " -"the characters that are *not* in the set will be matched. For example, " -"``[^5]`` will match any character except ``'5'``, and ``[^^]`` will match " -"any character except ``'^'``. ``^`` has no special meaning if it's not the " -"first character in the set." +"Characters that are not within a range can be matched " +"by :dfn:`complementing` the set. If the first character of the set is " +"``'^'``, all the characters that are *not* in the set will be matched. For " +"example, ``[^5]`` will match any character except ``'5'``, and ``[^^]`` will " +"match any character except ``'^'``. ``^`` has no special meaning if it's " +"not the first character in the set." msgstr "" msgid "" @@ -482,13 +485,13 @@ msgid "" "Attempts to match ``...`` as if it was a separate regular expression, and if " "successful, continues to match the rest of the pattern following it. If the " "subsequent pattern fails to match, the stack can only be unwound to a point " -"*before* the ``(?>...)`` because once exited, the expression, known as an :" -"dfn:`atomic group`, has thrown away all stack points within itself. Thus, " -"``(?>.*).`` would never match anything because first the ``.*`` would match " -"all characters possible, then, having nothing left to match, the final ``.`` " -"would fail to match. Since there are no stack points saved in the Atomic " -"Group, and there is no stack point before it, the entire expression would " -"thus fail to match." +"*before* the ``(?>...)`` because once exited, the expression, known as " +"an :dfn:`atomic group`, has thrown away all stack points within itself. " +"Thus, ``(?>.*).`` would never match anything because first the ``.*`` would " +"match all characters possible, then, having nothing left to match, the final " +"``.`` would fail to match. Since there are no stack points saved in the " +"Atomic Group, and there is no stack point before it, the entire expression " +"would thus fail to match." msgstr "" msgid "``(?P...)``" @@ -591,8 +594,8 @@ msgid "" "length, meaning that ``abc`` or ``a|b`` are allowed, but ``a*`` and ``a{3,4}" "`` are not. Note that patterns which start with positive lookbehind " "assertions will not match at the beginning of the string being searched; you " -"will most likely want to use the :func:`search` function rather than the :" -"func:`match` function:" +"will most likely want to use the :func:`search` function rather than " +"the :func:`match` function:" msgstr "" msgid "This example looks for a word following a hyphen:" @@ -619,9 +622,10 @@ msgid "" "Will try to match with ``yes-pattern`` if the group with given *id* or " "*name* exists, and with ``no-pattern`` if it doesn't. ``no-pattern`` is " "optional and can be omitted. For example, ``(<)?(\\w+@\\w+(?:\\.\\w+)+)(?" -"(1)>|$)`` is a poor email matching pattern, which will match with " -"``''`` as well as ``'user@host.com'``, but not with " -"``''``." +"(1)>|$)`` is a poor email matching pattern, which matches " +"``''`` as well as ``'user@host.com'``, but does not match " +"``''`` in their entirety " +"(:func:`re.search` finds only ``'user@host.com'`` in the former)." msgstr "" msgid "" @@ -629,6 +633,9 @@ msgid "" "*name* can only contain bytes in the ASCII range (``b'\\x00'``-``b'\\x7f'``)." msgstr "" +msgid "Special sequences" +msgstr "" + msgid "" "The special sequences consist of ``'\\'`` and a character from the list " "below. If the ordinary character is not an ASCII digit or an ASCII letter, " @@ -670,9 +677,9 @@ msgstr "" msgid "" "The default word characters in Unicode (str) patterns are Unicode " -"alphanumerics and the underscore, but this can be changed by using the :py:" -"const:`~re.ASCII` flag. Word boundaries are determined by the current locale " -"if the :py:const:`~re.LOCALE` flag is used." +"alphanumerics and the underscore, but this can be changed by using " +"the :py:const:`~re.ASCII` flag. Word boundaries are determined by the " +"current locale if the :py:const:`~re.LOCALE` flag is used." msgstr "" msgid "" @@ -734,10 +741,10 @@ msgid "``\\s``" msgstr "``\\s``" msgid "" -"Matches Unicode whitespace characters (as defined by :py:meth:`str." -"isspace`). This includes ``[ \\t\\n\\r\\f\\v]``, and also many other " -"characters, for example the non-breaking spaces mandated by typography rules " -"in many languages." +"Matches Unicode whitespace characters (as defined " +"by :py:meth:`str.isspace`). This includes ``[ \\t\\n\\r\\f\\v]``, and also " +"many other characters, for example the non-breaking spaces mandated by " +"typography rules in many languages." msgstr "" msgid "" @@ -785,8 +792,8 @@ msgstr "``\\W``" msgid "" "Matches any character which is not a word character. This is the opposite of " -"``\\w``. By default, matches non-underscore (``_``) characters for which :py:" -"meth:`str.isalnum` returns ``False``." +"``\\w``. By default, matches non-underscore (``_``) characters for " +"which :py:meth:`str.isalnum` returns ``False``." msgstr "" msgid "Matches ``[^a-zA-Z0-9_]`` if the :py:const:`~re.ASCII` flag is used." @@ -809,6 +816,9 @@ msgstr "``\\Z``" msgid "The same as ``\\z``. For compatibility with old Python versions." msgstr "" +msgid "Standard escapes" +msgstr "" + msgid "" "Most of the :ref:`escape sequences ` supported by Python " "string literals are also accepted by the regular expression parser::" @@ -889,8 +899,9 @@ msgstr "" msgid "" "The :py:const:`~re.U` flag still exists for backward compatibility, but is " "redundant in Python 3 since matches are Unicode by default for ``str`` " -"patterns, and Unicode matching isn't allowed for bytes patterns. :py:const:" -"`~re.UNICODE` and the inline flag ``(?u)`` are similarly redundant." +"patterns, and Unicode matching isn't allowed for bytes " +"patterns. :py:const:`~re.UNICODE` and the inline flag ``(?u)`` are similarly " +"redundant." msgstr "" msgid "Display debug information about compiled expression." @@ -914,8 +925,8 @@ msgid "" "Note that when the Unicode patterns ``[a-z]`` or ``[A-Z]`` are used in " "combination with the :const:`IGNORECASE` flag, they will match the 52 ASCII " "letters and 4 additional non-ASCII letters: 'İ' (U+0130, Latin capital " -"letter I with dot above), 'ı' (U+0131, Latin small letter dotless i), " -"'ſ' (U+017F, Latin small letter long s) and 'K' (U+212A, Kelvin sign). If " +"letter I with dot above), 'ı' (U+0131, Latin small letter dotless i), 'ſ' " +"(U+017F, Latin small letter long s) and 'K' (U+212A, Kelvin sign). If " "the :py:const:`~re.ASCII` flag is used, only letters 'a' to 'z' and 'A' to " "'Z' are matched." msgstr "" @@ -1023,8 +1034,9 @@ msgstr "Zadania" msgid "" "Compile a regular expression pattern into a :ref:`regular expression object " -"`, which can be used for matching using its :func:`~Pattern." -"match`, :func:`~Pattern.search` and other methods, described below." +"`, which can be used for matching using " +"its :func:`~Pattern.match`, :func:`~Pattern.search` and other methods, " +"described below." msgstr "" msgid "" @@ -1054,18 +1066,18 @@ msgid "" msgstr "" msgid "" -"The compiled versions of the most recent patterns passed to :func:`re." -"compile` and the module-level matching functions are cached, so programs " -"that use only a few regular expressions at a time needn't worry about " -"compiling regular expressions." +"The compiled versions of the most recent patterns passed " +"to :func:`re.compile` and the module-level matching functions are cached, so " +"programs that use only a few regular expressions at a time needn't worry " +"about compiling regular expressions." msgstr "" msgid "" "Scan through *string* looking for the first location where the regular " -"expression *pattern* produces a match, and return a corresponding :class:" -"`~re.Match`. Return ``None`` if no position in the string matches the " -"pattern; note that this is different from finding a zero-length match at " -"some point in the string." +"expression *pattern* produces a match, and return a " +"corresponding :class:`~re.Match`. Return ``None`` if no position in the " +"string matches the pattern; note that this is different from finding a zero-" +"length match at some point in the string." msgstr "" msgid "" @@ -1218,8 +1230,8 @@ msgid "" "...\n" ">>> re.sub('-{1,2}', dashrepl, 'pro----gram-files')\n" "'pro--gram files'\n" -">>> re.sub(r'\\sAND\\s', ' & ', 'Baked Beans And Spam', flags=re." -"IGNORECASE)\n" +">>> re.sub(r'\\sAND\\s', ' & ', 'Baked Beans And Spam', " +"flags=re.IGNORECASE)\n" "'Baked Beans & Spam'" msgstr "" @@ -1366,6 +1378,11 @@ msgstr "" msgid "Compiled regular expression object returned by :func:`re.compile`." msgstr "" +msgid "" +"Patterns are :ref:`generic ` over the type of string they handle " +"(:class:`str` or :class:`bytes`)." +msgstr "" + msgid "" ":py:class:`re.Pattern` supports ``[]`` to indicate a Unicode (str) or bytes " "pattern. See :ref:`types-genericalias`." @@ -1411,8 +1428,8 @@ msgid "" msgstr "" msgid "" -"The optional *pos* and *endpos* parameters have the same meaning as for the :" -"meth:`~Pattern.search` method. ::" +"The optional *pos* and *endpos* parameters have the same meaning as for " +"the :meth:`~Pattern.search` method. ::" msgstr "" msgid "" @@ -1425,8 +1442,8 @@ msgid "" msgstr "" msgid "" -"If you want to locate a match anywhere in *string*, use :meth:`~Pattern." -"search` instead (see also :ref:`search-vs-match`)." +"If you want to locate a match anywhere in *string*, " +"use :meth:`~Pattern.search` instead (see also :ref:`search-vs-match`)." msgstr "" msgid "" @@ -1467,9 +1484,10 @@ msgid "Identical to the :func:`subn` function, using the compiled pattern." msgstr "" msgid "" -"The regex matching flags. This is a combination of the flags given to :func:" -"`.compile`, any ``(?...)`` inline flags in the pattern, and implicit flags " -"such as :py:const:`~re.UNICODE` if the pattern is a Unicode string." +"The regex matching flags. This is a combination of the flags given " +"to :func:`.compile`, any ``(?...)`` inline flags in the pattern, and " +"implicit flags such as :py:const:`~re.UNICODE` if the pattern is a Unicode " +"string." msgstr "" msgid "The number of capturing groups in the pattern." @@ -1493,9 +1511,10 @@ msgid "Match Objects" msgstr "" msgid "" -"Match objects always have a boolean value of ``True``. Since :meth:`~Pattern." -"match` and :meth:`~Pattern.search` return ``None`` when there is no match, " -"you can test whether there was a match with a simple ``if`` statement::" +"Match objects always have a boolean value of ``True``. " +"Since :meth:`~Pattern.match` and :meth:`~Pattern.search` return ``None`` " +"when there is no match, you can test whether there was a match with a simple " +"``if`` statement::" msgstr "" msgid "" @@ -1507,6 +1526,11 @@ msgstr "" msgid "Match object returned by successful ``match``\\ es and ``search``\\ es." msgstr "" +msgid "" +"Matches are :ref:`generic ` over the type of string which was " +"matched (:class:`str` or :class:`bytes`)." +msgstr "" + msgid "" ":py:class:`re.Match` supports ``[]`` to indicate a Unicode (str) or bytes " "match. See :ref:`types-genericalias`." @@ -1550,8 +1574,8 @@ msgstr "" msgid "" "If the regular expression uses the ``(?P...)`` syntax, the *groupN* " "arguments may also be strings identifying groups by their group name. If a " -"string argument is not used as a group name in the pattern, an :exc:" -"`IndexError` exception is raised." +"string argument is not used as a group name in the pattern, " +"an :exc:`IndexError` exception is raised." msgstr "" msgid "A moderately complicated example::" @@ -1690,9 +1714,9 @@ msgstr "m.string[m.start(g):m.end(g)]" msgid "" "Note that ``m.start(group)`` will equal ``m.end(group)`` if *group* matched " -"a null string. For example, after ``m = re.search('b(c?)', 'cba')``, ``m." -"start(0)`` is 1, ``m.end(0)`` is 2, ``m.start(1)`` and ``m.end(1)`` are both " -"2, and ``m.start(2)`` raises an :exc:`IndexError` exception." +"a null string. For example, after ``m = re.search('b(c?)', 'cba')``, " +"``m.start(0)`` is 1, ``m.end(0)`` is 2, ``m.start(1)`` and ``m.end(1)`` are " +"both 2, and ``m.start(2)`` raises an :exc:`IndexError` exception." msgstr "" msgid "An example that will remove *remove_this* from email addresses::" @@ -1712,15 +1736,16 @@ msgid "" msgstr "" msgid "" -"The value of *pos* which was passed to the :meth:`~Pattern.search` or :meth:" -"`~Pattern.match` method of a :ref:`regex object `. This is the " -"index into the string at which the RE engine started looking for a match." +"The value of *pos* which was passed to the :meth:`~Pattern.search` " +"or :meth:`~Pattern.match` method of a :ref:`regex object `. " +"This is the index into the string at which the RE engine started looking for " +"a match." msgstr "" msgid "" -"The value of *endpos* which was passed to the :meth:`~Pattern.search` or :" -"meth:`~Pattern.match` method of a :ref:`regex object `. This is " -"the index into the string beyond which the RE engine will not go." +"The value of *endpos* which was passed to the :meth:`~Pattern.search` " +"or :meth:`~Pattern.match` method of a :ref:`regex object `. " +"This is the index into the string beyond which the RE engine will not go." msgstr "" msgid "" @@ -1737,8 +1762,9 @@ msgid "" msgstr "" msgid "" -"The :ref:`regular expression object ` whose :meth:`~Pattern." -"match` or :meth:`~Pattern.search` method produced this match instance." +"The :ref:`regular expression object ` " +"whose :meth:`~Pattern.match` or :meth:`~Pattern.search` method produced this " +"match instance." msgstr "" msgid "The string passed to :meth:`~Pattern.match` or :meth:`~Pattern.search`." @@ -1803,8 +1829,8 @@ msgid "" msgstr "" msgid "" -"To find out what card the pair consists of, one could use the :meth:`~Match." -"group` method of the match object in the following manner::" +"To find out what card the pair consists of, one could use " +"the :meth:`~Match.group` method of the match object in the following manner::" msgstr "" msgid "" @@ -1829,9 +1855,9 @@ msgstr "" msgid "" "Python does not currently have an equivalent to :c:func:`!scanf`. Regular " -"expressions are generally more powerful, though also more verbose, than :c:" -"func:`!scanf` format strings. The table below offers some more-or-less " -"equivalent mappings between :c:func:`!scanf` format tokens and regular " +"expressions are generally more powerful, though also more verbose, " +"than :c:func:`!scanf` format strings. The table below offers some more-or-" +"less equivalent mappings between :c:func:`!scanf` format tokens and regular " "expressions." msgstr "" @@ -2283,6 +2309,9 @@ msgstr "" msgid "(?:" msgstr "(?:" +msgid "(?>" +msgstr "" + msgid "(?P<" msgstr "" diff --git a/library/readline.po b/library/readline.po index 1969dc7f49..875714dcab 100644 --- a/library/readline.po +++ b/library/readline.po @@ -4,17 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,8 +32,8 @@ msgid "" "This module can be used directly, or via the :mod:`rlcompleter` module, " "which supports completion of Python identifiers at the interactive prompt. " "Settings made using this module affect the behaviour of both the " -"interpreter's interactive prompt and the prompts offered by the built-in :" -"func:`input` function." +"interpreter's interactive prompt and the prompts offered by the built-" +"in :func:`input` function." msgstr "" msgid "" @@ -62,8 +61,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "" "The underlying Readline library API may be implemented by the ``editline`` " @@ -73,8 +72,8 @@ msgstr "" msgid "" "The configuration file for ``editline`` is different from that of GNU " -"readline. If you programmatically load configuration strings you can use :" -"data:`backend` to determine which library is being used." +"readline. If you programmatically load configuration strings you can " +"use :data:`backend` to determine which library is being used." msgstr "" msgid "" @@ -107,8 +106,8 @@ msgid "The following functions relate to the init file and user configuration:" msgstr "" msgid "" -"Execute the init line provided in the *string* argument. This calls :c:func:" -"`!rl_parse_and_bind` in the underlying library." +"Execute the init line provided in the *string* argument. This " +"calls :c:func:`!rl_parse_and_bind` in the underlying library." msgstr "" msgid "" @@ -134,8 +133,9 @@ msgid "" msgstr "" msgid "" -"Insert text into the line buffer at the cursor position. This calls :c:func:" -"`!rl_insert_text` in the underlying library, but ignores the return value." +"Insert text into the line buffer at the cursor position. This " +"calls :c:func:`!rl_insert_text` in the underlying library, but ignores the " +"return value." msgstr "" msgid "" @@ -166,17 +166,17 @@ msgstr "" msgid "" "Append the last *nelements* items of history to a file. The default " -"filename is :file:`~/.history`. The file must already exist. This calls :c:" -"func:`!append_history` in the underlying library. This function only exists " -"if Python was compiled for a version of the library that supports it. It " -"raises an :ref:`auditing event ` ``open`` with the file name if " -"given and :code:`\"~/.history\"` otherwise." +"filename is :file:`~/.history`. The file must already exist. This " +"calls :c:func:`!append_history` in the underlying library. This function " +"only exists if Python was compiled for a version of the library that " +"supports it. It raises an :ref:`auditing event ` ``open`` with the " +"file name if given and :code:`\"~/.history\"` otherwise." msgstr "" msgid "" -"Set or return the desired number of lines to save in the history file. The :" -"func:`write_history_file` function uses this value to truncate the history " -"file, by calling :c:func:`!history_truncate_file` in the underlying " +"Set or return the desired number of lines to save in the history file. " +"The :func:`write_history_file` function uses this value to truncate the " +"history file, by calling :c:func:`!history_truncate_file` in the underlying " "library. Negative values imply unlimited history file size." msgstr "" @@ -344,8 +344,8 @@ msgid "" msgstr "" msgid "" -"This code is actually automatically run when Python is run in :ref:" -"`interactive mode ` (see :ref:`rlcompleter-config`)." +"This code is actually automatically run when Python is run " +"in :ref:`interactive mode ` (see :ref:`rlcompleter-config`)." msgstr "" msgid "" @@ -406,6 +406,6 @@ msgstr "" msgid "" "The new :term:`REPL` introduced in version 3.13 doesn't support readline. " -"However, readline can still be used by setting the :envvar:" -"`PYTHON_BASIC_REPL` environment variable." +"However, readline can still be used by setting " +"the :envvar:`PYTHON_BASIC_REPL` environment variable." msgstr "" diff --git a/library/reprlib.po b/library/reprlib.po index d266801e57..51a473f253 100644 --- a/library/reprlib.po +++ b/library/reprlib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -71,9 +71,10 @@ msgid "Allow attributes to be set via keyword arguments." msgstr "" msgid "" -"This is an instance of :class:`Repr` which is used to provide the :func:`." -"repr` function described below. Changing the attributes of this object will " -"affect the size limits used by :func:`.repr` and the Python debugger." +"This is an instance of :class:`Repr` which is used to provide " +"the :func:`.repr` function described below. Changing the attributes of this " +"object will affect the size limits used by :func:`.repr` and the Python " +"debugger." msgstr "" msgid "" @@ -226,18 +227,18 @@ msgstr "" msgid "" "Formatting methods for specific types are implemented as methods with a name " -"based on the type name. In the method name, **TYPE** is replaced by ``'_'." -"join(type(obj).__name__.split())``. Dispatch to these methods is handled by :" -"meth:`repr1`. Type-specific methods which need to recursively format a value " -"should call ``self.repr1(subobj, level - 1)``." +"based on the type name. In the method name, **TYPE** is replaced by " +"``'_'.join(type(obj).__name__.split())``. Dispatch to these methods is " +"handled by :meth:`repr1`. Type-specific methods which need to recursively " +"format a value should call ``self.repr1(subobj, level - 1)``." msgstr "" msgid "Subclassing Repr Objects" msgstr "" msgid "" -"The use of dynamic dispatching by :meth:`Repr.repr1` allows subclasses of :" -"class:`Repr` to add support for additional built-in object types or to " +"The use of dynamic dispatching by :meth:`Repr.repr1` allows subclasses " +"of :class:`Repr` to add support for additional built-in object types or to " "modify the handling of types already supported. This example shows how " "special support for file objects could be added:" msgstr "" diff --git a/library/resource.po b/library/resource.po index 38e6bc4ea9..ca0a319b58 100644 --- a/library/resource.po +++ b/library/resource.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -89,10 +89,10 @@ msgid "" "Raises :exc:`ValueError` if an invalid resource is specified, if the new " "soft limit exceeds the hard limit, or if a process tries to raise its hard " "limit. Specifying a limit of :const:`~resource.RLIM_INFINITY` when the hard " -"or system limit for that resource is not unlimited will result in a :exc:" -"`ValueError`. A process with the effective UID of super-user can request " -"any valid limit value, including unlimited, but :exc:`ValueError` will still " -"be raised if the requested limit exceeds the system imposed limit." +"or system limit for that resource is not unlimited will result in " +"a :exc:`ValueError`. A process with the effective UID of super-user can " +"request any valid limit value, including unlimited, but :exc:`ValueError` " +"will still be raised if the requested limit exceeds the system imposed limit." msgstr "" msgid "" @@ -123,9 +123,9 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`ProcessLookupError` when *pid* can't be found and :exc:" -"`PermissionError` when the user doesn't have ``CAP_SYS_RESOURCE`` for the " -"process." +"Raises :exc:`ProcessLookupError` when *pid* can't be found " +"and :exc:`PermissionError` when the user doesn't have ``CAP_SYS_RESOURCE`` " +"for the process." msgstr "" msgid "" @@ -224,9 +224,9 @@ msgstr "" msgid "" "The maximum size (in bytes) of the swap space that may be reserved or used " "by all of this user id's processes. This limit is enforced only if bit 1 of " -"the vm.overcommit sysctl is set. Please see `tuning(7) `__ for a complete description of " -"this sysctl." +"the vm.overcommit sysctl is set. Please see `tuning(7) `__ for a complete " +"description of this sysctl." msgstr "" msgid "The maximum number of pseudo-terminals created by this user id." @@ -244,8 +244,8 @@ msgstr "" msgid "" "This function returns an object that describes the resources consumed by " "either the current process or its children, as specified by the *who* " -"parameter. The *who* parameter should be specified using one of the :const:" -"`!RUSAGE_\\*` constants described below." +"parameter. The *who* parameter should be specified using one of " +"the :const:`!RUSAGE_\\*` constants described below." msgstr "" msgid "A simple example::" @@ -282,9 +282,9 @@ msgid "" "The fields :attr:`!ru_utime` and :attr:`!ru_stime` of the return value are " "floating-point values representing the amount of time spent executing in " "user mode and the amount of time spent executing in system mode, " -"respectively. The remaining values are integers. Consult the :manpage:" -"`getrusage(2)` man page for detailed information about these values. A brief " -"summary is presented here:" +"respectively. The remaining values are integers. Consult " +"the :manpage:`getrusage(2)` man page for detailed information about these " +"values. A brief summary is presented here:" msgstr "" msgid "Index" @@ -452,9 +452,9 @@ msgid "" msgstr "" msgid "" -"The following :const:`!RUSAGE_\\*` symbols are passed to the :func:" -"`getrusage` function to specify which processes information should be " -"provided for." +"The following :const:`!RUSAGE_\\*` symbols are passed to " +"the :func:`getrusage` function to specify which processes information should " +"be provided for." msgstr "" msgid "" diff --git a/library/rlcompleter.po b/library/rlcompleter.po index e330dacd85..9692445769 100644 --- a/library/rlcompleter.po +++ b/library/rlcompleter.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -50,19 +50,19 @@ msgid "" ">>> import readline\n" ">>> readline.parse_and_bind(\"tab: complete\")\n" ">>> readline. \n" -"readline.__doc__ readline.get_line_buffer( readline." -"read_init_file(\n" -"readline.__file__ readline.insert_text( readline." -"set_completer(\n" +"readline.__doc__ " +"readline.get_line_buffer( readline.read_init_file(\n" +"readline.__file__ " +"readline.insert_text( readline.set_completer(\n" "readline.__name__ readline.parse_and_bind(\n" ">>> readline." msgstr "" msgid "" -"The :mod:`!rlcompleter` module is designed for use with Python's :ref:" -"`interactive mode `. Unless Python is run with the :option:" -"`-S` option, the module is automatically imported and configured (see :ref:" -"`rlcompleter-config`)." +"The :mod:`!rlcompleter` module is designed for use with " +"Python's :ref:`interactive mode `. Unless Python is run " +"with the :option:`-S` option, the module is automatically imported and " +"configured (see :ref:`rlcompleter-config`)." msgstr "" msgid "" @@ -84,8 +84,9 @@ msgstr "" msgid "" "If called for *text* that doesn't include a period character (``'.'``), it " -"will complete from names currently defined in :mod:`__main__`, :mod:" -"`builtins` and keywords (as defined by the :mod:`keyword` module)." +"will complete from names currently defined " +"in :mod:`__main__`, :mod:`builtins` and keywords (as defined by " +"the :mod:`keyword` module)." msgstr "" msgid "" diff --git a/library/runpy.po b/library/runpy.po index 17e0c53913..6140410948 100644 --- a/library/runpy.po +++ b/library/runpy.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -70,8 +70,8 @@ msgid "" "The optional dictionary argument *init_globals* may be used to pre-populate " "the module's globals dictionary before the code is executed. *init_globals* " "will not be modified. If any of the special global variables below are " -"defined in *init_globals*, those definitions are overridden by :func:" -"`run_module`." +"defined in *init_globals*, those definitions are overridden " +"by :func:`run_module`." msgstr "" msgid "" @@ -83,28 +83,28 @@ msgid "" msgstr "" msgid "" -"``__name__`` is set to *run_name* if this optional argument is not :const:" -"`None`, to ``mod_name + '.__main__'`` if the named module is a package and " -"to the *mod_name* argument otherwise." +"``__name__`` is set to *run_name* if this optional argument is " +"not :const:`None`, to ``mod_name + '.__main__'`` if the named module is a " +"package and to the *mod_name* argument otherwise." msgstr "" msgid "" "``__spec__`` will be set appropriately for the *actually* imported module " -"(that is, ``__spec__.name`` will always be *mod_name* or ``mod_name + '." -"__main__'``, never *run_name*)." +"(that is, ``__spec__.name`` will always be *mod_name* or ``mod_name + " +"'.__main__'``, never *run_name*)." msgstr "" msgid "" -"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` are :ref:" -"`set as normal ` based on the module spec." +"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` " +"are :ref:`set as normal ` based on the module spec." msgstr "" msgid "" "If the argument *alter_sys* is supplied and evaluates to :const:`True`, then " -"``sys.argv[0]`` is updated with the value of ``__file__`` and ``sys." -"modules[__name__]`` is updated with a temporary module object for the module " -"being executed. Both ``sys.argv[0]`` and ``sys.modules[__name__]`` are " -"restored to their original values before the function returns." +"``sys.argv[0]`` is updated with the value of ``__file__`` and " +"``sys.modules[__name__]`` is updated with a temporary module object for the " +"module being executed. Both ``sys.argv[0]`` and ``sys.modules[__name__]`` " +"are restored to their original values before the function returns." msgstr "" msgid "" @@ -129,8 +129,8 @@ msgstr "" msgid "" "Updated to take advantage of the module spec feature added by :pep:`451`. " "This allows ``__cached__`` to be set correctly for modules run this way, as " -"well as ensuring the real module name is always accessible as ``__spec__." -"name``." +"well as ensuring the real module name is always accessible as " +"``__spec__.name``." msgstr "" msgid "" @@ -160,13 +160,13 @@ msgid "" "The optional dictionary argument *init_globals* may be used to pre-populate " "the module's globals dictionary before the code is executed. *init_globals* " "will not be modified. If any of the special global variables below are " -"defined in *init_globals*, those definitions are overridden by :func:" -"`run_path`." +"defined in *init_globals*, those definitions are overridden " +"by :func:`run_path`." msgstr "" msgid "" -"``__name__`` is set to *run_name* if this optional argument is not :const:" -"`None` and to ``''`` otherwise." +"``__name__`` is set to *run_name* if this optional argument is " +"not :const:`None` and to ``''`` otherwise." msgstr "" msgid "" @@ -180,14 +180,14 @@ msgid "" "If *file_path* is a reference to a valid :data:`sys.path` entry, then " "``__spec__`` will be set appropriately for the imported :mod:`__main__` " "module (that is, ``__spec__.name`` will always be ``__main__``). " -"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` will be :" -"ref:`set as normal ` based on the module spec." +"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` will " +"be :ref:`set as normal ` based on the module spec." msgstr "" msgid "" -"A number of alterations are also made to the :mod:`sys` module. Firstly, :" -"data:`sys.path` may be altered as described above. ``sys.argv[0]`` is " -"updated with the value of *file_path* and ``sys.modules[__name__]`` is " +"A number of alterations are also made to the :mod:`sys` module. " +"Firstly, :data:`sys.path` may be altered as described above. ``sys.argv[0]`` " +"is updated with the value of *file_path* and ``sys.modules[__name__]`` is " "updated with a temporary module object for the module being executed. All " "modifications to items in :mod:`sys` are reverted before the function " "returns." diff --git a/library/sched.po b/library/sched.po index f821c6485b..25094169ab 100644 --- a/library/sched.po +++ b/library/sched.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -136,9 +136,11 @@ msgid "" msgstr "" msgid "" -"If *blocking* is false executes the scheduled events due to expire soonest " -"(if any) and then return the deadline of the next scheduled call in the " -"scheduler (if any)." +"If *blocking* is false, immediately executes all events in the queue which " +"have a time value less than or equal to the current *timefunc* value (if " +"any) and returns the difference between the current *timefunc* value and the " +"time value of the next scheduled event in the scheduler's event queue. If " +"the queue is empty, returns ``None``." msgstr "" msgid "" diff --git a/library/secrets.po b/library/secrets.po index be085d7ea6..f06c145ce1 100644 --- a/library/secrets.po +++ b/library/secrets.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -150,9 +150,9 @@ msgstr "" msgid "" "Return ``True`` if strings or :term:`bytes-like objects ` " "*a* and *b* are equal, otherwise ``False``, using a \"constant-time " -"compare\" to reduce the risk of `timing attacks `_. See :func:`hmac.compare_digest` for additional " -"details." +"compare\" to reduce the risk of `timing attacks `__. " +"See :func:`hmac.compare_digest` for additional details." msgstr "" msgid "Recipes and best practices" diff --git a/library/security_warnings.po b/library/security_warnings.po index cc950100a7..de1d6039d0 100644 --- a/library/security_warnings.po +++ b/library/security_warnings.po @@ -30,8 +30,8 @@ msgid "The following modules have specific security considerations:" msgstr "" msgid "" -":mod:`base64`: :ref:`base64 security considerations ` in :" -"rfc:`4648`" +":mod:`base64`: :ref:`base64 security considerations ` " +"in :rfc:`4648`" msgstr "" msgid "" @@ -92,9 +92,9 @@ msgstr "" msgid "" "The :option:`-I` command line option can be used to run Python in isolated " -"mode. When it cannot be used, the :option:`-P` option or the :envvar:" -"`PYTHONSAFEPATH` environment variable can be used to not prepend a " -"potentially unsafe path to :data:`sys.path` such as the current directory, " +"mode. When it cannot be used, the :option:`-P` option or " +"the :envvar:`PYTHONSAFEPATH` environment variable can be used to not prepend " +"a potentially unsafe path to :data:`sys.path` such as the current directory, " "the script's directory or an empty string." msgstr "" diff --git a/library/select.po b/library/select.po index fa64952f25..27dce506ae 100644 --- a/library/select.po +++ b/library/select.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,11 +29,11 @@ msgstr "" msgid "" "This module provides access to the :c:func:`!select` and :c:func:`!poll` " "functions available in most operating systems, :c:func:`!devpoll` available " -"on Solaris and derivatives, :c:func:`!epoll` available on Linux 2.5+ and :c:" -"func:`!kqueue` available on most BSD. Note that on Windows, it only works " -"for sockets; on other operating systems, it also works for other file types " -"(in particular, on Unix, it works on pipes). It cannot be used on regular " -"files to determine whether a file has grown since it was last read." +"on Solaris and derivatives, :c:func:`!epoll` available on Linux 2.5+ " +"and :c:func:`!kqueue` available on most BSD. Note that on Windows, it only " +"works for sockets; on other operating systems, it also works for other file " +"types (in particular, on Unix, it works on pipes). It cannot be used on " +"regular files to determine whether a file has grown since it was last read." msgstr "" msgid "" @@ -61,16 +61,16 @@ msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`." msgstr "" msgid "" -"(Only supported on Solaris and derivatives.) Returns a ``/dev/poll`` " -"polling object; see section :ref:`devpoll-objects` below for the methods " -"supported by devpoll objects." +"Returns a ``/dev/poll`` polling object; see section :ref:`devpoll-objects` " +"below for the methods supported by devpoll objects." msgstr "" msgid "" ":c:func:`!devpoll` objects are linked to the number of file descriptors " -"allowed at the time of instantiation. If your program reduces this value, :c:" -"func:`!devpoll` will fail. If your program increases this value, :c:func:`!" -"devpoll` may return an incomplete list of active file descriptors." +"allowed at the time of instantiation. If your program reduces this " +"value, :c:func:`!devpoll` will fail. If your program increases this " +"value, :c:func:`!devpoll` may return an incomplete list of active file " +"descriptors." msgstr "" msgid "The new file descriptor is :ref:`non-inheritable `." @@ -80,8 +80,8 @@ msgid "The new file descriptor is now non-inheritable." msgstr "" msgid "" -"(Only supported on Linux 2.5.44 and newer.) Return an edge polling object, " -"which can be used as Edge or Level Triggered interface for I/O events." +"Return an edge polling object, which can be used as Edge or Level Triggered " +"interface for I/O events." msgstr "" msgid "" @@ -103,9 +103,9 @@ msgid "" msgstr "" msgid "" -"``epoll`` objects support the context management protocol: when used in a :" -"keyword:`with` statement, the new file descriptor is automatically closed at " -"the end of the block." +"``epoll`` objects support the context management protocol: when used in " +"a :keyword:`with` statement, the new file descriptor is automatically closed " +"at the end of the block." msgstr "" msgid "Added the *flags* parameter." @@ -122,20 +122,19 @@ msgid "" msgstr "" msgid "" -"(Not supported by all operating systems.) Returns a polling object, which " -"supports registering and unregistering file descriptors, and then polling " -"them for I/O events; see section :ref:`poll-objects` below for the methods " -"supported by polling objects." +"Returns a polling object, which supports registering and unregistering file " +"descriptors, and then polling them for I/O events; see section :ref:`poll-" +"objects` below for the methods supported by polling objects." msgstr "" msgid "" -"(Only supported on BSD.) Returns a kernel queue object; see section :ref:" -"`kqueue-objects` below for the methods supported by kqueue objects." +"Returns a kernel queue object; see section :ref:`kqueue-objects` below for " +"the methods supported by kqueue objects." msgstr "" msgid "" -"(Only supported on BSD.) Returns a kernel event object; see section :ref:" -"`kevent-objects` below for the methods supported by kevent objects." +"Returns a kernel event object; see section :ref:`kevent-objects` below for " +"the methods supported by kevent objects." msgstr "" msgid "" @@ -173,11 +172,11 @@ msgstr "" msgid "" "Among the acceptable object types in the iterables are Python :term:`file " -"objects ` (e.g. ``sys.stdin``, or objects returned by :func:" -"`open` or :func:`os.popen`), socket objects returned by :func:`socket." -"socket`. You may also define a :dfn:`wrapper` class yourself, as long as it " -"has an appropriate :meth:`~io.IOBase.fileno` method (that really returns a " -"file descriptor, not just a random integer)." +"objects ` (e.g. ``sys.stdin``, or objects returned " +"by :func:`open` or :func:`os.popen`), socket objects returned " +"by :func:`socket.socket`. You may also define a :dfn:`wrapper` class " +"yourself, as long as it has an appropriate :meth:`~io.IOBase.fileno` method " +"(that really returns a file descriptor, not just a random integer)." msgstr "" msgid "" @@ -195,15 +194,16 @@ msgstr "" msgid "" "The minimum number of bytes which can be written without blocking to a pipe " -"when the pipe has been reported as ready for writing by :func:`~select." -"select`, :func:`!poll` or another interface in this module. This doesn't " -"apply to other kinds of file-like objects such as sockets." +"when the pipe has been reported as ready for writing " +"by :func:`~select.select`, :func:`!poll` or another interface in this " +"module. This doesn't apply to other kinds of file-like objects such as " +"sockets." msgstr "" msgid "This value is guaranteed by POSIX to be at least 512." msgstr "" -msgid "``/dev/poll`` Polling Objects" +msgid "``/dev/poll`` polling objects" msgstr "" msgid "" @@ -226,18 +226,18 @@ msgid "Return the file descriptor number of the polling object." msgstr "" msgid "" -"Register a file descriptor with the polling object. Future calls to the :" -"meth:`poll` method will then check whether the file descriptor has any " -"pending I/O events. *fd* can be either an integer, or an object with a :" -"meth:`~io.IOBase.fileno` method that returns an integer. File objects " +"Register a file descriptor with the polling object. Future calls to " +"the :meth:`poll` method will then check whether the file descriptor has any " +"pending I/O events. *fd* can be either an integer, or an object with " +"a :meth:`~io.IOBase.fileno` method that returns an integer. File objects " "implement :meth:`!fileno`, so they can also be used as the argument." msgstr "" msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " "check for. The constants are the same as with :c:func:`!poll` object. The " -"default value is a combination of the constants :const:`POLLIN`, :const:" -"`POLLPRI`, and :const:`POLLOUT`." +"default value is a combination of the " +"constants :const:`POLLIN`, :const:`POLLPRI`, and :const:`POLLOUT`." msgstr "" msgid "" @@ -252,9 +252,9 @@ msgid "" msgstr "" msgid "" -"Remove a file descriptor being tracked by a polling object. Just like the :" -"meth:`register` method, *fd* can be an integer or an object with a :meth:" -"`~io.IOBase.fileno` method that returns an integer." +"Remove a file descriptor being tracked by a polling object. Just like " +"the :meth:`register` method, *fd* can be an integer or an object with " +"a :meth:`~io.IOBase.fileno` method that returns an integer." msgstr "" msgid "" @@ -266,22 +266,23 @@ msgid "" "Polls the set of registered file descriptors, and returns a possibly empty " "list containing ``(fd, event)`` 2-tuples for the descriptors that have " "events or errors to report. *fd* is the file descriptor, and *event* is a " -"bitmask with bits set for the reported events for that descriptor --- :const:" -"`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the descriptor " -"can be written to, and so forth. An empty list indicates that the call timed " -"out and no file descriptors had any events to report. If *timeout* is given, " -"it specifies the length of time in milliseconds which the system will wait " -"for events before returning. If *timeout* is omitted, -1, or :const:`None`, " -"the call will block until there is an event for this poll object." +"bitmask with bits set for the reported events for that descriptor " +"--- :const:`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the " +"descriptor can be written to, and so forth. An empty list indicates that the " +"call timed out and no file descriptors had any events to report. If " +"*timeout* is given, it specifies the length of time in milliseconds which " +"the system will wait for events before returning. If *timeout* is omitted, " +"-1, or :const:`None`, the call will block until there is an event for this " +"poll object." msgstr "" -msgid "Edge and Level Trigger Polling (epoll) Objects" +msgid "Edge and level trigger polling (epoll) objects" msgstr "" msgid "https://linux.die.net/man/4/epoll" msgstr "https://linux.die.net/man/4/epoll" -msgid "*eventmask*" +msgid "The *eventmask* is a bit mask using the following constants:" msgstr "" msgid "Constant" @@ -293,37 +294,37 @@ msgstr "Znaczenie" msgid ":const:`EPOLLIN`" msgstr ":const:`EPOLLIN`" -msgid "Available for read" +msgid "Available for read." msgstr "" msgid ":const:`EPOLLOUT`" msgstr ":const:`EPOLLOUT`" -msgid "Available for write" +msgid "Available for write." msgstr "" msgid ":const:`EPOLLPRI`" msgstr ":const:`EPOLLPRI`" -msgid "Urgent data for read" +msgid "Urgent data for read." msgstr "" msgid ":const:`EPOLLERR`" msgstr ":const:`EPOLLERR`" -msgid "Error condition happened on the assoc. fd" +msgid "Error condition happened on the associated fd." msgstr "" msgid ":const:`EPOLLHUP`" msgstr ":const:`EPOLLHUP`" -msgid "Hang up happened on the assoc. fd" +msgid "Hang up happened on the associated fd." msgstr "" msgid ":const:`EPOLLET`" msgstr ":const:`EPOLLET`" -msgid "Set Edge Trigger behavior, the default is Level Trigger behavior" +msgid "Set Edge Trigger behavior, the default is Level Trigger behavior." msgstr "" msgid ":const:`EPOLLONESHOT`" @@ -331,7 +332,7 @@ msgstr ":const:`EPOLLONESHOT`" msgid "" "Set one-shot behavior. After one event is pulled out, the fd is internally " -"disabled" +"disabled." msgstr "" msgid ":const:`EPOLLEXCLUSIVE`" @@ -339,7 +340,7 @@ msgstr ":const:`EPOLLEXCLUSIVE`" msgid "" "Wake only one epoll object when the associated fd has an event. The default " -"(if this flag is not set) is to wake all epoll objects polling on a fd." +"(if this flag is not set) is to wake all epoll objects polling on an fd." msgstr "" msgid ":const:`EPOLLRDHUP`" @@ -364,7 +365,7 @@ msgstr "" msgid ":const:`EPOLLWRNORM`" msgstr ":const:`EPOLLWRNORM`" -msgid "Equivalent to :const:`EPOLLOUT`" +msgid "Equivalent to :const:`EPOLLOUT`." msgstr "" msgid ":const:`EPOLLWRBAND`" @@ -407,10 +408,10 @@ msgstr "" msgid "Create an epoll object from a given file descriptor." msgstr "" -msgid "Register a fd descriptor with the epoll object." +msgid "Register a file descriptor *fd* with the epoll object." msgstr "" -msgid "Modify a registered file descriptor." +msgid "Modify a registered file descriptor *fd*." msgstr "" msgid "Remove a registered file descriptor from the epoll object." @@ -422,7 +423,7 @@ msgstr "" msgid "Wait for events. timeout in seconds (float)" msgstr "" -msgid "Polling Objects" +msgid "Polling objects" msgstr "" msgid "" @@ -438,52 +439,54 @@ msgstr "" msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " -"check for, and can be a combination of the constants :const:`POLLIN`, :const:" -"`POLLPRI`, and :const:`POLLOUT`, described in the table below. If not " -"specified, the default value used will check for all 3 types of events." +"check for, and can be a combination of the " +"constants :const:`POLLIN`, :const:`POLLPRI`, and :const:`POLLOUT`, described " +"in the table below. If not specified, the default value used will check for " +"all 3 types of events." msgstr "" msgid ":const:`POLLIN`" msgstr ":const:`POLLIN`" -msgid "There is data to read" +msgid "There is data to read." msgstr "" msgid ":const:`POLLPRI`" msgstr ":const:`POLLPRI`" -msgid "There is urgent data to read" +msgid "There is urgent data to read." msgstr "" msgid ":const:`POLLOUT`" msgstr ":const:`POLLOUT`" -msgid "Ready for output: writing will not block" +msgid "Ready for output: writing will not block." msgstr "" msgid ":const:`POLLERR`" msgstr ":const:`POLLERR`" -msgid "Error condition of some sort" +msgid "Error condition of some sort." msgstr "" msgid ":const:`POLLHUP`" msgstr ":const:`POLLHUP`" -msgid "Hung up" +msgid "Hung up." msgstr "" msgid ":const:`POLLRDHUP`" msgstr ":const:`POLLRDHUP`" msgid "" -"Stream socket peer closed connection, or shut down writing half of connection" +"Stream socket peer closed connection, or shut down writing half of " +"connection." msgstr "" msgid ":const:`POLLNVAL`" msgstr ":const:`POLLNVAL`" -msgid "Invalid request: descriptor not open" +msgid "Invalid request: descriptor not open." msgstr "" msgid "" @@ -494,29 +497,30 @@ msgstr "" msgid "" "Modifies an already registered fd. This has the same effect as " "``register(fd, eventmask)``. Attempting to modify a file descriptor that " -"was never registered causes an :exc:`OSError` exception with errno :const:" -"`ENOENT` to be raised." +"was never registered causes an :exc:`OSError` exception with " +"errno :const:`ENOENT` to be raised." msgstr "" msgid "" -"Attempting to remove a file descriptor that was never registered causes a :" -"exc:`KeyError` exception to be raised." +"Attempting to remove a file descriptor that was never registered causes " +"a :exc:`KeyError` exception to be raised." msgstr "" msgid "" "Polls the set of registered file descriptors, and returns a possibly empty " "list containing ``(fd, event)`` 2-tuples for the descriptors that have " "events or errors to report. *fd* is the file descriptor, and *event* is a " -"bitmask with bits set for the reported events for that descriptor --- :const:" -"`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the descriptor " -"can be written to, and so forth. An empty list indicates that the call timed " -"out and no file descriptors had any events to report. If *timeout* is given, " -"it specifies the length of time in milliseconds which the system will wait " -"for events before returning. If *timeout* is omitted, negative, or :const:" -"`None`, the call will block until there is an event for this poll object." +"bitmask with bits set for the reported events for that descriptor " +"--- :const:`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the " +"descriptor can be written to, and so forth. An empty list indicates that the " +"call timed out and no file descriptors had any events to report. If " +"*timeout* is given, it specifies the length of time in milliseconds which " +"the system will wait for events before returning. If *timeout* is omitted, " +"negative, or :const:`None`, the call will block until there is an event for " +"this poll object." msgstr "" -msgid "Kqueue Objects" +msgid "Kqueue objects" msgstr "" msgid "Close the control file descriptor of the kqueue object." @@ -542,7 +546,7 @@ msgid "" "forever" msgstr "" -msgid "Kevent Objects" +msgid "Kevent objects" msgstr "" msgid "https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2" @@ -561,51 +565,52 @@ msgstr "" msgid ":const:`KQ_FILTER_READ`" msgstr ":const:`KQ_FILTER_READ`" -msgid "Takes a descriptor and returns whenever there is data available to read" +msgid "" +"Takes a descriptor and returns whenever there is data available to read." msgstr "" msgid ":const:`KQ_FILTER_WRITE`" msgstr ":const:`KQ_FILTER_WRITE`" msgid "" -"Takes a descriptor and returns whenever there is data available to write" +"Takes a descriptor and returns whenever there is data available to write." msgstr "" msgid ":const:`KQ_FILTER_AIO`" msgstr ":const:`KQ_FILTER_AIO`" -msgid "AIO requests" +msgid "AIO requests." msgstr "" msgid ":const:`KQ_FILTER_VNODE`" msgstr ":const:`KQ_FILTER_VNODE`" msgid "" -"Returns when one or more of the requested events watched in *fflag* occurs" +"Returns when one or more of the requested events watched in *fflags* occurs." msgstr "" msgid ":const:`KQ_FILTER_PROC`" msgstr ":const:`KQ_FILTER_PROC`" -msgid "Watch for events on a process id" +msgid "Watch for events on a process ID." msgstr "" msgid ":const:`KQ_FILTER_NETDEV`" msgstr ":const:`KQ_FILTER_NETDEV`" -msgid "Watch for events on a network device [not available on macOS]" +msgid "Watch for events on a network device (not available on macOS)." msgstr "" msgid ":const:`KQ_FILTER_SIGNAL`" msgstr ":const:`KQ_FILTER_SIGNAL`" -msgid "Returns whenever the watched signal is delivered to the process" +msgid "Returns whenever the watched signal is delivered to the process." msgstr "" msgid ":const:`KQ_FILTER_TIMER`" msgstr ":const:`KQ_FILTER_TIMER`" -msgid "Establishes an arbitrary timer" +msgid "Establishes an arbitrary timer." msgstr "" msgid "Filter action." @@ -614,43 +619,43 @@ msgstr "" msgid ":const:`KQ_EV_ADD`" msgstr ":const:`KQ_EV_ADD`" -msgid "Adds or modifies an event" +msgid "Adds or modifies an event." msgstr "" msgid ":const:`KQ_EV_DELETE`" msgstr ":const:`KQ_EV_DELETE`" -msgid "Removes an event from the queue" +msgid "Removes an event from the queue." msgstr "" msgid ":const:`KQ_EV_ENABLE`" msgstr ":const:`KQ_EV_ENABLE`" -msgid "Permits control() to return the event" +msgid "Permits control() to return the event." msgstr "" msgid ":const:`KQ_EV_DISABLE`" msgstr ":const:`KQ_EV_DISABLE`" -msgid "Disables event" +msgid "Disables event." msgstr "" msgid ":const:`KQ_EV_ONESHOT`" msgstr ":const:`KQ_EV_ONESHOT`" -msgid "Removes event after first occurrence" +msgid "Removes event after first occurrence." msgstr "" msgid ":const:`KQ_EV_CLEAR`" msgstr ":const:`KQ_EV_CLEAR`" -msgid "Reset the state after an event is retrieved" +msgid "Reset the state after an event is retrieved." msgstr "" msgid ":const:`KQ_EV_SYSFLAGS`" msgstr ":const:`KQ_EV_SYSFLAGS`" -msgid "internal event" +msgid "Internal event." msgstr "" msgid ":const:`KQ_EV_FLAG1`" @@ -659,16 +664,16 @@ msgstr ":const:`KQ_EV_FLAG1`" msgid ":const:`KQ_EV_EOF`" msgstr ":const:`KQ_EV_EOF`" -msgid "Filter specific EOF condition" +msgid "Filter-specific EOF condition." msgstr "" msgid ":const:`KQ_EV_ERROR`" msgstr ":const:`KQ_EV_ERROR`" -msgid "See return values" +msgid "See return values." msgstr "" -msgid "Filter specific flags." +msgid "Filter-specific flags." msgstr "" msgid ":const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:" @@ -677,7 +682,7 @@ msgstr "" msgid ":const:`KQ_NOTE_LOWAT`" msgstr ":const:`KQ_NOTE_LOWAT`" -msgid "low water mark of a socket buffer" +msgid "Low water mark of a socket buffer." msgstr "" msgid ":const:`KQ_FILTER_VNODE` filter flags:" @@ -686,43 +691,43 @@ msgstr "" msgid ":const:`KQ_NOTE_DELETE`" msgstr ":const:`KQ_NOTE_DELETE`" -msgid "*unlink()* was called" +msgid "*unlink()* was called." msgstr "" msgid ":const:`KQ_NOTE_WRITE`" msgstr ":const:`KQ_NOTE_WRITE`" -msgid "a write occurred" +msgid "A write occurred." msgstr "" msgid ":const:`KQ_NOTE_EXTEND`" msgstr ":const:`KQ_NOTE_EXTEND`" -msgid "the file was extended" +msgid "The file was extended." msgstr "" msgid ":const:`KQ_NOTE_ATTRIB`" msgstr ":const:`KQ_NOTE_ATTRIB`" -msgid "an attribute was changed" +msgid "An attribute was changed." msgstr "" msgid ":const:`KQ_NOTE_LINK`" msgstr ":const:`KQ_NOTE_LINK`" -msgid "the link count has changed" +msgid "The link count has changed." msgstr "" msgid ":const:`KQ_NOTE_RENAME`" msgstr ":const:`KQ_NOTE_RENAME`" -msgid "the file was renamed" +msgid "The file was renamed." msgstr "" msgid ":const:`KQ_NOTE_REVOKE`" msgstr ":const:`KQ_NOTE_REVOKE`" -msgid "access to the file was revoked" +msgid "Access to the file was revoked." msgstr "" msgid ":const:`KQ_FILTER_PROC` filter flags:" @@ -731,25 +736,25 @@ msgstr "" msgid ":const:`KQ_NOTE_EXIT`" msgstr ":const:`KQ_NOTE_EXIT`" -msgid "the process has exited" +msgid "The process has exited." msgstr "" msgid ":const:`KQ_NOTE_FORK`" msgstr ":const:`KQ_NOTE_FORK`" -msgid "the process has called *fork()*" +msgid "The process has called *fork()*." msgstr "" msgid ":const:`KQ_NOTE_EXEC`" msgstr ":const:`KQ_NOTE_EXEC`" -msgid "the process has executed a new process" +msgid "The process has executed a new process." msgstr "" msgid ":const:`KQ_NOTE_PCTRLMASK`" msgstr ":const:`KQ_NOTE_PCTRLMASK`" -msgid "internal filter flag" +msgid "Internal filter flag." msgstr "" msgid ":const:`KQ_NOTE_PDATAMASK`" @@ -758,19 +763,19 @@ msgstr ":const:`KQ_NOTE_PDATAMASK`" msgid ":const:`KQ_NOTE_TRACK`" msgstr ":const:`KQ_NOTE_TRACK`" -msgid "follow a process across *fork()*" +msgid "Follow a process across *fork()*." msgstr "" msgid ":const:`KQ_NOTE_CHILD`" msgstr ":const:`KQ_NOTE_CHILD`" -msgid "returned on the child process for *NOTE_TRACK*" +msgid "Returned on the child process for *NOTE_TRACK*." msgstr "" msgid ":const:`KQ_NOTE_TRACKERR`" msgstr ":const:`KQ_NOTE_TRACKERR`" -msgid "unable to attach to a child" +msgid "Unable to attach to a child." msgstr "" msgid ":const:`KQ_FILTER_NETDEV` filter flags (not available on macOS):" @@ -779,25 +784,25 @@ msgstr "" msgid ":const:`KQ_NOTE_LINKUP`" msgstr ":const:`KQ_NOTE_LINKUP`" -msgid "link is up" +msgid "Link is up." msgstr "" msgid ":const:`KQ_NOTE_LINKDOWN`" msgstr ":const:`KQ_NOTE_LINKDOWN`" -msgid "link is down" +msgid "Link is down." msgstr "" msgid ":const:`KQ_NOTE_LINKINV`" msgstr ":const:`KQ_NOTE_LINKINV`" -msgid "link state is invalid" +msgid "Link state is invalid." msgstr "" -msgid "Filter specific data." +msgid "Filter-specific data." msgstr "" -msgid "User defined value." +msgid "User-defined value." msgstr "" msgid "socket() (in module socket)" diff --git a/library/selectors.po b/library/selectors.po index d4e13e915f..953447d89c 100644 --- a/library/selectors.po +++ b/library/selectors.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,10 +40,11 @@ msgstr "" msgid "" "It defines a :class:`BaseSelector` abstract base class, along with several " -"concrete implementations (:class:`KqueueSelector`, :class:" -"`EpollSelector`...), that can be used to wait for I/O readiness notification " -"on multiple file objects. In the following, \"file object\" refers to any " -"object with a :meth:`~io.IOBase.fileno` method, or a raw file descriptor. " +"concrete implementations " +"(:class:`KqueueSelector`, :class:`EpollSelector`...), that can be used to " +"wait for I/O readiness notification on multiple file objects. In the " +"following, \"file object\" refers to any object with " +"a :meth:`~io.IOBase.fileno` method, or a raw file descriptor. " "See :term:`file object`." msgstr "" @@ -132,11 +133,12 @@ msgid "" "A :class:`BaseSelector` is used to wait for I/O event readiness on multiple " "file objects. It supports file stream registration, unregistration, and a " "method to wait for I/O events on those streams, with an optional timeout. " -"It's an abstract base class, so cannot be instantiated. Use :class:" -"`DefaultSelector` instead, or one of :class:`SelectSelector`, :class:" -"`KqueueSelector` etc. if you want to specifically use an implementation, and " -"your platform supports it. :class:`BaseSelector` and its concrete " -"implementations support the :term:`context manager` protocol." +"It's an abstract base class, so cannot be instantiated. " +"Use :class:`DefaultSelector` instead, or one " +"of :class:`SelectSelector`, :class:`KqueueSelector` etc. if you want to " +"specifically use an implementation, and your platform supports " +"it. :class:`BaseSelector` and its concrete implementations support " +"the :term:`context manager` protocol." msgstr "" msgid "Register a file object for selection, monitoring it for I/O events." @@ -149,9 +151,9 @@ msgid "" msgstr "" msgid "" -"This returns a new :class:`SelectorKey` instance, or raises a :exc:" -"`ValueError` in case of invalid event mask or file descriptor, or :exc:" -"`KeyError` if the file object is already registered." +"This returns a new :class:`SelectorKey` instance, or raises " +"a :exc:`ValueError` in case of invalid event mask or file descriptor, " +"or :exc:`KeyError` if the file object is already registered." msgstr "" msgid "" @@ -163,10 +165,10 @@ msgid "*fileobj* must be a file object previously registered." msgstr "" msgid "" -"This returns the associated :class:`SelectorKey` instance, or raises a :exc:" -"`KeyError` if *fileobj* is not registered. It will raise :exc:`ValueError` " -"if *fileobj* is invalid (e.g. it has no ``fileno()`` method or its " -"``fileno()`` method has an invalid return value)." +"This returns the associated :class:`SelectorKey` instance, or raises " +"a :exc:`KeyError` if *fileobj* is not registered. It will " +"raise :exc:`ValueError` if *fileobj* is invalid (e.g. it has no ``fileno()`` " +"method or its ``fileno()`` method has an invalid return value)." msgstr "" msgid "Change a registered file object's monitored events or attached data." @@ -179,9 +181,9 @@ msgid "" msgstr "" msgid "" -"This returns a new :class:`SelectorKey` instance, or raises a :exc:" -"`ValueError` in case of invalid event mask or file descriptor, or :exc:" -"`KeyError` if the file object is not registered." +"This returns a new :class:`SelectorKey` instance, or raises " +"a :exc:`ValueError` in case of invalid event mask or file descriptor, " +"or :exc:`KeyError` if the file object is not registered." msgstr "" msgid "" @@ -266,16 +268,16 @@ msgid ":func:`select.devpoll`-based selector." msgstr "" msgid "" -"This returns the file descriptor used by the underlying :func:`select." -"devpoll` object." +"This returns the file descriptor used by the " +"underlying :func:`select.devpoll` object." msgstr "" msgid ":func:`select.kqueue`-based selector." msgstr "" msgid "" -"This returns the file descriptor used by the underlying :func:`select." -"kqueue` object." +"This returns the file descriptor used by the " +"underlying :func:`select.kqueue` object." msgstr "" msgid "Examples" diff --git a/library/shelve.po b/library/shelve.po index 7314d0cd8a..a8cd7b3965 100644 --- a/library/shelve.po +++ b/library/shelve.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,8 +44,8 @@ msgid "" "for the underlying database. As a side-effect, an extension may be added to " "the filename and more than one file may be created. By default, the " "underlying database file is opened for reading and writing. The optional " -"*flag* parameter has the same interpretation as the *flag* parameter of :" -"func:`dbm.open`." +"*flag* parameter has the same interpretation as the *flag* parameter " +"of :func:`dbm.open`." msgstr "" msgid "" @@ -58,13 +59,13 @@ msgid "" "dictionary entry is modified. By default modified objects are written " "*only* when assigned to the shelf (see :ref:`shelve-example`). If the " "optional *writeback* parameter is set to ``True``, all entries accessed are " -"also cached in memory, and written back on :meth:`~Shelf.sync` and :meth:" -"`~Shelf.close`; this can make it handier to mutate mutable entries in the " -"persistent dictionary, but, if many entries are accessed, it can consume " -"vast amounts of memory for the cache, and it can make the close operation " -"very slow since all accessed entries are written back (there is no way to " -"determine which accessed entries are mutable, nor which ones were actually " -"mutated)." +"also cached in memory, and written back on :meth:`~Shelf.sync` " +"and :meth:`~Shelf.close`; this can make it handier to mutate mutable entries " +"in the persistent dictionary, but, if many entries are accessed, it can " +"consume vast amounts of memory for the cache, and it can make the close " +"operation very slow since all accessed entries are written back (there is no " +"way to determine which accessed entries are mutable, nor which ones were " +"actually mutated)." msgstr "" msgid "" @@ -75,9 +76,9 @@ msgid "Accepts :term:`path-like object` for filename." msgstr "" msgid "" -"Do not rely on the shelf being closed automatically; always call :meth:" -"`~Shelf.close` explicitly when you don't need it any more, or use :func:" -"`shelve.open` as a context manager::" +"Do not rely on the shelf being closed automatically; always " +"call :meth:`~Shelf.close` explicitly when you don't need it any more, or " +"use :func:`shelve.open` as a context manager::" msgstr "" msgid "" @@ -181,27 +182,27 @@ msgid "" msgstr "" msgid "Added context manager support." -msgstr "" +msgstr "Dodano obsługę menedżer wparcie" msgid "" -"A subclass of :class:`Shelf` which exposes :meth:`!first`, :meth:`!next`, :" -"meth:`!previous`, :meth:`!last` and :meth:`!set_location` methods. These are " -"available in the third-party :mod:`!bsddb` module from `pybsddb `_ but not in other database modules. The " -"*dict* object passed to the constructor must support those methods. This is " -"generally accomplished by calling one of :func:`!bsddb.hashopen`, :func:`!" -"bsddb.btopen` or :func:`!bsddb.rnopen`. The optional *protocol*, " -"*writeback*, and *keyencoding* parameters have the same interpretation as " -"for the :class:`Shelf` class." +"A subclass of :class:`Shelf` which exposes :meth:`!first`, :meth:`!" +"next`, :meth:`!previous`, :meth:`!last` and :meth:`!set_location` methods. " +"These are available in the third-party :mod:`!bsddb` module from `pybsddb " +"`_ but not in other database " +"modules. The *dict* object passed to the constructor must support those " +"methods. This is generally accomplished by calling one of :func:`!" +"bsddb.hashopen`, :func:`!bsddb.btopen` or :func:`!bsddb.rnopen`. The " +"optional *protocol*, *writeback*, and *keyencoding* parameters have the same " +"interpretation as for the :class:`Shelf` class." msgstr "" msgid "" "A subclass of :class:`Shelf` which accepts a *filename* instead of a dict-" "like object. The underlying file will be opened using :func:`dbm.open`. By " "default, the file will be created and opened for both read and write. The " -"optional *flag* parameter has the same interpretation as for the :func:`." -"open` function. The optional *protocol* and *writeback* parameters have the " -"same interpretation as for the :class:`Shelf` class." +"optional *flag* parameter has the same interpretation as for " +"the :func:`.open` function. The optional *protocol* and *writeback* " +"parameters have the same interpretation as for the :class:`Shelf` class." msgstr "" msgid "Example" diff --git a/library/shlex.po b/library/shlex.po index 2d4ceef257..4783ab0462 100644 --- a/library/shlex.po +++ b/library/shlex.po @@ -40,12 +40,12 @@ msgid "The :mod:`shlex` module defines the following functions:" msgstr "" msgid "" -"Split the string *s* using shell-like syntax. If *comments* is :const:" -"`False` (the default), the parsing of comments in the given string will be " -"disabled (setting the :attr:`~shlex.commenters` attribute of the :class:" -"`~shlex.shlex` instance to the empty string). This function operates in " -"POSIX mode by default, but uses non-POSIX mode if the *posix* argument is " -"false." +"Split the string *s* using shell-like syntax. If *comments* " +"is :const:`False` (the default), the parsing of comments in the given string " +"will be disabled (setting the :attr:`~shlex.commenters` attribute of " +"the :class:`~shlex.shlex` instance to the empty string). This function " +"operates in POSIX mode by default, but uses non-POSIX mode if the *posix* " +"argument is false." msgstr "" msgid "" @@ -85,8 +85,8 @@ msgid "" msgstr "" msgid "" -"Consider using functions that pass command arguments with lists such as :" -"func:`subprocess.run` with ``shell=False``." +"Consider using functions that pass command arguments with lists such " +"as :func:`subprocess.run` with ``shell=False``." msgstr "" msgid "This idiom would be unsafe:" @@ -104,25 +104,26 @@ msgstr "" msgid "" "A :class:`~shlex.shlex` instance or subclass instance is a lexical analyzer " "object. The initialization argument, if present, specifies where to read " -"characters from. It must be a file-/stream-like object with :meth:`~io." -"TextIOBase.read` and :meth:`~io.TextIOBase.readline` methods, or a string. " -"If no argument is given, input will be taken from ``sys.stdin``. The second " -"optional argument is a filename string, which sets the initial value of the :" -"attr:`~shlex.infile` attribute. If the *instream* argument is omitted or " -"equal to ``sys.stdin``, this second argument defaults to \"stdin\". The " -"*posix* argument defines the operational mode: when *posix* is not true " -"(default), the :class:`~shlex.shlex` instance will operate in compatibility " -"mode. When operating in POSIX mode, :class:`~shlex.shlex` will try to be as " -"close as possible to the POSIX shell parsing rules. The *punctuation_chars* " -"argument provides a way to make the behaviour even closer to how real shells " -"parse. This can take a number of values: the default value, ``False``, " -"preserves the behaviour seen under Python 3.5 and earlier. If set to " -"``True``, then parsing of the characters ``();<>|&`` is changed: any run of " -"these characters (considered punctuation characters) is returned as a single " -"token. If set to a non-empty string of characters, those characters will be " -"used as the punctuation characters. Any characters in the :attr:`wordchars` " -"attribute that appear in *punctuation_chars* will be removed from :attr:" -"`wordchars`. See :ref:`improved-shell-compatibility` for more information. " +"characters from. It must be a file-/stream-like object " +"with :meth:`~io.TextIOBase.read` and :meth:`~io.TextIOBase.readline` " +"methods, or a string. If no argument is given, input will be taken from " +"``sys.stdin``. The second optional argument is a filename string, which sets " +"the initial value of the :attr:`~shlex.infile` attribute. If the *instream* " +"argument is omitted or equal to ``sys.stdin``, this second argument defaults " +"to \"stdin\". The *posix* argument defines the operational mode: when " +"*posix* is not true (default), the :class:`~shlex.shlex` instance will " +"operate in compatibility mode. When operating in POSIX " +"mode, :class:`~shlex.shlex` will try to be as close as possible to the POSIX " +"shell parsing rules. The *punctuation_chars* argument provides a way to " +"make the behaviour even closer to how real shells parse. This can take a " +"number of values: the default value, ``False``, preserves the behaviour seen " +"under Python 3.5 and earlier. If set to ``True``, then parsing of the " +"characters ``();<>|&`` is changed: any run of these characters (considered " +"punctuation characters) is returned as a single token. If set to a non-" +"empty string of characters, those characters will be used as the punctuation " +"characters. Any characters in the :attr:`wordchars` attribute that appear " +"in *punctuation_chars* will be removed from :attr:`wordchars`. " +"See :ref:`improved-shell-compatibility` for more information. " "*punctuation_chars* can be set only upon :class:`~shlex.shlex` instance " "creation and can't be modified later." msgstr "" @@ -185,8 +186,9 @@ msgstr "" msgid "" "This hook is exposed so that you can use it to implement directory search " "paths, addition of file extensions, and other namespace hacks. There is no " -"corresponding 'close' hook, but a shlex instance will call the :meth:`~io." -"IOBase.close` method of the sourced input stream when it returns EOF." +"corresponding 'close' hook, but a shlex instance will call " +"the :meth:`~io.IOBase.close` method of the sourced input stream when it " +"returns EOF." msgstr "" msgid "" @@ -233,10 +235,10 @@ msgstr "" msgid "" "The string of characters that will accumulate into multi-character tokens. " "By default, includes all ASCII alphanumerics and underscore. In POSIX mode, " -"the accented characters in the Latin-1 set are also included. If :attr:" -"`punctuation_chars` is not empty, the characters ``~-./*?=``, which can " -"appear in filename specifications and command line parameters, will also be " -"included in this attribute, and any characters which appear in " +"the accented characters in the Latin-1 set are also included. " +"If :attr:`punctuation_chars` is not empty, the characters ``~-./*?=``, which " +"can appear in filename specifications and command line parameters, will also " +"be included in this attribute, and any characters which appear in " "``punctuation_chars`` will be removed from ``wordchars`` if they are present " "there. If :attr:`whitespace_split` is set to ``True``, this will have no " "effect." @@ -269,14 +271,14 @@ msgstr "" msgid "" "If ``True``, tokens will only be split in whitespaces. This is useful, for " "example, for parsing command lines with :class:`~shlex.shlex`, getting " -"tokens in a similar way to shell arguments. When used in combination with :" -"attr:`punctuation_chars`, tokens will be split on whitespace in addition to " -"those characters." +"tokens in a similar way to shell arguments. When used in combination " +"with :attr:`punctuation_chars`, tokens will be split on whitespace in " +"addition to those characters." msgstr "" msgid "" -"The :attr:`punctuation_chars` attribute was made compatible with the :attr:" -"`whitespace_split` attribute." +"The :attr:`punctuation_chars` attribute was made compatible with " +"the :attr:`whitespace_split` attribute." msgstr "" msgid "" @@ -382,18 +384,19 @@ msgid "" msgstr "" msgid "" -"Enclosing characters in quotes which are not part of :attr:`~shlex." -"escapedquotes` (e.g. ``\"'\"``) preserve the literal value of all characters " -"within the quotes;" +"Enclosing characters in quotes which are not part " +"of :attr:`~shlex.escapedquotes` (e.g. ``\"'\"``) preserve the literal value " +"of all characters within the quotes;" msgstr "" msgid "" -"Enclosing characters in quotes which are part of :attr:`~shlex." -"escapedquotes` (e.g. ``'\"'``) preserves the literal value of all characters " -"within the quotes, with the exception of the characters mentioned in :attr:" -"`~shlex.escape`. The escape characters retain its special meaning only when " -"followed by the quote in use, or the escape character itself. Otherwise the " -"escape character will be considered a normal character." +"Enclosing characters in quotes which are part " +"of :attr:`~shlex.escapedquotes` (e.g. ``'\"'``) preserves the literal value " +"of all characters within the quotes, with the exception of the characters " +"mentioned in :attr:`~shlex.escape`. The escape characters retain its " +"special meaning only when followed by the quote in use, or the escape " +"character itself. Otherwise the escape character will be considered a normal " +"character." msgstr "" msgid "EOF is signaled with a :const:`None` value;" @@ -439,13 +442,13 @@ msgstr "" msgid "" "However, to match the shell as closely as possible, it is recommended to " -"always use ``posix`` and :attr:`~shlex.whitespace_split` when using :attr:" -"`~shlex.punctuation_chars`, which will negate :attr:`~shlex.wordchars` " -"entirely." +"always use ``posix`` and :attr:`~shlex.whitespace_split` when " +"using :attr:`~shlex.punctuation_chars`, which will " +"negate :attr:`~shlex.wordchars` entirely." msgstr "" msgid "" "For best effect, ``punctuation_chars`` should be set in conjunction with " -"``posix=True``. (Note that ``posix=False`` is the default for :class:`~shlex." -"shlex`.)" +"``posix=True``. (Note that ``posix=False`` is the default " +"for :class:`~shlex.shlex`.)" msgstr "" diff --git a/library/shutil.po b/library/shutil.po index ea0212ba3c..e475832cce 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -37,8 +37,8 @@ msgid "" msgstr "" msgid "" -"Even the higher-level file copying functions (:func:`shutil.copy`, :func:" -"`shutil.copy2`) cannot copy all file metadata." +"Even the higher-level file copying functions " +"(:func:`shutil.copy`, :func:`shutil.copy2`) cannot copy all file metadata." msgstr "" msgid "" @@ -67,9 +67,9 @@ msgid "" "been flushed on completion of the copy. If you want to read from the " "destination at the completion of the copy operation (for example, reading " "the contents of a temporary file that has been copied from a HTTP stream), " -"you must ensure that you have called :func:`~io.IOBase.flush` or :func:`~io." -"IOBase.close` on the file-like object before attempting to read the " -"destination file." +"you must ensure that you have called :func:`~io.IOBase.flush` " +"or :func:`~io.IOBase.close` on the file-like object before attempting to " +"read the destination file." msgstr "" msgid "" @@ -134,10 +134,10 @@ msgid "" "like object>` or path names given as strings. If *follow_symlinks* is false, " "and both *src* and *dst* are symbolic links, :func:`copymode` will attempt " "to modify the mode of *dst* itself (rather than the file it points to). " -"This functionality is not available on every platform; please see :func:" -"`copystat` for more information. If :func:`copymode` cannot modify symbolic " -"links on the local platform, and it is asked to do so, it will do nothing " -"and return." +"This functionality is not available on every platform; please " +"see :func:`copystat` for more information. If :func:`copymode` cannot " +"modify symbolic links on the local platform, and it is asked to do so, it " +"will do nothing and return." msgstr "" msgid "" @@ -179,9 +179,9 @@ msgid "" msgstr "" msgid "" -"If ``os.chflags in os.supports_follow_symlinks`` is ``True``, :func:" -"`copystat` can modify the flags of a symbolic link. (``os.chflags`` is not " -"available on all platforms.)" +"If ``os.chflags in os.supports_follow_symlinks`` is " +"``True``, :func:`copystat` can modify the flags of a symbolic link. " +"(``os.chflags`` is not available on all platforms.)" msgstr "" msgid "" @@ -237,14 +237,15 @@ msgid "" "attempts to copy all metadata from the *src* symbolic link to the newly " "created *dst* symbolic link. However, this functionality is not available on " "all platforms. On platforms where some or all of this functionality is " -"unavailable, :func:`copy2` will preserve all the metadata it can; :func:" -"`copy2` never raises an exception because it cannot preserve file metadata." +"unavailable, :func:`copy2` will preserve all the metadata it " +"can; :func:`copy2` never raises an exception because it cannot preserve file " +"metadata." msgstr "" msgid "" -":func:`copy2` uses :func:`copystat` to copy the file metadata. Please see :" -"func:`copystat` for more information about platform support for modifying " -"symbolic link metadata." +":func:`copy2` uses :func:`copystat` to copy the file metadata. Please " +"see :func:`copystat` for more information about platform support for " +"modifying symbolic link metadata." msgstr "" msgid "" @@ -254,9 +255,9 @@ msgid "" msgstr "" msgid "" -"This factory function creates a function that can be used as a callable for :" -"func:`copytree`\\'s *ignore* argument, ignoring files and directories that " -"match one of the glob-style *patterns* provided. See the example below." +"This factory function creates a function that can be used as a callable " +"for :func:`copytree`\\'s *ignore* argument, ignoring files and directories " +"that match one of the glob-style *patterns* provided. See the example below." msgstr "" msgid "" @@ -279,9 +280,9 @@ msgstr "" msgid "" "When *symlinks* is false, if the file pointed to by the symlink doesn't " -"exist, an exception will be added in the list of errors raised in an :exc:" -"`Error` exception at the end of the copy process. You can set the optional " -"*ignore_dangling_symlinks* flag to true if you want to silence this " +"exist, an exception will be added in the list of errors raised in " +"an :exc:`Error` exception at the end of the copy process. You can set the " +"optional *ignore_dangling_symlinks* flag to true if you want to silence this " "exception. Notice that this option has no effect on platforms that don't " "support :func:`os.symlink`." msgstr "" @@ -310,8 +311,8 @@ msgid "" msgstr "" msgid "" -"If *dirs_exist_ok* is false (the default) and *dst* already exists, a :exc:" -"`FileExistsError` is raised. If *dirs_exist_ok* is true, the copying " +"If *dirs_exist_ok* is false (the default) and *dst* already exists, " +"a :exc:`FileExistsError` is raised. If *dirs_exist_ok* is true, the copying " "operation will continue if it encounters existing directories, and files " "within the *dst* tree will be overwritten by corresponding files from the " "*src* tree." @@ -342,6 +343,14 @@ msgid "" "are omitted, exceptions are propagated to the caller." msgstr "" +msgid "" +"If *path* is a symbolic link to a directory followed by a trailing path " +"separator, such as ``'link/'``, the operating system resolves the link, " +"so :func:`!rmtree` deletes the contents of the directory it points to and " +"then fails to remove *path* itself. :class:`pathlib.Path` strips trailing " +"separators, so ``rmtree(Path('link/'))`` refuses the link as usual." +msgstr "" + msgid "" "This function can support :ref:`paths relative to directory descriptors " "`." @@ -403,8 +412,8 @@ msgstr "" msgid "" ":func:`!rmtree` now ignores :exc:`FileNotFoundError` exceptions for all but " -"the top-level path. Exceptions other than :exc:`OSError` and subclasses of :" -"exc:`!OSError` are now always propagated to the caller." +"the top-level path. Exceptions other than :exc:`OSError` and subclasses " +"of :exc:`!OSError` are now always propagated to the caller." msgstr "" msgid "" @@ -430,18 +439,25 @@ msgid "" msgstr "" msgid "" -"If the destination is on the current filesystem, then :func:`os.rename` is " -"used. Otherwise, *src* is copied to the destination using *copy_function* " -"and then removed. In case of symlinks, a new symlink pointing to the target " -"of *src* will be created as the destination and *src* will be removed." +":func:`os.rename` is preferably used internally when *src* and the " +"destination are on the same filesystem. In case :func:`os.rename` fails due " +"to :exc:`OSError` (e.g. the user has write permission to the destination " +"file but not to its parent directory), this method falls back to using " +"*copy_function*, in which case *src* is copied to the destination using " +"*copy_function* and then removed." +msgstr "" + +msgid "" +"In case of symlinks, a new symlink pointing to the target of *src* will be " +"created in or as the destination, and *src* will be removed." msgstr "" msgid "" "If *copy_function* is given, it must be a callable that takes two arguments, " "*src* and the destination, and will be used to copy *src* to the destination " -"if :func:`os.rename` cannot be used. If the source is a directory, :func:" -"`copytree` is called, passing it the *copy_function*. The default " -"*copy_function* is :func:`copy2`. Using :func:`~shutil.copy` as the " +"if :func:`os.rename` cannot be used. If the source is a " +"directory, :func:`copytree` is called, passing it the *copy_function*. The " +"default *copy_function* is :func:`copy2`. Using :func:`~shutil.copy` as the " "*copy_function* allows the move to succeed when it is not possible to also " "copy the metadata, at the expense of not copying any of the metadata." msgstr "" @@ -511,9 +527,9 @@ msgstr "" msgid "" "*path* is a \"``PATH`` string\" specifying the directories to look in, " -"delimited by :data:`os.pathsep`. When no *path* is specified, the :envvar:" -"`PATH` environment variable is read from :data:`os.environ`, falling back " -"to :data:`os.defpath` if it is not set." +"delimited by :data:`os.pathsep`. When no *path* is specified, " +"the :envvar:`PATH` environment variable is read from :data:`os.environ`, " +"falling back to :data:`os.defpath` if it is not set." msgstr "" msgid "" @@ -581,12 +597,12 @@ msgid "Platform-dependent efficient copy operations" msgstr "" msgid "" -"Starting from Python 3.8, all functions involving a file copy (:func:" -"`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, and :func:" -"`move`) may use platform-specific \"fast-copy\" syscalls in order to copy " -"the file more efficiently (see :issue:`33671`). \"fast-copy\" means that the " -"copying operation occurs within the kernel, avoiding the use of userspace " -"buffers in Python as in \"``outfd.write(infd.read())``\"." +"Starting from Python 3.8, all functions involving a file copy " +"(:func:`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, " +"and :func:`move`) may use platform-specific \"fast-copy\" syscalls in order " +"to copy the file more efficiently (see :issue:`33671`). \"fast-copy\" means " +"that the copying operation occurs within the kernel, avoiding the use of " +"userspace buffers in Python as in \"``outfd.write(infd.read())``\"." msgstr "" msgid "On macOS `fcopyfile`_ is used to copy the file content (not metadata)." @@ -600,22 +616,22 @@ msgstr "" msgid "" "On Windows :func:`shutil.copyfile` uses a bigger default buffer size (1 MiB " -"instead of 64 KiB) and a :func:`memoryview`-based variant of :func:`shutil." -"copyfileobj` is used." +"instead of 64 KiB) and a :func:`memoryview`-based variant " +"of :func:`shutil.copyfileobj` is used." msgstr "" msgid "" "If the fast-copy operation fails and no data was written in the destination " -"file then shutil will silently fall back to less efficient :func:" -"`copyfileobj` function internally." +"file then shutil will silently fall back to less " +"efficient :func:`copyfileobj` function internally." msgstr "" msgid "Solaris now uses :func:`os.sendfile`." msgstr "" msgid "" -"Copy-on-write or server-side copy may be used internally via :func:`os." -"copy_file_range` on supported Linux filesystems." +"Copy-on-write or server-side copy may be used internally " +"via :func:`os.copy_file_range` on supported Linux filesystems." msgstr "" msgid "copytree example" @@ -693,9 +709,9 @@ msgstr "" msgid "" "*format* is the archive format: one of \"zip\" (if the :mod:`zlib` module is " "available), \"tar\", \"gztar\" (if the :mod:`zlib` module is available), " -"\"bztar\" (if the :mod:`bz2` module is available), \"xztar\" (if the :mod:" -"`lzma` module is available), or \"zstdtar\" (if the :mod:`compression.zstd` " -"module is available)." +"\"bztar\" (if the :mod:`bz2` module is available), \"xztar\" (if " +"the :mod:`lzma` module is available), or \"zstdtar\" (if " +"the :mod:`compression.zstd` module is available)." msgstr "" msgid "" @@ -738,10 +754,10 @@ msgid "" msgstr "" msgid "" -"This function is not thread-safe when custom archivers registered with :func:" -"`register_archive_format` do not support the *root_dir* argument. In this " -"case it temporarily changes the current working directory of the process to " -"*root_dir* to perform archiving." +"This function is not thread-safe when custom archivers registered " +"with :func:`register_archive_format` do not support the *root_dir* " +"argument. In this case it temporarily changes the current working directory " +"of the process to *root_dir* to perform archiving." msgstr "" msgid "" @@ -792,7 +808,7 @@ msgid "Register an archiver for the format *name*." msgstr "" msgid "" -"*function* is the callable that will be used to unpack archives. The " +"*function* is the callable that will be used to create archives. The " "callable will receive the *base_name* of the file to create, followed by the " "*base_dir* (which defaults to :data:`os.curdir`) to start archiving from. " "Further arguments are passed as keyword arguments: *owner*, *group*, " @@ -833,10 +849,11 @@ msgstr "" msgid "" "*format* is the archive format: one of \"zip\", \"tar\", \"gztar\", " -"\"bztar\", \"xztar\", or \"zstdtar\". Or any other format registered with :" -"func:`register_unpack_format`. If not provided, :func:`unpack_archive` will " -"use the archive file name extension and see if an unpacker was registered " -"for that extension. In case none is found, a :exc:`ValueError` is raised." +"\"bztar\", \"xztar\", or \"zstdtar\". Or any other format registered " +"with :func:`register_unpack_format`. If not " +"provided, :func:`unpack_archive` will use the archive file name extension " +"and see if an unpacker was registered for that extension. In case none is " +"found, a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -855,8 +872,8 @@ msgstr "" msgid "" "Never extract archives from untrusted sources without prior inspection. It " "is possible that files are created outside of the path specified in the " -"*extract_dir* argument, e.g. members that have absolute filenames starting " -"with \"/\" or filenames with two dots \"..\"." +"*extract_dir* argument, for example, members that have absolute filenames or " +"filenames with \"..\" components." msgstr "" msgid "" @@ -874,8 +891,8 @@ msgstr "" msgid "" "Registers an unpack format. *name* is the name of the format and " -"*extensions* is a list of extensions corresponding to the format, like ``." -"zip`` for Zip files." +"*extensions* is a list of extensions corresponding to the format, like " +"``.zip`` for Zip files." msgstr "" msgid "" @@ -891,8 +908,8 @@ msgid "" msgstr "" msgid "" -"possibly a *filter* keyword argument, if it was given to :func:" -"`unpack_archive`;" +"possibly a *filter* keyword argument, if it was given " +"to :func:`unpack_archive`;" msgstr "" msgid "" @@ -978,8 +995,8 @@ msgid "" msgstr "" msgid "" -"In the final archive, :file:`please_add.txt` should be included, but :file:" -"`do_not_add.txt` should not. Therefore we use the following::" +"In the final archive, :file:`please_add.txt` should be included, " +"but :file:`do_not_add.txt` should not. Therefore we use the following::" msgstr "" msgid "" @@ -1021,8 +1038,8 @@ msgstr "" msgid "" "When ``COLUMNS`` or ``LINES`` is not defined, which is the common case, the " -"terminal connected to :data:`sys.__stdout__` is queried by invoking :func:" -"`os.get_terminal_size`." +"terminal connected to :data:`sys.__stdout__` is queried by " +"invoking :func:`os.get_terminal_size`." msgstr "" msgid "" diff --git a/library/signal.po b/library/signal.po index 70e04423fe..468aff229e 100644 --- a/library/signal.po +++ b/library/signal.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-05 15:48+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -47,8 +47,8 @@ msgstr "" msgid "" "A handler for a particular signal, once set, remains installed until it is " "explicitly reset (Python emulates the BSD style interface regardless of the " -"underlying implementation), with the exception of the handler for :const:" -"`SIGCHLD`, which follows the underlying implementation." +"underlying implementation), with the exception of the handler " +"for :const:`SIGCHLD`, which follows the underlying implementation." msgstr "" msgid "" @@ -69,12 +69,12 @@ msgid "" msgstr "" msgid "" -"It makes little sense to catch synchronous errors like :const:`SIGFPE` or :" -"const:`SIGSEGV` that are caused by an invalid operation in C code. Python " -"will return from the signal handler to the C code, which is likely to raise " -"the same signal again, causing Python to apparently hang. From Python 3.3 " -"onwards, you can use the :mod:`faulthandler` module to report on synchronous " -"errors." +"It makes little sense to catch synchronous errors like :const:`SIGFPE` " +"or :const:`SIGSEGV` that are caused by an invalid operation in C code. " +"Python will return from the signal handler to the C code, which is likely to " +"raise the same signal again, causing Python to apparently hang. From Python " +"3.3 onwards, you can use the :mod:`faulthandler` module to report on " +"synchronous errors." msgstr "" msgid "" @@ -115,13 +115,13 @@ msgid "Module contents" msgstr "" msgid "" -"signal (SIG*), handler (:const:`SIG_DFL`, :const:`SIG_IGN`) and sigmask (:" -"const:`SIG_BLOCK`, :const:`SIG_UNBLOCK`, :const:`SIG_SETMASK`) related " -"constants listed below were turned into :class:`enums ` (:" -"class:`Signals`, :class:`Handlers` and :class:`Sigmasks` respectively). :" -"func:`getsignal`, :func:`pthread_sigmask`, :func:`sigpending` and :func:" -"`sigwait` functions return human-readable :class:`enums ` as :" -"class:`Signals` objects." +"signal (SIG*), handler (:const:`SIG_DFL`, :const:`SIG_IGN`) and sigmask " +"(:const:`SIG_BLOCK`, :const:`SIG_UNBLOCK`, :const:`SIG_SETMASK`) related " +"constants listed below were turned into :class:`enums ` " +"(:class:`Signals`, :class:`Handlers` and :class:`Sigmasks` " +"respectively). :func:`getsignal`, :func:`pthread_sigmask`, :func:`sigpending` " +"and :func:`sigwait` functions return human-readable :class:`enums " +"` as :class:`Signals` objects." msgstr "" msgid "The signal module defines three enums:" @@ -132,13 +132,13 @@ msgid "" msgstr "" msgid "" -":class:`enum.IntEnum` collection of the constants :const:`SIG_DFL` and :" -"const:`SIG_IGN`." +":class:`enum.IntEnum` collection of the constants :const:`SIG_DFL` " +"and :const:`SIG_IGN`." msgstr "" msgid "" -":class:`enum.IntEnum` collection of the constants :const:`SIG_BLOCK`, :const:" -"`SIG_UNBLOCK` and :const:`SIG_SETMASK`." +":class:`enum.IntEnum` collection of the " +"constants :const:`SIG_BLOCK`, :const:`SIG_UNBLOCK` and :const:`SIG_SETMASK`." msgstr "" msgid "Availability" @@ -236,8 +236,8 @@ msgid "" msgstr "" msgid "" -"On architectures where the signal is available. See the man page :manpage:" -"`signal(7)` for further information." +"On architectures where the signal is available. See the man " +"page :manpage:`signal(7)` for further information." msgstr "" msgid "Termination signal." @@ -263,9 +263,10 @@ msgid "" "signal is defined as :const:`signal.SIGHUP`; the variable names are " "identical to the names used in C programs, as found in ````. The " "Unix man page for '``signal``' lists the existing signals (on some systems " -"this is :manpage:`signal(2)`, on others the list is in :manpage:" -"`signal(7)`). Note that not all systems define the same set of signal names; " -"only those names defined by the system are defined by this module." +"this is :manpage:`signal(2)`, on others the list is " +"in :manpage:`signal(7)`). Note that not all systems define the same set of " +"signal names; only those names defined by the system are defined by this " +"module." msgstr "" msgid "" @@ -279,8 +280,8 @@ msgid "" msgstr "" msgid "" -"One more than the number of the highest signal number. Use :func:" -"`valid_signals` to get valid signal numbers." +"One more than the number of the highest signal number. " +"Use :func:`valid_signals` to get valid signal numbers." msgstr "" msgid "" @@ -319,15 +320,15 @@ msgid "The :mod:`!signal` module defines one exception:" msgstr "" msgid "" -"Raised to signal an error from the underlying :func:`setitimer` or :func:" -"`getitimer` implementation. Expect this error if an invalid interval timer " -"or a negative time is passed to :func:`setitimer`. This error is a subtype " -"of :exc:`OSError`." +"Raised to signal an error from the underlying :func:`setitimer` " +"or :func:`getitimer` implementation. Expect this error if an invalid " +"interval timer or a negative time is passed to :func:`setitimer`. This error " +"is a subtype of :exc:`OSError`." msgstr "" msgid "" -"This error used to be a subtype of :exc:`IOError`, which is now an alias of :" -"exc:`OSError`." +"This error used to be a subtype of :exc:`IOError`, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "The :mod:`!signal` module defines the following functions:" @@ -348,18 +349,18 @@ msgstr "" msgid "" "Return the current signal handler for the signal *signalnum*. The returned " -"value may be a callable Python object, or one of the special values :const:" -"`signal.SIG_IGN`, :const:`signal.SIG_DFL` or :const:`None`. Here, :const:" -"`signal.SIG_IGN` means that the signal was previously ignored, :const:" -"`signal.SIG_DFL` means that the default way of handling the signal was " -"previously in use, and ``None`` means that the previous signal handler was " -"not installed from Python." +"value may be a callable Python object, or one of the special " +"values :const:`signal.SIG_IGN`, :const:`signal.SIG_DFL` or :const:`None`. " +"Here, :const:`signal.SIG_IGN` means that the signal was previously " +"ignored, :const:`signal.SIG_DFL` means that the default way of handling the " +"signal was previously in use, and ``None`` means that the previous signal " +"handler was not installed from Python." msgstr "" msgid "" -"Returns the description of signal *signalnum*, such as \"Interrupt\" for :" -"const:`SIGINT`. Returns :const:`None` if *signalnum* has no description. " -"Raises :exc:`ValueError` if *signalnum* is invalid." +"Returns the description of signal *signalnum*, such as \"Interrupt\" " +"for :const:`SIGINT`. Returns :const:`None` if *signalnum* has no " +"description. Raises :exc:`ValueError` if *signalnum* is invalid." msgstr "" msgid "" @@ -377,8 +378,8 @@ msgid "See the man page :manpage:`signal(2)` for further information." msgstr "" msgid "" -"See also :func:`sigwait`, :func:`sigwaitinfo`, :func:`sigtimedwait` and :" -"func:`sigpending`." +"See also :func:`sigwait`, :func:`sigwaitinfo`, :func:`sigtimedwait` " +"and :func:`sigpending`." msgstr "" msgid "Sends a signal to the calling process. Returns nothing." @@ -453,9 +454,9 @@ msgid "" msgstr "" msgid "" -"*mask* is a set of signal numbers (e.g. {:const:`signal.SIGINT`, :const:" -"`signal.SIGTERM`}). Use :func:`~signal.valid_signals` for a full mask " -"including all signals." +"*mask* is a set of signal numbers (e.g. " +"{:const:`signal.SIGINT`, :const:`signal.SIGTERM`}). " +"Use :func:`~signal.valid_signals` for a full mask including all signals." msgstr "" msgid "" @@ -470,27 +471,28 @@ msgid "See also :func:`pause`, :func:`sigpending` and :func:`sigwait`." msgstr "" msgid "" -"Sets given interval timer (one of :const:`signal.ITIMER_REAL`, :const:" -"`signal.ITIMER_VIRTUAL` or :const:`signal.ITIMER_PROF`) specified by *which* " -"to fire after *seconds* (float is accepted, different from :func:`alarm`) " -"and after that every *interval* seconds (if *interval* is non-zero). The " -"interval timer specified by *which* can be cleared by setting *seconds* to " -"zero." +"Sets given interval timer (one " +"of :const:`signal.ITIMER_REAL`, :const:`signal.ITIMER_VIRTUAL` " +"or :const:`signal.ITIMER_PROF`) specified by *which* to fire after *seconds* " +"(float is accepted, different from :func:`alarm`) and after that every " +"*interval* seconds (if *interval* is non-zero). The interval timer specified " +"by *which* can be cleared by setting *seconds* to zero." msgstr "" msgid "" "When an interval timer fires, a signal is sent to the process. The signal " "sent is dependent on the timer being used; :const:`signal.ITIMER_REAL` will " -"deliver :const:`SIGALRM`, :const:`signal.ITIMER_VIRTUAL` sends :const:" -"`SIGVTALRM`, and :const:`signal.ITIMER_PROF` will deliver :const:`SIGPROF`." +"deliver :const:`SIGALRM`, :const:`signal.ITIMER_VIRTUAL` " +"sends :const:`SIGVTALRM`, and :const:`signal.ITIMER_PROF` will " +"deliver :const:`SIGPROF`." msgstr "" msgid "The old values are returned as a tuple: (delay, interval)." msgstr "" msgid "" -"Attempting to pass an invalid interval timer will cause an :exc:" -"`ItimerError`." +"Attempting to pass an invalid interval timer will cause " +"an :exc:`ItimerError`." msgstr "" msgid "Returns current value of a given interval timer specified by *which*." @@ -560,8 +562,8 @@ msgid "See the man page :manpage:`siginterrupt(3)` for further information." msgstr "" msgid "" -"Note that installing a signal handler with :func:`signal` will reset the " -"restart behaviour to interruptible by implicitly calling :c:func:`!" +"Note that installing a signal handler with :func:`~signal.signal` will reset " +"the restart behaviour to interruptible by implicitly calling :c:func:`!" "siginterrupt` with a true *flag* value for the given signal." msgstr "" @@ -569,9 +571,9 @@ msgid "" "Set the handler for signal *signalnum* to the function *handler*. *handler* " "can be a callable Python object taking two arguments (see below), or one of " "the special values :const:`signal.SIG_IGN` or :const:`signal.SIG_DFL`. The " -"previous signal handler will be returned (see the description of :func:" -"`getsignal` above). (See the Unix man page :manpage:`signal(2)` for further " -"information.)" +"previous signal handler will be returned (see the description " +"of :func:`getsignal` above). (See the Unix man page :manpage:`signal(2)` " +"for further information.)" msgstr "" msgid "" @@ -582,10 +584,10 @@ msgid "" msgstr "" msgid "" -"On Windows, :func:`signal` can only be called with :const:`SIGABRT`, :const:" -"`SIGFPE`, :const:`SIGILL`, :const:`SIGINT`, :const:`SIGSEGV`, :const:" -"`SIGTERM`, or :const:`SIGBREAK`. A :exc:`ValueError` will be raised in any " -"other case. Note that not all systems define the same set of signal names; " +"On Windows, :func:`~signal.signal` can only be called " +"with :const:`SIGABRT`, :const:`SIGFPE`, :const:`SIGILL`, :const:`SIGINT`, :const:`SIGSEGV`, :const:`SIGTERM`, " +"or :const:`SIGBREAK`. A :exc:`ValueError` will be raised in any other case. " +"Note that not all systems define the same set of signal names; " "an :exc:`AttributeError` will be raised if a signal name is not defined as " "``SIG*`` module level constant." msgstr "" @@ -613,8 +615,9 @@ msgid "See the man page :manpage:`sigwait(3)` for further information." msgstr "" msgid "" -"See also :func:`pause`, :func:`pthread_sigmask`, :func:`sigpending`, :func:" -"`sigwaitinfo` and :func:`sigtimedwait`." +"See " +"also :func:`pause`, :func:`pthread_sigmask`, :func:`sigpending`, :func:`sigwaitinfo` " +"and :func:`sigtimedwait`." msgstr "" msgid "" @@ -623,8 +626,9 @@ msgid "" "signal and removes it from the pending list of signals. If one of the " "signals in *sigset* is already pending for the calling thread, the function " "will return immediately with information about that signal. The signal " -"handler is not called for the delivered signal. The function raises an :exc:" -"`InterruptedError` if it is interrupted by a signal that is not in *sigset*." +"handler is not called for the delivered signal. The function raises " +"an :exc:`InterruptedError` if it is interrupted by a signal that is not in " +"*sigset*." msgstr "" msgid "" @@ -697,11 +701,11 @@ msgid "Note on SIGPIPE" msgstr "" msgid "" -"Piping output of your program to tools like :manpage:`head(1)` will cause a :" -"const:`SIGPIPE` signal to be sent to your process when the receiver of its " -"standard output closes early. This results in an exception like :code:" -"`BrokenPipeError: [Errno 32] Broken pipe`. To handle this case, wrap your " -"entry point to catch this exception as follows::" +"Piping output of your program to tools like :manpage:`head(1)` will cause " +"a :const:`SIGPIPE` signal to be sent to your process when the receiver of " +"its standard output closes early. This results in an exception " +"like :code:`BrokenPipeError: [Errno 32] Broken pipe`. To handle this case, " +"wrap your entry point to catch this exception as follows::" msgstr "" msgid "" @@ -769,9 +773,9 @@ msgid "" msgstr "" msgid "" -"For many programs, especially those that merely want to exit on :exc:" -"`KeyboardInterrupt`, this is not a problem, but applications that are " -"complex or require high reliability should avoid raising exceptions from " +"For many programs, especially those that merely want to exit " +"on :exc:`KeyboardInterrupt`, this is not a problem, but applications that " +"are complex or require high reliability should avoid raising exceptions from " "signal handlers. They should also avoid catching :exc:`KeyboardInterrupt` as " "a means of gracefully shutting down. Instead, they should install their " "own :const:`SIGINT` handler. Below is an example of an HTTP server that " diff --git a/library/site.po b/library/site.po index d95fd95810..f41ad44fd4 100644 --- a/library/site.po +++ b/library/site.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -46,8 +47,8 @@ msgid "" msgstr "" msgid "" -"Importing the module used to trigger paths manipulation even when using :" -"option:`-S`." +"Importing the module used to trigger paths manipulation even when " +"using :option:`-S`." msgstr "" msgid "" @@ -73,12 +74,12 @@ msgid "" msgstr "" msgid "" -":mod:`!site` is no longer responsible for updating :data:`sys.prefix` and :" -"data:`sys.exec_prefix` on :ref:`sys-path-init-virtual-environments`. This is " -"now done during the :ref:`path initialization `. As a result, " -"under :ref:`sys-path-init-virtual-environments`, :data:`sys.prefix` and :" -"data:`sys.exec_prefix` no longer depend on the :mod:`!site` initialization, " -"and are therefore unaffected by :option:`-S`." +":mod:`!site` is no longer responsible for updating :data:`sys.prefix` " +"and :data:`sys.exec_prefix` on :ref:`sys-path-init-virtual-environments`. " +"This is now done during the :ref:`path initialization `. As a " +"result, under :ref:`sys-path-init-virtual-environments`, :data:`sys.prefix` " +"and :data:`sys.exec_prefix` no longer depend on the :mod:`!site` " +"initialization, and are therefore unaffected by :option:`-S`." msgstr "" msgid "" @@ -90,14 +91,14 @@ msgid "" msgstr "" msgid "" -"A path configuration file is a file whose name has the form :file:`{name}." -"pth` and exists in one of the four directories mentioned above; its contents " -"are additional items (one per line) to be added to ``sys.path``. Non-" -"existing items are never added to ``sys.path``, and no check is made that " -"the item refers to a directory rather than a file. No item is added to " -"``sys.path`` more than once. Blank lines and lines beginning with ``#`` are " -"skipped. Lines starting with ``import`` (followed by space or tab) are " -"executed." +"A path configuration file is a file whose name has the " +"form :file:`{name}.pth` and exists in one of the four directories mentioned " +"above; its contents are additional items (one per line) to be added to " +"``sys.path``. Non-existing items are never added to ``sys.path``, and no " +"check is made that the item refers to a directory rather than a file. No " +"item is added to ``sys.path`` more than once. Blank lines and lines " +"beginning with ``#`` are skipped. Lines starting with ``import`` (followed " +"by space or tab) are executed." msgstr "" msgid "" @@ -112,17 +113,18 @@ msgid "" msgstr "" msgid "" -"The :file:`.pth` files are now decoded by UTF-8 at first and then by the :" -"term:`locale encoding` if it fails." +"The :file:`.pth` files are now decoded by UTF-8 at first and then by " +"the :term:`locale encoding` if it fails." msgstr "" msgid "" -"For example, suppose ``sys.prefix`` and ``sys.exec_prefix`` are set to :file:" -"`/usr/local`. The Python X.Y library is then installed in :file:`/usr/local/" -"lib/python{X.Y}`. Suppose this has a subdirectory :file:`/usr/local/lib/" -"python{X.Y}/site-packages` with three subsubdirectories, :file:`foo`, :file:" -"`bar` and :file:`spam`, and two path configuration files, :file:`foo.pth` " -"and :file:`bar.pth`. Assume :file:`foo.pth` contains the following::" +"For example, suppose ``sys.prefix`` and ``sys.exec_prefix`` are set " +"to :file:`/usr/local`. The Python X.Y library is then installed in :file:`/" +"usr/local/lib/python{X.Y}`. Suppose this has a subdirectory :file:`/usr/" +"local/lib/python{X.Y}/site-packages` with three " +"subsubdirectories, :file:`foo`, :file:`bar` and :file:`spam`, and two path " +"configuration files, :file:`foo.pth` and :file:`bar.pth`. " +"Assume :file:`foo.pth` contains the following::" msgstr "" msgid "" @@ -153,26 +155,27 @@ msgid "" msgstr "" msgid "" -"Note that :file:`bletch` is omitted because it doesn't exist; the :file:" -"`bar` directory precedes the :file:`foo` directory because :file:`bar.pth` " -"comes alphabetically before :file:`foo.pth`; and :file:`spam` is omitted " -"because it is not mentioned in either path configuration file." +"Note that :file:`bletch` is omitted because it doesn't exist; " +"the :file:`bar` directory precedes the :file:`foo` directory " +"because :file:`bar.pth` comes alphabetically before :file:`foo.pth`; " +"and :file:`spam` is omitted because it is not mentioned in either path " +"configuration file." msgstr "" msgid ":mod:`!sitecustomize`" msgstr "" msgid "" -"After these path manipulations, an attempt is made to import a module named :" -"mod:`!sitecustomize`, which can perform arbitrary site-specific " +"After these path manipulations, an attempt is made to import a module " +"named :mod:`!sitecustomize`, which can perform arbitrary site-specific " "customizations. It is typically created by a system administrator in the " "site-packages directory. If this import fails with an :exc:`ImportError` or " "its subclass exception, and the exception's :attr:`~ImportError.name` " "attribute equals ``'sitecustomize'``, it is silently ignored. If Python is " "started without output streams available, as with :file:`pythonw.exe` on " -"Windows (which is used by default to start IDLE), attempted output from :mod:" -"`!sitecustomize` is ignored. Any other exception causes a silent and " -"perhaps mysterious failure of the process." +"Windows (which is used by default to start IDLE), attempted output " +"from :mod:`!sitecustomize` is ignored. Any other exception causes a silent " +"and perhaps mysterious failure of the process." msgstr "" msgid ":mod:`!usercustomize`" @@ -183,16 +186,16 @@ msgid "" "usercustomize`, which can perform arbitrary user-specific customizations, " "if :data:`~site.ENABLE_USER_SITE` is true. This file is intended to be " "created in the user site-packages directory (see below), which is part of " -"``sys.path`` unless disabled by :option:`-s`. If this import fails with an :" -"exc:`ImportError` or its subclass exception, and the exception's :attr:" -"`~ImportError.name` attribute equals ``'usercustomize'``, it is silently " -"ignored." +"``sys.path`` unless disabled by :option:`-s`. If this import fails with " +"an :exc:`ImportError` or its subclass exception, and the " +"exception's :attr:`~ImportError.name` attribute equals ``'usercustomize'``, " +"it is silently ignored." msgstr "" msgid "" "Note that for some non-Unix systems, ``sys.prefix`` and ``sys.exec_prefix`` " -"are empty, and the path manipulations are skipped; however the import of :" -"mod:`sitecustomize` and :mod:`!usercustomize` is still attempted." +"are empty, and the path manipulations are skipped; however the import " +"of :mod:`sitecustomize` and :mod:`!usercustomize` is still attempted." msgstr "" msgid "Readline configuration" @@ -200,13 +203,13 @@ msgstr "" msgid "" "On systems that support :mod:`readline`, this module will also import and " -"configure the :mod:`rlcompleter` module, if Python is started in :ref:" -"`interactive mode ` and without the :option:`-S` option. " -"The default behavior is to enable tab completion and to use :file:`~/." -"python_history` as the history save file. To disable it, delete (or " -"override) the :data:`sys.__interactivehook__` attribute in your :mod:" -"`sitecustomize` or :mod:`usercustomize` module or your :envvar:" -"`PYTHONSTARTUP` file." +"configure the :mod:`rlcompleter` module, if Python is started " +"in :ref:`interactive mode ` and without the :option:`-S` " +"option. The default behavior is to enable tab completion and to " +"use :file:`~/.python_history` as the history save file. To disable it, " +"delete (or override) the :data:`sys.__interactivehook__` attribute in " +"your :mod:`sitecustomize` or :mod:`usercustomize` module or " +"your :envvar:`PYTHONSTARTUP` file." msgstr "" msgid "Activation of rlcompleter and history was made automatic." @@ -221,30 +224,32 @@ msgstr "" msgid "" "Flag showing the status of the user site-packages directory. ``True`` means " "that it is enabled and was added to ``sys.path``. ``False`` means that it " -"was disabled by user request (with :option:`-s` or :envvar:" -"`PYTHONNOUSERSITE`). ``None`` means it was disabled for security reasons " -"(mismatch between user or group id and effective id) or by an administrator." +"was disabled by user request (with :option:`-s` " +"or :envvar:`PYTHONNOUSERSITE`). ``None`` means it was disabled for security " +"reasons (mismatch between user or group id and effective id) or by an " +"administrator." msgstr "" msgid "" -"Path to the user site-packages for the running Python. Can be ``None`` if :" -"func:`getusersitepackages` hasn't been called yet. Default value is :file:" -"`~/.local/lib/python{X.Y}[t]/site-packages` for UNIX and non-framework macOS " -"builds, :file:`~/Library/Python/{X.Y}/lib/python/site-packages` for macOS " -"framework builds, and :file:`{%APPDATA%}\\\\Python\\\\Python{XY}\\\\site-" -"packages` on Windows. The optional \"t\" indicates the free-threaded " -"build. This directory is a site directory, which means that :file:`.pth` " -"files in it will be processed." +"Path to the user site-packages for the running Python. Can be ``None`` " +"if :func:`getusersitepackages` hasn't been called yet. Default value " +"is :file:`~/.local/lib/python{X.Y}[t]/site-packages` for UNIX and non-" +"framework macOS builds, :file:`~/Library/Python/{X.Y}/lib/python/site-" +"packages` for macOS framework builds, and :file:`{%APPDATA%}\\\\Python\\" +"\\Python{XY}\\\\site-packages` on Windows. The optional \"t\" indicates the " +"free-threaded build. This directory is a site directory, which means " +"that :file:`.pth` files in it will be processed." msgstr "" msgid "" -"Path to the base directory for the user site-packages. Can be ``None`` if :" -"func:`getuserbase` hasn't been called yet. Default value is :file:`~/." -"local` for UNIX and macOS non-framework builds, :file:`~/Library/Python/{X.Y}" -"` for macOS framework builds, and :file:`{%APPDATA%}\\\\Python` for " -"Windows. This value is used to compute the installation directories for " -"scripts, data files, Python modules, etc. for the :ref:`user installation " -"scheme `. See also :envvar:`PYTHONUSERBASE`." +"Path to the base directory for the user site-packages. Can be ``None`` " +"if :func:`getuserbase` hasn't been called yet. Default value " +"is :file:`~/.local` for UNIX and macOS non-framework builds, :file:`~/" +"Library/Python/{X.Y}` for macOS framework builds, and :file:`{%APPDATA%}\\" +"\\Python` for Windows. This value is used to compute the installation " +"directories for scripts, data files, Python modules, etc. for the :ref:`user " +"installation scheme `. See " +"also :envvar:`PYTHONUSERBASE`." msgstr "" msgid "" @@ -264,21 +269,32 @@ msgstr "" msgid "Return a list containing all global site-packages directories." msgstr "" +msgid "" +"For each directory given in *prefixes* (or :data:`PREFIXES` if *prefixes* is " +"``None``), this function will compute its site-packages subdirectory " +"depending on the system environment, and will return a list of full paths, " +"which are not checked for existence." +msgstr "" + +msgid "Added the optional *prefixes* parameter." +msgstr "" + msgid "" "Return the path of the user base directory, :data:`USER_BASE`. If it is not " -"initialized yet, this function will also set it, respecting :envvar:" -"`PYTHONUSERBASE`." +"initialized yet, this function will also set it, " +"respecting :envvar:`PYTHONUSERBASE`." msgstr "" msgid "" -"Return the path of the user-specific site-packages directory, :data:" -"`USER_SITE`. If it is not initialized yet, this function will also set it, " -"respecting :data:`USER_BASE`. To determine if the user-specific site-" -"packages was added to ``sys.path`` :data:`ENABLE_USER_SITE` should be used." +"Return the path of the user-specific site-packages " +"directory, :data:`USER_SITE`. If it is not initialized yet, this function " +"will also set it, respecting :data:`USER_BASE`. To determine if the user-" +"specific site-packages was added to ``sys.path`` :data:`ENABLE_USER_SITE` " +"should be used." msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The :mod:`!site` module also provides a way to get the user directories from " @@ -293,10 +309,10 @@ msgstr "" "/home/user/.local/lib/python3.11/site-packages" msgid "" -"If it is called without arguments, it will print the contents of :data:`sys." -"path` on the standard output, followed by the value of :data:`USER_BASE` and " -"whether the directory exists, then the same thing for :data:`USER_SITE`, and " -"finally the value of :data:`ENABLE_USER_SITE`." +"If it is called without arguments, it will print the contents " +"of :data:`sys.path` on the standard output, followed by the value " +"of :data:`USER_BASE` and whether the directory exists, then the same thing " +"for :data:`USER_SITE`, and finally the value of :data:`ENABLE_USER_SITE`." msgstr "" msgid "Print the path to the user base directory." diff --git a/library/smtplib.po b/library/smtplib.po index 7ab93d4d4f..1e6547df82 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -50,28 +50,30 @@ msgid "" "*host* and *port* parameters are given, the SMTP :meth:`connect` method is " "called with those parameters during initialization. If specified, " "*local_hostname* is used as the FQDN of the local host in the HELO/EHLO " -"command. Otherwise, the local hostname is found using :func:`socket." -"getfqdn`. If the :meth:`connect` call returns anything other than a success " -"code, an :exc:`SMTPConnectError` is raised. The optional *timeout* parameter " -"specifies a timeout in seconds for blocking operations like the connection " -"attempt (if not specified, the global default timeout setting will be " -"used). If the timeout expires, :exc:`TimeoutError` is raised. The optional " -"*source_address* parameter allows binding to some specific source address in " -"a machine with multiple network interfaces, and/or to some specific source " -"TCP port. It takes a 2-tuple ``(host, port)``, for the socket to bind to as " -"its source address before connecting. If omitted (or if *host* or *port* are " -"``''`` and/or ``0`` respectively) the OS default behavior will be used." +"command. Otherwise, the local hostname is found " +"using :func:`socket.getfqdn`. If the :meth:`connect` call returns anything " +"other than a success code, an :exc:`SMTPConnectError` is raised. The " +"optional *timeout* parameter specifies a timeout in seconds for blocking " +"operations like the connection attempt (if not specified, the global default " +"timeout setting will be used). If the timeout expires, :exc:`TimeoutError` " +"is raised. The optional *source_address* parameter allows binding to some " +"specific source address in a machine with multiple network interfaces, and/" +"or to some specific source TCP port. It takes a 2-tuple ``(host, port)``, " +"for the socket to bind to as its source address before connecting. If " +"omitted (or if *host* or *port* are ``''`` and/or ``0`` respectively) the OS " +"default behavior will be used." msgstr "" msgid "" -"For normal use, you should only require the initialization/connect, :meth:" -"`sendmail`, and :meth:`SMTP.quit` methods. An example is included below." +"For normal use, you should only require the initialization/" +"connect, :meth:`sendmail`, and :meth:`SMTP.quit` methods. An example is " +"included below." msgstr "" msgid "" "The :class:`SMTP` class supports the :keyword:`with` statement. When used " -"like this, the SMTP ``QUIT`` command is issued automatically when the :" -"keyword:`!with` statement exits. E.g.::" +"like this, the SMTP ``QUIT`` command is issued automatically when " +"the :keyword:`!with` statement exits. E.g.::" msgstr "" msgid "" @@ -84,9 +86,9 @@ msgid "" msgstr "" msgid "" -"All commands will raise an :ref:`auditing event ` ``smtplib.SMTP." -"send`` with arguments ``self`` and ``data``, where ``data`` is the bytes " -"about to be sent to the remote host." +"All commands will raise an :ref:`auditing event ` " +"``smtplib.SMTP.send`` with arguments ``self`` and ``data``, where ``data`` " +"is the bytes about to be sent to the remote host." msgstr "" msgid "Support for the :keyword:`with` statement was added." @@ -99,21 +101,21 @@ msgid "The SMTPUTF8 extension (:rfc:`6531`) is now supported." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket." +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket." msgstr "" msgid "" -"An :class:`SMTP_SSL` instance behaves exactly the same as instances of :" -"class:`SMTP`. :class:`SMTP_SSL` should be used for situations where SSL is " -"required from the beginning of the connection and using :meth:`~SMTP." -"starttls` is not appropriate. If *host* is not specified, the local host is " -"used. If *port* is zero, the standard SMTP-over-SSL port (465) is used. The " -"optional arguments *local_hostname*, *timeout* and *source_address* have the " -"same meaning as they do in the :class:`SMTP` class. *context*, also " -"optional, can contain a :class:`~ssl.SSLContext` and allows configuring " -"various aspects of the secure connection. Please read :ref:`ssl-security` " -"for best practices." +"An :class:`SMTP_SSL` instance behaves exactly the same as instances " +"of :class:`SMTP`. :class:`SMTP_SSL` should be used for situations where SSL " +"is required from the beginning of the connection and " +"using :meth:`~SMTP.starttls` is not appropriate. If *host* is not specified, " +"the local host is used. If *port* is zero, the standard SMTP-over-SSL port " +"(465) is used. The optional arguments *local_hostname*, *timeout* and " +"*source_address* have the same meaning as they do in the :class:`SMTP` " +"class. *context*, also optional, can contain a :class:`~ssl.SSLContext` and " +"allows configuring various aspects of the secure connection. Please " +"read :ref:`ssl-security` for best practices." msgstr "" msgid "*context* was added." @@ -123,13 +125,14 @@ msgid "The *source_address* argument was added." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket" +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket" msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -137,11 +140,12 @@ msgstr "" msgid "" "The LMTP protocol, which is very similar to ESMTP, is heavily based on the " -"standard SMTP client. It's common to use Unix sockets for LMTP, so our :meth:" -"`~SMTP.connect` method must support that as well as a regular host:port " -"server. The optional arguments *local_hostname* and *source_address* have " -"the same meaning as they do in the :class:`SMTP` class. To specify a Unix " -"socket, you must use an absolute path for *host*, starting with a '/'." +"standard SMTP client. It's common to use Unix sockets for LMTP, so " +"our :meth:`~SMTP.connect` method must support that as well as a regular " +"host:port server. The optional arguments *local_hostname* and " +"*source_address* have the same meaning as they do in the :class:`SMTP` " +"class. To specify a Unix socket, you must use an absolute path for *host*, " +"starting with a '/'." msgstr "" msgid "" @@ -183,9 +187,9 @@ msgid "The error message." msgstr "" msgid "" -"Sender address refused. In addition to the attributes set by on all :exc:" -"`SMTPResponseException` exceptions, this sets 'sender' to the string that " -"the SMTP server refused." +"Sender address refused. In addition to the attributes set by on " +"all :exc:`SMTPResponseException` exceptions, this sets 'sender' to the " +"string that the SMTP server refused." msgstr "" msgid "All recipient addresses refused." @@ -263,8 +267,8 @@ msgid "" msgstr "" msgid "" -"If the connection to the server is lost while waiting for the reply, :exc:" -"`SMTPServerDisconnected` will be raised." +"If the connection to the server is lost while waiting for the " +"reply, :exc:`SMTPServerDisconnected` will be raised." msgstr "" msgid "" @@ -301,9 +305,9 @@ msgid "" "response for ESMTP option and store them for use by :meth:`has_extn`. Also " "sets several informational attributes: the message returned by the server is " "stored as the :attr:`ehlo_resp` attribute, :attr:`does_esmtp` is set to " -"``True`` or ``False`` depending on whether the server supports ESMTP, and :" -"attr:`esmtp_features` will be a dictionary containing the names of the SMTP " -"service extensions this server supports, and their parameters (if any)." +"``True`` or ``False`` depending on whether the server supports ESMTP, " +"and :attr:`esmtp_features` will be a dictionary containing the names of the " +"SMTP service extensions this server supports, and their parameters (if any)." msgstr "" msgid "" @@ -422,10 +426,10 @@ msgstr "" msgid "" "The ``SMTP`` class provides ``authobjects`` for the ``CRAM-MD5``, ``PLAIN``, " -"and ``LOGIN`` mechanisms; they are named ``SMTP.auth_cram_md5``, ``SMTP." -"auth_plain``, and ``SMTP.auth_login`` respectively. They all require that " -"the ``user`` and ``password`` properties of the ``SMTP`` instance are set to " -"appropriate values." +"and ``LOGIN`` mechanisms; they are named ``SMTP.auth_cram_md5``, " +"``SMTP.auth_plain``, and ``SMTP.auth_login`` respectively. They all require " +"that the ``user`` and ``password`` properties of the ``SMTP`` instance are " +"set to appropriate values." msgstr "" msgid "" @@ -443,8 +447,8 @@ msgid "" msgstr "" msgid "" -"If *keyfile* and *certfile* are provided, they are used to create an :class:" -"`ssl.SSLContext`." +"If *keyfile* and *certfile* are provided, they are used to create " +"an :class:`ssl.SSLContext`." msgstr "" msgid "" @@ -468,13 +472,15 @@ msgid "SSL/TLS support is not available to your Python interpreter." msgstr "" msgid "" -"The method now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indicator* (see :const:`~ssl.HAS_SNI`)." +"The method now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indicator* " +"(see :const:`~ssl.HAS_SNI`)." msgstr "" msgid "" -"The error raised for lack of STARTTLS support is now the :exc:" -"`SMTPNotSupportedError` subclass instead of the base :exc:`SMTPException`." +"The error raised for lack of STARTTLS support is now " +"the :exc:`SMTPNotSupportedError` subclass instead of the " +"base :exc:`SMTPException`." msgstr "" msgid "" @@ -485,10 +491,10 @@ msgid "" "commands as *mail_options*. ESMTP options (such as ``DSN`` commands) that " "should be used with all ``RCPT`` commands can be passed as *rcpt_options*. " "Each option should be passed as a string containing the full text of the " -"option, including any potential key (for instance, ``\"NOTIFY=SUCCESS," -"FAILURE\"``). (If you need to use different ESMTP options to different " -"recipients you have to use the low-level methods such as :meth:`!mail`, :" -"meth:`!rcpt` and :meth:`!data` to send the message.)" +"option, including any potential key (for instance, " +"``\"NOTIFY=SUCCESS,FAILURE\"``). (If you need to use different ESMTP options " +"to different recipients you have to use the low-level methods such " +"as :meth:`!mail`, :meth:`!rcpt` and :meth:`!data` to send the message.)" msgstr "" msgid "" @@ -579,27 +585,28 @@ msgid "" "those arguments with addresses extracted from the headers of *msg* as " "specified in :rfc:`5322`\\: *from_addr* is set to the :mailheader:`Sender` " "field if it is present, and otherwise to the :mailheader:`From` field. " -"*to_addrs* combines the values (if any) of the :mailheader:`To`, :mailheader:" -"`Cc`, and :mailheader:`Bcc` fields from *msg*. If exactly one set of :" -"mailheader:`Resent-*` headers appear in the message, the regular headers are " -"ignored and the :mailheader:`Resent-*` headers are used instead. If the " -"message contains more than one set of :mailheader:`Resent-*` headers, a :exc:" -"`ValueError` is raised, since there is no way to unambiguously detect the " -"most recent set of :mailheader:`Resent-` headers." -msgstr "" - -msgid "" -"``send_message`` serializes *msg* using :class:`~email.generator." -"BytesGenerator` with ``\\r\\n`` as the *linesep*, and calls :meth:`sendmail` " -"to transmit the resulting message. Regardless of the values of *from_addr* " -"and *to_addrs*, ``send_message`` does not transmit any :mailheader:`Bcc` or :" -"mailheader:`Resent-Bcc` headers that may appear in *msg*. If any of the " -"addresses in *from_addr* and *to_addrs* contain non-ASCII characters and the " -"server does not advertise ``SMTPUTF8`` support, an :exc:" -"`SMTPNotSupportedError` is raised. Otherwise the ``Message`` is serialized " -"with a clone of its :mod:`~email.policy` with the :attr:`~email.policy." -"EmailPolicy.utf8` attribute set to ``True``, and ``SMTPUTF8`` and " -"``BODY=8BITMIME`` are added to *mail_options*." +"*to_addrs* combines the values (if any) of " +"the :mailheader:`To`, :mailheader:`Cc`, and :mailheader:`Bcc` fields from " +"*msg*. If exactly one set of :mailheader:`Resent-*` headers appear in the " +"message, the regular headers are ignored and the :mailheader:`Resent-*` " +"headers are used instead. If the message contains more than one set " +"of :mailheader:`Resent-*` headers, a :exc:`ValueError` is raised, since " +"there is no way to unambiguously detect the most recent set " +"of :mailheader:`Resent-` headers." +msgstr "" + +msgid "" +"``send_message`` serializes *msg* " +"using :class:`~email.generator.BytesGenerator` with ``\\r\\n`` as the " +"*linesep*, and calls :meth:`sendmail` to transmit the resulting message. " +"Regardless of the values of *from_addr* and *to_addrs*, ``send_message`` " +"does not transmit any :mailheader:`Bcc` or :mailheader:`Resent-Bcc` headers " +"that may appear in *msg*. If any of the addresses in *from_addr* and " +"*to_addrs* contain non-ASCII characters and the server does not advertise " +"``SMTPUTF8`` support, an :exc:`SMTPNotSupportedError` is raised. Otherwise " +"the ``Message`` is serialized with a clone of its :mod:`~email.policy` with " +"the :attr:`~email.policy.EmailPolicy.utf8` attribute set to ``True``, and " +"``SMTPUTF8`` and ``BODY=8BITMIME`` are added to *mail_options*." msgstr "" msgid "Support for internationalized addresses (``SMTPUTF8``)." @@ -627,8 +634,8 @@ msgid "The response to the ``EHLO`` command, see :meth:`ehlo`." msgstr "" msgid "" -"A boolean value indicating whether the server supports ESMTP, see :meth:" -"`ehlo`." +"A boolean value indicating whether the server supports ESMTP, " +"see :meth:`ehlo`." msgstr "" msgid "" @@ -679,8 +686,8 @@ msgstr "" msgid "" "In general, you will want to use the :mod:`email` package's features to " -"construct an email message, which you can then send via :meth:`~smtplib.SMTP." -"send_message`; see :ref:`email-examples`." +"construct an email message, which you can then send " +"via :meth:`~smtplib.SMTP.send_message`; see :ref:`email-examples`." msgstr "" msgid "SMTP" diff --git a/library/socket.po b/library/socket.po index 7c2491672b..8aa4553f3b 100644 --- a/library/socket.po +++ b/library/socket.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -53,8 +53,8 @@ msgid "" "call and library interface for sockets to Python's object-oriented style: " "the :func:`~socket.socket` function returns a :dfn:`socket object` whose " "methods implement the various socket system calls. Parameter types are " -"somewhat higher-level than in the C interface: as with :meth:`read` and :" -"meth:`write` operations on Python files, buffer allocation on receive " +"somewhat higher-level than in the C interface: as with :meth:`read` " +"and :meth:`write` operations on Python files, buffer allocation on receive " "operations is automatic, and buffer length is implicit on send operations." msgstr "" @@ -112,10 +112,10 @@ msgstr "" msgid "" "For IPv4 addresses, two special forms are accepted instead of a host " "address: ``''`` represents :const:`INADDR_ANY`, which is used to bind to all " -"interfaces, and the string ``''`` represents :const:" -"`INADDR_BROADCAST`. This behavior is not compatible with IPv6, therefore, " -"you may want to avoid these if you intend to support IPv6 with your Python " -"programs." +"interfaces, and the string ``''`` " +"represents :const:`INADDR_BROADCAST`. This behavior is not compatible with " +"IPv6, therefore, you may want to avoid these if you intend to support IPv6 " +"with your Python programs." msgstr "" msgid "" @@ -219,9 +219,9 @@ msgid "" msgstr "" msgid "" -"``bdaddr_type`` is an optional integer specifying the address type; one of :" -"const:`BDADDR_BREDR` (default), :const:`BDADDR_LE_PUBLIC`, :const:" -"`BDADDR_LE_RANDOM`." +"``bdaddr_type`` is an optional integer specifying the address type; one " +"of :const:`BDADDR_BREDR` " +"(default), :const:`BDADDR_LE_PUBLIC`, :const:`BDADDR_LE_RANDOM`." msgstr "" msgid "Added ``cid`` and ``bdaddr_type`` fields." @@ -238,8 +238,8 @@ msgstr "" msgid "" "On Linux it accepts an integer ``device_id`` or a tuple ``(device_id, " "[channel])`` where ``device_id`` specifies the number of the Bluetooth " -"device, and ``channel`` is an optional integer specifying the HCI channel (:" -"const:`HCI_CHANNEL_RAW` by default)." +"device, and ``channel`` is an optional integer specifying the HCI channel " +"(:const:`HCI_CHANNEL_RAW` by default)." msgstr "" msgid "" @@ -421,8 +421,8 @@ msgstr "" msgid "" "Non-blocking mode is supported through :meth:`~socket.setblocking`. A " -"generalization of this based on timeouts is supported through :meth:`~socket." -"settimeout`." +"generalization of this based on timeouts is supported " +"through :meth:`~socket.settimeout`." msgstr "" msgid "Module contents" @@ -442,11 +442,12 @@ msgstr "" msgid "" "A subclass of :exc:`OSError`, this exception is raised for address-related " -"errors, i.e. for functions that use *h_errno* in the POSIX C API, including :" -"func:`gethostbyname_ex` and :func:`gethostbyaddr`. The accompanying value is " -"a pair ``(h_errno, string)`` representing an error returned by a library " -"call. *h_errno* is a numeric value, while *string* represents the " -"description of *h_errno*, as returned by the :c:func:`hstrerror` C function." +"errors, i.e. for functions that use *h_errno* in the POSIX C API, " +"including :func:`gethostbyname_ex` and :func:`gethostbyaddr`. The " +"accompanying value is a pair ``(h_errno, string)`` representing an error " +"returned by a library call. *h_errno* is a numeric value, while *string* " +"represents the description of *h_errno*, as returned by " +"the :c:func:`hstrerror` C function." msgstr "" msgid "This class was made a subclass of :exc:`OSError`." @@ -466,10 +467,10 @@ msgstr "" msgid "" "A subclass of :exc:`OSError`, this exception is raised when a timeout occurs " -"on a socket which has had timeouts enabled via a prior call to :meth:" -"`~socket.settimeout` (or implicitly through :func:`~socket." -"setdefaulttimeout`). The accompanying value is a string whose value is " -"currently always \"timed out\"." +"on a socket which has had timeouts enabled via a prior call " +"to :meth:`~socket.settimeout` (or implicitly " +"through :func:`~socket.setdefaulttimeout`). The accompanying value is a " +"string whose value is currently always \"timed out\"." msgstr "" msgid "This class was made an alias of :exc:`TimeoutError`." @@ -479,8 +480,8 @@ msgid "Constants" msgstr "Stały" msgid "" -"The AF_* and SOCK_* constants are now :class:`AddressFamily` and :class:" -"`SocketKind` :class:`.IntEnum` collections." +"The AF_* and SOCK_* constants are now :class:`AddressFamily` " +"and :class:`SocketKind` :class:`.IntEnum` collections." msgstr "" msgid "" @@ -497,8 +498,8 @@ msgid "" msgstr "" msgid "" -"These constants represent the socket types, used for the second argument to :" -"func:`~socket.socket`. More constants may be available depending on the " +"These constants represent the socket types, used for the second argument " +"to :func:`~socket.socket`. More constants may be available depending on the " "system. (Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be " "generally useful.)" msgstr "" @@ -510,17 +511,17 @@ msgid "" msgstr "" msgid "" -"`Secure File Descriptor Handling `_ for a more thorough explanation." +"`Secure File Descriptor Handling `_ for a more thorough explanation." msgstr "" msgid "" "Many constants of these forms, documented in the Unix documentation on " "sockets and/or the IP protocol, are also defined in the socket module. They " -"are generally used in arguments to the :meth:`~socket.setsockopt` and :meth:" -"`~socket.getsockopt` methods of socket objects. In most cases, only those " -"symbols that are defined in the Unix header files are defined; for a few " -"symbols, default values are provided." +"are generally used in arguments to the :meth:`~socket.setsockopt` " +"and :meth:`~socket.getsockopt` methods of socket objects. In most cases, " +"only those symbols that are defined in the Unix header files are defined; " +"for a few symbols, default values are provided." msgstr "" msgid "" @@ -678,8 +679,8 @@ msgid "" msgstr "" msgid "" -"Used in the level argument to the :meth:`~socket.setsockopt` and :meth:" -"`~socket.getsockopt` methods of Bluetooth socket objects." +"Used in the level argument to the :meth:`~socket.setsockopt` " +"and :meth:`~socket.getsockopt` methods of Bluetooth socket objects." msgstr "" msgid "" @@ -732,8 +733,8 @@ msgid "" msgstr "" msgid "" -"Constant to optimize CPU locality, to be used in conjunction with :data:" -"`SO_REUSEPORT`." +"Constant to optimize CPU locality, to be used in conjunction " +"with :data:`SO_REUSEPORT`." msgstr "" msgid "" @@ -764,76 +765,16 @@ msgid "" msgstr "" msgid "" -"Create a new socket using the given address family, socket type and protocol " -"number. The address family should be :const:`AF_INET` (the default), :const:" -"`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, or :const:" -"`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the default), :" -"const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_`` " -"constants. The protocol number is usually zero and may be omitted or in the " -"case where the address family is :const:`AF_CAN` the protocol should be one " -"of :const:`CAN_RAW`, :const:`CAN_BCM`, :const:`CAN_ISOTP` or :const:" -"`CAN_J1939`." -msgstr "" - -msgid "" -"If *fileno* is specified, the values for *family*, *type*, and *proto* are " -"auto-detected from the specified file descriptor. Auto-detection can be " -"overruled by calling the function with explicit *family*, *type*, or *proto* " -"arguments. This only affects how Python represents e.g. the return value " -"of :meth:`socket.getpeername` but not the actual OS resource. Unlike :func:" -"`socket.fromfd`, *fileno* will return the same socket and not a duplicate. " -"This may help close a detached socket using :meth:`socket.close`." -msgstr "" - -msgid "The newly created socket is :ref:`non-inheritable `." -msgstr "" - -msgid "" -"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " -"``self``, ``family``, ``type``, ``protocol``." -msgstr "" - -msgid "The AF_CAN family was added. The AF_RDS family was added." -msgstr "" - -msgid "The CAN_BCM protocol was added." -msgstr "" - -msgid "The returned socket is now non-inheritable." -msgstr "" - -msgid "The CAN_ISOTP protocol was added." -msgstr "" - -msgid "" -"When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied " -"to *type* they are cleared, and :attr:`socket.type` will not reflect them. " -"They are still passed to the underlying system ``socket()`` call. Therefore," -msgstr "" - -msgid "" -"sock = socket.socket(\n" -" socket.AF_INET,\n" -" socket.SOCK_STREAM | socket.SOCK_NONBLOCK)" -msgstr "" - -msgid "" -"will still create a non-blocking socket on OSes that support " -"``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." -msgstr "" - -msgid "The CAN_J1939 protocol was added." -msgstr "" - -msgid "The IPPROTO_MPTCP protocol was added." +"The :class:`socket ` class constructor creates a new socket " +"directly; see :ref:`socket-objects` for its parameters and full description." msgstr "" msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " "number are as for the :func:`~socket.socket` function. The default family " -"is :const:`AF_UNIX` if defined on the platform; otherwise, the default is :" -"const:`AF_INET`." +"is :const:`AF_UNIX` if defined on the platform; otherwise, the default " +"is :const:`AF_INET`." msgstr "" msgid "The newly created sockets are :ref:`non-inheritable `." @@ -893,8 +834,8 @@ msgstr "" msgid "" "*family* should be either :data:`AF_INET` or :data:`AF_INET6`. *backlog* is " "the queue size passed to :meth:`socket.listen`; if not specified , a default " -"reasonable value is chosen. *reuse_port* dictates whether to set the :data:" -"`SO_REUSEPORT` socket option." +"reasonable value is chosen. *reuse_port* dictates whether to set " +"the :data:`SO_REUSEPORT` socket option." msgstr "" msgid "" @@ -934,8 +875,8 @@ msgstr "" msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`~io.IOBase.fileno` method) and build a socket object from " -"the result. Address family, socket type and protocol number are as for the :" -"func:`~socket.socket` function. The file descriptor should refer to a " +"the result. Address family, socket type and protocol number are as for " +"the :func:`~socket.socket` function. The file descriptor should refer to a " "socket, but this is not checked --- subsequent operations on the object may " "fail if the file descriptor is invalid. This function is rarely needed, but " "can be used to get or set socket options on a socket passed to a program as " @@ -943,14 +884,15 @@ msgid "" "daemon). The socket is assumed to be in blocking mode." msgstr "" -msgid "" -"Instantiate a socket from data obtained from the :meth:`socket.share` " -"method. The socket is assumed to be in blocking mode." +msgid "The newly created socket is :ref:`non-inheritable `." +msgstr "" + +msgid "The returned socket is now non-inheritable." msgstr "" msgid "" -"This is a Python type object that represents the socket object type. It is " -"the same as ``type(socket(...))``." +"Instantiate a socket from data obtained from the :meth:`socket.share` " +"method. The socket is assumed to be in blocking mode." msgstr "" msgid "Other functions" @@ -987,9 +929,9 @@ msgstr "" msgid "" "The *flags* argument can be one or several of the ``AI_*`` constants, and " -"will influence how results are computed and returned. For example, :const:" -"`AI_NUMERICHOST` will disable domain name resolution and will raise an error " -"if *host* is a domain name." +"will influence how results are computed and returned. For " +"example, :const:`AI_NUMERICHOST` will disable domain name resolution and " +"will raise an error if *host* is a domain name." msgstr "" msgid "The function returns a list of 5-tuples with the following structure:" @@ -1001,12 +943,13 @@ msgstr "" msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " "be passed to the :func:`~socket.socket` function. *canonname* will be a " -"string representing the canonical name of the *host* if :const:" -"`AI_CANONNAME` is part of the *flags* argument; else *canonname* will be " -"empty. *sockaddr* is a tuple describing a socket address, whose format " -"depends on the returned *family* (a ``(address, port)`` 2-tuple for :const:" -"`AF_INET`, a ``(address, port, flowinfo, scope_id)`` 4-tuple for :const:" -"`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." +"string representing the canonical name of the *host* " +"if :const:`AI_CANONNAME` is part of the *flags* argument; else *canonname* " +"will be empty. *sockaddr* is a tuple describing a socket address, whose " +"format depends on the returned *family* (a ``(address, port)`` 2-tuple " +"for :const:`AF_INET`, a ``(address, port, flowinfo, scope_id)`` 4-tuple " +"for :const:`AF_INET6`), and is meant to be passed to " +"the :meth:`socket.connect` method." msgstr "" msgid "" @@ -1120,8 +1063,8 @@ msgid "" "(possibly empty) list of alternative host names for the same address, and " "*ipaddrlist* is a list of IPv4/v6 addresses for the same interface on the " "same host (most likely containing only a single address). To find the fully " -"qualified domain name, use the function :func:`getfqdn`. :func:" -"`gethostbyaddr` supports both IPv4 and IPv6." +"qualified domain name, use the " +"function :func:`getfqdn`. :func:`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" msgid "" @@ -1152,10 +1095,11 @@ msgstr "" msgid "" "Translate an internet protocol name (for example, ``'icmp'``) to a constant " -"suitable for passing as the (optional) third argument to the :func:`~socket." -"socket` function. This is usually only needed for sockets opened in \"raw\" " -"mode (:const:`SOCK_RAW`); for the normal socket modes, the correct protocol " -"is chosen automatically if the protocol is omitted or zero." +"suitable for passing as the (optional) third argument to " +"the :func:`~socket.socket` function. This is usually only needed for " +"sockets opened in \"raw\" mode (:const:`SOCK_RAW`); for the normal socket " +"modes, the correct protocol is chosen automatically if the protocol is " +"omitted or zero." msgstr "" msgid "" @@ -1222,9 +1166,9 @@ msgid "" msgstr "" msgid "" -"If the IPv4 address string passed to this function is invalid, :exc:" -"`OSError` will be raised. Note that exactly what is valid depends on the " -"underlying C implementation of :c:func:`inet_aton`." +"If the IPv4 address string passed to this function is " +"invalid, :exc:`OSError` will be raised. Note that exactly what is valid " +"depends on the underlying C implementation of :c:func:`inet_aton`." msgstr "" msgid "" @@ -1251,16 +1195,16 @@ msgstr "" msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " -"protocol calls for an object of type :c:struct:`in_addr` (similar to :func:" -"`inet_aton`) or :c:struct:`in6_addr`." +"protocol calls for an object of type :c:struct:`in_addr` (similar " +"to :func:`inet_aton`) or :c:struct:`in6_addr`." msgstr "" msgid "" -"Supported values for *address_family* are currently :const:`AF_INET` and :" -"const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" -"`OSError` will be raised. Note that exactly what is valid depends on both " -"the value of *address_family* and the underlying implementation of :c:func:" -"`inet_pton`." +"Supported values for *address_family* are currently :const:`AF_INET` " +"and :const:`AF_INET6`. If the IP address string *ip_string* is " +"invalid, :exc:`OSError` will be raised. Note that exactly what is valid " +"depends on both the value of *address_family* and the underlying " +"implementation of :c:func:`inet_pton`." msgstr "" msgid "Windows support added" @@ -1275,20 +1219,21 @@ msgid "" msgstr "" msgid "" -"Supported values for *address_family* are currently :const:`AF_INET` and :" -"const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length " -"for the specified address family, :exc:`ValueError` will be raised. :exc:" -"`OSError` is raised for errors from the call to :func:`inet_ntop`." +"Supported values for *address_family* are currently :const:`AF_INET` " +"and :const:`AF_INET6`. If the bytes object *packed_ip* is not the correct " +"length for the specified address family, :exc:`ValueError` will be " +"raised. :exc:`OSError` is raised for errors from the call " +"to :func:`inet_ntop`." msgstr "" msgid "" "Return the total length, without trailing padding, of an ancillary data item " "with associated data of the given *length*. This value can often be used as " "the buffer size for :meth:`~socket.recvmsg` to receive a single item of " -"ancillary data, but :rfc:`3542` requires portable applications to use :func:" -"`CMSG_SPACE` and thus include space for padding, even when the item will be " -"the last in the buffer. Raises :exc:`OverflowError` if *length* is outside " -"the permissible range of values." +"ancillary data, but :rfc:`3542` requires portable applications to " +"use :func:`CMSG_SPACE` and thus include space for padding, even when the " +"item will be the last in the buffer. Raises :exc:`OverflowError` if " +"*length* is outside the permissible range of values." msgstr "" msgid "Most Unix platforms." @@ -1321,8 +1266,9 @@ msgstr "" msgid "" "Set the default timeout in seconds (float) for new socket objects. When the " -"socket module is first imported, the default is ``None``. See :meth:" -"`~socket.settimeout` for possible values and their respective meanings." +"socket module is first imported, the default is ``None``. " +"See :meth:`~socket.settimeout` for possible values and their respective " +"meanings." msgstr "" msgid "" @@ -1366,22 +1312,22 @@ msgid "" msgstr "" msgid "" -"Return a network interface index number corresponding to an interface name. :" -"exc:`OSError` if no interface with the given name exists." +"Return a network interface index number corresponding to an interface " +"name. :exc:`OSError` if no interface with the given name exists." msgstr "" msgid "\"Interface name\" is a name as documented in :func:`if_nameindex`." msgstr "" msgid "" -"Return a network interface name corresponding to an interface index number. :" -"exc:`OSError` if no interface with the given index exists." +"Return a network interface name corresponding to an interface index " +"number. :exc:`OSError` if no interface with the given index exists." msgstr "" msgid "" "Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket " -"*sock*. The *fds* parameter is a sequence of file descriptors. Consult :meth:" -"`~socket.sendmsg` for the documentation of these parameters." +"*sock*. The *fds* parameter is a sequence of file descriptors. " +"Consult :meth:`~socket.sendmsg` for the documentation of these parameters." msgstr "" msgid "" @@ -1391,8 +1337,8 @@ msgstr "" msgid "" "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket " -"*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`~socket." -"recvmsg` for the documentation of these parameters." +"*sock*. Return ``(msg, list(fds), flags, addr)``. " +"Consult :meth:`~socket.recvmsg` for the documentation of these parameters." msgstr "" msgid "" @@ -1407,13 +1353,74 @@ msgid "Socket Objects" msgstr "" msgid "" -"Socket objects have the following methods. Except for :meth:`~socket." -"makefile`, these correspond to Unix system calls applicable to sockets." +"Create a new socket using the given address family, socket type and protocol " +"number. The address family should be :const:`AF_INET` (the " +"default), :const:`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, " +"or :const:`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the " +"default), :const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other " +"``SOCK_`` constants. The protocol number is usually zero and may be omitted " +"or in the case where the address family is :const:`AF_CAN` the protocol " +"should be one of :const:`CAN_RAW`, :const:`CAN_BCM`, :const:`CAN_ISOTP` " +"or :const:`CAN_J1939`." +msgstr "" + +msgid "" +"If *fileno* is specified, the values for *family*, *type*, and *proto* are " +"auto-detected from the specified file descriptor. Auto-detection can be " +"overruled by calling the function with explicit *family*, *type*, or *proto* " +"arguments. This only affects how Python represents e.g. the return value " +"of :meth:`socket.getpeername` but not the actual OS resource. " +"Unlike :func:`socket.fromfd`, *fileno* will return the same socket and not a " +"duplicate. This may help close a detached socket " +"using :meth:`~socket.socket.close`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " +"``self``, ``family``, ``type``, ``protocol``." +msgstr "" + +msgid "The AF_CAN family was added. The AF_RDS family was added." +msgstr "" + +msgid "The CAN_BCM protocol was added." +msgstr "" + +msgid "The CAN_ISOTP protocol was added." +msgstr "" + +msgid "" +"When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied " +"to *type* they are cleared, and :attr:`socket.type` will not reflect them. " +"They are still passed to the underlying system ``socket()`` call. Therefore," +msgstr "" + +msgid "" +"sock = socket.socket(\n" +" socket.AF_INET,\n" +" socket.SOCK_STREAM | socket.SOCK_NONBLOCK)" +msgstr "" + +msgid "" +"will still create a non-blocking socket on OSes that support " +"``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." +msgstr "" + +msgid "The CAN_J1939 protocol was added." +msgstr "" + +msgid "The IPPROTO_MPTCP protocol was added." +msgstr "" + +msgid "" +"Socket objects have the following methods. Except " +"for :meth:`~socket.makefile`, these correspond to Unix system calls " +"applicable to sockets." msgstr "" msgid "" "Support for the :term:`context manager` protocol was added. Exiting the " -"context manager is equivalent to calling :meth:`~socket.close`." +"context manager is equivalent to calling :meth:`~socket.socket.close`." msgstr "" msgid "" @@ -1429,8 +1436,8 @@ msgstr "" msgid "" "If the system call is interrupted and the signal handler does not raise an " -"exception, the method now retries the system call instead of raising an :exc:" -"`InterruptedError` exception (see :pep:`475` for the rationale)." +"exception, the method now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" msgid "" @@ -1459,8 +1466,8 @@ msgid "" msgstr "" msgid "" -":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" -"`close` call is made." +":exc:`OSError` is now raised if an error occurs when the " +"underlying :c:func:`!close` call is made." msgstr "" msgid "" @@ -1478,9 +1485,9 @@ msgid "" "If the connection is interrupted by a signal, the method waits until the " "connection completes, or raises a :exc:`TimeoutError` on timeout, if the " "signal handler doesn't raise an exception and the socket is blocking or has " -"a timeout. For non-blocking sockets, the method raises an :exc:" -"`InterruptedError` exception if the connection is interrupted by a signal " -"(or the exception raised by the signal handler)." +"a timeout. For non-blocking sockets, the method raises " +"an :exc:`InterruptedError` exception if the connection is interrupted by a " +"signal (or the exception raised by the signal handler)." msgstr "" msgid "" @@ -1489,15 +1496,15 @@ msgid "" msgstr "" msgid "" -"The method now waits until the connection completes instead of raising an :" -"exc:`InterruptedError` exception if the connection is interrupted by a " +"The method now waits until the connection completes instead of raising " +"an :exc:`InterruptedError` exception if the connection is interrupted by a " "signal, the signal handler doesn't raise an exception and the socket is " "blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " -"an exception for errors returned by the C-level :c:func:`connect` call " +"an exception for errors returned by the C-level :c:func:`!connect` call " "(other problems, such as \"host not found,\" can still raise exceptions). " "The error indicator is ``0`` if the operation succeeded, otherwise the value " "of the :c:data:`errno` variable. This is useful to support, for example, " @@ -1533,8 +1540,8 @@ msgstr "" msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. The " -"format of the address returned depends on the address family --- see :ref:" -"`socket-addresses`. On some systems this function is not supported." +"format of the address returned depends on the address family --- " +"see :ref:`socket-addresses`. On some systems this function is not supported." msgstr "" msgid "" @@ -1544,15 +1551,15 @@ msgid "" msgstr "" msgid "" -"Return the value of the given socket option (see the Unix man page :manpage:" -"`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* etc. `) are defined in this module. If *buflen* is absent, an " -"integer option is assumed and its integer value is returned by the " -"function. If *buflen* is present, it specifies the maximum length of the " -"buffer used to receive the option in, and this buffer is returned as a bytes " -"object. It is up to the caller to decode the contents of the buffer (see " -"the optional built-in module :mod:`struct` for a way to decode C structures " -"encoded as byte strings)." +"Return the value of the given socket option (see the Unix man " +"page :manpage:`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* " +"etc. `) are defined in this module. If *buflen* is " +"absent, an integer option is assumed and its integer value is returned by " +"the function. If *buflen* is present, it specifies the maximum length of " +"the buffer used to receive the option in, and this buffer is returned as a " +"bytes object. It is up to the caller to decode the contents of the buffer " +"(see the optional built-in module :mod:`struct` for a way to decode C " +"structures encoded as byte strings)." msgstr "" msgid "" @@ -1564,14 +1571,15 @@ msgstr "" msgid "" "Return the timeout in seconds (float) associated with socket operations, or " -"``None`` if no timeout is set. This reflects the last call to :meth:" -"`setblocking` or :meth:`settimeout`." +"``None`` if no timeout is set. This reflects the last call " +"to :meth:`setblocking` or :meth:`settimeout`." msgstr "" msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " -"interface. Please refer to the `Win32 documentation `_ for more information." +"interface. Please refer to the `Win32 documentation `_ for more " +"information." msgstr "" msgid "" @@ -1610,8 +1618,8 @@ msgstr "" msgid "" "Closing the file object returned by :meth:`makefile` won't close the " -"original socket unless all other file objects have been closed and :meth:" -"`socket.close` has been called on the socket object." +"original socket unless all other file objects have been closed " +"and :meth:`~socket.socket.close` has been called on the socket object." msgstr "" msgid "" @@ -1624,9 +1632,9 @@ msgid "" "Receive data from the socket. The return value is a bytes object " "representing the data received. The maximum amount of data to be received " "at once is specified by *bufsize*. A returned empty bytes object indicates " -"that the client has disconnected. See the Unix manual page :manpage:" -"`recv(2)` for the meaning of the optional argument *flags*; it defaults to " -"zero." +"that the client has disconnected. See the Unix manual " +"page :manpage:`recv(2)` for the meaning of the optional argument *flags*; it " +"defaults to zero." msgstr "" msgid "" @@ -1640,8 +1648,8 @@ msgstr "" msgid "" "For multicast IPv6 address, first item of *address* does not contain " -"``%scope_id`` part anymore. In order to get full IPv6 address use :func:" -"`getnameinfo`." +"``%scope_id`` part anymore. In order to get full IPv6 address " +"use :func:`getnameinfo`." msgstr "" msgid "" @@ -1673,27 +1681,28 @@ msgid "" "file descriptors between processes over an :const:`AF_UNIX` socket. When " "this facility is used (it is often restricted to :const:`SOCK_STREAM` " "sockets), :meth:`recvmsg` will return, in its ancillary data, items of the " -"form ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)``, where *fds* is a :" -"class:`bytes` object representing the new file descriptors as a binary array " -"of the native C :c:expr:`int` type. If :meth:`recvmsg` raises an exception " -"after the system call returns, it will first attempt to close any file " -"descriptors received via this mechanism." +"form ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)``, where *fds* is " +"a :class:`bytes` object representing the new file descriptors as a binary " +"array of the native C :c:expr:`int` type. If :meth:`recvmsg` raises an " +"exception after the system call returns, it will first attempt to close any " +"file descriptors received via this mechanism." msgstr "" msgid "" "Some systems do not indicate the truncated length of ancillary data items " "which have been only partially received. If an item appears to extend " -"beyond the end of the buffer, :meth:`recvmsg` will issue a :exc:" -"`RuntimeWarning`, and will return the part of it which is inside the buffer " -"provided it has not been truncated before the start of its associated data." +"beyond the end of the buffer, :meth:`recvmsg` will issue " +"a :exc:`RuntimeWarning`, and will return the part of it which is inside the " +"buffer provided it has not been truncated before the start of its associated " +"data." msgstr "" msgid "" -"On systems which support the :const:`SCM_RIGHTS` mechanism, the following " +"On systems which support the :const:`!SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " "data and a list containing the descriptors (while ignoring unexpected " -"conditions such as unrelated control messages being received). See also :" -"meth:`sendmsg`. ::" +"conditions such as unrelated control messages being received). See " +"also :meth:`sendmsg`. ::" msgstr "" msgid "" @@ -1704,24 +1713,25 @@ msgid "" " msg, ancdata, flags, addr = sock.recvmsg(msglen, socket.CMSG_LEN(maxfds " "* fds.itemsize))\n" " for cmsg_level, cmsg_type, cmsg_data in ancdata:\n" -" if cmsg_level == socket.SOL_SOCKET and cmsg_type == socket." -"SCM_RIGHTS:\n" +" if cmsg_level == socket.SOL_SOCKET and cmsg_type == " +"socket.SCM_RIGHTS:\n" " # Append data, ignoring any truncated integers at the end.\n" -" fds.frombytes(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % fds." -"itemsize)])\n" +" fds.frombytes(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % " +"fds.itemsize)])\n" " return msg, list(fds)" msgstr "" msgid "" -"Receive normal data and ancillary data from the socket, behaving as :meth:" -"`recvmsg` would, but scatter the non-ancillary data into a series of buffers " -"instead of returning a new bytes object. The *buffers* argument must be an " -"iterable of objects that export writable buffers (e.g. :class:`bytearray` " -"objects); these will be filled with successive chunks of the non-ancillary " -"data until it has all been written or there are no more buffers. The " -"operating system may set a limit (:func:`~os.sysconf` value ``SC_IOV_MAX``) " -"on the number of buffers that can be used. The *ancbufsize* and *flags* " -"arguments have the same meaning as for :meth:`recvmsg`." +"Receive normal data and ancillary data from the socket, behaving " +"as :meth:`recvmsg` would, but scatter the non-ancillary data into a series " +"of buffers instead of returning a new bytes object. The *buffers* argument " +"must be an iterable of objects that export writable buffers " +"(e.g. :class:`bytearray` objects); these will be filled with successive " +"chunks of the non-ancillary data until it has all been written or there are " +"no more buffers. The operating system may set a limit (:func:`~os.sysconf` " +"value ``SC_IOV_MAX``) on the number of buffers that can be used. The " +"*ancbufsize* and *flags* arguments have the same meaning as " +"for :meth:`recvmsg`." msgstr "" msgid "" @@ -1805,9 +1815,9 @@ msgstr "" msgid "" "Send normal and ancillary data to the socket, gathering the non-ancillary " "data from a series of buffers and concatenating it into a single message. " -"The *buffers* argument specifies the non-ancillary data as an iterable of :" -"term:`bytes-like objects ` (e.g. :class:`bytes` objects); " -"the operating system may set a limit (:func:`~os.sysconf` value " +"The *buffers* argument specifies the non-ancillary data as an iterable " +"of :term:`bytes-like objects ` (e.g. :class:`bytes` " +"objects); the operating system may set a limit (:func:`~os.sysconf` value " "``SC_IOV_MAX``) on the number of buffers that can be used. The *ancdata* " "argument specifies the ancillary data (control messages) as an iterable of " "zero or more tuples ``(cmsg_level, cmsg_type, cmsg_data)``, where " @@ -1822,17 +1832,17 @@ msgid "" msgstr "" msgid "" -"The following function sends the list of file descriptors *fds* over an :" -"const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` " -"mechanism. See also :meth:`recvmsg`. ::" +"The following function sends the list of file descriptors *fds* over " +"an :const:`AF_UNIX` socket, on systems which support the :const:`!" +"SCM_RIGHTS` mechanism. See also :meth:`recvmsg`. ::" msgstr "" msgid "" "import socket, array\n" "\n" "def send_fds(sock, msg, fds):\n" -" return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, array." -"array(\"i\", fds))])" +" return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, " +"array.array(\"i\", fds))])" msgstr "" msgid "" @@ -1847,16 +1857,17 @@ msgid "" msgstr "" msgid "" -"Send a file until EOF is reached by using high-performance :mod:`os." -"sendfile` and return the total number of bytes which were sent. *file* must " -"be a regular file object opened in binary mode. If :mod:`os.sendfile` is not " -"available (e.g. Windows) or *file* is not a regular file :meth:`send` will " -"be used instead. *offset* tells from where to start reading the file. If " -"specified, *count* is the total number of bytes to transmit as opposed to " -"sending the file until EOF is reached. File position is updated on return or " -"also in case of error in which case :meth:`file.tell() ` can " -"be used to figure out the number of bytes which were sent. The socket must " -"be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." +"Send a file until EOF is reached by using high-" +"performance :mod:`os.sendfile` and return the total number of bytes which " +"were sent. *file* must be a regular file object opened in binary mode. " +"If :mod:`os.sendfile` is not available (e.g. Windows) or *file* is not a " +"regular file :meth:`send` will be used instead. *offset* tells from where to " +"start reading the file. If specified, *count* is the total number of bytes " +"to transmit as opposed to sending the file until EOF is reached. File " +"position is updated on return or also in case of error in which " +"case :meth:`file.tell() ` can be used to figure out the " +"number of bytes which were sent. The socket must be of :const:`SOCK_STREAM` " +"type. Non-blocking sockets are not supported." msgstr "" msgid "" @@ -1880,17 +1891,17 @@ msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "" msgid "" -"The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket." -"type`." +"The method no longer applies :const:`SOCK_NONBLOCK` flag " +"on :attr:`socket.type`." msgstr "" msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " -"nonnegative floating-point number expressing seconds, or ``None``. If a non-" -"zero value is given, subsequent socket operations will raise a :exc:" -"`timeout` exception if the timeout period *value* has elapsed before the " -"operation has completed. If zero is given, the socket is put in non-" -"blocking mode. If ``None`` is given, the socket is put in blocking mode." +"nonnegative real number expressing seconds, or ``None``. If a non-zero value " +"is given, subsequent socket operations will raise a :exc:`timeout` exception " +"if the timeout period *value* has elapsed before the operation has " +"completed. If zero is given, the socket is put in non-blocking mode. If " +"``None`` is given, the socket is put in blocking mode." msgstr "" msgid "" @@ -1899,45 +1910,47 @@ msgid "" msgstr "" msgid "" -"The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket." -"type`." +"The method no longer toggles :const:`SOCK_NONBLOCK` flag " +"on :attr:`socket.type`." msgstr "" msgid "" -"Set the value of the given socket option (see the Unix manual page :manpage:" -"`setsockopt(2)`). The needed symbolic constants are defined in this module " -"(:ref:`!SO_\\* etc. `). The value can be an integer, " -"``None`` or a :term:`bytes-like object` representing a buffer. In the latter " -"case it is up to the caller to ensure that the bytestring contains the " -"proper bits (see the optional built-in module :mod:`struct` for a way to " -"encode C structures as bytestrings). When *value* is set to ``None``, " -"*optlen* argument is required. It's equivalent to calling :c:func:" -"`setsockopt` C function with ``optval=NULL`` and ``optlen=optlen``." +"Set the value of the given socket option (see the Unix manual " +"page :manpage:`setsockopt(2)`). The needed symbolic constants are defined " +"in this module (:ref:`!SO_\\* etc. `). The value can " +"be an integer, ``None`` or a :term:`bytes-like object` representing a " +"buffer. In the latter case it is up to the caller to ensure that the " +"bytestring contains the proper bits (see the optional built-in " +"module :mod:`struct` for a way to encode C structures as bytestrings). When " +"*value* is set to ``None``, *optlen* argument is required. It's equivalent " +"to calling :c:func:`!setsockopt` C function with ``optval=NULL`` and " +"``optlen=optlen``." msgstr "" msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" msgid "" -"Shut down one or both halves of the connection. If *how* is :const:" -"`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " -"further sends are disallowed. If *how* is :const:`SHUT_RDWR`, further sends " -"and receives are disallowed." +"Shut down one or both halves of the connection. If *how* " +"is :const:`SHUT_RD`, further receives are disallowed. If *how* " +"is :const:`SHUT_WR`, further sends are disallowed. If *how* " +"is :const:`SHUT_RDWR`, further sends and receives are disallowed." msgstr "" msgid "" "Duplicate a socket and prepare it for sharing with a target process. The " "target process must be provided with *process_id*. The resulting bytes " "object can then be passed to the target process using some form of " -"interprocess communication and the socket can be recreated there using :func:" -"`fromshare`. Once this method has been called, it is safe to close the " -"socket since the operating system has already duplicated it for the target " -"process." +"interprocess communication and the socket can be recreated there " +"using :func:`fromshare`. Once this method has been called, it is safe to " +"close the socket since the operating system has already duplicated it for " +"the target process." msgstr "" msgid "" -"Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" -"`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." +"Note that there are no methods :meth:`!read` or :meth:`!write`; " +"use :meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument " +"instead." msgstr "" msgid "" @@ -1954,6 +1967,13 @@ msgstr "" msgid "The socket protocol." msgstr "" +msgid "" +"The base class of the :class:`~socket.socket` type, re-exported from :mod:`!" +"_socket`. An instance check such as ``isinstance(socket(...), SocketType)`` " +"is true, but ``SocketType`` is not the same as ``type(socket(...))``, which " +"is :class:`~socket.socket` itself." +msgstr "" + msgid "Notes on socket timeouts" msgstr "" @@ -1995,19 +2015,19 @@ msgstr "" msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " -"before calling :meth:`~socket.connect` or pass a timeout parameter to :meth:" -"`create_connection`. However, the system network stack may also return a " -"connection timeout error of its own regardless of any Python socket timeout " -"setting." +"before calling :meth:`~socket.connect` or pass a timeout parameter " +"to :meth:`create_connection`. However, the system network stack may also " +"return a connection timeout error of its own regardless of any Python socket " +"timeout setting." msgstr "" msgid "Timeouts and the ``accept`` method" msgstr "" msgid "" -"If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the :" -"meth:`~socket.accept` method inherit that timeout. Otherwise, the behaviour " -"depends on settings of the listening socket:" +"If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by " +"the :meth:`~socket.accept` method inherit that timeout. Otherwise, the " +"behaviour depends on settings of the listening socket:" msgstr "" msgid "" @@ -2028,13 +2048,14 @@ msgstr "Przykład" msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " -"a client using it. Note that a server must perform the sequence :func:" -"`~socket.socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:" -"`~socket.accept` (possibly repeating the :meth:`~socket.accept` to service " -"more than one client), while a client only needs the sequence :func:`~socket." -"socket`, :meth:`~socket.connect`. Also note that the server does not :meth:" -"`~socket.sendall`/:meth:`~socket.recv` on the socket it is listening on but " -"on the new socket returned by :meth:`~socket.accept`." +"a client using it. Note that a server must perform the " +"sequence :func:`~socket.socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:`~socket.accept` " +"(possibly repeating the :meth:`~socket.accept` to service more than one " +"client), while a client only needs the " +"sequence :func:`~socket.socket`, :meth:`~socket.connect`. Also note that " +"the server does not :meth:`~socket.sendall`/:meth:`~socket.recv` on the " +"socket it is listening on but on the new socket returned " +"by :meth:`~socket.accept`." msgstr "" msgid "The first two examples support IPv4 only. ::" @@ -2124,8 +2145,8 @@ msgid "" "HOST = 'daring.cwi.nl' # The remote host\n" "PORT = 50007 # The same port as used by the server\n" "s = None\n" -"for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC, socket." -"SOCK_STREAM):\n" +"for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC, " +"socket.SOCK_STREAM):\n" " af, socktype, proto, canonname, sa = res\n" " try:\n" " s = socket.socket(af, socktype, proto)\n" @@ -2250,8 +2271,8 @@ msgid "" msgstr "" msgid "" -"There is a :mod:`!socket` flag to set, in order to prevent this, :const:" -"`socket.SO_REUSEADDR`::" +"There is a :mod:`!socket` flag to set, in order to prevent " +"this, :const:`socket.SO_REUSEADDR`::" msgstr "" msgid "" diff --git a/library/socketserver.po b/library/socketserver.po index 5fc860e419..980c31be8e 100644 --- a/library/socketserver.po +++ b/library/socketserver.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -83,9 +83,9 @@ msgid "" "classes, passing it the server's address and the request handler class. It " "is recommended to use the server in a :keyword:`with` statement. Then call " "the :meth:`~BaseServer.handle_request` or :meth:`~BaseServer.serve_forever` " -"method of the server object to process one or many requests. Finally, call :" -"meth:`~BaseServer.server_close` to close the socket (unless you used a :" -"keyword:`!with` statement)." +"method of the server object to process one or many requests. Finally, " +"call :meth:`~BaseServer.server_close` to close the socket (unless you used " +"a :keyword:`!with` statement)." msgstr "" msgid "" @@ -95,8 +95,8 @@ msgid "" "attribute *daemon_threads*, which indicates whether or not the server should " "wait for thread termination. You should set the flag explicitly if you " "would like threads to behave autonomously; the default is :const:`False`, " -"meaning that Python will not exit until all threads created by :class:" -"`ThreadingMixIn` have exited." +"meaning that Python will not exit until all threads created " +"by :class:`ThreadingMixIn` have exited." msgstr "" msgid "" @@ -146,9 +146,9 @@ msgid "" msgstr "" msgid "" -"The mix-in class comes first, since it overrides a method defined in :class:" -"`UDPServer`. Setting the various attributes also changes the behavior of " -"the underlying server mechanism." +"The mix-in class comes first, since it overrides a method defined " +"in :class:`UDPServer`. Setting the various attributes also changes the " +"behavior of the underlying server mechanism." msgstr "" msgid "" @@ -175,17 +175,17 @@ msgid "" msgstr "" msgid "" -"For :class:`ThreadingMixIn` use daemonic threads by setting :data:" -"`ThreadingMixIn.daemon_threads ` to ``True`` to not wait " -"until threads complete." +"For :class:`ThreadingMixIn` use daemonic threads by " +"setting :data:`ThreadingMixIn.daemon_threads ` to ``True`` " +"to not wait until threads complete." msgstr "" msgid "" -":meth:`ForkingMixIn.server_close ` and :meth:" -"`ThreadingMixIn.server_close ` now waits until all " -"child processes and non-daemonic threads complete. Add a new :attr:" -"`ForkingMixIn.block_on_close ` class attribute to opt-in for " -"the pre-3.7 behaviour." +":meth:`ForkingMixIn.server_close ` " +"and :meth:`ThreadingMixIn.server_close ` now waits " +"until all child processes and non-daemonic threads complete. Add a " +"new :attr:`ForkingMixIn.block_on_close ` class attribute to " +"opt-in for the pre-3.7 behaviour." msgstr "" msgid "These classes are pre-defined using the mix-in classes." @@ -197,13 +197,13 @@ msgid "" msgstr "" msgid "" -"To implement a service, you must derive a class from :class:" -"`BaseRequestHandler` and redefine its :meth:`~BaseRequestHandler.handle` " -"method. You can then run various versions of the service by combining one of " -"the server classes with your request handler class. The request handler " -"class must be different for datagram or stream services. This can be hidden " -"by using the handler subclasses :class:`StreamRequestHandler` or :class:" -"`DatagramRequestHandler`." +"To implement a service, you must derive a class " +"from :class:`BaseRequestHandler` and redefine " +"its :meth:`~BaseRequestHandler.handle` method. You can then run various " +"versions of the service by combining one of the server classes with your " +"request handler class. The request handler class must be different for " +"datagram or stream services. This can be hidden by using the handler " +"subclasses :class:`StreamRequestHandler` or :class:`DatagramRequestHandler`." msgstr "" msgid "" @@ -228,8 +228,8 @@ msgid "" "In some cases, it may be appropriate to process part of a request " "synchronously, but to finish processing in a forked child depending on the " "request data. This can be implemented by using a synchronous server and " -"doing an explicit fork in the request handler class :meth:" -"`~BaseRequestHandler.handle` method." +"doing an explicit fork in the request handler " +"class :meth:`~BaseRequestHandler.handle` method." msgstr "" msgid "" @@ -249,8 +249,8 @@ msgstr "" msgid "" "This is the superclass of all Server objects in the module. It defines the " "interface, given below, but does not implement most of the methods, which is " -"done in subclasses. The two parameters are stored in the respective :attr:" -"`server_address` and :attr:`RequestHandlerClass` attributes." +"done in subclasses. The two parameters are stored in the " +"respective :attr:`server_address` and :attr:`RequestHandlerClass` attributes." msgstr "" msgid "" @@ -261,12 +261,13 @@ msgstr "" msgid "" "Process a single request. This function calls the following methods in " -"order: :meth:`get_request`, :meth:`verify_request`, and :meth:" -"`process_request`. If the user-provided :meth:`~BaseRequestHandler.handle` " -"method of the handler class raises an exception, the server's :meth:" -"`handle_error` method will be called. If no request is received within :" -"attr:`timeout` seconds, :meth:`handle_timeout` will be called and :meth:" -"`handle_request` will return." +"order: :meth:`get_request`, :meth:`verify_request`, " +"and :meth:`process_request`. If the user-" +"provided :meth:`~BaseRequestHandler.handle` method of the handler class " +"raises an exception, the server's :meth:`handle_error` method will be " +"called. If no request is received within :attr:`timeout` " +"seconds, :meth:`handle_timeout` will be called and :meth:`handle_request` " +"will return." msgstr "" msgid "" @@ -288,9 +289,9 @@ msgid "" msgstr "" msgid "" -"Tell the :meth:`serve_forever` loop to stop and wait until it does. :meth:" -"`shutdown` must be called while :meth:`serve_forever` is running in a " -"different thread otherwise it will deadlock." +"Tell the :meth:`serve_forever` loop to stop and wait until it " +"does. :meth:`shutdown` must be called while :meth:`serve_forever` is running " +"in a different thread otherwise it will deadlock." msgstr "" msgid "Clean up the server. May be overridden." @@ -298,10 +299,10 @@ msgstr "" msgid "" "The family of protocols to which the server's socket belongs. Common " -"examples are :const:`socket.AF_INET`, :const:`socket.AF_INET6`, and :const:" -"`socket.AF_UNIX`. Subclass the TCP or UDP server classes in this module " -"with class attribute ``address_family = AF_INET6`` set if you want IPv6 " -"server classes." +"examples are :const:`socket.AF_INET`, :const:`socket.AF_INET6`, " +"and :const:`socket.AF_UNIX`. Subclass the TCP or UDP server classes in this " +"module with class attribute ``address_family = AF_INET6`` set if you want " +"IPv6 server classes." msgstr "" msgid "" @@ -311,9 +312,9 @@ msgstr "" msgid "" "The address on which the server is listening. The format of addresses " -"varies depending on the protocol family; see the documentation for the :mod:" -"`socket` module for details. For internet protocols, this is a tuple " -"containing a string giving the address, and an integer port number: " +"varies depending on the protocol family; see the documentation for " +"the :mod:`socket` module for details. For internet protocols, this is a " +"tuple containing a string giving the address, and an integer port number: " "``('127.0.0.1', 80)``, for example." msgstr "" @@ -325,8 +326,8 @@ msgid "The server classes support the following class variables:" msgstr "" msgid "" -"Whether the server will allow the reuse of an address. This defaults to :" -"const:`False`, and can be set in subclasses to change the policy." +"Whether the server will allow the reuse of an address. This defaults " +"to :const:`False`, and can be set in subclasses to change the policy." msgstr "" msgid "" @@ -338,8 +339,8 @@ msgid "" msgstr "" msgid "" -"The type of socket used by the server; :const:`socket.SOCK_STREAM` and :" -"const:`socket.SOCK_DGRAM` are two common values." +"The type of socket used by the server; :const:`socket.SOCK_STREAM` " +"and :const:`socket.SOCK_DGRAM` are two common values." msgstr "" msgid "" @@ -384,10 +385,10 @@ msgid "" msgstr "" msgid "" -"Calls :meth:`finish_request` to create an instance of the :attr:" -"`RequestHandlerClass`. If desired, this function can create a new process " -"or thread to handle the request; the :class:`ForkingMixIn` and :class:" -"`ThreadingMixIn` classes do this." +"Calls :meth:`finish_request` to create an instance of " +"the :attr:`RequestHandlerClass`. If desired, this function can create a new " +"process or thread to handle the request; the :class:`ForkingMixIn` " +"and :class:`ThreadingMixIn` classes do this." msgstr "" msgid "" @@ -432,8 +433,8 @@ msgid "" "This function must do all the work required to service a request. The " "default implementation does nothing. Several instance attributes are " "available to it; the request is available as :attr:`request`; the client " -"address as :attr:`client_address`; and the server instance as :attr:" -"`server`, in case it needs access to per-server information." +"address as :attr:`client_address`; and the server instance " +"as :attr:`server`, in case it needs access to per-server information." msgstr "" msgid "" @@ -460,19 +461,19 @@ msgid ":class:`BaseServer` object used for handling the request." msgstr "" msgid "" -"These :class:`BaseRequestHandler` subclasses override the :meth:" -"`~BaseRequestHandler.setup` and :meth:`~BaseRequestHandler.finish` methods, " -"and provide :attr:`rfile` and :attr:`wfile` attributes." +"These :class:`BaseRequestHandler` subclasses override " +"the :meth:`~BaseRequestHandler.setup` and :meth:`~BaseRequestHandler.finish` " +"methods, and provide :attr:`rfile` and :attr:`wfile` attributes." msgstr "" msgid "" -"A file object from which receives the request is read. Support the :class:" -"`io.BufferedIOBase` readable interface." +"A file object from which receives the request is read. Support " +"the :class:`io.BufferedIOBase` readable interface." msgstr "" msgid "" -"A file object to which the reply is written. Support the :class:`io." -"BufferedIOBase` writable interface" +"A file object to which the reply is written. Support " +"the :class:`io.BufferedIOBase` writable interface" msgstr "" msgid "" @@ -662,8 +663,8 @@ msgid "Asynchronous Mixins" msgstr "" msgid "" -"To build asynchronous handlers, use the :class:`ThreadingMixIn` and :class:" -"`ForkingMixIn` classes." +"To build asynchronous handlers, use the :class:`ThreadingMixIn` " +"and :class:`ForkingMixIn` classes." msgstr "" msgid "An example for the :class:`ThreadingMixIn` class::" @@ -682,8 +683,8 @@ msgid "" " response = bytes(\"{}: {}\".format(cur_thread.name, data), 'ascii')\n" " self.request.sendall(response)\n" "\n" -"class ThreadedTCPServer(socketserver.ThreadingMixIn, socketserver." -"TCPServer):\n" +"class ThreadedTCPServer(socketserver.ThreadingMixIn, " +"socketserver.TCPServer):\n" " pass\n" "\n" "def client(ip, port, message):\n" diff --git a/library/sqlite3.po b/library/sqlite3.po index e8cdadc3f2..7904869472 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -4,17 +4,18 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -41,8 +42,9 @@ msgstr "" msgid "" "The :mod:`!sqlite3` module was written by Gerhard Häring. It provides an " -"SQL interface compliant with the DB-API 2.0 specification described by :pep:" -"`249`, and requires the third-party `SQLite `_ library." +"SQL interface compliant with the DB-API 2.0 specification described " +"by :pep:`249`, and requires the third-party `SQLite `_ " +"library." msgstr "" msgid "" @@ -53,8 +55,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "This document includes four main sections:" msgstr "" @@ -125,8 +127,8 @@ msgstr "" msgid "" "In order to execute SQL statements and fetch results from SQL queries, we " -"will need to use a database cursor. Call :meth:`con.cursor() ` to create the :class:`Cursor`:" +"will need to use a database cursor. Call :meth:`con.cursor() " +"` to create the :class:`Cursor`:" msgstr "" msgid "cur = con.cursor()" @@ -137,8 +139,8 @@ msgid "" "database table ``movie`` with columns for title, release year, and review " "score. For simplicity, we can just use column names in the table declaration " "-- thanks to the `flexible typing`_ feature of SQLite, specifying the data " -"types is optional. Execute the ``CREATE TABLE`` statement by calling :meth:" -"`cur.execute(...) `:" +"types is optional. Execute the ``CREATE TABLE`` statement by " +"calling :meth:`cur.execute(...) `:" msgstr "" msgid "cur.execute(\"CREATE TABLE movie(title, year, score)\")" @@ -148,9 +150,9 @@ msgid "" "We can verify that the new table has been created by querying the " "``sqlite_master`` table built-in to SQLite, which should now contain an " "entry for the ``movie`` table definition (see `The Schema Table`_ for " -"details). Execute that query by calling :meth:`cur.execute(...) `, assign the result to ``res``, and call :meth:`res.fetchone() " -"` to fetch the resulting row:" +"details). Execute that query by calling :meth:`cur.execute(...) " +"`, assign the result to ``res``, and " +"call :meth:`res.fetchone() ` to fetch the resulting row:" msgstr "" msgid "" @@ -163,9 +165,10 @@ msgstr "" "('movie',)" msgid "" -"We can see that the table has been created, as the query returns a :class:" -"`tuple` containing the table's name. If we query ``sqlite_master`` for a non-" -"existent table ``spam``, :meth:`!res.fetchone` will return ``None``:" +"We can see that the table has been created, as the query returns " +"a :class:`tuple` containing the table's name. If we query ``sqlite_master`` " +"for a non-existent table ``spam``, :meth:`!res.fetchone` will return " +"``None``:" msgstr "" msgid "" @@ -176,8 +179,8 @@ msgstr "" msgid "" "Now, add two rows of data supplied as SQL literals by executing an " -"``INSERT`` statement, once again by calling :meth:`cur.execute(...) `:" +"``INSERT`` statement, once again by calling :meth:`cur.execute(...) " +"`:" msgstr "" msgid "" @@ -191,8 +194,8 @@ msgstr "" msgid "" "The ``INSERT`` statement implicitly opens a transaction, which needs to be " "committed before changes are saved in the database (see :ref:`sqlite3-" -"controlling-transactions` for details). Call :meth:`con.commit() ` on the connection object to commit the transaction:" +"controlling-transactions` for details). Call :meth:`con.commit() " +"` on the connection object to commit the transaction:" msgstr "" msgid "con.commit()" @@ -201,8 +204,8 @@ msgstr "" msgid "" "We can verify that the data was inserted correctly by executing a ``SELECT`` " "query. Use the now-familiar :meth:`cur.execute(...) ` to " -"assign the result to ``res``, and call :meth:`res.fetchall() ` to return all resulting rows:" +"assign the result to ``res``, and call :meth:`res.fetchall() " +"` to return all resulting rows:" msgstr "" msgid "" @@ -220,8 +223,8 @@ msgid "" msgstr "" msgid "" -"Now, insert three more rows by calling :meth:`cur.executemany(...) `:" +"Now, insert three more rows by calling :meth:`cur.executemany(...) " +"`:" msgstr "" msgid "" @@ -263,9 +266,10 @@ msgid "" msgstr "" msgid "" -"Finally, verify that the database has been written to disk by calling :meth:" -"`con.close() ` to close the existing connection, opening a " -"new one, creating a new cursor, then querying the database:" +"Finally, verify that the database has been written to disk by " +"calling :meth:`con.close() ` to close the existing " +"connection, opening a new one, creating a new cursor, then querying the " +"database:" msgstr "" msgid "" @@ -310,7 +314,7 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "Module functions" msgstr "" @@ -328,9 +332,9 @@ msgid "" msgstr "" msgid "" -"How many seconds the connection should wait before raising an :exc:" -"`OperationalError` when a table is locked. If another connection opens a " -"transaction to modify a table, that table will be locked until the " +"How many seconds the connection should wait before raising " +"an :exc:`OperationalError` when a table is locked. If another connection " +"opens a transaction to modify a table, that table will be locked until the " "transaction is committed. Default five seconds." msgstr "" @@ -338,18 +342,19 @@ msgid "" "Control whether and how data types not :ref:`natively supported by SQLite " "` are looked up to be converted to Python types, using the " "converters registered with :func:`register_converter`. Set it to any " -"combination (using ``|``, bitwise or) of :const:`PARSE_DECLTYPES` and :const:" -"`PARSE_COLNAMES` to enable this. Column names take precedence over declared " -"types if both flags are set. By default (``0``), type detection is disabled." +"combination (using ``|``, bitwise or) of :const:`PARSE_DECLTYPES` " +"and :const:`PARSE_COLNAMES` to enable this. Column names take precedence " +"over declared types if both flags are set. By default (``0``), type " +"detection is disabled." msgstr "" msgid "" -"Control legacy transaction handling behaviour. See :attr:`Connection." -"isolation_level` and :ref:`sqlite3-transaction-control-isolation-level` for " -"more information. Can be ``\"DEFERRED\"`` (default), ``\"EXCLUSIVE\"`` or " -"``\"IMMEDIATE\"``; or ``None`` to disable opening transactions implicitly. " -"Has no effect unless :attr:`Connection.autocommit` is set to :const:" -"`~sqlite3.LEGACY_TRANSACTION_CONTROL` (the default)." +"Control legacy transaction handling behaviour. " +"See :attr:`Connection.isolation_level` and :ref:`sqlite3-transaction-control-" +"isolation-level` for more information. Can be ``\"DEFERRED\"`` (default), " +"``\"EXCLUSIVE\"`` or ``\"IMMEDIATE\"``; or ``None`` to disable opening " +"transactions implicitly. Has no effect unless :attr:`Connection.autocommit` " +"is set to :const:`~sqlite3.LEGACY_TRANSACTION_CONTROL` (the default)." msgstr "" msgid "" @@ -379,11 +384,11 @@ msgid "" msgstr "" msgid "" -"Control :pep:`249` transaction handling behaviour. See :attr:`Connection." -"autocommit` and :ref:`sqlite3-transaction-control-autocommit` for more " -"information. *autocommit* currently defaults to :const:`~sqlite3." -"LEGACY_TRANSACTION_CONTROL`. The default will change to ``False`` in a " -"future Python release." +"Control :pep:`249` transaction handling behaviour. " +"See :attr:`Connection.autocommit` and :ref:`sqlite3-transaction-control-" +"autocommit` for more information. *autocommit* currently defaults " +"to :const:`~sqlite3.LEGACY_TRANSACTION_CONTROL`. The default will change to " +"``False`` in a future Python release." msgstr "" msgid "Return type" @@ -516,8 +521,8 @@ msgid "" msgstr "" msgid "" -"Generated fields (for example ``MAX(p)``) are returned as :class:`str`. Use :" -"const:`!PARSE_COLNAMES` to enforce types for such queries." +"Generated fields (for example ``MAX(p)``) are returned as :class:`str`. " +"Use :const:`!PARSE_COLNAMES` to enforce types for such queries." msgstr "" msgid "" @@ -572,8 +577,8 @@ msgid "" msgstr "" msgid "" -"Version number of the runtime SQLite library as a :class:`tuple` of :class:" -"`integers `." +"Version number of the runtime SQLite library as a :class:`tuple` " +"of :class:`integers `." msgstr "" msgid "" @@ -650,8 +655,8 @@ msgid "Set *threadsafety* dynamically instead of hard-coding it to ``1``." msgstr "" msgid "" -"These constants are used for the :meth:`Connection.setconfig` and :meth:" -"`~Connection.getconfig` methods." +"These constants are used for the :meth:`Connection.setconfig` " +"and :meth:`~Connection.getconfig` methods." msgstr "" msgid "" @@ -673,16 +678,17 @@ msgstr "" msgid "" "Each open SQLite database is represented by a ``Connection`` object, which " -"is created using :func:`sqlite3.connect`. Their main purpose is creating :" -"class:`Cursor` objects, and :ref:`sqlite3-controlling-transactions`." +"is created using :func:`sqlite3.connect`. Their main purpose is " +"creating :class:`Cursor` objects, and :ref:`sqlite3-controlling-" +"transactions`." msgstr "" msgid ":ref:`sqlite3-connection-shortcuts`" msgstr ":ref:`sqlite3-connection-shortcuts`" msgid "" -"A :exc:`ResourceWarning` is emitted if :meth:`close` is not called before a :" -"class:`!Connection` object is deleted." +"A :exc:`ResourceWarning` is emitted if :meth:`close` is not called before " +"a :class:`!Connection` object is deleted." msgstr "" msgid "An SQLite database connection has the following attributes and methods:" @@ -690,8 +696,9 @@ msgstr "" msgid "" "Create and return a :class:`Cursor` object. The cursor method accepts a " -"single optional parameter *factory*. If supplied, this must be a :term:" -"`callable` returning an instance of :class:`Cursor` or its subclasses." +"single optional parameter *factory*. If supplied, this must be " +"a :term:`callable` returning an instance of :class:`Cursor` or its " +"subclasses." msgstr "" msgid "" @@ -730,16 +737,16 @@ msgstr "" msgid "" "Commit any pending transaction to the database. If :attr:`autocommit` is " -"``True``, or there is no open transaction, this method does nothing. If :" -"attr:`!autocommit` is ``False``, a new transaction is implicitly opened if a " -"pending transaction was committed by this method." +"``True``, or there is no open transaction, this method does nothing. " +"If :attr:`!autocommit` is ``False``, a new transaction is implicitly opened " +"if a pending transaction was committed by this method." msgstr "" msgid "" "Roll back to the start of any pending transaction. If :attr:`autocommit` is " -"``True``, or there is no open transaction, this method does nothing. If :" -"attr:`!autocommit` is ``False``, a new transaction is implicitly opened if a " -"pending transaction was rolled back by this method." +"``True``, or there is no open transaction, this method does nothing. " +"If :attr:`!autocommit` is ``False``, a new transaction is implicitly opened " +"if a pending transaction was rolled back by this method." msgstr "" msgid "" @@ -1035,16 +1042,16 @@ msgstr "" msgid "" "Call this method from a different thread to abort any queries that might be " -"executing on the connection. Aborted queries will raise an :exc:" -"`OperationalError`." +"executing on the connection. Aborted queries will raise " +"an :exc:`OperationalError`." msgstr "" msgid "" "Register :term:`callable` *authorizer_callback* to be invoked for each " "attempt to access a column of a table in the database. The callback should " -"return one of :const:`SQLITE_OK`, :const:`SQLITE_DENY`, or :const:" -"`SQLITE_IGNORE` to signal how access to the column should be handled by the " -"underlying SQLite library." +"return one of :const:`SQLITE_OK`, :const:`SQLITE_DENY`, " +"or :const:`SQLITE_IGNORE` to signal how access to the column should be " +"handled by the underlying SQLite library." msgstr "" msgid "" @@ -1105,10 +1112,11 @@ msgstr "" msgid "" "The only argument passed to the callback is the statement (as :class:`str`) " "that is being executed. The return value of the callback is ignored. Note " -"that the backend does not only run statements passed to the :meth:`Cursor." -"execute` methods. Other sources include the :ref:`transaction management " -"` of the :mod:`!sqlite3` module and the " -"execution of triggers defined in the current database." +"that the backend does not only run statements passed to " +"the :meth:`Cursor.execute` methods. Other sources include " +"the :ref:`transaction management ` of " +"the :mod:`!sqlite3` module and the execution of triggers defined in the " +"current database." msgstr "" msgid "Passing ``None`` as *trace_callback* will disable the trace callback." @@ -1137,8 +1145,8 @@ msgid "" "The :mod:`!sqlite3` module is not built with loadable extension support by " "default, because some platforms (notably macOS) have SQLite libraries which " "are compiled without this feature. To get loadable extension support, you " -"must pass the :option:`--enable-loadable-sqlite-extensions` option to :" -"program:`configure`." +"must pass the :option:`--enable-loadable-sqlite-extensions` option " +"to :program:`configure`." msgstr "" msgid "" @@ -1205,8 +1213,8 @@ msgstr "" msgid "" "Return an :term:`iterator` to dump the database as SQL source code. Useful " -"when saving an in-memory database for later restoration. Similar to the ``." -"dump`` command in the :program:`sqlite3` shell." +"when saving an in-memory database for later restoration. Similar to the " +"``.dump`` command in the :program:`sqlite3` shell." msgstr "" msgid "" @@ -1300,8 +1308,8 @@ msgid "If *category* is not recognised by the underlying SQLite library." msgstr "" msgid "" -"Example, query the maximum length of an SQL statement for :class:" -"`Connection` ``con`` (the default is 1000000000):" +"Example, query the maximum length of an SQL statement " +"for :class:`Connection` ``con`` (the default is 1000000000):" msgstr "" msgid "" @@ -1372,10 +1380,10 @@ msgid "" msgstr "" msgid "" -"Deserialize a :meth:`serialized ` database into a :class:" -"`Connection`. This method causes the database connection to disconnect from " -"database *name*, and reopen *name* as an in-memory database based on the " -"serialization contained in *data*." +"Deserialize a :meth:`serialized ` database into " +"a :class:`Connection`. This method causes the database connection to " +"disconnect from database *name*, and reopen *name* as an in-memory database " +"based on the serialization contained in *data*." msgstr "" msgid "A serialized database." @@ -1406,17 +1414,17 @@ msgid "" msgstr "" msgid "" -"``False``: Select :pep:`249`-compliant transaction behaviour, implying that :" -"mod:`!sqlite3` ensures a transaction is always open. Use :meth:`commit` and :" -"meth:`rollback` to close transactions." +"``False``: Select :pep:`249`-compliant transaction behaviour, implying " +"that :mod:`!sqlite3` ensures a transaction is always open. " +"Use :meth:`commit` and :meth:`rollback` to close transactions." msgstr "" msgid "This is the recommended value of :attr:`!autocommit`." msgstr "" msgid "" -"``True``: Use SQLite's `autocommit mode`_. :meth:`commit` and :meth:" -"`rollback` have no effect in this mode." +"``True``: Use SQLite's `autocommit mode`_. :meth:`commit` " +"and :meth:`rollback` have no effect in this mode." msgstr "" msgid "" @@ -1436,8 +1444,8 @@ msgid "See :ref:`sqlite3-transaction-control-autocommit` for more details." msgstr "" msgid "" -"The :attr:`isolation_level` attribute has no effect unless :attr:" -"`autocommit` is :data:`LEGACY_TRANSACTION_CONTROL`." +"The :attr:`isolation_level` attribute has no effect " +"unless :attr:`autocommit` is :data:`LEGACY_TRANSACTION_CONTROL`." msgstr "" msgid "" @@ -1473,15 +1481,18 @@ msgstr "" msgid "" "The initial :attr:`~Cursor.row_factory` for :class:`Cursor` objects created " -"from this connection. Assigning to this attribute does not affect the :attr:" -"`!row_factory` of existing cursors belonging to this connection, only new " -"ones. Is ``None`` by default, meaning each row is returned as a :class:" -"`tuple`." +"from this connection. Assigning to this attribute does not affect " +"the :attr:`!row_factory` of existing cursors belonging to this connection, " +"only new ones. Is ``None`` by default, meaning each row is returned as " +"a :class:`tuple`." msgstr "" msgid "See :ref:`sqlite3-howto-row-factory` for more details." msgstr "" +msgid "Deleting the ``row_factory`` attribute is no longer allowed." +msgstr "" + msgid "" "A :term:`callable` that accepts a :class:`bytes` parameter and returns a " "text representation of it. The callable is invoked for SQLite values with " @@ -1491,6 +1502,9 @@ msgstr "" msgid "See :ref:`sqlite3-howto-encoding` for more details." msgstr "" +msgid "Deleting the ``text_factory`` attribute is no longer allowed." +msgstr "" + msgid "" "Return the total number of database rows that have been modified, inserted, " "or deleted since the database connection was opened." @@ -1502,14 +1516,14 @@ msgstr "" msgid "" "A ``Cursor`` object represents a `database cursor`_ which is used to execute " "SQL statements, and manage the context of a fetch operation. Cursors are " -"created using :meth:`Connection.cursor`, or by using any of the :ref:" -"`connection shortcut methods `." +"created using :meth:`Connection.cursor`, or by using any of " +"the :ref:`connection shortcut methods `." msgstr "" msgid "" -"Cursor objects are :term:`iterators `, meaning that if you :meth:" -"`~Cursor.execute` a ``SELECT`` query, you can simply iterate over the cursor " -"to fetch the resulting rows:" +"Cursor objects are :term:`iterators `, meaning that if " +"you :meth:`~Cursor.execute` a ``SELECT`` query, you can simply iterate over " +"the cursor to fetch the resulting rows:" msgstr "" msgid "" @@ -1521,8 +1535,8 @@ msgid "A :class:`Cursor` instance has the following attributes and methods." msgstr "" msgid "" -"Execute a single SQL statement, optionally binding Python values using :ref:" -"`placeholders `." +"Execute a single SQL statement, optionally binding Python values " +"using :ref:`placeholders `." msgstr "" msgid "A single SQL statement." @@ -1541,16 +1555,17 @@ msgid "" msgstr "" msgid "" -"If :attr:`~Connection.autocommit` is :data:`LEGACY_TRANSACTION_CONTROL`, :" -"attr:`~Connection.isolation_level` is not ``None``, *sql* is an ``INSERT``, " -"``UPDATE``, ``DELETE``, or ``REPLACE`` statement, and there is no open " -"transaction, a transaction is implicitly opened before executing *sql*." +"If :attr:`~Connection.autocommit` " +"is :data:`LEGACY_TRANSACTION_CONTROL`, :attr:`~Connection.isolation_level` " +"is not ``None``, *sql* is an ``INSERT``, ``UPDATE``, ``DELETE``, or " +"``REPLACE`` statement, and there is no open transaction, a transaction is " +"implicitly opened before executing *sql*." msgstr "" msgid "" ":exc:`ProgrammingError` is emitted if :ref:`named placeholders ` are used and *parameters* is a sequence instead of a :class:" -"`dict`." +"placeholders>` are used and *parameters* is a sequence instead of " +"a :class:`dict`." msgstr "" msgid "Use :meth:`executescript` to execute multiple SQL statements." @@ -1600,11 +1615,11 @@ msgid "" msgstr "" msgid "" -"Execute the SQL statements in *sql_script*. If the :attr:`~Connection." -"autocommit` is :data:`LEGACY_TRANSACTION_CONTROL` and there is a pending " -"transaction, an implicit ``COMMIT`` statement is executed first. No other " -"implicit transaction control is performed; any transaction control must be " -"added to *sql_script*." +"Execute the SQL statements in *sql_script*. If " +"the :attr:`~Connection.autocommit` is :data:`LEGACY_TRANSACTION_CONTROL` and " +"there is a pending transaction, an implicit ``COMMIT`` statement is executed " +"first. No other implicit transaction control is performed; any transaction " +"control must be added to *sql_script*." msgstr "" msgid "*sql_script* must be a :class:`string `." @@ -1659,18 +1674,18 @@ msgid "Close the cursor now (rather than whenever ``__del__`` is called)." msgstr "" msgid "" -"The cursor will be unusable from this point forward; a :exc:" -"`ProgrammingError` exception will be raised if any operation is attempted " -"with the cursor." +"The cursor will be unusable from this point forward; " +"a :exc:`ProgrammingError` exception will be raised if any operation is " +"attempted with the cursor." msgstr "" msgid "Required by the DB-API. Does nothing in :mod:`!sqlite3`." msgstr "" msgid "" -"Read/write attribute that controls the number of rows returned by :meth:" -"`fetchmany`. The default value is 1 which means a single row would be " -"fetched per call." +"Read/write attribute that controls the number of rows returned " +"by :meth:`fetchmany`. The default value is 1 which means a single row would " +"be fetched per call." msgstr "" msgid "Negative values are rejected by raising :exc:`ValueError`." @@ -1678,9 +1693,9 @@ msgstr "" msgid "" "Read-only attribute that provides the SQLite database :class:`Connection` " -"belonging to the cursor. A :class:`Cursor` object created by calling :meth:" -"`con.cursor() ` will have a :attr:`connection` attribute " -"that refers to *con*:" +"belonging to the cursor. A :class:`Cursor` object created by " +"calling :meth:`con.cursor() ` will have " +"a :attr:`connection` attribute that refers to *con*:" msgstr "" msgid "" @@ -1734,18 +1749,18 @@ msgstr "" msgid "" "Defaults to what :attr:`Connection.row_factory` was set to when the :class:`!" -"Cursor` was created. Assigning to this attribute does not affect :attr:" -"`Connection.row_factory` of the parent connection." +"Cursor` was created. Assigning to this attribute does not " +"affect :attr:`Connection.row_factory` of the parent connection." msgstr "" msgid "Row objects" msgstr "" msgid "" -"A :class:`!Row` instance serves as a highly optimized :attr:`~Connection." -"row_factory` for :class:`Connection` objects. It supports iteration, " -"equality testing, :func:`len`, and :term:`mapping` access by column name and " -"index." +"A :class:`!Row` instance serves as a highly " +"optimized :attr:`~Connection.row_factory` for :class:`Connection` objects. " +"It supports iteration, equality testing, :func:`len`, and :term:`mapping` " +"access by column name and index." msgstr "" msgid "" @@ -1755,8 +1770,8 @@ msgstr "" msgid "" "Return a :class:`list` of column names as :class:`strings `. " -"Immediately after a query, it is the first member of each tuple in :attr:" -"`Cursor.description`." +"Immediately after a query, it is the first member of each tuple " +"in :attr:`Cursor.description`." msgstr "" msgid "Added support of slicing." @@ -1767,9 +1782,9 @@ msgstr "" msgid "" "A :class:`Blob` instance is a :term:`file-like object` that can read and " -"write data in an SQLite :abbr:`BLOB (Binary Large OBject)`. Call :func:" -"`len(blob) ` to get the size (number of bytes) of the blob. Use indices " -"and :term:`slices ` for direct access to the blob data." +"write data in an SQLite :abbr:`BLOB (Binary Large OBject)`. " +"Call :func:`len(blob) ` to get the size (number of bytes) of the blob. " +"Use indices and :term:`slices ` for direct access to the blob data." msgstr "" msgid "" @@ -1802,22 +1817,22 @@ msgid "Close the blob." msgstr "" msgid "" -"The blob will be unusable from this point onward. An :class:`~sqlite3." -"Error` (or subclass) exception will be raised if any further operation is " -"attempted with the blob." +"The blob will be unusable from this point onward. " +"An :class:`~sqlite3.Error` (or subclass) exception will be raised if any " +"further operation is attempted with the blob." msgstr "" msgid "" "Read *length* bytes of data from the blob at the current offset position. If " "the end of the blob is reached, the data up to :abbr:`EOF (End of File)` " -"will be returned. When *length* is not specified, or is negative, :meth:" -"`~Blob.read` will read until the end of the blob." +"will be returned. When *length* is not specified, or is " +"negative, :meth:`~Blob.read` will read until the end of the blob." msgstr "" msgid "" "Write *data* to the blob at the current offset. This function cannot change " -"the blob length. Writing beyond the end of the blob will raise :exc:" -"`ValueError`." +"the blob length. Writing beyond the end of the blob will " +"raise :exc:`ValueError`." msgstr "" msgid "Return the current access position of the blob." @@ -1864,8 +1879,8 @@ msgid "" msgstr "" msgid "" -"The numeric error code from the `SQLite API `_" +"The numeric error code from the `SQLite API `_" msgstr "" msgid "" @@ -1913,8 +1928,8 @@ msgstr "" msgid "" "Exception raised for :mod:`!sqlite3` API programming errors, for example " "supplying the wrong number of bindings to a query, or trying to operate on a " -"closed :class:`Connection`. ``ProgrammingError`` is a subclass of :exc:" -"`DatabaseError`." +"closed :class:`Connection`. ``ProgrammingError`` is a subclass " +"of :exc:`DatabaseError`." msgstr "" msgid "" @@ -2010,8 +2025,8 @@ msgid "" msgstr "" msgid "" -"A converter for :ref:`declared ` \"date\" types to :" -"class:`datetime.date` objects." +"A converter for :ref:`declared ` \"date\" types " +"to :class:`datetime.date` objects." msgstr "" msgid "" @@ -2028,7 +2043,7 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza komenda komendy" msgid "" "The :mod:`!sqlite3` module can be invoked as a script, using the " @@ -2230,8 +2245,8 @@ msgid "Explicit: set *detect_types* to :const:`PARSE_COLNAMES`" msgstr "" msgid "" -"Both: set *detect_types* to ``sqlite3.PARSE_DECLTYPES | sqlite3." -"PARSE_COLNAMES``. Column names take precedence over declared types." +"Both: set *detect_types* to ``sqlite3.PARSE_DECLTYPES | " +"sqlite3.PARSE_COLNAMES``. Column names take precedence over declared types." msgstr "" msgid "The following example illustrates the implicit and explicit approaches:" @@ -2325,14 +2340,14 @@ msgid "How to use connection shortcut methods" msgstr "" msgid "" -"Using the :meth:`~Connection.execute`, :meth:`~Connection.executemany`, and :" -"meth:`~Connection.executescript` methods of the :class:`Connection` class, " -"your code can be written more concisely because you don't have to create the " -"(often superfluous) :class:`Cursor` objects explicitly. Instead, the :class:" -"`Cursor` objects are created implicitly and these shortcut methods return " -"the cursor objects. This way, you can execute a ``SELECT`` statement and " -"iterate over it directly using only a single call on the :class:`Connection` " -"object." +"Using the :meth:`~Connection.execute`, :meth:`~Connection.executemany`, " +"and :meth:`~Connection.executescript` methods of the :class:`Connection` " +"class, your code can be written more concisely because you don't have to " +"create the (often superfluous) :class:`Cursor` objects explicitly. Instead, " +"the :class:`Cursor` objects are created implicitly and these shortcut " +"methods return the cursor objects. This way, you can execute a ``SELECT`` " +"statement and iterate over it directly using only a single call on " +"the :class:`Connection` object." msgstr "" msgid "" @@ -2380,14 +2395,14 @@ msgstr "" msgid "" "The context manager neither implicitly opens a new transaction nor closes " -"the connection. If you need a closing context manager, consider using :meth:" -"`contextlib.closing`." +"the connection. If you need a closing context manager, consider " +"using :meth:`contextlib.closing`." msgstr "" msgid "" "con = sqlite3.connect(\":memory:\")\n" -"con.execute(\"CREATE TABLE lang(id INTEGER PRIMARY KEY, name VARCHAR " -"UNIQUE)\")\n" +"con.execute(\"CREATE TABLE lang(id INTEGER PRIMARY KEY, name VARCHAR UNIQUE)" +"\")\n" "\n" "# Successful, con.commit() is called automatically afterwards\n" "with con:\n" @@ -2461,16 +2476,16 @@ msgid "How to create and use row factories" msgstr "" msgid "" -"By default, :mod:`!sqlite3` represents each row as a :class:`tuple`. If a :" -"class:`!tuple` does not suit your needs, you can use the :class:`sqlite3." -"Row` class or a custom :attr:`~Cursor.row_factory`." +"By default, :mod:`!sqlite3` represents each row as a :class:`tuple`. If " +"a :class:`!tuple` does not suit your needs, you can use " +"the :class:`sqlite3.Row` class or a custom :attr:`~Cursor.row_factory`." msgstr "" msgid "" -"While :attr:`!row_factory` exists as an attribute both on the :class:" -"`Cursor` and the :class:`Connection`, it is recommended to set :class:" -"`Connection.row_factory`, so all cursors created from the connection will " -"use the same row factory." +"While :attr:`!row_factory` exists as an attribute both on " +"the :class:`Cursor` and the :class:`Connection`, it is recommended to " +"set :class:`Connection.row_factory`, so all cursors created from the " +"connection will use the same row factory." msgstr "" msgid "" @@ -2565,9 +2580,9 @@ msgid "" msgstr "" msgid "" -"With some adjustments, the above recipe can be adapted to use a :class:" -"`~dataclasses.dataclass`, or any other custom class, instead of a :class:" -"`~collections.namedtuple`." +"With some adjustments, the above recipe can be adapted to use " +"a :class:`~dataclasses.dataclass`, or any other custom class, instead of " +"a :class:`~collections.namedtuple`." msgstr "" msgid "How to handle non-UTF-8 text encodings" @@ -2576,8 +2591,8 @@ msgstr "" msgid "" "By default, :mod:`!sqlite3` uses :class:`str` to adapt SQLite values with " "the ``TEXT`` data type. This works well for UTF-8 encoded text, but it might " -"fail for other encodings and invalid UTF-8. You can use a custom :attr:" -"`~Connection.text_factory` to handle such cases." +"fail for other encodings and invalid UTF-8. You can use a " +"custom :attr:`~Connection.text_factory` to handle such cases." msgstr "" msgid "" @@ -2585,9 +2600,9 @@ msgid "" "table columns with the ``TEXT`` data type containing non-UTF-8 encodings, or " "even arbitrary data. To demonstrate, let's assume we have a database with " "ISO-8859-2 (Latin-2) encoded text, for example a table of Czech-English " -"dictionary entries. Assuming we now have a :class:`Connection` instance :py:" -"data:`!con` connected to this database, we can decode the Latin-2 encoded " -"text using this :attr:`~Connection.text_factory`:" +"dictionary entries. Assuming we now have a :class:`Connection` " +"instance :py:data:`!con` connected to this database, we can decode the " +"Latin-2 encoded text using this :attr:`~Connection.text_factory`:" msgstr "" msgid "con.text_factory = lambda data: str(data, encoding=\"latin2\")" @@ -2626,9 +2641,9 @@ msgid "Transaction control via the ``autocommit`` attribute" msgstr "" msgid "" -"The recommended way of controlling transaction behaviour is through the :" -"attr:`Connection.autocommit` attribute, which should preferably be set using " -"the *autocommit* parameter of :func:`connect`." +"The recommended way of controlling transaction behaviour is through " +"the :attr:`Connection.autocommit` attribute, which should preferably be set " +"using the *autocommit* parameter of :func:`connect`." msgstr "" msgid "" @@ -2637,11 +2652,11 @@ msgid "" msgstr "" msgid "" -":mod:`!sqlite3` ensures that a transaction is always open, so :func:" -"`connect`, :meth:`Connection.commit`, and :meth:`Connection.rollback` will " -"implicitly open a new transaction (immediately after closing the pending " -"one, for the latter two). :mod:`!sqlite3` uses ``BEGIN DEFERRED`` statements " -"when opening transactions." +":mod:`!sqlite3` ensures that a transaction is always open, " +"so :func:`connect`, :meth:`Connection.commit`, " +"and :meth:`Connection.rollback` will implicitly open a new transaction " +"(immediately after closing the pending one, for the latter two). :mod:`!" +"sqlite3` uses ``BEGIN DEFERRED`` statements when opening transactions." msgstr "" msgid "Transactions should be committed explicitly using :meth:`!commit`." @@ -2651,51 +2666,52 @@ msgid "Transactions should be rolled back explicitly using :meth:`!rollback`." msgstr "" msgid "" -"An implicit rollback is performed if the database is :meth:`~Connection." -"close`-ed with pending changes." +"An implicit rollback is performed if the database " +"is :meth:`~Connection.close`-ed with pending changes." msgstr "" msgid "" "Set *autocommit* to ``True`` to enable SQLite's `autocommit mode`_. In this " "mode, :meth:`Connection.commit` and :meth:`Connection.rollback` have no " "effect. Note that SQLite's autocommit mode is distinct from the :pep:`249`-" -"compliant :attr:`Connection.autocommit` attribute; use :attr:`Connection." -"in_transaction` to query the low-level SQLite autocommit mode." +"compliant :attr:`Connection.autocommit` attribute; " +"use :attr:`Connection.in_transaction` to query the low-level SQLite " +"autocommit mode." msgstr "" msgid "" "Set *autocommit* to :data:`LEGACY_TRANSACTION_CONTROL` to leave transaction " -"control behaviour to the :attr:`Connection.isolation_level` attribute. See :" -"ref:`sqlite3-transaction-control-isolation-level` for more information." +"control behaviour to the :attr:`Connection.isolation_level` attribute. " +"See :ref:`sqlite3-transaction-control-isolation-level` for more information." msgstr "" msgid "Transaction control via the ``isolation_level`` attribute" msgstr "" msgid "" -"The recommended way of controlling transactions is via the :attr:" -"`~Connection.autocommit` attribute. See :ref:`sqlite3-transaction-control-" -"autocommit`." +"The recommended way of controlling transactions is via " +"the :attr:`~Connection.autocommit` attribute. See :ref:`sqlite3-transaction-" +"control-autocommit`." msgstr "" msgid "" -"If :attr:`Connection.autocommit` is set to :data:" -"`LEGACY_TRANSACTION_CONTROL` (the default), transaction behaviour is " -"controlled using the :attr:`Connection.isolation_level` attribute. " +"If :attr:`Connection.autocommit` is set " +"to :data:`LEGACY_TRANSACTION_CONTROL` (the default), transaction behaviour " +"is controlled using the :attr:`Connection.isolation_level` attribute. " "Otherwise, :attr:`!isolation_level` has no effect." msgstr "" msgid "" "If the connection attribute :attr:`~Connection.isolation_level` is not " -"``None``, new transactions are implicitly opened before :meth:`~Cursor." -"execute` and :meth:`~Cursor.executemany` executes ``INSERT``, ``UPDATE``, " -"``DELETE``, or ``REPLACE`` statements; for other statements, no implicit " -"transaction handling is performed. Use the :meth:`~Connection.commit` and :" -"meth:`~Connection.rollback` methods to respectively commit and roll back " -"pending transactions. You can choose the underlying `SQLite transaction " -"behaviour`_ — that is, whether and what type of ``BEGIN`` statements :mod:`!" -"sqlite3` implicitly executes – via the :attr:`~Connection.isolation_level` " -"attribute." +"``None``, new transactions are implicitly opened " +"before :meth:`~Cursor.execute` and :meth:`~Cursor.executemany` executes " +"``INSERT``, ``UPDATE``, ``DELETE``, or ``REPLACE`` statements; for other " +"statements, no implicit transaction handling is performed. Use " +"the :meth:`~Connection.commit` and :meth:`~Connection.rollback` methods to " +"respectively commit and roll back pending transactions. You can choose the " +"underlying `SQLite transaction behaviour`_ — that is, whether and what type " +"of ``BEGIN`` statements :mod:`!sqlite3` implicitly executes – via " +"the :attr:`~Connection.isolation_level` attribute." msgstr "" msgid "" @@ -2703,8 +2719,8 @@ msgid "" "are implicitly opened at all. This leaves the underlying SQLite library in " "`autocommit mode`_, but also allows the user to perform their own " "transaction handling using explicit SQL statements. The underlying SQLite " -"library autocommit mode can be queried using the :attr:`~Connection." -"in_transaction` attribute." +"library autocommit mode can be queried using " +"the :attr:`~Connection.in_transaction` attribute." msgstr "" msgid "" @@ -2719,8 +2735,8 @@ msgid "" msgstr "" msgid "" -"The recommended way of controlling transactions is now via the :attr:" -"`~Connection.autocommit` attribute." +"The recommended way of controlling transactions is now via " +"the :attr:`~Connection.autocommit` attribute." msgstr "" msgid "? (question mark)" diff --git a/library/ssl.po b/library/ssl.po index b09fce27bc..e3a64dbd93 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -4,17 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -45,8 +44,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "" "Some behavior may be platform dependent, since calls are made to the " @@ -81,8 +80,8 @@ msgid "" "also encrypts and decrypts the data going over the socket with SSL. It " "supports additional methods such as :meth:`getpeercert`, which retrieves the " "certificate of the other side of the connection, :meth:`cipher`, which " -"retrieves the cipher being used for the secure connection or :meth:" -"`get_verified_chain`, :meth:`get_unverified_chain` which retrieves " +"retrieves the cipher being used for the secure connection " +"or :meth:`get_verified_chain`, :meth:`get_unverified_chain` which retrieves " "certificate chain." msgstr "" @@ -116,9 +115,10 @@ msgid "Socket creation" msgstr "" msgid "" -"Instances of :class:`SSLSocket` must be created using the :meth:`SSLContext." -"wrap_socket` method. The helper function :func:`create_default_context` " -"returns a new context with secure default settings." +"Instances of :class:`SSLSocket` must be created using " +"the :meth:`SSLContext.wrap_socket` method. The helper " +"function :func:`create_default_context` returns a new context with secure " +"default settings." msgstr "" msgid "Client socket example with default context and IPv4/IPv6 dual stack::" @@ -188,13 +188,13 @@ msgid "" msgstr "" msgid "" -"The settings are: :data:`PROTOCOL_TLS_CLIENT` or :data:" -"`PROTOCOL_TLS_SERVER`, :data:`OP_NO_SSLv2`, and :data:`OP_NO_SSLv3` with " -"high encryption cipher suites without RC4 and without unauthenticated cipher " -"suites. Passing :const:`~Purpose.SERVER_AUTH` as *purpose* sets :data:" -"`~SSLContext.verify_mode` to :data:`CERT_REQUIRED` and either loads CA " -"certificates (when at least one of *cafile*, *capath* or *cadata* is given) " -"or uses :meth:`SSLContext.load_default_certs` to load default CA " +"The settings are: :data:`PROTOCOL_TLS_CLIENT` " +"or :data:`PROTOCOL_TLS_SERVER`, :data:`OP_NO_SSLv2`, and :data:`OP_NO_SSLv3` " +"with high encryption cipher suites without RC4 and without unauthenticated " +"cipher suites. Passing :const:`~Purpose.SERVER_AUTH` as *purpose* " +"sets :data:`~SSLContext.verify_mode` to :data:`CERT_REQUIRED` and either " +"loads CA certificates (when at least one of *cafile*, *capath* or *cadata* " +"is given) or uses :meth:`SSLContext.load_default_certs` to load default CA " "certificates." msgstr "" @@ -205,10 +205,10 @@ msgid "" msgstr "" msgid "" -"The default settings for this context include :data:" -"`VERIFY_X509_PARTIAL_CHAIN` and :data:`VERIFY_X509_STRICT`. These make the " -"underlying OpenSSL implementation behave more like a conforming " -"implementation of :rfc:`5280`, in exchange for a small amount of " +"The default settings for this context " +"include :data:`VERIFY_X509_PARTIAL_CHAIN` and :data:`VERIFY_X509_STRICT`. " +"These make the underlying OpenSSL implementation behave more like a " +"conforming implementation of :rfc:`5280`, in exchange for a small amount of " "incompatibility with older X.509 certificates." msgstr "" @@ -219,8 +219,8 @@ msgid "" msgstr "" msgid "" -"If your application needs specific settings, you should create a :class:" -"`SSLContext` and apply the settings yourself." +"If your application needs specific settings, you should create " +"a :class:`SSLContext` and apply the settings yourself." msgstr "" msgid "" @@ -228,9 +228,9 @@ msgid "" "with a :class:`SSLContext` created by this function that they get an error " "stating \"Protocol or cipher suite mismatch\", it may be that they only " "support SSL3.0 which this function excludes using the :data:`OP_NO_SSLv3`. " -"SSL3.0 is widely considered to be `completely broken `_. If you still wish to continue to use this function but " -"still allow SSL 3.0 connections you can re-enable them using::" +"SSL3.0 is widely considered to be `completely broken `_. If you still wish to continue to use this " +"function but still allow SSL 3.0 connections you can re-enable them using::" msgstr "" msgid "" @@ -263,13 +263,14 @@ msgid "Support for key logging to :envvar:`SSLKEYLOGFILE` was added." msgstr "" msgid "" -"The context now uses :data:`PROTOCOL_TLS_CLIENT` or :data:" -"`PROTOCOL_TLS_SERVER` protocol instead of generic :data:`PROTOCOL_TLS`." +"The context now uses :data:`PROTOCOL_TLS_CLIENT` " +"or :data:`PROTOCOL_TLS_SERVER` protocol instead of " +"generic :data:`PROTOCOL_TLS`." msgstr "" msgid "" -"The context now uses :data:`VERIFY_X509_PARTIAL_CHAIN` and :data:" -"`VERIFY_X509_STRICT` in its default verify flags." +"The context now uses :data:`VERIFY_X509_PARTIAL_CHAIN` " +"and :data:`VERIFY_X509_STRICT` in its default verify flags." msgstr "" msgid "Exceptions" @@ -349,11 +350,11 @@ msgid "Random generation" msgstr "" msgid "" -"Return *num* cryptographically strong pseudo-random bytes. Raises an :class:" -"`SSLError` if the PRNG has not been seeded with enough data or if the " -"operation is not supported by the current RAND method. :func:`RAND_status` " -"can be used to check the status of the PRNG and :func:`RAND_add` can be used " -"to seed the PRNG." +"Return *num* cryptographically strong pseudo-random bytes. Raises " +"an :class:`SSLError` if the PRNG has not been seeded with enough data or if " +"the operation is not supported by the current RAND " +"method. :func:`RAND_status` can be used to check the status of the PRNG " +"and :func:`RAND_add` can be used to seed the PRNG." msgstr "" msgid "For almost all applications :func:`os.urandom` is preferable." @@ -368,9 +369,9 @@ msgstr "" msgid "" "Return ``True`` if the SSL pseudo-random number generator has been seeded " -"with 'enough' randomness, and ``False`` otherwise. You can use :func:`ssl." -"RAND_egd` and :func:`ssl.RAND_add` to increase the randomness of the pseudo-" -"random number generator." +"with 'enough' randomness, and ``False`` otherwise. You can " +"use :func:`ssl.RAND_egd` and :func:`ssl.RAND_add` to increase the randomness " +"of the pseudo-random number generator." msgstr "" msgid "" @@ -420,19 +421,19 @@ msgid "" "PEM-encoded string. If ``ssl_version`` is specified, uses that version of " "the SSL protocol to attempt to connect to the server. If *ca_certs* is " "specified, it should be a file containing a list of root certificates, the " -"same format as used for the *cafile* parameter in :meth:`SSLContext." -"load_verify_locations`. The call will attempt to validate the server " -"certificate against that set of root certificates, and will fail if the " -"validation attempt fails. A timeout can be specified with the ``timeout`` " -"parameter." +"same format as used for the *cafile* parameter " +"in :meth:`SSLContext.load_verify_locations`. The call will attempt to " +"validate the server certificate against that set of root certificates, and " +"will fail if the validation attempt fails. A timeout can be specified with " +"the ``timeout`` parameter." msgstr "" msgid "This function is now IPv6-compatible." msgstr "" msgid "" -"The default *ssl_version* is changed from :data:`PROTOCOL_SSLv3` to :data:" -"`PROTOCOL_TLS` for maximum compatibility with modern servers." +"The default *ssl_version* is changed from :data:`PROTOCOL_SSLv3` " +"to :data:`PROTOCOL_TLS` for maximum compatibility with modern servers." msgstr "" msgid "The *timeout* parameter was added." @@ -488,10 +489,11 @@ msgstr "" msgid "" "The function returns a list of (cert_bytes, encoding_type, trust) tuples. " -"The encoding_type specifies the encoding of cert_bytes. It is either :const:" -"`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for PKCS#7 ASN.1 " -"data. Trust specifies the purpose of the certificate as a set of OIDS or " -"exactly ``True`` if the certificate is trustworthy for all purposes." +"The encoding_type specifies the encoding of cert_bytes. It is " +"either :const:`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for " +"PKCS#7 ASN.1 data. Trust specifies the purpose of the certificate as a set " +"of OIDS or exactly ``True`` if the certificate is trustworthy for all " +"purposes." msgstr "" msgid "Example::" @@ -513,8 +515,9 @@ msgstr "" msgid "" "The function returns a list of (cert_bytes, encoding_type, trust) tuples. " -"The encoding_type specifies the encoding of cert_bytes. It is either :const:" -"`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for PKCS#7 ASN.1 data." +"The encoding_type specifies the encoding of cert_bytes. It is " +"either :const:`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for " +"PKCS#7 ASN.1 data." msgstr "" msgid "Constants" @@ -526,10 +529,11 @@ msgid "" msgstr "" msgid "" -"Possible value for :attr:`SSLContext.verify_mode`. Except for :const:" -"`PROTOCOL_TLS_CLIENT`, it is the default mode. With client-side sockets, " -"just about any cert is accepted. Validation errors, such as untrusted or " -"expired cert, are ignored and do not abort the TLS/SSL handshake." +"Possible value for :attr:`SSLContext.verify_mode`. Except " +"for :const:`PROTOCOL_TLS_CLIENT`, it is the default mode. With client-side " +"sockets, just about any cert is accepted. Validation errors, such as " +"untrusted or expired cert, are ignored and do not abort the TLS/SSL " +"handshake." msgstr "" msgid "" @@ -541,9 +545,10 @@ msgid "See the discussion of :ref:`ssl-security` below." msgstr "" msgid "" -"Possible value for :attr:`SSLContext.verify_mode`. In client mode, :const:" -"`CERT_OPTIONAL` has the same meaning as :const:`CERT_REQUIRED`. It is " -"recommended to use :const:`CERT_REQUIRED` for client-side sockets instead." +"Possible value for :attr:`SSLContext.verify_mode`. In client " +"mode, :const:`CERT_OPTIONAL` has the same meaning as :const:`CERT_REQUIRED`. " +"It is recommended to use :const:`CERT_REQUIRED` for client-side sockets " +"instead." msgstr "" msgid "" @@ -555,19 +560,20 @@ msgid "" msgstr "" msgid "" -"Use of this setting requires a valid set of CA certificates to be passed to :" -"meth:`SSLContext.load_verify_locations`." +"Use of this setting requires a valid set of CA certificates to be passed " +"to :meth:`SSLContext.load_verify_locations`." msgstr "" msgid "" "Possible value for :attr:`SSLContext.verify_mode`. In this mode, " -"certificates are required from the other side of the socket connection; an :" -"class:`SSLError` will be raised if no certificate is provided, or if its " +"certificates are required from the other side of the socket connection; " +"an :class:`SSLError` will be raised if no certificate is provided, or if its " "validation fails. This mode is **not** sufficient to verify a certificate in " -"client mode as it does not match hostnames. :attr:`~SSLContext." -"check_hostname` must be enabled as well to verify the authenticity of a " -"cert. :const:`PROTOCOL_TLS_CLIENT` uses :const:`CERT_REQUIRED` and enables :" -"attr:`~SSLContext.check_hostname` by default." +"client mode as it does not match " +"hostnames. :attr:`~SSLContext.check_hostname` must be enabled as well to " +"verify the authenticity of a cert. :const:`PROTOCOL_TLS_CLIENT` " +"uses :const:`CERT_REQUIRED` and enables :attr:`~SSLContext.check_hostname` " +"by default." msgstr "" msgid "" @@ -589,8 +595,8 @@ msgid "" "Possible value for :attr:`SSLContext.verify_flags`. In this mode, only the " "peer cert is checked but none of the intermediate CA certificates. The mode " "requires a valid CRL that is signed by the peer cert's issuer (its direct " -"ancestor CA). If no proper CRL has been loaded with :attr:`SSLContext." -"load_verify_locations`, validation will fail." +"ancestor CA). If no proper CRL has been loaded " +"with :attr:`SSLContext.load_verify_locations`, validation will fail." msgstr "" msgid "" @@ -633,8 +639,8 @@ msgstr "" msgid "" "TLS clients and servers require different default settings for secure " -"communication. The generic TLS protocol constant is deprecated in favor of :" -"data:`PROTOCOL_TLS_CLIENT` and :data:`PROTOCOL_TLS_SERVER`." +"communication. The generic TLS protocol constant is deprecated in favor " +"of :data:`PROTOCOL_TLS_CLIENT` and :data:`PROTOCOL_TLS_SERVER`." msgstr "" msgid "" @@ -668,9 +674,9 @@ msgstr "" msgid "" "OpenSSL has deprecated all version specific protocols. Use the default " -"protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` with :" -"attr:`SSLContext.minimum_version` and :attr:`SSLContext.maximum_version` " -"instead." +"protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` " +"with :attr:`SSLContext.minimum_version` " +"and :attr:`SSLContext.maximum_version` instead." msgstr "" msgid "Selects TLS version 1.0 as the channel encryption protocol." @@ -720,8 +726,9 @@ msgid "" msgstr "" msgid "" -"The option is deprecated since OpenSSL 1.1.0, use the new :attr:`SSLContext." -"minimum_version` and :attr:`SSLContext.maximum_version` instead." +"The option is deprecated since OpenSSL 1.1.0, use the " +"new :attr:`SSLContext.minimum_version` " +"and :attr:`SSLContext.maximum_version` instead." msgstr "" msgid "" @@ -929,33 +936,34 @@ msgid "" msgstr "" msgid "" -"Used as the return value of the callback function in :meth:`SSLContext." -"set_servername_callback`." +"Used as the return value of the callback function " +"in :meth:`SSLContext.set_servername_callback`." msgstr "" msgid ":class:`enum.IntEnum` collection of ALERT_DESCRIPTION_* constants." msgstr "" msgid "" -"Option for :func:`create_default_context` and :meth:`SSLContext." -"load_default_certs`. This value indicates that the context may be used to " -"authenticate web servers (therefore, it will be used to create client-side " -"sockets)." +"Option for :func:`create_default_context` " +"and :meth:`SSLContext.load_default_certs`. This value indicates that the " +"context may be used to authenticate web servers (therefore, it will be used " +"to create client-side sockets)." msgstr "" msgid "" -"Option for :func:`create_default_context` and :meth:`SSLContext." -"load_default_certs`. This value indicates that the context may be used to " -"authenticate web clients (therefore, it will be used to create server-side " -"sockets)." +"Option for :func:`create_default_context` " +"and :meth:`SSLContext.load_default_certs`. This value indicates that the " +"context may be used to authenticate web clients (therefore, it will be used " +"to create server-side sockets)." msgstr "" msgid ":class:`enum.IntEnum` collection of SSL_ERROR_* constants." msgstr "" msgid "" -":class:`enum.IntEnum` collection of SSL and TLS versions for :attr:" -"`SSLContext.maximum_version` and :attr:`SSLContext.minimum_version`." +":class:`enum.IntEnum` collection of SSL and TLS versions " +"for :attr:`SSLContext.maximum_version` " +"and :attr:`SSLContext.minimum_version`." msgstr "" msgid "" @@ -968,8 +976,8 @@ msgid "SSL 3.0 to TLS 1.3." msgstr "" msgid "" -"All :class:`TLSVersion` members except :attr:`TLSVersion.TLSv1_2` and :attr:" -"`TLSVersion.TLSv1_3` are deprecated." +"All :class:`TLSVersion` members except :attr:`TLSVersion.TLSv1_2` " +"and :attr:`TLSVersion.TLSv1_3` are deprecated." msgstr "" msgid "SSL sockets" @@ -1002,9 +1010,7 @@ msgstr ":meth:`~socket.socket.getpeername`, :meth:`~socket.socket.getsockname`" msgid ":meth:`~socket.socket.getsockopt`, :meth:`~socket.socket.setsockopt`" msgstr ":meth:`~socket.socket.getsockopt`, :meth:`~socket.socket.setsockopt`" -msgid "" -":meth:`~socket.socket.gettimeout`, :meth:`~socket.socket.settimeout`, :meth:" -"`~socket.socket.setblocking`" +msgid ":meth:`~socket.socket.gettimeout`, :meth:`~socket.socket.settimeout`, :meth:`~socket.socket.setblocking`" msgstr "" msgid ":meth:`~socket.socket.listen`" @@ -1039,8 +1045,8 @@ msgid "" msgstr "" msgid "" -"Instances of :class:`SSLSocket` must be created using the :meth:`SSLContext." -"wrap_socket` method." +"Instances of :class:`SSLSocket` must be created using " +"the :meth:`SSLContext.wrap_socket` method." msgstr "" msgid "The :meth:`sendfile` method was added." @@ -1053,14 +1059,15 @@ msgid "" msgstr "" msgid "" -"It is deprecated to create a :class:`SSLSocket` instance directly, use :meth:" -"`SSLContext.wrap_socket` to wrap a socket." +"It is deprecated to create a :class:`SSLSocket` instance directly, " +"use :meth:`SSLContext.wrap_socket` to wrap a socket." msgstr "" msgid "" -":class:`SSLSocket` instances must to created with :meth:`~SSLContext." -"wrap_socket`. In earlier versions, it was possible to create instances " -"directly. This was never documented or officially supported." +":class:`SSLSocket` instances must be created " +"with :meth:`~SSLContext.wrap_socket`. In earlier versions, it was possible " +"to create instances directly. This was never documented or officially " +"supported." msgstr "" msgid "" @@ -1079,8 +1086,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket is :" -"ref:`non-blocking ` and the read would block." +"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket " +"is :ref:`non-blocking ` and the read would block." msgstr "" msgid "" @@ -1103,8 +1110,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket is :" -"ref:`non-blocking ` and the write would block." +"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket " +"is :ref:`non-blocking ` and the write would block." msgstr "" msgid "" @@ -1124,28 +1131,29 @@ msgid "" "The :meth:`~SSLSocket.read` and :meth:`~SSLSocket.write` methods are the low-" "level methods that read and write unencrypted, application-level data and " "decrypt/encrypt it to encrypted, wire-level data. These methods require an " -"active SSL connection, i.e. the handshake was completed and :meth:`SSLSocket." -"unwrap` was not called." +"active SSL connection, i.e. the handshake was completed " +"and :meth:`SSLSocket.unwrap` was not called." msgstr "" msgid "" -"Normally you should use the socket API methods like :meth:`~socket.socket." -"recv` and :meth:`~socket.socket.send` instead of these methods." +"Normally you should use the socket API methods " +"like :meth:`~socket.socket.recv` and :meth:`~socket.socket.send` instead of " +"these methods." msgstr "" msgid "Perform the SSL setup handshake." msgstr "" msgid "" -"If *block* is true and the timeout obtained by :meth:`~socket.socket." -"gettimeout` is zero, the socket is set in blocking mode until the handshake " -"is performed." +"If *block* is true and the timeout obtained " +"by :meth:`~socket.socket.gettimeout` is zero, the socket is set in blocking " +"mode until the handshake is performed." msgstr "" msgid "" -"The handshake method also performs :func:`!match_hostname` when the :attr:" -"`~SSLContext.check_hostname` attribute of the socket's :attr:`~SSLSocket." -"context` is true." +"The handshake method also performs :func:`!match_hostname` when " +"the :attr:`~SSLContext.check_hostname` attribute of the " +"socket's :attr:`~SSLSocket.context` is true." msgstr "" msgid "" @@ -1154,16 +1162,16 @@ msgid "" msgstr "" msgid "" -"Hostname or IP address is matched by OpenSSL during handshake. The function :" -"func:`!match_hostname` is no longer used. In case OpenSSL refuses a hostname " -"or IP address, the handshake is aborted early and a TLS alert message is " -"sent to the peer." +"Hostname or IP address is matched by OpenSSL during handshake. The " +"function :func:`!match_hostname` is no longer used. In case OpenSSL refuses " +"a hostname or IP address, the handshake is aborted early and a TLS alert " +"message is sent to the peer." msgstr "" msgid "" "If there is no certificate for the peer on the other end of the connection, " -"return ``None``. If the SSL handshake hasn't been done yet, raise :exc:" -"`ValueError`." +"return ``None``. If the SSL handshake hasn't been done yet, " +"raise :exc:`ValueError`." msgstr "" msgid "" @@ -1221,9 +1229,9 @@ msgstr "" msgid "" "for a server SSL socket, the client will only provide a certificate when " -"requested by the server; therefore :meth:`getpeercert` will return :const:" -"`None` if you used :const:`CERT_NONE` (rather than :const:`CERT_OPTIONAL` " -"or :const:`CERT_REQUIRED`)." +"requested by the server; therefore :meth:`getpeercert` will " +"return :const:`None` if you used :const:`CERT_NONE` (rather " +"than :const:`CERT_OPTIONAL` or :const:`CERT_REQUIRED`)." msgstr "" msgid "See also :attr:`SSLContext.check_hostname`." @@ -1249,11 +1257,23 @@ msgid "" "disabled method acts the same as :meth:`~SSLSocket.get_unverified_chain`." msgstr "" +msgid "" +"The verified chain is not stored with a session, so the list is empty when " +"the session is resumed (see :attr:`~SSLSocket.session_reused`)." +msgstr "" + msgid "" "Returns raw certificate chain provided by the other end of the SSL channel " "as a list of DER-encoded bytes." msgstr "" +msgid "" +"No certificates are exchanged when a session is resumed " +"(see :attr:`~SSLSocket.session_reused`); the list then holds what was stored " +"with the session, which for a session resumed from a ticket on the server " +"side is the peer's own certificate only." +msgstr "" + msgid "" "Returns a three-value tuple containing the name of the cipher being used, " "the version of the SSL protocol that defines its use, and the number of " @@ -1288,16 +1308,17 @@ msgstr "" msgid "" "The *cb_type* parameter allow selection of the desired channel binding type. " "Valid channel binding types are listed in the :data:`CHANNEL_BINDING_TYPES` " -"list. Currently only the 'tls-unique' channel binding, defined by :rfc:" -"`5929`, is supported. :exc:`ValueError` will be raised if an unsupported " -"channel binding type is requested." +"list. Currently only the 'tls-unique' channel binding, defined " +"by :rfc:`5929`, is supported. :exc:`ValueError` will be raised if an " +"unsupported channel binding type is requested." msgstr "" msgid "" -"Return the protocol that was selected during the TLS handshake. If :meth:" -"`SSLContext.set_alpn_protocols` was not called, if the other party does not " -"support ALPN, if this socket does not support any of the client's proposed " -"protocols, or if the handshake has not happened yet, ``None`` is returned." +"Return the protocol that was selected during the TLS handshake. " +"If :meth:`SSLContext.set_alpn_protocols` was not called, if the other party " +"does not support ALPN, if this socket does not support any of the client's " +"proposed protocols, or if the handshake has not happened yet, ``None`` is " +"returned." msgstr "" msgid "" @@ -1321,8 +1342,8 @@ msgstr "" msgid "" "Requests post-handshake authentication (PHA) from a TLS 1.3 client. PHA can " "only be initiated for a TLS 1.3 connection from a server-side socket, after " -"the initial TLS handshake and with PHA enabled on both sides, see :attr:" -"`SSLContext.post_handshake_auth`." +"the initial TLS handshake and with PHA enabled on both sides, " +"see :attr:`SSLContext.post_handshake_auth`." msgstr "" msgid "" @@ -1332,8 +1353,8 @@ msgid "" msgstr "" msgid "" -"If any precondition isn't met (e.g. not TLS 1.3, PHA not enabled), an :exc:" -"`SSLError` is raised." +"If any precondition isn't met (e.g. not TLS 1.3, PHA not enabled), " +"an :exc:`SSLError` is raised." msgstr "" msgid "" @@ -1370,15 +1391,15 @@ msgstr "" msgid "" "The attribute is now always ASCII text. When ``server_hostname`` is an " "internationalized domain name (IDN), this attribute now stores the A-label " -"form (``\"xn--pythn-mua.org\"``), rather than the U-label form (``\"pythön." -"org\"``)." +"form (``\"xn--pythn-mua.org\"``), rather than the U-label form " +"(``\"pythön.org\"``)." msgstr "" msgid "" "The :class:`SSLSession` for this SSL connection. The session is available " "for client and server side sockets after the TLS handshake has been " -"performed. For client sockets the session can be set before :meth:" -"`~SSLSocket.do_handshake` has been called to reuse a session." +"performed. For client sockets the session can be set " +"before :meth:`~SSLSocket.do_handshake` has been called to reuse a session." msgstr "" msgid "SSL contexts" @@ -1477,26 +1498,25 @@ msgid "" msgstr "" msgid "" -"The context is created with secure default values. The options :data:" -"`OP_NO_COMPRESSION`, :data:`OP_CIPHER_SERVER_PREFERENCE`, :data:" -"`OP_SINGLE_DH_USE`, :data:`OP_SINGLE_ECDH_USE`, :data:`OP_NO_SSLv2`, and :" -"data:`OP_NO_SSLv3` (except for :data:`PROTOCOL_SSLv3`) are set by default. " -"The initial cipher suite list contains only ``HIGH`` ciphers, no ``NULL`` " -"ciphers and no ``MD5`` ciphers." +"The context is created with secure default values. The " +"options :data:`OP_NO_COMPRESSION`, :data:`OP_CIPHER_SERVER_PREFERENCE`, :data:`OP_SINGLE_DH_USE`, :data:`OP_SINGLE_ECDH_USE`, :data:`OP_NO_SSLv2`, " +"and :data:`OP_NO_SSLv3` (except for :data:`PROTOCOL_SSLv3`) are set by " +"default. The initial cipher suite list contains only ``HIGH`` ciphers, no " +"``NULL`` ciphers and no ``MD5`` ciphers." msgstr "" msgid "" ":class:`SSLContext` without protocol argument is deprecated. The context " -"class will either require :data:`PROTOCOL_TLS_CLIENT` or :data:" -"`PROTOCOL_TLS_SERVER` protocol in the future." +"class will either require :data:`PROTOCOL_TLS_CLIENT` " +"or :data:`PROTOCOL_TLS_SERVER` protocol in the future." msgstr "" msgid "" "The default cipher suites now include only secure AES and ChaCha20 ciphers " "with forward secrecy and security level 2. RSA and DH keys with less than " -"2048 bits and ECC keys with less than 224 bits are prohibited. :data:" -"`PROTOCOL_TLS`, :data:`PROTOCOL_TLS_CLIENT`, and :data:`PROTOCOL_TLS_SERVER` " -"use TLS 1.2 as minimum TLS version." +"2048 bits and ECC keys with less than 224 bits are " +"prohibited. :data:`PROTOCOL_TLS`, :data:`PROTOCOL_TLS_CLIENT`, " +"and :data:`PROTOCOL_TLS_SERVER` use TLS 1.2 as minimum TLS version." msgstr "" msgid "" @@ -1569,9 +1589,9 @@ msgstr "" msgid "" "Load a set of default \"certification authority\" (CA) certificates from " "default locations. On Windows it loads CA certs from the ``CA`` and ``ROOT`` " -"system stores. On all systems it calls :meth:`SSLContext." -"set_default_verify_paths`. In the future the method may load CA certificates " -"from other locations, too." +"system stores. On all systems it " +"calls :meth:`SSLContext.set_default_verify_paths`. In the future the method " +"may load CA certificates from other locations, too." msgstr "" msgid "" @@ -1584,8 +1604,9 @@ msgstr "" msgid "" "Load a set of \"certification authority\" (CA) certificates used to validate " -"other peers' certificates when :data:`verify_mode` is other than :data:" -"`CERT_NONE`. At least one of *cafile* or *capath* must be specified." +"other peers' certificates when :data:`verify_mode` is other " +"than :data:`CERT_NONE`. At least one of *cafile* or *capath* must be " +"specified." msgstr "" msgid "" @@ -1631,8 +1652,8 @@ msgid "" msgstr "" msgid "" -"Get a list of enabled ciphers. The list is in order of cipher priority. See :" -"meth:`SSLContext.set_ciphers`." +"Get a list of enabled ciphers. The list is in order of cipher priority. " +"See :meth:`SSLContext.set_ciphers`." msgstr "" msgid "" @@ -1688,15 +1709,15 @@ msgid "" msgstr "" msgid "" -"TLS 1.3 cipher suites cannot be disabled with :meth:`~SSLContext." -"set_ciphers`." +"TLS 1.3 cipher suites cannot be disabled " +"with :meth:`~SSLContext.set_ciphers`." msgstr "" msgid "" "Specify which protocols the socket should advertise during the SSL/TLS " -"handshake. It should be a list of ASCII strings, like ``['http/1.1', " -"'spdy/2']``, ordered by preference. The selection of a protocol will happen " -"during the handshake, and will play out according to :rfc:`7301`. After a " +"handshake. It should be a list of ASCII strings, like ``['http/1.1', 'spdy/" +"2']``, ordered by preference. The selection of a protocol will happen during " +"the handshake, and will play out according to :rfc:`7301`. After a " "successful handshake, the :meth:`SSLSocket.selected_alpn_protocol` method " "will return the agreed-upon protocol." msgstr "" @@ -1712,9 +1733,9 @@ msgid "" "ordered by preference. The selection of a protocol will happen during the " "handshake, and will play out according to the `Application Layer Protocol " "Negotiation `_. After a successful handshake, the :meth:" -"`SSLSocket.selected_npn_protocol` method will return the agreed-upon " -"protocol." +"Layer_Protocol_Negotiation>`_. After a successful handshake, " +"the :meth:`SSLSocket.selected_npn_protocol` method will return the agreed-" +"upon protocol." msgstr "" msgid "" @@ -1746,34 +1767,41 @@ msgid "" msgstr "" msgid "" -"A typical use of this callback is to change the :class:`ssl.SSLSocket`'s :" -"attr:`SSLSocket.context` attribute to a new object of type :class:" -"`SSLContext` representing a certificate chain that matches the server name." +"A typical use of this callback is to change " +"the :class:`ssl.SSLSocket`'s :attr:`SSLSocket.context` attribute to a new " +"object of type :class:`SSLContext` representing a certificate chain that " +"matches the server name." +msgstr "" + +msgid "" +"If the callback assigns a new context to :attr:`SSLSocket.context`, any " +"further ClientHello message on the same connection (for example after a TLS " +"1.3 HelloRetryRequest) is dispatched to the new context's *sni_callback*, if " +"it has one; the original callback is not called again for that connection." msgstr "" msgid "" "Due to the early negotiation phase of the TLS connection, only limited " -"methods and attributes are usable like :meth:`SSLSocket." -"selected_alpn_protocol` and :attr:`SSLSocket.context`. The :meth:`SSLSocket." -"getpeercert`, :meth:`SSLSocket.get_verified_chain`, :meth:`SSLSocket." -"get_unverified_chain` :meth:`SSLSocket.cipher` and :meth:`SSLSocket." -"compression` methods require that the TLS connection has progressed beyond " -"the TLS Client Hello and therefore will not return meaningful values nor can " -"they be called safely." +"methods and attributes are usable " +"like :meth:`SSLSocket.selected_alpn_protocol` and :attr:`SSLSocket.context`. " +"The :meth:`SSLSocket.getpeercert`, :meth:`SSLSocket.get_verified_chain`, :meth:`SSLSocket.get_unverified_chain` :meth:`SSLSocket.cipher` " +"and :meth:`SSLSocket.compression` methods require that the TLS connection " +"has progressed beyond the TLS Client Hello and therefore will not return " +"meaningful values nor can they be called safely." msgstr "" msgid "" "The *sni_callback* function must return ``None`` to allow the TLS " -"negotiation to continue. If a TLS failure is required, a constant :const:" -"`ALERT_DESCRIPTION_* ` can be returned. " -"Other return values will result in a TLS fatal error with :const:" -"`ALERT_DESCRIPTION_INTERNAL_ERROR`." +"negotiation to continue. If a TLS failure is required, a " +"constant :const:`ALERT_DESCRIPTION_* ` can " +"be returned. Other return values will result in a TLS fatal error " +"with :const:`ALERT_DESCRIPTION_INTERNAL_ERROR`." msgstr "" msgid "" "If an exception is raised from the *sni_callback* function the TLS " -"connection will terminate with a fatal TLS alert message :const:" -"`ALERT_DESCRIPTION_HANDSHAKE_FAILURE`." +"connection will terminate with a fatal TLS alert " +"message :const:`ALERT_DESCRIPTION_HANDSHAKE_FAILURE`." msgstr "" msgid "" @@ -1781,6 +1809,12 @@ msgid "" "OPENSSL_NO_TLSEXT defined when it was built." msgstr "" +msgid "" +"After the callback assigns a new :attr:`SSLSocket.context`, later " +"ClientHello messages on the connection are dispatched to the new context's " +"*sni_callback*." +msgstr "" + msgid "" "This is a legacy API retained for backwards compatibility. When possible, " "you should use :attr:`sni_callback` instead. The given " @@ -1804,8 +1838,8 @@ msgid "" msgstr "" msgid "" -"This setting doesn't apply to client sockets. You can also use the :data:" -"`OP_SINGLE_DH_USE` option to further improve security." +"This setting doesn't apply to client sockets. You can also use " +"the :data:`OP_SINGLE_DH_USE` option to further improve security." msgstr "" msgid "" @@ -1817,8 +1851,8 @@ msgid "" msgstr "" msgid "" -"This setting doesn't apply to client sockets. You can also use the :data:" -"`OP_SINGLE_ECDH_USE` option to further improve security." +"This setting doesn't apply to client sockets. You can also use " +"the :data:`OP_SINGLE_ECDH_USE` option to further improve security." msgstr "" msgid "This method is not available if :data:`HAS_ECDH` is ``False``." @@ -1833,10 +1867,11 @@ msgid "Vincent Bernat." msgstr "" msgid "" -"Wrap an existing Python socket *sock* and return an instance of :attr:" -"`SSLContext.sslsocket_class` (default :class:`SSLSocket`). The returned SSL " -"socket is tied to the context, its settings and certificates. *sock* must be " -"a :const:`~socket.SOCK_STREAM` socket; other socket types are unsupported." +"Wrap an existing Python socket *sock* and return an instance " +"of :attr:`SSLContext.sslsocket_class` (default :class:`SSLSocket`). The " +"returned SSL socket is tied to the context, its settings and certificates. " +"*sock* must be a :const:`~socket.SOCK_STREAM` socket; other socket types are " +"unsupported." msgstr "" msgid "" @@ -1850,8 +1885,8 @@ msgid "" "after :meth:`connect` is called on the socket. For server-side sockets, if " "the socket has no remote peer, it is assumed to be a listening socket, and " "the server-side SSL wrapping is automatically performed on client " -"connections accepted via the :meth:`accept` method. The method may raise :" -"exc:`SSLError`." +"connections accepted via the :meth:`accept` method. The method may " +"raise :exc:`SSLError`." msgstr "" msgid "" @@ -1865,27 +1900,27 @@ msgstr "" msgid "" "The parameter ``do_handshake_on_connect`` specifies whether to do the SSL " "handshake automatically after doing a :meth:`socket.connect`, or whether the " -"application program will call it explicitly, by invoking the :meth:" -"`SSLSocket.do_handshake` method. Calling :meth:`SSLSocket.do_handshake` " -"explicitly gives the program control over the blocking behavior of the " -"socket I/O involved in the handshake." +"application program will call it explicitly, by invoking " +"the :meth:`SSLSocket.do_handshake` method. " +"Calling :meth:`SSLSocket.do_handshake` explicitly gives the program control " +"over the blocking behavior of the socket I/O involved in the handshake." msgstr "" msgid "" -"The parameter ``suppress_ragged_eofs`` specifies how the :meth:`SSLSocket." -"recv` method should signal unexpected EOF from the other end of the " -"connection. If specified as :const:`True` (the default), it returns a " -"normal EOF (an empty bytes object) in response to unexpected EOF errors " -"raised from the underlying socket; if :const:`False`, it will raise the " -"exceptions back to the caller." +"The parameter ``suppress_ragged_eofs`` specifies how " +"the :meth:`SSLSocket.recv` method should signal unexpected EOF from the " +"other end of the connection. If specified as :const:`True` (the default), " +"it returns a normal EOF (an empty bytes object) in response to unexpected " +"EOF errors raised from the underlying socket; if :const:`False`, it will " +"raise the exceptions back to the caller." msgstr "" msgid "*session*, see :attr:`~SSLSocket.session`." msgstr "" msgid "" -"To wrap an :class:`SSLSocket` in another :class:`SSLSocket`, use :meth:" -"`SSLContext.wrap_bio`." +"To wrap an :class:`SSLSocket` in another :class:`SSLSocket`, " +"use :meth:`SSLContext.wrap_bio`." msgstr "" msgid "" @@ -1902,21 +1937,26 @@ msgid "" msgstr "" msgid "" -"The return type of :meth:`SSLContext.wrap_socket`, defaults to :class:" -"`SSLSocket`. The attribute can be assigned to on instances of :class:" -"`SSLContext` in order to return a custom subclass of :class:`SSLSocket`." +"The return type of :meth:`SSLContext.wrap_socket`, defaults " +"to :class:`SSLSocket`. The attribute can be assigned to on instances " +"of :class:`SSLContext` in order to return a custom subclass " +"of :class:`SSLSocket`." msgstr "" msgid "" -"Wrap the BIO objects *incoming* and *outgoing* and return an instance of :" -"attr:`SSLContext.sslobject_class` (default :class:`SSLObject`). The SSL " +"Wrap the BIO objects *incoming* and *outgoing* and return an instance " +"of :attr:`SSLContext.sslobject_class` (default :class:`SSLObject`). The SSL " "routines will read input data from the incoming BIO and write data to the " "outgoing BIO." msgstr "" msgid "" "The *server_side*, *server_hostname* and *session* parameters have the same " -"meaning as in :meth:`SSLContext.wrap_socket`." +"meaning as in :meth:`SSLContext.wrap_socket`, and are validated in the same " +"way: in particular a :exc:`ValueError` is raised " +"when :attr:`~SSLContext.check_hostname` is enabled but no *server_hostname* " +"is given, since there would be no name to match the peer's certificate " +"against." msgstr "" msgid "" @@ -1925,9 +1965,17 @@ msgid "" msgstr "" msgid "" -"The return type of :meth:`SSLContext.wrap_bio`, defaults to :class:" -"`SSLObject`. The attribute can be overridden on instance of class in order " -"to return a custom subclass of :class:`SSLObject`." +"The *server_side*, *server_hostname* and *session* parameters are now " +"validated as :meth:`SSLContext.wrap_socket` validates them. Previously a " +"context with :attr:`~SSLContext.check_hostname` enabled and no " +"*server_hostname* was accepted, and verified the certificate chain but never " +"the peer's identity." +msgstr "" + +msgid "" +"The return type of :meth:`SSLContext.wrap_bio`, defaults " +"to :class:`SSLObject`. The attribute can be overridden on instance of class " +"in order to return a custom subclass of :class:`SSLObject`." msgstr "" msgid "" @@ -1949,14 +1997,15 @@ msgstr "" msgid "" "Whether to match the peer cert's hostname in :meth:`SSLSocket.do_handshake`. " -"The context's :attr:`~SSLContext.verify_mode` must be set to :data:" -"`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, and you must pass " +"The context's :attr:`~SSLContext.verify_mode` must be set " +"to :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, and you must pass " "*server_hostname* to :meth:`~SSLContext.wrap_socket` in order to match the " -"hostname. Enabling hostname checking automatically sets :attr:`~SSLContext." -"verify_mode` from :data:`CERT_NONE` to :data:`CERT_REQUIRED`. It cannot be " -"set back to :data:`CERT_NONE` as long as hostname checking is enabled. The :" -"data:`PROTOCOL_TLS_CLIENT` protocol enables hostname checking by default. " -"With other protocols, hostname checking must be enabled explicitly." +"hostname. Enabling hostname checking automatically " +"sets :attr:`~SSLContext.verify_mode` from :data:`CERT_NONE` " +"to :data:`CERT_REQUIRED`. It cannot be set back to :data:`CERT_NONE` as " +"long as hostname checking is enabled. The :data:`PROTOCOL_TLS_CLIENT` " +"protocol enables hostname checking by default. With other protocols, " +"hostname checking must be enabled explicitly." msgstr "" msgid "" @@ -1973,10 +2022,10 @@ msgid "" msgstr "" msgid "" -":attr:`~SSLContext.verify_mode` is now automatically changed to :data:" -"`CERT_REQUIRED` when hostname checking is enabled and :attr:`~SSLContext." -"verify_mode` is :data:`CERT_NONE`. Previously the same operation would have " -"failed with a :exc:`ValueError`." +":attr:`~SSLContext.verify_mode` is now automatically changed " +"to :data:`CERT_REQUIRED` when hostname checking is enabled " +"and :attr:`~SSLContext.verify_mode` is :data:`CERT_NONE`. Previously the " +"same operation would have failed with a :exc:`ValueError`." msgstr "" msgid "" @@ -1990,17 +2039,20 @@ msgstr "" msgid "" "A :class:`TLSVersion` enum member representing the highest supported TLS " "version. The value defaults to :attr:`TLSVersion.MAXIMUM_SUPPORTED`. The " -"attribute is read-only for protocols other than :const:`PROTOCOL_TLS`, :" -"const:`PROTOCOL_TLS_CLIENT`, and :const:`PROTOCOL_TLS_SERVER`." +"attribute is read-only for protocols other " +"than :const:`PROTOCOL_TLS`, :const:`PROTOCOL_TLS_CLIENT`, " +"and :const:`PROTOCOL_TLS_SERVER`." msgstr "" msgid "" -"The attributes :attr:`~SSLContext.maximum_version`, :attr:`~SSLContext." -"minimum_version` and :attr:`SSLContext.options` all affect the supported SSL " -"and TLS versions of the context. The implementation does not prevent invalid " -"combination. For example a context with :attr:`OP_NO_TLSv1_2` in :attr:" -"`~SSLContext.options` and :attr:`~SSLContext.maximum_version` set to :attr:" -"`TLSVersion.TLSv1_2` will not be able to establish a TLS 1.2 connection." +"The " +"attributes :attr:`~SSLContext.maximum_version`, :attr:`~SSLContext.minimum_version` " +"and :attr:`SSLContext.options` all affect the supported SSL and TLS versions " +"of the context. The implementation does not prevent invalid combinations. " +"For example a context with :attr:`OP_NO_TLSv1_2` " +"in :attr:`~SSLContext.options` and :attr:`~SSLContext.maximum_version` set " +"to :attr:`TLSVersion.TLSv1_2` will not be able to establish a TLS 1.2 " +"connection." msgstr "" msgid "" @@ -2009,15 +2061,15 @@ msgid "" msgstr "" msgid "" -"Control the number of TLS 1.3 session tickets of a :const:" -"`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS 1.0 to 1.2 " -"connections." +"Control the number of TLS 1.3 session tickets of " +"a :const:`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS 1.0 " +"to 1.2 connections." msgstr "" msgid "" "An integer representing the set of SSL options enabled on this context. The " -"default value is :data:`OP_ALL`, but you can specify other options such as :" -"data:`OP_NO_SSLv2` by ORing them together." +"default value is :data:`OP_ALL`, but you can specify other options such " +"as :data:`OP_NO_SSLv2` by ORing them together." msgstr "" msgid ":attr:`SSLContext.options` returns :class:`Options` flags:" @@ -2025,8 +2077,8 @@ msgstr "" msgid "" "All ``OP_NO_SSL*`` and ``OP_NO_TLS*`` options have been deprecated since " -"Python 3.7. Use :attr:`SSLContext.minimum_version` and :attr:`SSLContext." -"maximum_version` instead." +"Python 3.7. Use :attr:`SSLContext.minimum_version` " +"and :attr:`SSLContext.maximum_version` instead." msgstr "" msgid "" @@ -2044,8 +2096,9 @@ msgstr "" msgid "" "When enabled on server-side sockets, :attr:`SSLContext.verify_mode` must be " "set to :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, too. The actual " -"client cert exchange is delayed until :meth:`SSLSocket." -"verify_client_post_handshake` is called and some I/O is performed." +"client cert exchange is delayed " +"until :meth:`SSLSocket.verify_client_post_handshake` is called and some I/O " +"is performed." msgstr "" msgid "" @@ -2071,9 +2124,9 @@ msgid "" msgstr "" msgid "" -"The flags for certificate verification operations. You can set flags like :" -"data:`VERIFY_CRL_CHECK_LEAF` by ORing them together. By default OpenSSL does " -"neither require nor verify certificate revocation lists (CRLs)." +"The flags for certificate verification operations. You can set flags " +"like :data:`VERIFY_CRL_CHECK_LEAF` by ORing them together. By default " +"OpenSSL does neither require nor verify certificate revocation lists (CRLs)." msgstr "" msgid ":attr:`SSLContext.verify_flags` returns :class:`VerifyFlags` flags:" @@ -2081,8 +2134,8 @@ msgstr "" msgid "" "Whether to try to verify other peers' certificates and how to behave if " -"verification fails. This attribute must be one of :data:`CERT_NONE`, :data:" -"`CERT_OPTIONAL` or :data:`CERT_REQUIRED`." +"verification fails. This attribute must be one " +"of :data:`CERT_NONE`, :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`." msgstr "" msgid ":attr:`SSLContext.verify_mode` returns :class:`VerifyMode` enum:" @@ -2105,7 +2158,8 @@ msgid "" "optional string which may be used by the server to select a corresponding " "PSK for the client. The string must be less than or equal to ``256`` octets " "when UTF-8 encoded. PSK is a :term:`bytes-like object` representing the pre-" -"shared key. Return a zero length PSK to reject the connection." +"shared key. With TLS 1.2 and earlier, return a zero length PSK to reject the " +"connection." msgstr "" msgid "Setting ``callback`` to :const:`None` removes any existing callback." @@ -2120,13 +2174,32 @@ msgstr "" msgid "client-identity must be a non-empty string." msgstr "" +msgid "" +"the PSK is only offered to the server, which may decline it and authenticate " +"with a certificate instead. That certificate is checked according " +"to :attr:`~SSLContext.verify_mode`, so a client relying on the PSK to " +"authenticate the server should not set it to :const:`CERT_NONE`, or should " +"check :attr:`SSLSocket.session_reused`, which is true if the PSK was used. " +"A PSK handshake does not need any CA certificates to be loaded when " +"using :const:`CERT_REQUIRED`." +msgstr "" + +msgid "" +"a zero length PSK does not reject the connection, it only means that no PSK " +"is offered. An exception raised by the callback has the same effect." +msgstr "" + +msgid "" +"the PSK is used with the SHA-256 handshake digest, so a server can only " +"accept it with a cipher suite that uses SHA-256." +msgstr "" + msgid "Example usage::" msgstr "" msgid "" "context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)\n" "context.check_hostname = False\n" -"context.verify_mode = ssl.CERT_NONE\n" "context.maximum_version = ssl.TLSVersion.TLSv1_2\n" "context.set_ciphers('PSK')\n" "\n" @@ -2157,8 +2230,8 @@ msgid "" "callback(identity: str | None) -> bytes``. The ``identity`` parameter is an " "optional identity sent by the client which can be used to select a " "corresponding PSK. The return value is a :term:`bytes-like object` " -"representing the pre-shared key. Return a zero length PSK to reject the " -"connection." +"representing the pre-shared key. With TLS 1.2 and earlier, return a zero " +"length PSK to reject the connection." msgstr "" msgid "" @@ -2167,8 +2240,22 @@ msgid "" "UTF-8 encoded." msgstr "" +msgid "the ``identity_hint`` parameter is not sent to the client." +msgstr "" + +msgid "" +"a zero length PSK, or an exception raised by the callback, only declines the " +"client's PSK. If a certificate was loaded " +"with :meth:`~SSLContext.load_cert_chain`, the handshake continues with " +"certificate authentication instead of failing, so a server relying on the " +"PSK to authenticate clients should not load one, or should " +"check :attr:`SSLSocket.session_reused`, which is true if the PSK was used." +msgstr "" + msgid "" -"When using TLS 1.3 the ``identity_hint`` parameter is not sent to the client." +"the PSK can only be accepted with a cipher suite that uses SHA-256. When a " +"certificate is loaded, OpenSSL's default TLS 1.3 cipher suite order selects " +"a SHA-384 suite instead, so the PSK is declined even if it matches." msgstr "" msgid "" @@ -2278,9 +2365,9 @@ msgid "" "certificate chains for each issuer you are willing to trust. Again, this " "file just contains these chains concatenated together. For validation, " "Python will use the first chain it finds in the file which matches. The " -"platform's certificates file can be used by calling :meth:`SSLContext." -"load_default_certs`, this is done automatically with :func:`." -"create_default_context`." +"platform's certificates file can be used by " +"calling :meth:`SSLContext.load_default_certs`, this is done automatically " +"with :func:`.create_default_context`." msgstr "" msgid "Combined key and certificate" @@ -2402,8 +2489,8 @@ msgid "" msgstr "" msgid "" -"When you use the context to connect to a server, :const:`CERT_REQUIRED` and :" -"attr:`~SSLContext.check_hostname` validate the server certificate: it " +"When you use the context to connect to a server, :const:`CERT_REQUIRED` " +"and :attr:`~SSLContext.check_hostname` validate the server certificate: it " "ensures that the server certificate was signed with one of the CA " "certificates, checks the signature for correctness, and verifies other " "properties like validity and identity of the hostname::" @@ -2434,10 +2521,10 @@ msgid "" "{'OCSP': ('http://ocsp.digicert.com',),\n" " 'caIssuers': ('http://cacerts.digicert.com/" "DigiCertSHA2ExtendedValidationServerCA.crt',),\n" -" 'crlDistributionPoints': ('http://crl3.digicert.com/sha2-ev-server-g1." -"crl',\n" -" 'http://crl4.digicert.com/sha2-ev-server-g1." -"crl'),\n" +" 'crlDistributionPoints': ('http://crl3.digicert.com/sha2-ev-server-" +"g1.crl',\n" +" 'http://crl4.digicert.com/sha2-ev-server-" +"g1.crl'),\n" " 'issuer': ((('countryName', 'US'),),\n" " (('organizationName', 'DigiCert Inc'),),\n" " (('organizationalUnitName', 'www.digicert.com'),),\n" @@ -2526,8 +2613,9 @@ msgstr "" msgid "" "When a client connects, you'll call :meth:`accept` on the socket to get the " -"new socket from the other end, and use the context's :meth:`SSLContext." -"wrap_socket` method to create a server-side SSL socket for the connection::" +"new socket from the other end, and use the " +"context's :meth:`SSLContext.wrap_socket` method to create a server-side SSL " +"socket for the connection::" msgstr "" msgid "" @@ -2579,10 +2667,10 @@ msgid "" "Most :class:`SSLSocket` methods will raise either :exc:`SSLWantWriteError` " "or :exc:`SSLWantReadError` instead of :exc:`BlockingIOError` if an I/O " "operation would block. :exc:`SSLWantReadError` will be raised if a read " -"operation on the underlying socket is necessary, and :exc:" -"`SSLWantWriteError` for a write operation on the underlying socket. Note " -"that attempts to *write* to an SSL socket may require *reading* from the " -"underlying socket first, and attempts to *read* from the SSL socket may " +"operation on the underlying socket is necessary, " +"and :exc:`SSLWantWriteError` for a write operation on the underlying socket. " +"Note that attempts to *write* to an SSL socket may require *reading* from " +"the underlying socket first, and attempts to *read* from the SSL socket may " "require a prior *write* to the underlying socket." msgstr "" @@ -2596,8 +2684,8 @@ msgid "" "read from (or written to), but it does not imply that there is sufficient " "data at the upper SSL layer. For example, only part of an SSL frame might " "have arrived. Therefore, you must be ready to handle :meth:`SSLSocket.recv` " -"and :meth:`SSLSocket.send` failures, and retry after another call to :func:" -"`~select.select`." +"and :meth:`SSLSocket.send` failures, and retry after another call " +"to :func:`~select.select`." msgstr "" msgid "" @@ -2609,15 +2697,15 @@ msgid "" msgstr "" msgid "" -"(of course, similar provisions apply when using other primitives such as :" -"func:`~select.poll`, or those in the :mod:`selectors` module)" +"(of course, similar provisions apply when using other primitives such " +"as :func:`~select.poll`, or those in the :mod:`selectors` module)" msgstr "" msgid "" -"The SSL handshake itself will be non-blocking: the :meth:`SSLSocket." -"do_handshake` method has to be retried until it returns successfully. Here " -"is a synopsis using :func:`~select.select` to wait for the socket's " -"readiness::" +"The SSL handshake itself will be non-blocking: " +"the :meth:`SSLSocket.do_handshake` method has to be retried until it returns " +"successfully. Here is a synopsis using :func:`~select.select` to wait for " +"the socket's readiness::" msgstr "" msgid "" @@ -2635,17 +2723,17 @@ msgid "" "The :mod:`asyncio` module supports :ref:`non-blocking SSL sockets ` and provides a higher level :ref:`Streams API `. It polls for events using the :mod:`selectors` module and " -"handles :exc:`SSLWantWriteError`, :exc:`SSLWantReadError` and :exc:" -"`BlockingIOError` exceptions. It runs the SSL handshake asynchronously as " -"well." +"handles :exc:`SSLWantWriteError`, :exc:`SSLWantReadError` " +"and :exc:`BlockingIOError` exceptions. It runs the SSL handshake " +"asynchronously as well." msgstr "" msgid "Memory BIO support" msgstr "" msgid "" -"Ever since the SSL module was introduced in Python 2.6, the :class:" -"`SSLSocket` class has provided two related but distinct areas of " +"Ever since the SSL module was introduced in Python 2.6, " +"the :class:`SSLSocket` class has provided two related but distinct areas of " "functionality:" msgstr "" @@ -2666,11 +2754,11 @@ msgid "" "Combining SSL protocol handling and network IO usually works well, but there " "are some cases where it doesn't. An example is async IO frameworks that want " "to use a different IO multiplexing model than the \"select/poll on a file " -"descriptor\" (readiness based) model that is assumed by :class:`socket." -"socket` and by the internal OpenSSL socket IO routines. This is mostly " -"relevant for platforms like Windows where this model is not efficient. For " -"this purpose, a reduced scope variant of :class:`SSLSocket` called :class:" -"`SSLObject` is provided." +"descriptor\" (readiness based) model that is assumed " +"by :class:`socket.socket` and by the internal OpenSSL socket IO routines. " +"This is mostly relevant for platforms like Windows where this model is not " +"efficient. For this purpose, a reduced scope variant of :class:`SSLSocket` " +"called :class:`SSLObject` is provided." msgstr "" msgid "" @@ -2778,8 +2866,8 @@ msgstr "" msgid "" "There is no handling of *suppress_ragged_eofs*. All end-of-file conditions " -"that are in violation of the protocol are reported via the :exc:" -"`SSLEOFError` exception." +"that are in violation of the protocol are reported via " +"the :exc:`SSLEOFError` exception." msgstr "" msgid "" @@ -2788,9 +2876,9 @@ msgid "" msgstr "" msgid "" -"The *server_name_callback* callback passed to :meth:`SSLContext." -"set_servername_callback` will get an :class:`SSLObject` instance instead of " -"a :class:`SSLSocket` instance as its first parameter." +"The *server_name_callback* callback passed " +"to :meth:`SSLContext.set_servername_callback` will get an :class:`SSLObject` " +"instance instead of a :class:`SSLSocket` instance as its first parameter." msgstr "" msgid "Some notes related to the use of :class:`SSLObject`:" @@ -2798,14 +2886,15 @@ msgstr "" msgid "" "All IO on an :class:`SSLObject` is :ref:`non-blocking `. " -"This means that for example :meth:`~SSLSocket.read` will raise an :exc:" -"`SSLWantReadError` if it needs more data than the incoming BIO has available." +"This means that for example :meth:`~SSLSocket.read` will raise " +"an :exc:`SSLWantReadError` if it needs more data than the incoming BIO has " +"available." msgstr "" msgid "" -":class:`SSLObject` instances must be created with :meth:`~SSLContext." -"wrap_bio`. In earlier versions, it was possible to create instances " -"directly. This was never documented or officially supported." +":class:`SSLObject` instances must be created " +"with :meth:`~SSLContext.wrap_bio`. In earlier versions, it was possible to " +"create instances directly. This was never documented or officially supported." msgstr "" msgid "" @@ -2862,11 +2951,11 @@ msgstr "" msgid "" "For **client use**, if you don't have any special requirements for your " -"security policy, it is highly recommended that you use the :func:" -"`create_default_context` function to create your SSL context. It will load " -"the system's trusted CA certificates, enable certificate validation and " -"hostname checking, and try to choose reasonably secure protocol and cipher " -"settings." +"security policy, it is highly recommended that you use " +"the :func:`create_default_context` function to create your SSL context. It " +"will load the system's trusted CA certificates, enable certificate " +"validation and hostname checking, and try to choose reasonably secure " +"protocol and cipher settings." msgstr "" msgid "" @@ -2883,15 +2972,15 @@ msgid "" msgstr "" msgid "" -"If a client certificate is needed for the connection, it can be added with :" -"meth:`SSLContext.load_cert_chain`." +"If a client certificate is needed for the connection, it can be added " +"with :meth:`SSLContext.load_cert_chain`." msgstr "" msgid "" -"By contrast, if you create the SSL context by calling the :class:" -"`SSLContext` constructor yourself, it will not have certificate validation " -"nor hostname checking enabled by default. If you do so, please read the " -"paragraphs below to achieve a good security level." +"By contrast, if you create the SSL context by calling " +"the :class:`SSLContext` constructor yourself, it will not have certificate " +"validation nor hostname checking enabled by default. If you do so, please " +"read the paragraphs below to achieve a good security level." msgstr "" msgid "Manual settings" @@ -2901,22 +2990,22 @@ msgid "Verifying certificates" msgstr "" msgid "" -"When calling the :class:`SSLContext` constructor directly, :const:" -"`CERT_NONE` is the default. Since it does not authenticate the other peer, " -"it can be insecure, especially in client mode where most of the time you " -"would like to ensure the authenticity of the server you're talking to. " -"Therefore, when in client mode, it is highly recommended to use :const:" -"`CERT_REQUIRED`. However, it is in itself not sufficient; you also have to " -"check that the server certificate, which can be obtained by calling :meth:" -"`SSLSocket.getpeercert`, matches the desired service. For many protocols " -"and applications, the service can be identified by the hostname. This common " -"check is automatically performed when :attr:`SSLContext.check_hostname` is " -"enabled." +"When calling the :class:`SSLContext` constructor " +"directly, :const:`CERT_NONE` is the default. Since it does not authenticate " +"the other peer, it can be insecure, especially in client mode where most of " +"the time you would like to ensure the authenticity of the server you're " +"talking to. Therefore, when in client mode, it is highly recommended to " +"use :const:`CERT_REQUIRED`. However, it is in itself not sufficient; you " +"also have to check that the server certificate, which can be obtained by " +"calling :meth:`SSLSocket.getpeercert`, matches the desired service. For " +"many protocols and applications, the service can be identified by the " +"hostname. This common check is automatically performed " +"when :attr:`SSLContext.check_hostname` is enabled." msgstr "" msgid "" -"Hostname matchings is now performed by OpenSSL. Python no longer uses :func:" -"`!match_hostname`." +"Hostname matchings is now performed by OpenSSL. Python no longer " +"uses :func:`!match_hostname`." msgstr "" msgid "" @@ -2932,25 +3021,22 @@ msgstr "" msgid "" "SSL versions 2 and 3 are considered insecure and are therefore dangerous to " "use. If you want maximum compatibility between clients and servers, it is " -"recommended to use :const:`PROTOCOL_TLS_CLIENT` or :const:" -"`PROTOCOL_TLS_SERVER` as the protocol version. SSLv2 and SSLv3 are disabled " -"by default." +"recommended to use :const:`PROTOCOL_TLS_CLIENT` " +"or :const:`PROTOCOL_TLS_SERVER` as the protocol version. SSLv2 and SSLv3 are " +"disabled by default." msgstr "" msgid "" ">>> client_context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)\n" -">>> client_context.minimum_version = ssl.TLSVersion.TLSv1_3\n" +">>> client_context.minimum_version = ssl.TLSVersion.TLSv1_2\n" ">>> client_context.maximum_version = ssl.TLSVersion.TLSv1_3" msgstr "" -">>> client_context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)\n" -">>> client_context.minimum_version = ssl.TLSVersion.TLSv1_3\n" -">>> client_context.maximum_version = ssl.TLSVersion.TLSv1_3" msgid "" -"The SSL context created above will only allow TLSv1.3 and later (if " -"supported by your system) connections to a server. :const:" -"`PROTOCOL_TLS_CLIENT` implies certificate validation and hostname checks by " -"default. You have to load certificates into the context." +"The SSL client context created above will only allow TLSv1.2 and TLSv1.3 (if " +"supported by your system) connections to a " +"server. :const:`PROTOCOL_TLS_CLIENT` implies certificate validation and " +"hostname checks by default. You have to load certificates into the context." msgstr "" msgid "Cipher selection" @@ -2958,14 +3044,14 @@ msgstr "" msgid "" "If you have advanced security requirements, fine-tuning of the ciphers " -"enabled when negotiating a SSL session is possible through the :meth:" -"`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the ssl module " -"disables certain weak ciphers by default, but you may want to further " -"restrict the cipher choice. Be sure to read OpenSSL's documentation about " -"the `cipher list format `_. If you want to check which ciphers are enabled by a given " -"cipher list, use :meth:`SSLContext.get_ciphers` or the ``openssl ciphers`` " -"command on your system." +"enabled when negotiating a SSL session is possible through " +"the :meth:`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the " +"ssl module disables certain weak ciphers by default, but you may want to " +"further restrict the cipher choice. Be sure to read OpenSSL's documentation " +"about the `cipher list format `_. If you want to check which ciphers are enabled by a " +"given cipher list, use :meth:`SSLContext.get_ciphers` or the ``openssl " +"ciphers`` command on your system." msgstr "" msgid "Multi-processing" @@ -2991,9 +3077,9 @@ msgstr "" msgid "" "TLS 1.3 uses a disjunct set of cipher suites. All AES-GCM and ChaCha20 " -"cipher suites are enabled by default. The method :meth:`SSLContext." -"set_ciphers` cannot enable or disable any TLS 1.3 ciphers yet, but :meth:" -"`SSLContext.get_ciphers` returns them." +"cipher suites are enabled by default. The " +"method :meth:`SSLContext.set_ciphers` cannot enable or disable any TLS 1.3 " +"ciphers yet, but :meth:`SSLContext.get_ciphers` returns them." msgstr "" msgid "" diff --git a/library/stat.po b/library/stat.po index ec20b15795..b2609b7202 100644 --- a/library/stat.po +++ b/library/stat.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -185,11 +185,12 @@ msgid "" "The interpretation of \"file size\" changes according to the file type. For " "plain files this is the size of the file in bytes. For FIFOs and sockets " "under most flavors of Unix (including Linux in particular), the \"size\" is " -"the number of bytes waiting to be read at the time of the call to :func:`os." -"stat`, :func:`os.fstat`, or :func:`os.lstat`; this can sometimes be useful, " -"especially for polling one of these special files after a non-blocking " -"open. The meaning of the size field for other character and block devices " -"varies more, depending on the implementation of the underlying system call." +"the number of bytes waiting to be read at the time of the call " +"to :func:`os.stat`, :func:`os.fstat`, or :func:`os.lstat`; this can " +"sometimes be useful, especially for polling one of these special files after " +"a non-blocking open. The meaning of the size field for other character and " +"block devices varies more, depending on the implementation of the underlying " +"system call." msgstr "" msgid "The variables below define the flags used in the :data:`ST_MODE` field." @@ -236,8 +237,8 @@ msgid "" msgstr "" msgid "" -"The following flags can also be used in the *mode* argument of :func:`os." -"chmod`:" +"The following flags can also be used in the *mode* argument " +"of :func:`os.chmod`:" msgstr "" msgid "Set UID bit." @@ -296,9 +297,9 @@ msgid "Others have execute permission." msgstr "" msgid "" -"System V file locking enforcement. This flag is shared with :data:" -"`S_ISGID`: file/record locking is enforced on files that do not have the " -"group execution bit (:data:`S_IXGRP`) set." +"System V file locking enforcement. This flag is shared " +"with :data:`S_ISGID`: file/record locking is enforced on files that do not " +"have the group execution bit (:data:`S_IXGRP`) set." msgstr "" msgid "Unix V7 synonym for :data:`S_IRUSR`." @@ -311,8 +312,8 @@ msgid "Unix V7 synonym for :data:`S_IXUSR`." msgstr "" msgid "" -"The following flags can be used in the *flags* argument of :func:`os." -"chflags`:" +"The following flags can be used in the *flags* argument " +"of :func:`os.chflags`:" msgstr "" msgid "All user settable flags." @@ -379,10 +380,10 @@ msgstr "" msgid "" "On Windows, the following file attribute constants are available for use " -"when testing bits in the ``st_file_attributes`` member returned by :func:`os." -"stat`. See the `Windows API documentation `_ for more detail on the meaning of " -"these constants." +"when testing bits in the ``st_file_attributes`` member returned " +"by :func:`os.stat`. See the `Windows API documentation `_ for more " +"detail on the meaning of these constants." msgstr "" msgid "" diff --git a/library/statistics.po b/library/statistics.po index f41cecc0bb..188e1e4e20 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-11 19:27+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,13 +43,13 @@ msgid "" msgstr "" msgid "" -"Unless explicitly noted, these functions support :class:`int`, :class:" -"`float`, :class:`~decimal.Decimal` and :class:`~fractions.Fraction`. " -"Behaviour with other types (whether in the numeric tower or not) is " -"currently unsupported. Collections with a mix of types are also undefined " -"and implementation-dependent. If your input data consists of mixed types, " -"you may be able to use :func:`map` to ensure a consistent result, for " -"example: ``map(float, input_data)``." +"Unless explicitly noted, these functions " +"support :class:`int`, :class:`float`, :class:`~decimal.Decimal` " +"and :class:`~fractions.Fraction`. Behaviour with other types (whether in the " +"numeric tower or not) is currently unsupported. Collections with a mix of " +"types are also undefined and implementation-dependent. If your input data " +"consists of mixed types, you may be able to use :func:`map` to ensure a " +"consistent result, for example: ``map(float, input_data)``." msgstr "" msgid "" @@ -287,8 +287,8 @@ msgid "Convert *data* to floats and compute the arithmetic mean." msgstr "" msgid "" -"This runs faster than the :func:`mean` function and it always returns a :" -"class:`float`. The *data* may be a sequence or iterable. If the input " +"This runs faster than the :func:`mean` function and it always returns " +"a :class:`float`. The *data* may be a sequence or iterable. If the input " "dataset is empty, raises a :exc:`StatisticsError`." msgstr "" @@ -313,8 +313,8 @@ msgid "" msgstr "" msgid "" -"If *weights* is supplied, it must be the same length as the *data* or a :exc:" -"`ValueError` will be raised." +"If *weights* is supplied, it must be the same length as the *data* or " +"a :exc:`ValueError` will be raised." msgstr "" msgid "Added support for *weights*." @@ -410,9 +410,9 @@ msgid "" msgstr "" msgid "" -"The basic idea is to smooth the data using `a kernel function `_. to help draw inferences about a " -"population from a sample." +"The basic idea is to smooth the data using `a kernel function `_. to help draw inferences about " +"a population from a sample." msgstr "" msgid "" @@ -466,6 +466,13 @@ msgstr "" msgid "Scatter plot of the estimated probability density function." msgstr "" +msgid "" +"Because the returned ``f_hat`` function is typically called many times, it " +"caches the *data* for performance. To support dynamic datasets, this cache " +"automatically refreshes whenever the length of the *data* changes. This " +"allows new samples to be added as they become available." +msgstr "" + msgid "" "Return a function that makes a random selection from the estimated " "probability density function produced by ``kde(data, h, kernel)``." @@ -526,8 +533,9 @@ msgid "" msgstr "" msgid "" -"Return the low median of numeric data. If *data* is empty, :exc:" -"`StatisticsError` is raised. *data* can be a sequence or iterable." +"Return the low median of numeric data. If *data* is " +"empty, :exc:`StatisticsError` is raised. *data* can be a sequence or " +"iterable." msgstr "" msgid "" @@ -888,9 +896,9 @@ msgid "" msgstr "" msgid "" -"If you somehow know the actual population mean μ you should pass it to the :" -"func:`pvariance` function as the *mu* parameter to get the variance of a " -"sample." +"If you somehow know the actual population mean μ you should pass it to " +"the :func:`pvariance` function as the *mu* parameter to get the variance of " +"a sample." msgstr "" msgid "" @@ -966,8 +974,8 @@ msgid "" msgstr "" msgid "" -"Both inputs must be of the same length (no less than two), otherwise :exc:" -"`StatisticsError` is raised." +"Both inputs must be of the same length (no less than two), " +"otherwise :exc:`StatisticsError` is raised." msgstr "" msgid "" @@ -1041,8 +1049,8 @@ msgid "Added support for Spearman's rank correlation coefficient." msgstr "" msgid "" -"Return the slope and intercept of `simple linear regression `_ parameters estimated using " +"Return the slope and intercept of `simple linear regression `_ parameters estimated using " "ordinary least squares. Simple linear regression describes the relationship " "between an independent variable *x* and a dependent variable *y* in terms of " "this linear function:" @@ -1060,8 +1068,8 @@ msgstr "" msgid "" "Both inputs must be of the same length (no less than two), and the " -"independent variable *x* cannot be constant; otherwise a :exc:" -"`StatisticsError` is raised." +"independent variable *x* cannot be constant; otherwise " +"a :exc:`StatisticsError` is raised." msgstr "" msgid "" @@ -1127,14 +1135,14 @@ msgstr "" msgid "" ":class:`NormalDist` is a tool for creating and manipulating normal " -"distributions of a `random variable `_. It is a class that treats the mean and " -"standard deviation of data measurements as a single entity." +"distributions of a `random variable `_. It is a class that treats the mean and standard " +"deviation of data measurements as a single entity." msgstr "" msgid "" -"Normal distributions arise from the `Central Limit Theorem `_ and have a wide range of " +"Normal distributions arise from the `Central Limit Theorem `_ and have a wide range of " "applications in statistics." msgstr "" @@ -1226,8 +1234,8 @@ msgstr "" msgid "" "Compute the inverse cumulative distribution function, also known as the " "`quantile function `_ or " -"the `percent-point `_ " +"the `percent-point `_ " "function. Mathematically, it is written ``x : P(X <= x) = p``." msgstr "" @@ -1282,8 +1290,8 @@ msgid "" "Since normal distributions arise from additive effects of independent " "variables, it is possible to `add and subtract two independent normally " "distributed random variables `_ represented as instances of :" -"class:`NormalDist`. For example:" +"Sum_of_normally_distributed_random_variables>`_ represented as instances " +"of :class:`NormalDist`. For example:" msgstr "" msgid "" @@ -1400,8 +1408,8 @@ msgid "Normal distributions commonly arise in machine learning problems." msgstr "" msgid "" -"Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " +"Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " "challenge is to predict a person's gender from measurements of normally " "distributed features including height, weight, and foot size." msgstr "" diff --git a/library/stdtypes.po b/library/stdtypes.po index 7238b3e17a..9eb4ef7da9 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-09-03 18:21+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -54,17 +54,18 @@ msgid "Truth Value Testing" msgstr "" msgid "" -"Any object can be tested for truth value, for use in an :keyword:`if` or :" -"keyword:`while` condition or as operand of the Boolean operations below." +"Any object can be tested for truth value, for use in an :keyword:`if` " +"or :keyword:`while` condition or as operand of the Boolean operations below." msgstr "" msgid "" -"By default, an object is considered true unless its class defines either a :" -"meth:`~object.__bool__` method that returns ``False`` or a :meth:`~object." -"__len__` method that returns zero, when called with the object. [1]_ If one " -"of the methods raises an exception when called, the exception is propagated " -"and the object does not have a truth value (for example, :data:" -"`NotImplemented`). Here are most of the built-in objects considered false:" +"By default, an object is considered true unless its class defines either " +"a :meth:`~object.__bool__` method that returns ``False`` or " +"a :meth:`~object.__len__` method that returns zero, when called with the " +"object. [1]_ If one of the methods raises an exception when called, the " +"exception is propagated and the object does not have a truth value (for " +"example, :data:`NotImplemented`). Here are most of the built-in objects " +"considered false:" msgstr "" msgid "constants defined to be false: ``None`` and ``False``" @@ -229,10 +230,11 @@ msgstr "" msgid "" "Instances of a class cannot be ordered with respect to other instances of " "the same class, or other types of object, unless the class defines enough of " -"the methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object." -"__gt__`, and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` and :" -"meth:`~object.__eq__` are sufficient, if you want the conventional meanings " -"of the comparison operators)." +"the " +"methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` " +"and :meth:`~object.__eq__` are sufficient, if you want the conventional " +"meanings of the comparison operators)." msgstr "" msgid "" @@ -242,8 +244,8 @@ msgid "" msgstr "" msgid "" -"Two more operations with the same syntactic priority, :keyword:`in` and :" -"keyword:`not in`, are supported by types that are :term:`iterable` or " +"Two more operations with the same syntactic priority, :keyword:`in` " +"and :keyword:`not in`, are supported by types that are :term:`iterable` or " "implement the :meth:`~object.__contains__` method." msgstr "" @@ -256,12 +258,13 @@ msgid "" "subtype of integers. Integers have unlimited precision. Floating-point " "numbers are usually implemented using :c:expr:`double` in C; information " "about the precision and internal representation of floating-point numbers " -"for the machine on which your program is running is available in :data:`sys." -"float_info`. Complex numbers have a real and imaginary part, which are each " -"a floating-point number. To extract these parts from a complex number *z*, " -"use ``z.real`` and ``z.imag``. (The standard library includes the additional " -"numeric types :mod:`fractions.Fraction`, for rationals, and :mod:`decimal." -"Decimal`, for floating-point numbers with user-definable precision.)" +"for the machine on which your program is running is available " +"in :data:`sys.float_info`. Complex numbers have a real and imaginary part, " +"which are each a floating-point number. To extract these parts from a " +"complex number *z*, use ``z.real`` and ``z.imag``. (The standard library " +"includes the additional numeric types :mod:`fractions.Fraction`, for " +"rationals, and :mod:`decimal.Decimal`, for floating-point numbers with user-" +"definable precision.)" msgstr "" msgid "" @@ -602,8 +605,8 @@ msgstr "" msgid "" "Performing these calculations with at least one extra sign extension bit in " -"a finite two's complement representation (a working bit-width of ``1 + max(x." -"bit_length(), y.bit_length())`` or more) is sufficient to get the same " +"a finite two's complement representation (a working bit-width of ``1 + " +"max(x.bit_length(), y.bit_length())`` or more) is sufficient to get the same " "result as if there were an infinite number of sign bits." msgstr "" @@ -637,8 +640,8 @@ msgid "" "More precisely, if ``x`` is nonzero, then ``x.bit_length()`` is the unique " "positive integer ``k`` such that ``2**(k-1) <= abs(x) < 2**k``. " "Equivalently, when ``abs(x)`` is small enough to have a correctly rounded " -"logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then ``x." -"bit_length()`` returns ``0``." +"logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then " +"``x.bit_length()`` returns ``0``." msgstr "" msgid "Equivalent to::" @@ -682,9 +685,9 @@ msgid "Return an array of bytes representing an integer." msgstr "" msgid "" -"The integer is represented using *length* bytes, and defaults to 1. An :exc:" -"`OverflowError` is raised if the integer is not representable with the given " -"number of bytes." +"The integer is represented using *length* bytes, and defaults to 1. " +"An :exc:`OverflowError` is raised if the integer is not representable with " +"the given number of bytes." msgstr "" msgid "" @@ -746,8 +749,8 @@ msgid "" "integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " "most significant byte is at the beginning of the byte array. If *byteorder* " "is ``\"little\"``, the most significant byte is at the end of the byte " -"array. To request the native byte order of the host system, use :data:`sys." -"byteorder` as the byte order value." +"array. To request the native byte order of the host system, " +"use :data:`sys.byteorder` as the byte order value." msgstr "" msgid "" @@ -781,8 +784,8 @@ msgid "" msgstr "" msgid "" -"Returns ``True``. Exists for duck type compatibility with :meth:`float." -"is_integer`." +"Returns ``True``. Exists for duck type compatibility " +"with :meth:`float.is_integer`." msgstr "" msgid "Additional Methods on Float" @@ -800,20 +803,20 @@ msgstr "" msgid "" "If the argument is an integer or a floating-point number, a floating-point " "number with the same value (within Python's floating-point precision) is " -"returned. If the argument is outside the range of a Python float, an :exc:" -"`OverflowError` will be raised." +"returned. If the argument is outside the range of a Python float, " +"an :exc:`OverflowError` will be raised." msgstr "" msgid "" -"For a general Python object ``x``, ``float.from_number(x)`` delegates to ``x." -"__float__()``. If :meth:`~object.__float__` is not defined then it falls " +"For a general Python object ``x``, ``float.from_number(x)`` delegates to " +"``x.__float__()``. If :meth:`~object.__float__` is not defined then it falls " "back to :meth:`~object.__index__`." msgstr "" msgid "" "Return a pair of integers whose ratio is exactly equal to the original " -"float. The ratio is in lowest terms and has a positive denominator. Raises :" -"exc:`OverflowError` on infinities and a :exc:`ValueError` on NaNs." +"float. The ratio is in lowest terms and has a positive denominator. " +"Raises :exc:`OverflowError` on infinities and a :exc:`ValueError` on NaNs." msgstr "" msgid "" @@ -853,8 +856,8 @@ msgid "" msgstr "" msgid "" -"Note that :meth:`float.hex` is an instance method, while :meth:`float." -"fromhex` is a class method." +"Note that :meth:`float.hex` is an instance method, " +"while :meth:`float.fromhex` is a class method." msgstr "" msgid "A hexadecimal string takes the form::" @@ -864,7 +867,7 @@ msgid "[sign] ['0x'] integer ['.' fraction] ['p' exponent]" msgstr "" msgid "" -"where the optional ``sign`` may by either ``+`` or ``-``, ``integer`` and " +"where the optional ``sign`` may be either ``+`` or ``-``, ``integer`` and " "``fraction`` are strings of hexadecimal digits, and ``exponent`` is a " "decimal integer with an optional leading sign. Case is not significant, and " "there must be at least one hexadecimal digit in either the integer or the " @@ -906,9 +909,9 @@ msgid "Additional Methods on Complex" msgstr "" msgid "" -"The :class:`!complex` type implements the :class:`numbers.Complex` :term:" -"`abstract base class`. :class:`!complex` also has the following additional " -"methods." +"The :class:`!complex` type implements " +"the :class:`numbers.Complex` :term:`abstract base class`. :class:`!complex` " +"also has the following additional methods." msgstr "" msgid "Class method to convert a number to a complex number." @@ -926,17 +929,18 @@ msgstr "" msgid "" "For numbers ``x`` and ``y``, possibly of different types, it's a requirement " -"that ``hash(x) == hash(y)`` whenever ``x == y`` (see the :meth:`~object." -"__hash__` method documentation for more details). For ease of " -"implementation and efficiency across a variety of numeric types (including :" -"class:`int`, :class:`float`, :class:`decimal.Decimal` and :class:`fractions." -"Fraction`) Python's hash for numeric types is based on a single mathematical " -"function that's defined for any rational number, and hence applies to all " -"instances of :class:`int` and :class:`fractions.Fraction`, and all finite " -"instances of :class:`float` and :class:`decimal.Decimal`. Essentially, this " -"function is given by reduction modulo ``P`` for a fixed prime ``P``. The " -"value of ``P`` is made available to Python as the :attr:`~sys.hash_info." -"modulus` attribute of :data:`sys.hash_info`." +"that ``hash(x) == hash(y)`` whenever ``x == y`` (see " +"the :meth:`~object.__hash__` method documentation for more details). For " +"ease of implementation and efficiency across a variety of numeric types " +"(including :class:`int`, :class:`float`, :class:`decimal.Decimal` " +"and :class:`fractions.Fraction`) Python's hash for numeric types is based on " +"a single mathematical function that's defined for any rational number, and " +"hence applies to all instances of :class:`int` " +"and :class:`fractions.Fraction`, and all finite instances of :class:`float` " +"and :class:`decimal.Decimal`. Essentially, this function is given by " +"reduction modulo ``P`` for a fixed prime ``P``. The value of ``P`` is made " +"available to Python as the :attr:`~sys.hash_info.modulus` attribute " +"of :data:`sys.hash_info`." msgstr "" msgid "" @@ -973,16 +977,17 @@ msgstr "" msgid "" "For a :class:`complex` number ``z``, the hash values of the real and " -"imaginary parts are combined by computing ``hash(z.real) + sys.hash_info." -"imag * hash(z.imag)``, reduced modulo ``2**sys.hash_info.width`` so that it " -"lies in ``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - " -"1))``. Again, if the result is ``-1``, it's replaced with ``-2``." +"imaginary parts are combined by computing ``hash(z.real) + " +"sys.hash_info.imag * hash(z.imag)``, reduced modulo " +"``2**sys.hash_info.width`` so that it lies in " +"``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - 1))``. " +"Again, if the result is ``-1``, it's replaced with ``-2``." msgstr "" msgid "" "To clarify the above rules, here's some example Python code, equivalent to " -"the built-in hash, for computing the hash of a rational number, :class:" -"`float`, or :class:`complex`::" +"the built-in hash, for computing the hash of a rational " +"number, :class:`float`, or :class:`complex`::" msgstr "" msgid "" @@ -1026,8 +1031,8 @@ msgid "" "def hash_complex(z):\n" " \"\"\"Compute the hash of a complex number z.\"\"\"\n" "\n" -" hash_value = hash_float(z.real) + sys.hash_info.imag * hash_float(z." -"imag)\n" +" hash_value = hash_float(z.real) + sys.hash_info.imag * " +"hash_float(z.imag)\n" " # do a signed reduction modulo 2**sys.hash_info.width\n" " M = 2**(sys.hash_info.width - 1)\n" " hash_value = (hash_value & (M - 1)) - (hash_value & M)\n" @@ -1080,8 +1085,8 @@ msgid "" msgstr "" msgid "" -"One method needs to be defined for container objects to provide :term:" -"`iterable` support:" +"One method needs to be defined for container objects to " +"provide :term:`iterable` support:" msgstr "" msgid "" @@ -1090,9 +1095,9 @@ msgid "" "of iteration, additional methods can be provided to specifically request " "iterators for those iteration types. (An example of an object supporting " "multiple forms of iteration would be a tree structure which supports both " -"breadth-first and depth-first traversal.) This method corresponds to the :c:" -"member:`~PyTypeObject.tp_iter` slot of the type structure for Python objects " -"in the Python/C API." +"breadth-first and depth-first traversal.) This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." msgstr "" msgid "" @@ -1102,9 +1107,10 @@ msgstr "" msgid "" "Return the :term:`iterator` object itself. This is required to allow both " -"containers and iterators to be used with the :keyword:`for` and :keyword:" -"`in` statements. This method corresponds to the :c:member:`~PyTypeObject." -"tp_iter` slot of the type structure for Python objects in the Python/C API." +"containers and iterators to be used with the :keyword:`for` " +"and :keyword:`in` statements. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." msgstr "" msgid "" @@ -1122,8 +1128,8 @@ msgid "" msgstr "" msgid "" -"Once an iterator's :meth:`~iterator.__next__` method raises :exc:" -"`StopIteration`, it must continue to do so on subsequent calls. " +"Once an iterator's :meth:`~iterator.__next__` method " +"raises :exc:`StopIteration`, it must continue to do so on subsequent calls. " "Implementations that do not obey this property are deemed broken." msgstr "" @@ -1134,10 +1140,10 @@ msgid "" "Python's :term:`generator`\\s provide a convenient way to implement the " "iterator protocol. If a container object's :meth:`~object.__iter__` method " "is implemented as a generator, it will automatically return an iterator " -"object (technically, a generator object) supplying the :meth:`~iterator." -"__iter__` and :meth:`~generator.__next__` methods. More information about " -"generators can be found in :ref:`the documentation for the yield expression " -"`." +"object (technically, a generator object) supplying " +"the :meth:`~iterator.__iter__` and :meth:`~generator.__next__` methods. More " +"information about generators can be found in :ref:`the documentation for the " +"yield expression `." msgstr "" msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`" @@ -1174,6 +1180,10 @@ msgid "" "[3]_" msgstr "" +msgid "" +"See :ref:`time-complexity` for the costs of the various sequence operations." +msgstr "" + msgid "``x in s``" msgstr "``x in s``" @@ -1260,9 +1270,9 @@ msgstr "" msgid "" "Forward and reversed iterators over mutable sequences access values using an " "index. That index will continue to march forward (or backward) even if the " -"underlying sequence is mutated. The iterator terminates only when an :exc:" -"`IndexError` or a :exc:`StopIteration` is encountered (or when the index " -"drops below zero)." +"underlying sequence is mutated. The iterator terminates only when " +"an :exc:`IndexError` or a :exc:`StopIteration` is encountered (or when the " +"index drops below zero)." msgstr "" msgid "" @@ -1362,16 +1372,16 @@ msgid "" msgstr "" msgid "" -"if concatenating :class:`str` objects, you can build a list and use :meth:" -"`str.join` at the end or else write to an :class:`io.StringIO` instance and " -"retrieve its value when complete" +"if concatenating :class:`str` objects, you can build a list and " +"use :meth:`str.join` at the end or else write to an :class:`io.StringIO` " +"instance and retrieve its value when complete" msgstr "" msgid "" -"if concatenating :class:`bytes` objects, you can similarly use :meth:`bytes." -"join` or :class:`io.BytesIO`, or you can do in-place concatenation with a :" -"class:`bytearray` object. :class:`bytearray` objects are mutable and have " -"an efficient overallocation mechanism" +"if concatenating :class:`bytes` objects, you can similarly " +"use :meth:`bytes.join` or :class:`io.BytesIO`, or you can do in-place " +"concatenation with a :class:`bytearray` object. :class:`bytearray` objects " +"are mutable and have an efficient overallocation mechanism" msgstr "" msgid "if concatenating :class:`tuple` objects, extend a :class:`list` instead" @@ -1420,14 +1430,14 @@ msgstr "" msgid "" "The only operation that immutable sequence types generally implement that is " -"not also implemented by mutable sequence types is support for the :func:" -"`hash` built-in." +"not also implemented by mutable sequence types is support for " +"the :func:`hash` built-in." msgstr "" msgid "" "This support allows immutable sequences, such as :class:`tuple` instances, " -"to be used as :class:`dict` keys and stored in :class:`set` and :class:" -"`frozenset` instances." +"to be used as :class:`dict` keys and stored in :class:`set` " +"and :class:`frozenset` instances." msgstr "" msgid "" @@ -1509,10 +1519,11 @@ msgid "" msgstr "" msgid "" -"The value *n* is an integer, or an object implementing :meth:`~object." -"__index__`. Zero and negative values of *n* clear the sequence. Items in " -"the sequence are not copied; they are referenced multiple times, as " -"explained for ``s * n`` under :ref:`typesseq-common`." +"The value *n* is an integer, or an object " +"implementing :meth:`~object.__index__`. Zero and negative values of *n* " +"clear the sequence. Items in the sequence are not copied; they are " +"referenced multiple times, as explained for ``s * n`` under :ref:`typesseq-" +"common`." msgstr "" msgid "Mutable Sequence Methods" @@ -1537,9 +1548,9 @@ msgid "" msgstr "" msgid "" -"The :meth:`!copy` method is not part of the :class:`~collections.abc." -"MutableSequence` :class:`~abc.ABC`, but most concrete mutable sequence types " -"provide it." +"The :meth:`!copy` method is not part of " +"the :class:`~collections.abc.MutableSequence` :class:`~abc.ABC`, but most " +"concrete mutable sequence types provide it." msgstr "" msgid "" @@ -1553,8 +1564,8 @@ msgid "" msgstr "" msgid "" -"Retrieve the item at *index* and also removes it from *sequence*. By " -"default, the last item in *sequence* is removed and returned." +"Retrieve the item at *index* and also remove it from *sequence*. By default, " +"the last item in *sequence* is removed and returned." msgstr "" msgid "Remove the first item from *sequence* where ``sequence[i] == value``." @@ -1606,6 +1617,9 @@ msgid "" "in." msgstr "" +msgid "Lists are :ref:`generic ` over the types of their items." +msgstr "" + msgid "" "Lists implement all of the :ref:`common ` and :ref:`mutable " "` sequence operations. Lists also provide the following " @@ -1620,8 +1634,8 @@ msgid "" msgstr "" msgid "" -":meth:`sort` accepts two arguments that can only be passed by keyword (:ref:" -"`keyword-only arguments `):" +":meth:`sort` accepts two arguments that can only be passed by keyword " +"(:ref:`keyword-only arguments `):" msgstr "" msgid "" @@ -1661,8 +1675,8 @@ msgstr "" msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -"Przykłady sortowania i krótki samouczek sortowania można znaleźć na stronie :" -"ref:`sortinghowto`." +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " @@ -1683,8 +1697,8 @@ msgid "" "Tuples are immutable sequences, typically used to store collections of " "heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " "built-in). Tuples are also used for cases where an immutable sequence of " -"homogeneous data is needed (such as allowing storage in a :class:`set` or :" -"class:`dict` instance)." +"homogeneous data is needed (such as allowing storage in a :class:`set` " +"or :class:`dict` instance)." msgstr "" msgid "Tuples may be constructed in a number of ways:" @@ -1729,6 +1743,12 @@ msgid "" "operations." msgstr "" +msgid "" +"Tuples are :ref:`generic ` over the types of their contents. For " +"more information, refer to :ref:`the typing documentation on annotating " +"tuples `." +msgstr "" + msgid "" "For heterogeneous collections of data where access by name is clearer than " "access by index, :func:`collections.namedtuple` may be a more appropriate " @@ -1744,8 +1764,8 @@ msgid "" msgstr "" msgid "" -"The arguments to the range constructor must be integers (either built-in :" -"class:`int` or any object that implements the :meth:`~object.__index__` " +"The arguments to the range constructor must be integers (either built-" +"in :class:`int` or any object that implements the :meth:`~object.__index__` " "special method). If the *step* argument is omitted, it defaults to ``1``. " "If the *start* argument is omitted, it defaults to ``0``. If *step* is " "zero, :exc:`ValueError` is raised." @@ -1770,8 +1790,8 @@ msgstr "" msgid "" "Ranges containing absolute values larger than :data:`sys.maxsize` are " -"permitted but some features (such as :func:`len`) may raise :exc:" -"`OverflowError`." +"permitted but some features (such as :func:`len`) may " +"raise :exc:`OverflowError`." msgstr "" msgid "Range examples::" @@ -1815,8 +1835,8 @@ msgid "" msgstr "" msgid "" -"The advantage of the :class:`range` type over a regular :class:`list` or :" -"class:`tuple` is that a :class:`range` object will always take the same " +"The advantage of the :class:`range` type over a regular :class:`list` " +"or :class:`tuple` is that a :class:`range` object will always take the same " "(small) amount of memory, no matter the size of the range it represents (as " "it only stores the ``start``, ``stop`` and ``step`` values, calculating " "individual items and subranges as needed)." @@ -1838,9 +1858,9 @@ msgid "" msgstr "" msgid "" -"Implement the Sequence ABC. Support slicing and negative indices. Test :" -"class:`int` objects for membership in constant time instead of iterating " -"through all items." +"Implement the Sequence ABC. Support slicing and negative indices. " +"Test :class:`int` objects for membership in constant time instead of " +"iterating through all items." msgstr "" msgid "" @@ -2122,6 +2142,18 @@ msgstr ":meth:`bytes.lstrip`" msgid ":meth:`bytes.rstrip`" msgstr ":meth:`bytes.rstrip`" +msgid ":meth:`str.removeprefix`" +msgstr "" + +msgid ":meth:`bytes.removeprefix`" +msgstr "" + +msgid ":meth:`str.removesuffix`" +msgstr "" + +msgid ":meth:`bytes.removesuffix`" +msgstr "" + msgid "Translation and Encoding" msgstr "" @@ -2147,9 +2179,9 @@ msgid "Text Sequence Type --- :class:`str`" msgstr "" msgid "" -"Textual data in Python is handled with :class:`str` objects, or :dfn:" -"`strings`. Strings are immutable :ref:`sequences ` of Unicode code " -"points. String literals are written in a variety of ways:" +"Textual data in Python is handled with :class:`str` objects, " +"or :dfn:`strings`. Strings are immutable :ref:`sequences ` of " +"Unicode code points. String literals are written in a variety of ways:" msgstr "" msgid "Single quotes: ``'allows embedded \"double\" quotes'``" @@ -2191,9 +2223,9 @@ msgid "" msgstr "" msgid "" -"There is also no mutable string type, but :meth:`str.join` or :class:`io." -"StringIO` can be used to efficiently construct strings from multiple " -"fragments." +"There is also no mutable string type, but :meth:`str.join` " +"or :class:`io.StringIO` can be used to efficiently construct strings from " +"multiple fragments." msgstr "" msgid "" @@ -2209,23 +2241,23 @@ msgid "" msgstr "" msgid "" -"If neither *encoding* nor *errors* is given, ``str(object)`` returns :meth:" -"`type(object).__str__(object) `, which is the \"informal\" " -"or nicely printable string representation of *object*. For string objects, " -"this is the string itself. If *object* does not have a :meth:`~object." -"__str__` method, then :func:`str` falls back to returning :func:" -"`repr(object) `." +"If neither *encoding* nor *errors* is given, ``str(object)`` " +"returns :meth:`type(object).__str__(object) `, which is the " +"\"informal\" or nicely printable string representation of *object*. For " +"string objects, this is the string itself. If *object* does not have " +"a :meth:`~object.__str__` method, then :func:`str` falls back to " +"returning :func:`repr(object) `." msgstr "" msgid "" -"If at least one of *encoding* or *errors* is given, *object* should be a :" -"term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " +"If at least one of *encoding* or *errors* is given, *object* should be " +"a :term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " "this case, if *object* is a :class:`bytes` (or :class:`bytearray`) object, " -"then ``str(bytes, encoding, errors)`` is equivalent to :meth:`bytes." -"decode(encoding, errors) `. Otherwise, the bytes object " -"underlying the buffer object is obtained before calling :meth:`bytes." -"decode`. See :ref:`binaryseq` and :ref:`bufferobjects` for information on " -"buffer objects." +"then ``str(bytes, encoding, errors)`` is equivalent " +"to :meth:`bytes.decode(encoding, errors) `. Otherwise, the " +"bytes object underlying the buffer object is obtained before " +"calling :meth:`bytes.decode`. See :ref:`binaryseq` and :ref:`bufferobjects` " +"for information on buffer objects." msgstr "" msgid "" @@ -2243,10 +2275,10 @@ msgstr "" "\"b'Zoot!'\"" msgid "" -"For more information on the ``str`` class and its methods, see :ref:" -"`textseq` and the :ref:`string-methods` section below. To output formatted " -"strings, see the :ref:`f-strings` and :ref:`formatstrings` sections. In " -"addition, see the :ref:`stringservices` section." +"For more information on the ``str`` class and its methods, " +"see :ref:`textseq` and the :ref:`string-methods` section below. To output " +"formatted strings, see the :ref:`f-strings` and :ref:`formatstrings` " +"sections. In addition, see the :ref:`stringservices` section." msgstr "" msgid "String Methods" @@ -2259,11 +2291,11 @@ msgstr "" msgid "" "Strings also support two styles of string formatting, one providing a large " -"degree of flexibility and customization (see :meth:`str.format`, :ref:" -"`formatstrings` and :ref:`string-formatting`) and the other based on C " -"``printf`` style formatting that handles a narrower range of types and is " -"slightly harder to use correctly, but is often faster for the cases it can " -"handle (:ref:`old-string-formatting`)." +"degree of flexibility and customization " +"(see :meth:`str.format`, :ref:`formatstrings` and :ref:`string-formatting`) " +"and the other based on C ``printf`` style formatting that handles a narrower " +"range of types and is slightly harder to use correctly, but is often faster " +"for the cases it can handle (:ref:`old-string-formatting`)." msgstr "" msgid "" @@ -2292,8 +2324,8 @@ msgid "" "Casefolding is similar to lowercasing but more aggressive because it is " "intended to remove all case distinctions in a string. For example, the " "German lowercase letter ``'ß'`` is equivalent to ``\"ss\"``. Since it is " -"already lowercase, :meth:`lower` would do nothing to ``'ß'``; :meth:" -"`casefold` converts it to ``\"ss\"``. For example:" +"already lowercase, :meth:`lower` would do nothing to " +"``'ß'``; :meth:`casefold` converts it to ``\"ss\"``. For example:" msgstr "" msgid "" @@ -2360,14 +2392,14 @@ msgid "" "*errors* controls how encoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " "are ``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``, " -"``'backslashreplace'`` and any other name registered via :func:`codecs." -"register_error`. See :ref:`error-handlers` for details." +"``'backslashreplace'`` and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" msgid "" "For performance reasons, the value of *errors* is not checked for validity " -"unless an encoding error actually occurs, :ref:`devmode` is enabled or a :" -"ref:`debug build ` is used. For example::" +"unless an encoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used. For example::" msgstr "" msgid "" @@ -2382,8 +2414,8 @@ msgid "Added support for keyword arguments." msgstr "" msgid "" -"The value of the *errors* argument is now checked in :ref:`devmode` and in :" -"ref:`debug mode `." +"The value of the *errors* argument is now checked in :ref:`devmode` and " +"in :ref:`debug mode `." msgstr "" msgid "" @@ -2452,8 +2484,8 @@ msgstr "" msgid "" "The :meth:`~str.find` method should be used only if you need to know the " -"position of *sub*. To check if *sub* is a substring or not, use the :" -"keyword:`in` operator::" +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" msgstr "" msgid "" @@ -2487,13 +2519,14 @@ msgid "" msgstr "" msgid "" -"When formatting a number (:class:`int`, :class:`float`, :class:`complex`, :" -"class:`decimal.Decimal` and subclasses) with the ``n`` type (ex: ``'{:n}'." -"format(1234)``), the function temporarily sets the ``LC_CTYPE`` locale to " -"the ``LC_NUMERIC`` locale to decode ``decimal_point`` and ``thousands_sep`` " -"fields of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, " -"and the ``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. " -"This temporary change affects other threads." +"When formatting a number " +"(:class:`int`, :class:`float`, :class:`complex`, :class:`decimal.Decimal` " +"and subclasses) with the ``n`` type (ex: ``'{:n}'.format(1234)``), the " +"function temporarily sets the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` " +"locale to decode ``decimal_point`` and ``thousands_sep`` fields " +"of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, and the " +"``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. This " +"temporary change affects other threads." msgstr "" msgid "" @@ -2529,8 +2562,8 @@ msgstr "" msgid "" "Return ``True`` if all characters in the string are alphanumeric and there " "is at least one character, ``False`` otherwise. A character ``c`` is " -"alphanumeric if one of the following returns ``True``: ``c.isalpha()``, ``c." -"isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``. For example:" +"alphanumeric if one of the following returns ``True``: ``c.isalpha()``, " +"``c.isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``. For example:" msgstr "" msgid "" @@ -2547,11 +2580,11 @@ msgstr "" msgid "" "Return ``True`` if all characters in the string are alphabetic and there is " "at least one character, ``False`` otherwise. Alphabetic characters are " -"those characters defined in the Unicode character database as \"Letter\", i." -"e., those with general category property being one of \"Lm\", \"Lt\", " +"those characters defined in the Unicode character database as \"Letter\", " +"i.e., those with general category property being one of \"Lm\", \"Lt\", " "\"Lu\", \"Ll\", or \"Lo\". Note that this is different from the `Alphabetic " -"property defined in the section 4.10 'Letters, Alphabetic, and Ideographic' " -"of the Unicode Standard `_. For example:" msgstr "" @@ -2603,10 +2636,28 @@ msgid "" "least one character, ``False`` otherwise. Digits include decimal characters " "and digits that need special handling, such as the compatibility superscript " "digits. This covers digits which cannot be used to form numbers in base 10, " -"like the Kharosthi numbers. Formally, a digit is a character that has the " +"like the `Kharosthi numbers `__. Formally, a digit is a character that has the " "property value Numeric_Type=Digit or Numeric_Type=Decimal." msgstr "" +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +">>> '0123456789'.isdigit()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdigit() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isdigit() # Vulgar fraction one fifth\n" +"False\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isnumeric`." +msgstr "" + msgid "" "Return ``True`` if the string is a valid identifier according to the " "language definition, section :ref:`identifiers`." @@ -2646,7 +2697,7 @@ msgstr "" msgid "" ">>> '0123456789'.isnumeric()\n" "True\n" -">>> '٠١٢٣٤٥٦٧٨٩'.isnumeric() # Arabic-indic digit zero to nine\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isnumeric() # Arabic-Indic digits zero to nine\n" "True\n" ">>> '⅕'.isnumeric() # Vulgar fraction one fifth\n" "True\n" @@ -2654,9 +2705,7 @@ msgid "" "(False, True, True)" msgstr "" -msgid "" -"See also :meth:`isdecimal` and :meth:`isdigit`. Numeric characters are a " -"superset of decimal numbers." +msgid "See also :meth:`isdecimal` and :meth:`isdigit`." msgstr "" msgid "" @@ -2679,9 +2728,6 @@ msgid "" "C), except the ASCII space." msgstr "" -msgid "For example:" -msgstr "Na przykład::" - msgid "" ">>> ''.isprintable(), ' '.isprintable()\n" "(True, True)\n" @@ -2709,9 +2755,10 @@ msgid "" msgstr "" msgid "" -"A character is *whitespace* if in the Unicode character database (see :mod:" -"`unicodedata`), either its general category is ``Zs`` (\"Separator, " -"space\"), or its bidirectional class is one of ``WS``, ``B``, or ``S``." +"A character is *whitespace* if in the Unicode character database " +"(see :mod:`unicodedata`), either its general category is ``Zs`` " +"(\"Separator, space\"), or its bidirectional class is one of ``WS``, ``B``, " +"or ``S``." msgstr "" msgid "See also :meth:`isprintable`." @@ -2742,8 +2789,8 @@ msgid "" msgstr "" msgid "" -"Return a string which is the concatenation of the strings in *iterable*. A :" -"exc:`TypeError` will be raised if there are any non-string values in " +"Return a string which is the concatenation of the strings in *iterable*. " +"A :exc:`TypeError` will be raised if there are any non-string values in " "*iterable*, including :class:`bytes` objects. The separator between " "elements is the string providing this method. For example:" msgstr "" @@ -2828,8 +2875,8 @@ msgstr "" "'three!'" msgid "" -"This static method returns a translation table usable for :meth:`str." -"translate`." +"This static method returns a translation table usable " +"for :meth:`str.translate`." msgstr "" msgid "" @@ -2997,9 +3044,10 @@ msgstr "" msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " -"*rightmost* ones. If *sep* is not specified or ``None``, any whitespace " -"string is a separator. Except for splitting from the right, :meth:`rsplit` " -"behaves like :meth:`split` which is described in detail below." +"*rightmost* ones. If *sep* is not specified or ``None``, " +"any :meth:`whitespace ` string is a separator. Except for " +"splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " +"described in detail below." msgstr "" msgid "" @@ -3052,14 +3100,11 @@ msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " "``['1', '', '2']``). The *sep* argument may consist of multiple characters " -"as a single delimiter (to split with multiple delimiters, use :func:`re." -"split`). Splitting an empty string with a specified separator returns " -"``['']``." +"as a single delimiter (to split with multiple delimiters, " +"use :func:`re.split`). Splitting an empty string with a specified separator " +"returns ``['']``." msgstr "" -msgid "For example::" -msgstr "Dla przykładu::" - msgid "" ">>> '1,2,3'.split(',')\n" "['1', '2', '3']\n" @@ -3073,11 +3118,11 @@ msgstr "" msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " -"applied: runs of consecutive whitespace are regarded as a single separator, " -"and the result will contain no empty strings at the start or end if the " -"string has leading or trailing whitespace. Consequently, splitting an empty " -"string or a string consisting of just whitespace with a ``None`` separator " -"returns ``[]``." +"applied: runs of consecutive :meth:`whitespace ` are regarded " +"as a single separator, and the result will contain no empty strings at the " +"start or end if the string has leading or trailing whitespace. " +"Consequently, splitting an empty string or a string consisting of just " +"whitespace with a ``None`` separator returns ``[]``." msgstr "" msgid "" @@ -3103,7 +3148,7 @@ msgid "" "['foo ']" msgstr "" -msgid "See also :meth:`join`." +msgid "See also :meth:`join` and :meth:`rsplit`." msgstr "" msgid "" @@ -3192,6 +3237,9 @@ msgstr "" msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "" +msgid "For example::" +msgstr "Dla przykładu::" + msgid "" ">>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" "['ab c', '', 'de fg', 'kl']\n" @@ -3257,6 +3305,9 @@ msgid "" "all combinations of its values are stripped." msgstr "" +msgid "Whitespace characters are defined by :meth:`str.isspace`." +msgstr "" + msgid "" ">>> ' spacious '.strip()\n" "'spacious'\n" @@ -3360,12 +3411,12 @@ msgstr "" msgid "" "Return a copy of the string in which each character has been mapped through " "the given translation table. The table must be an object that implements " -"indexing via :meth:`~object.__getitem__`, typically a :term:`mapping` or :" -"term:`sequence`. When indexed by a Unicode ordinal (an integer), the table " -"object can do any of the following: return a Unicode ordinal or a string, to " -"map the character to one or more other characters; return ``None``, to " -"delete the character from the return string; or raise a :exc:`LookupError` " -"exception, to map the character to itself." +"indexing via :meth:`~object.__getitem__`, typically a :term:`mapping` " +"or :term:`sequence`. When indexed by a Unicode ordinal (an integer), the " +"table object can do any of the following: return a Unicode ordinal or a " +"string, to map the character to one or more other characters; return " +"``None``, to delete the character from the return string; or raise " +"a :exc:`LookupError` exception, to map the character to itself." msgstr "" msgid "" @@ -3548,7 +3599,7 @@ msgid "" "'0.333333'\n" ">>> f'{one_third:_^+10}'\n" "'___+1/3___'\n" -">>> >>> f'{one_third!r:_^20}'\n" +">>> f'{one_third!r:_^20}'\n" "'___Fraction(1, 3)___'\n" ">>> f'{one_third = :~>10}~'\n" "'one_third = ~~~~~~~1/3~'" @@ -3558,13 +3609,13 @@ msgid "Template String Literals (t-strings)" msgstr "" msgid "" -"An :dfn:`t-string` (formally a :dfn:`template string literal`) is a string " +"A :dfn:`t-string` (formally a :dfn:`template string literal`) is a string " "literal that is prefixed with ``t`` or ``T``." msgstr "" msgid "" "These strings follow the same syntax and evaluation rules as :ref:`formatted " -"string literals `, with for the following differences:" +"string literals `, with the following differences:" msgstr "" msgid "" @@ -3574,19 +3625,21 @@ msgstr "" msgid "" "The :func:`format` protocol is not used. Instead, the format specifier and " -"conversions (if any) are passed to a new :class:`~string.templatelib." -"Interpolation` object that is created for each evaluated expression. It is " -"up to code that processes the resulting :class:`~string.templatelib." -"Template` object to decide how to handle format specifiers and conversions." +"conversions (if any) are passed to a " +"new :class:`~string.templatelib.Interpolation` object that is created for " +"each evaluated expression. It is up to code that processes the " +"resulting :class:`~string.templatelib.Template` object to decide how to " +"handle format specifiers and conversions." msgstr "" msgid "" "Format specifiers containing nested replacement fields are evaluated " -"eagerly, prior to being passed to the :class:`~string.templatelib." -"Interpolation` object. For instance, an interpolation of the form ``{amount:." -"{precision}f}`` will evaluate the inner expression ``{precision}`` to " -"determine the value of the ``format_spec`` attribute. If ``precision`` were " -"to be ``2``, the resulting format specifier would be ``'.2f'``." +"eagerly, prior to being passed to " +"the :class:`~string.templatelib.Interpolation` object. For instance, an " +"interpolation of the form ``{amount:.{precision}f}`` will evaluate the inner " +"expression ``{precision}`` to determine the value of the ``format_spec`` " +"attribute. If ``precision`` were to be ``2``, the resulting format specifier " +"would be ``'.2f'``." msgstr "" msgid "" @@ -3594,10 +3647,10 @@ msgid "" "text of the expression is appended to the literal string that precedes the " "relevant interpolation. This includes the equals sign and any surrounding " "whitespace. The :class:`!Interpolation` instance for the expression will be " -"created as normal, except that :attr:`~string.templatelib.Interpolation." -"conversion` will be set to '``r``' (:func:`repr`) by default. If an explicit " -"conversion or format specifier are provided, this will override the default " -"behaviour." +"created as normal, except " +"that :attr:`~string.templatelib.Interpolation.conversion` will be set to " +"'``r``' (:func:`repr`) by default. If an explicit conversion or format " +"specifier is provided, this will override the default behaviour." msgstr "" msgid "``printf``-style String Formatting" @@ -3894,15 +3947,15 @@ msgid "" msgstr "" msgid "" -"Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" -"`memoryview`" +"Binary Sequence Types " +"--- :class:`bytes`, :class:`bytearray`, :class:`memoryview`" msgstr "" msgid "" -"The core built-in types for manipulating binary data are :class:`bytes` and :" -"class:`bytearray`. They are supported by :class:`memoryview` which uses the :" -"ref:`buffer protocol ` to access the memory of other binary " -"objects without needing to make a copy." +"The core built-in types for manipulating binary data are :class:`bytes` " +"and :class:`bytearray`. They are supported by :class:`memoryview` which uses " +"the :ref:`buffer protocol ` to access the memory of other " +"binary objects without needing to make a copy." msgstr "" msgid "" @@ -4078,8 +4131,8 @@ msgid "" msgstr "" msgid "" -"This :class:`bytearray` class method returns bytearray object, decoding the " -"given string object. The string must contain two hexadecimal digits per " +"This :class:`bytearray` class method returns a bytearray object, decoding " +"the given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" @@ -4259,20 +4312,20 @@ msgstr "" msgid "" "*errors* controls how decoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " -"are ``'ignore'``, ``'replace'``, and any other name registered via :func:" -"`codecs.register_error`. See :ref:`error-handlers` for details." +"are ``'ignore'``, ``'replace'``, and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" msgid "" "For performance reasons, the value of *errors* is not checked for validity " -"unless a decoding error actually occurs, :ref:`devmode` is enabled or a :ref:" -"`debug build ` is used." +"unless a decoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used." msgstr "" msgid "" -"Passing the *encoding* argument to :class:`str` allows decoding any :term:" -"`bytes-like object` directly, without needing to make a temporary :class:`!" -"bytes` or :class:`!bytearray` object." +"Passing the *encoding* argument to :class:`str` allows decoding " +"any :term:`bytes-like object` directly, without needing to make a " +"temporary :class:`!bytes` or :class:`!bytearray` object." msgstr "" msgid "" @@ -4294,8 +4347,8 @@ msgstr "" msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " -"position of *sub*. To check if *sub* is a substring or not, use the :" -"keyword:`in` operator::" +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" msgstr "" msgid "" @@ -4320,10 +4373,10 @@ msgid "" msgstr "" msgid "" -"This static method returns a translation table usable for :meth:`bytes." -"translate` that will map each character in *from* into the character at the " -"same position in *to*; *from* and *to* must both be :term:`bytes-like " -"objects ` and have the same length." +"This static method returns a translation table usable " +"for :meth:`bytes.translate` that will map each character in *from* into the " +"character at the same position in *to*; *from* and *to* must both " +"be :term:`bytes-like objects ` and have the same length." msgstr "" msgid "" @@ -4430,8 +4483,8 @@ msgid "" "Return a copy of the sequence with specified leading bytes removed. The " "*bytes* argument is a binary sequence specifying the set of byte values to " "be removed. If omitted or ``None``, the *bytes* argument defaults to " -"removing ASCII whitespace. The *bytes* argument is not a prefix; rather, " -"all combinations of its values are stripped::" +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a prefix; rather, all combinations of its values are stripped::" msgstr "" msgid "" @@ -4473,17 +4526,17 @@ msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " "done, the *rightmost* ones. If *sep* is not specified or ``None``, any " -"subsequence consisting solely of ASCII whitespace is a separator. Except for " -"splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " -"described in detail below." +"subsequence consisting solely of :meth:`ASCII whitespace ` is " +"a separator. Except for splitting from the right, :meth:`rsplit` behaves " +"like :meth:`split` which is described in detail below." msgstr "" msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " "*bytes* argument is a binary sequence specifying the set of byte values to " "be removed. If omitted or ``None``, the *bytes* argument defaults to " -"removing ASCII whitespace. The *bytes* argument is not a suffix; rather, " -"all combinations of its values are stripped::" +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a suffix; rather, all combinations of its values are stripped::" msgstr "" msgid "" @@ -4545,11 +4598,11 @@ msgstr "" msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " -"applied: runs of consecutive ASCII whitespace are regarded as a single " -"separator, and the result will contain no empty strings at the start or end " -"if the sequence has leading or trailing whitespace. Consequently, splitting " -"an empty sequence or a sequence consisting solely of ASCII whitespace " -"without a specified separator returns ``[]``." +"applied: runs of consecutive :meth:`ASCII whitespace ` are " +"regarded as a single separator, and the result will contain no empty strings " +"at the start or end if the sequence has leading or trailing whitespace. " +"Consequently, splitting an empty sequence or a sequence consisting solely of " +"ASCII whitespace without a specified separator returns ``[]``." msgstr "" msgid "" @@ -4565,8 +4618,9 @@ msgid "" "Return a copy of the sequence with specified leading and trailing bytes " "removed. The *bytes* argument is a binary sequence specifying the set of " "byte values to be removed. If omitted or ``None``, the *bytes* argument " -"defaults to removing ASCII whitespace. The *bytes* argument is not a prefix " -"or suffix; rather, all combinations of its values are stripped::" +"defaults to removing :meth:`ASCII whitespace `. The *bytes* " +"argument is not a prefix or suffix; rather, all combinations of its values " +"are stripped::" msgstr "" msgid "" @@ -4798,10 +4852,10 @@ msgstr "" "b'hELLO wORLD'" msgid "" -"Unlike :func:`str.swapcase`, it is always the case that ``bin.swapcase()." -"swapcase() == bin`` for the binary versions. Case conversions are " -"symmetrical in ASCII, even though that is not generally true for arbitrary " -"Unicode code points." +"Unlike :func:`str.swapcase`, it is always the case that " +"``bin.swapcase().swapcase() == bin`` for the binary versions. Case " +"conversions are symmetrical in ASCII, even though that is not generally true " +"for arbitrary Unicode code points." msgstr "" msgid "" @@ -4893,8 +4947,8 @@ msgid "" "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " "*interpolation* operator. Given ``format % values`` (where *format* is a " "bytes object), ``%`` conversion specifications in *format* are replaced with " -"zero or more elements of *values*. The effect is similar to using the :c:" -"func:`sprintf` in the C language." +"zero or more elements of *values*. The effect is similar to using " +"the :c:func:`sprintf` function in the C language." msgstr "" msgid "" @@ -4975,8 +5029,13 @@ msgid "" msgstr "" msgid "" -"``len(view)`` is equal to the length of :class:`~memoryview.tolist`, which " -"is the nested list representation of the view. If ``view.ndim = 1``, this is " +":class:`!memoryview`\\s are :ref:`generic ` over the type of their " +"underlying data." +msgstr "" + +msgid "" +"``len(view)`` is equal to the length of :meth:`~memoryview.tolist`, which is " +"the nested list representation of the view. If ``view.ndim == 1``, this is " "equal to the number of elements in the view." msgstr "" @@ -5080,11 +5139,11 @@ msgid "" msgstr "" msgid "" -"memoryview is now registered automatically with :class:`collections.abc." -"Sequence`" +"memoryview is now registered automatically " +"with :class:`collections.abc.Sequence`" msgstr "" -msgid "memoryviews can now be indexed with tuple of integers." +msgid "memoryviews can now be indexed with a tuple of integers." msgstr "" msgid "memoryview is now a :term:`generic type`." @@ -5100,8 +5159,9 @@ msgid "" msgstr "" msgid "" -"For the subset of :mod:`struct` format strings currently supported by :meth:" -"`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" +"For the subset of :mod:`struct` format strings currently supported " +"by :meth:`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == " +"w.tolist()``::" msgstr "" msgid "" @@ -5219,8 +5279,8 @@ msgid "" msgstr "" msgid "" -":meth:`tolist` now supports all single character native formats in :mod:" -"`struct` module syntax as well as multi-dimensional representations." +":meth:`tolist` now supports all single character native formats " +"in :mod:`struct` module syntax as well as multi-dimensional representations." msgstr "" msgid "" @@ -5244,8 +5304,8 @@ msgstr "" msgid "" "Release the underlying buffer exposed by the memoryview object. Many " -"objects take special actions when a view is held on them (for example, a :" -"class:`bytearray` would temporarily forbid resizing); therefore, calling " +"objects take special actions when a view is held on them (for example, " +"a :class:`bytearray` would temporarily forbid resizing); therefore, calling " "release() is handy to remove these restrictions (and free any dangling " "resources) as soon as possible." msgstr "" @@ -5290,10 +5350,10 @@ msgid "" msgstr "" msgid "" -"The destination format is restricted to a single element native format in :" -"mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " -"'c'). The byte length of the result must be the same as the original length. " -"Note that all byte lengths may depend on the operating system." +"The destination format is restricted to a single element native format " +"in :mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' " +"or 'c'). The byte length of the result must be the same as the original " +"length. Note that all byte lengths may depend on the operating system." msgstr "" msgid "Cast 1D/long to 1D/unsigned bytes::" @@ -5512,8 +5572,8 @@ msgid "A bool indicating whether the memory is :term:`contiguous`." msgstr "" msgid "" -"For information on the thread safety of :class:`memoryview` objects in the :" -"term:`free-threaded build`, see :ref:`thread-safety-memoryview`." +"For information on the thread safety of :class:`memoryview` objects in " +"the :term:`free-threaded build`, see :ref:`thread-safety-memoryview`." msgstr "" msgid "Set Types --- :class:`set`, :class:`frozenset`" @@ -5524,8 +5584,9 @@ msgid "" "objects. Common uses include membership testing, removing duplicates from a " "sequence, and computing mathematical operations such as intersection, union, " "difference, and symmetric difference. (For other containers see the built-" -"in :class:`dict`, :class:`list`, and :class:`tuple` classes, and the :mod:" -"`collections` module.)" +"in :class:`dict`, :class:`list`, and :class:`tuple` classes, and " +"the :mod:`collections` module.) See :ref:`time-complexity` for the costs of " +"the various set operations." msgstr "" msgid "" @@ -5536,10 +5597,10 @@ msgid "" msgstr "" msgid "" -"There are currently two built-in set types, :class:`set` and :class:" -"`frozenset`. The :class:`set` type is mutable --- the contents can be " -"changed using methods like :meth:`~set.add` and :meth:`~set.remove`. Since " -"it is mutable, it has no hash value and cannot be used as either a " +"There are currently two built-in set types, :class:`set` " +"and :class:`frozenset`. The :class:`set` type is mutable --- the contents " +"can be changed using methods like :meth:`~set.add` and :meth:`~set.remove`. " +"Since it is mutable, it has no hash value and cannot be used as either a " "dictionary key or as an element of another set. The :class:`frozenset` type " "is immutable and :term:`hashable` --- its contents cannot be altered after " "it is created; it can therefore be used as a dictionary key or as an element " @@ -5630,13 +5691,13 @@ msgid "Return a shallow copy of the set." msgstr "" msgid "" -"Note, the non-operator versions of :meth:`~frozenset.union`, :meth:" -"`~frozenset.intersection`, :meth:`~frozenset.difference`, :meth:`~frozenset." -"symmetric_difference`, :meth:`~frozenset.issubset`, and :meth:`~frozenset." -"issuperset` methods will accept any iterable as an argument. In contrast, " -"their operator based counterparts require their arguments to be sets. This " -"precludes error-prone constructions like ``set('abc') & 'cbs'`` in favor of " -"the more readable ``set('abc').intersection('cbs')``." +"Note, the non-operator versions " +"of :meth:`~frozenset.union`, :meth:`~frozenset.intersection`, :meth:`~frozenset.difference`, :meth:`~frozenset.symmetric_difference`, :meth:`~frozenset.issubset`, " +"and :meth:`~frozenset.issuperset` methods will accept any iterable as an " +"argument. In contrast, their operator based counterparts require their " +"arguments to be sets. This precludes error-prone constructions like " +"``set('abc') & 'cbs'`` in favor of the more readable " +"``set('abc').intersection('cbs')``." msgstr "" msgid "" @@ -5713,16 +5774,17 @@ msgid "Remove all elements from the set." msgstr "" msgid "" -"Note, the non-operator versions of the :meth:`~set.update`, :meth:`~set." -"intersection_update`, :meth:`~set.difference_update`, and :meth:`~set." -"symmetric_difference_update` methods will accept any iterable as an argument." +"Note, the non-operator versions of " +"the :meth:`~set.update`, :meth:`~set.intersection_update`, :meth:`~set.difference_update`, " +"and :meth:`~set.symmetric_difference_update` methods will accept any " +"iterable as an argument." msgstr "" msgid "" -"Note, the *elem* argument to the :meth:`~object.__contains__`, :meth:`~set." -"remove`, and :meth:`~set.discard` methods may be a set. To support " -"searching for an equivalent frozenset, a temporary one is created from " -"*elem*." +"Note, the *elem* argument to " +"the :meth:`~object.__contains__`, :meth:`~set.remove`, " +"and :meth:`~set.discard` methods may be a set. To support searching for an " +"equivalent frozenset, a temporary one is created from *elem*." msgstr "" msgid "" @@ -5730,23 +5792,30 @@ msgid "" "objects, see :ref:`thread-safety-set`." msgstr "" +msgid "" +"Sets and frozensets are :ref:`generic ` over the type of their " +"elements." +msgstr "" + msgid "Mapping Types --- :class:`dict`" msgstr "" msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " -"type, the :dfn:`dictionary`. (For other containers see the built-in :class:" -"`list`, :class:`set`, and :class:`tuple` classes, and the :mod:`collections` " -"module.)" +"type, the :dfn:`dictionary`. (For other containers see the built-" +"in :class:`list`, :class:`set`, and :class:`tuple` classes, and " +"the :mod:`collections` module.) See :ref:`time-complexity` for the costs of " +"the various dictionary operations." msgstr "" msgid "" -"A dictionary's keys are *almost* arbitrary values. Values that are not :" -"term:`hashable`, that is, values containing lists, dictionaries or other " -"mutable types (that are compared by value rather than by object identity) " -"may not be used as keys. Values that compare equal (such as ``1``, ``1.0``, " -"and ``True``) can be used interchangeably to index the same dictionary entry." +"A dictionary's keys are *almost* arbitrary values. Values that are " +"not :term:`hashable`, that is, values containing lists, dictionaries or " +"other mutable types (that are compared by value rather than by object " +"identity) may not be used as keys. Values that compare equal (such as ``1``, " +"``1.0``, and ``True``) can be used interchangeably to index the same " +"dictionary entry." msgstr "" msgid "" @@ -5840,6 +5909,11 @@ msgid "" "implementation detail of CPython from 3.6." msgstr "" +msgid "" +"Dictionaries are :ref:`generic ` over two types, signifying " +"(respectively) the types of the dictionary's keys and values." +msgstr "" + msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" @@ -5861,9 +5935,10 @@ msgid "" "is not present, the ``d[key]`` operation calls that method with the key " "*key* as argument. The ``d[key]`` operation then returns or raises whatever " "is returned or raised by the ``__missing__(key)`` call. No other operations " -"or methods invoke :meth:`~object.__missing__`. If :meth:`~object." -"__missing__` is not defined, :exc:`KeyError` is raised. :meth:`~object." -"__missing__` must be a method; it cannot be an instance variable::" +"or methods invoke :meth:`~object.__missing__`. " +"If :meth:`~object.__missing__` is not defined, :exc:`KeyError` is " +"raised. :meth:`~object.__missing__` must be a method; it cannot be an " +"instance variable::" msgstr "" msgid "" @@ -5880,9 +5955,9 @@ msgid "" msgstr "" msgid "" -"The example above shows part of the implementation of :class:`collections." -"Counter`. A different :meth:`!__missing__` method is used by :class:" -"`collections.defaultdict`." +"The example above shows part of the implementation " +"of :class:`collections.Counter`. A different :meth:`!__missing__` method is " +"used by :class:`collections.defaultdict`." msgstr "" msgid "Set ``d[key]`` to *value*." @@ -5940,8 +6015,8 @@ msgstr "" msgid "" "If *key* is in the dictionary, remove it and return its value, else return " -"*default*. If *default* is not given and *key* is not in the dictionary, a :" -"exc:`KeyError` is raised." +"*default*. If *default* is not given and *key* is not in the dictionary, " +"a :exc:`KeyError` is raised." msgstr "" msgid "" @@ -5951,8 +6026,8 @@ msgstr "" msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " -"often used in set algorithms. If the dictionary is empty, calling :meth:" -"`popitem` raises a :exc:`KeyError`." +"often used in set algorithms. If the dictionary is empty, " +"calling :meth:`popitem` raises a :exc:`KeyError`." msgstr "" msgid "" @@ -6034,8 +6109,8 @@ msgid "Dictionaries are now reversible." msgstr "" msgid "" -":class:`types.MappingProxyType` can be used to create a read-only view of a :" -"class:`dict`." +":class:`types.MappingProxyType` can be used to create a read-only view of " +"a :class:`dict`." msgstr "" msgid "" @@ -6047,10 +6122,10 @@ msgid "Dictionary view objects" msgstr "" msgid "" -"The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" -"`dict.items` are *view objects*. They provide a dynamic view on the " -"dictionary's entries, which means that when the dictionary changes, the view " -"reflects these changes." +"The objects returned by :meth:`dict.keys`, :meth:`dict.values` " +"and :meth:`dict.items` are *view objects*. They provide a dynamic view on " +"the dictionary's entries, which means that when the dictionary changes, the " +"view reflects these changes." msgstr "" msgid "" @@ -6068,9 +6143,9 @@ msgstr "" msgid "" "Keys and values are iterated over in insertion order. This allows the " -"creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." -"values(), d.keys())``. Another way to create the same list is ``pairs = " -"[(v, k) for (k, v) in d.items()]``." +"creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = " +"zip(d.values(), d.keys())``. Another way to create the same list is ``pairs " +"= [(v, k) for (k, v) in d.items()]``." msgstr "" msgid "" @@ -6174,8 +6249,9 @@ msgstr "" msgid "" "An example of a context manager that returns itself is a :term:`file " -"object`. File objects return themselves from __enter__() to allow :func:" -"`open` to be used as the context expression in a :keyword:`with` statement." +"object`. File objects return themselves from __enter__() to " +"allow :func:`open` to be used as the context expression in a :keyword:`with` " +"statement." msgstr "" msgid "" @@ -6212,8 +6288,8 @@ msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " "successfully and does not want to suppress the raised exception. This allows " -"context management code to easily detect whether or not an :meth:`~object." -"__exit__` method has actually failed." +"context management code to easily detect whether or not " +"an :meth:`~object.__exit__` method has actually failed." msgstr "" msgid "" @@ -6228,9 +6304,10 @@ msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " "generator function is decorated with the :class:`contextlib.contextmanager` " -"decorator, it will return a context manager implementing the necessary :meth:" -"`~contextmanager.__enter__` and :meth:`~contextmanager.__exit__` methods, " -"rather than the iterator produced by an undecorated generator function." +"decorator, it will return a context manager implementing the " +"necessary :meth:`~contextmanager.__enter__` " +"and :meth:`~contextmanager.__exit__` methods, rather than the iterator " +"produced by an undecorated generator function." msgstr "" msgid "" @@ -6242,13 +6319,13 @@ msgid "" msgstr "" msgid "" -"Type Annotation Types --- :ref:`Generic Alias `, :ref:" -"`Union `" +"Type Annotation Types --- :ref:`Generic Alias `, :ref:`Union `" msgstr "" msgid "" -"The core built-in types for :term:`type annotations ` are :ref:" -"`Generic Alias ` and :ref:`Union `." +"The core built-in types for :term:`type annotations ` " +"are :ref:`Generic Alias ` and :ref:`Union `." msgstr "" msgid "Generic Alias Type" @@ -6277,8 +6354,8 @@ msgid "" "For a container class, the argument(s) supplied to a :ref:`subscription " "` of the class may indicate the type(s) of the elements an " "object contains. For example, ``set[bytes]`` can be used in type annotations " -"to signify a :class:`set` in which all the elements are of type :class:" -"`bytes`." +"to signify a :class:`set` in which all the elements are of " +"type :class:`bytes`." msgstr "" msgid "" @@ -6298,16 +6375,18 @@ msgstr "" msgid "" "If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " -"``y`` will also be an instance of ``re.Match``, but the return values of ``y." -"group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " +"``y`` will also be an instance of ``re.Match``, but the return values of " +"``y.group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " "annotations, we would represent this variety of :ref:`re.Match ` objects with ``re.Match[bytes]``." msgstr "" msgid "" -"``GenericAlias`` objects are instances of the class :class:`types." -"GenericAlias`, which can also be used to create ``GenericAlias`` objects " -"directly." +"``GenericAlias`` objects are instances of the " +"class :class:`types.GenericAlias`, which can also be used to create " +"``GenericAlias`` objects directly. Specializations of user-" +"defined :ref:`generic classes ` may not be instances " +"of :class:`types.GenericAlias`, but they provide similar functionality." msgstr "" msgid "" @@ -6377,6 +6456,21 @@ msgid "" "" msgstr "" +msgid "" +"Instances of ``GenericAlias`` are not classes at runtime, even though they " +"behave like classes (they can be instantiated and subclassed)::" +msgstr "" + +msgid "" +">>> import inspect\n" +">>> inspect.isclass(list[int])\n" +"False" +msgstr "" + +msgid "" +"This is true for :ref:`user-defined generics ` also." +msgstr "" + msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" @@ -6645,8 +6739,9 @@ msgstr "" msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " -"have correct ``__parameters__`` after substitution because :class:`typing." -"ParamSpec` is intended primarily for static type checking." +"have correct ``__parameters__`` after substitution " +"because :class:`typing.ParamSpec` is intended primarily for static type " +"checking." msgstr "" msgid "" @@ -6665,13 +6760,13 @@ msgstr "" msgid "" "Introducing the ability to natively parameterize standard-library classes, " -"provided they implement the special class method :meth:`~object." -"__class_getitem__`." +"provided they implement the special class " +"method :meth:`~object.__class_getitem__`." msgstr "" msgid "" -":ref:`Generics`, :ref:`user-defined generics ` and :" -"class:`typing.Generic`" +":ref:`Generics`, :ref:`user-defined generics ` " +"and :class:`typing.Generic`" msgstr "" msgid "" @@ -6686,15 +6781,15 @@ msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " "primarily for :term:`type annotations `. The union type " -"expression enables cleaner type hinting syntax compared to subscripting :" -"class:`typing.Union`." +"expression enables cleaner type hinting syntax compared to " +"subscripting :class:`typing.Union`." msgstr "" msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " -"example, the following function expects an argument of type :class:`int` or :" -"class:`float`::" +"example, the following function expects an argument of type :class:`int` " +"or :class:`float`::" msgstr "" msgid "" @@ -6703,7 +6798,7 @@ msgid "" msgstr "" msgid "" -"The ``|`` operand cannot be used at runtime to define unions where one or " +"The ``|`` operator cannot be used at runtime to define unions where one or " "more members is a forward reference. For example, ``int | \"Foo\"``, where " "``\"Foo\"`` is a reference to a class not yet defined, will fail at runtime. " "For unions which include forward references, present the whole expression as " @@ -6773,8 +6868,8 @@ msgid "" msgstr "" msgid "" -"The user-exposed type for the union object can be accessed from :class:" -"`typing.Union` and used for :func:`isinstance` checks::" +"The user-exposed type for the union object can be accessed " +"from :class:`typing.Union` and used for :func:`isinstance` checks::" msgstr "" msgid "" @@ -6812,8 +6907,8 @@ msgstr "" msgid "" "Union objects are now instances of :class:`typing.Union`. Previously, they " -"were instances of :class:`types.UnionType`, which remains an alias for :" -"class:`typing.Union`." +"were instances of :class:`types.UnionType`, which remains an alias " +"for :class:`typing.Union`." msgstr "" msgid "Other Built-in Types" @@ -6830,10 +6925,10 @@ msgstr "Moduły" msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " -"table. Module attributes can be assigned to. (Note that the :keyword:" -"`import` statement is not, strictly speaking, an operation on a module " -"object; ``import foo`` does not require a module object named *foo* to " -"exist, rather it requires an (external) *definition* for a module named " +"table. Module attributes can be assigned to. (Note that " +"the :keyword:`import` statement is not, strictly speaking, an operation on a " +"module object; ``import foo`` does not require a module object named *foo* " +"to exist, rather it requires an (external) *definition* for a module named " "*foo* somewhere.)" msgstr "" @@ -6841,16 +6936,16 @@ msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " "will actually change the module's symbol table, but direct assignment to " -"the :attr:`~object.__dict__` attribute is not possible (you can write ``m." -"__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't write " -"``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is not " -"recommended." +"the :attr:`~object.__dict__` attribute is not possible (you can write " +"``m.__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't " +"write ``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is " +"not recommended." msgstr "" msgid "" -"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." +"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." msgstr "" msgid "Classes and Class Instances" @@ -6882,21 +6977,21 @@ msgstr "" msgid "" "Methods are functions that are called using the attribute notation. There " -"are two flavors: :ref:`built-in methods ` (such as :meth:" -"`~list.append` on lists) and :ref:`class instance method ` (such " +"as :meth:`~list.append` on lists) and :ref:`class instance methods `. Built-in methods are described with the types that support them." msgstr "" msgid "" "If you access a method (a function defined in a class namespace) through an " -"instance, you get a special object: a :dfn:`bound method` (also called :ref:" -"`instance method `) object. When called, it will add the " -"``self`` argument to the argument list. Bound methods have two special read-" -"only attributes: :attr:`m.__self__ ` is the object on which " -"the method operates, and :attr:`m.__func__ ` is the " -"function implementing the method. Calling ``m(arg-1, arg-2, ..., arg-n)`` " -"is completely equivalent to calling ``m.__func__(m.__self__, arg-1, " -"arg-2, ..., arg-n)``." +"instance, you get a special object: a :dfn:`bound method` (also " +"called :ref:`instance method `) object. When called, it " +"will add the ``self`` argument to the argument list. Bound methods have two " +"special read-only attributes: :attr:`m.__self__ ` is the " +"object on which the method operates, and :attr:`m.__func__ " +"` is the function implementing the method. Calling " +"``m(arg-1, arg-2, ..., arg-n)`` is completely equivalent to calling " +"``m.__func__(m.__self__, arg-1, arg-2, ..., arg-n)``." msgstr "" msgid "" @@ -6935,8 +7030,8 @@ msgid "" "executable Python code such as a function body. They differ from function " "objects because they don't contain a reference to their global execution " "environment. Code objects are returned by the built-in :func:`compile` " -"function and can be extracted from function objects through their :attr:" -"`~function.__code__` attribute. See also the :mod:`code` module." +"function and can be extracted from function objects through " +"their :attr:`~function.__code__` attribute. See also the :mod:`code` module." msgstr "" msgid "" @@ -7037,8 +7132,8 @@ msgstr "" msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " -"more information. There is exactly one :data:`NotImplemented` object. :code:" -"`type(NotImplemented)()` produces the singleton instance." +"more information. There is exactly one :data:`NotImplemented` " +"object. :code:`type(NotImplemented)()` produces the singleton instance." msgstr "" msgid "It is written as :code:`NotImplemented`." @@ -7058,8 +7153,8 @@ msgstr "" msgid "" "The implementation adds a few special read-only attributes to several object " -"types, where they are relevant. Some of these are not reported by the :func:" -"`dir` built-in function." +"types, where they are relevant. Some of these are not reported by " +"the :func:`dir` built-in function." msgstr "" msgid "" @@ -7079,19 +7174,19 @@ msgid "" msgstr "" msgid "" -"The :ref:`type parameters ` of generic classes, functions, and :" -"ref:`type aliases `. For classes and functions that are not " -"generic, this will be an empty tuple." +"The :ref:`type parameters ` of generic classes, functions, " +"and :ref:`type aliases `. For classes and functions that are " +"not generic, this will be an empty tuple." msgstr "" msgid "Integer string conversion length limitation" msgstr "" msgid "" -"CPython has a global limit for converting between :class:`int` and :class:" -"`str` to mitigate denial of service attacks. This limit *only* applies to " -"decimal or other non-power-of-two number bases. Hexadecimal, octal, and " -"binary conversions are unlimited. The limit can be configured." +"CPython has a global limit for converting between :class:`int` " +"and :class:`str` to mitigate denial of service attacks. This limit *only* " +"applies to decimal or other non-power-of-two number bases. Hexadecimal, " +"octal, and binary conversions are unlimited. The limit can be configured." msgstr "" msgid "" @@ -7141,10 +7236,10 @@ msgid "" msgstr "" msgid "" -"The default limit is 4300 digits as provided in :data:`sys.int_info." -"default_max_str_digits `. The lowest limit that can be " -"configured is 640 digits as provided in :data:`sys.int_info." -"str_digits_check_threshold `." +"The default limit is 4300 digits as provided " +"in :data:`sys.int_info.default_max_str_digits `. The lowest " +"limit that can be configured is 640 digits as provided " +"in :data:`sys.int_info.str_digits_check_threshold `." msgstr "" msgid "Verification:" @@ -7164,8 +7259,8 @@ msgid "Affected APIs" msgstr "" msgid "" -"The limitation only applies to potentially slow conversions between :class:" -"`int` and :class:`str` or :class:`bytes`:" +"The limitation only applies to potentially slow conversions " +"between :class:`int` and :class:`str` or :class:`bytes`:" msgstr "" msgid "``int(string)`` with default base 10." @@ -7226,16 +7321,17 @@ msgid "" msgstr "" msgid "" -":data:`sys.flags.int_max_str_digits` contains the value of :envvar:" -"`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. If both the " -"env var and the ``-X`` option are set, the ``-X`` option takes precedence. A " -"value of *-1* indicates that both were unset, thus a value of :data:`sys." -"int_info.default_max_str_digits` was used during initialization." +":data:`sys.flags.int_max_str_digits` contains the value " +"of :envvar:`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. " +"If both the env var and the ``-X`` option are set, the ``-X`` option takes " +"precedence. A value of *-1* indicates that both were unset, thus a value " +"of :data:`sys.int_info.default_max_str_digits` was used during " +"initialization." msgstr "" msgid "" -"From code, you can inspect the current limit and set a new one using these :" -"mod:`sys` APIs:" +"From code, you can inspect the current limit and set a new one using " +"these :mod:`sys` APIs:" msgstr "" msgid "" @@ -7245,8 +7341,8 @@ msgid "" msgstr "" msgid "" -"Information about the default and minimum can be found in :data:`sys." -"int_info`:" +"Information about the default and minimum can be found " +"in :data:`sys.int_info`:" msgstr "" msgid "" diff --git a/library/string.po b/library/string.po index 914d668380..d627d8f636 100644 --- a/library/string.po +++ b/library/string.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-01 14:49+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-17 17:36+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -42,9 +42,9 @@ msgid "The constants defined in this module are:" msgstr "" msgid "" -"The concatenation of the :const:`ascii_lowercase` and :const:" -"`ascii_uppercase` constants described below. This value is not locale-" -"dependent." +"The concatenation of the :const:`ascii_lowercase` " +"and :const:`ascii_uppercase` constants described below. This value is not " +"locale-dependent." msgstr "" msgid "" @@ -73,14 +73,15 @@ msgstr "" msgid "" "String of ASCII characters which are considered printable by Python. This is " -"a combination of :const:`digits`, :const:`ascii_letters`, :const:" -"`punctuation`, and :const:`whitespace`." +"a combination " +"of :const:`digits`, :const:`ascii_letters`, :const:`punctuation`, " +"and :const:`whitespace`." msgstr "" msgid "" -"By design, :meth:`string.printable.isprintable() ` returns :" -"const:`False`. In particular, ``string.printable`` is not printable in the " -"POSIX sense (see :manpage:`LC_CTYPE `)." +"By design, :meth:`string.printable.isprintable() ` " +"returns :const:`False`. In particular, ``string.printable`` is not printable " +"in the POSIX sense (see :manpage:`LC_CTYPE `)." msgstr "" msgid "" @@ -106,8 +107,8 @@ msgstr "" msgid "" "The primary API method. It takes a format string and an arbitrary set of " -"positional and keyword arguments. It is just a wrapper that calls :meth:" -"`vformat`." +"positional and keyword arguments. It is just a wrapper that " +"calls :meth:`vformat`." msgstr "" msgid "" @@ -119,9 +120,10 @@ msgid "" "This function does the actual work of formatting. It is exposed as a " "separate function for cases where you want to pass in a predefined " "dictionary of arguments, rather than unpacking and repacking the dictionary " -"as individual arguments using the ``*args`` and ``**kwargs`` syntax. :meth:" -"`vformat` does the work of breaking up the format string into character data " -"and replacement fields. It calls the various methods described below." +"as individual arguments using the ``*args`` and ``**kwargs`` " +"syntax. :meth:`vformat` does the work of breaking up the format string into " +"character data and replacement fields. It calls the various methods " +"described below." msgstr "" msgid "" @@ -150,9 +152,9 @@ msgid "" "Given *field_name*, convert it to an object to be formatted. Auto-numbering " "of *field_name* returned from :meth:`parse` is done by :meth:`vformat` " "before calling this method. Returns a tuple (obj, used_key). The default " -"version takes strings of the form defined in :pep:`3101`, such as " -"\"0[name]\" or \"label.title\". *args* and *kwargs* are as passed in to :" -"meth:`vformat`. The return value *used_key* has the same meaning as the " +"version takes strings of the form defined in :pep:`3101`, such as \"0[name]" +"\" or \"label.title\". *args* and *kwargs* are as passed in " +"to :meth:`vformat`. The return value *used_key* has the same meaning as the " "*key* parameter to :meth:`get_value`." msgstr "" @@ -164,9 +166,9 @@ msgid "" msgstr "" msgid "" -"The *args* parameter is set to the list of positional arguments to :meth:" -"`vformat`, and the *kwargs* parameter is set to the dictionary of keyword " -"arguments." +"The *args* parameter is set to the list of positional arguments " +"to :meth:`vformat`, and the *kwargs* parameter is set to the dictionary of " +"keyword arguments." msgstr "" msgid "" @@ -178,13 +180,13 @@ msgstr "" msgid "" "So for example, the field expression '0.name' would cause :meth:`get_value` " "to be called with a *key* argument of 0. The ``name`` attribute will be " -"looked up after :meth:`get_value` returns by calling the built-in :func:" -"`getattr` function." +"looked up after :meth:`get_value` returns by calling the built-" +"in :func:`getattr` function." msgstr "" msgid "" -"If the index or keyword refers to an item that does not exist, then an :exc:" -"`IndexError` or :exc:`KeyError` should be raised." +"If the index or keyword refers to an item that does not exist, then " +"an :exc:`IndexError` or :exc:`KeyError` should be raised." msgstr "" msgid "" @@ -192,8 +194,9 @@ msgid "" "function is the set of all argument keys that were actually referred to in " "the format string (integers for positional arguments, and strings for named " "arguments), and a reference to the *args* and *kwargs* that was passed to " -"vformat. The set of unused args can be calculated from these parameters. :" -"meth:`check_unused_args` is assumed to raise an exception if the check fails." +"vformat. The set of unused args can be calculated from these " +"parameters. :meth:`check_unused_args` is assumed to raise an exception if " +"the check fails." msgstr "" msgid "" @@ -214,9 +217,10 @@ msgid "" "The :meth:`str.format` method and the :class:`Formatter` class share the " "same syntax for format strings (although in the case of :class:`Formatter`, " "subclasses can define their own format string syntax). The syntax is " -"related to that of :ref:`formatted string literals ` and :ref:" -"`template string literals `, but it is less sophisticated and, in " -"particular, does not support arbitrary expressions in interpolations." +"related to that of :ref:`formatted string literals ` " +"and :ref:`template string literals `, but it is less " +"sophisticated and, in particular, does not support arbitrary expressions in " +"interpolations." msgstr "" msgid "" @@ -253,9 +257,9 @@ msgid "" "not quote-delimited, it is not possible to specify arbitrary dictionary keys " "(e.g., the strings ``'10'`` or ``':-]'``) within a format string. The " "*arg_name* can be followed by any number of index or attribute expressions. " -"An expression of the form ``'.name'`` selects the named attribute using :" -"func:`getattr`, while an expression of the form ``'[index]'`` does an index " -"lookup using :meth:`~object.__getitem__`." +"An expression of the form ``'.name'`` selects the named attribute " +"using :func:`getattr`, while an expression of the form ``'[index]'`` does an " +"index lookup using :meth:`~object.__getitem__`." msgstr "" msgid "" @@ -287,14 +291,14 @@ msgid "" "the job of formatting a value is done by the :meth:`~object.__format__` " "method of the value itself. However, in some cases it is desirable to force " "a type to be formatted as a string, overriding its own definition of " -"formatting. By converting the value to a string before calling :meth:" -"`~object.__format__`, the normal formatting logic is bypassed." +"formatting. By converting the value to a string before " +"calling :meth:`~object.__format__`, the normal formatting logic is bypassed." msgstr "" msgid "" -"Three conversion flags are currently supported: ``'!s'`` which calls :func:" -"`str` on the value, ``'!r'`` which calls :func:`repr` and ``'!a'`` which " -"calls :func:`ascii`." +"Three conversion flags are currently supported: ``'!s'`` which " +"calls :func:`str` on the value, ``'!r'`` which calls :func:`repr` and ``'!" +"a'`` which calls :func:`ascii`." msgstr "" msgid "Some examples::" @@ -335,9 +339,9 @@ msgstr "" msgid "" "\"Format specifications\" are used within replacement fields contained " -"within a format string to define how individual values are presented (see :" -"ref:`formatstrings`, :ref:`f-strings`, and :ref:`t-strings`). They can also " -"be passed directly to the built-in :func:`format` function. Each " +"within a format string to define how individual values are presented " +"(see :ref:`formatstrings`, :ref:`f-strings`, and :ref:`t-strings`). They can " +"also be passed directly to the built-in :func:`format` function. Each " "formattable type may define how the format specification is to be " "interpreted." msgstr "" @@ -398,9 +402,9 @@ msgstr "``'='``" msgid "" "Forces the padding to be placed after the sign (if any) but before the " "digits. This is used for printing fields in the form '+000000120'. This " -"alignment option is only valid for numeric types, excluding :class:" -"`complex`. It becomes the default for numbers when '0' immediately precedes " -"the field width." +"alignment option is only valid for numeric types, " +"excluding :class:`complex`. It becomes the default for numbers when '0' " +"immediately precedes the field width." msgstr "" msgid "``'^'``" @@ -521,7 +525,9 @@ msgid "" msgstr "" msgid "" -"For a locale aware separator, use the ``'n'`` presentation type instead." +"For a locale-aware separator, use the ``'n'`` :ref:`float presentation type " +"` or :ref:`integer presentation type ` " +"instead." msgstr "" msgid "Added the ``','`` option (see also :pep:`378`)." @@ -605,7 +611,10 @@ msgstr "``'n'``" msgid "" "Number. This is the same as ``'d'``, except that it uses the current locale " -"setting to insert the appropriate digit group separators." +"setting to insert the appropriate digit group separators. Note that the " +"default locale is not the system locale. Depending on your use case, you may " +"wish to set :const:`~locale.LC_NUMERIC` with :func:`locale.setlocale` before " +"using ``'n'``." msgstr "" msgid "The same as ``'d'``." @@ -619,8 +628,8 @@ msgid "" msgstr "" msgid "" -"The available presentation types for :class:`float` and :class:`~decimal." -"Decimal` values are:" +"The available presentation types for :class:`float` " +"and :class:`~decimal.Decimal` values are:" msgstr "" msgid "``'e'``" @@ -632,9 +641,9 @@ msgid "" "exponent. The coefficient has one digit before and ``p`` digits after the " "decimal point, for a total of ``p + 1`` significant digits. With no " "precision given, uses a precision of ``6`` digits after the decimal point " -"for :class:`float`, and shows all coefficient digits for :class:`~decimal." -"Decimal`. If ``p=0``, the decimal point is omitted unless the ``#`` option " -"is used." +"for :class:`float`, and shows all coefficient digits " +"for :class:`~decimal.Decimal`. If ``p=0``, the decimal point is omitted " +"unless the ``#`` option is used." msgstr "" msgid "" @@ -693,12 +702,12 @@ msgid "" msgstr "" msgid "" -"With no precision given, uses a precision of ``6`` significant digits for :" -"class:`float`. For :class:`~decimal.Decimal`, the coefficient of the result " -"is formed from the coefficient digits of the value; scientific notation is " -"used for values smaller than ``1e-6`` in absolute value and values where the " -"place value of the least significant digit is larger than 1, and fixed-point " -"notation is used otherwise." +"With no precision given, uses a precision of ``6`` significant digits " +"for :class:`float`. For :class:`~decimal.Decimal`, the coefficient of the " +"result is formed from the coefficient digits of the value; scientific " +"notation is used for values smaller than ``1e-6`` in absolute value and " +"values where the place value of the least significant digit is larger than " +"1, and fixed-point notation is used otherwise." msgstr "" msgid "" @@ -718,7 +727,9 @@ msgstr "" msgid "" "Number. This is the same as ``'g'``, except that it uses the current locale " "setting to insert the appropriate digit group separators for the integral " -"part of a number." +"part of a number. Note that the default locale is not the system locale. " +"Depending on your use case, you may wish to set :const:`~locale.LC_NUMERIC` " +"with :func:`locale.setlocale` before using ``'n'``." msgstr "" msgid "``'%'``" @@ -873,8 +884,8 @@ msgid "" "'+3.140000; -3.140000'\n" ">>> '{: f}; {: f}'.format(3.14, -3.14) # show a space for positive numbers\n" "' 3.140000; -3.140000'\n" -">>> '{:-f}; {:-f}'.format(3.14, -3.14) # show only the minus -- same as '{:" -"f}; {:f}'\n" +">>> '{:-f}; {:-f}'.format(3.14, -3.14) # show only the minus -- same as " +"'{:f}; {:f}'\n" "'3.140000; -3.140000'" msgstr "" @@ -969,24 +980,26 @@ msgstr "" msgid "" "The feature described here was introduced in Python 2.4; a simple templating " -"method based upon regular expressions. It predates :meth:`str.format`, :ref:" -"`formatted string literals `, and :ref:`template string literals " -"`." +"method based upon regular expressions. It " +"predates :meth:`str.format`, :ref:`formatted string literals `, " +"and :ref:`template string literals `." msgstr "" msgid "" "It is unrelated to template string literals (t-strings), which were " -"introduced in Python 3.14. These evaluate to :class:`string.templatelib." -"Template` objects, found in the :mod:`string.templatelib` module." +"introduced in Python 3.14. These evaluate " +"to :class:`string.templatelib.Template` objects, found in " +"the :mod:`string.templatelib` module." msgstr "" msgid "" -"Template strings provide simpler string substitutions as described in :pep:" -"`292`. A primary use case for template strings is for internationalization " -"(i18n) since in that context, the simpler syntax and functionality makes it " -"easier to translate than other built-in string formatting facilities in " -"Python. As an example of a library built on template strings for i18n, see " -"the `flufl.i18n `_ package." +"Template strings provide simpler string substitutions as described " +"in :pep:`292`. A primary use case for template strings is for " +"internationalization (i18n) since in that context, the simpler syntax and " +"functionality makes it easier to translate than other built-in string " +"formatting facilities in Python. As an example of a library built on " +"template strings for i18n, see the `flufl.i18n `_ package." msgstr "" msgid "" @@ -1013,8 +1026,8 @@ msgid "" msgstr "" msgid "" -"Any other appearance of ``$`` in the string will result in a :exc:" -"`ValueError` being raised." +"Any other appearance of ``$`` in the string will result in " +"a :exc:`ValueError` being raised." msgstr "" msgid "" @@ -1051,8 +1064,8 @@ msgid "" msgstr "" msgid "" -"Returns ``False`` if the template has invalid placeholders that will cause :" -"meth:`substitute` to raise :exc:`ValueError`." +"Returns ``False`` if the template has invalid placeholders that will " +"cause :meth:`substitute` to raise :exc:`ValueError`." msgstr "" msgid "" @@ -1099,10 +1112,10 @@ msgstr "" msgid "" "*delimiter* -- This is the literal string describing a placeholder " "introducing delimiter. The default value is ``$``. Note that this should " -"*not* be a regular expression, as the implementation will call :meth:`re." -"escape` on this string as needed. Note further that you cannot change the " -"delimiter after class creation (i.e. a different delimiter must be set in " -"the subclass's class namespace)." +"*not* be a regular expression, as the implementation will " +"call :meth:`re.escape` on this string as needed. Note further that you " +"cannot change the delimiter after class creation (i.e. a different delimiter " +"must be set in the subclass's class namespace)." msgstr "" msgid "" @@ -1141,9 +1154,9 @@ msgstr "" msgid "" "Alternatively, you can provide the entire regular expression pattern by " "overriding the class attribute *pattern*. If you do this, the value must be " -"a regular expression object with four named capturing groups. The capturing " -"groups correspond to the rules given above, along with the invalid " -"placeholder rule:" +"a regular expression pattern string, or a compiled regular expression " +"object, with four named capturing groups. The capturing groups correspond " +"to the rules given above, along with the invalid placeholder rule:" msgstr "" msgid "" @@ -1176,11 +1189,11 @@ msgstr "" msgid "" "Split the argument into words using :meth:`str.split`, capitalize each word " -"using :meth:`str.capitalize`, and join the capitalized words using :meth:" -"`str.join`. If the optional second argument *sep* is absent or ``None``, " -"runs of whitespace characters are replaced by a single space and leading and " -"trailing whitespace are removed, otherwise *sep* is used to split and join " -"the words." +"using :meth:`str.capitalize`, and join the capitalized words " +"using :meth:`str.join`. If the optional second argument *sep* is absent or " +"``None``, runs of whitespace characters are replaced by a single space and " +"leading and trailing whitespace are removed, otherwise *sep* is used to " +"split and join the words." msgstr "" msgid "{} (curly brackets)" diff --git a/library/string.templatelib.po b/library/string.templatelib.po index 216f29c7d2..67eb5d3288 100644 --- a/library/string.templatelib.po +++ b/library/string.templatelib.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-21 19:19+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -43,9 +43,10 @@ msgstr "" msgid "" "Template strings are a mechanism for custom string processing. They have the " -"full flexibility of Python's :ref:`f-strings`, but return a :class:" -"`Template` instance that gives access to the static and interpolated (in " -"curly brackets) parts of a string *before* they are combined." +"full flexibility of Python's :ref:`f-strings`, but return " +"a :class:`Template` instance that gives access to the static and " +"interpolated (in curly brackets) parts of a string *before* they are " +"combined." msgstr "" msgid "" @@ -70,10 +71,10 @@ msgid "" msgstr "" msgid "" -"The most common way to create a :class:`!Template` instance is to use the :" -"ref:`template string literal syntax `. This syntax is identical " -"to that of :ref:`f-strings `, except that it uses a ``t`` prefix " -"in place of an ``f``:" +"The most common way to create a :class:`!Template` instance is to use " +"the :ref:`template string literal syntax `. This syntax is " +"identical to that of :ref:`f-strings `, except that it uses a " +"``t`` prefix in place of an ``f``:" msgstr "" msgid "" @@ -120,8 +121,8 @@ msgstr "" msgid "" "The ``values`` tuple always has the same length as the ``interpolations`` " -"tuple. It is always equivalent to ``tuple(i.value for i in template." -"interpolations)``." +"tuple. It is always equivalent to ``tuple(i.value for i in " +"template.interpolations)``." msgstr "" msgid "Methods" @@ -146,8 +147,8 @@ msgid "" msgstr "" msgid "" -"Iterate over the template, yielding each non-empty string and :class:" -"`Interpolation` in the correct order:" +"Iterate over the template, yielding each non-empty string " +"and :class:`Interpolation` in the correct order:" msgstr "" msgid "Empty strings are **not** included in the iteration:" @@ -178,6 +179,10 @@ msgid "" "attributes with the :ref:`match statement `:" msgstr "" +msgid "" +"Interpolations are :ref:`generic ` over the types of their values." +msgstr "" + msgid "The evaluated value of the interpolation." msgstr "" diff --git a/library/stringprep.po b/library/stringprep.po index 970e58fcfd..86ca087375 100644 --- a/library/stringprep.po +++ b/library/stringprep.po @@ -58,11 +58,11 @@ msgstr "" msgid "" "As a result, these tables are exposed as functions, not as data structures. " -"There are two kinds of tables in the RFC: sets and mappings. For a set, :mod:" -"`stringprep` provides the \"characteristic function\", i.e. a function that " -"returns ``True`` if the parameter is part of the set. For mappings, it " -"provides the mapping function: given the key, it returns the associated " -"value. Below is a list of all functions available in the module." +"There are two kinds of tables in the RFC: sets and mappings. For a " +"set, :mod:`stringprep` provides the \"characteristic function\", i.e. a " +"function that returns ``True`` if the parameter is part of the set. For " +"mappings, it provides the mapping function: given the key, it returns the " +"associated value. Below is a list of all functions available in the module." msgstr "" msgid "" diff --git a/library/struct.po b/library/struct.po index f27254f037..55ff8e889a 100644 --- a/library/struct.po +++ b/library/struct.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2026 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-29 15:53+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2026\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -52,12 +52,12 @@ msgstr "" msgid "" "Several :mod:`!struct` functions (and methods of :class:`Struct`) take a " -"*buffer* argument. This refers to objects that implement the :ref:" -"`bufferobjects` and provide either a readable or read-writable buffer. The " -"most common types used for that purpose are :class:`bytes` and :class:" -"`bytearray`, but many other types that can be viewed as an array of bytes " -"implement the buffer protocol, so that they can be read/filled without " -"additional copying from a :class:`bytes` object." +"*buffer* argument. This refers to objects that implement " +"the :ref:`bufferobjects` and provide either a readable or read-writable " +"buffer. The most common types used for that purpose are :class:`bytes` " +"and :class:`bytearray`, but many other types that can be viewed as an array " +"of bytes implement the buffer protocol, so that they can be read/filled " +"without additional copying from a :class:`bytes` object." msgstr "" msgid "Functions and Exceptions" @@ -80,7 +80,8 @@ msgstr "" msgid "" "Pack the values *v1*, *v2*, ... according to the format string *format* and " "write the packed bytes into the writable buffer *buffer* starting at " -"position *offset*. Note that *offset* is a required argument." +"position *offset*. Note that *offset* is a required argument. A negative " +"*offset* counts from the end of *buffer*." msgstr "" msgid "" @@ -94,7 +95,8 @@ msgid "" "Unpack from *buffer* starting at position *offset*, according to the format " "string *format*. The result is a tuple even if it contains exactly one " "item. The buffer's size in bytes, starting at position *offset*, must be at " -"least the size required by the format, as reflected by :func:`calcsize`." +"least the size required by the format, as reflected by :func:`calcsize`. A " +"negative *offset* counts from the end of *buffer*." msgstr "" msgid "" @@ -209,8 +211,8 @@ msgstr "" msgid "" "Native byte order is big-endian or little-endian, depending on the host " "system. For example, Intel x86, AMD64 (x86-64), and Apple M1 are little-" -"endian; IBM z and many legacy architectures are big-endian. Use :data:`sys." -"byteorder` to check the endianness of your system." +"endian; IBM z and many legacy architectures are big-endian. " +"Use :data:`sys.byteorder` to check the endianness of your system." msgstr "" msgid "" @@ -219,8 +221,8 @@ msgid "" msgstr "" msgid "" -"Standard size depends only on the format character; see the table in the :" -"ref:`format-characters` section." +"Standard size depends only on the format character; see the table in " +"the :ref:`format-characters` section." msgstr "" msgid "" @@ -579,8 +581,8 @@ msgid "" "appropriate to make it fit. For unpacking, the resulting :class:`!bytes` " "object always has exactly the specified number of bytes. As a special case, " "``'0s'`` means a single, empty byte string (while ``'0c'`` means 0 " -"characters). When packing, arguments of types :class:`bytes` and :class:" -"`bytearray` are accepted." +"characters). When packing, arguments of types :class:`bytes` " +"and :class:`bytearray` are accepted." msgstr "" msgid "" @@ -606,8 +608,8 @@ msgstr "" msgid "" "When packing a value ``x`` using one of the integer formats (``'b'``, " "``'B'``, ``'h'``, ``'H'``, ``'i'``, ``'I'``, ``'l'``, ``'L'``, ``'q'``, " -"``'Q'``), if ``x`` is outside the valid range for that format then :exc:" -"`struct.error` is raised." +"``'Q'``), if ``x`` is outside the valid range for that format " +"then :exc:`struct.error` is raised." msgstr "" msgid "" @@ -884,8 +886,8 @@ msgstr "" msgid "" "Identical to the :func:`unpack_from` function, using the compiled format. " -"The buffer's size in bytes, starting at position *offset*, must be at least :" -"attr:`size`." +"The buffer's size in bytes, starting at position *offset*, must be at " +"least :attr:`size`." msgstr "" msgid "" diff --git a/library/subprocess.po b/library/subprocess.po index f7d46f0829..0e748a6992 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-25 14:38+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -84,33 +85,35 @@ msgid "" "the internal :class:`Popen` object is automatically created with *stdout* " "and *stderr* both set to :data:`~subprocess.PIPE`. The *stdout* and *stderr* " "arguments may not be supplied at the same time as *capture_output*. If you " -"wish to capture and combine both streams into one, set *stdout* to :data:" -"`~subprocess.PIPE` and *stderr* to :data:`~subprocess.STDOUT`, instead of " -"using *capture_output*." +"wish to capture and combine both streams into one, set *stdout* " +"to :data:`~subprocess.PIPE` and *stderr* to :data:`~subprocess.STDOUT`, " +"instead of using *capture_output*." msgstr "" msgid "" -"A *timeout* may be specified in seconds, it is internally passed on to :meth:" -"`Popen.communicate`. If the timeout expires, the child process will be " -"killed and waited for. The :exc:`TimeoutExpired` exception will be re-raised " -"after the child process has terminated. The initial process creation itself " -"cannot be interrupted on many platform APIs so you are not guaranteed to see " -"a timeout exception until at least after however long process creation takes." +"A *timeout* may be specified in seconds, it is internally passed on " +"to :meth:`Popen.communicate`. If the timeout expires, the child process will " +"be killed and waited for. The :exc:`TimeoutExpired` exception will be re-" +"raised after the child process has terminated. The initial process creation " +"itself cannot be interrupted on many platform APIs so you are not guaranteed " +"to see a timeout exception until at least after however long process " +"creation takes." msgstr "" msgid "" "The *input* argument is passed to :meth:`Popen.communicate` and thus to the " "subprocess's stdin. If used it must be a byte sequence, or a string if " "*encoding* or *errors* is specified or *text* is true. When used, the " -"internal :class:`Popen` object is automatically created with *stdin* set to :" -"data:`~subprocess.PIPE`, and the *stdin* argument may not be used as well." +"internal :class:`Popen` object is automatically created with *stdin* set " +"to :data:`~subprocess.PIPE`, and the *stdin* argument may not be used as " +"well." msgstr "" msgid "" -"If *check* is true, and the process exits with a non-zero exit code, a :exc:" -"`CalledProcessError` exception will be raised. Attributes of that exception " -"hold the arguments, the exit code, and stdout and stderr if they were " -"captured." +"If *check* is true, and the process exits with a non-zero exit code, " +"a :exc:`CalledProcessError` exception will be raised. Attributes of that " +"exception hold the arguments, the exit code, and stdout and stderr if they " +"were captured." msgstr "" msgid "" @@ -126,8 +129,8 @@ msgid "" "variables for the new process; these are used instead of the default " "behavior of inheriting the current process' environment. It is passed " "directly to :class:`Popen`. This mapping can be str to str on any platform " -"or bytes to bytes on POSIX platforms much like :data:`os.environ` or :data:" -"`os.environb`." +"or bytes to bytes on POSIX platforms much like :data:`os.environ` " +"or :data:`os.environb`." msgstr "" msgid "Examples::" @@ -159,8 +162,8 @@ msgstr "" msgid "" "Changed Windows shell search order for ``shell=True``. The current directory " "and ``%PATH%`` are replaced with ``%COMSPEC%`` and ``%SystemRoot%" -"\\System32\\cmd.exe``. As a result, dropping a malicious program named ``cmd." -"exe`` into a current directory no longer works." +"\\System32\\cmd.exe``. As a result, dropping a malicious program named " +"``cmd.exe`` into a current directory no longer works." msgstr "" msgid "" @@ -182,9 +185,9 @@ msgid "" msgstr "" msgid "" -"Captured stdout from the child process. A bytes sequence, or a string if :" -"func:`run` was called with an encoding, errors, or text=True. ``None`` if " -"stdout was not captured." +"Captured stdout from the child process. A bytes sequence, or a string " +"if :func:`run` was called with an encoding, errors, or text=True. ``None`` " +"if stdout was not captured." msgstr "" msgid "" @@ -193,9 +196,9 @@ msgid "" msgstr "" msgid "" -"Captured stderr from the child process. A bytes sequence, or a string if :" -"func:`run` was called with an encoding, errors, or text=True. ``None`` if " -"stderr was not captured." +"Captured stderr from the child process. A bytes sequence, or a string " +"if :func:`run` was called with an encoding, errors, or text=True. ``None`` " +"if stderr was not captured." msgstr "" msgid "If :attr:`returncode` is non-zero, raise a :exc:`CalledProcessError`." @@ -234,10 +237,11 @@ msgid "Timeout in seconds." msgstr "" msgid "" -"Output of the child process if it was captured by :func:`run` or :func:" -"`check_output`. Otherwise, ``None``. This is always :class:`bytes` when " -"any output was captured regardless of the ``text=True`` setting. It may " -"remain ``None`` instead of ``b''`` when no output was observed." +"Output of the child process if it was captured by :func:`run` " +"or :func:`check_output`. Otherwise, ``None``. This is " +"always :class:`bytes` when any output was captured regardless of the " +"``text=True`` setting. It may remain ``None`` instead of ``b''`` when no " +"output was observed." msgstr "" msgid "Alias for output, for symmetry with :attr:`stderr`." @@ -254,19 +258,19 @@ msgid "*stdout* and *stderr* attributes added" msgstr "" msgid "" -"Subclass of :exc:`SubprocessError`, raised when a process run by :func:" -"`check_call`, :func:`check_output`, or :func:`run` (with ``check=True``) " -"returns a non-zero exit status." +"Subclass of :exc:`SubprocessError`, raised when a process run " +"by :func:`check_call`, :func:`check_output`, or :func:`run` (with " +"``check=True``) returns a non-zero exit status." msgstr "" msgid "" -"Exit status of the child process. If the process exited due to a signal, " -"this will be the negative signal number." +"Exit status of the child process, an integer. If the process exited due to " +"a signal, this will be the negative signal number." msgstr "" msgid "" -"Output of the child process if it was captured by :func:`run` or :func:" -"`check_output`. Otherwise, ``None``." +"Output of the child process if it was captured by :func:`run` " +"or :func:`check_output`. Otherwise, ``None``." msgstr "" msgid "" @@ -300,10 +304,10 @@ msgid "" "descriptor (a positive integer), and an existing :term:`file object` with a " "valid file descriptor. With the default settings of ``None``, no " "redirection will occur. :data:`PIPE` indicates that a new pipe to the child " -"should be created. :data:`DEVNULL` indicates that the special file :data:" -"`os.devnull` will be used. Additionally, *stderr* can be :data:`STDOUT`, " -"which indicates that the stderr data from the child process should be " -"captured into the same file handle as for *stdout*." +"should be created. :data:`DEVNULL` indicates that the special " +"file :data:`os.devnull` will be used. Additionally, *stderr* can " +"be :data:`STDOUT`, which indicates that the stderr data from the child " +"process should be captured into the same file handle as for *stdout*." msgstr "" msgid "" @@ -333,9 +337,9 @@ msgid "Added the *text* parameter as an alias for *universal_newlines*." msgstr "" msgid "" -"The newlines attribute of the file objects :attr:`Popen.stdin`, :attr:`Popen." -"stdout` and :attr:`Popen.stderr` are not updated by the :meth:`Popen." -"communicate` method." +"The newlines attribute of the file " +"objects :attr:`Popen.stdin`, :attr:`Popen.stdout` and :attr:`Popen.stderr` " +"are not updated by the :meth:`Popen.communicate` method." msgstr "" msgid "" @@ -345,16 +349,17 @@ msgid "" "convenient access to other shell features such as shell pipes, filename " "wildcards, environment variable expansion, and expansion of ``~`` to a " "user's home directory. However, note that Python itself offers " -"implementations of many shell-like features (in particular, :mod:`glob`, :" -"mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`, :func:`os.path." -"expanduser`, and :mod:`shutil`)." +"implementations of many shell-like features (in " +"particular, :mod:`glob`, :mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`, :func:`os.path.expanduser`, " +"and :mod:`shutil`)." msgstr "" msgid "" -"When *universal_newlines* is ``True``, the class uses the encoding :func:" -"`locale.getpreferredencoding(False) ` instead " -"of ``locale.getpreferredencoding()``. See the :class:`io.TextIOWrapper` " -"class for more information on this change." +"When *universal_newlines* is ``True``, the class uses the " +"encoding :func:`locale.getpreferredencoding(False) " +"` instead of " +"``locale.getpreferredencoding()``. See the :class:`io.TextIOWrapper` class " +"for more information on this change." msgstr "" msgid "" @@ -377,15 +382,15 @@ msgid "" msgstr "" msgid "" -"Execute a child program in a new process. On POSIX, the class uses :meth:" -"`os.execvpe`-like behavior to execute the child program. On Windows, the " -"class uses the Windows ``CreateProcess()`` function. The arguments to :" -"class:`Popen` are as follows." +"Execute a child program in a new process. On POSIX, the class " +"uses :meth:`os.execvpe`-like behavior to execute the child program. On " +"Windows, the class uses the Windows ``CreateProcess()`` function. The " +"arguments to :class:`Popen` are as follows." msgstr "" msgid "" -"*args* should be a sequence of program arguments or else a single string or :" -"term:`path-like object`. By default, the program to execute is the first " +"*args* should be a sequence of program arguments or else a single string " +"or :term:`path-like object`. By default, the program to execute is the first " "item in *args* if *args* is a sequence. If *args* is a string, the " "interpretation is platform-dependent and described below. See the *shell* " "and *executable* arguments for additional differences from the default " @@ -483,8 +488,8 @@ msgid "" "when typed at the shell prompt. This includes, for example, quoting or " "backslash escaping filenames with spaces in them. If *args* is a sequence, " "the first item specifies the command string, and any additional items will " -"be treated as additional arguments to the shell itself. That is to say, :" -"class:`Popen` does the equivalent of::" +"be treated as additional arguments to the shell itself. That is to " +"say, :class:`Popen` does the equivalent of::" msgstr "" msgid "Popen(['/bin/sh', '-c', args[0], args[1], ...])" @@ -517,8 +522,8 @@ msgid "any other positive value means use a buffer of approximately that size" msgstr "" msgid "" -"negative bufsize (the default) means the system default of io." -"DEFAULT_BUFFER_SIZE will be used." +"negative bufsize (the default) means the system default of " +"io.DEFAULT_BUFFER_SIZE will be used." msgstr "" msgid "" @@ -556,10 +561,10 @@ msgid "" "descriptor (a positive integer), and an existing :term:`file object` with a " "valid file descriptor. With the default settings of ``None``, no " "redirection will occur. :data:`PIPE` indicates that a new pipe to the child " -"should be created. :data:`DEVNULL` indicates that the special file :data:" -"`os.devnull` will be used. Additionally, *stderr* can be :data:`STDOUT`, " -"which indicates that the stderr data from the applications should be " -"captured into the same file handle as for *stdout*." +"should be created. :data:`DEVNULL` indicates that the special " +"file :data:`os.devnull` will be used. Additionally, *stderr* can " +"be :data:`STDOUT`, which indicates that the stderr data from the " +"applications should be captured into the same file handle as for *stdout*." msgstr "" msgid "" @@ -595,8 +600,8 @@ msgstr "" msgid "" "On Windows, if *close_fds* is true then no handles will be inherited by the " -"child process unless explicitly passed in the ``handle_list`` element of :" -"attr:`STARTUPINFO.lpAttributeList`, or by standard handle redirection." +"child process unless explicitly passed in the ``handle_list`` element " +"of :attr:`STARTUPINFO.lpAttributeList`, or by standard handle redirection." msgstr "" msgid "" @@ -605,15 +610,15 @@ msgid "" msgstr "" msgid "" -"On Windows the default for *close_fds* was changed from :const:`False` to :" -"const:`True` when redirecting the standard handles. It's now possible to set " -"*close_fds* to :const:`True` when redirecting the standard handles." +"On Windows the default for *close_fds* was changed from :const:`False` " +"to :const:`True` when redirecting the standard handles. It's now possible to " +"set *close_fds* to :const:`True` when redirecting the standard handles." msgstr "" msgid "" "*pass_fds* is an optional sequence of file descriptors to keep open between " -"the parent and child. Providing any *pass_fds* forces *close_fds* to be :" -"const:`True`. (POSIX only)" +"the parent and child. Providing any *pass_fds* forces *close_fds* to " +"be :const:`True`. (POSIX only)" msgstr "" msgid "The *pass_fds* parameter was added." @@ -621,10 +626,10 @@ msgstr "" msgid "" "If *cwd* is not ``None``, the function changes the working directory to " -"*cwd* before executing the child. *cwd* can be a string, bytes or :term:" -"`path-like ` object. On POSIX, the function looks for " -"*executable* (or for the first item in *args*) relative to *cwd* if the " -"executable path is a relative path." +"*cwd* before executing the child. *cwd* can be a string, bytes " +"or :term:`path-like ` object. On POSIX, the function " +"looks for *executable* (or for the first item in *args*) relative to *cwd* " +"if the executable path is a relative path." msgstr "" msgid "*cwd* parameter accepts a :term:`path-like object` on POSIX." @@ -701,8 +706,8 @@ msgid "" "If *env* is not ``None``, it must be a mapping that defines the environment " "variables for the new process; these are used instead of the default " "behavior of inheriting the current process' environment. This mapping can be " -"str to str on any platform or bytes to bytes on POSIX platforms much like :" -"data:`os.environ` or :data:`os.environb`." +"str to str on any platform or bytes to bytes on POSIX platforms much " +"like :data:`os.environ` or :data:`os.environb`." msgstr "" msgid "" @@ -792,14 +797,14 @@ msgid "" msgstr "" msgid "" -"Popen and the other functions in this module that use it raise an :ref:" -"`auditing event ` ``subprocess.Popen`` with arguments " +"Popen and the other functions in this module that use it raise " +"an :ref:`auditing event ` ``subprocess.Popen`` with arguments " "``executable``, ``args``, ``cwd``, and ``env``. The value for ``args`` may " "be a single string or a list of strings, depending on platform." msgstr "" msgid "Added context manager support." -msgstr "" +msgstr "Dodano obsługę menedżer wparcie" msgid "" "Popen destructor now emits a :exc:`ResourceWarning` warning if the child " @@ -810,8 +815,8 @@ msgid "" "Popen can use :func:`os.posix_spawn` in some cases for better performance. " "On Windows Subsystem for Linux and QEMU User Emulation, Popen constructor " "using :func:`os.posix_spawn` no longer raise an exception on errors like " -"missing program, but the child process fails with a non-zero :attr:`~Popen." -"returncode`." +"missing program, but the child process fails with a non-" +"zero :attr:`~Popen.returncode`." msgstr "" msgid "Exceptions" @@ -825,11 +830,11 @@ msgstr "" msgid "" "The most common exception raised is :exc:`OSError`. This occurs, for " "example, when trying to execute a non-existent file. Applications should " -"prepare for :exc:`OSError` exceptions. Note that, when ``shell=True``, :exc:" -"`OSError` will be raised by the child only if the selected shell itself was " -"not found. To determine if the shell failed to find the requested " -"application, it is necessary to check the return code or output from the " -"subprocess." +"prepare for :exc:`OSError` exceptions. Note that, when " +"``shell=True``, :exc:`OSError` will be raised by the child only if the " +"selected shell itself was not found. To determine if the shell failed to " +"find the requested application, it is necessary to check the return code or " +"output from the subprocess." msgstr "" msgid "" @@ -838,14 +843,15 @@ msgid "" msgstr "" msgid "" -":func:`check_call` and :func:`check_output` will raise :exc:" -"`CalledProcessError` if the called process returns a non-zero return code." +":func:`check_call` and :func:`check_output` will " +"raise :exc:`CalledProcessError` if the called process returns a non-zero " +"return code." msgstr "" msgid "" -"All of the functions and methods that accept a *timeout* parameter, such as :" -"func:`run` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` if " -"the timeout expires before the process exits." +"All of the functions and methods that accept a *timeout* parameter, such " +"as :func:`run` and :meth:`Popen.communicate` will " +"raise :exc:`TimeoutExpired` if the timeout expires before the process exits." msgstr "" msgid "" @@ -876,8 +882,8 @@ msgid "" "this library. This could result in arguments being parsed according to shell " "rules, but without any escaping added by Python. If you are intentionally " "launching a batch file with arguments from untrusted sources, consider " -"passing ``shell=True`` to allow Python to escape special characters. See :gh:" -"`114539` for additional discussion." +"passing ``shell=True`` to allow Python to escape special characters. " +"See :gh:`114539` for additional discussion." msgstr "" msgid "Popen Objects" @@ -887,19 +893,19 @@ msgid "Instances of the :class:`Popen` class have the following methods:" msgstr "" msgid "" -"Check if child process has terminated. Set and return :attr:`~Popen." -"returncode` attribute. Otherwise, returns ``None``." +"Check if child process has terminated. Set and " +"return :attr:`~Popen.returncode` attribute. Otherwise, returns ``None``." msgstr "" msgid "" -"Wait for child process to terminate. Set and return :attr:`~Popen." -"returncode` attribute." +"Wait for child process to terminate. Set and " +"return :attr:`~Popen.returncode` attribute." msgstr "" msgid "" -"If the process does not terminate after *timeout* seconds, raise a :exc:" -"`TimeoutExpired` exception. It is safe to catch this exception and retry " -"the wait." +"If the process does not terminate after *timeout* seconds, raise " +"a :exc:`TimeoutExpired` exception. It is safe to catch this exception and " +"retry the wait." msgstr "" msgid "" @@ -912,8 +918,8 @@ msgstr "" msgid "" "When the ``timeout`` parameter is not ``None``, then (on POSIX) the function " "is implemented using a busy loop (non-blocking call and short sleeps). Use " -"the :mod:`asyncio` module for an asynchronous wait: see :class:`asyncio." -"create_subprocess_exec`." +"the :mod:`asyncio` module for an asynchronous wait: " +"see :class:`asyncio.create_subprocess_exec`." msgstr "" msgid "*timeout* was added." @@ -941,9 +947,9 @@ msgid "" msgstr "" msgid "" -"If the process does not terminate after *timeout* seconds, a :exc:" -"`TimeoutExpired` exception will be raised. Catching this exception and " -"retrying communication will not lose any output. Supplying *input* to a " +"If the process does not terminate after *timeout* seconds, " +"a :exc:`TimeoutExpired` exception will be raised. Catching this exception " +"and retrying communication will not lose any output. Supplying *input* to a " "subsequent post-timeout :meth:`communicate` call is in undefined behavior " "and may become an error in the future." msgstr "" @@ -1035,10 +1041,10 @@ msgid "" msgstr "" msgid "" -"Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write `, :attr:`.stdout.read ` or :attr:`.stderr.read ` to avoid deadlocks due to any of the other OS pipe buffers filling " -"up and blocking the child process." +"Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write " +"`, :attr:`.stdout.read ` or :attr:`.stderr.read " +"` to avoid deadlocks due to any of the other OS pipe buffers " +"filling up and blocking the child process." msgstr "" msgid "The process ID of the child process." @@ -1092,8 +1098,8 @@ msgstr "" msgid "" "si = subprocess.STARTUPINFO()\n" -"si.dwFlags = subprocess.STARTF_USESTDHANDLES | subprocess." -"STARTF_USESHOWWINDOW" +"si.dwFlags = subprocess.STARTF_USESTDHANDLES | " +"subprocess.STARTF_USESHOWWINDOW" msgstr "" msgid "" @@ -1123,14 +1129,14 @@ msgid "" msgstr "" msgid "" -":data:`SW_HIDE` is provided for this attribute. It is used when :class:" -"`Popen` is called with ``shell=True``." +":data:`SW_HIDE` is provided for this attribute. It is used " +"when :class:`Popen` is called with ``shell=True``." msgstr "" msgid "" "A dictionary of additional attributes for process creation as given in " -"``STARTUPINFOEX``, see `UpdateProcThreadAttribute `__." +"``STARTUPINFOEX``, see `UpdateProcThreadAttribute `__." msgstr "" msgid "Supported attributes:" @@ -1145,18 +1151,18 @@ msgid "" msgstr "" msgid "" -"The handles must be temporarily made inheritable by :func:`os." -"set_handle_inheritable` when passed to the :class:`Popen` constructor, else :" -"class:`OSError` will be raised with Windows error " +"The handles must be temporarily made inheritable " +"by :func:`os.set_handle_inheritable` when passed to the :class:`Popen` " +"constructor, else :class:`OSError` will be raised with Windows error " "``ERROR_INVALID_PARAMETER`` (87)." msgstr "" msgid "" "In a multithreaded process, use caution to avoid leaking handles that are " "marked inheritable when combining this feature with concurrent calls to " -"other process creation functions that inherit all handles such as :func:`os." -"system`. This also applies to standard handle redirection, which " -"temporarily creates inheritable handles." +"other process creation functions that inherit all handles such " +"as :func:`os.system`. This also applies to standard handle redirection, " +"which temporarily creates inheritable handles." msgstr "" msgid "Windows Constants" @@ -1184,9 +1190,9 @@ msgid "Hides the window. Another window will be activated." msgstr "" msgid "" -"Specifies that the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO." -"hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes contain additional " -"information." +"Specifies that " +"the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO.hStdOutput`, " +"and :attr:`STARTUPINFO.hStdError` attributes contain additional information." msgstr "" msgid "" @@ -1315,10 +1321,11 @@ msgstr "" msgid "" "Run command with arguments. Wait for command to complete. If the return " -"code was zero then return, otherwise raise :exc:`CalledProcessError`. The :" -"exc:`CalledProcessError` object will have the return code in the :attr:" -"`~CalledProcessError.returncode` attribute. If :func:`check_call` was unable " -"to start the process it will propagate the exception that was raised." +"code was zero then return, otherwise raise :exc:`CalledProcessError`. " +"The :exc:`CalledProcessError` object will have the return code in " +"the :attr:`~CalledProcessError.returncode` attribute. If :func:`check_call` " +"was unable to start the process it will propagate the exception that was " +"raised." msgstr "" msgid "run(..., check=True)" @@ -1328,10 +1335,10 @@ msgid "Run command with arguments and return its output." msgstr "" msgid "" -"If the return code was non-zero it raises a :exc:`CalledProcessError`. The :" -"exc:`CalledProcessError` object will have the return code in the :attr:" -"`~CalledProcessError.returncode` attribute and any output in the :attr:" -"`~CalledProcessError.output` attribute." +"If the return code was non-zero it raises a :exc:`CalledProcessError`. " +"The :exc:`CalledProcessError` object will have the return code in " +"the :attr:`~CalledProcessError.returncode` attribute and any output in " +"the :attr:`~CalledProcessError.output` attribute." msgstr "" msgid "This is equivalent to::" @@ -1343,10 +1350,10 @@ msgstr "" msgid "" "The arguments shown above are merely some common ones. The full function " "signature is largely the same as that of :func:`run` - most arguments are " -"passed directly through to that interface. One API deviation from :func:" -"`run` behavior exists: passing ``input=None`` will behave the same as " -"``input=b''`` (or ``input=''``, depending on other arguments) rather than " -"using the parent's standard input file handle." +"passed directly through to that interface. One API deviation " +"from :func:`run` behavior exists: passing ``input=None`` will behave the " +"same as ``input=b''`` (or ``input=''``, depending on other arguments) rather " +"than using the parent's standard input file handle." msgstr "" msgid "" @@ -1362,8 +1369,8 @@ msgid "" msgstr "" msgid "" -"To also capture standard error in the result, use ``stderr=subprocess." -"STDOUT``::" +"To also capture standard error in the result, use " +"``stderr=subprocess.STDOUT``::" msgstr "" msgid "" @@ -1390,15 +1397,15 @@ msgstr "" msgid "" "All \"a\" functions in this section fail (more or less) silently if the " -"executed program cannot be found; the \"b\" replacements raise :exc:" -"`OSError` instead." +"executed program cannot be found; the \"b\" replacements " +"raise :exc:`OSError` instead." msgstr "" msgid "" -"In addition, the replacements using :func:`check_output` will fail with a :" -"exc:`CalledProcessError` if the requested operation produces a non-zero " -"return code. The output is still available as the :attr:`~CalledProcessError." -"output` attribute of the raised exception." +"In addition, the replacements using :func:`check_output` will fail with " +"a :exc:`CalledProcessError` if the requested operation produces a non-zero " +"return code. The output is still available as " +"the :attr:`~CalledProcessError.output` attribute of the raised exception." msgstr "" msgid "" @@ -1460,14 +1467,14 @@ msgid "Calling the program through the shell is usually not required." msgstr "" msgid "" -"The :func:`call` return value is encoded differently to that of :func:`os." -"system`." +"The :func:`call` return value is encoded differently to that " +"of :func:`os.system`." msgstr "" msgid "" "The :func:`os.system` function ignores SIGINT and SIGQUIT signals while the " -"command is running, but the caller must do this separately when using the :" -"mod:`!subprocess` module." +"command is running, but the caller must do this separately when using " +"the :mod:`!subprocess` module." msgstr "" msgid "A more realistic example would look like this::" @@ -1477,8 +1484,8 @@ msgid "" "try:\n" " retcode = call(\"mycmd\" + \" myarg\", shell=True)\n" " if retcode < 0:\n" -" print(\"Child was terminated by signal\", -retcode, file=sys." -"stderr)\n" +" print(\"Child was terminated by signal\", -retcode, " +"file=sys.stderr)\n" " else:\n" " print(\"Child returned\", retcode, file=sys.stderr)\n" "except OSError as e:\n" @@ -1593,8 +1600,8 @@ msgstr "" msgid "" "The function now returns (exitcode, output) instead of (status, output) as " -"it did in Python 3.3.3 and earlier. exitcode has the same value as :attr:" -"`~Popen.returncode`." +"it did in Python 3.3.3 and earlier. exitcode has the same value " +"as :attr:`~Popen.returncode`." msgstr "" msgid "Return output (stdout and stderr) of executing *cmd* in a shell." @@ -1622,9 +1629,9 @@ msgid "Timeout Behavior" msgstr "" msgid "" -"When using the ``timeout`` parameter in functions like :func:`run`, :meth:" -"`Popen.wait`, or :meth:`Popen.communicate`, users should be aware of the " -"following behaviors:" +"When using the ``timeout`` parameter in functions " +"like :func:`run`, :meth:`Popen.wait`, or :meth:`Popen.communicate`, users " +"should be aware of the following behaviors:" msgstr "" msgid "" diff --git a/library/symtable.po b/library/symtable.po index 496f29acd6..fcd1b36a91 100644 --- a/library/symtable.po +++ b/library/symtable.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -88,8 +88,8 @@ msgid "A namespace table for a block. The constructor is not public." msgstr "" msgid "" -"Return the type of the symbol table. Possible values are members of the :" -"class:`SymbolTableType` enumeration." +"Return the type of the symbol table. Possible values are members of " +"the :class:`SymbolTableType` enumeration." msgstr "" msgid "" @@ -115,8 +115,8 @@ msgid "" "``'top'`` if the table is global (:meth:`get_type` returns ``'module'``). " "For type parameter scopes (which are used for generic classes, functions, " "and type aliases), it is the name of the underlying class, function, or type " -"alias. For type alias scopes, it is the name of the type alias. For :class:" -"`~typing.TypeVar` bound scopes, it is the name of the ``TypeVar``." +"alias. For type alias scopes, it is the name of the type alias. " +"For :class:`~typing.TypeVar` bound scopes, it is the name of the ``TypeVar``." msgstr "" msgid "Return the number of the first line in the block this table represents." @@ -134,8 +134,8 @@ msgid "" msgstr "" msgid "" -"Return a view object containing the names of symbols in the table. See the :" -"ref:`documentation of view objects `." +"Return a view object containing the names of symbols in the table. See " +"the :ref:`documentation of view objects `." msgstr "" msgid "Lookup *name* in the table and return a :class:`Symbol` instance." @@ -148,8 +148,8 @@ msgid "Return a list of the nested symbol tables." msgstr "" msgid "" -"A namespace for a function or method. This class inherits from :class:" -"`SymbolTable`." +"A namespace for a function or method. This class inherits " +"from :class:`SymbolTable`." msgstr "" msgid "Return a tuple containing names of parameters to this function." diff --git a/library/sys.monitoring.po b/library/sys.monitoring.po index d400e06ac8..bf816f347c 100644 --- a/library/sys.monitoring.po +++ b/library/sys.monitoring.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-03 14:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,9 +28,9 @@ msgstr "" msgid "" ":mod:`!sys.monitoring` is a namespace within the :mod:`sys` module, not an " -"independent module, and ``import sys.monitoring`` would fail with a :exc:" -"`ModuleNotFoundError`. Instead, simply ``import sys`` and then use ``sys." -"monitoring``." +"independent module, and ``import sys.monitoring`` would fail with " +"a :exc:`ModuleNotFoundError`. Instead, simply ``import sys`` and then use " +"``sys.monitoring``." msgstr "" msgid "" @@ -84,8 +84,14 @@ msgid "Unregister all events and callback functions associated with *tool_id*." msgstr "" msgid "" -"Should be called once a tool no longer requires *tool_id*. Will call :func:" -"`clear_tool_id` before releasing *tool_id*." +"Should be called once a tool no longer requires *tool_id*. Will " +"call :func:`clear_tool_id` before releasing *tool_id*." +msgstr "" + +msgid "" +"Now calls :func:`clear_tool_id` before releasing *tool_id*. Previously, it " +"would not disable global or local events associated with *tool_id*, nor " +"unregister any callback functions." msgstr "" msgid "" @@ -180,8 +186,8 @@ msgid "" msgstr "" msgid "" -"An exception is raised, except those that cause a :monitoring-event:" -"`STOP_ITERATION` event." +"An exception is raised, except those that cause a :monitoring-" +"event:`STOP_ITERATION` event." msgstr "" msgid "" @@ -267,9 +273,9 @@ msgid "``BRANCH``" msgstr "``BRANCH``" msgid "" -"The ``BRANCH`` event is deprecated in 3.14. Using :monitoring-event:" -"`BRANCH_LEFT` and :monitoring-event:`BRANCH_RIGHT` events will give much " -"better performance as they can be disabled independently." +"The ``BRANCH`` event is deprecated in 3.14. Using :monitoring-" +"event:`BRANCH_LEFT` and :monitoring-event:`BRANCH_RIGHT` events will give " +"much better performance as they can be disabled independently." msgstr "" msgid "Ancillary events" @@ -288,9 +294,9 @@ msgstr ":monitoring-event:`C_RETURN`" msgid "" "The :monitoring-event:`C_RETURN` and :monitoring-event:`C_RAISE` events are " -"controlled by the :monitoring-event:`CALL` event. :monitoring-event:" -"`C_RETURN` and :monitoring-event:`C_RAISE` events will only be seen if the " -"corresponding :monitoring-event:`CALL` event is being monitored." +"controlled by the :monitoring-event:`CALL` event. :monitoring-" +"event:`C_RETURN` and :monitoring-event:`C_RAISE` events will only be seen if " +"the corresponding :monitoring-event:`CALL` event is being monitored." msgstr "" msgid "Other events" @@ -320,8 +326,8 @@ msgid "The STOP_ITERATION event" msgstr "" msgid "" -":pep:`PEP 380 <380#use-of-stopiteration-to-return-values>` specifies that a :" -"exc:`StopIteration` exception is raised when returning a value from a " +":pep:`PEP 380 <380#use-of-stopiteration-to-return-values>` specifies that " +"a :exc:`StopIteration` exception is raised when returning a value from a " "generator or coroutine. However, this is a very inefficient way to return a " "value, so some Python implementations, notably CPython 3.12+, do not raise " "an exception unless it would be visible to other code." @@ -364,8 +370,8 @@ msgid "Returns the ``int`` representing all the active events." msgstr "" msgid "" -"Activates all events which are set in *event_set*. Raises a :exc:" -"`ValueError` if *tool_id* is not in use." +"Activates all events which are set in *event_set*. Raises " +"a :exc:`ValueError` if *tool_id* is not in use." msgstr "" msgid "No events are active by default." @@ -437,13 +443,13 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``sys.monitoring." -"register_callback`` with argument ``func``." +"Raises an :ref:`auditing event ` " +"``sys.monitoring.register_callback`` with argument ``func``." msgstr "" msgid "" -"Functions can be unregistered by calling ``sys.monitoring." -"register_callback(tool_id, event, None)``." +"Functions can be unregistered by calling " +"``sys.monitoring.register_callback(tool_id, event, None)``." msgstr "" msgid "Callback functions can be registered and unregistered at any time." @@ -484,8 +490,8 @@ msgid "func(code: CodeType, instruction_offset: int, retval: object) -> object" msgstr "" msgid "" -":monitoring-event:`CALL`, :monitoring-event:`C_RAISE` and :monitoring-event:" -"`C_RETURN` (*arg0* can be :data:`MISSING` specifically)::" +":monitoring-event:`CALL`, :monitoring-event:`C_RAISE` and :monitoring-" +"event:`C_RETURN` (*arg0* can be :data:`MISSING` specifically)::" msgstr "" msgid "" @@ -496,8 +502,8 @@ msgstr "" msgid "" "*code* represents the code object where the call is being made, while " "*callable* is the object that is about to be called (and thus triggered the " -"event). If there are no arguments, *arg0* is set to :data:`sys.monitoring." -"MISSING`." +"event). If there are no arguments, *arg0* is set " +"to :data:`sys.monitoring.MISSING`." msgstr "" msgid "" @@ -507,9 +513,9 @@ msgid "" msgstr "" msgid "" -":monitoring-event:`RAISE`, :monitoring-event:`RERAISE`, :monitoring-event:" -"`EXCEPTION_HANDLED`, :monitoring-event:`PY_UNWIND`, :monitoring-event:" -"`PY_THROW` and :monitoring-event:`STOP_ITERATION`::" +":monitoring-event:`RAISE`, :monitoring-event:`RERAISE`, :monitoring-" +"event:`EXCEPTION_HANDLED`, :monitoring-event:`PY_UNWIND`, :monitoring-" +"event:`PY_THROW` and :monitoring-event:`STOP_ITERATION`::" msgstr "" msgid "" @@ -524,8 +530,8 @@ msgid "func(code: CodeType, line_number: int) -> object" msgstr "" msgid "" -":monitoring-event:`BRANCH_LEFT`, :monitoring-event:`BRANCH_RIGHT` and :" -"monitoring-event:`JUMP`::" +":monitoring-event:`BRANCH_LEFT`, :monitoring-event:`BRANCH_RIGHT` " +"and :monitoring-event:`JUMP`::" msgstr "" msgid "" diff --git a/library/sys.po b/library/sys.po index e9c6d281bf..b3d8cebc10 100644 --- a/library/sys.po +++ b/library/sys.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -67,8 +67,8 @@ msgid "" "particular, malicious code can trivially disable or bypass hooks added using " "this function. At a minimum, any security-sensitive hooks must be added " "using the C API :c:func:`PySys_AddAuditHook` before initialising the " -"runtime, and any modules allowing arbitrary memory modification (such as :" -"mod:`ctypes`) should be completely removed or closely monitored." +"runtime, and any modules allowing arbitrary memory modification (such " +"as :mod:`ctypes`) should be completely removed or closely monitored." msgstr "" msgid "" @@ -142,8 +142,8 @@ msgid "" msgstr "" msgid "" -"Hooks are added using the :func:`sys.addaudithook` or :c:func:" -"`PySys_AddAuditHook` functions." +"Hooks are added using the :func:`sys.addaudithook` " +"or :c:func:`PySys_AddAuditHook` functions." msgstr "" msgid "" @@ -162,11 +162,11 @@ msgid "" msgstr "" msgid "" -"When running under :ref:`sys-path-init-virtual-environments`, :data:" -"`exec_prefix` gets overwritten to the virtual environment prefix. :data:" -"`base_exec_prefix`, conversely, does not change, and always points to the " -"base Python installation. Refer to :ref:`sys-path-init-virtual-environments` " -"for more information." +"When running under :ref:`sys-path-init-virtual-" +"environments`, :data:`exec_prefix` gets overwritten to the virtual " +"environment prefix. :data:`base_exec_prefix`, conversely, does not change, " +"and always points to the base Python installation. Refer to :ref:`sys-path-" +"init-virtual-environments` for more information." msgstr "" msgid "" @@ -203,9 +203,10 @@ msgid "" msgstr "" msgid "" -"Tracing is suspended while calling a tracing function set by :func:" -"`settrace` or :func:`setprofile` to avoid infinite recursion. :func:`!" -"call_tracing` enables explicit recursion of the tracing function." +"Tracing is suspended while calling a tracing function set " +"by :func:`settrace` or :func:`setprofile` to avoid infinite " +"recursion. :func:`!call_tracing` enables explicit recursion of the tracing " +"function." msgstr "" msgid "A string containing the copyright pertaining to the Python interpreter." @@ -285,27 +286,28 @@ msgid "" msgstr "" msgid "" -"The default implementation first consults the environment variable :envvar:" -"`PYTHONBREAKPOINT`. If that is set to ``\"0\"`` then this function returns " -"immediately; i.e. it is a no-op. If the environment variable is not set, or " -"is set to the empty string, ``pdb.set_trace()`` is called. Otherwise this " -"variable should name a function to run, using Python's dotted-import " -"nomenclature, e.g. ``package.subpackage.module.function``. In this case, " +"The default implementation first consults the environment " +"variable :envvar:`PYTHONBREAKPOINT`. If that is set to ``\"0\"`` then this " +"function returns immediately; i.e. it is a no-op. If the environment " +"variable is not set, or is set to the empty string, ``pdb.set_trace()`` is " +"called. Otherwise this variable should name a function to run, using " +"Python's dotted-import nomenclature, e.g. " +"``package.subpackage.module.function``. In this case, " "``package.subpackage.module`` would be imported and the resulting module " "must have a callable named ``function()``. This is run, passing in " -"``*args`` and ``**kws``, and whatever ``function()`` returns, ``sys." -"breakpointhook()`` returns to the built-in :func:`breakpoint` function." +"``*args`` and ``**kws``, and whatever ``function()`` returns, " +"``sys.breakpointhook()`` returns to the built-in :func:`breakpoint` function." msgstr "" msgid "" -"Note that if anything goes wrong while importing the callable named by :" -"envvar:`PYTHONBREAKPOINT`, a :exc:`RuntimeWarning` is reported and the " +"Note that if anything goes wrong while importing the callable named " +"by :envvar:`PYTHONBREAKPOINT`, a :exc:`RuntimeWarning` is reported and the " "breakpoint is ignored." msgstr "" msgid "" -"Also note that if ``sys.breakpointhook()`` is overridden programmatically, :" -"envvar:`PYTHONBREAKPOINT` is *not* consulted." +"Also note that if ``sys.breakpointhook()`` is overridden " +"programmatically, :envvar:`PYTHONBREAKPOINT` is *not* consulted." msgstr "" msgid "" @@ -328,18 +330,18 @@ msgid "Integer specifying the handle of the Python DLL." msgstr "" msgid "" -"If *value* is not ``None``, this function prints ``repr(value)`` to ``sys." -"stdout``, and saves *value* in ``builtins._``. If ``repr(value)`` is not " -"encodable to ``sys.stdout.encoding`` with ``sys.stdout.errors`` error " -"handler (which is probably ``'strict'``), encode it to ``sys.stdout." -"encoding`` with ``'backslashreplace'`` error handler." +"If *value* is not ``None``, this function prints ``repr(value)`` to " +"``sys.stdout``, and saves *value* in ``builtins._``. If ``repr(value)`` is " +"not encodable to ``sys.stdout.encoding`` with ``sys.stdout.errors`` error " +"handler (which is probably ``'strict'``), encode it to " +"``sys.stdout.encoding`` with ``'backslashreplace'`` error handler." msgstr "" msgid "" -"``sys.displayhook`` is called on the result of evaluating an :term:" -"`expression` entered in an interactive Python session. The display of these " -"values can be customized by assigning another one-argument function to ``sys." -"displayhook``." +"``sys.displayhook`` is called on the result of evaluating " +"an :term:`expression` entered in an interactive Python session. The display " +"of these values can be customized by assigning another one-argument function " +"to ``sys.displayhook``." msgstr "" msgid "Pseudo-code::" @@ -371,9 +373,9 @@ msgstr "" msgid "" "If this is true, Python won't try to write ``.pyc`` files on the import of " "source modules. This value is initially set to ``True`` or ``False`` " -"depending on the :option:`-B` command line option and the :envvar:" -"`PYTHONDONTWRITEBYTECODE` environment variable, but you can set it yourself " -"to control bytecode file generation." +"depending on the :option:`-B` command line option and " +"the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable, but you can set " +"it yourself to control bytecode file generation." msgstr "" msgid "" @@ -414,9 +416,9 @@ msgstr "" msgid "" "This value is initially set based on the value of the :option:`-X` " -"``pycache_prefix=PATH`` command-line option or the :envvar:" -"`PYTHONPYCACHEPREFIX` environment variable (command-line takes precedence). " -"If neither are set, it is ``None``." +"``pycache_prefix=PATH`` command-line option or " +"the :envvar:`PYTHONPYCACHEPREFIX` environment variable (command-line takes " +"precedence). If neither are set, it is ``None``." msgstr "" msgid "" @@ -438,14 +440,14 @@ msgid "" "``type``, ``value``, ``traceback`` when an uncaught exception occurs. If no " "hook has been set, ``hook`` may be ``None``. If any hook raises an exception " "derived from :class:`RuntimeError` the call to the hook will be suppressed. " -"Otherwise, the audit hook exception will be reported as unraisable and ``sys." -"excepthook`` will be called." +"Otherwise, the audit hook exception will be reported as unraisable and " +"``sys.excepthook`` will be called." msgstr "" msgid "" "The :func:`sys.unraisablehook` function handles unraisable exceptions and " -"the :func:`threading.excepthook` function handles exception raised by :func:" -"`threading.Thread.run`." +"the :func:`threading.excepthook` function handles exception raised " +"by :func:`threading.Thread.run`." msgstr "" msgid "" @@ -475,11 +477,11 @@ msgstr "" msgid "" "This function returns the old-style representation of the handled exception. " "If an exception ``e`` is currently handled (so :func:`exception` would " -"return ``e``), :func:`exc_info` returns the tuple ``(type(e), e, e." -"__traceback__)``. That is, a tuple containing the type of the exception (a " -"subclass of :exc:`BaseException`), the exception itself, and a :ref:" -"`traceback object ` which typically encapsulates the call " -"stack at the point where the exception last occurred." +"return ``e``), :func:`exc_info` returns the tuple ``(type(e), e, " +"e.__traceback__)``. That is, a tuple containing the type of the exception (a " +"subclass of :exc:`BaseException`), the exception itself, and " +"a :ref:`traceback object ` which typically encapsulates " +"the call stack at the point where the exception last occurred." msgstr "" msgid "" @@ -490,8 +492,8 @@ msgstr "" msgid "" "The ``type`` and ``traceback`` fields are now derived from the ``value`` " "(the exception instance), so when an exception is modified while it is being " -"handled, the changes are reflected in the results of subsequent calls to :" -"func:`exc_info`." +"handled, the changes are reflected in the results of subsequent calls " +"to :func:`exc_info`." msgstr "" msgid "" @@ -499,17 +501,18 @@ msgid "" "dependent Python files are installed; by default, this is also ``'/usr/" "local'``. This can be set at build time with the ``--exec-prefix`` argument " "to the :program:`configure` script. Specifically, all configuration files " -"(e.g. the :file:`pyconfig.h` header file) are installed in the directory :" -"file:`{exec_prefix}/lib/python{X.Y}/config`, and shared library modules are " -"installed in :file:`{exec_prefix}/lib/python{X.Y}/lib-dynload`, where *X.Y* " -"is the version number of Python, for example ``3.2``." +"(e.g. the :file:`pyconfig.h` header file) are installed in the " +"directory :file:`{exec_prefix}/lib/python{X.Y}/config`, and shared library " +"modules are installed in :file:`{exec_prefix}/lib/python{X.Y}/lib-dynload`, " +"where *X.Y* is the version number of Python, for example ``3.2``." msgstr "" msgid "" -"If a :ref:`virtual environment ` is in effect, this :data:" -"`exec_prefix` will point to the virtual environment. The value for the " -"Python installation will still be available, via :data:`base_exec_prefix`. " -"Refer to :ref:`sys-path-init-virtual-environments` for more information." +"If a :ref:`virtual environment ` is in effect, " +"this :data:`exec_prefix` will point to the virtual environment. The value " +"for the Python installation will still be available, " +"via :data:`base_exec_prefix`. Refer to :ref:`sys-path-init-virtual-" +"environments` for more information." msgstr "" msgid "" @@ -548,17 +551,17 @@ msgid "" msgstr "" msgid "" -"Since :func:`exit` ultimately \"only\" raises an exception, it will only " -"exit the process when called from the main thread, and the exception is not " -"intercepted. Cleanup actions specified by finally clauses of :keyword:`try` " -"statements are honored, and it is possible to intercept the exit attempt at " -"an outer level." +"Since :func:`~sys.exit` ultimately \"only\" raises an exception, it will " +"only exit the process when called from the main thread, and the exception is " +"not intercepted. Cleanup actions specified by finally clauses " +"of :keyword:`try` statements are honored, and it is possible to intercept " +"the exit attempt at an outer level." msgstr "" msgid "" -"If an error occurs in the cleanup after the Python interpreter has caught :" -"exc:`SystemExit` (such as an error flushing buffered data in the standard " -"streams), the exit status is changed to 120." +"If an error occurs in the cleanup after the Python interpreter has " +"caught :exc:`SystemExit` (such as an error flushing buffered data in the " +"standard streams), the exit status is changed to 120." msgstr "" msgid "" @@ -624,13 +627,13 @@ msgid ":option:`-X gil <-X>` and :envvar:`PYTHON_GIL`" msgstr "" msgid "" -":option:`-X thread_inherit_context <-X>` and :envvar:" -"`PYTHON_THREAD_INHERIT_CONTEXT`" +":option:`-X thread_inherit_context <-X>` " +"and :envvar:`PYTHON_THREAD_INHERIT_CONTEXT`" msgstr "" msgid "" -":option:`-X context_aware_warnings <-X>` and :envvar:" -"`PYTHON_CONTEXT_AWARE_WARNINGS`" +":option:`-X context_aware_warnings <-X>` " +"and :envvar:`PYTHON_CONTEXT_AWARE_WARNINGS`" msgstr "" msgid "Added ``quiet`` attribute for the new :option:`-q` flag." @@ -802,8 +805,8 @@ msgstr "" msgid "" "The attribute :attr:`sys.float_info.dig` needs further explanation. If " -"``s`` is any string representing a decimal number with at most :attr:`!sys." -"float_info.dig` significant digits, then converting ``s`` to a float and " +"``s`` is any string representing a decimal number with at most :attr:`!" +"sys.float_info.dig` significant digits, then converting ``s`` to a float and " "back again will recover a string representing the same decimal value::" msgstr "" @@ -840,9 +843,9 @@ msgid "" "Return the number of memory blocks currently allocated by the interpreter, " "regardless of their size. This function is mainly useful for tracking and " "debugging memory leaks. Because of the interpreter's internal caches, the " -"result can vary from call to call; you may have to call :func:" -"`_clear_internal_caches` and :func:`gc.collect` to get more predictable " -"results." +"result can vary from call to call; you may have to " +"call :func:`_clear_internal_caches` and :func:`gc.collect` to get more " +"predictable results." msgstr "" msgid "" @@ -874,8 +877,8 @@ msgid "" "Get the :term:`filesystem encoding `: " "the encoding used with the :term:`filesystem error handler ` to convert between Unicode filenames and bytes " -"filenames. The filesystem error handler is returned from :func:" -"`getfilesystemencodeerrors`." +"filenames. The filesystem error handler is returned " +"from :func:`getfilesystemencodeerrors`." msgstr "" msgid "" @@ -892,17 +895,17 @@ msgstr "" msgid "" "The :term:`filesystem encoding and error handler` are configured at Python " -"startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig." -"filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :" -"c:type:`PyConfig`." +"startup by the :c:func:`PyConfig_Read` function: " +"see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid ":func:`getfilesystemencoding` result cannot be ``None`` anymore." msgstr "" msgid "" -"Windows is no longer guaranteed to return ``'mbcs'``. See :pep:`529` and :" -"func:`_enablelegacywindowsfsencoding` for more information." +"Windows is no longer guaranteed to return ``'mbcs'``. See :pep:`529` " +"and :func:`_enablelegacywindowsfsencoding` for more information." msgstr "" msgid "" @@ -913,8 +916,8 @@ msgid "" "Get the :term:`filesystem error handler `: the error handler used with the :term:`filesystem encoding " "` to convert between Unicode " -"filenames and bytes filenames. The filesystem encoding is returned from :" -"func:`getfilesystemencoding`." +"filenames and bytes filenames. The filesystem encoding is returned " +"from :func:`getfilesystemencoding`." msgstr "" msgid "" @@ -930,10 +933,10 @@ msgstr "" msgid "" "Note that the returned value may not actually reflect how many references to " -"the object are actually held. For example, some objects are :term:" -"`immortal` and have a very high refcount that does not reflect the actual " -"number of references. Consequently, do not rely on the returned value to be " -"accurate, other than a value of 0 or 1." +"the object are actually held. For example, some objects " +"are :term:`immortal` and have a very high refcount that does not reflect the " +"actual number of references. Consequently, do not rely on the returned " +"value to be accurate, other than a value of 0 or 1." msgstr "" msgid "" @@ -949,8 +952,8 @@ msgstr "" msgid "" "Return the current value of the recursion limit, the maximum depth of the " "Python interpreter stack. This limit prevents infinite recursion from " -"causing an overflow of the C stack and crashing Python. It can be set by :" -"func:`setrecursionlimit`." +"causing an overflow of the C stack and crashing Python. It can be set " +"by :func:`setrecursionlimit`." msgstr "" msgid "" @@ -983,8 +986,8 @@ msgid "" msgstr "" msgid "" -"Return the interpreter's \"thread switch interval\" in seconds; see :func:" -"`setswitchinterval`." +"Return the interpreter's \"thread switch interval\" in seconds; " +"see :func:`setswitchinterval`." msgstr "" msgid "" @@ -1032,10 +1035,11 @@ msgstr "" msgid "" "Objects from the list are not safe to use. Specifically, the result will " "include objects from all interpreters that share their object allocator " -"state (that is, ones created with :c:member:`PyInterpreterConfig." -"use_main_obmalloc` set to 1 or using :c:func:`Py_NewInterpreter`, and the :" -"ref:`main interpreter `). Mixing objects from " -"different interpreters may lead to crashes or other unexpected behavior." +"state (that is, ones created " +"with :c:member:`PyInterpreterConfig.use_main_obmalloc` set to 1 or " +"using :c:func:`Py_NewInterpreter`, and the :ref:`main interpreter `). Mixing objects from different interpreters may lead " +"to crashes or other unexpected behavior." msgstr "" msgid "" @@ -1065,9 +1069,9 @@ msgid "" "*service_pack_minor*, *service_pack_major*, *suite_mask*, *product_type* and " "*platform_version*. *service_pack* contains a string, *platform_version* a 3-" "tuple and all other values are integers. The components can also be accessed " -"by name, so ``sys.getwindowsversion()[0]`` is equivalent to ``sys." -"getwindowsversion().major``. For compatibility with prior versions, only the " -"first 5 elements are retrievable by indexing." +"by name, so ``sys.getwindowsversion()[0]`` is equivalent to " +"``sys.getwindowsversion().major``. For compatibility with prior versions, " +"only the first 5 elements are retrievable by indexing." msgstr "" msgid "*platform* will be ``2`` (VER_PLATFORM_WIN32_NT)." @@ -1128,12 +1132,12 @@ msgid "Added *platform_version*" msgstr "" msgid "" -"Returns an *asyncgen_hooks* object, which is similar to a :class:" -"`~collections.namedtuple` of the form ``(firstiter, finalizer)``, where " -"*firstiter* and *finalizer* are expected to be either ``None`` or functions " -"which take an :term:`asynchronous generator iterator` as an argument, and " -"are used to schedule finalization of an asynchronous generator by an event " -"loop." +"Returns an *asyncgen_hooks* object, which is similar to " +"a :class:`~collections.namedtuple` of the form ``(firstiter, finalizer)``, " +"where *firstiter* and *finalizer* are expected to be either ``None`` or " +"functions which take an :term:`asynchronous generator iterator` as an " +"argument, and are used to schedule finalization of an asynchronous generator " +"by an event loop." msgstr "" msgid "See :pep:`525` for more details." @@ -1145,8 +1149,8 @@ msgid "" msgstr "" msgid "" -"Get the current coroutine origin tracking depth, as set by :func:" -"`set_coroutine_origin_tracking_depth`." +"Get the current coroutine origin tracking depth, as set " +"by :func:`set_coroutine_origin_tracking_depth`." msgstr "" msgid "" @@ -1239,8 +1243,8 @@ msgid "" msgstr "" msgid "" -"*hexversion* is the implementation version in hexadecimal format, like :data:" -"`sys.hexversion`." +"*hexversion* is the implementation version in hexadecimal format, " +"like :data:`sys.hexversion`." msgstr "" msgid "" @@ -1264,10 +1268,10 @@ msgstr "" msgid "" ":data:`sys.implementation` may contain additional attributes specific to the " "Python implementation. These non-standard attributes must start with an " -"underscore, and are not described here. Regardless of its contents, :data:" -"`sys.implementation` will not change during a run of the interpreter, nor " -"between implementation versions. (It may change between Python language " -"versions, however.) See :pep:`421` for more information." +"underscore, and are not described here. Regardless of its " +"contents, :data:`sys.implementation` will not change during a run of the " +"interpreter, nor between implementation versions. (It may change between " +"Python language versions, however.) See :pep:`421` for more information." msgstr "" msgid "Added ``supports_isolated_interpreters`` field." @@ -1297,13 +1301,14 @@ msgid "" msgstr "" msgid "" -"The minimum non-zero value for :func:`sys.set_int_max_str_digits`, :envvar:" -"`PYTHONINTMAXSTRDIGITS`, or :option:`-X int_max_str_digits <-X>`." +"The minimum non-zero value " +"for :func:`sys.set_int_max_str_digits`, :envvar:`PYTHONINTMAXSTRDIGITS`, " +"or :option:`-X int_max_str_digits <-X>`." msgstr "" msgid "" -"Added :attr:`~int_info.default_max_str_digits` and :attr:`~int_info." -"str_digits_check_threshold`." +"Added :attr:`~int_info.default_max_str_digits` " +"and :attr:`~int_info.str_digits_check_threshold`." msgstr "" msgid "" @@ -1355,8 +1360,8 @@ msgid "Utilities for observing just-in-time compilation." msgstr "" msgid "" -"JIT compilation is an *experimental implementation detail* of CPython. ``sys." -"_jit`` is not guaranteed to exist or behave the same way in all Python " +"JIT compilation is an *experimental implementation detail* of CPython. " +"``sys._jit`` is not guaranteed to exist or behave the same way in all Python " "implementations, versions, or build configurations." msgstr "" @@ -1370,9 +1375,9 @@ msgstr "" msgid "" "Return ``True`` if JIT compilation is enabled for the current Python process " "(implies :func:`sys._jit.is_available`), and ``False`` otherwise. If JIT " -"compilation is available, this can be controlled by setting the :envvar:" -"`PYTHON_JIT` environment variable to ``0`` (disabled) or ``1`` (enabled) at " -"interpreter startup." +"compilation is available, this can be controlled by setting " +"the :envvar:`PYTHON_JIT` environment variable to ``0`` (disabled) or ``1`` " +"(enabled) at interpreter startup." msgstr "" msgid "" @@ -1434,8 +1439,8 @@ msgstr "" msgid "" "These three variables are deprecated; use :data:`sys.last_exc` instead. They " -"hold the legacy representation of ``sys.last_exc``, as returned from :func:" -"`exc_info` above." +"hold the legacy representation of ``sys.last_exc``, as returned " +"from :func:`exc_info` above." msgstr "" msgid "" @@ -1456,23 +1461,24 @@ msgid "" msgstr "" msgid "" -"A list of :term:`meta path finder` objects that have their :meth:`~importlib." -"abc.MetaPathFinder.find_spec` methods called to see if one of the objects " -"can find the module to be imported. By default, it holds entries that " -"implement Python's default import semantics. The :meth:`~importlib.abc." -"MetaPathFinder.find_spec` method is called with at least the absolute name " -"of the module being imported. If the module to be imported is contained in a " -"package, then the parent package's :attr:`~module.__path__` attribute is " -"passed in as a second argument. The method returns a :term:`module spec`, or " -"``None`` if the module cannot be found." +"A list of :term:`meta path finder` objects that have " +"their :meth:`~importlib.abc.MetaPathFinder.find_spec` methods called to see " +"if one of the objects can find the module to be imported. By default, it " +"holds entries that implement Python's default import semantics. " +"The :meth:`~importlib.abc.MetaPathFinder.find_spec` method is called with at " +"least the absolute name of the module being imported. If the module to be " +"imported is contained in a package, then the parent " +"package's :attr:`~module.__path__` attribute is passed in as a second " +"argument. The method returns a :term:`module spec`, or ``None`` if the " +"module cannot be found." msgstr "" msgid ":class:`importlib.abc.MetaPathFinder`" msgstr ":class:`importlib.abc.MetaPathFinder`" msgid "" -"The abstract base class defining the interface of finder objects on :data:" -"`meta_path`." +"The abstract base class defining the interface of finder objects " +"on :data:`meta_path`." msgstr "" msgid ":class:`importlib.machinery.ModuleSpec`" @@ -1484,14 +1490,14 @@ msgid "" msgstr "" msgid "" -":term:`Module specs ` were introduced in Python 3.4, by :pep:" -"`451`." +":term:`Module specs ` were introduced in Python 3.4, " +"by :pep:`451`." msgstr "" msgid "" -"Removed the fallback that looked for a :meth:`!find_module` method if a :" -"data:`meta_path` entry didn't have a :meth:`~importlib.abc.MetaPathFinder." -"find_spec` method." +"Removed the fallback that looked for a :meth:`!find_module` method if " +"a :data:`meta_path` entry didn't have " +"a :meth:`~importlib.abc.MetaPathFinder.find_spec` method." msgstr "" msgid "" @@ -1555,14 +1561,14 @@ msgid "" msgstr "" msgid "" -"Module :mod:`site` This describes how to use .pth files to extend :data:`sys." -"path`." +"Module :mod:`site` This describes how to use .pth files to " +"extend :data:`sys.path`." msgstr "" msgid "" -"A list of callables that take a path argument to try to create a :term:" -"`finder` for the path. If a finder can be created, it is to be returned by " -"the callable, else raise :exc:`ImportError`." +"A list of callables that take a path argument to try to create " +"a :term:`finder` for the path. If a finder can be created, it is to be " +"returned by the callable, else raise :exc:`ImportError`." msgstr "" msgid "Originally specified in :pep:`302`." @@ -1694,8 +1700,8 @@ msgstr "" msgid "" "It is equal to ``\"lib\"`` on most platforms. On Fedora and SuSE, it is " -"equal to ``\"lib64\"`` on 64-bit platforms which gives the following ``sys." -"path`` paths (where ``X.Y`` is the Python ``major.minor`` version):" +"equal to ``\"lib64\"`` on 64-bit platforms which gives the following " +"``sys.path`` paths (where ``X.Y`` is the Python ``major.minor`` version):" msgstr "" msgid "" @@ -1710,8 +1716,8 @@ msgid "" msgstr "" msgid "" -"``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, not :data:`sys." -"platlibdir`): Third-party modules" +"``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, " +"not :data:`sys.platlibdir`): Third-party modules" msgstr "" msgid "" @@ -1749,14 +1755,14 @@ msgid "" "enable a lazy resolving of symbols when importing a module, if called as " "``sys.setdlopenflags(0)``. To share symbols across extension modules, call " "as ``sys.setdlopenflags(os.RTLD_GLOBAL)``. Symbolic names for the flag " -"values can be found in the :mod:`os` module (:samp:`RTLD_{xxx}` constants, e." -"g. :const:`os.RTLD_LAZY`)." +"values can be found in the :mod:`os` module (:samp:`RTLD_{xxx}` constants, " +"e.g. :const:`os.RTLD_LAZY`)." msgstr "" msgid "" "Set the :ref:`integer string conversion length limitation " -"` used by this interpreter. See also :func:" -"`get_int_max_str_digits`." +"` used by this interpreter. See " +"also :func:`get_int_max_str_digits`." msgstr "" msgid "" @@ -1774,9 +1780,9 @@ msgid "" msgstr "" msgid "" -"The same tracing mechanism is used for :func:`!setprofile` as :func:" -"`settrace`. To trace calls with :func:`!setprofile` inside a tracing " -"function (e.g. in a debugger breakpoint), see :func:`call_tracing`." +"The same tracing mechanism is used for :func:`!setprofile` " +"as :func:`settrace`. To trace calls with :func:`!setprofile` inside a " +"tracing function (e.g. in a debugger breakpoint), see :func:`call_tracing`." msgstr "" msgid "" @@ -1845,8 +1851,8 @@ msgid "" msgstr "" msgid "" -"If the new limit is too low at the current recursion depth, a :exc:" -"`RecursionError` exception is raised." +"If the new limit is too low at the current recursion depth, " +"a :exc:`RecursionError` exception is raised." msgstr "" msgid "" @@ -1868,8 +1874,8 @@ msgid "" "Set the system's trace function, which allows you to implement a Python " "source code debugger in Python. The function is thread-specific; for a " "debugger to support multiple threads, it must register a trace function " -"using :func:`settrace` for each thread being debugged or use :func:" -"`threading.settrace`." +"using :func:`settrace` for each thread being debugged or " +"use :func:`threading.settrace`." msgstr "" msgid "" @@ -1913,10 +1919,11 @@ msgstr "" msgid "" "The interpreter is about to execute a new line of code or re-execute the " "condition of a loop. The local trace function is called; *arg* is ``None``; " -"the return value specifies the new local trace function. See :file:`Objects/" -"lnotab_notes.txt` for a detailed explanation of how this works. Per-line " -"events may be disabled for a frame by setting :attr:`~frame.f_trace_lines` " -"to :const:`False` on that :ref:`frame `." +"the return value specifies the new local trace function. " +"See :source:`InternalDocs/code_objects.md` for a detailed explanation of how " +"this works. Per-line events may be disabled for a frame by " +"setting :attr:`~frame.f_trace_lines` to :const:`False` on that :ref:`frame " +"`." msgstr "" msgid "" @@ -1942,9 +1949,9 @@ msgid "" "The interpreter is about to execute a new opcode (see :mod:`dis` for opcode " "details). The local trace function is called; *arg* is ``None``; the return " "value specifies the new local trace function. Per-opcode events are not " -"emitted by default: they must be explicitly requested by setting :attr:" -"`~frame.f_trace_opcodes` to :const:`True` on the :ref:`frame `." +"emitted by default: they must be explicitly requested by " +"setting :attr:`~frame.f_trace_opcodes` to :const:`True` on the :ref:`frame " +"`." msgstr "" msgid "" @@ -1958,11 +1965,11 @@ msgid "" "it being set indirectly via the return value from an already installed trace " "function. This is also required for activating the trace function on the " "current frame, which :func:`settrace` doesn't do. Note that in order for " -"this to work, a global tracing function must have been installed with :func:" -"`settrace` in order to enable the runtime tracing machinery, but it doesn't " -"need to be the same tracing function (e.g. it could be a low overhead " -"tracing function that simply returns ``None`` to disable itself immediately " -"on each frame)." +"this to work, a global tracing function must have been installed " +"with :func:`settrace` in order to enable the runtime tracing machinery, but " +"it doesn't need to be the same tracing function (e.g. it could be a low " +"overhead tracing function that simply returns ``None`` to disable itself " +"immediately on each frame)." msgstr "" msgid "For more information on code and frame objects, refer to :ref:`types`." @@ -1981,26 +1988,26 @@ msgid "" msgstr "" msgid "" -"``'opcode'`` event type added; :attr:`~frame.f_trace_lines` and :attr:" -"`~frame.f_trace_opcodes` attributes added to frames" +"``'opcode'`` event type added; :attr:`~frame.f_trace_lines` " +"and :attr:`~frame.f_trace_opcodes` attributes added to frames" msgstr "" msgid "" -"Accepts two optional keyword arguments which are callables that accept an :" -"term:`asynchronous generator iterator` as an argument. The *firstiter* " +"Accepts two optional keyword arguments which are callables that accept " +"an :term:`asynchronous generator iterator` as an argument. The *firstiter* " "callable will be called when an asynchronous generator is iterated for the " "first time. The *finalizer* will be called when an asynchronous generator is " "about to be garbage collected." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_firstiter`` with no arguments." +"Raises an :ref:`auditing event ` " +"``sys.set_asyncgen_hooks_firstiter`` with no arguments." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_finalizer`` with no arguments." +"Raises an :ref:`auditing event ` " +"``sys.set_asyncgen_hooks_finalizer`` with no arguments." msgstr "" msgid "" @@ -2010,8 +2017,8 @@ msgstr "" msgid "" "See :pep:`525` for more details, and for a reference example of a " -"*finalizer* method see the implementation of ``asyncio.Loop." -"shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`" +"*finalizer* method see the implementation of " +"``asyncio.Loop.shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`" msgstr "" msgid "" @@ -2082,8 +2089,8 @@ msgstr "" msgid "" "When the code is executed in the remote process, an :ref:`auditing event " "` ``sys.remote_exec`` is raised with the *pid* and the path to the " -"script file. This event is raised in the process that called :func:`sys." -"remote_exec`." +"script file. This event is raised in the process that " +"called :func:`sys.remote_exec`." msgstr "" msgid "" @@ -2107,8 +2114,8 @@ msgid "" msgstr "" msgid "" -"See also :func:`sys.getfilesystemencoding` and :func:`sys." -"getfilesystemencodeerrors`." +"See also :func:`sys.getfilesystemencoding` " +"and :func:`sys.getfilesystemencodeerrors`." msgstr "" msgid "" @@ -2129,8 +2136,8 @@ msgid "" msgstr "" msgid "" -"``stdin`` is used for all interactive input (including calls to :func:" -"`input`);" +"``stdin`` is used for all interactive input (including calls " +"to :func:`input`);" msgstr "" msgid "" @@ -2147,8 +2154,9 @@ msgid "" msgstr "" msgid "" -"The encoding and error handling are is initialized from :c:member:`PyConfig." -"stdio_encoding` and :c:member:`PyConfig.stdio_errors`." +"The encoding and error handling are initialized " +"from :c:member:`PyConfig.stdio_encoding` " +"and :c:member:`PyConfig.stdio_errors`." msgstr "" msgid "" @@ -2168,19 +2176,20 @@ msgid "" msgstr "" msgid "" -"Under all platforms, you can override the character encoding by setting the :" -"envvar:`PYTHONIOENCODING` environment variable before starting Python or by " -"using the new :option:`-X` ``utf8`` command line option and :envvar:" -"`PYTHONUTF8` environment variable. However, for the Windows console, this " -"only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also set." +"Under all platforms, you can override the character encoding by setting " +"the :envvar:`PYTHONIOENCODING` environment variable before starting Python " +"or by using the new :option:`-X` ``utf8`` command line option " +"and :envvar:`PYTHONUTF8` environment variable. However, for the Windows " +"console, this only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also " +"set." msgstr "" msgid "" "When interactive, the ``stdout`` stream is line-buffered. Otherwise, it is " "block-buffered like regular text files. The ``stderr`` stream is line-" "buffered in both cases. You can make both streams unbuffered by passing " -"the :option:`-u` command-line option or setting the :envvar:" -"`PYTHONUNBUFFERED` environment variable." +"the :option:`-u` command-line option or setting " +"the :envvar:`PYTHONUNBUFFERED` environment variable." msgstr "" msgid "" @@ -2317,8 +2326,8 @@ msgstr "" msgid "" "The default hook formats :attr:`!err_msg` and :attr:`!object` as: " -"``f'{err_msg}: {object!r}'``; use \"Exception ignored in\" error message if :" -"attr:`!err_msg` is ``None``." +"``f'{err_msg}: {object!r}'``; use \"Exception ignored in\" error message " +"if :attr:`!err_msg` is ``None``." msgstr "" msgid "" @@ -2372,8 +2381,8 @@ msgid "" "*releaselevel* are integers; the release level is ``'alpha'``, ``'beta'``, " "``'candidate'``, or ``'final'``. The ``version_info`` value corresponding " "to the Python version 2.0 is ``(2, 0, 0, 'final', 0)``. The components can " -"also be accessed by name, so ``sys.version_info[0]`` is equivalent to ``sys." -"version_info.major`` and so on." +"also be accessed by name, so ``sys.version_info[0]`` is equivalent to " +"``sys.version_info.major`` and so on." msgstr "" msgid "Added named component attributes." diff --git a/library/sys_path_init.po b/library/sys_path_init.po index 1bbe5066e2..8153503d10 100644 --- a/library/sys_path_init.po +++ b/library/sys_path_init.po @@ -34,8 +34,8 @@ msgstr "" msgid "" "The first entry in the module search path is the directory that contains the " "input script, if there is one. Otherwise, the first entry is the current " -"directory, which is the case when executing the interactive shell, a :option:" -"`-c` command, or :option:`-m` module." +"directory, which is the case when executing the interactive shell, " +"a :option:`-c` command, or :option:`-m` module." msgstr "" msgid "" @@ -71,24 +71,24 @@ msgstr "" msgid "" "Once ``home`` is determined, the ``prefix`` directory is found by first " -"looking for :file:`python{majorversion}{minorversion}.zip` (``python311." -"zip``). On Windows the zip archive is searched for in ``home`` and on Unix " -"the archive is expected to be in :file:`lib`. Note that the expected zip " -"archive location is added to the module search path even if the archive does " -"not exist. If no archive was found, Python on Windows will continue the " -"search for ``prefix`` by looking for :file:`Lib\\\\os.py`. Python on Unix " -"will look for :file:`lib/python{majorversion}.{minorversion}/os.py` (``lib/" -"python3.11/os.py``). On Windows ``prefix`` and ``exec_prefix`` are the same, " -"however on other platforms :file:`lib/python{majorversion}.{minorversion}/" -"lib-dynload` (``lib/python3.11/lib-dynload``) is searched for and used as an " -"anchor for ``exec_prefix``. On some platforms :file:`lib` may be :file:" -"`lib64` or another value, see :data:`sys.platlibdir` and :envvar:" -"`PYTHONPLATLIBDIR`." +"looking for :file:`python{majorversion}{minorversion}.zip` " +"(``python311.zip``). On Windows the zip archive is searched for in ``home`` " +"and on Unix the archive is expected to be in :file:`lib`. Note that the " +"expected zip archive location is added to the module search path even if the " +"archive does not exist. If no archive was found, Python on Windows will " +"continue the search for ``prefix`` by looking for :file:`Lib\\\\os.py`. " +"Python on Unix will look for :file:`lib/python{majorversion}.{minorversion}/" +"os.py` (``lib/python3.11/os.py``). On Windows ``prefix`` and ``exec_prefix`` " +"are the same, however on other platforms :file:`lib/python{majorversion}." +"{minorversion}/lib-dynload` (``lib/python3.11/lib-dynload``) is searched for " +"and used as an anchor for ``exec_prefix``. On some platforms :file:`lib` may " +"be :file:`lib64` or another value, see :data:`sys.platlibdir` " +"and :envvar:`PYTHONPLATLIBDIR`." msgstr "" msgid "" -"Once found, ``prefix`` and ``exec_prefix`` are available at :data:`sys." -"prefix` and :data:`sys.exec_prefix` respectively." +"Once found, ``prefix`` and ``exec_prefix`` are available " +"at :data:`sys.prefix` and :data:`sys.exec_prefix` respectively." msgstr "" msgid "" @@ -99,8 +99,9 @@ msgid "" msgstr "" msgid "" -"Certain command line options may further affect path calculations. See :" -"option:`-E`, :option:`-I`, :option:`-s` and :option:`-S` for further details." +"Certain command line options may further affect path calculations. " +"See :option:`-E`, :option:`-I`, :option:`-s` and :option:`-S` for further " +"details." msgstr "" msgid "Virtual environments" @@ -153,11 +154,12 @@ msgid "Embedded Python" msgstr "" msgid "" -"If Python is embedded within another application :c:func:" -"`Py_InitializeFromConfig` and the :c:type:`PyConfig` structure can be used " -"to initialize Python. The path specific details are described at :ref:`init-" -"path-config`. Alternatively the older :c:func:`Py_SetPath` can be used to " -"bypass the initialization of the module search path." +"If Python is embedded within another " +"application :c:func:`Py_InitializeFromConfig` and the :c:type:`PyConfig` " +"structure can be used to initialize Python. The path specific details are " +"described at :ref:`init-path-config`. Alternatively the " +"older :c:func:`Py_SetPath` can be used to bypass the initialization of the " +"module search path." msgstr "" msgid ":ref:`windows_finding_modules` for detailed Windows notes." diff --git a/library/sysconfig.po b/library/sysconfig.po index cfc85076eb..73fea946dc 100644 --- a/library/sysconfig.po +++ b/library/sysconfig.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -93,9 +93,9 @@ msgstr "" msgid "" "Python uses an installation scheme that differs depending on the platform " "and on the installation options. These schemes are stored in :mod:`!" -"sysconfig` under unique identifiers based on the value returned by :const:" -"`os.name`. The schemes are used by package installers to determine where to " -"copy files to." +"sysconfig` under unique identifiers based on the value returned " +"by :const:`os.name`. The schemes are used by package installers to determine " +"where to copy files to." msgstr "" msgid "Python currently supports nine schemes:" @@ -113,8 +113,8 @@ msgstr "" msgid "" "*posix_user*: scheme for POSIX platforms, when the *user* option is used. " -"This scheme defines paths located under the user's home directory (:const:" -"`site.USER_BASE`)." +"This scheme defines paths located under the user's home directory " +"(:const:`site.USER_BASE`)." msgstr "" msgid "" @@ -194,8 +194,8 @@ msgstr "" msgid "" "Files will be installed into subdirectories of :const:`site.USER_BASE` " "(written as :file:`{userbase}` hereafter). This scheme installs pure Python " -"modules and extension modules in the same location (also known as :const:" -"`site.USER_SITE`)." +"modules and extension modules in the same location (also known " +"as :const:`site.USER_SITE`)." msgstr "" msgid "``posix_user``" @@ -274,8 +274,8 @@ msgid "" "The idea behind the \"home scheme\" is that you build and maintain a " "personal stash of Python modules. This scheme's name is derived from the " "idea of a \"home\" directory on Unix, since it's not unusual for a Unix user " -"to make their home directory have a layout similar to :file:`/usr/` or :file:" -"`/usr/local/`. This scheme can be used by anyone, regardless of the " +"to make their home directory have a layout similar to :file:`/usr/` " +"or :file:`/usr/local/`. This scheme can be used by anyone, regardless of the " "operating system they are installing for." msgstr "" @@ -414,8 +414,8 @@ msgid "" msgstr "" msgid "" -"End users should not use this function, but :func:`get_default_scheme` and :" -"func:`get_preferred_scheme` instead." +"End users should not use this function, but :func:`get_default_scheme` " +"and :func:`get_preferred_scheme` instead." msgstr "" msgid "" @@ -445,9 +445,9 @@ msgid "" msgstr "" msgid "" -"If *scheme* is provided, it must be a value from the list returned by :func:" -"`get_scheme_names`. Otherwise, the default scheme for the current platform " -"is used." +"If *scheme* is provided, it must be a value from the list returned " +"by :func:`get_scheme_names`. Otherwise, the default scheme for the current " +"platform is used." msgstr "" msgid "" @@ -482,8 +482,8 @@ msgid "If *expand* is set to false, the paths will not be expanded." msgstr "" msgid "" -"If *scheme* is not an existing scheme, :func:`get_paths` will raise a :exc:" -"`KeyError`." +"If *scheme* is not an existing scheme, :func:`get_paths` will raise " +"a :exc:`KeyError`." msgstr "" msgid "Other functions" @@ -595,9 +595,9 @@ msgid "" msgstr "" msgid "" -"This call will print in the standard output the information returned by :" -"func:`get_platform`, :func:`get_python_version`, :func:`get_path` and :func:" -"`get_config_vars`." +"This call will print in the standard output the information returned " +"by :func:`get_platform`, :func:`get_python_version`, :func:`get_path` " +"and :func:`get_config_vars`." msgstr "" msgid "configuration information" diff --git a/library/syslog.po b/library/syslog.po index 92f522842c..afeac19449 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -37,8 +37,9 @@ msgstr "Dostępność" msgid "" "This module wraps the system ``syslog`` family of routines. A pure Python " -"library that can speak to a syslog server is available in the :mod:`logging." -"handlers` module as :class:`~logging.handlers.SysLogHandler`." +"library that can speak to a syslog server is available in " +"the :mod:`logging.handlers` module " +"as :class:`~logging.handlers.SysLogHandler`." msgstr "" msgid "The module defines the following functions:" @@ -54,8 +55,8 @@ msgid "" msgstr "" msgid "" -"If :func:`openlog` has not been called prior to the call to :func:`syslog`, :" -"func:`openlog` will be called with no arguments." +"If :func:`openlog` has not been called prior to the call " +"to :func:`~syslog.syslog`, :func:`openlog` will be called with no arguments." msgstr "" msgid "" @@ -65,22 +66,22 @@ msgstr "" msgid "" "In previous versions, :func:`openlog` would not be called automatically if " -"it wasn't called prior to the call to :func:`syslog`, deferring to the " -"syslog implementation to call ``openlog()``." +"it wasn't called prior to the call to :func:`~syslog.syslog`, deferring to " +"the syslog implementation to call ``openlog()``." msgstr "" msgid "" "This function is restricted in subinterpreters. (Only code that runs in " "multiple interpreters is affected and the restriction is not relevant for " -"most users.) :func:`openlog` must be called in the main interpreter before :" -"func:`syslog` may be used in a subinterpreter. Otherwise it will raise :exc:" -"`RuntimeError`." +"most users.) :func:`openlog` must be called in the main interpreter " +"before :func:`~syslog.syslog` may be used in a subinterpreter. Otherwise it " +"will raise :exc:`RuntimeError`." msgstr "" msgid "" -"Logging options of subsequent :func:`syslog` calls can be set by calling :" -"func:`openlog`. :func:`syslog` will call :func:`openlog` with no arguments " -"if the log is not currently open." +"Logging options of subsequent :func:`~syslog.syslog` calls can be set by " +"calling :func:`openlog`. :func:`~syslog.syslog` will call :func:`openlog` " +"with no arguments if the log is not currently open." msgstr "" msgid "" @@ -105,8 +106,8 @@ msgstr "" msgid "" "This function is restricted in subinterpreters. (Only code that runs in " "multiple interpreters is affected and the restriction is not relevant for " -"most users.) This may only be called in the main interpreter. It will raise :" -"exc:`RuntimeError` if called in a subinterpreter." +"most users.) This may only be called in the main interpreter. It will " +"raise :exc:`RuntimeError` if called in a subinterpreter." msgstr "" msgid "" @@ -115,9 +116,9 @@ msgstr "" msgid "" "This causes the module to behave as it does when initially imported. For " -"example, :func:`openlog` will be called on the first :func:`syslog` call " -"(if :func:`openlog` hasn't already been called), and *ident* and other :func:" -"`openlog` parameters are reset to defaults." +"example, :func:`openlog` will be called on the first :func:`~syslog.syslog` " +"call (if :func:`openlog` hasn't already been called), and *ident* and " +"other :func:`openlog` parameters are reset to defaults." msgstr "" msgid "" @@ -127,8 +128,8 @@ msgstr "" msgid "" "Set the priority mask to *maskpri* and return the previous mask value. " -"Calls to :func:`syslog` with a priority level not set in *maskpri* are " -"ignored. The default is to log all priorities. The function " +"Calls to :func:`~syslog.syslog` with a priority level not set in *maskpri* " +"are ignored. The default is to log all priorities. The function " "``LOG_MASK(pri)`` calculates the mask for the individual priority *pri*. " "The function ``LOG_UPTO(pri)`` calculates the mask for all priorities up to " "and including *pri*." @@ -146,19 +147,19 @@ msgid "Priority levels (high to low)." msgstr "" msgid "" -"Facilities, depending on availability in ```` for :const:" -"`LOG_AUTHPRIV`, :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:" -"`LOG_REMOTEAUTH`, :const:`LOG_INSTALL` and :const:`LOG_RAS`." +"Facilities, depending on availability in ```` " +"for :const:`LOG_AUTHPRIV`, :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:`LOG_REMOTEAUTH`, :const:`LOG_INSTALL` " +"and :const:`LOG_RAS`." msgstr "" msgid "" -"Added :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:`LOG_REMOTEAUTH`, :" -"const:`LOG_INSTALL`, :const:`LOG_RAS`, and :const:`LOG_LAUNCHD`." +"Added :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:`LOG_REMOTEAUTH`, :const:`LOG_INSTALL`, :const:`LOG_RAS`, " +"and :const:`LOG_LAUNCHD`." msgstr "" msgid "" -"Log options, depending on availability in ```` for :const:" -"`LOG_ODELAY`, :const:`LOG_NOWAIT` and :const:`LOG_PERROR`." +"Log options, depending on availability in ```` " +"for :const:`LOG_ODELAY`, :const:`LOG_NOWAIT` and :const:`LOG_PERROR`." msgstr "" msgid "Examples" diff --git a/library/tabnanny.po b/library/tabnanny.po index 36872270e6..5973c11e11 100644 --- a/library/tabnanny.po +++ b/library/tabnanny.po @@ -65,8 +65,8 @@ msgid "" msgstr "" msgid "" -"This function is used by :func:`check` to process tokens generated by the :" -"mod:`tokenize` module." +"This function is used by :func:`check` to process tokens generated by " +"the :mod:`tokenize` module." msgstr "" msgid "Module :mod:`tokenize`" diff --git a/library/tarfile.po b/library/tarfile.po index e4b1cd137e..7a4ae94b8f 100644 --- a/library/tarfile.po +++ b/library/tarfile.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-23 18:56+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,15 +41,15 @@ msgid "Some facts and figures:" msgstr "" msgid "" -"reads and writes :mod:`gzip`, :mod:`bz2`, :mod:`compression.zstd`, and :mod:" -"`lzma` compressed archives if the respective modules are available." +"reads and writes :mod:`gzip`, :mod:`bz2`, :mod:`compression.zstd`, " +"and :mod:`lzma` compressed archives if the respective modules are available." msgstr "" msgid "" "If any of these :term:`optional modules ` are missing from " "your copy of CPython, look for documentation from your distributor (that is, " -"whoever provided Python to you). If you are the distributor, see :ref:" -"`optional-module-requirements`." +"whoever provided Python to you). If you are the distributor, " +"see :ref:`optional-module-requirements`." msgstr "" msgid "read/write support for the POSIX.1-1988 (ustar) format." @@ -145,8 +146,8 @@ msgid "``'x'`` or ``'x:'``" msgstr "``'x'`` or ``'x:'``" msgid "" -"Create a tarfile exclusively without compression. Raise a :exc:" -"`FileExistsError` exception if it already exists." +"Create a tarfile exclusively without compression. Raise " +"a :exc:`FileExistsError` exception if it already exists." msgstr "" msgid "``'x:gz'``" @@ -221,9 +222,9 @@ msgstr "" msgid "" "Note that ``'a:gz'``, ``'a:bz2'`` or ``'a:xz'`` is not possible. If *mode* " -"is not suitable to open a certain (compressed) file for reading, :exc:" -"`ReadError` is raised. Use *mode* ``'r'`` to avoid this. If a compression " -"method is not supported, :exc:`CompressionError` is raised." +"is not suitable to open a certain (compressed) file for " +"reading, :exc:`ReadError` is raised. Use *mode* ``'r'`` to avoid this. If a " +"compression method is not supported, :exc:`CompressionError` is raised." msgstr "" msgid "" @@ -247,27 +248,29 @@ msgid "" "For modes ``'w:zst'``, ``'x:zst'`` and ``'w|zst'``, :func:`tarfile.open` " "accepts the keyword argument *level* to specify the compression level of the " "file. The keyword argument *options* may also be passed, providing advanced " -"Zstandard compression parameters described by :class:`~compression.zstd." -"CompressionParameter`. The keyword argument *zstd_dict* can be passed to " -"provide a :class:`~compression.zstd.ZstdDict`, a Zstandard dictionary used " -"to improve compression of smaller amounts of data." +"Zstandard compression parameters described " +"by :class:`~compression.zstd.CompressionParameter`. The keyword argument " +"*zstd_dict* can be passed to provide a :class:`~compression.zstd.ZstdDict`, " +"a Zstandard dictionary used to improve compression of smaller amounts of " +"data." msgstr "" msgid "" "For special purposes, there is a second format for *mode*: ``'filemode|" "[compression]'``. :func:`tarfile.open` will return a :class:`TarFile` " "object that processes its data as a stream of blocks. No random seeking " -"will be done on the file. If given, *fileobj* may be any object that has a :" -"meth:`~io.RawIOBase.read` or :meth:`~io.RawIOBase.write` method (depending " -"on the *mode*) that works with bytes. *bufsize* specifies the blocksize and " -"defaults to ``20 * 512`` bytes. Use this variant in combination with e.g. " -"``sys.stdin.buffer``, a socket :term:`file object` or a tape device. " -"However, such a :class:`TarFile` object is limited in that it does not allow " -"random access, see :ref:`tar-examples`. The currently possible modes:" +"will be done on the file. If given, *fileobj* may be any object that has " +"a :meth:`~io.RawIOBase.read` or :meth:`~io.RawIOBase.write` method " +"(depending on the *mode*) that works with bytes. *bufsize* specifies the " +"blocksize and defaults to ``20 * 512`` bytes. Use this variant in " +"combination with e.g. ``sys.stdin.buffer``, a socket :term:`file object` or " +"a tape device. However, such a :class:`TarFile` object is limited in that it " +"does not allow random access, see :ref:`tar-examples`. The currently " +"possible modes:" msgstr "" msgid "Mode" -msgstr "" +msgstr "Tryb" msgid "Action" msgstr "" @@ -381,8 +384,8 @@ msgid "" msgstr "" msgid "" -"Is raised for the limitations that are typical for stream-like :class:" -"`TarFile` objects." +"Is raised for the limitations that are typical for stream-" +"like :class:`TarFile` objects." msgstr "" msgid "" @@ -398,8 +401,8 @@ msgid "" msgstr "" msgid "" -"Information about the member that the filter refused to extract, as :ref:" -"`TarInfo `." +"Information about the member that the filter refused to extract, " +"as :ref:`TarInfo `." msgstr "" msgid "Raised to refuse extracting a member with an absolute path." @@ -483,13 +486,13 @@ msgid "POSIX.1-2001 (pax) format." msgstr "" msgid "" -"The default format for creating archives. This is currently :const:" -"`PAX_FORMAT`." +"The default format for creating archives. This is " +"currently :const:`PAX_FORMAT`." msgstr "" msgid "" -"The default format for new archives was changed to :const:`PAX_FORMAT` from :" -"const:`GNU_FORMAT`." +"The default format for new archives was changed to :const:`PAX_FORMAT` " +"from :const:`GNU_FORMAT`." msgstr "" msgid "Module :mod:`zipfile`" @@ -521,16 +524,16 @@ msgid "" "The :class:`TarFile` object provides an interface to a tar archive. A tar " "archive is a sequence of blocks. An archive member (a stored file) is made " "up of a header block followed by data blocks. It is possible to store a file " -"in a tar archive several times. Each archive member is represented by a :" -"class:`TarInfo` object, see :ref:`tarinfo-objects` for details." +"in a tar archive several times. Each archive member is represented by " +"a :class:`TarInfo` object, see :ref:`tarinfo-objects` for details." msgstr "" msgid "" -"A :class:`TarFile` object can be used as a context manager in a :keyword:" -"`with` statement. It will automatically be closed when the block is " -"completed. Please note that in the event of an exception an archive opened " -"for writing will not be finalized; only the internally used file object will " -"be closed. See the :ref:`tar-examples` section for a use case." +"A :class:`TarFile` object can be used as a context manager in " +"a :keyword:`with` statement. It will automatically be closed when the block " +"is completed. Please note that in the event of an exception an archive " +"opened for writing will not be finalized; only the internally used file " +"object will be closed. See the :ref:`tar-examples` section for a use case." msgstr "" msgid "Added support for the context management protocol." @@ -601,8 +604,8 @@ msgstr "" msgid "" "The *encoding* and *errors* arguments define the character encoding to be " "used for reading or writing the archive and how conversion errors are going " -"to be handled. The default settings will work for most users. See section :" -"ref:`tar-unicode` for in-depth information." +"to be handled. The default settings will work for most users. See " +"section :ref:`tar-unicode` for in-depth information." msgstr "" msgid "" @@ -657,9 +660,9 @@ msgid "Added the *members* parameter." msgstr "" msgid "" -"Return the next member of the archive as a :class:`TarInfo` object, when :" -"class:`TarFile` is opened for reading. Return :const:`None` if there is no " -"more available." +"Return the next member of the archive as a :class:`TarInfo` object, " +"when :class:`TarFile` is opened for reading. Return :const:`None` if there " +"is no more available." msgstr "" msgid "" @@ -718,8 +721,8 @@ msgid "" msgstr "" msgid "" -"The *numeric_owner* and *filter* arguments are the same as for :meth:" -"`extractall`." +"The *numeric_owner* and *filter* arguments are the same as " +"for :meth:`extractall`." msgstr "" msgid "" @@ -752,12 +755,12 @@ msgid "" msgstr "" msgid "" -"If *errorlevel* is ``0``, errors are ignored when using :meth:`TarFile." -"extract` and :meth:`TarFile.extractall`. Nevertheless, they appear as error " -"messages in the debug output when *debug* is greater than 0. If ``1`` (the " -"default), all *fatal* errors are raised as :exc:`OSError` or :exc:" -"`FilterError` exceptions. If ``2``, all *non-fatal* errors are raised as :" -"exc:`TarError` exceptions as well." +"If *errorlevel* is ``0``, errors are ignored when " +"using :meth:`TarFile.extract` and :meth:`TarFile.extractall`. Nevertheless, " +"they appear as error messages in the debug output when *debug* is greater " +"than 0. If ``1`` (the default), all *fatal* errors are raised " +"as :exc:`OSError` or :exc:`FilterError` exceptions. If ``2``, all *non-" +"fatal* errors are raised as :exc:`TarError` exceptions as well." msgstr "" msgid "" @@ -766,9 +769,9 @@ msgid "" msgstr "" msgid "" -"Custom :ref:`extraction filters ` should raise :" -"exc:`FilterError` for *fatal* errors and :exc:`ExtractError` for *non-fatal* " -"ones." +"Custom :ref:`extraction filters ` should " +"raise :exc:`FilterError` for *fatal* errors and :exc:`ExtractError` for *non-" +"fatal* ones." msgstr "" msgid "" @@ -778,8 +781,8 @@ msgstr "" msgid "" "The :ref:`extraction filter ` used as a default " -"for the *filter* argument of :meth:`~TarFile.extract` and :meth:`~TarFile." -"extractall`." +"for the *filter* argument of :meth:`~TarFile.extract` " +"and :meth:`~TarFile.extractall`." msgstr "" msgid "" @@ -798,26 +801,26 @@ msgid "" "default, although, since it affects all uses of *tarfile*, it is best " "practice to only do so in top-level applications or :mod:`site configuration " "`. To set a global default this way, a filter function needs to be " -"wrapped in :func:`staticmethod` to prevent injection of a ``self`` argument." +"wrapped in :deco:`staticmethod` to prevent injection of a ``self`` argument." msgstr "" msgid "" "The default filter is set to :func:`data `, which disallows " "some dangerous features such as links to absolute paths or paths outside of " -"the destination. Previously, the default was equivalent to :func:" -"`fully_trusted `." +"the destination. Previously, the default was equivalent " +"to :func:`fully_trusted `." msgstr "" msgid "" "Add the file *name* to the archive. *name* may be any type of file " "(directory, fifo, symbolic link, etc.). If given, *arcname* specifies an " "alternative name for the file in the archive. Directories are added " -"recursively by default. This can be avoided by setting *recursive* to :const:" -"`False`. Recursion adds entries in sorted order. If *filter* is given, it " -"should be a function that takes a :class:`TarInfo` object argument and " -"returns the changed :class:`TarInfo` object. If it instead returns :const:" -"`None` the :class:`TarInfo` object will be excluded from the archive. See :" -"ref:`tar-examples` for an example." +"recursively by default. This can be avoided by setting *recursive* " +"to :const:`False`. Recursion adds entries in sorted order. If *filter* is " +"given, it should be a function that takes a :class:`TarInfo` object argument " +"and returns the changed :class:`TarInfo` object. If it instead " +"returns :const:`None` the :class:`TarInfo` object will be excluded from the " +"archive. See :ref:`tar-examples` for an example." msgstr "" msgid "Recursion adds entries in sorted order." @@ -825,10 +828,10 @@ msgstr "" msgid "" "Add the :class:`TarInfo` object *tarinfo* to the archive. If *tarinfo* " -"represents a non zero-size regular file, the *fileobj* argument should be a :" -"term:`binary file`, and ``tarinfo.size`` bytes are read from it and added to " -"the archive. You can create :class:`TarInfo` objects directly, or by using :" -"meth:`gettarinfo`." +"represents a non zero-size regular file, the *fileobj* argument should be " +"a :term:`binary file`, and ``tarinfo.size`` bytes are read from it and added " +"to the archive. You can create :class:`TarInfo` objects directly, or by " +"using :meth:`gettarinfo`." msgstr "" msgid "*fileobj* must be given for non-zero-sized regular files." @@ -847,10 +850,10 @@ msgstr "" msgid "" "You can modify some of the :class:`TarInfo`’s attributes before you add it " "using :meth:`addfile`. If the file object is not an ordinary file object " -"positioned at the beginning of the file, attributes such as :attr:`~TarInfo." -"size` may need modifying. This is the case for objects such as :class:" -"`~gzip.GzipFile`. The :attr:`~TarInfo.name` may also be modified, in which " -"case *arcname* could be a dummy string." +"positioned at the beginning of the file, attributes such " +"as :attr:`~TarInfo.size` may need modifying. This is the case for objects " +"such as :class:`~gzip.GzipFile`. The :attr:`~TarInfo.name` may also be " +"modified, in which case *arcname* could be a dummy string." msgstr "" msgid "" @@ -872,17 +875,17 @@ msgid "" msgstr "" msgid "" -":class:`TarInfo` objects are returned by :class:`TarFile`'s methods :meth:" -"`~TarFile.getmember`, :meth:`~TarFile.getmembers` and :meth:`~TarFile." -"gettarinfo`." +":class:`TarInfo` objects are returned by :class:`TarFile`'s " +"methods :meth:`~TarFile.getmember`, :meth:`~TarFile.getmembers` " +"and :meth:`~TarFile.gettarinfo`." msgstr "" msgid "" -"Modifying the objects returned by :meth:`~TarFile.getmember` or :meth:" -"`~TarFile.getmembers` will affect all subsequent operations on the archive. " -"For cases where this is unwanted, you can use :mod:`copy.copy() ` or " -"call the :meth:`~TarInfo.replace` method to create a modified copy in one " -"step." +"Modifying the objects returned by :meth:`~TarFile.getmember` " +"or :meth:`~TarFile.getmembers` will affect all subsequent operations on the " +"archive. For cases where this is unwanted, you can use :mod:`copy.copy() " +"` or call the :meth:`~TarInfo.replace` method to create a modified " +"copy in one step." msgstr "" msgid "" @@ -931,24 +934,24 @@ msgid "Size in bytes." msgstr "" msgid "" -"Time of last modification in seconds since the :ref:`epoch `, as in :" -"attr:`os.stat_result.st_mtime`." +"Time of last modification in seconds since the :ref:`epoch `, as " +"in :attr:`os.stat_result.st_mtime`." msgstr "" msgid "" -"Can be set to ``None`` for :meth:`~TarFile.extract` and :meth:`~TarFile." -"extractall`, causing extraction to skip applying this attribute." +"Can be set to ``None`` for :meth:`~TarFile.extract` " +"and :meth:`~TarFile.extractall`, causing extraction to skip applying this " +"attribute." msgstr "" msgid "Permission bits, as for :func:`os.chmod`." msgstr "" msgid "" -"File type. *type* is usually one of these constants: :const:`REGTYPE`, :" -"const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :" -"const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :" -"const:`GNUTYPE_SPARSE`. To determine the type of a :class:`TarInfo` object " -"more conveniently, use the ``is*()`` methods below." +"File type. *type* is usually one of these " +"constants: :const:`REGTYPE`, :const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :const:`GNUTYPE_SPARSE`. " +"To determine the type of a :class:`TarInfo` object more conveniently, use " +"the ``is*()`` methods below." msgstr "" msgid "" @@ -1006,8 +1009,8 @@ msgid "new_tarinfo = old_tarinfo.replace(gname='staff')" msgstr "" msgid "" -"By default, a deep copy is made. If *deep* is false, the copy is shallow, i." -"e. ``pax_headers`` and any custom attributes are shared with the original " +"By default, a deep copy is made. If *deep* is false, the copy is shallow, " +"i.e. ``pax_headers`` and any custom attributes are shared with the original " "``TarInfo`` object." msgstr "" @@ -1062,8 +1065,8 @@ msgstr "" msgid "" "None of the available filters blocks *all* dangerous archive features. Never " -"extract archives from untrusted sources without prior inspection. See also :" -"ref:`tarfile-further-verification`." +"extract archives from untrusted sources without prior inspection. See " +"also :ref:`tarfile-further-verification`." msgstr "" msgid ":pep:`706`" @@ -1073,8 +1076,8 @@ msgid "Contains further motivation and rationale behind the design." msgstr "" msgid "" -"The *filter* argument to :meth:`TarFile.extract` or :meth:`~TarFile." -"extractall` can be:" +"The *filter* argument to :meth:`TarFile.extract` " +"or :meth:`~TarFile.extractall` can be:" msgstr "" msgid "" @@ -1091,8 +1094,8 @@ msgstr "" msgid "" "the string ``'data'``: Ignore or block most features specific to UNIX-like " -"filesystems. Intended for extracting cross-platform data archives. See :func:" -"`data_filter` for details." +"filesystems. Intended for extracting cross-platform data archives. " +"See :func:`data_filter` for details." msgstr "" msgid "``None`` (default): Use :attr:`TarFile.extraction_filter`." @@ -1108,9 +1111,9 @@ msgid "" msgstr "" msgid "" -"A callable which will be called for each extracted member with a :ref:" -"`TarInfo ` describing the member and the destination path " -"to where the archive is extracted (i.e. the same path is used for all " +"A callable which will be called for each extracted member with " +"a :ref:`TarInfo ` describing the member and the destination " +"path to where the archive is extracted (i.e. the same path is used for all " "members)::" msgstr "" @@ -1131,10 +1134,10 @@ msgid "return ``None``, in which case the member will be skipped, or" msgstr "" msgid "" -"raise an exception to abort the operation or skip the member, depending on :" -"attr:`~TarFile.errorlevel`. Note that when extraction is aborted, :meth:" -"`~TarFile.extractall` may leave the archive partially extracted. It does not " -"attempt to clean up." +"raise an exception to abort the operation or skip the member, depending " +"on :attr:`~TarFile.errorlevel`. Note that when extraction is " +"aborted, :meth:`~TarFile.extractall` may leave the archive partially " +"extracted. It does not attempt to clean up." msgstr "" msgid "Default named filters" @@ -1163,6 +1166,13 @@ msgid "" "foo`` on Windows). This raises :class:`~tarfile.AbsolutePathError`." msgstr "" +msgid "" +"Normalize filenames (:attr:`TarInfo.name`) that contain ``..`` components " +"using :func:`os.path.normpath`. Note that this removes internal ``..`` " +"components, which may change the meaning of the name if it traverses " +"symbolic links." +msgstr "" + msgid "" ":ref:`Refuse ` to extract files whose absolute " "path (after following symlinks) would end up outside the destination. This " @@ -1170,22 +1180,32 @@ msgid "" msgstr "" msgid "" -"Clear high mode bits (setuid, setgid, sticky) and group/other write bits (:" -"const:`~stat.S_IWGRP` | :const:`~stat.S_IWOTH`)." +":ref:`Refuse ` to extract links (hard or soft) " +"whose name refers to the destination directory itself. This " +"raises :class:`~tarfile.OutsideDestinationError`. Note that such files are " +"refused even on platforms that do not support symbolic links." +msgstr "" + +msgid "" +"Clear high mode bits (setuid, setgid, sticky) and group/other write bits " +"(:const:`~stat.S_IWGRP` | :const:`~stat.S_IWOTH`)." msgstr "" msgid "Return the modified ``TarInfo`` member." msgstr "" +msgid "Filenames containing ``..`` components are now normalized." +msgstr "" + msgid "" "Implements the ``'data'`` filter. In addition to what ``tar_filter`` does:" msgstr "" msgid "" -"Normalize link targets (:attr:`TarInfo.linkname`) using :func:`os.path." -"normpath`. Note that this removes internal ``..`` components, which may " -"change the meaning of the link if the path in :attr:`!TarInfo.linkname` " -"traverses symbolic links." +"Normalize link targets (:attr:`TarInfo.linkname`) " +"using :func:`os.path.normpath`. Note that this removes internal ``..`` " +"components, which may change the meaning of the link if the path in :attr:`!" +"TarInfo.linkname` traverses symbolic links." msgstr "" msgid "" @@ -1194,8 +1214,8 @@ msgid "" msgstr "" msgid "" -"This raises :class:`~tarfile.AbsoluteLinkError` or :class:`~tarfile." -"LinkOutsideDestinationError`." +"This raises :class:`~tarfile.AbsoluteLinkError` " +"or :class:`~tarfile.LinkOutsideDestinationError`." msgstr "" msgid "" @@ -1212,13 +1232,14 @@ msgid "For regular files, including hard links:" msgstr "" msgid "" -"Set the owner read and write permissions (:const:`~stat.S_IRUSR` | :const:" -"`~stat.S_IWUSR`)." +"Set the owner read and write permissions (:const:`~stat.S_IRUSR` " +"| :const:`~stat.S_IWUSR`)." msgstr "" msgid "" -"Remove the group & other executable permission (:const:`~stat.S_IXGRP` | :" -"const:`~stat.S_IXOTH`) if the owner doesn’t have it (:const:`~stat.S_IXUSR`)." +"Remove the group & other executable permission (:const:`~stat.S_IXGRP` " +"| :const:`~stat.S_IXOTH`) if the owner doesn’t have it " +"(:const:`~stat.S_IXUSR`)." msgstr "" msgid "" @@ -1232,8 +1253,8 @@ msgid "" msgstr "" msgid "" -"Note that this filter does not block *all* dangerous archive features. See :" -"ref:`tarfile-further-verification` for details." +"Note that this filter does not block *all* dangerous archive features. " +"See :ref:`tarfile-further-verification` for details." msgstr "" msgid "Link targets are now normalized." @@ -1264,9 +1285,9 @@ msgid "Here is an incomplete list of things to consider:" msgstr "" msgid "" -"Extract to a :func:`new temporary directory ` to prevent e." -"g. exploiting pre-existing links, and to make it easier to clean up after a " -"failed extraction." +"Extract to a :func:`new temporary directory ` to prevent " +"e.g. exploiting pre-existing links, and to make it easier to clean up after " +"a failed extraction." msgstr "" msgid "Disallow symbolic links if you do not need the functionality." @@ -1414,8 +1435,9 @@ msgid "" msgstr "" msgid "" -"If you want to create a new tar archive, specify its name after the :option:" -"`-c` option and then list the filename(s) that should be included:" +"If you want to create a new tar archive, specify its name after " +"the :option:`-c` option and then list the filename(s) that should be " +"included:" msgstr "" msgid "$ python -m tarfile -c monty.tar spam.txt eggs.txt" @@ -1428,8 +1450,8 @@ msgid "$ python -m tarfile -c monty.tar life-of-brian_1979/" msgstr "$ python -m tarfile -c monty.tar life-of-brian_1979/" msgid "" -"If you want to extract a tar archive into the current directory, use the :" -"option:`-e` option:" +"If you want to extract a tar archive into the current directory, use " +"the :option:`-e` option:" msgstr "" msgid "$ python -m tarfile -e monty.tar" diff --git a/library/tempfile.po b/library/tempfile.po index 3458b8db98..edc2ab2b35 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,11 +31,12 @@ msgstr "**Kod źródłowy:** :source:`Lib/tempfile.py`" msgid "" "This module creates temporary files and directories. It works on all " -"supported platforms. :class:`TemporaryFile`, :class:`NamedTemporaryFile`, :" -"class:`TemporaryDirectory`, and :class:`SpooledTemporaryFile` are high-level " -"interfaces which provide automatic cleanup and can be used as :term:`context " -"managers `. :func:`mkstemp` and :func:`mkdtemp` are lower-" -"level functions which require manual cleanup." +"supported " +"platforms. :class:`TemporaryFile`, :class:`NamedTemporaryFile`, :class:`TemporaryDirectory`, " +"and :class:`SpooledTemporaryFile` are high-level interfaces which provide " +"automatic cleanup and can be used as :term:`context managers `. :func:`mkstemp` and :func:`mkdtemp` are lower-level functions " +"which require manual cleanup." msgstr "" msgid "" @@ -63,9 +64,9 @@ msgid "" msgstr "" msgid "" -"The resulting object can be used as a :term:`context manager` (see :ref:" -"`tempfile-examples`). On completion of the context or destruction of the " -"file object the temporary file will be removed from the filesystem." +"The resulting object can be used as a :term:`context manager` " +"(see :ref:`tempfile-examples`). On completion of the context or destruction " +"of the file object the temporary file will be removed from the filesystem." msgstr "" msgid "" @@ -175,10 +176,10 @@ msgstr "" msgid "" "*delete* is true but *delete_on_close* is false. Note, that in this case the " -"additional opens that do not share delete access (e.g. created via builtin :" -"func:`open`) must be closed before exiting the context manager, else the :" -"func:`os.unlink` call on context manager exit will fail with a :exc:" -"`PermissionError`." +"additional opens that do not share delete access (e.g. created via " +"builtin :func:`open`) must be closed before exiting the context manager, " +"else the :func:`os.unlink` call on context manager exit will fail with " +"a :exc:`PermissionError`." msgstr "" msgid "" @@ -202,8 +203,8 @@ msgid "" "This class operates exactly as :func:`TemporaryFile` does, except that data " "is spooled in memory until the file size exceeds *max_size*, or until the " "file's :func:`~io.IOBase.fileno` method is called, at which point the " -"contents are written to disk and operation proceeds as with :func:" -"`TemporaryFile`." +"contents are written to disk and operation proceeds as " +"with :func:`TemporaryFile`." msgstr "" msgid "" @@ -229,8 +230,8 @@ msgid "" msgstr "" msgid "" -"This class securely creates a temporary directory using the same rules as :" -"func:`mkdtemp`. The resulting object can be used as a :term:`context " +"This class securely creates a temporary directory using the same rules " +"as :func:`mkdtemp`. The resulting object can be used as a :term:`context " "manager` (see :ref:`tempfile-examples`). On completion of the context or " "destruction of the temporary directory object, the newly created temporary " "directory and all its contents are removed from the filesystem." @@ -262,6 +263,17 @@ msgid "" "based on other logic." msgstr "" +msgid "" +"Cleanup is not robust against the tree being modified while it is removed. " +"Files outside of the tree may have their permissions and file flags reset." +msgstr "" + +msgid "" +"On systems where :data:`shutil.rmtree.avoids_symlink_attacks` is false, " +"manipulating symbolic links during cleanup may cause files outside of the " +"tree to be removed." +msgstr "" + msgid "" "Raises an :ref:`auditing event ` ``tempfile.mkdtemp`` with " "argument ``fullpath``." @@ -289,7 +301,8 @@ msgstr "" msgid "" "Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for " -"deleting the temporary file when done with it." +"closing the file descriptor (for example, using :func:`os.close`) and " +"deleting the temporary file (for example, using :func:`os.remove`)." msgstr "" msgid "" @@ -301,8 +314,8 @@ msgstr "" msgid "" "If *prefix* is not ``None``, the file name will begin with that prefix; " -"otherwise, a default prefix is used. The default is the return value of :" -"func:`gettempprefix` or :func:`gettempprefixb`, as appropriate." +"otherwise, a default prefix is used. The default is the return value " +"of :func:`gettempprefix` or :func:`gettempprefixb`, as appropriate." msgstr "" msgid "" @@ -355,8 +368,8 @@ msgid "" msgstr "" msgid "" -"The *prefix*, *suffix*, and *dir* arguments are the same as for :func:" -"`mkstemp`." +"The *prefix*, *suffix*, and *dir* arguments are the same as " +"for :func:`mkstemp`." msgstr "" msgid ":func:`mkdtemp` returns the absolute pathname of the new directory." @@ -390,13 +403,14 @@ msgid "A platform-specific location:" msgstr "" msgid "" -"On Windows, the directories :file:`C:\\\\TEMP`, :file:`C:\\\\TMP`, :file:`\\" -"\\TEMP`, and :file:`\\\\TMP`, in that order." +"On Windows, the directories :file:`%USERPROFILE%\\\\AppData\\\\Local\\" +"\\Temp`, :file:`%SYSTEMROOT%\\\\Temp`, :file:`C:\\\\TEMP`, :file:`C:\\" +"\\TMP`, :file:`\\\\TEMP`, and :file:`\\\\TMP`, in that order." msgstr "" msgid "" -"On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, and :" -"file:`/usr/tmp`, in that order." +"On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, " +"and :file:`/usr/tmp`, in that order." msgstr "" msgid "As a last resort, the current working directory." @@ -446,11 +460,11 @@ msgstr "" msgid "" "Beware that if you set ``tempdir`` to a bytes value, there is a nasty side " -"effect: The global default return type of :func:`mkstemp` and :func:" -"`mkdtemp` changes to bytes when no explicit ``prefix``, ``suffix``, or " -"``dir`` arguments of type str are supplied. Please do not write code " -"expecting or depending on this. This awkward behavior is maintained for " -"compatibility with the historical implementation." +"effect: The global default return type of :func:`mkstemp` " +"and :func:`mkdtemp` changes to bytes when no explicit ``prefix``, " +"``suffix``, or ``dir`` arguments of type str are supplied. Please do not " +"write code expecting or depending on this. This awkward behavior is " +"maintained for compatibility with the historical implementation." msgstr "" msgid "Examples" diff --git a/library/termios.po b/library/termios.po index be62d61c6f..b116ff1213 100644 --- a/library/termios.po +++ b/library/termios.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-29 20:25+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,8 +38,9 @@ msgstr "Dostępność" msgid "" "All functions in this module take a file descriptor *fd* as their first " -"argument. This can be an integer file descriptor, such as returned by ``sys." -"stdin.fileno()``, or a :term:`file object`, such as ``sys.stdin`` itself." +"argument. This can be an integer file descriptor, such as returned by " +"``sys.stdin.fileno()``, or a :term:`file object`, such as ``sys.stdin`` " +"itself." msgstr "" msgid "" @@ -62,6 +63,12 @@ msgid "" "constants defined in the :mod:`!termios` module." msgstr "" +msgid "" +"Indices into the *cc* array controlling a non-canonical read: the minimum " +"number of characters to read and the timeout in tenths of a second, " +"respectively." +msgstr "" + msgid "" "Set the tty attributes for file descriptor *fd* from the *attributes*, which " "is a list like the one returned by :func:`tcgetattr`. The *when* argument " @@ -94,24 +101,44 @@ msgid "" "the output queue, or :const:`TCIOFLUSH` for both queues." msgstr "" +msgid "" +"Values for the *queue* selector: the input queue, the output queue, or both " +"queues, respectively." +msgstr "" + msgid "" "Suspend or resume input or output on file descriptor *fd*. The *action* " "argument can be :const:`TCOOFF` to suspend output, :const:`TCOON` to restart " "output, :const:`TCIOFF` to suspend input, or :const:`TCION` to restart input." msgstr "" +msgid "" +"Values for the *action* argument: suspend output, restart output, suspend " +"input, or restart input, respectively." +msgstr "" + msgid "" "Return a tuple ``(ws_row, ws_col)`` containing the tty window size for file " -"descriptor *fd*. Requires :const:`termios.TIOCGWINSZ` or :const:`termios." -"TIOCGSIZE`." +"descriptor *fd*. Requires :const:`termios.TIOCGWINSZ` " +"or :const:`termios.TIOCGSIZE`." +msgstr "" + +msgid "" +"``ioctl()`` requests for querying the tty window size. Not defined on all " +"platforms; :func:`tcgetwinsize` requires at least one of them." msgstr "" msgid "" "Set the tty window size for file descriptor *fd* from *winsize*, which is a " -"two-item tuple ``(ws_row, ws_col)`` like the one returned by :func:" -"`tcgetwinsize`. Requires at least one of the pairs (:const:`termios." -"TIOCGWINSZ`, :const:`termios.TIOCSWINSZ`); (:const:`termios.TIOCGSIZE`, :" -"const:`termios.TIOCSSIZE`) to be defined." +"two-item tuple ``(ws_row, ws_col)`` like the one returned " +"by :func:`tcgetwinsize`. Requires at least one of the pairs " +"(:const:`termios.TIOCGWINSZ`, :const:`termios.TIOCSWINSZ`); " +"(:const:`termios.TIOCGSIZE`, :const:`termios.TIOCSSIZE`) to be defined." +msgstr "" + +msgid "" +"``ioctl()`` requests for setting the tty window size. Not defined on all " +"platforms; see :func:`tcsetwinsize` for the required pairs." msgstr "" msgid "Module :mod:`tty`" @@ -125,9 +152,9 @@ msgstr "Przykład" msgid "" "Here's a function that prompts for a password with echoing turned off. Note " -"the technique using a separate :func:`tcgetattr` call and a :keyword:" -"`try` ... :keyword:`finally` statement to ensure that the old tty attributes " -"are restored exactly no matter what happens::" +"the technique using a separate :func:`tcgetattr` call and " +"a :keyword:`try` ... :keyword:`finally` statement to ensure that the old tty " +"attributes are restored exactly no matter what happens::" msgstr "" msgid "" diff --git a/library/test.po b/library/test.po index fe987144c3..6825112cba 100644 --- a/library/test.po +++ b/library/test.po @@ -1,1480 +1,6 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation -# This file is distributed under the same license as the Python package. -# FIRST AUTHOR , YEAR. -# -# Translators: -# Transifex Bot <>, 2023 -# -#, fuzzy +# msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" "Language: pl\n" -"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " -"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " -"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" - -msgid ":mod:`test` --- Regression tests package for Python" -msgstr "" - -msgid "" -"The :mod:`test` package is meant for internal use by Python only. It is " -"documented for the benefit of the core developers of Python. Any use of this " -"package outside of Python's standard library is discouraged as code " -"mentioned here can change or be removed without notice between releases of " -"Python." -msgstr "" - -msgid "" -"The :mod:`test` package contains all regression tests for Python as well as " -"the modules :mod:`test.support` and :mod:`test.regrtest`. :mod:`test." -"support` is used to enhance your tests while :mod:`test.regrtest` drives the " -"testing suite." -msgstr "" - -msgid "" -"Each module in the :mod:`test` package whose name starts with ``test_`` is a " -"testing suite for a specific module or feature. All new tests should be " -"written using the :mod:`unittest` or :mod:`doctest` module. Some older " -"tests are written using a \"traditional\" testing style that compares output " -"printed to ``sys.stdout``; this style of test is considered deprecated." -msgstr "" - -msgid "Module :mod:`unittest`" -msgstr "" - -msgid "Writing PyUnit regression tests." -msgstr "" - -msgid "Module :mod:`doctest`" -msgstr "" - -msgid "Tests embedded in documentation strings." -msgstr "" - -msgid "Writing Unit Tests for the :mod:`test` package" -msgstr "" - -msgid "" -"It is preferred that tests that use the :mod:`unittest` module follow a few " -"guidelines. One is to name the test module by starting it with ``test_`` and " -"end it with the name of the module being tested. The test methods in the " -"test module should start with ``test_`` and end with a description of what " -"the method is testing. This is needed so that the methods are recognized by " -"the test driver as test methods. Also, no documentation string for the " -"method should be included. A comment (such as ``# Tests function returns " -"only True or False``) should be used to provide documentation for test " -"methods. This is done because documentation strings get printed out if they " -"exist and thus what test is being run is not stated." -msgstr "" - -msgid "A basic boilerplate is often used::" -msgstr "" - -msgid "" -"This code pattern allows the testing suite to be run by :mod:`test." -"regrtest`, on its own as a script that supports the :mod:`unittest` CLI, or " -"via the ``python -m unittest`` CLI." -msgstr "" - -msgid "" -"The goal for regression testing is to try to break code. This leads to a few " -"guidelines to be followed:" -msgstr "" - -msgid "" -"The testing suite should exercise all classes, functions, and constants. " -"This includes not just the external API that is to be presented to the " -"outside world but also \"private\" code." -msgstr "" - -msgid "" -"Whitebox testing (examining the code being tested when the tests are being " -"written) is preferred. Blackbox testing (testing only the published user " -"interface) is not complete enough to make sure all boundary and edge cases " -"are tested." -msgstr "" - -msgid "" -"Make sure all possible values are tested including invalid ones. This makes " -"sure that not only all valid values are acceptable but also that improper " -"values are handled correctly." -msgstr "" - -msgid "" -"Exhaust as many code paths as possible. Test where branching occurs and thus " -"tailor input to make sure as many different paths through the code are taken." -msgstr "" - -msgid "" -"Add an explicit test for any bugs discovered for the tested code. This will " -"make sure that the error does not crop up again if the code is changed in " -"the future." -msgstr "" - -msgid "" -"Make sure to clean up after your tests (such as close and remove all " -"temporary files)." -msgstr "" - -msgid "" -"If a test is dependent on a specific condition of the operating system then " -"verify the condition already exists before attempting the test." -msgstr "" - -msgid "" -"Import as few modules as possible and do it as soon as possible. This " -"minimizes external dependencies of tests and also minimizes possible " -"anomalous behavior from side-effects of importing a module." -msgstr "" - -msgid "" -"Try to maximize code reuse. On occasion, tests will vary by something as " -"small as what type of input is used. Minimize code duplication by " -"subclassing a basic test class with a class that specifies the input::" -msgstr "" - -msgid "" -"When using this pattern, remember that all classes that inherit from :class:" -"`unittest.TestCase` are run as tests. The :class:`Mixin` class in the " -"example above does not have any data and so can't be run by itself, thus it " -"does not inherit from :class:`unittest.TestCase`." -msgstr "" - -msgid "Test Driven Development" -msgstr "" - -msgid "A book by Kent Beck on writing tests before code." -msgstr "" - -msgid "Running tests using the command-line interface" -msgstr "" - -msgid "" -"The :mod:`test` package can be run as a script to drive Python's regression " -"test suite, thanks to the :option:`-m` option: :program:`python -m test`. " -"Under the hood, it uses :mod:`test.regrtest`; the call :program:`python -m " -"test.regrtest` used in previous Python versions still works. Running the " -"script by itself automatically starts running all regression tests in the :" -"mod:`test` package. It does this by finding all modules in the package whose " -"name starts with ``test_``, importing them, and executing the function :func:" -"`test_main` if present or loading the tests via unittest.TestLoader." -"loadTestsFromModule if ``test_main`` does not exist. The names of tests to " -"execute may also be passed to the script. Specifying a single regression " -"test (:program:`python -m test test_spam`) will minimize output and only " -"print whether the test passed or failed." -msgstr "" - -msgid "" -"Running :mod:`test` directly allows what resources are available for tests " -"to use to be set. You do this by using the ``-u`` command-line option. " -"Specifying ``all`` as the value for the ``-u`` option enables all possible " -"resources: :program:`python -m test -uall`. If all but one resource is " -"desired (a more common case), a comma-separated list of resources that are " -"not desired may be listed after ``all``. The command :program:`python -m " -"test -uall,-audio,-largefile` will run :mod:`test` with all resources except " -"the ``audio`` and ``largefile`` resources. For a list of all resources and " -"more command-line options, run :program:`python -m test -h`." -msgstr "" - -msgid "" -"Some other ways to execute the regression tests depend on what platform the " -"tests are being executed on. On Unix, you can run :program:`make test` at " -"the top-level directory where Python was built. On Windows, executing :" -"program:`rt.bat` from your :file:`PCbuild` directory will run all regression " -"tests." -msgstr "" - -msgid ":mod:`test.support` --- Utilities for the Python test suite" -msgstr "" - -msgid "" -"The :mod:`test.support` module provides support for Python's regression test " -"suite." -msgstr "" - -msgid "" -":mod:`test.support` is not a public module. It is documented here to help " -"Python developers write tests. The API of this module is subject to change " -"without backwards compatibility concerns between releases." -msgstr "" - -msgid "This module defines the following exceptions:" -msgstr "" - -msgid "" -"Exception to be raised when a test fails. This is deprecated in favor of :" -"mod:`unittest`\\ -based tests and :class:`unittest.TestCase`'s assertion " -"methods." -msgstr "" - -msgid "" -"Subclass of :exc:`unittest.SkipTest`. Raised when a resource (such as a " -"network connection) is not available. Raised by the :func:`requires` " -"function." -msgstr "" - -msgid "The :mod:`test.support` module defines the following constants:" -msgstr "" - -msgid "" -"``True`` when verbose output is enabled. Should be checked when more " -"detailed information is desired about a running test. *verbose* is set by :" -"mod:`test.regrtest`." -msgstr "" - -msgid "``True`` if the running interpreter is Jython." -msgstr "" - -msgid "``True`` if the system is Android." -msgstr "" - -msgid "Path for shell if not on Windows; otherwise ``None``." -msgstr "" - -msgid "" -"Timeout in seconds for tests using a network server listening on the network " -"local loopback interface like ``127.0.0.1``." -msgstr "" - -msgid "" -"The timeout is long enough to prevent test failure: it takes into account " -"that the client and the server can run in different threads or even " -"different processes." -msgstr "" - -msgid "" -"The timeout should be long enough for :meth:`~socket.socket.connect`, :meth:" -"`~socket.socket.recv` and :meth:`~socket.socket.send` methods of :class:" -"`socket.socket`." -msgstr "" - -msgid "Its default value is 5 seconds." -msgstr "" - -msgid "See also :data:`INTERNET_TIMEOUT`." -msgstr "" - -msgid "Timeout in seconds for network requests going to the internet." -msgstr "" - -msgid "" -"The timeout is short enough to prevent a test to wait for too long if the " -"internet request is blocked for whatever reason." -msgstr "" - -msgid "" -"Usually, a timeout using :data:`INTERNET_TIMEOUT` should not mark a test as " -"failed, but skip the test instead: see :func:`~test.support.socket_helper." -"transient_internet`." -msgstr "" - -msgid "Its default value is 1 minute." -msgstr "" - -msgid "See also :data:`LOOPBACK_TIMEOUT`." -msgstr "" - -msgid "" -"Timeout in seconds to mark a test as failed if the test takes \"too long\"." -msgstr "" - -msgid "" -"The timeout value depends on the regrtest ``--timeout`` command line option." -msgstr "" - -msgid "" -"If a test using :data:`SHORT_TIMEOUT` starts to fail randomly on slow " -"buildbots, use :data:`LONG_TIMEOUT` instead." -msgstr "" - -msgid "Its default value is 30 seconds." -msgstr "" - -msgid "Timeout in seconds to detect when a test hangs." -msgstr "" - -msgid "" -"It is long enough to reduce the risk of test failure on the slowest Python " -"buildbots. It should not be used to mark a test as failed if the test takes " -"\"too long\". The timeout value depends on the regrtest ``--timeout`` " -"command line option." -msgstr "" - -msgid "Its default value is 5 minutes." -msgstr "" - -msgid "" -"See also :data:`LOOPBACK_TIMEOUT`, :data:`INTERNET_TIMEOUT` and :data:" -"`SHORT_TIMEOUT`." -msgstr "" - -msgid "Set when tests can be skipped when they are not useful for PGO." -msgstr "" - -msgid "" -"A constant that is likely larger than the underlying OS pipe buffer size, to " -"make writes blocking." -msgstr "" - -msgid "" -"A constant that is likely larger than the underlying OS socket buffer size, " -"to make writes blocking." -msgstr "" - -msgid "Set to the top level directory that contains :mod:`test.support`." -msgstr "" - -msgid "Set to the top level directory for the test package." -msgstr "" - -msgid "Set to the ``data`` directory within the test package." -msgstr "" - -msgid "Set to :data:`sys.maxsize` for big memory tests." -msgstr "" - -msgid "" -"Set by :func:`set_memlimit` as the memory limit for big memory tests. " -"Limited by :data:`MAX_Py_ssize_t`." -msgstr "" - -msgid "" -"Set by :func:`set_memlimit` as the memory limit for big memory tests. Not " -"limited by :data:`MAX_Py_ssize_t`." -msgstr "" - -msgid "" -"Set to ``True`` if Python is built without docstrings (the :c:macro:" -"`WITH_DOC_STRINGS` macro is not defined). See the :option:`configure --" -"without-doc-strings <--without-doc-strings>` option." -msgstr "" - -msgid "See also the :data:`HAVE_DOCSTRINGS` variable." -msgstr "" - -msgid "" -"Set to ``True`` if function docstrings are available. See the :option:" -"`python -OO <-O>` option, which strips docstrings of functions implemented " -"in Python." -msgstr "" - -msgid "See also the :data:`MISSING_C_DOCSTRINGS` variable." -msgstr "" - -msgid "Define the URL of a dedicated HTTP server for the network tests." -msgstr "" - -msgid "Object that is equal to anything. Used to test mixed type comparison." -msgstr "" - -msgid "" -"Object that is not equal to anything (even to :data:`ALWAYS_EQ`). Used to " -"test mixed type comparison." -msgstr "" - -msgid "" -"Object that is greater than anything (except itself). Used to test mixed " -"type comparison." -msgstr "" - -msgid "" -"Object that is less than anything (except itself). Used to test mixed type " -"comparison." -msgstr "" - -msgid "The :mod:`test.support` module defines the following functions:" -msgstr "" - -msgid "" -"Return ``True`` if *resource* is enabled and available. The list of " -"available resources is only set when :mod:`test.regrtest` is executing the " -"tests." -msgstr "" - -msgid "Return ``True`` if Python was not built with ``-O0`` or ``-Og``." -msgstr "" - -msgid "Return :data:`_testcapi.WITH_PYMALLOC`." -msgstr "" - -msgid "" -"Raise :exc:`ResourceDenied` if *resource* is not available. *msg* is the " -"argument to :exc:`ResourceDenied` if it is raised. Always returns ``True`` " -"if called by a function whose ``__name__`` is ``'__main__'``. Used when " -"tests are executed by :mod:`test.regrtest`." -msgstr "" - -msgid "Return a repr of *dict* with keys sorted." -msgstr "" - -msgid "" -"Return the path to the file named *filename*. If no match is found " -"*filename* is returned. This does not equal a failure since it could be the " -"path to the file." -msgstr "" - -msgid "" -"Setting *subdir* indicates a relative path to use to find the file rather " -"than looking directly in the path directories." -msgstr "" - -msgid "" -"Determine whether *test* matches the patterns set in :func:`set_match_tests`." -msgstr "" - -msgid "" -"Define match patterns on test filenames and test method names for filtering " -"tests." -msgstr "" - -msgid "" -"Execute :class:`unittest.TestCase` subclasses passed to the function. The " -"function scans the classes for methods starting with the prefix ``test_`` " -"and executes the tests individually." -msgstr "" - -msgid "" -"It is also legal to pass strings as parameters; these should be keys in " -"``sys.modules``. Each associated module will be scanned by ``unittest." -"TestLoader.loadTestsFromModule()``. This is usually seen in the following :" -"func:`test_main` function::" -msgstr "" - -msgid "This will run all tests defined in the named module." -msgstr "" - -msgid "" -"Run :func:`doctest.testmod` on the given *module*. Return ``(failure_count, " -"test_count)``." -msgstr "" - -msgid "" -"If *verbosity* is ``None``, :func:`doctest.testmod` is run with verbosity " -"set to :data:`verbose`. Otherwise, it is run with verbosity set to " -"``None``. *optionflags* is passed as ``optionflags`` to :func:`doctest." -"testmod`." -msgstr "" - -msgid "" -"Set the :func:`sys.setswitchinterval` to the given *interval*. Defines a " -"minimum interval for Android systems to prevent the system from hanging." -msgstr "" - -msgid "" -"Use this check to guard CPython's implementation-specific tests or to run " -"them only on the implementations guarded by the arguments. This function " -"returns ``True`` or ``False`` depending on the host platform. Example usage::" -msgstr "" - -msgid "" -"Set the values for :data:`max_memuse` and :data:`real_max_memuse` for big " -"memory tests." -msgstr "" - -msgid "" -"Store the value from *stdout*. It is meant to hold the stdout at the time " -"the regrtest began." -msgstr "" - -msgid "" -"Return the original stdout set by :func:`record_original_stdout` or ``sys." -"stdout`` if it's not set." -msgstr "" - -msgid "" -"Return a list of command line arguments reproducing the current settings in " -"``sys.flags`` and ``sys.warnoptions``." -msgstr "" - -msgid "" -"Return a list of command line arguments reproducing the current optimization " -"settings in ``sys.flags``." -msgstr "" - -msgid "" -"A context managers that temporarily replaces the named stream with :class:" -"`io.StringIO` object." -msgstr "" - -msgid "Example use with output streams::" -msgstr "" - -msgid "Example use with input stream::" -msgstr "" - -msgid "A context manager that temporary disables :mod:`faulthandler`." -msgstr "" - -msgid "" -"Force as many objects as possible to be collected. This is needed because " -"timely deallocation is not guaranteed by the garbage collector. This means " -"that ``__del__`` methods may be called later than expected and weakrefs may " -"remain alive for longer than expected." -msgstr "" - -msgid "" -"A context manager that disables the garbage collector on entry. On exit, the " -"garbage collector is restored to its prior state." -msgstr "" - -msgid "Context manager to swap out an attribute with a new object." -msgstr "" - -msgid "Usage::" -msgstr "" - -msgid "" -"This will set ``obj.attr`` to 5 for the duration of the ``with`` block, " -"restoring the old value at the end of the block. If ``attr`` doesn't exist " -"on ``obj``, it will be created and then deleted at the end of the block." -msgstr "" - -msgid "" -"The old value (or ``None`` if it doesn't exist) will be assigned to the " -"target of the \"as\" clause, if there is one." -msgstr "" - -msgid "Context manager to swap out an item with a new object." -msgstr "" - -msgid "" -"This will set ``obj[\"item\"]`` to 5 for the duration of the ``with`` block, " -"restoring the old value at the end of the block. If ``item`` doesn't exist " -"on ``obj``, it will be created and then deleted at the end of the block." -msgstr "" - -msgid "" -"Call the ``flush()`` method on :data:`sys.stdout` and then on :data:`sys." -"stderr`. It can be used to make sure that the logs order is consistent " -"before writing into stderr." -msgstr "" - -msgid "" -"Print a warning into :data:`sys.__stderr__`. Format the message as: " -"``f\"Warning -- {msg}\"``. If *msg* is made of multiple lines, add " -"``\"Warning -- \"`` prefix to each line." -msgstr "" - -msgid "" -"Wait until process *pid* completes and check that the process exit code is " -"*exitcode*." -msgstr "" - -msgid "" -"Raise an :exc:`AssertionError` if the process exit code is not equal to " -"*exitcode*." -msgstr "" - -msgid "" -"If the process runs longer than *timeout* seconds (:data:`SHORT_TIMEOUT` by " -"default), kill the process and raise an :exc:`AssertionError`. The timeout " -"feature is not available on Windows." -msgstr "" - -msgid "" -"Return the size of the :c:type:`PyObject` whose structure members are " -"defined by *fmt*. The returned value includes the size of the Python object " -"header and alignment." -msgstr "" - -msgid "" -"Return the size of the :c:type:`PyVarObject` whose structure members are " -"defined by *fmt*. The returned value includes the size of the Python object " -"header and alignment." -msgstr "" - -msgid "" -"For testcase *test*, assert that the ``sys.getsizeof`` for *o* plus the GC " -"header size equals *size*." -msgstr "" - -msgid "" -"A decorator to conditionally mark tests with :func:`unittest." -"expectedFailure`. Any use of this decorator should have an associated " -"comment identifying the relevant tracker issue." -msgstr "" - -msgid "" -"A decorator that skips the decorated test on TLS certification validation " -"failures." -msgstr "" - -msgid "" -"A decorator for running a function in a different locale, correctly " -"resetting it after it has finished. *catstr* is the locale category as a " -"string (for example ``\"LC_ALL\"``). The *locales* passed will be tried " -"sequentially, and the first valid locale will be used." -msgstr "" - -msgid "" -"A decorator for running a function in a specific timezone, correctly " -"resetting it after it has finished." -msgstr "" - -msgid "" -"Decorator for the minimum version when running test on FreeBSD. If the " -"FreeBSD version is less than the minimum, the test is skipped." -msgstr "" - -msgid "" -"Decorator for the minimum version when running test on Linux. If the Linux " -"version is less than the minimum, the test is skipped." -msgstr "" - -msgid "" -"Decorator for the minimum version when running test on macOS. If the macOS " -"version is less than the minimum, the test is skipped." -msgstr "" - -msgid "Decorator for skipping tests on non-IEEE 754 platforms." -msgstr "" - -msgid "Decorator for skipping tests if :mod:`zlib` doesn't exist." -msgstr "" - -msgid "Decorator for skipping tests if :mod:`gzip` doesn't exist." -msgstr "" - -msgid "Decorator for skipping tests if :mod:`bz2` doesn't exist." -msgstr "" - -msgid "Decorator for skipping tests if :mod:`lzma` doesn't exist." -msgstr "" - -msgid "Decorator for skipping tests if *resource* is not available." -msgstr "" - -msgid "Decorator for only running the test if :data:`HAVE_DOCSTRINGS`." -msgstr "" - -msgid "Decorator for tests only applicable to CPython." -msgstr "" - -msgid "" -"Decorator for invoking :func:`check_impl_detail` on *guards*. If that " -"returns ``False``, then uses *msg* as the reason for skipping the test." -msgstr "" - -msgid "Decorator to temporarily turn off tracing for the duration of the test." -msgstr "" - -msgid "" -"Decorator for tests which involve reference counting. The decorator does " -"not run the test if it is not run by CPython. Any trace function is unset " -"for the duration of the test to prevent unexpected refcounts caused by the " -"trace function." -msgstr "" - -msgid "Decorator for bigmem tests." -msgstr "" - -msgid "" -"*size* is a requested size for the test (in arbitrary, test-interpreted " -"units.) *memuse* is the number of bytes per unit for the test, or a good " -"estimate of it. For example, a test that needs two byte buffers, of 4 GiB " -"each, could be decorated with ``@bigmemtest(size=_4G, memuse=2)``." -msgstr "" - -msgid "" -"The *size* argument is normally passed to the decorated test method as an " -"extra argument. If *dry_run* is ``True``, the value passed to the test " -"method may be less than the requested value. If *dry_run* is ``False``, it " -"means the test doesn't support dummy runs when ``-M`` is not specified." -msgstr "" - -msgid "Decorator for tests that fill the address space." -msgstr "" - -msgid "" -"Test for syntax errors in *statement* by attempting to compile *statement*. " -"*testcase* is the :mod:`unittest` instance for the test. *errtext* is the " -"regular expression which should match the string representation of the " -"raised :exc:`SyntaxError`. If *lineno* is not ``None``, compares to the " -"line of the exception. If *offset* is not ``None``, compares to the offset " -"of the exception." -msgstr "" - -msgid "Open *url*. If open fails, raises :exc:`TestFailed`." -msgstr "" - -msgid "" -"Use this at the end of ``test_main`` whenever sub-processes are started. " -"This will help ensure that no extra children (zombies) stick around to hog " -"resources and create problems when looking for refleaks." -msgstr "" - -msgid "" -"Get an attribute, raising :exc:`unittest.SkipTest` if :exc:`AttributeError` " -"is raised." -msgstr "" - -msgid "" -"Context manager catching unraisable exception using :func:`sys." -"unraisablehook`." -msgstr "" - -msgid "" -"Storing the exception value (``cm.unraisable.exc_value``) creates a " -"reference cycle. The reference cycle is broken explicitly when the context " -"manager exits." -msgstr "" - -msgid "" -"Storing the object (``cm.unraisable.object``) can resurrect it if it is set " -"to an object which is being finalized. Exiting the context manager clears " -"the stored object." -msgstr "" - -msgid "" -"Generic implementation of the :mod:`unittest` ``load_tests`` protocol for " -"use in test packages. *pkg_dir* is the root directory of the package; " -"*loader*, *standard_tests*, and *pattern* are the arguments expected by " -"``load_tests``. In simple cases, the test package's ``__init__.py`` can be " -"the following::" -msgstr "" - -msgid "" -"Returns the set of attributes, functions or methods of *ref_api* not found " -"on *other_api*, except for a defined list of items to be ignored in this " -"check specified in *ignore*." -msgstr "" - -msgid "" -"By default this skips private attributes beginning with '_' but includes all " -"magic methods, i.e. those starting and ending in '__'." -msgstr "" - -msgid "" -"Override *object_to_patch.attr_name* with *new_value*. Also add cleanup " -"procedure to *test_instance* to restore *object_to_patch* for *attr_name*. " -"The *attr_name* should be a valid attribute for *object_to_patch*." -msgstr "" - -msgid "" -"Run *code* in subinterpreter. Raise :exc:`unittest.SkipTest` if :mod:" -"`tracemalloc` is enabled." -msgstr "" - -msgid "Assert instances of *cls* are deallocated after iterating." -msgstr "" - -msgid "" -"Check for the existence of the compiler executables whose names are listed " -"in *cmd_names* or all the compiler executables when *cmd_names* is empty and " -"return the first missing executable or ``None`` when none is found missing." -msgstr "" - -msgid "" -"Assert that the ``__all__`` variable of *module* contains all public names." -msgstr "" - -msgid "" -"The module's public names (its API) are detected automatically based on " -"whether they match the public name convention and were defined in *module*." -msgstr "" - -msgid "" -"The *name_of_module* argument can specify (as a string or tuple thereof) " -"what module(s) an API could be defined in order to be detected as a public " -"API. One case for this is when *module* imports part of its public API from " -"other modules, possibly a C backend (like ``csv`` and its ``_csv``)." -msgstr "" - -msgid "" -"The *extra* argument can be a set of names that wouldn't otherwise be " -"automatically detected as \"public\", like objects without a proper " -"``__module__`` attribute. If provided, it will be added to the automatically " -"detected ones." -msgstr "" - -msgid "" -"The *not_exported* argument can be a set of names that must not be treated " -"as part of the public API even though their names indicate otherwise." -msgstr "" - -msgid "Example use::" -msgstr "" - -msgid "" -"Skip tests if the :mod:`multiprocessing.synchronize` module is missing, if " -"there is no available semaphore implementation, or if creating a lock raises " -"an :exc:`OSError`." -msgstr "" - -msgid "Assert that type *tp* cannot be instantiated using *args* and *kwds*." -msgstr "" - -msgid "" -"This function returns a context manager that will change the global :func:" -"`sys.set_int_max_str_digits` setting for the duration of the context to " -"allow execution of test code that needs a different limit on the number of " -"digits when converting between an integer and string." -msgstr "" - -msgid "The :mod:`test.support` module defines the following classes:" -msgstr "" - -msgid "" -"A context manager used to try to prevent crash dialog popups on tests that " -"are expected to crash a subprocess." -msgstr "" - -msgid "" -"On Windows, it disables Windows Error Reporting dialogs using `SetErrorMode " -"`_." -msgstr "" - -msgid "" -"On UNIX, :func:`resource.setrlimit` is used to set :attr:`resource." -"RLIMIT_CORE`'s soft limit to 0 to prevent coredump file creation." -msgstr "" - -msgid "On both platforms, the old value is restored by :meth:`__exit__`." -msgstr "" - -msgid "" -"Class to save and restore signal handlers registered by the Python signal " -"handler." -msgstr "" - -msgid "" -"Save the signal handlers to a dictionary mapping signal numbers to the " -"current signal handler." -msgstr "" - -msgid "" -"Set the signal numbers from the :meth:`save` dictionary to the saved handler." -msgstr "" - -msgid "Try to match a single dict with the supplied arguments." -msgstr "" - -msgid "Try to match a single stored value (*dv*) with a supplied value (*v*)." -msgstr "" - -msgid "Run *test* and return the result." -msgstr "" - -msgid ":mod:`test.support.socket_helper` --- Utilities for socket tests" -msgstr "" - -msgid "" -"The :mod:`test.support.socket_helper` module provides support for socket " -"tests." -msgstr "" - -msgid "Set to ``True`` if IPv6 is enabled on this host, ``False`` otherwise." -msgstr "" - -msgid "" -"Returns an unused port that should be suitable for binding. This is " -"achieved by creating a temporary socket with the same family and type as the " -"``sock`` parameter (default is :const:`~socket.AF_INET`, :const:`~socket." -"SOCK_STREAM`), and binding it to the specified host address (defaults to " -"``0.0.0.0``) with the port set to 0, eliciting an unused ephemeral port from " -"the OS. The temporary socket is then closed and deleted, and the ephemeral " -"port is returned." -msgstr "" - -msgid "" -"Either this method or :func:`bind_port` should be used for any tests where a " -"server socket needs to be bound to a particular port for the duration of the " -"test. Which one to use depends on whether the calling code is creating a " -"Python socket, or if an unused port needs to be provided in a constructor or " -"passed to an external program (i.e. the ``-accept`` argument to openssl's " -"s_server mode). Always prefer :func:`bind_port` over :func:" -"`find_unused_port` where possible. Using a hard coded port is discouraged " -"since it can make multiple instances of the test impossible to run " -"simultaneously, which is a problem for buildbots." -msgstr "" - -msgid "" -"Bind the socket to a free port and return the port number. Relies on " -"ephemeral ports in order to ensure we are using an unbound port. This is " -"important as many tests may be running simultaneously, especially in a " -"buildbot environment. This method raises an exception if the ``sock." -"family`` is :const:`~socket.AF_INET` and ``sock.type`` is :const:`~socket." -"SOCK_STREAM`, and the socket has :const:`~socket.SO_REUSEADDR` or :const:" -"`~socket.SO_REUSEPORT` set on it. Tests should never set these socket " -"options for TCP/IP sockets. The only case for setting these options is " -"testing multicasting via multiple UDP sockets." -msgstr "" - -msgid "" -"Additionally, if the :const:`~socket.SO_EXCLUSIVEADDRUSE` socket option is " -"available (i.e. on Windows), it will be set on the socket. This will " -"prevent anyone else from binding to our host/port for the duration of the " -"test." -msgstr "" - -msgid "" -"Bind a Unix socket, raising :exc:`unittest.SkipTest` if :exc:" -"`PermissionError` is raised." -msgstr "" - -msgid "" -"A decorator for running tests that require a functional ``bind()`` for Unix " -"sockets." -msgstr "" - -msgid "" -"A context manager that raises :exc:`~test.support.ResourceDenied` when " -"various issues with the internet connection manifest themselves as " -"exceptions." -msgstr "" - -msgid "" -":mod:`test.support.script_helper` --- Utilities for the Python execution " -"tests" -msgstr "" - -msgid "" -"The :mod:`test.support.script_helper` module provides support for Python's " -"script execution tests." -msgstr "" - -msgid "" -"Return ``True`` if ``sys.executable interpreter`` requires environment " -"variables in order to be able to run at all." -msgstr "" - -msgid "" -"This is designed to be used with ``@unittest.skipIf()`` to annotate tests " -"that need to use an ``assert_python*()`` function to launch an isolated mode " -"(``-I``) or no environment mode (``-E``) sub-interpreter process." -msgstr "" - -msgid "" -"A normal build & test does not run into this situation but it can happen " -"when trying to run the standard library test suite from an interpreter that " -"doesn't have an obvious home with Python's current home finding logic." -msgstr "" - -msgid "" -"Setting :envvar:`PYTHONHOME` is one way to get most of the testsuite to run " -"in that situation. :envvar:`PYTHONPATH` or :envvar:`PYTHONUSERSITE` are " -"other common environment variables that might impact whether or not the " -"interpreter can start." -msgstr "" - -msgid "" -"Set up the environment based on *env_vars* for running the interpreter in a " -"subprocess. The values can include ``__isolated``, ``__cleanenv``, " -"``__cwd``, and ``TERM``." -msgstr "" - -msgid "The function no longer strips whitespaces from *stderr*." -msgstr "" - -msgid "" -"Assert that running the interpreter with *args* and optional environment " -"variables *env_vars* succeeds (``rc == 0``) and return a ``(return code, " -"stdout, stderr)`` tuple." -msgstr "" - -msgid "" -"If the *__cleanenv* keyword-only parameter is set, *env_vars* is used as a " -"fresh environment." -msgstr "" - -msgid "" -"Python is started in isolated mode (command line option ``-I``), except if " -"the *__isolated* keyword-only parameter is set to ``False``." -msgstr "" - -msgid "" -"Assert that running the interpreter with *args* and optional environment " -"variables *env_vars* fails (``rc != 0``) and return a ``(return code, " -"stdout, stderr)`` tuple." -msgstr "" - -msgid "See :func:`assert_python_ok` for more options." -msgstr "" - -msgid "Run a Python subprocess with the given arguments." -msgstr "" - -msgid "" -"*kw* is extra keyword args to pass to :func:`subprocess.Popen`. Returns a :" -"class:`subprocess.Popen` object." -msgstr "" - -msgid "" -"Run the given :class:`subprocess.Popen` process until completion and return " -"stdout." -msgstr "" - -msgid "" -"Create script containing *source* in path *script_dir* and " -"*script_basename*. If *omit_suffix* is ``False``, append ``.py`` to the " -"name. Return the full script path." -msgstr "" - -msgid "" -"Create zip file at *zip_dir* and *zip_basename* with extension ``zip`` which " -"contains the files in *script_name*. *name_in_zip* is the archive name. " -"Return a tuple containing ``(full path, full path of archive name)``." -msgstr "" - -msgid "" -"Create a directory named *pkg_dir* containing an ``__init__`` file with " -"*init_source* as its contents." -msgstr "" - -msgid "" -"Create a zip package directory with a path of *zip_dir* and *zip_basename* " -"containing an empty ``__init__`` file and a file *script_basename* " -"containing the *source*. If *compiled* is ``True``, both source files will " -"be compiled and added to the zip package. Return a tuple of the full zip " -"path and the archive name for the zip file." -msgstr "" - -msgid "" -":mod:`test.support.bytecode_helper` --- Support tools for testing correct " -"bytecode generation" -msgstr "" - -msgid "" -"The :mod:`test.support.bytecode_helper` module provides support for testing " -"and inspecting bytecode generation." -msgstr "" - -msgid "The module defines the following class:" -msgstr "" - -msgid "This class has custom assertion methods for inspecting bytecode." -msgstr "" - -msgid "Return the disassembly of *co* as string." -msgstr "" - -msgid "" -"Return instr if *opname* is found, otherwise throws :exc:`AssertionError`." -msgstr "" - -msgid "Throws :exc:`AssertionError` if *opname* is found." -msgstr "" - -msgid ":mod:`test.support.threading_helper` --- Utilities for threading tests" -msgstr "" - -msgid "" -"The :mod:`test.support.threading_helper` module provides support for " -"threading tests." -msgstr "" - -msgid "" -"Join a *thread* within *timeout*. Raise an :exc:`AssertionError` if thread " -"is still alive after *timeout* seconds." -msgstr "" - -msgid "Decorator to ensure the threads are cleaned up even if the test fails." -msgstr "" - -msgid "" -"Context manager to start *threads*, which is a sequence of threads. *unlock* " -"is a function called after the threads are started, even if an exception was " -"raised; an example would be :meth:`threading.Event.set`. ``start_threads`` " -"will attempt to join the started threads upon exit." -msgstr "" - -msgid "" -"Cleanup up threads not specified in *original_values*. Designed to emit a " -"warning if a test leaves running threads in the background." -msgstr "" - -msgid "Return current thread count and copy of dangling threads." -msgstr "" - -msgid "" -"Context manager to wait until all threads created in the ``with`` statement " -"exit." -msgstr "" - -msgid "" -"Context manager catching :class:`threading.Thread` exception using :func:" -"`threading.excepthook`." -msgstr "" - -msgid "Attributes set when an exception is caught:" -msgstr "" - -msgid "``exc_type``" -msgstr "" - -msgid "``exc_value``" -msgstr "" - -msgid "``exc_traceback``" -msgstr "" - -msgid "``thread``" -msgstr "" - -msgid "See :func:`threading.excepthook` documentation." -msgstr "" - -msgid "These attributes are deleted at the context manager exit." -msgstr "" - -msgid ":mod:`test.support.os_helper` --- Utilities for os tests" -msgstr "" - -msgid "The :mod:`test.support.os_helper` module provides support for os tests." -msgstr "" - -msgid "A non-ASCII character encodable by :func:`os.fsencode`." -msgstr "" - -msgid "Set to :func:`os.getcwd`." -msgstr "" - -msgid "" -"Set to a name that is safe to use as the name of a temporary file. Any " -"temporary file that is created should be closed and unlinked (removed)." -msgstr "" - -msgid "" -"Set to a filename containing the :data:`FS_NONASCII` character, if it " -"exists. This guarantees that if the filename exists, it can be encoded and " -"decoded with the default filesystem encoding. This allows tests that require " -"a non-ASCII filename to be easily skipped on platforms where they can't work." -msgstr "" - -msgid "" -"Set to a filename (str type) that should not be able to be encoded by file " -"system encoding in strict mode. It may be ``None`` if it's not possible to " -"generate such a filename." -msgstr "" - -msgid "" -"Set to a filename (bytes type) that should not be able to be decoded by file " -"system encoding in strict mode. It may be ``None`` if it's not possible to " -"generate such a filename." -msgstr "" - -msgid "Set to a non-ASCII name for a temporary file." -msgstr "" - -msgid "" -"Class used to temporarily set or unset environment variables. Instances can " -"be used as a context manager and have a complete dictionary interface for " -"querying/modifying the underlying ``os.environ``. After exit from the " -"context manager all changes to environment variables done through this " -"instance will be rolled back." -msgstr "" - -msgid "Added dictionary interface." -msgstr "" - -msgid "" -"Simple :term:`path-like object`. It implements the :meth:`__fspath__` " -"method which just returns the *path* argument. If *path* is an exception, " -"it will be raised in :meth:`!__fspath__`." -msgstr "" - -msgid "" -"Temporarily set the environment variable ``envvar`` to the value of " -"``value``." -msgstr "" - -msgid "Temporarily unset the environment variable ``envvar``." -msgstr "" - -msgid "Return ``True`` if the OS supports symbolic links, ``False`` otherwise." -msgstr "" - -msgid "Return ``True`` if the OS supports xattr, ``False`` otherwise." -msgstr "" - -msgid "" -"A context manager that temporarily changes the current working directory to " -"*path* and yields the directory." -msgstr "" - -msgid "" -"If *quiet* is ``False``, the context manager raises an exception on error. " -"Otherwise, it issues only a warning and keeps the current working directory " -"the same." -msgstr "" - -msgid "" -"Create an empty file with *filename*. If it already exists, truncate it." -msgstr "" - -msgid "Count the number of open file descriptors." -msgstr "" - -msgid "Return ``True`` if the file system for *directory* is case-insensitive." -msgstr "" - -msgid "" -"Create an invalid file descriptor by opening and closing a temporary file, " -"and returning its descriptor." -msgstr "" - -msgid "" -"Call :func:`os.rmdir` on *filename*. On Windows platforms, this is wrapped " -"with a wait loop that checks for the existence of the file, which is needed " -"due to antivirus programs that can hold files open and prevent deletion." -msgstr "" - -msgid "" -"Call :func:`shutil.rmtree` on *path* or call :func:`os.lstat` and :func:`os." -"rmdir` to remove a path and its contents. As with :func:`rmdir`, on Windows " -"platforms this is wrapped with a wait loop that checks for the existence of " -"the files." -msgstr "" - -msgid "A decorator for running tests that require support for symbolic links." -msgstr "" - -msgid "A decorator for running tests that require support for xattr." -msgstr "" - -msgid "" -"A context manager that temporarily creates a new directory and changes the " -"current working directory (CWD)." -msgstr "" - -msgid "" -"The context manager creates a temporary directory in the current directory " -"with name *name* before temporarily changing the current working directory. " -"If *name* is ``None``, the temporary directory is created using :func:" -"`tempfile.mkdtemp`." -msgstr "" - -msgid "" -"If *quiet* is ``False`` and it is not possible to create or change the CWD, " -"an error is raised. Otherwise, only a warning is raised and the original " -"CWD is used." -msgstr "" - -msgid "" -"A context manager that creates a temporary directory at *path* and yields " -"the directory." -msgstr "" - -msgid "" -"If *path* is ``None``, the temporary directory is created using :func:" -"`tempfile.mkdtemp`. If *quiet* is ``False``, the context manager raises an " -"exception on error. Otherwise, if *path* is specified and cannot be " -"created, only a warning is issued." -msgstr "" - -msgid "A context manager that temporarily sets the process umask." -msgstr "" - -msgid "" -"Call :func:`os.unlink` on *filename*. As with :func:`rmdir`, on Windows " -"platforms, this is wrapped with a wait loop that checks for the existence of " -"the file." -msgstr "" - -msgid ":mod:`test.support.import_helper` --- Utilities for import tests" -msgstr "" - -msgid "" -"The :mod:`test.support.import_helper` module provides support for import " -"tests." -msgstr "" - -msgid "" -"Remove the module named *module_name* from ``sys.modules`` and delete any " -"byte-compiled files of the module." -msgstr "" - -msgid "" -"This function imports and returns a fresh copy of the named Python module by " -"removing the named module from ``sys.modules`` before doing the import. Note " -"that unlike :func:`reload`, the original module is not affected by this " -"operation." -msgstr "" - -msgid "" -"*fresh* is an iterable of additional module names that are also removed from " -"the ``sys.modules`` cache before doing the import." -msgstr "" - -msgid "" -"*blocked* is an iterable of module names that are replaced with ``None`` in " -"the module cache during the import to ensure that attempts to import them " -"raise :exc:`ImportError`." -msgstr "" - -msgid "" -"The named module and any modules named in the *fresh* and *blocked* " -"parameters are saved before starting the import and then reinserted into " -"``sys.modules`` when the fresh import is complete." -msgstr "" - -msgid "" -"Module and package deprecation messages are suppressed during this import if " -"*deprecated* is ``True``." -msgstr "" - -msgid "" -"This function will raise :exc:`ImportError` if the named module cannot be " -"imported." -msgstr "" - -msgid "" -"This function imports and returns the named module. Unlike a normal import, " -"this function raises :exc:`unittest.SkipTest` if the module cannot be " -"imported." -msgstr "" - -msgid "" -"Module and package deprecation messages are suppressed during this import if " -"*deprecated* is ``True``. If a module is required on a platform but " -"optional for others, set *required_on* to an iterable of platform prefixes " -"which will be compared against :data:`sys.platform`." -msgstr "" - -msgid "Return a copy of :data:`sys.modules`." -msgstr "" - -msgid "" -"Remove modules except for *oldmodules* and ``encodings`` in order to " -"preserve internal cache." -msgstr "" - -msgid "Delete *name* from ``sys.modules``." -msgstr "" - -msgid "" -"Move a :pep:`3147`/:pep:`488` pyc file to its legacy pyc location and return " -"the file system path to the legacy pyc file. The *source* value is the file " -"system path to the source file. It does not need to exist, however the PEP " -"3147/488 pyc file must exist." -msgstr "" - -msgid "" -"A context manager to force import to return a new module reference. This is " -"useful for testing module-level behaviors, such as the emission of a :exc:" -"`DeprecationWarning` on import. Example usage::" -msgstr "" - -msgid "A context manager to temporarily add directories to :data:`sys.path`." -msgstr "" - -msgid "" -"This makes a copy of :data:`sys.path`, appends any directories given as " -"positional arguments, then reverts :data:`sys.path` to the copied settings " -"when the context ends." -msgstr "" - -msgid "" -"Note that *all* :data:`sys.path` modifications in the body of the context " -"manager, including replacement of the object, will be reverted at the end of " -"the block." -msgstr "" - -msgid ":mod:`test.support.warnings_helper` --- Utilities for warnings tests" -msgstr "" - -msgid "" -"The :mod:`test.support.warnings_helper` module provides support for warnings " -"tests." -msgstr "" - -msgid "" -"Suppress warnings that are instances of *category*, which must be :exc:" -"`Warning` or a subclass. Roughly equivalent to :func:`warnings." -"catch_warnings` with :meth:`warnings.simplefilter('ignore', " -"category=category) `. For example::" -msgstr "" - -msgid "" -"Context manager to check that no :exc:`ResourceWarning` was raised. You " -"must remove the object which may emit :exc:`ResourceWarning` before the end " -"of the context manager." -msgstr "" - -msgid "" -"Test for syntax warning in *statement* by attempting to compile *statement*. " -"Test also that the :exc:`SyntaxWarning` is emitted only once, and that it " -"will be converted to a :exc:`SyntaxError` when turned into error. *testcase* " -"is the :mod:`unittest` instance for the test. *errtext* is the regular " -"expression which should match the string representation of the emitted :exc:" -"`SyntaxWarning` and raised :exc:`SyntaxError`. If *lineno* is not ``None``, " -"compares to the line of the warning and exception. If *offset* is not " -"``None``, compares to the offset of the exception." -msgstr "" - -msgid "" -"A convenience wrapper for :func:`warnings.catch_warnings()` that makes it " -"easier to test that a warning was correctly raised. It is approximately " -"equivalent to calling ``warnings.catch_warnings(record=True)`` with :meth:" -"`warnings.simplefilter` set to ``always`` and with the option to " -"automatically validate the results that are recorded." -msgstr "" - -msgid "" -"``check_warnings`` accepts 2-tuples of the form ``(\"message regexp\", " -"WarningCategory)`` as positional arguments. If one or more *filters* are " -"provided, or if the optional keyword argument *quiet* is ``False``, it " -"checks to make sure the warnings are as expected: each specified filter " -"must match at least one of the warnings raised by the enclosed code or the " -"test fails, and if any warnings are raised that do not match any of the " -"specified filters the test fails. To disable the first of these checks, set " -"*quiet* to ``True``." -msgstr "" - -msgid "If no arguments are specified, it defaults to::" -msgstr "" - -msgid "In this case all warnings are caught and no errors are raised." -msgstr "" - -msgid "" -"On entry to the context manager, a :class:`WarningRecorder` instance is " -"returned. The underlying warnings list from :func:`~warnings.catch_warnings` " -"is available via the recorder object's :attr:`warnings` attribute. As a " -"convenience, the attributes of the object representing the most recent " -"warning can also be accessed directly through the recorder object (see " -"example below). If no warning has been raised, then any of the attributes " -"that would otherwise be expected on an object representing a warning will " -"return ``None``." -msgstr "" - -msgid "" -"The recorder object also has a :meth:`reset` method, which clears the " -"warnings list." -msgstr "" - -msgid "The context manager is designed to be used like this::" -msgstr "" - -msgid "" -"In this case if either warning was not raised, or some other warning was " -"raised, :func:`check_warnings` would raise an error." -msgstr "" - -msgid "" -"When a test needs to look more deeply into the warnings, rather than just " -"checking whether or not they occurred, code like this can be used::" -msgstr "" - -msgid "" -"Here all warnings will be caught, and the test code tests the captured " -"warnings directly." -msgstr "" - -msgid "New optional arguments *filters* and *quiet*." -msgstr "" - -msgid "" -"Class used to record warnings for unit tests. See documentation of :func:" -"`check_warnings` above for more details." -msgstr "" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" diff --git a/library/text.po b/library/text.po index 8144c01463..d244542aff 100644 --- a/library/text.po +++ b/library/text.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/textwrap.po b/library/textwrap.po index e790992cd4..be5303403e 100644 --- a/library/textwrap.po +++ b/library/textwrap.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,11 +30,11 @@ msgid "**Source code:** :source:`Lib/textwrap.py`" msgstr "**Kod źródłowy:** :source:`Lib/textwrap.py`" msgid "" -"The :mod:`!textwrap` module provides some convenience functions, as well as :" -"class:`TextWrapper`, the class that does all the work. If you're just " +"The :mod:`!textwrap` module provides some convenience functions, as well " +"as :class:`TextWrapper`, the class that does all the work. If you're just " "wrapping or filling one or two text strings, the convenience functions " -"should be good enough; otherwise, you should use an instance of :class:" -"`TextWrapper` for efficiency." +"should be good enough; otherwise, you should use an instance " +"of :class:`TextWrapper` for efficiency." msgstr "" msgid "" @@ -44,13 +44,13 @@ msgid "" msgstr "" msgid "" -"Optional keyword arguments correspond to the instance attributes of :class:" -"`TextWrapper`, documented below." +"Optional keyword arguments correspond to the instance attributes " +"of :class:`TextWrapper`, documented below." msgstr "" msgid "" -"See the :meth:`TextWrapper.wrap` method for additional details on how :func:" -"`wrap` behaves." +"See the :meth:`TextWrapper.wrap` method for additional details on " +"how :func:`wrap` behaves." msgstr "" msgid "" @@ -62,8 +62,8 @@ msgid "\"\\n\".join(wrap(text, ...))" msgstr "" msgid "" -"In particular, :func:`fill` accepts exactly the same keyword arguments as :" -"func:`wrap`." +"In particular, :func:`fill` accepts exactly the same keyword arguments " +"as :func:`wrap`." msgstr "" msgid "Collapse and truncate the given *text* to fit in the given *width*." @@ -86,11 +86,12 @@ msgid "" msgstr "" msgid "" -"Optional keyword arguments correspond to the instance attributes of :class:" -"`TextWrapper`, documented below. Note that the whitespace is collapsed " -"before the text is passed to the :class:`TextWrapper` :meth:`fill` function, " -"so changing the value of :attr:`.tabsize`, :attr:`.expand_tabs`, :attr:`." -"drop_whitespace`, and :attr:`.replace_whitespace` will have no effect." +"Optional keyword arguments correspond to the instance attributes " +"of :class:`TextWrapper`, documented below. Note that the whitespace is " +"collapsed before the text is passed to the :class:`TextWrapper` :meth:`fill` " +"function, so changing the value " +"of :attr:`.tabsize`, :attr:`.expand_tabs`, :attr:`.drop_whitespace`, " +"and :attr:`.replace_whitespace` will have no effect." msgstr "" msgid "Remove any common leading whitespace from every line in *text*." @@ -172,17 +173,17 @@ msgstr "" "+ world" msgid "" -":func:`wrap`, :func:`fill` and :func:`shorten` work by creating a :class:" -"`TextWrapper` instance and calling a single method on it. That instance is " -"not reused, so for applications that process many text strings using :func:" -"`wrap` and/or :func:`fill`, it may be more efficient to create your own :" -"class:`TextWrapper` object." +":func:`wrap`, :func:`fill` and :func:`shorten` work by creating " +"a :class:`TextWrapper` instance and calling a single method on it. That " +"instance is not reused, so for applications that process many text strings " +"using :func:`wrap` and/or :func:`fill`, it may be more efficient to create " +"your own :class:`TextWrapper` object." msgstr "" msgid "" "Text is preferably wrapped on whitespaces and right after the hyphens in " -"hyphenated words; only then will long words be broken if necessary, unless :" -"attr:`TextWrapper.break_long_words` is set to false." +"hyphenated words; only then will long words be broken if necessary, " +"unless :attr:`TextWrapper.break_long_words` is set to false." msgstr "" msgid "" @@ -215,9 +216,9 @@ msgstr "" msgid "" "(default: ``70``) The maximum length of wrapped lines. As long as there are " -"no individual words in the input text longer than :attr:`width`, :class:" -"`TextWrapper` guarantees that no output line will be longer than :attr:" -"`width` characters." +"no individual words in the input text longer " +"than :attr:`width`, :class:`TextWrapper` guarantees that no output line will " +"be longer than :attr:`width` characters." msgstr "" msgid "" @@ -232,8 +233,8 @@ msgid "" msgstr "" msgid "" -"(default: ``True``) If true, after tab expansion but before wrapping, the :" -"meth:`wrap` method will replace each whitespace character with a single " +"(default: ``True``) If true, after tab expansion but before wrapping, " +"the :meth:`wrap` method will replace each whitespace character with a single " "space. The whitespace characters replaced are as follows: tab, newline, " "vertical tab, formfeed, and carriage return (``'\\t\\n\\v\\f\\r'``)." msgstr "" @@ -334,11 +335,11 @@ msgid "" msgstr "" msgid "" -"Wraps the single paragraph in *text* (a string) so every line is at most :" -"attr:`width` characters long. All wrapping options are taken from instance " -"attributes of the :class:`TextWrapper` instance. Returns a list of output " -"lines, without final newlines. If the wrapped output has no content, the " -"returned list is empty." +"Wraps the single paragraph in *text* (a string) so every line is at " +"most :attr:`width` characters long. All wrapping options are taken from " +"instance attributes of the :class:`TextWrapper` instance. Returns a list of " +"output lines, without final newlines. If the wrapped output has no content, " +"the returned list is empty." msgstr "" msgid "" diff --git a/library/threading.po b/library/threading.po index 68861002a5..7c0f381a49 100644 --- a/library/threading.po +++ b/library/threading.po @@ -4,16 +4,17 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -124,9 +125,10 @@ msgid "" "lock>`, only one thread can execute Python code at once (even though certain " "performance-oriented libraries might overcome this limitation). If you want " "your application to make better use of the computational resources of multi-" -"core machines, you are advised to use :mod:`multiprocessing` or :class:" -"`concurrent.futures.ProcessPoolExecutor`. However, threading is still an " -"appropriate model if you want to run multiple I/O-bound tasks simultaneously." +"core machines, you are advised to use :mod:`multiprocessing` " +"or :class:`concurrent.futures.ProcessPoolExecutor`. However, threading is " +"still an appropriate model if you want to run multiple I/O-bound tasks " +"simultaneously." msgstr "" msgid "GIL and performance considerations" @@ -149,7 +151,7 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "This module defines the following functions:" msgstr "" @@ -246,10 +248,10 @@ msgstr "" msgid "" "Return a list of all :class:`Thread` objects currently active. The list " -"includes daemonic threads and dummy thread objects created by :func:" -"`current_thread`. It excludes terminated threads and threads that have not " -"yet been started. However, the main thread is always part of the result, " -"even when terminated." +"includes daemonic threads and dummy thread objects created " +"by :func:`current_thread`. It excludes terminated threads and threads that " +"have not yet been started. However, the main thread is always part of the " +"result, even when terminated." msgstr "" msgid "" @@ -300,9 +302,9 @@ msgid "" "*size* argument specifies the stack size to be used for subsequently created " "threads, and must be 0 (use platform or configured default) or a positive " "integer value of at least 32,768 (32 KiB). If *size* is not specified, 0 is " -"used. If changing the thread stack size is unsupported, a :exc:" -"`RuntimeError` is raised. If the specified stack size is invalid, a :exc:" -"`ValueError` is raised and the stack size is unmodified. 32 KiB is " +"used. If changing the thread stack size is unsupported, " +"a :exc:`RuntimeError` is raised. If the specified stack size is invalid, " +"a :exc:`ValueError` is raised and the stack size is unmodified. 32 KiB is " "currently the minimum supported stack size value to guarantee sufficient " "stack space for the interpreter itself. Note that some platforms may have " "particular restrictions on values for the stack size, such as requiring a " @@ -322,8 +324,8 @@ msgstr "" msgid "" "The maximum value allowed for the *timeout* parameter of blocking functions " "(:meth:`Lock.acquire`, :meth:`RLock.acquire`, :meth:`Condition.wait`, etc.). " -"Specifying a timeout greater than this value will raise an :exc:" -"`OverflowError`." +"Specifying a timeout greater than this value will raise " +"an :exc:`OverflowError`." msgstr "" msgid "" @@ -402,16 +404,16 @@ msgid "" msgstr "" msgid "" -"Of course, values you get from a :class:`local` object, including their :" -"attr:`~object.__dict__` attribute, are for whatever thread was current at " -"the time the attribute was read. For that reason, you generally don't want " -"to save these values across threads, as they apply only to the thread they " -"came from." +"Of course, values you get from a :class:`local` object, including " +"their :attr:`~object.__dict__` attribute, are for whatever thread was " +"current at the time the attribute was read. For that reason, you generally " +"don't want to save these values across threads, as they apply only to the " +"thread they came from." msgstr "" msgid "" -"You can create custom :class:`local` objects by subclassing the :class:" -"`local` class::" +"You can create custom :class:`local` objects by subclassing " +"the :class:`local` class::" msgstr "" msgid "" @@ -540,8 +542,8 @@ msgstr "" msgid "" "Once the thread's activity is started, the thread is considered 'alive'. It " "stops being alive when its :meth:`~Thread.run` method terminates -- either " -"normally, or by raising an unhandled exception. The :meth:`~Thread." -"is_alive` method tests whether the thread is alive." +"normally, or by raising an unhandled exception. " +"The :meth:`~Thread.is_alive` method tests whether the thread is alive." msgstr "" msgid "" @@ -556,9 +558,9 @@ msgid "" msgstr "" msgid "" -"If the :meth:`~Thread.run` method raises an exception, :func:`threading." -"excepthook` is called to handle it. By default, :func:`threading.excepthook` " -"ignores silently :exc:`SystemExit`." +"If the :meth:`~Thread.run` method raises an " +"exception, :func:`threading.excepthook` is called to handle it. By " +"default, :func:`threading.excepthook` ignores silently :exc:`SystemExit`." msgstr "" msgid "" @@ -597,8 +599,8 @@ msgid "" msgstr "" msgid "" -"*group* should be ``None``; reserved for future extension when a :class:`!" -"ThreadGroup` class is implemented." +"*group* must be ``None`` as it is reserved for future extension when " +"a :class:`!ThreadGroup` class is implemented." msgstr "" msgid "" @@ -631,14 +633,14 @@ msgstr "" msgid "" "*context* is the :class:`~contextvars.Context` value to use when starting " -"the thread. The default value is ``None`` which indicates that the :data:" -"`sys.flags.thread_inherit_context` flag controls the behaviour. If the flag " -"is true, threads will start with a copy of the context of the caller of :" -"meth:`~Thread.start`. If false, they will start with an empty context. To " -"explicitly start with an empty context, pass a new instance of :class:" -"`~contextvars.Context()`. To explicitly start with a copy of the current " -"context, pass the value from :func:`~contextvars.copy_context`. The flag " -"defaults true on free-threaded builds and false otherwise." +"the thread. The default value is ``None`` which indicates that " +"the :data:`sys.flags.thread_inherit_context` flag controls the behaviour. " +"If the flag is true, threads will start with a copy of the context of the " +"caller of :meth:`~Thread.start`. If false, they will start with an empty " +"context. To explicitly start with an empty context, pass a new instance " +"of :class:`~contextvars.Context()`. To explicitly start with a copy of the " +"current context, pass the value from :func:`~contextvars.copy_context`. The " +"flag defaults true on free-threaded builds and false otherwise." msgstr "" msgid "" @@ -671,9 +673,9 @@ msgid "" msgstr "" msgid "" -"If supported, set the operating system thread name to :attr:`threading." -"Thread.name`. The name can be truncated depending on the operating system " -"thread name limits." +"If supported, set the operating system thread name " +"to :attr:`threading.Thread.name`. The name can be truncated depending on the " +"operating system thread name limits." msgstr "" msgid "Set the operating system thread name." @@ -690,8 +692,8 @@ msgid "" msgstr "" msgid "" -"Using list or tuple as the *args* argument which passed to the :class:" -"`Thread` could achieve the same effect." +"Using list or tuple as the *args* argument which passed to " +"the :class:`Thread` could achieve the same effect." msgstr "" msgid "Example::" @@ -719,8 +721,8 @@ msgid "" "floating-point number specifying a timeout for the operation in seconds (or " "fractions thereof). As :meth:`~Thread.join` always returns ``None``, you " "must call :meth:`~Thread.is_alive` after :meth:`~Thread.join` to decide " -"whether a timeout happened -- if the thread is still alive, the :meth:" -"`~Thread.join` call timed out." +"whether a timeout happened -- if the thread is still alive, " +"the :meth:`~Thread.join` call timed out." msgstr "" msgid "" @@ -739,9 +741,9 @@ msgid "" msgstr "" msgid "" -"If an attempt is made to join a running daemonic thread in late stages of :" -"term:`Python finalization ` :meth:`!join` raises a :" -"exc:`PythonFinalizationError`." +"If an attempt is made to join a running daemonic thread in late stages " +"of :term:`Python finalization ` :meth:`!join` raises " +"a :exc:`PythonFinalizationError`." msgstr "" msgid "May raise :exc:`PythonFinalizationError`." @@ -807,8 +809,8 @@ msgid "" "or not (``False``). This must be set before :meth:`~Thread.start` is " "called, otherwise :exc:`RuntimeError` is raised. Its initial value is " "inherited from the creating thread; the main thread is not a daemon thread " -"and therefore all threads created in the main thread default to :attr:" -"`~Thread.daemon` = ``False``." +"and therefore all threads created in the main thread default " +"to :attr:`~Thread.daemon` = ``False``." msgstr "" msgid "" @@ -826,21 +828,21 @@ msgstr "" msgid "" "A primitive lock is a synchronization primitive that is not owned by a " "particular thread when locked. In Python, it is currently the lowest level " -"synchronization primitive available, implemented directly by the :mod:" -"`_thread` extension module." +"synchronization primitive available, implemented directly by " +"the :mod:`_thread` extension module." msgstr "" msgid "" "A primitive lock is in one of two states, \"locked\" or \"unlocked\". It is " -"created in the unlocked state. It has two basic methods, :meth:`~Lock." -"acquire` and :meth:`~Lock.release`. When the state is unlocked, :meth:" -"`~Lock.acquire` changes the state to locked and returns immediately. When " -"the state is locked, :meth:`~Lock.acquire` blocks until a call to :meth:" -"`~Lock.release` in another thread changes it to unlocked, then the :meth:" -"`~Lock.acquire` call resets it to locked and returns. The :meth:`~Lock." -"release` method should only be called in the locked state; it changes the " -"state to unlocked and returns immediately. If an attempt is made to release " -"an unlocked lock, a :exc:`RuntimeError` will be raised." +"created in the unlocked state. It has two basic " +"methods, :meth:`~Lock.acquire` and :meth:`~Lock.release`. When the state is " +"unlocked, :meth:`~Lock.acquire` changes the state to locked and returns " +"immediately. When the state is locked, :meth:`~Lock.acquire` blocks until a " +"call to :meth:`~Lock.release` in another thread changes it to unlocked, then " +"the :meth:`~Lock.acquire` call resets it to locked and returns. " +"The :meth:`~Lock.release` method should only be called in the locked state; " +"it changes the state to unlocked and returns immediately. If an attempt is " +"made to release an unlocked lock, a :exc:`RuntimeError` will be raised." msgstr "" msgid "Locks also support the :ref:`context management protocol `." @@ -848,9 +850,9 @@ msgstr "" msgid "" "When more than one thread is blocked in :meth:`~Lock.acquire` waiting for " -"the state to turn to unlocked, only one thread proceeds when a :meth:`~Lock." -"release` call resets the state to unlocked; which one of the waiting threads " -"proceeds is not defined, and may vary across implementations." +"the state to turn to unlocked, only one thread proceeds when " +"a :meth:`~Lock.release` call resets the state to unlocked; which one of the " +"waiting threads proceeds is not defined, and may vary across implementations." msgstr "" msgid "All methods are executed atomically." @@ -937,15 +939,15 @@ msgid "" msgstr "" msgid "" -"Threads call a lock's :meth:`~RLock.acquire` method to lock it, and its :" -"meth:`~Lock.release` method to unlock it." +"Threads call a lock's :meth:`~RLock.acquire` method to lock it, and " +"its :meth:`~Lock.release` method to unlock it." msgstr "" msgid "" "Reentrant locks support the :ref:`context management protocol `, " -"so it is recommended to use :keyword:`with` instead of manually calling :" -"meth:`~RLock.acquire` and :meth:`~RLock.release` to handle acquiring and " -"releasing the lock for a block of code." +"so it is recommended to use :keyword:`with` instead of manually " +"calling :meth:`~RLock.acquire` and :meth:`~RLock.release` to handle " +"acquiring and releasing the lock for a block of code." msgstr "" msgid "" @@ -1035,9 +1037,9 @@ msgid "" msgstr "" msgid "" -"Only call this method when the calling thread owns the lock. A :exc:" -"`RuntimeError` is raised if this method is called when the lock is not " -"acquired." +"Only call this method when the calling thread owns the lock. " +"A :exc:`RuntimeError` is raised if this method is called when the lock is " +"not acquired." msgstr "" msgid "Return a boolean indicating whether this object is locked right now." @@ -1056,23 +1058,24 @@ msgstr "" msgid "" "A condition variable obeys the :ref:`context management protocol `: using the ``with`` statement acquires the associated lock for the " -"duration of the enclosed block. The :meth:`~Condition.acquire` and :meth:" -"`~Condition.release` methods also call the corresponding methods of the " -"associated lock." +"duration of the enclosed block. The :meth:`~Condition.acquire` " +"and :meth:`~Condition.release` methods also call the corresponding methods " +"of the associated lock." msgstr "" msgid "" -"Other methods must be called with the associated lock held. The :meth:" -"`~Condition.wait` method releases the lock, and then blocks until another " -"thread awakens it by calling :meth:`~Condition.notify` or :meth:`~Condition." -"notify_all`. Once awakened, :meth:`~Condition.wait` re-acquires the lock " -"and returns. It is also possible to specify a timeout." +"Other methods must be called with the associated lock held. " +"The :meth:`~Condition.wait` method releases the lock, and then blocks until " +"another thread awakens it by calling :meth:`~Condition.notify` " +"or :meth:`~Condition.notify_all`. Once awakened, :meth:`~Condition.wait` re-" +"acquires the lock and returns. It is also possible to specify a timeout." msgstr "" msgid "" "The :meth:`~Condition.notify` method wakes up one of the threads waiting for " -"the condition variable, if any are waiting. The :meth:`~Condition." -"notify_all` method wakes up all threads waiting for the condition variable." +"the condition variable, if any are waiting. " +"The :meth:`~Condition.notify_all` method wakes up all threads waiting for " +"the condition variable." msgstr "" msgid "" @@ -1087,11 +1090,11 @@ msgid "" "The typical programming style using condition variables uses the lock to " "synchronize access to some shared state; threads that are interested in a " "particular change of state call :meth:`~Condition.wait` repeatedly until " -"they see the desired state, while threads that modify the state call :meth:" -"`~Condition.notify` or :meth:`~Condition.notify_all` when they change the " -"state in such a way that it could possibly be a desired state for one of the " -"waiters. For example, the following code is a generic producer-consumer " -"situation with unlimited buffer capacity::" +"they see the desired state, while threads that modify the state " +"call :meth:`~Condition.notify` or :meth:`~Condition.notify_all` when they " +"change the state in such a way that it could possibly be a desired state for " +"one of the waiters. For example, the following code is a generic producer-" +"consumer situation with unlimited buffer capacity::" msgstr "" msgid "" @@ -1111,8 +1114,8 @@ msgid "" "The ``while`` loop checking for the application's condition is necessary " "because :meth:`~Condition.wait` can return after an arbitrary long time, and " "the condition which prompted the :meth:`~Condition.notify` call may no " -"longer hold true. This is inherent to multi-threaded programming. The :" -"meth:`~Condition.wait_for` method can be used to automate the condition " +"longer hold true. This is inherent to multi-threaded programming. " +"The :meth:`~Condition.wait_for` method can be used to automate the condition " "checking, and eases the computation of timeouts::" msgstr "" @@ -1124,11 +1127,11 @@ msgid "" msgstr "" msgid "" -"To choose between :meth:`~Condition.notify` and :meth:`~Condition." -"notify_all`, consider whether one state change can be interesting for only " -"one or several waiting threads. E.g. in a typical producer-consumer " -"situation, adding one item to the buffer only needs to wake up one consumer " -"thread." +"To choose between :meth:`~Condition.notify` " +"and :meth:`~Condition.notify_all`, consider whether one state change can be " +"interesting for only one or several waiting threads. E.g. in a typical " +"producer-consumer situation, adding one item to the buffer only needs to " +"wake up one consumer thread." msgstr "" msgid "" @@ -1175,12 +1178,12 @@ msgid "" msgstr "" msgid "" -"When the underlying lock is an :class:`RLock`, it is not released using its :" -"meth:`release` method, since this may not actually unlock the lock when it " -"was acquired multiple times recursively. Instead, an internal interface of " -"the :class:`RLock` class is used, which really unlocks it even when it has " -"been recursively acquired several times. Another internal interface is then " -"used to restore the recursion level when the lock is reacquired." +"When the underlying lock is an :class:`RLock`, it is not released using " +"its :meth:`release` method, since this may not actually unlock the lock when " +"it was acquired multiple times recursively. Instead, an internal interface " +"of the :class:`RLock` class is used, which really unlocks it even when it " +"has been recursively acquired several times. Another internal interface is " +"then used to restore the recursion level when the lock is reacquired." msgstr "" msgid "" @@ -1222,8 +1225,8 @@ msgstr "" msgid "" "By default, wake up one thread waiting on this condition, if any. If the " -"calling thread has not acquired the lock when this method is called, a :exc:" -"`RuntimeError` is raised." +"calling thread has not acquired the lock when this method is called, " +"a :exc:`RuntimeError` is raised." msgstr "" msgid "" @@ -1245,10 +1248,10 @@ msgid "" msgstr "" msgid "" -"Wake up all threads waiting on this condition. This method acts like :meth:" -"`notify`, but wakes up all waiting threads instead of one. If the calling " -"thread has not acquired the lock when this method is called, a :exc:" -"`RuntimeError` is raised." +"Wake up all threads waiting on this condition. This method acts " +"like :meth:`notify`, but wakes up all waiting threads instead of one. If the " +"calling thread has not acquired the lock when this method is called, " +"a :exc:`RuntimeError` is raised." msgstr "" msgid "The method ``notifyAll`` is a deprecated alias for this method." @@ -1260,16 +1263,16 @@ msgstr "" msgid "" "This is one of the oldest synchronization primitives in the history of " "computer science, invented by the early Dutch computer scientist Edsger W. " -"Dijkstra (he used the names ``P()`` and ``V()`` instead of :meth:`~Semaphore." -"acquire` and :meth:`~Semaphore.release`)." +"Dijkstra (he used the names ``P()`` and ``V()`` instead " +"of :meth:`~Semaphore.acquire` and :meth:`~Semaphore.release`)." msgstr "" msgid "" -"A semaphore manages an internal counter which is decremented by each :meth:" -"`~Semaphore.acquire` call and incremented by each :meth:`~Semaphore.release` " -"call. The counter can never go below zero; when :meth:`~Semaphore.acquire` " -"finds that it is zero, it blocks, waiting until some other thread calls :" -"meth:`~Semaphore.release`." +"A semaphore manages an internal counter which is decremented by " +"each :meth:`~Semaphore.acquire` call and incremented by " +"each :meth:`~Semaphore.release` call. The counter can never go below zero; " +"when :meth:`~Semaphore.acquire` finds that it is zero, it blocks, waiting " +"until some other thread calls :meth:`~Semaphore.release`." msgstr "" msgid "" @@ -1302,10 +1305,10 @@ msgid "" msgstr "" msgid "" -"If the internal counter is zero on entry, block until awoken by a call to :" -"meth:`~Semaphore.release`. Once awoken (and the counter is greater than 0), " -"decrement the counter by 1 and return ``True``. Exactly one thread will be " -"awoken by each call to :meth:`~Semaphore.release`. The order in which " +"If the internal counter is zero on entry, block until awoken by a call " +"to :meth:`~Semaphore.release`. Once awoken (and the counter is greater than " +"0), decrement the counter by 1 and return ``True``. Exactly one thread will " +"be awoken by each call to :meth:`~Semaphore.release`. The order in which " "threads are awoken should not be relied on." msgstr "" @@ -1332,10 +1335,10 @@ msgstr "" msgid "" "Class implementing bounded semaphore objects. A bounded semaphore checks to " -"make sure its current value doesn't exceed its initial value. If it does, :" -"exc:`ValueError` is raised. In most situations semaphores are used to guard " -"resources with limited capacity. If the semaphore is released too many " -"times it's a sign of a bug. If not given, *value* defaults to 1." +"make sure its current value doesn't exceed its initial value. If it " +"does, :exc:`ValueError` is raised. In most situations semaphores are used to " +"guard resources with limited capacity. If the semaphore is released too " +"many times it's a sign of a bug. If not given, *value* defaults to 1." msgstr "" msgid ":class:`Semaphore` example" @@ -1383,16 +1386,17 @@ msgid "" msgstr "" msgid "" -"An event object manages an internal flag that can be set to true with the :" -"meth:`~Event.set` method and reset to false with the :meth:`~Event.clear` " -"method. The :meth:`~Event.wait` method blocks until the flag is true." +"An event object manages an internal flag that can be set to true with " +"the :meth:`~Event.set` method and reset to false with " +"the :meth:`~Event.clear` method. The :meth:`~Event.wait` method blocks " +"until the flag is true." msgstr "" msgid "" "Class implementing event objects. An event manages a flag that can be set " -"to true with the :meth:`~Event.set` method and reset to false with the :meth:" -"`clear` method. The :meth:`wait` method blocks until the flag is true. The " -"flag is initially false." +"to true with the :meth:`~Event.set` method and reset to false with " +"the :meth:`clear` method. The :meth:`wait` method blocks until the flag is " +"true. The flag is initially false." msgstr "" msgid "Return ``True`` if and only if the internal flag is true." @@ -1432,9 +1436,9 @@ msgstr "" msgid "" "This class represents an action that should be run only after a certain " -"amount of time has passed --- a timer. :class:`Timer` is a subclass of :" -"class:`Thread` and as such also functions as an example of creating custom " -"threads." +"amount of time has passed --- a timer. :class:`Timer` is a subclass " +"of :class:`Thread` and as such also functions as an example of creating " +"custom threads." msgstr "" msgid "" @@ -1579,8 +1583,8 @@ msgid "A boolean that is ``True`` if the barrier is in the broken state." msgstr "" msgid "" -"This exception, a subclass of :exc:`RuntimeError`, is raised when the :class:" -"`Barrier` object is reset or broken." +"This exception, a subclass of :exc:`RuntimeError`, is raised when " +"the :class:`Barrier` object is reset or broken." msgstr "" msgid "" @@ -1612,9 +1616,9 @@ msgid "" msgstr "" msgid "" -"Currently, :class:`Lock`, :class:`RLock`, :class:`Condition`, :class:" -"`Semaphore`, and :class:`BoundedSemaphore` objects may be used as :keyword:" -"`with` statement context managers." +"Currently, :class:`Lock`, :class:`RLock`, :class:`Condition`, :class:`Semaphore`, " +"and :class:`BoundedSemaphore` objects may be used as :keyword:`with` " +"statement context managers." msgstr "" msgid "trace function" diff --git a/library/time-complexity.po b/library/time-complexity.po new file mode 100644 index 0000000000..39c2a3d721 --- /dev/null +++ b/library/time-complexity.po @@ -0,0 +1,473 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001 Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.14\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-09-03 18:21+0000\n" +"PO-Revision-Date: 2026-09-03 18:23+0000\n" +"Last-Translator: python-doc bot, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Time complexity of operations on built-in types" +msgstr "" + +msgid "" +"This page documents the time complexity of various operations on built-in " +"types in CPython. Other Python implementations may have different " +"performance characteristics. Additionally, the listed costs assume exact " +"built-in types, as instances of subclasses may have different costs." +msgstr "" + +msgid "" +"We use |big O notation|_ to describe how the running time of an operation " +"grows with the size of its inputs. Unless stated otherwise, *n* denotes the " +"number of elements currently in the container, and *k* is the value of a " +"numeric parameter, such as an index or a repeat count." +msgstr "" + +msgid ":class:`!list`" +msgstr "" + +msgid "" +"Lists are mutable sequences; for more detail on the implementation " +"see :ref:`how-are-lists-implemented`. The largest costs come from growing " +"beyond the current allocation size (because everything must move), or from " +"inserting or deleting somewhere near the beginning (because everything after " +"that must move). If you need to add or remove at both ends, consider using " +"a :class:`collections.deque` instead." +msgstr "" + +msgid "Operation" +msgstr "" + +msgid "Complexity" +msgstr "" + +msgid "Copy (``l.copy()``)" +msgstr "" + +msgid "*O*\\ (*n*)" +msgstr "" + +msgid "Append (``l.append(x)``) [1]_" +msgstr "" + +msgid "*O*\\ (1)" +msgstr "" + +msgid "Pop (``l.pop(k)``) [1]_ [2]_" +msgstr "" + +msgid "*O*\\ (*n* - *k*)" +msgstr "" + +msgid "Insert (``l.insert(k, x)``) [1]_ [2]_" +msgstr "" + +msgid "Get item (``l[k]``)" +msgstr "" + +msgid "Set item (``l[k] = x``)" +msgstr "" + +msgid "Delete item (``del l[k]``) [2]_" +msgstr "" + +msgid "Iteration" +msgstr "Iteracja" + +msgid "Get slice (``l[i:j]``)" +msgstr "" + +msgid "*O*\\ (*j* - *i*)" +msgstr "" + +msgid "Set slice (``l[i:j] = t``) [1]_" +msgstr "" + +msgid "" +"*O*\\ (*j* - *i*) if len(*t*) == *j* - *i*, otherwise *O*\\ (*n* - *i* + " +"len(*t*))" +msgstr "" + +msgid "Delete slice (``del l[i:j]``)" +msgstr "" + +msgid "*O*\\ (*n* - *i*)" +msgstr "" + +msgid "Extend (``l.extend(t)``) [1]_ [3]_" +msgstr "" + +msgid "*O*\\ (len(*t*))" +msgstr "" + +msgid "Sort (``l.sort()``) [4]_" +msgstr "" + +msgid "*O*\\ (*n* log *n*)" +msgstr "" + +msgid "Concatenate (``l1 + l2``)" +msgstr "" + +msgid "*O*\\ (len(*l1*) + len(*l2*))" +msgstr "" + +msgid "Multiply (``l * k``)" +msgstr "" + +msgid "*O*\\ (*nk*)" +msgstr "" + +msgid "``x in l``" +msgstr "" + +msgid "``min(l)``, ``max(l)``" +msgstr "" + +msgid "Get length (``len(l)``) [5]_" +msgstr "" + +msgid ":class:`!tuple`" +msgstr "" + +msgid "" +"A :class:`tuple` is an :term:`immutable` sequence. Because a tuple can never " +"change, there are no insertion or deletion costs, and making a copy simply " +"returns the same object, so is constant time (*O*\\ (1))." +msgstr "" + +msgid "Copy (``tuple(t)``)" +msgstr "" + +msgid "Get item (``t[k]``)" +msgstr "" + +msgid "Get slice (``t[i:j]``)" +msgstr "" + +msgid "Concatenate (``t1 + t2``)" +msgstr "" + +msgid "*O*\\ (len(*t1*) + len(*t2*))" +msgstr "" + +msgid "Multiply (``t * k``)" +msgstr "" + +msgid "``x in t``" +msgstr "" + +msgid "``min(t)``, ``max(t)``" +msgstr "" + +msgid "Get length (``len(t)``) [5]_" +msgstr "" + +msgid ":class:`!dict`" +msgstr "" + +msgid "" +"The times listed for dict objects are average-case times, as they assume the " +"hash function for the objects is sufficiently robust to make collisions " +"uncommon. They also assume the keys are well-distributed among the set of " +"possible keys. In the worst case, when every key hashes to the same value, " +"each of the *O*\\ (1) operations below instead takes *O*\\ (*n*) time. They " +"also assume that hashing and comparing a key is *O*\\ (1). For more detail " +"on the implementation, see :ref:`how-are-dictionaries-implemented`." +msgstr "" + +msgid "``key in d``" +msgstr "" + +msgid "Copy (``d.copy()``) [7]_" +msgstr "" + +msgid "Get item (``d[key]``, ``d.get(key)``)" +msgstr "" + +msgid "Set item (``d[key] = value``) [1]_" +msgstr "" + +msgid "Delete item (``del d[key]``, ``d.pop(key)``)" +msgstr "" + +msgid "Update (``d.update(t)``, ``d |= t``) [1]_ [3]_ [7]_" +msgstr "" + +msgid "Iteration [7]_" +msgstr "" + +msgid "Get length (``len(d)``) [5]_" +msgstr "" + +msgid ":class:`!set`, :class:`!frozenset`" +msgstr "" + +msgid "" +"See :class:`dict` as the :class:`set` and :class:`frozenset` implementations " +"are similar, and the same caveats apply. In the worst case, *O*\\ (1) " +"operations instead take *O*\\ (*n*) time, and operations that look up every " +"element degrade accordingly." +msgstr "" + +msgid "" +"A :class:`frozenset` is :term:`immutable`, so it does not support adding, " +"discarding, or the in-place update operations. The others below apply to it " +"at the same costs." +msgstr "" + +msgid "``x in s``" +msgstr "``x in s``" + +msgid "Copy (``s.copy()``) [6]_ [7]_" +msgstr "" + +msgid "Add (``s.add(x)``) [1]_" +msgstr "" + +msgid "Discard (``s.discard(x)``, ``s.remove(x)``)" +msgstr "" + +msgid "Union (``s1 | s2``, ``s1.union(s2)``) [7]_" +msgstr "" + +msgid "*O*\\ (len(*s1*) + len(*s2*))" +msgstr "" + +msgid "Update (``s1 |= s2``, ``s1.update(s2)``) [1]_ [7]_" +msgstr "" + +msgid "*O*\\ (len(*s2*))" +msgstr "" + +msgid "Intersection (``s1 & s2``, ``s1.intersection(s2)``) [7]_ [8]_" +msgstr "" + +msgid "*O*\\ (min(len(*s1*), len(*s2*)))" +msgstr "" + +msgid "" +"Intersection update (``s1 &= s2``, ``s1.intersection_update(s2)``) [1]_ [7]_ " +"[8]_" +msgstr "" + +msgid "Difference (``s1 - s2``, ``s1.difference(s2)``) [7]_ [9]_" +msgstr "" + +msgid "*O*\\ (len(*s1*))" +msgstr "" + +msgid "" +"Difference update (``s1 -= s2``, ``s1.difference_update(s2)``) [1]_ [7]_ [8]_" +msgstr "" + +msgid "" +"Symmetric difference (``s1 ^ s2``, ``s1.symmetric_difference(s2)``) [7]_" +msgstr "" + +msgid "" +"Symmetric difference update (``s1 ^= s2``, " +"``s1.symmetric_difference_update(s2)``) [1]_ [7]_" +msgstr "" + +msgid "Get length (``len(s)``) [5]_" +msgstr "" + +msgid ":class:`!str`, :class:`!bytes`, :class:`!bytearray`" +msgstr "" + +msgid "" +":class:`str` and :class:`bytes` objects are immutable sequences of " +"characters and bytes, respectively. As with tuples, copying one returns the " +"original object. A :class:`bytearray` is mutable, and additionally supports " +"the mutating operations of :class:`list` (except :meth:`!sort`), at the same " +"costs. However, deleting at the front with ``del`` (``del b[0]``, ``del " +"b[:k]``) only advances the start of the buffer instead of moving the " +"remaining bytes, and is amortized *O*\\ (1)." +msgstr "" + +msgid "Get item (``s[k]``)" +msgstr "" + +msgid "Get slice (``s[i:j]``)" +msgstr "" + +msgid "Concatenate (``s + t``) [10]_" +msgstr "" + +msgid "*O*\\ (len(*s*) + len(*t*))" +msgstr "" + +msgid "Multiply (``s * k``)" +msgstr "" + +msgid "Substring search (``x in s``, ``s.find(x)``, ``s.index(x)``) [11]_" +msgstr "" + +msgid "Reverse substring search (``s.rfind(x)``, ``s.rindex(x)``) [11]_ [12]_" +msgstr "" + +msgid "*O*\\ (*n* × len(*x*))" +msgstr "" + +msgid "Encode or decode [13]_" +msgstr "" + +msgid ":class:`!memoryview`" +msgstr "" + +msgid "" +":class:`memoryview` objects allow Python code to access the internal data of " +"an object that supports the :ref:`buffer protocol ` without " +"copying. In particular, slicing a memory view returns a new view onto the " +"same buffer." +msgstr "" + +msgid "Create (``memoryview(obj)``)" +msgstr "" + +msgid "Get item (``v[k]``)" +msgstr "" + +msgid "Get slice (``v[i:j]``)" +msgstr "" + +msgid "Index (``v.index(x)``) [11]_ [14]_" +msgstr "" + +msgid "Count (``v.count(x)``) [14]_" +msgstr "" + +msgid "Convert to bytes (``v.tobytes()``, ``bytes(v)``)" +msgstr "" + +msgid "Get length (``len(v)``) [5]_" +msgstr "" + +msgid ":class:`!range`" +msgstr "" + +msgid "" +"A :class:`range` object computes its items on demand from its *start*, " +"*stop* and *step* values, so most operations do not depend on the length of " +"the range." +msgstr "" + +msgid "Get item (``r[k]``)" +msgstr "" + +msgid "Get slice (``r[i:j]``)" +msgstr "" + +msgid "``x in r`` [15]_" +msgstr "" + +msgid "Index and count (``r.index(x)``, ``r.count(x)``) [15]_" +msgstr "" + +msgid "``min(r)``, ``max(r)``" +msgstr "" + +msgid "Get length (``len(r)``) [5]_" +msgstr "" + +msgid "Notes" +msgstr "Notatki" + +msgid "" +"Amortized. An individual operation may occasionally be *O*\\ (*n*) when the " +"underlying storage is resized, but this cost is spread over many operations, " +"depending on the history of the container." +msgstr "" + +msgid "" +"Popping or deleting the element at index *k* of a list of size *n* shifts " +"all elements after *k* one slot to the left, moving *n* - *k* - 1 elements; " +"inserting at index *k* shifts the elements from *k* onwards one slot to the " +"right, moving *n* - *k* elements. The worst case is index 0, where the whole " +"rest of the list has to be moved; the average case, an index in the middle " +"of the list, takes *O*\\ (*n*/2) = *O*\\ (*n*) operations; and operating at " +"the end of the list moves nothing and is *O*\\ (1)." +msgstr "" + +msgid "" +"Plus the cost of iterating over *t*, which may be expensive for an arbitrary " +"iterable." +msgstr "" + +msgid "" +"This is the worst case scenario. Sorting is adaptive and input that is " +"already sorted or reverse-sorted takes only *O*\\ (*n*) comparisons. " +"See :source:`Objects/listsort.txt` for more information." +msgstr "" + +msgid "" +"The number of elements is stored in the object, so ``len()`` does not need " +"to count them." +msgstr "" + +msgid "" +"Copying a :class:`frozenset` is *O*\\ (1) as it returns the original object." +msgstr "" + +msgid "" +"These operations scan the container's internal hash table, which is not " +"shrunk when elements are removed. After removing most elements, they still " +"take time proportional to the container's former size, until a later " +"insertion triggers a resize." +msgstr "" + +msgid "*O*\\ (len(*t*)) if *t* is not a set." +msgstr "" + +msgid "*O*\\ (len(*s*) + len(*t*)) if *t* is not a set." +msgstr "" + +msgid "" +"Each concatenation builds a new object, so building a string by " +"concatenating many pieces in a loop is quadratic in the total length. See " +"the :ref:`note on concatenating immutable sequences ` for alternatives." +msgstr "" + +msgid "" +"With *start* and *end* arguments, *n* is the length of the region searched " +"rather than of *s*, and unlike slicing nothing is copied." +msgstr "" + +msgid "" +"This is the worst case. Reverse searches are *O*\\ (*n*) on typical input. " +"Forward searches instead use a more elaborate algorithm with a linear worst " +"case, described in :source:`Objects/stringlib/" +"stringlib_find_two_way_notes.txt`." +msgstr "" + +msgid "This assumes a codec that does a constant amount of work per character." +msgstr "" + +msgid "" +"These unpack and compare each element individually, so they are much slower " +"than the equivalent :class:`bytes` methods." +msgstr "" + +msgid "" +"Assuming :class:`int` or :class:`bool` arguments. For other types, the range " +"is searched like any other sequence in *O*\\ (*n*) time." +msgstr "" diff --git a/library/time.po b/library/time.po index 27673d4eed..6899b9ece9 100644 --- a/library/time.po +++ b/library/time.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-17 14:50+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-27 20:01+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -90,32 +90,32 @@ msgstr "" msgid "" "On the other hand, the precision of :func:`.time` and :func:`sleep` is " "better than their Unix equivalents: times are expressed as floating-point " -"numbers, :func:`.time` returns the most accurate time available (using Unix :" -"c:func:`!gettimeofday` where available), and :func:`sleep` will accept a " -"time with a nonzero fraction (Unix :c:func:`!select` is used to implement " +"numbers, :func:`.time` returns the most accurate time available (using " +"Unix :c:func:`!gettimeofday` where available), and :func:`sleep` will accept " +"a time with a nonzero fraction (Unix :c:func:`!select` is used to implement " "this, where available)." msgstr "" msgid "" -"The time value as returned by :func:`gmtime`, :func:`localtime`, and :func:" -"`strptime`, and accepted by :func:`asctime`, :func:`mktime` and :func:" -"`strftime`, is a sequence of 9 integers. The return values of :func:" -"`gmtime`, :func:`localtime`, and :func:`strptime` also offer attribute names " -"for individual fields." +"The time value as returned by :func:`gmtime`, :func:`localtime`, " +"and :func:`strptime`, and accepted by :func:`asctime`, :func:`mktime` " +"and :func:`strftime`, is a sequence of 9 integers. The return values " +"of :func:`gmtime`, :func:`localtime`, and :func:`strptime` also offer " +"attribute names for individual fields." msgstr "" msgid "See :class:`struct_time` for a description of these objects." msgstr "" msgid "" -"The :class:`struct_time` type was extended to provide the :attr:" -"`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` attributes when " -"platform supports corresponding ``struct tm`` members." +"The :class:`struct_time` type was extended to provide " +"the :attr:`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` " +"attributes when platform supports corresponding ``struct tm`` members." msgstr "" msgid "" -"The :class:`struct_time` attributes :attr:`~struct_time.tm_gmtoff` and :attr:" -"`~struct_time.tm_zone` are now available on all platforms." +"The :class:`struct_time` attributes :attr:`~struct_time.tm_gmtoff` " +"and :attr:`~struct_time.tm_zone` are now available on all platforms." msgstr "" msgid "Use the following functions to convert between time representations:" @@ -155,15 +155,17 @@ msgid "Functions" msgstr "Zadania" msgid "" -"Convert a tuple or :class:`struct_time` representing a time as returned by :" -"func:`gmtime` or :func:`localtime` to a string of the following form: ``'Sun " -"Jun 20 23:21:05 1993'``. The day field is two characters long and is space " -"padded if the day is a single digit, e.g.: ``'Wed Jun 9 04:26:40 1993'``." +"Convert a tuple or :class:`struct_time` representing a time as returned " +"by :func:`gmtime` or :func:`localtime` to a string of the following form: " +"``'Sun Jun 20 23:21:05 1993'``. The day field is two characters long and is " +"space padded if the day is a single digit, for example: ``'Wed Jun 9 " +"04:26:40 1993'``." msgstr "" msgid "" -"If *t* is not provided, the current time as returned by :func:`localtime` is " -"used. Locale information is not used by :func:`asctime`." +"If *time_tuple* is not provided, the current time as returned " +"by :func:`localtime` is used. Locale information is not used " +"by :func:`asctime`." msgstr "" msgid "" @@ -206,21 +208,21 @@ msgid "" msgstr "" msgid "" -"Use :func:`clock_gettime_ns` to avoid the precision loss caused by the :" -"class:`float` type." +"Use :func:`clock_gettime_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Similar to :func:`clock_gettime` but return time as nanoseconds." msgstr "" msgid "" -"Set the time of the specified clock *clk_id*. Currently, :data:" -"`CLOCK_REALTIME` is the only accepted value for *clk_id*." +"Set the time of the specified clock *clk_id*. " +"Currently, :data:`CLOCK_REALTIME` is the only accepted value for *clk_id*." msgstr "" msgid "" -"Use :func:`clock_settime_ns` to avoid the precision loss caused by the :" -"class:`float` type." +"Use :func:`clock_settime_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Similar to :func:`clock_settime` but set time with nanoseconds." @@ -229,15 +231,15 @@ msgstr "" msgid "" "Convert a time expressed in seconds since the epoch_ to a string of a form: " "``'Sun Jun 20 23:21:05 1993'`` representing local time. The day field is two " -"characters long and is space padded if the day is a single digit, e.g.: " -"``'Wed Jun 9 04:26:40 1993'``." +"characters long and is space padded if the day is a single digit, for " +"example: ``'Wed Jun 9 04:26:40 1993'``." msgstr "" msgid "" -"If *secs* is not provided or :const:`None`, the current time as returned by :" -"func:`.time` is used. ``ctime(secs)`` is equivalent to " -"``asctime(localtime(secs))``. Locale information is not used by :func:" -"`ctime`." +"If *seconds* is not provided or :const:`None`, the current time as returned " +"by :func:`.time` is used. ``ctime(seconds)`` is equivalent to " +"``asctime(localtime(seconds))``. Locale information is not used " +"by :func:`ctime`." msgstr "" msgid "" @@ -281,35 +283,35 @@ msgid "*resolution*: The resolution of the clock in seconds (:class:`float`)" msgstr "" msgid "" -"Convert a time expressed in seconds since the epoch_ to a :class:" -"`struct_time` in UTC in which the dst flag is always zero. If *secs* is not " -"provided or :const:`None`, the current time as returned by :func:`.time` is " -"used. Fractions of a second are ignored. See above for a description of " -"the :class:`struct_time` object. See :func:`calendar.timegm` for the inverse " -"of this function." +"Convert a time expressed in seconds since the epoch_ to " +"a :class:`struct_time` in UTC in which the dst flag is always zero. If " +"*seconds* is not provided or :const:`None`, the current time as returned " +"by :func:`.time` is used. Fractions of a second are ignored. See above for " +"a description of the :class:`struct_time` object. " +"See :func:`calendar.timegm` for the inverse of this function." msgstr "" msgid "" -"Like :func:`gmtime` but converts to local time. If *secs* is not provided " -"or :const:`None`, the current time as returned by :func:`.time` is used. " -"The dst flag is set to ``1`` when DST applies to the given time." +"Like :func:`gmtime` but converts to local time. If *seconds* is not provided " +"or :const:`None`, the current time as returned by :func:`.time` is used. The " +"dst flag is set to ``1`` when DST applies to the given time." msgstr "" msgid "" ":func:`localtime` may raise :exc:`OverflowError`, if the timestamp is " "outside the range of values supported by the platform C :c:func:`localtime` " -"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` or :" -"c:func:`gmtime` failure. It's common for this to be restricted to years " +"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` " +"or :c:func:`gmtime` failure. It's common for this to be restricted to years " "between 1970 and 2038." msgstr "" msgid "" -"This is the inverse function of :func:`localtime`. Its argument is the :" -"class:`struct_time` or full 9-tuple (since the dst flag is needed; use " +"This is the inverse function of :func:`localtime`. Its argument is " +"the :class:`struct_time` or full 9-tuple (since the dst flag is needed; use " "``-1`` as the dst flag if it is unknown) which expresses the time in *local* " -"time, not UTC. It returns a floating-point number, for compatibility with :" -"func:`.time`. If the input value cannot be represented as a valid time, " -"either :exc:`OverflowError` or :exc:`ValueError` will be raised (which " +"time, not UTC. It returns a floating-point number, for compatibility " +"with :func:`.time`. If the input value cannot be represented as a valid " +"time, either :exc:`OverflowError` or :exc:`ValueError` will be raised (which " "depends on whether the invalid value is caught by Python or the underlying C " "libraries). The earliest date for which it can generate a time is platform-" "dependent." @@ -343,8 +345,8 @@ msgid "Otherwise, call ``clock_gettime(CLOCK_MONOTONIC)``." msgstr "" msgid "" -"Use :func:`monotonic_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`monotonic_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "" @@ -372,8 +374,8 @@ msgid "" msgstr "" msgid "" -"Use :func:`perf_counter_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`perf_counter_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "On Windows, the clock is now the same for all processes." @@ -394,8 +396,8 @@ msgid "" msgstr "" msgid "" -"Use :func:`process_time_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`process_time_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Similar to :func:`process_time` but return time as nanoseconds." @@ -421,13 +423,13 @@ msgid "Windows implementation" msgstr "" msgid "" -"On Windows, if *secs* is zero, the thread relinquishes the remainder of its " -"time slice to any other thread that is ready to run. If there are no other " -"threads ready to run, the function returns immediately, and the thread " -"continues execution. On Windows 10 and newer the implementation uses a " -"`high-resolution timer `_ which provides resolution of " -"100 nanoseconds. If *secs* is zero, ``Sleep(0)`` is used." +"On Windows, if *seconds* is zero, the thread relinquishes the remainder of " +"its time slice to any other thread that is ready to run. If there are no " +"other threads ready to run, the function returns immediately, and the thread " +"continues execution. On Windows 10 and newer the implementation uses a `high-" +"resolution timer `_ which provides resolution of 100 " +"nanoseconds. If *seconds* is zero, ``Sleep(0)`` is used." msgstr "" msgid "Unix implementation" @@ -453,13 +455,13 @@ msgstr "" msgid "" "Raises an :ref:`auditing event ` ``time.sleep`` with argument " -"``secs``." +"``seconds``." msgstr "" msgid "" -"The function now sleeps at least *secs* even if the sleep is interrupted by " -"a signal, except if the signal handler raises an exception (see :pep:`475` " -"for the rationale)." +"The function now sleeps at least *seconds* even if the sleep is interrupted " +"by a signal, except if the signal handler raises an exception " +"(see :pep:`475` for the rationale)." msgstr "" msgid "" @@ -471,11 +473,12 @@ msgid "Raises an auditing event." msgstr "" msgid "" -"Convert a tuple or :class:`struct_time` representing a time as returned by :" -"func:`gmtime` or :func:`localtime` to a string as specified by the *format* " -"argument. If *t* is not provided, the current time as returned by :func:" -"`localtime` is used. *format* must be a string. :exc:`ValueError` is " -"raised if any field in *t* is outside of the allowed range." +"Convert a tuple or :class:`struct_time` representing a time as returned " +"by :func:`gmtime` or :func:`localtime` to a string as specified by the " +"*format* argument. If *time_tuple* is not provided, the current time as " +"returned by :func:`localtime` is used. *format* must be a " +"string. :exc:`ValueError` is raised if any field in *time_tuple* is outside " +"of the allowed range." msgstr "" msgid "" @@ -537,10 +540,7 @@ msgstr "" msgid "``%f``" msgstr "``%f``" -msgid "Microseconds as a decimal number" -msgstr "" - -msgid "[000000,999999]." +msgid "Microseconds as a decimal number [000000,999999]." msgstr "" msgid "\\(1)" @@ -694,10 +694,10 @@ msgid "Notes:" msgstr "Uwagi:" msgid "" -"The ``%f`` format directive only applies to :func:`strptime`, not to :func:" -"`strftime`. However, see also :meth:`datetime.datetime.strptime` and :meth:" -"`datetime.datetime.strftime` where the ``%f`` format directive :ref:`applies " -"to microseconds `." +"The ``%f`` format directive only applies to :func:`strptime`, not " +"to :func:`strftime`. However, see also :meth:`datetime.datetime.strptime` " +"and :meth:`datetime.datetime.strftime` where the ``%f`` format " +"directive :ref:`applies to microseconds `." msgstr "" msgid "" @@ -731,8 +731,8 @@ msgstr "" msgid "" "Additional directives may be supported on certain platforms, but only the " "ones listed here have a meaning standardized by ANSI C. To see the full set " -"of format codes supported on your platform, consult the :manpage:" -"`strftime(3)` documentation." +"of format codes supported on your platform, consult " +"the :manpage:`strftime(3)` documentation." msgstr "" msgid "" @@ -748,13 +748,13 @@ msgid "" msgstr "" msgid "" -"The *format* parameter uses the same directives as those used by :func:" -"`strftime`; it defaults to ``\"%a %b %d %H:%M:%S %Y\"`` which matches the " -"formatting returned by :func:`ctime`. If *string* cannot be parsed according " -"to *format*, or if it has excess data after parsing, :exc:`ValueError` is " -"raised. The default values used to fill in any missing data when more " -"accurate values cannot be inferred are ``(1900, 1, 1, 0, 0, 0, 0, 1, -1)``. " -"Both *string* and *format* must be strings." +"The *format* parameter uses the same directives as those used " +"by :func:`strftime`; it defaults to ``\"%a %b %d %H:%M:%S %Y\"`` which " +"matches the formatting returned by :func:`ctime`. If *string* cannot be " +"parsed according to *format*, or if it has excess data after " +"parsing, :exc:`ValueError` is raised. The default values used to fill in any " +"missing data when more accurate values cannot be inferred are ``(1900, 1, 1, " +"0, 0, 0, 0, 1, -1)``. Both *string* and *format* must be strings." msgstr "" msgid "For example:" @@ -776,10 +776,10 @@ msgid "" msgstr "" msgid "" -"The type of the time value sequence returned by :func:`gmtime`, :func:" -"`localtime`, and :func:`strptime`. It is an object with a :term:`named " -"tuple` interface: values can be accessed by index and by attribute name. " -"The following values are present:" +"The type of the time value sequence returned " +"by :func:`gmtime`, :func:`localtime`, and :func:`strptime`. It is an object " +"with a :term:`named tuple` interface: values can be accessed by index and by " +"attribute name. The following values are present:" msgstr "" msgid "Index" @@ -867,17 +867,17 @@ msgid "" msgstr "" msgid "" -"When a tuple with an incorrect length is passed to a function expecting a :" -"class:`struct_time`, or having elements of the wrong type, a :exc:" -"`TypeError` is raised." +"When a tuple with an incorrect length is passed to a function expecting " +"a :class:`struct_time`, or having elements of the wrong type, " +"a :exc:`TypeError` is raised." msgstr "" msgid "" "Return the time in seconds since the epoch_ as a floating-point number. The " "handling of `leap seconds`_ is platform dependent. On Windows and most Unix " "systems, the leap seconds are not counted towards the time in seconds since " -"the epoch_. This is commonly referred to as `Unix time `_." +"the epoch_. This is commonly referred to as `Unix time `_." msgstr "" msgid "" @@ -890,11 +890,11 @@ msgstr "" msgid "" "The number returned by :func:`.time` may be converted into a more common " -"time format (i.e. year, month, day, hour, etc...) in UTC by passing it to :" -"func:`gmtime` function or in local time by passing it to the :func:" -"`localtime` function. In both cases a :class:`struct_time` object is " -"returned, from which the components of the calendar date may be accessed as " -"attributes." +"time format (i.e. year, month, day, hour, etc...) in UTC by passing it " +"to :func:`gmtime` function or in local time by passing it to " +"the :func:`localtime` function. In both cases a :class:`struct_time` object " +"is returned, from which the components of the calendar date may be accessed " +"as attributes." msgstr "" msgid "On Windows, call ``GetSystemTimePreciseAsFileTime()``." @@ -930,8 +930,8 @@ msgid "" msgstr "" msgid "" -"Use :func:`thread_time_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`thread_time_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Unix systems supporting ``CLOCK_THREAD_CPUTIME_ID``." @@ -952,8 +952,8 @@ msgstr "" msgid "" "Although in many cases, changing the :envvar:`TZ` environment variable may " -"affect the output of functions like :func:`localtime` without calling :func:" -"`tzset`, this behavior should not be relied on." +"affect the output of functions like :func:`localtime` without " +"calling :func:`tzset`, this behavior should not be relied on." msgstr "" msgid "The :envvar:`TZ` environment variable should contain no whitespace." @@ -1063,8 +1063,8 @@ msgid "Clock ID Constants" msgstr "" msgid "" -"These constants are used as parameters for :func:`clock_getres` and :func:" -"`clock_gettime`." +"These constants are used as parameters for :func:`clock_getres` " +"and :func:`clock_gettime`." msgstr "" msgid "" @@ -1133,8 +1133,8 @@ msgid "" msgstr "" msgid "" -"The following constant is the only parameter that can be sent to :func:" -"`clock_settime`." +"The following constant is the only parameter that can be sent " +"to :func:`clock_settime`." msgstr "" msgid "" @@ -1168,12 +1168,13 @@ msgid "" msgstr "" msgid "" -"For the above Timezone constants (:data:`altzone`, :data:`daylight`, :data:" -"`timezone`, and :data:`tzname`), the value is determined by the timezone " -"rules in effect at module load time or the last time :func:`tzset` is called " -"and may be incorrect for times in the past. It is recommended to use the :" -"attr:`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` results from :" -"func:`localtime` to obtain timezone information." +"For the above Timezone constants " +"(:data:`altzone`, :data:`daylight`, :data:`timezone`, and :data:`tzname`), " +"the value is determined by the timezone rules in effect at module load time " +"or the last time :func:`tzset` is called and may be incorrect for times in " +"the past. It is recommended to use the :attr:`~struct_time.tm_gmtoff` " +"and :attr:`~struct_time.tm_zone` results from :func:`localtime` to obtain " +"timezone information." msgstr "" msgid "Module :mod:`datetime`" @@ -1187,8 +1188,8 @@ msgstr "" msgid "" "Internationalization services. The locale setting affects the " -"interpretation of many format specifiers in :func:`strftime` and :func:" -"`strptime`." +"interpretation of many format specifiers in :func:`strftime` " +"and :func:`strptime`." msgstr "" msgid "Module :mod:`calendar`" diff --git a/library/timeit.po b/library/timeit.po index 3af7701a11..d4708c3e04 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -79,8 +79,8 @@ msgstr "" msgid "" "Note however that :func:`.timeit` will automatically determine the number of " -"repetitions only when the command-line interface is used. In the :ref:" -"`timeit-examples` section you can find more advanced examples." +"repetitions only when the command-line interface is used. In " +"the :ref:`timeit-examples` section you can find more advanced examples." msgstr "" msgid "Python Interface" @@ -131,9 +131,9 @@ msgid "" msgstr "" msgid "" -"To measure the execution time of the first statement, use the :meth:`." -"timeit` method. The :meth:`.repeat` and :meth:`.autorange` methods are " -"convenience methods to call :meth:`.timeit` multiple times." +"To measure the execution time of the first statement, use " +"the :meth:`.timeit` method. The :meth:`.repeat` and :meth:`.autorange` " +"methods are convenience methods to call :meth:`.timeit` multiple times." msgstr "" msgid "" @@ -281,8 +281,8 @@ msgstr "" msgid "" ":func:`default_timer` measurements can be affected by other programs running " "on the same machine, so the best thing to do when accurate timing is " -"necessary is to repeat the timing a few times and use the best time. The :" -"option:`-r` option is good for this; the default of 5 repetitions is " +"necessary is to repeat the timing a few times and use the best time. " +"The :option:`-r` option is good for this; the default of 5 repetitions is " "probably enough in most cases. You can use :func:`time.process_time` to " "measure CPU time." msgstr "" @@ -306,8 +306,8 @@ msgid "" "$ python -m timeit -s \"text = 'sample string'; char = 'g'\" \"char in " "text\"\n" "5000000 loops, best of 5: 0.0877 usec per loop\n" -"$ python -m timeit -s \"text = 'sample string'; char = 'g'\" \"text." -"find(char)\"\n" +"$ python -m timeit -s \"text = 'sample string'; char = 'g'\" " +"\"text.find(char)\"\n" "1000000 loops, best of 5: 0.342 usec per loop" msgstr "" @@ -346,8 +346,9 @@ msgstr "" msgid "" "The following examples show how to time expressions that contain multiple " -"lines. Here we compare the cost of using :func:`hasattr` vs. :keyword:`try`/:" -"keyword:`except` to test for missing and present object attributes:" +"lines. Here we compare the cost of using :func:`hasattr` " +"vs. :keyword:`try`/:keyword:`except` to test for missing and present object " +"attributes:" msgstr "" msgid "" diff --git a/library/tk.po b/library/tk.po index d7b862c20a..1d9b6da128 100644 --- a/library/tk.po +++ b/library/tk.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-23 15:47+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,16 +29,16 @@ msgstr "" msgid "" "Tk/Tcl has long been an integral part of Python. It provides a robust and " "platform independent windowing toolkit, that is available to Python " -"programmers using the :mod:`tkinter` package, and its extension, the :mod:" -"`tkinter.ttk` module." +"programmers using the :mod:`tkinter` package, and its extension, " +"the :mod:`tkinter.ttk` module." msgstr "" msgid "" "The :mod:`tkinter` package is a thin object-oriented layer on top of Tcl/Tk. " "To use :mod:`tkinter`, you don't need to write Tcl code, but you will need " -"to consult the Tk documentation, and occasionally the Tcl documentation. :" -"mod:`tkinter` is a set of wrappers that implement the Tk widgets as Python " -"classes." +"to consult the Tk documentation, and occasionally the Tcl " +"documentation. :mod:`tkinter` is a set of wrappers that implement the Tk " +"widgets as Python classes." msgstr "" msgid "" diff --git a/library/tkinter.colorchooser.po b/library/tkinter.colorchooser.po index dc9c532f1b..f09daf54bf 100644 --- a/library/tkinter.colorchooser.po +++ b/library/tkinter.colorchooser.po @@ -32,8 +32,8 @@ msgstr "" msgid "" "The :mod:`tkinter.colorchooser` module provides the :class:`Chooser` class " "as an interface to the native color picker dialog. ``Chooser`` implements a " -"modal color choosing dialog window. The ``Chooser`` class inherits from the :" -"class:`~tkinter.commondialog.Dialog` class." +"modal color choosing dialog window. The ``Chooser`` class inherits from " +"the :class:`~tkinter.commondialog.Dialog` class." msgstr "" msgid "" diff --git a/library/tkinter.dnd.po b/library/tkinter.dnd.po index 685e1767a5..b3ee77e76c 100644 --- a/library/tkinter.dnd.po +++ b/library/tkinter.dnd.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-19 14:37+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -40,39 +40,40 @@ msgid "" "enable an object to be dragged, you must create an event binding for it that " "starts the drag-and-drop process. Typically, you bind a ButtonPress event to " "a callback function that you write (see :ref:`Bindings-and-Events`). The " -"function should call :func:`dnd_start`, where 'source' is the object to be " -"dragged, and 'event' is the event that invoked the call (the argument to " +"function should call :func:`dnd_start`, where *source* is the object to be " +"dragged, and *event* is the event that invoked the call (the argument to " "your callback function)." msgstr "" msgid "Selection of a target object occurs as follows:" msgstr "" -msgid "Top-down search of area under mouse for target widget" +msgid "Top-down search of the area under the mouse for a target widget:" msgstr "" -msgid "Target widget should have a callable *dnd_accept* attribute" +msgid "the target widget should have a callable *dnd_accept* attribute;" msgstr "" msgid "" -"If *dnd_accept* is not present or returns ``None``, search moves to parent " -"widget" +"if *dnd_accept* is not present or returns ``None``, the search moves to the " +"parent widget;" msgstr "" -msgid "If no target widget is found, then the target object is ``None``" +msgid "if no target widget is found, the target object is ``None``." msgstr "" -msgid "Call to *.dnd_leave(source, event)*" +msgid "Call to ``.dnd_leave(source, event)``." msgstr "" -msgid "Call to *.dnd_enter(source, event)*" +msgid "Call to ``.dnd_enter(source, event)``." msgstr "" -msgid "Call to *.dnd_commit(source, event)* to notify of drop" +msgid "Call to ``.dnd_commit(source, event)`` to notify of the drop." msgstr "" msgid "" -"Call to *.dnd_end(target, event)* to signal end of drag-and-drop" +"Call to ``.dnd_end(target, event)`` to signal the end of drag-and-" +"drop." msgstr "" msgid "" @@ -86,13 +87,16 @@ msgstr "" msgid "Execute end of drag-and-drop functions." msgstr "" -msgid "Inspect area below mouse for target objects while drag is performed." +msgid "Inspect area below mouse for target objects while a drag is performed." msgstr "" msgid "Signal end of drag when the release pattern is triggered." msgstr "" -msgid "Factory function for drag-and-drop process." +msgid "" +"Factory function for the drag-and-drop process. Return " +"the :class:`DndHandler` instance managing the drag, or ``None`` if a drag " +"could not be started." msgstr "" msgid ":ref:`Bindings-and-Events`" diff --git a/library/tkinter.po b/library/tkinter.po index a24a2a9b14..b6830e7abd 100644 --- a/library/tkinter.po +++ b/library/tkinter.po @@ -4,17 +4,18 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 -# Maciej Olko , 2025 +# Rafael Fontenelle , 2026 +# python-doc bot, 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 20:31+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -47,9 +48,12 @@ msgstr "" msgid "" "Tkinter supports a range of Tcl/Tk versions, built either with or without " -"thread support. The official Python binary release bundles Tcl/Tk 8.6 " -"threaded. See the source code for the :mod:`_tkinter` module for more " -"information about supported versions." +"thread support. Tcl/Tk 8.5.12 is the minimum supported version; the official " +"Python binary release bundles Tcl/Tk 8.6. See the source code for " +"the :mod:`_tkinter` module for more information about supported versions." +msgstr "" + +msgid "Support for Tcl/Tk versions older than 8.5.12 was removed." msgstr "" msgid "" @@ -61,9 +65,9 @@ msgstr "" msgid "" "Tcl/Tk 8.5 (2007) introduced a modern set of themed user interface " -"components along with a new API to use them. Both old and new APIs are still " -"available. Most documentation you will find online still uses the old API " -"and can be woefully outdated." +"components along with a new API to use them (see :mod:`tkinter.ttk`). Both " +"old and new APIs are still available. Most documentation you will find " +"online still uses the old API and can be woefully outdated." msgstr "" msgid "" @@ -74,8 +78,8 @@ msgid "" msgstr "" "To jest :term:`moduł opcjonalny `. Jeśli brakuje go w " "twojej kopii CPythona, poszukaj dokumentacji od dystrybutora (czyli tego, " -"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, zobacz :ref:" -"`optional-module-requirements`." +"kto dostarczył ci Pythona). Jeśli jesteś dystrybutorem, " +"zobacz :ref:`optional-module-requirements`." msgid "`TkDocs `_" msgstr "" @@ -97,7 +101,7 @@ msgstr "" msgid "Tcl/Tk Resources:" msgstr "" -msgid "`Tk commands `_" +msgid "`Tk commands `_" msgstr "" msgid "" @@ -176,10 +180,11 @@ msgstr "" msgid "" "Tk is a `Tcl package `_ implemented in C " -"that adds custom commands to create and manipulate GUI widgets. Each :class:" -"`Tk` object embeds its own Tcl interpreter instance with Tk loaded into it. " -"Tk's widgets are very customizable, though at the cost of a dated " -"appearance. Tk uses Tcl's event queue to generate and process GUI events." +"that adds custom commands to create and manipulate GUI widgets. " +"Each :class:`Tk` object embeds its own Tcl interpreter instance with Tk " +"loaded into it. Tk's widgets are very customizable, though at the cost of a " +"dated appearance. Tk uses Tcl's event queue to generate and process GUI " +"events." msgstr "" msgid "Ttk" @@ -193,20 +198,20 @@ msgid "" msgstr "" msgid "" -"Internally, Tk and Ttk use facilities of the underlying operating system, i." -"e., Xlib on Unix/X11, Cocoa on macOS, GDI on Windows." +"Internally, Tk and Ttk use facilities of the underlying operating system, " +"that is, Xlib on Unix/X11, Cocoa on macOS, GDI on Windows." msgstr "" msgid "" -"When your Python application uses a class in Tkinter, e.g., to create a " -"widget, the :mod:`!tkinter` module first assembles a Tcl/Tk command string. " -"It passes that Tcl command string to an internal :mod:`_tkinter` binary " -"module, which then calls the Tcl interpreter to evaluate it. The Tcl " +"When your Python application uses a class in Tkinter, for example, to create " +"a widget, the :mod:`!tkinter` module first assembles a Tcl/Tk command " +"string. It passes that Tcl command string to an internal :mod:`_tkinter` " +"binary module, which then calls the Tcl interpreter to evaluate it. The Tcl " "interpreter will then call into the Tk and/or Ttk packages, which will in " "turn make calls to Xlib, Cocoa, or GDI." msgstr "" -msgid "Tkinter Modules" +msgid "Tkinter modules" msgstr "" msgid "" @@ -220,112 +225,6 @@ msgid "" "from tkinter import ttk" msgstr "" -msgid "" -"Construct a toplevel Tk widget, which is usually the main window of an " -"application, and initialize a Tcl interpreter for this widget. Each " -"instance has its own associated Tcl interpreter." -msgstr "" - -msgid "" -"The :class:`Tk` class is typically instantiated using all default values. " -"However, the following keyword arguments are currently recognized:" -msgstr "" - -msgid "*screenName*" -msgstr "" - -msgid "" -"When given (as a string), sets the :envvar:`DISPLAY` environment variable. " -"(X11 only)" -msgstr "" - -msgid "*baseName*" -msgstr "" - -msgid "" -"Name of the profile file. By default, *baseName* is derived from the " -"program name (``sys.argv[0]``)." -msgstr "" - -msgid "*className*" -msgstr "" - -msgid "" -"Name of the widget class. Used as a profile file and also as the name with " -"which Tcl is invoked (*argv0* in *interp*)." -msgstr "" - -msgid "*useTk*" -msgstr "" - -msgid "" -"If ``True``, initialize the Tk subsystem. The :func:`tkinter.Tcl() ` " -"function sets this to ``False``." -msgstr "" - -msgid "*sync*" -msgstr "" - -msgid "" -"If ``True``, execute all X server commands synchronously, so that errors are " -"reported immediately. Can be used for debugging. (X11 only)" -msgstr "" - -msgid "*use*" -msgstr "" - -msgid "" -"Specifies the *id* of the window in which to embed the application, instead " -"of it being created as an independent toplevel window. *id* must be " -"specified in the same way as the value for the -use option for toplevel " -"widgets (that is, it has a form like that returned by :meth:`winfo_id`)." -msgstr "" - -msgid "" -"Note that on some platforms this will only work correctly if *id* refers to " -"a Tk frame or toplevel that has its -container option enabled." -msgstr "" - -msgid "" -":class:`Tk` reads and interprets profile files, named :file:`.{className}." -"tcl` and :file:`.{baseName}.tcl`, into the Tcl interpreter and calls :func:" -"`exec` on the contents of :file:`.{className}.py` and :file:`.{baseName}." -"py`. The path for the profile files is the :envvar:`HOME` environment " -"variable or, if that isn't defined, then :data:`os.curdir`." -msgstr "" - -msgid "" -"The Tk application object created by instantiating :class:`Tk`. This " -"provides access to the Tcl interpreter. Each widget that is attached the " -"same instance of :class:`Tk` has the same value for its :attr:`tk` attribute." -msgstr "" - -msgid "" -"The widget object that contains this widget. For :class:`Tk`, the :attr:`!" -"master` is :const:`None` because it is the main window. The terms *master* " -"and *parent* are similar and sometimes used interchangeably as argument " -"names; however, calling :meth:`winfo_parent` returns a string of the widget " -"name whereas :attr:`!master` returns the object. *parent*/*child* reflects " -"the tree-like relationship while *master* (or *container*)/*content* " -"reflects the container structure." -msgstr "" - -msgid "" -"The immediate descendants of this widget as a :class:`dict` with the child " -"widget names as the keys and the child instance objects as the values." -msgstr "" - -msgid "" -"The :func:`Tcl` function is a factory function which creates an object much " -"like that created by the :class:`Tk` class, except that it does not " -"initialize the Tk subsystem. This is most often useful when driving the Tcl " -"interpreter in an environment where one doesn't want to create extraneous " -"toplevel windows, or where one cannot (such as Unix/Linux systems without an " -"X server). An object created by the :func:`Tcl` object can have a Toplevel " -"window created (and the Tk subsystem initialized) by calling its :meth:" -"`loadtk` method." -msgstr "" - msgid "The modules that provide Tk support include:" msgstr "" @@ -403,12 +302,12 @@ msgid ":mod:`idlelib`" msgstr ":mod:`idlelib`" msgid "" -"Python's Integrated Development and Learning Environment (IDLE). Based on :" -"mod:`!tkinter`." +"Python's Integrated Development and Learning Environment (IDLE). Based " +"on :mod:`!tkinter`." msgstr "" -msgid ":mod:`tkinter.constants`" -msgstr ":mod:`tkinter.constants`" +msgid ":mod:`!tkinter.constants`" +msgstr "" msgid "" "Symbolic constants that can be used in place of strings when passing various " @@ -430,7 +329,7 @@ msgstr ":mod:`turtle`" msgid "Turtle graphics in a Tk window." msgstr "" -msgid "Tkinter Life Preserver" +msgid "Tkinter life preserver" msgstr "" msgid "" @@ -448,7 +347,7 @@ msgid "" "reference manual." msgstr "" -msgid "A Hello World Program" +msgid "A Hello World program" msgstr "" msgid "" @@ -482,14 +381,15 @@ msgid "" msgstr "" msgid "" -"The next line creates a label widget holding a static text string. The :meth:" -"`grid` method is used to specify the relative layout (position) of the label " -"within its containing frame widget, similar to how tables in HTML work." +"The next line creates a label widget holding a static text string. " +"The :meth:`~Grid.grid` method is used to specify the relative layout " +"(position) of the label within its containing frame widget, similar to how " +"tables in HTML work." msgstr "" msgid "" "A button widget is then created, and placed to the right of the label. When " -"pressed, it will call the :meth:`destroy` method of the root window." +"pressed, it will call the :meth:`~Misc.destroy` method of the root window." msgstr "" msgid "" @@ -497,7 +397,7 @@ msgid "" "responds to user input until the program terminates." msgstr "" -msgid "Important Tk Concepts" +msgid "Important Tk concepts" msgstr "" msgid "Even this simple program illustrates the following key Tk concepts:" @@ -508,8 +408,8 @@ msgstr "" msgid "" "A Tkinter user interface is made up of individual *widgets*. Each widget is " -"represented as a Python object, instantiated from classes like :class:`ttk." -"Frame`, :class:`ttk.Label`, and :class:`ttk.Button`." +"represented as a Python object, instantiated from classes " +"like :class:`ttk.Frame`, :class:`ttk.Label`, and :class:`ttk.Button`." msgstr "" msgid "widget hierarchy" @@ -549,7 +449,7 @@ msgid "" "isn't running the event loop, your user interface won't update." msgstr "" -msgid "Understanding How Tkinter Wraps Tcl/Tk" +msgid "Understanding how Tkinter wraps Tcl/Tk" msgstr "" msgid "" @@ -575,8 +475,8 @@ msgid "" "ttk::frame .frm -padding 10\n" "grid .frm\n" "grid [ttk::label .frm.lbl -text \"Hello World!\"] -column 0 -row 0\n" -"grid [ttk::button .frm.btn -text \"Quit\" -command \"destroy .\"] -column 1 -" -"row 0" +"grid [ttk::button .frm.btn -text \"Quit\" -command \"destroy .\"] -column 1 " +"-row 0" msgstr "" msgid "" @@ -641,9 +541,9 @@ msgstr "" msgid "" "To find out what configuration options are available on any widget, call " -"its :meth:`configure` method, which returns a dictionary containing a " +"its :meth:`~Misc.configure` method, which returns a dictionary containing a " "variety of information about each object, including its default and current " -"values. Use :meth:`keys` to get just the names of each option." +"values. Use :meth:`~Misc.keys` to get just the names of each option." msgstr "" msgid "" @@ -673,12 +573,12 @@ msgid "" "print(set(dir(btn)) - set(dir(frm)))" msgstr "" -msgid "Navigating the Tcl/Tk Reference Manual" +msgid "Navigating the Tcl/Tk reference manual" msgstr "" msgid "" -"As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate " +"As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate " "description of what specific operations on widgets do. Even when you know " "the name of the option or method that you need, you may still have a few " "places to look." @@ -688,7 +588,7 @@ msgid "" "While all operations in Tkinter are implemented as method calls on widget " "objects, you've seen that many Tcl/Tk operations appear as commands that " "take a widget pathname as its first parameter, followed by optional " -"parameters, e.g." +"parameters, for example" msgstr "" msgid "" @@ -710,33 +610,34 @@ msgstr "" msgid "" "In the official Tcl/Tk reference documentation, you'll find most operations " -"that look like method calls on the man page for a specific widget (e.g., " -"you'll find the :meth:`invoke` method on the `ttk::button `_ man page), while functions that take a " -"widget as a parameter often have their own man page (e.g., `grid `_)." +"that look like method calls on the man page for a specific widget (for " +"example, you'll find the :meth:`~tkinter.ttk.Button.invoke` method on the " +"`ttk::button `_ " +"man page), while functions that take a widget as a parameter often have " +"their own man page (for example, `grid `_)." msgstr "" msgid "" -"You'll find many common options and methods in the `options `_ or `ttk::widget `_ man pages, while others are found in the man " -"page for a specific widget class." +"You'll find many common options and methods in the `options `_ or `ttk::widget `_ man pages, while others are " +"found in the man page for a specific widget class." msgstr "" msgid "" -"You'll also find that many Tkinter methods have compound names, e.g., :func:" -"`winfo_x`, :func:`winfo_height`, :func:`winfo_viewable`. You'd find " -"documentation for all of these in the `winfo `_ man page." +"You'll also find that many Tkinter methods have compound names, for " +"example, :meth:`~Misc.winfo_x`, :meth:`~Misc.winfo_height`, :meth:`~Misc.winfo_viewable`. " +"You'd find documentation for all of these in the `winfo `_ man page." msgstr "" msgid "" "Somewhat confusingly, there are also methods on all Tkinter widgets that " "don't actually operate on the widget, but operate at a global scope, " "independent of any widget. Examples are methods for accessing the clipboard " -"or the system bell. (They happen to be implemented as methods in the base :" -"class:`Widget` class that all Tkinter widgets inherit from)." +"or the system bell. (They happen to be implemented as methods in the " +"base :class:`Widget` class that all Tkinter widgets inherit from)." msgstr "" msgid "Threading model" @@ -767,14 +668,14 @@ msgstr "" msgid "" "Tcl/Tk applications are normally event-driven, meaning that after " -"initialization, the interpreter runs an event loop (i.e. :func:`Tk." -"mainloop`) and responds to events. Because it is single-threaded, event " -"handlers must respond quickly, otherwise they will block other events from " -"being processed. To avoid this, any long-running computations should not run " -"in an event handler, but are either broken into smaller pieces using timers, " -"or run in another thread. This is different from many GUI toolkits where the " -"GUI runs in a completely separate thread from all application code including " -"event handlers." +"initialization, the interpreter runs an event loop (that " +"is, :meth:`Tk.mainloop `) and responds to events. Because it " +"is single-threaded, event handlers must respond quickly, otherwise they will " +"block other events from being processed. To avoid this, any long-running " +"computations should not run in an event handler, but are either broken into " +"smaller pieces using timers, or run in another thread. This is different " +"from many GUI toolkits where the GUI runs in a completely separate thread " +"from all application code including event handlers." msgstr "" msgid "" @@ -787,16 +688,18 @@ msgid "A number of special cases exist:" msgstr "" msgid "" -"Tcl/Tk libraries can be built so they are not thread-aware. In this case, :" -"mod:`!tkinter` calls the library from the originating Python thread, even if " -"this is different than the thread that created the Tcl interpreter. A global " -"lock ensures only one call occurs at a time." +"Tcl/Tk libraries built without thread support are now rare: the bundled Tcl/" +"Tk 8.6 is built with thread support, so this case only arises with some " +"older non-threaded builds. When the library is not thread-aware, :mod:`!" +"tkinter` calls the library from the originating Python thread, even if this " +"is different than the thread that created the Tcl interpreter. A global lock " +"ensures only one call occurs at a time." msgstr "" msgid "" -"While :mod:`!tkinter` allows you to create more than one instance of a :" -"class:`Tk` object (with its own interpreter), all interpreters that are part " -"of the same thread share a common event queue, which gets ugly fast. In " +"While :mod:`!tkinter` allows you to create more than one instance of " +"a :class:`Tk` object (with its own interpreter), all interpreters that are " +"part of the same thread share a common event queue, which gets ugly fast. In " "practice, don't create more than one instance of :class:`Tk` at a time. " "Otherwise, it's best to create them in separate threads and ensure you're " "running a thread-aware Tcl/Tk build." @@ -814,10 +717,10 @@ msgid "" "when called from the thread that created the Tcl interpreter." msgstr "" -msgid "Handy Reference" +msgid "Handy reference" msgstr "" -msgid "Setting Options" +msgid "Setting options" msgstr "" msgid "" @@ -847,6 +750,15 @@ msgstr "" msgid "fred.config(fg=\"red\", bg=\"blue\")" msgstr "" +msgid "" +"The ``fg`` and ``bg`` options used here, and other options that control a " +"widget's appearance, belong to the classic :mod:`!tkinter` widgets. The " +"themed :mod:`tkinter.ttk` widgets recommended in the introduction do not " +"accept them; style a themed widget through the :class:`ttk.Style " +"` class instead. The three ways of setting an option " +"shown above apply to both widget sets." +msgstr "" + msgid "" "For a complete explanation of a given option and its behavior, see the Tk " "man pages for the widget in question." @@ -856,8 +768,8 @@ msgid "" "Note that the man pages list \"STANDARD OPTIONS\" and \"WIDGET SPECIFIC " "OPTIONS\" for each widget. The former is a list of options that are common " "to many widgets, the latter are the options that are idiosyncratic to that " -"particular widget. The Standard Options are documented on the :manpage:" -"`options(3)` man page." +"particular widget. The Standard Options are documented on " +"the :manpage:`options(3)` man page." msgstr "" msgid "" @@ -869,18 +781,16 @@ msgstr "" msgid "" "The options supported by a given widget are listed in that widget's man " -"page, or can be queried at runtime by calling the :meth:`config` method " -"without arguments, or by calling the :meth:`keys` method on that widget. " -"The return value of these calls is a dictionary whose key is the name of the " -"option as a string (for example, ``'relief'``) and whose values are 5-tuples." +"page, or can be queried at runtime by calling the :meth:`~Misc.config` " +"method without arguments, or by calling the :meth:`~Misc.keys` method on " +"that widget. The return value of these calls is a dictionary whose key is " +"the name of the option as a string (for example, ``'relief'``) and whose " +"values are 5-tuples." msgstr "" msgid "" -"Some options, like ``bg`` are synonyms for common options with long names " -"(``bg`` is shorthand for \"background\"). Passing the ``config()`` method " -"the name of a shorthand option will return a 2-tuple, not 5-tuple. The 2-" -"tuple passed back will contain the name of the synonym and the \"real\" " -"option (such as ``('bg', 'background')``)." +"Some options, like ``bg``, are synonyms for common options with long names " +"(``bg`` is shorthand for \"background\")." msgstr "" msgid "Index" @@ -949,121 +859,129 @@ msgid "" "their values. This is meant only as an example." msgstr "" -msgid "The Packer" +msgid "Geometry management" msgstr "" msgid "" -"The packer is one of Tk's geometry-management mechanisms. Geometry " -"managers are used to specify the relative positioning of widgets within " -"their container. In contrast to the more cumbersome *placer* (which is used " -"less commonly, and we do not cover here), the packer takes qualitative " -"relationship specification - *above*, *to the left of*, *filling*, etc - and " -"works everything out to determine the exact placement coordinates for you." +"Creating a widget does not display it. A widget appears only after it has " +"been handed to a *geometry manager*, which works out its size and position " +"inside its container and keeps the layout up to date as the container is " +"resized or its content changes. Forgetting to call a geometry manager is a " +"common early mistake: the widget is created, but nothing shows up." msgstr "" msgid "" -"The size of any container widget is determined by the size of the \"content " -"widgets\" inside. The packer is used to control where content widgets " -"appear inside the container into which they are packed. You can pack " -"widgets into frames, and frames into other frames, in order to achieve the " -"kind of layout you desire. Additionally, the arrangement is dynamically " -"adjusted to accommodate incremental changes to the configuration, once it is " -"packed." +"Tk provides three geometry managers. Each is inherited by every widget, so " +"any widget can be managed by any of them (but see the warning below about " +"the incompatibility of grid and pack). The choice depends on the kind of " +"layout you want." msgstr "" -msgid "" -"Note that widgets do not appear until they have had their geometry specified " -"with a geometry manager. It's a common early mistake to leave out the " -"geometry specification, and then be surprised when the widget is created but " -"nothing appears. A widget will appear only after it has had, for example, " -"the packer's :meth:`pack` method applied to it." +msgid ":meth:`grid `" msgstr "" msgid "" -"The pack() method can be called with keyword-option/value pairs that control " -"where the widget is to appear within its container, and how it is to behave " -"when the main application window is resized. Here are some examples::" +"Arranges widgets in a two-dimensional table of rows and columns. It is the " +"most flexible manager and the one to reach for by default: layouts that " +"would otherwise need several nested frames can often be expressed as a " +"single grid, and rows and columns can be told how to absorb extra space." msgstr "" msgid "" -"fred.pack() # defaults to side = \"top\"\n" -"fred.pack(side=\"left\")\n" -"fred.pack(expand=1)" +"ttk.Label(frm, text=\"Name:\").grid(column=0, row=0, sticky=\"w\")\n" +"ttk.Entry(frm).grid(column=1, row=0)\n" +"ttk.Button(frm, text=\"OK\").grid(column=1, row=1, sticky=\"e\")" msgstr "" -msgid "Packer Options" +msgid ":meth:`pack `" msgstr "" msgid "" -"For more extensive information on the packer and the options that it can " -"take, see the man pages and page 183 of John Ousterhout's book." -msgstr "" - -msgid "anchor" +"Stacks widgets against one side of their container -- ``\"top\"`` (the " +"default), ``\"bottom\"``, ``\"left\"`` or ``\"right\"`` -- and can make them " +"fill or expand into the space that is left. It is convenient for simple " +"arrangements, such as a single row or column of widgets or a content area " +"framed by a toolbar and a status bar." msgstr "" msgid "" -"Anchor type. Denotes where the packer is to place each content in its " -"parcel." -msgstr "" - -msgid "expand" -msgstr "" - -msgid "Boolean, ``0`` or ``1``." -msgstr "" - -msgid "fill" +"toolbar.pack(side=\"top\", fill=\"x\")\n" +"status.pack(side=\"bottom\", fill=\"x\")\n" +"body.pack(side=\"left\", expand=True, fill=\"both\")" msgstr "" -msgid "Legal values: ``'x'``, ``'y'``, ``'both'``, ``'none'``." +msgid ":meth:`place `" msgstr "" -msgid "ipadx and ipady" +msgid "" +"Positions each widget at an explicit spot, given either as absolute screen " +"distances or as a fraction of the container's size. It offers the most " +"control but the least automatic behavior, and is used the least; it suits " +"special cases such as overlapping widgets or precise custom layouts." msgstr "" -msgid "A distance - designating internal padding on each side of the content." +msgid "" +"background.place(x=0, y=0, relwidth=1.0, relheight=1.0)\n" +"badge.place(relx=1.0, rely=0.0, anchor=\"ne\")" msgstr "" -msgid "padx and pady" +msgid "" +"Layouts are built up by nesting: grid or pack widgets, including frames, " +"inside a frame or toplevel. Toplevels are managed by the OS window manager. " +"Classic and themed :mod:`tkinter.ttk` widgets can be managed interchangeably." msgstr "" -msgid "A distance - designating external padding on each side of the content." +msgid "" +"Do not apply :meth:`!pack` and :meth:`!grid` to two widgets that share the " +"same container. The two managers negotiate sizes in incompatible ways, and " +"the application can hang as they repeatedly resize the container against " +"each other. To combine them, keep each manager's widgets in a separate frame." msgstr "" -msgid "side" +msgid "" +"The full set of options accepted by each manager, with their values and " +"defaults, is documented " +"under :meth:`Grid.grid_configure`, :meth:`Pack.pack_configure` " +"and :meth:`Place.place_configure`; see also " +"the :manpage:`grid(3tk)`, :manpage:`pack(3tk)` and :manpage:`place(3tk)` man " +"pages." msgstr "" -msgid "Legal values are: ``'left'``, ``'right'``, ``'top'``, ``'bottom'``." +msgid "Coupling widget variables" msgstr "" -msgid "Coupling Widget Variables" +msgid "" +"Some widgets can tie their current value directly to a program variable, so " +"that the two stay in sync. Options such as ``variable``, ``textvariable``, " +"``value``, ``onvalue`` and ``offvalue`` set up this connection: when the " +"user changes the widget the variable is updated, and when the variable is " +"set the widget redraws to match." msgstr "" msgid "" -"The current-value setting of some widgets (like text entry widgets) can be " -"connected directly to application variables by using special options. These " -"options are ``variable``, ``textvariable``, ``onvalue``, ``offvalue``, and " -"``value``. This connection works both ways: if the variable changes for any " -"reason, the widget it's connected to will be updated to reflect the new " -"value." +"A widget can be linked only to a :class:`Variable` object, not to an " +"ordinary Python variable. This is not a limitation of :mod:`!tkinter` but a " +"consequence of how the two languages differ: the link relies on Tcl being " +"notified every time the value changes, and Python offers no way to react " +"when a plain variable is reassigned. A :class:`Variable` sidesteps this by " +"keeping its value inside the Tcl interpreter and exposing it through " +"explicit :meth:`~Variable.get` and :meth:`~Variable.set` methods." msgstr "" msgid "" -"Unfortunately, in the current implementation of :mod:`!tkinter` it is not " -"possible to hand over an arbitrary Python variable to a widget through a " -"``variable`` or ``textvariable`` option. The only kinds of variables for " -"which this works are variables that are subclassed from a class called " -"Variable, defined in :mod:`!tkinter`." +"Ready-made subclasses cover the common " +"types: :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar` " +"and :class:`BooleanVar`. Pass one as a widget's ``textvariable`` (or " +"``variable``) option, then read and update it with :meth:`~Variable.get` " +"and :meth:`~Variable.set`; the widget tracks it with no further work on your " +"part." msgstr "" msgid "" -"There are many useful subclasses of Variable already defined: :class:" -"`StringVar`, :class:`IntVar`, :class:`DoubleVar`, and :class:`BooleanVar`. " -"To read the current value of such a variable, call the :meth:`get` method on " -"it, and to change its value you call the :meth:`!set` method. If you follow " -"this protocol, the widget will always track the value of the variable, with " -"no further intervention on your part." +"Keep a reference to the variable for as long as the widget uses it -- for " +"example by storing it as an attribute. A :class:`Variable` that is garbage " +"collected removes its underlying Tcl variable, breaking the connection to " +"the widget (see :class:`Variable`)." msgstr "" msgid "For example::" @@ -1071,111 +989,123 @@ msgstr "Dla przykładu::" msgid "" "import tkinter as tk\n" +"from tkinter import ttk\n" +"\n" +"root = tk.Tk()\n" "\n" -"class App(tk.Frame):\n" -" def __init__(self, master):\n" -" super().__init__(master)\n" -" self.pack()\n" +"# Create the application variable and give it an initial value.\n" +"contents = tk.StringVar(value=\"this is a variable\")\n" "\n" -" self.entrythingy = tk.Entry()\n" -" self.entrythingy.pack()\n" +"# Tell the entry widget to track the variable.\n" +"entry = ttk.Entry(root, textvariable=contents)\n" +"entry.pack()\n" "\n" -" # Create the application variable.\n" -" self.contents = tk.StringVar()\n" -" # Set it to some value.\n" -" self.contents.set(\"this is a variable\")\n" -" # Tell the entry widget to watch this variable.\n" -" self.entrythingy[\"textvariable\"] = self.contents\n" +"# Print the current value whenever the user presses Return.\n" +"def print_contents(event):\n" +" print(\"The current entry content is:\", contents.get())\n" "\n" -" # Define a callback for when the user hits return.\n" -" # It prints the current value of the variable.\n" -" self.entrythingy.bind('',\n" -" self.print_contents)\n" +"entry.bind(\"\", print_contents)\n" "\n" -" def print_contents(self, event):\n" -" print(\"Hi. The current entry content is:\",\n" -" self.contents.get())\n" +"# Setting the variable from the program updates the entry through the\n" +"# same link.\n" +"def clear():\n" +" contents.set(\"\")\n" "\n" -"root = tk.Tk()\n" -"myapp = App(root)\n" -"myapp.mainloop()" +"ttk.Button(root, text=\"Clear\", command=clear).pack()\n" +"\n" +"root.mainloop()" msgstr "" -msgid "The Window Manager" +msgid "The window manager" msgstr "" msgid "" -"In Tk, there is a utility command, ``wm``, for interacting with the window " -"manager. Options to the ``wm`` command allow you to control things like " -"titles, placement, icon bitmaps, and the like. In :mod:`!tkinter`, these " -"commands have been implemented as methods on the :class:`Wm` class. " -"Toplevel widgets are subclassed from the :class:`Wm` class, and so can call " -"the :class:`Wm` methods directly." +"The *window manager* is the part of the desktop responsible for the title " +"bar, border and controls drawn around each top-level window, and for such " +"things as its title, position, size and icon. Tk gives access to these " +"through the :class:`Wm` mixin, which is inherited by the :class:`Tk` root " +"window and by every :class:`Toplevel`. You therefore call the window-manager " +"methods directly on a top-level window. Each has a short name and an " +"equivalent ``wm_``-prefixed name, for example :meth:`~Wm.title` " +"and :meth:`~Wm.wm_title`." msgstr "" msgid "" -"To get at the toplevel window that contains a given widget, you can often " -"just refer to the widget's :attr:`master`. Of course if the widget has been " -"packed inside of a frame, the :attr:`!master` won't represent a toplevel " -"window. To get at the toplevel window that contains an arbitrary widget, " -"you can call the :meth:`_root` method. This method begins with an underscore " -"to denote the fact that this function is part of the implementation, and not " -"an interface to Tk functionality." -msgstr "" - -msgid "Here are some examples of typical usage::" +"These methods act on the top-level window whether its content is built from " +"the classic widgets or the themed :mod:`tkinter.ttk` widgets. To reach the " +"top-level window containing an arbitrary widget, call " +"its :meth:`~Misc.winfo_toplevel` method." msgstr "" msgid "" "import tkinter as tk\n" +"from tkinter import ttk\n" "\n" -"class App(tk.Frame):\n" -" def __init__(self, master=None):\n" -" super().__init__(master)\n" -" self.pack()\n" -"\n" -"# create the application\n" -"myapp = App()\n" +"root = tk.Tk()\n" +"root.title(\"My Application\")\n" +"root.geometry(\"640x480\")\n" +"root.minsize(320, 240)\n" "\n" -"#\n" -"# here are method calls to the window manager class\n" -"#\n" -"myapp.master.title(\"My Do-Nothing Application\")\n" -"myapp.master.maxsize(1000, 400)\n" +"ttk.Label(root, text=\"Hello\").pack(padx=20, pady=20)\n" "\n" -"# start the program\n" -"myapp.mainloop()" +"root.mainloop()" msgstr "" -msgid "Tk Option Data Types" +msgid "See :class:`Wm` for the full set of window-manager methods." +msgstr "" + +msgid "Tk option data types" +msgstr "" + +msgid "" +"Many widget options documented in the reference accept values of a small " +"number of common types, described here. The standard options and their types " +"are described in the :manpage:`options(3tk)` manual page." +msgstr "" + +msgid "anchor" msgstr "" msgid "" "Legal values are points of the compass: ``\"n\"``, ``\"ne\"``, ``\"e\"``, " "``\"se\"``, ``\"s\"``, ``\"sw\"``, ``\"w\"``, ``\"nw\"``, and also " -"``\"center\"``." +"``\"center\"``. The *labelanchor* option of :class:`LabelFrame` " +"and :class:`ttk.LabelFrame ` accepts also " +"``\"en\"``, ``\"es\"``, ``\"wn\"`` and ``\"ws\"``. The *sticky* option of " +"the grid geometry manager accepts a combination of the compass directions, " +"such as ``\"nsew\"``, or an empty string." msgstr "" msgid "bitmap" msgstr "" msgid "" -"There are eight built-in, named bitmaps: ``'error'``, ``'gray25'``, " -"``'gray50'``, ``'hourglass'``, ``'info'``, ``'questhead'``, ``'question'``, " -"``'warning'``. To specify an X bitmap filename, give the full path to the " -"file, preceded with an ``@``, as in ``\"@/usr/contrib/bitmap/gumby.bit\"``." +"There are ten built-in, named bitmaps: ``'error'``, ``'gray12'``, " +"``'gray25'``, ``'gray50'``, ``'gray75'``, ``'hourglass'``, ``'info'``, " +"``'questhead'``, ``'question'``, ``'warning'``. On macOS the following " +"bitmaps are available as well: ``'application'``, ``'accessory'``, " +"``'folder'``, ``'pfolder'``, ``'trash'``, ``'floppy'``, ``'ramdisk'``, " +"``'cdrom'``, ``'preferences'``, ``'querydoc'``, ``'stop'``, ``'note'`` and " +"``'caution'``. To specify an X bitmap file, give the full path to the file, " +"preceded with an ``@``, as in ``\"@/usr/contrib/bitmap/gumby.bit\"``." msgstr "" msgid "boolean" msgstr "" -msgid "You can pass integers 0 or 1 or the strings ``\"yes\"`` or ``\"no\"``." +msgid "" +"You can pass the integers 0 or 1, ``True`` or ``False``, or the strings " +"``\"0\"``, ``\"1\"``, ``\"yes\"``, ``\"no\"``, ``\"true\"``, ``\"false\"``, " +"``\"on\"`` or ``\"off\"``. The strings are matched ignoring case, and an " +"unambiguous prefix, such as ``\"t\"``, is enough. Any non-zero integer means " +"true." msgstr "" msgid "callback" msgstr "wywołanie zwrotne" -msgid "This is any Python function that takes no arguments. For example::" +msgid "" +"This is any callable object. Most callbacks take no arguments. For example::" msgstr "" msgid "" @@ -1184,25 +1114,56 @@ msgid "" "fred[\"command\"] = print_it" msgstr "" +msgid "" +"Some options call it with arguments, such as the *command* option " +"of :class:`Scale`, which is called with the new value." +msgstr "" + msgid "color" msgstr "" msgid "" -"Colors can be given as the names of X colors in the rgb.txt file, or as " -"strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 bit: " -"``\"#RRGGBB\"``, 12 bit: ``\"#RRRGGGBBB\"``, or 16 bit: " +"Colors can be given as symbolic names, such as ``\"red\"`` or ``\"light " +"blue\"``, or as strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 " +"bit: ``\"#RRGGBB\"``, 12 bit: ``\"#RRRGGGBBB\"``, or 16 bit: " "``\"#RRRRGGGGBBBB\"`` ranges, where R,G,B here represent any legal hex " -"digit. See page 160 of Ousterhout's book for details." +"digit. Tk provides a portable set of symbolic names available on all " +"platforms; they are matched ignoring case and spaces, so ``\"light blue\"``, " +"``\"Light Blue\"`` and ``\"lightblue\"`` are the same color. The full list " +"of names, including the platform-specific names of the current system colors " +"(for example ``\"systemButtonFace\"`` on Windows or ``\"systemWindowBody\"`` " +"on macOS), is given in the :manpage:`colors(3tk)` manual " +"page. :meth:`~tkinter.Misc.winfo_rgb` returns the red, green and blue " +"components of a color." +msgstr "" + +msgid "compound" +msgstr "" + +msgid "" +"Determines how to combine an image and a text displayed in a widget. Legal " +"values are ``\"none\"`` (display the image if there is one, otherwise the " +"text), ``\"text\"``, ``\"image\"``, ``\"center\"`` (display the text in the " +"center of the image) and ``\"top\"``, ``\"bottom\"``, ``\"left\"``, " +"``\"right\"`` (display the image above, below, to the left of or to the " +"right of the text). The themed widgets accept all these values, the classic " +"widgets accept all except ``\"text\"`` and ``\"image\"``." msgstr "" msgid "cursor" msgstr "" msgid "" -"The standard X cursor names from :file:`cursorfont.h` can be used, without " -"the ``XC_`` prefix. For example to get a hand cursor (:const:`XC_hand2`), " -"use the string ``\"hand2\"``. You can also specify a bitmap and mask file " -"of your own. See page 179 of Ousterhout's book." +"The name of the mouse cursor to display while the pointer is over the " +"widget. Tk provides a portable set of cursor names available on all " +"platforms (for example ``\"arrow\"``, ``\"watch\"``, ``\"cross\"``, or " +"``\"hand2\"``); the standard X cursor names from :file:`cursorfont.h` may " +"also be used, without the ``XC_`` prefix (so ``XC_hand2`` becomes " +"``\"hand2\"``). The full list of names, including the platform-specific " +"ones, is given in the :manpage:`cursors(3tk)` manual page. You can also " +"specify a bitmap and mask file of your own. On Windows a cursor file " +"(:file:`.cur` or :file:`.ani`) may be used directly, giving its path " +"preceded with an ``@``, as in ``\"@C:/cursors/bart.ani\"``." msgstr "" msgid "distance" @@ -1220,35 +1181,49 @@ msgid "font" msgstr "" msgid "" -"Tk uses a list font name format, such as ``{courier 10 bold}``. Font sizes " -"with positive numbers are measured in points; sizes with negative numbers " -"are measured in pixels." +"Tk uses a font description such as ``{courier 10 bold}``; in :mod:`!tkinter` " +"this is most naturally passed as a tuple of ``(family, size, *styles)`` (or " +"as the equivalent string ``\"Courier 10 bold\"``). Font sizes with positive " +"numbers are measured in points; sizes with negative numbers are measured in " +"pixels. The name of a named font, such as ``\"TkDefaultFont\"``, " +"a :class:`tkinter.font.Font` instance, or, on X11, an XLFD font name can be " +"used as well." msgstr "" -msgid "geometry" +msgid "justify" msgstr "" msgid "" -"This is a string of the form ``widthxheight``, where width and height are " -"measured in pixels for most widgets (in characters for widgets displaying " -"text). For example: ``fred[\"geometry\"] = \"200x100\"``." +"Legal values are the strings: ``\"left\"``, ``\"center\"``, and " +"``\"right\"``." msgstr "" -msgid "justify" +msgid "orient" +msgstr "" + +msgid "Legal values are ``\"horizontal\"`` and ``\"vertical\"``." +msgstr "" + +msgid "padding" msgstr "" msgid "" -"Legal values are the strings: ``\"left\"``, ``\"center\"``, and " -"``\"right\"``." +"This is a legal distance (see above), applied on all sides, or a sequence of " +"up to four distances specifying the left, top, right and bottom padding. If " +"fewer than four are specified, the bottom padding defaults to the top one, " +"the right one to the left one, and the top one to the left one. It is only " +"supported by the themed widgets." msgstr "" msgid "region" msgstr "" msgid "" -"This is a string with four space-delimited elements, each of which is a " -"legal distance (see above). For example: ``\"2 3 4 5\"`` and ``\"3i 2i 4.5i " -"2i\"`` and ``\"3c 2c 4c 10.43c\"`` are all legal regions." +"Used for the *scrollregion* option of :class:`Canvas`. This is a string with " +"four space-delimited elements, each of which is a legal distance (see " +"above), or a sequence of four such elements. For example: ``\"2 3 4 5\"``, " +"``(2, 3, 4, 5)``, ``\"3i 2i 4.5i 2i\"`` and ``\"3c 2c 4c 10.43c\"`` are all " +"legal regions." msgstr "" msgid "relief" @@ -1256,8 +1231,8 @@ msgstr "" msgid "" "Determines what the border style of a widget will be. Legal values are: " -"``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, and " -"``\"ridge\"``." +"``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, ``\"ridge\"``, " +"and ``\"solid\"``." msgstr "" msgid "scrollcommand" @@ -1268,13 +1243,28 @@ msgid "" "can be any widget method that takes a single argument." msgstr "" +msgid "state" +msgstr "" + +msgid "" +"Legal values are ``\"normal\"``, ``\"disabled\"`` and, depending on the " +"widget, also ``\"active\"``, ``\"hidden\"`` (for :class:`Canvas` items) or " +"``\"readonly\"`` (for :class:`Entry`, :class:`Spinbox` and the themed " +"widgets). The themed widgets have in addition a more general set of states, " +"which is manipulated with :meth:`ttk.Widget.state " +"`." +msgstr "" + msgid "wrap" msgstr "" -msgid "Must be one of: ``\"none\"``, ``\"char\"``, or ``\"word\"``." +msgid "" +"Must be one of ``\"none\"``, ``\"char\"`` or ``\"word\"`` for " +"the :class:`Text` widget and its tags; for a tag an empty string means to " +"use the widget's value." msgstr "" -msgid "Bindings and Events" +msgid "Bindings and events" msgstr "" msgid "" @@ -1293,9 +1283,11 @@ msgid "sequence" msgstr "sekwencja" msgid "" -"is a string that denotes the target kind of event. (See the :manpage:" -"`bind(3tk)` man page, and page 201 of John Ousterhout's book, :title-" -"reference:`Tcl and the Tk Toolkit (2nd edition)`, for details)." +"is a string that denotes the target kind of event. Physical events use the " +"```` form (for example ``\"\"`` or " +"``\"\"``); application-defined virtual events use double " +"angle brackets, as in ``\"<>\"``. (See the :manpage:`bind(3tk)` man " +"page for details.)" msgstr "" msgid "func" @@ -1374,9 +1366,6 @@ msgstr "" msgid "%s" msgstr "%s" -msgid "state" -msgstr "" - msgid "%N" msgstr "%N" @@ -1431,7 +1420,46 @@ msgstr "%Y" msgid "y_root" msgstr "" -msgid "The index Parameter" +msgid "%#" +msgstr "" + +msgid "serial" +msgstr "" + +msgid "%b" +msgstr "" + +msgid "num" +msgstr "" + +msgid "%d" +msgstr "" + +msgid "detail" +msgstr "" + +msgid "%D" +msgstr "" + +msgid "delta" +msgstr "" + +msgid "" +"The ``add`` parameter above only affects the bindings you make yourself. " +"Every widget also inherits *class bindings* that implement its standard " +"behavior -- for example a :class:`Text` widget binds :kbd:`Control-t` to " +"transpose two characters. These are described in the bindings section of the " +"widget's Tk man page (such as :manpage:`text(3tk)` or :manpage:`entry(3tk)`)." +msgstr "" + +msgid "" +"Class bindings are processed separately from your own, so binding an event " +"yourself does not replace the default; both run. To suppress an unwanted " +"default binding, bind the event on the widget and return the string " +"``\"break\"`` from your callback." +msgstr "" + +msgid "The index parameter" msgstr "" msgid "" @@ -1444,9 +1472,40 @@ msgid "Entry widget indexes (index, view index, etc.)" msgstr "" msgid "" -"Entry widgets have options that refer to character positions in the text " -"being displayed. You can use these :mod:`!tkinter` functions to access " -"these special points in text widgets:" +"Entry widgets have methods and options that refer to character positions in " +"the text being displayed. Anytime an index is needed, you may pass in:" +msgstr "" + +msgid "" +"an integer which refers to the numeric position of a character, counted from " +"the beginning of the text, starting with 0;" +msgstr "" + +msgid "" +"the string ``\"anchor\"``, which refers to the anchor point of the " +"selection, set with the widget's selection methods;" +msgstr "" + +msgid "" +"the string ``\"end\"``, which refers to the position just after the last " +"character;" +msgstr "" + +msgid "" +"the string ``\"insert\"``, which refers to the character just after the " +"insertion cursor;" +msgstr "" + +msgid "" +"the strings ``\"sel.first\"`` and ``\"sel.last\"``, which refer to the first " +"character in the selection and the position just after the last (it is an " +"error to use these if there is no selection);" +msgstr "" + +msgid "" +"a string consisting of ``@`` followed by an integer, as in ``\"@6\"``, where " +"the integer is interpreted as an x pixel coordinate in the entry's " +"coordinate system, selecting the character spanning that point." msgstr "" msgid "Text widget indexes" @@ -1479,8 +1538,9 @@ msgid "the string ``\"last\"`` which refers to the last menu item;" msgstr "" msgid "" -"An integer preceded by ``@``, as in ``@6``, where the integer is interpreted " -"as a y pixel coordinate in the menu's coordinate system;" +"a string consisting of ``@`` followed by an integer, as in ``\"@6\"``, where " +"the integer is interpreted as a y pixel coordinate in the menu's coordinate " +"system;" msgstr "" msgid "" @@ -1520,17 +1580,17 @@ msgstr "" msgid "" "Added the :class:`!PhotoImage` method :meth:`!copy_replace` to copy a region " "from one image to other image, possibly with pixel zooming and/or " -"subsampling. Add *from_coords* parameter to :class:`!PhotoImage` methods :" -"meth:`!copy`, :meth:`!zoom` and :meth:`!subsample`. Add *zoom* and " +"subsampling. Add *from_coords* parameter to :class:`!PhotoImage` " +"methods :meth:`!copy`, :meth:`!zoom` and :meth:`!subsample`. Add *zoom* and " "*subsample* parameters to :class:`!PhotoImage` method :meth:`!copy`." msgstr "" msgid "" "The image object can then be used wherever an ``image`` option is supported " -"by some widget (e.g. labels, buttons, menus). In these cases, Tk will not " -"keep a reference to the image. When the last Python reference to the image " -"object is deleted, the image data is deleted as well, and Tk will display an " -"empty box wherever the image was used." +"by some widget (for example, labels, buttons, menus). In these cases, Tk " +"will not keep a reference to the image. When the last Python reference to " +"the image object is deleted, the image data is deleted as well, and Tk will " +"display an empty box wherever the image was used." msgstr "" msgid "" @@ -1538,58 +1598,5087 @@ msgid "" "such as BMP, JPEG, TIFF, and WebP, among others." msgstr "" -msgid "File Handlers" +msgid "Reference" +msgstr "Dokumentacja" + +msgid "" +"This section documents the classes, methods, functions and constants of " +"the :mod:`!tkinter` module. Most of them wrap Tcl/Tk commands; consult the " +"official Tcl/Tk manual pages for the full list of widget options and further " +"details." msgstr "" msgid "" -"Tk allows you to register and unregister a callback function which will be " -"called from the Tk mainloop when I/O is possible on a file descriptor. Only " -"one handler may be registered per file descriptor. Example code::" +"The exception raised when a call into the Tcl interpreter fails, for example " +"when a widget is given an unknown option or an invalid value." +msgstr "" + +msgid "Base and mixin classes" msgstr "" msgid "" -"import tkinter\n" -"widget = tkinter.Tk()\n" -"mask = tkinter.READABLE | tkinter.WRITABLE\n" -"widget.tk.createfilehandler(file, mask, callback)\n" -"...\n" -"widget.tk.deletefilehandler(file)" +"The :class:`!Misc` class is a mix-in inherited by :class:`Tk` and, " +"through :class:`BaseWidget`, by every widget. It provides the large set of " +"methods common to all Tk objects: querying window information, managing " +"event bindings and the event loop, controlling the keyboard focus and " +"pointer grabs, accessing the selection, clipboard and option database, and " +"assorted utility and introspection services. Because they are inherited, " +"these methods are available on every widget and on the :class:`Tk` " +"application object, and are documented here once rather than repeated for " +"each widget." msgstr "" -msgid "This feature is not available on Windows." +msgid "" +"Return the current value of the configuration option named *key* for this " +"widget, as a string. The expression ``widget[key]`` is equivalent and may be " +"used instead." msgstr "" msgid "" -"Since you don't know how many bytes are available for reading, you may not " -"want to use the :class:`~io.BufferedIOBase` or :class:`~io.TextIOBase` :meth:" -"`~io.BufferedIOBase.read` or :meth:`~io.IOBase.readline` methods, since " -"these will insist on reading a predefined number of bytes. For sockets, the :" -"meth:`~socket.socket.recv` or :meth:`~socket.socket.recvfrom` methods will " -"work fine; for other files, use raw reads or ``os.read(file.fileno(), " -"maxbytecount)``." +"Query or modify the configuration options of the widget. With no arguments, " +"return a dictionary mapping every available option name to a tuple " +"describing it (its name, X resource name, X resource class, default value " +"and current value). If a single option name is given as a string, return the " +"tuple for just that option. If one or more keyword arguments are given, or a " +"dictionary is passed as *cnf*, set each named option to the corresponding " +"value; the expression ``widget[key] = value`` sets a single option in the " +"same way." +msgstr "" + +msgid ":meth:`config` is an alias of :meth:`!configure`." +msgstr "" + +msgid "Return a list of the names of all configuration options of this widget." msgstr "" msgid "" -"Registers the file handler callback function *func*. The *file* argument may " -"either be an object with a :meth:`~io.IOBase.fileno` method (such as a file " -"or socket object), or an integer file descriptor. The *mask* argument is an " -"ORed combination of any of the three constants below. The callback is called " -"as follows::" +"Interpret the string *s* as a Tcl boolean and return the " +"corresponding :class:`bool`. Tcl accepts values such as ``'1'``, ``'0'``, " +"``'yes'``, ``'no'``, ``'true'``, ``'false'``, ``'on'`` and ``'off'``. " +"Raise :exc:`ValueError` if *s* is not a valid boolean." msgstr "" -msgid "callback(file, mask)" +msgid "" +"Interpret the string *s* as a Tcl floating-point number and return it as " +"a :class:`float`. Raise :exc:`ValueError` if *s* is not a valid number." msgstr "" -msgid "Unregisters a file handler." +msgid "" +"Interpret the string *s* as a Tcl integer and return it as an :class:`int`. " +"Raise :exc:`ValueError` if *s* is not a valid integer." msgstr "" -msgid "Constants used in the *mask* arguments." +msgid "Return the value of the Tcl global variable named *name*." msgstr "" -msgid "packing (widgets)" +msgid "Set the Tcl global variable named *name* to *value*." msgstr "" -msgid "window manager (widgets)" +msgid "" +"The :meth:`!getvar` and :meth:`!setvar` methods give direct access to Tcl " +"variables. In most code you will instead use a :class:`Variable` subclass " +"such as :class:`StringVar` or :class:`IntVar`, which wraps a Tcl variable " +"and converts its value to and from a Python type." +msgstr "" + +msgid "" +"Register the Python callable *func* as a Tcl command and return the name of " +"the new command as a string. Whenever Tcl invokes that command, *func* is " +"called; if *subst* is given, it is applied to the command's arguments first. " +"This is the mechanism used internally to turn Python callbacks into the " +"command names passed to Tk options such as *command*. Unless *needcleanup* " +"is false, the command is deleted automatically when the widget is destroyed." +msgstr "" + +msgid "The arguments passed to *func* are no longer converted to strings." +msgstr "" + +msgid "" +"Delete the Tcl command named *name*, such as one previously returned " +"by :meth:`register`." +msgstr "" + +msgid "Return the widget instance corresponding to the Tk pathname *name*." +msgstr "" + +msgid "" +"Send the Tcl command *cmd*, with the given *args*, to the Tcl interpreter " +"registered under the name *interp*, and return its result. This is not " +"available on all platforms." +msgstr "" + +msgid "" +"Destroy this widget and all of its descendant widgets, and delete the Tcl " +"commands associated with them." +msgstr "" + +msgid "" +"Raise this widget in the stacking order so that it is drawn on top of its " +"siblings. If *aboveThis* is given, the widget is moved to be just above it " +"in the stacking order instead." +msgstr "" + +msgid ":meth:`lift` is an alias of :meth:`!tkraise`." +msgstr "" + +msgid "" +"Lower this widget in the stacking order so that it is drawn beneath its " +"siblings. If *belowThis* is given, the widget is moved to be just below it " +"in the stacking order instead." +msgstr "" + +msgid "" +":meth:`tkraise`/:meth:`lift` and :meth:`lower` are overridden by " +"the :class:`Canvas` widget, where they restack canvas items instead." +msgstr "" + +msgid "" +"Return the names of all images that currently exist in the Tcl interpreter." +msgstr "" + +msgid "" +"This is overridden by the :class:`Text` widget, where :meth:`!image_names` " +"returns the names of its embedded images instead." +msgstr "" + +msgid "Return the available image types, such as ``'photo'`` and ``'bitmap'``." +msgstr "" + +msgid "" +"Set the anchor that controls where the grid is placed inside this container " +"when the container is larger than the grid and no row or column has a non-" +"zero weight. *anchor* is one of the usual anchor strings, such as ``'nw'`` " +"(the default) or ``'center'``. Called with no argument, this method has no " +"effect." +msgstr "" + +msgid ":meth:`anchor` is an alias of :meth:`!grid_anchor`." +msgstr "" + +msgid "" +"Return the bounding box, in pixels, of a region of the grid laid out in this " +"container, as a 4-tuple ``(xoffset, yoffset, width, height)``. With no " +"arguments the bounding box of the whole grid is returned. If *column* and " +"*row* are given, the box spans from the cell at row and column 0 to that " +"cell; if *col2* and *row2* are also given, it spans from the cell (*column*, " +"*row*) to the cell (*col2*, *row2*)." +msgstr "" + +msgid "" +":meth:`bbox` is an alias of :meth:`!grid_bbox`, except " +"on :class:`Canvas`, :class:`Listbox`, :class:`Spinbox`, :class:`Text`, :class:`ttk.Entry " +"` and :class:`ttk.Treeview `, which " +"provide their own :meth:`!bbox` method." +msgstr "" + +msgid "" +"Query or set the properties of the column (or columns) *index* of the grid " +"managed by this container. *index* may be a column number; when setting " +"options it may also be a list of column numbers, the string ``'all'`` to " +"affect every column, or a child widget whose occupied columns are affected. " +"The supported options are:" +msgstr "" + +msgid "*minsize*" +msgstr "" + +msgid "The column's minimum size, in pixels." +msgstr "" + +msgid "*weight*" +msgstr "" + +msgid "" +"An integer setting how much of any extra space is apportioned to the column. " +"A weight of ``0`` keeps the column at its requested size, and a column of " +"weight two grows twice as fast as a column of weight one." +msgstr "" + +msgid "*uniform*" +msgstr "" + +msgid "" +"The name of a uniform group. Columns sharing a non-empty group name are kept " +"in sizes that are strictly proportional to their weights." +msgstr "" + +msgid "*pad*" +msgstr "" + +msgid "" +"Extra space, in pixels, added to the largest widget in the column when " +"computing the column's size." +msgstr "" + +msgid "" +"With a single option name, return that option's value; with no options, " +"return a dictionary of all of them." +msgstr "" + +msgid ":meth:`columnconfigure` is an alias of :meth:`!grid_columnconfigure`." +msgstr "" + +msgid "" +"Query or set the properties of the row (or rows) *index* of the grid managed " +"by this container. *index* is interpreted as " +"for :meth:`grid_columnconfigure`, and the supported options (*minsize*, " +"*weight*, *uniform* and *pad*) are the same, applied to a row instead of a " +"column." +msgstr "" + +msgid ":meth:`rowconfigure` is an alias of :meth:`!grid_rowconfigure`." +msgstr "" + +msgid "" +"Return the ``(column, row)`` of the grid cell that contains the pixel at " +"position (*x*, *y*), given in pixels relative to this container. For " +"locations above or to the left of the grid, ``-1`` is returned for the " +"corresponding coordinate." +msgstr "" + +msgid "" +"Enable or disable geometry propagation for this container when it manages " +"its children with the grid geometry manager. When *flag* is true, the " +"container resizes itself to fit the requested sizes of its children; when it " +"is false, its size is left under your control. Called with no argument, " +"return the current setting as a boolean." +msgstr "" + +msgid "" +"Return the size of the grid managed by this container as a ``(columns, " +"rows)`` tuple." +msgstr "" + +msgid "" +":meth:`size` is an alias of :meth:`!grid_size`, except on " +"the :class:`Listbox` widget, which provides its own :meth:`!size` method." +msgstr "" + +msgid "" +"Return a list of the child widgets managed in this container's grid, most " +"recently managed first. If *row* or *column* is given, only the children in " +"that row or column are returned." +msgstr "" + +msgid "" +"Enable or disable geometry propagation for this container when it manages " +"its children with the pack geometry manager. When *flag* is true, the " +"container resizes itself to fit the requested sizes of its children; when it " +"is false, its size is left under your control. Called with no argument, " +"return the current setting as a boolean." +msgstr "" + +msgid ":meth:`propagate` is an alias of :meth:`!pack_propagate`." +msgstr "" + +msgid "" +"Return a list of the child widgets managed by this container with the pack " +"geometry manager, in packing order." +msgstr "" + +msgid ":meth:`slaves` is an alias of :meth:`!pack_slaves`." +msgstr "" + +msgid "" +"Return a list of the child widgets managed by this container with the place " +"geometry manager." +msgstr "" + +msgid "" +"Bind the event pattern *sequence* on this widget to the callable *func*." +msgstr "" + +msgid "" +"*sequence* is an event pattern, such as ``''`` (a mouse click) or " +"``''``, optionally a concatenation of several such patterns that " +"must occur shortly after one another. When the event occurs, *func* is " +"called with an :class:`Event` instance describing it as its only argument; " +"if *func* returns the string ``'break'``, no further bindings for the event " +"are invoked." +msgstr "" + +msgid "" +"If *add* is true, *func* is added to any functions already bound to " +"*sequence*; otherwise it replaces them. The binding applies only to this " +"widget." +msgstr "" + +msgid "" +":meth:`!bind` returns a string identifier (a *funcid*) that can later be " +"passed to :meth:`unbind` to remove the binding without leaking the " +"associated Tcl command." +msgstr "" + +msgid "" +"If *func* is omitted, return the binding currently associated with " +"*sequence*; if *sequence* is also omitted, return a list of all the " +"sequences for which bindings exist on this widget." +msgstr "" + +msgid "" +"Like :meth:`bind`, but bind *func* to the binding tag *className* rather " +"than to a single widget, so that the binding applies to every widget having " +"that tag. *className* is usually the name of a widget class, such as " +"``'Button'``, in which case the binding affects all widgets of that class. " +"The set of binding tags for a widget can be inspected and changed " +"with :meth:`bindtags`." +msgstr "" + +msgid "The remaining arguments and the return value are as for :meth:`bind`." +msgstr "" + +msgid "" +"Like :meth:`bind`, but bind *func* to the special binding tag ``'all'``, so " +"that the binding applies to every widget in the application." +msgstr "" + +msgid "Remove bindings for the event pattern *sequence* on this widget." +msgstr "" + +msgid "" +"If *funcid* is given, only the function identified by it (a value returned " +"from a previous call to :meth:`bind`) is removed, and its associated Tcl " +"command is deleted. Otherwise all bindings for *sequence* are destroyed, " +"leaving it unbound." +msgstr "" + +msgid "" +"If *funcid* is given, only that callback is unbound; other callbacks bound " +"to *sequence* are kept." +msgstr "" + +msgid "" +"Remove all bindings for the event pattern *sequence* from the binding tag " +"*className*. See :meth:`bind_class`." +msgstr "" + +msgid "" +"Remove all bindings for the event pattern *sequence* from the special " +"binding tag ``'all'``. See :meth:`bind_all`." +msgstr "" + +msgid "" +"If *tagList* is omitted, return a tuple of the binding tags associated with " +"this widget. When an event occurs in a widget, it is applied to each of the " +"widget's binding tags in order, and for each tag the most specific matching " +"binding is executed. By default a widget has four binding tags: its own " +"pathname, its widget class, the pathname of its nearest toplevel ancestor, " +"and ``'all'``, in that order." +msgstr "" + +msgid "" +"If *tagList* is given, it must be a sequence of strings; the widget's " +"binding tags are set to its elements, which determines the order in which " +"bindings are evaluated." +msgstr "" + +msgid "" +"The methods with the ``event_`` prefix define virtual events and generate " +"events programmatically." +msgstr "" + +msgid "" +"Associate the virtual event *virtual*, whose name has the form " +"``'<>'``, with each of the physical event patterns given by " +"*sequences*, so that the virtual event triggers whenever any of them occurs. " +"If *virtual* is already defined, the new sequences are added to its existing " +"ones." +msgstr "" + +msgid "" +"Remove each of *sequences* from those associated with the virtual event " +"*virtual*. Sequences that are not currently associated with *virtual* are " +"ignored. If no *sequences* are given, all physical event sequences are " +"removed, so that *virtual* no longer triggers." +msgstr "" + +msgid "" +"Generate the event *sequence* on this widget and arrange for it to be " +"processed just as if it had come from the window system. *sequence* must be " +"a single event pattern, such as ``''`` or ``'<>'``, not a " +"concatenation of several. Keyword arguments specify additional fields of the " +"event, for example *x* and *y* for the pointer position, or *when* to " +"control when the event is processed; refer to the Tk ``event`` manual page " +"for the full list." +msgstr "" + +msgid "" +"If *virtual* is omitted, return a tuple of all the virtual events that are " +"currently defined. If *virtual* is given, return a tuple of the physical " +"event sequences currently associated with it, or an empty tuple if it is not " +"defined." +msgstr "" + +msgid "" +"The methods with the ``after`` prefix schedule callbacks to run after a " +"delay or when the application is idle." +msgstr "" + +msgid "" +"Schedule the callable *func* to be called after *ms* milliseconds, with " +"*args* and *kw* passed to it as positional and keyword arguments. Return an " +"identifier that can be passed to :meth:`after_cancel` to cancel the call." +msgstr "" + +msgid "" +"If *func* is omitted, sleep for *ms* milliseconds instead, processing no " +"events during that time, and return ``None``." +msgstr "" + +msgid "*func* can now be any callable object, not only a function." +msgstr "" + +msgid "Keyword arguments are now passed to *func*." +msgstr "" + +msgid "" +"Cancel a callback previously scheduled with :meth:`after` " +"or :meth:`after_idle`. *id* must be an identifier returned by one of those " +"methods; passing a value that is not such an identifier " +"raises :exc:`ValueError`. If the callback has already run or been cancelled, " +"this has no effect." +msgstr "" + +msgid "" +"Passing ``None`` (or any false value) as *id* now raises :exc:`ValueError`." +msgstr "" + +msgid "" +"Schedule the callable *func* to be called, with *args* and *kw* passed to " +"it, when the Tk main loop next becomes idle, that is, when it has no other " +"events to process. Return an identifier that can be passed " +"to :meth:`after_cancel` to cancel the call." +msgstr "" + +msgid "" +"If *id* is omitted, return a tuple of the identifiers of all callbacks " +"currently scheduled with :meth:`after` and :meth:`after_idle` for this " +"interpreter." +msgstr "" + +msgid "" +"If *id* is given, it must identify a callback that has not yet run or been " +"cancelled, and the return value is a tuple ``(script, type)``, where " +"*script* refers to the function to be called and *type* is either ``'idle'`` " +"or ``'timer'``. A :exc:`TclError` is raised if *id* does not exist." +msgstr "" + +msgid "" +"Enter the Tk event loop, which processes events until all windows are " +"destroyed. This is normally called once, on the root window, to run the " +"application." +msgstr "" + +msgid "Quit the Tcl interpreter, causing :meth:`mainloop` to return." +msgstr "" + +msgid "" +"Enter the event loop until all pending events, including idle callbacks, " +"have been processed. This brings the display up to date and handles any " +"events that are already queued, then returns." +msgstr "" + +msgid "" +"Enter the event loop until all pending idle callbacks have been called. This " +"updates the display of windows, for example after geometry changes, but does " +"not process events caused by the user." +msgstr "" + +msgid "" +"Wait until the Tcl variable *name* is modified, continuing to process events " +"in the meantime so that the application stays responsive. *name* is usually " +"a :class:`Variable` instance, such as an :class:`IntVar` " +"or :class:`StringVar`." +msgstr "" + +msgid ":meth:`waitvar` is an alias of :meth:`!wait_variable`." +msgstr "" + +msgid "" +"Wait until *window* is destroyed, continuing to process events in the " +"meantime. If *window* is omitted, this widget is used. This is typically " +"used to wait for the user to finish interacting with a dialog box." +msgstr "" + +msgid "" +"Wait until the visibility state of *window* changes, for example when it " +"first appears on the screen, continuing to process events in the meantime. " +"If *window* is omitted, this widget is used. This is typically used to wait " +"for a newly created window to become visible before acting on it." +msgstr "" + +msgid "The methods with the ``focus_`` prefix manage the keyboard focus." +msgstr "" + +msgid "" +"Direct the keyboard input focus for this widget's display to this widget. If " +"the application does not currently have the input focus on this widget's " +"display, the widget is remembered as the focus window for its top level, and " +"the focus will be redirected to it the next time the window manager gives " +"the focus to the top level. :meth:`focus` is an alias of :meth:`!focus_set`, " +"except on the :class:`Canvas` and :class:`ttk.Treeview " +"` widgets, which provide their own :meth:`!focus` " +"method." +msgstr "" + +msgid "" +"Direct the keyboard input focus to this widget even if the application does " +"not currently have the input focus for the widget's display. This method " +"should be used sparingly, if at all; normally an application should wait for " +"the window manager to give it the focus rather than claiming it." +msgstr "" + +msgid "" +"Return the widget that currently has the keyboard focus in the application, " +"or ``None`` if no widget in the application has the focus. " +"Use :meth:`focus_displayof` to work correctly with several displays." +msgstr "" + +msgid "" +"Return the widget that currently has the keyboard focus on the display where " +"this widget is located, or ``None`` if no widget in the application has the " +"focus on that display." +msgstr "" + +msgid "" +"Return the most recent widget to have had the keyboard focus among all the " +"widgets in the same top level as this widget; this is the widget that will " +"receive the focus the next time the window manager gives the focus to the " +"top level. If no widget in that top level has ever had the focus, or if the " +"most recent focus widget has been deleted, the top level itself is returned." +msgstr "" + +msgid "" +"Reconfigure Tk to use an implicit focus model in which the focus is set to a " +"widget whenever the mouse pointer enters it. This cannot easily be disabled " +"once enabled." +msgstr "" + +msgid "" +"Return the next widget after this one in the keyboard traversal order, or " +"``None`` if there is none. The traversal order goes first to the next child, " +"then recursively to the children of that child, and then to the next sibling " +"higher in the stacking order. A widget is skipped if its ``takefocus`` " +"option is set to ``0``. This method is used in the default bindings for " +"the :kbd:`Tab` key." +msgstr "" + +msgid "" +"Return the previous widget before this one in the keyboard traversal order, " +"or ``None`` if there is none. See :meth:`tk_focusNext` for how the order is " +"defined. This method is used in the default bindings for the :kbd:`Shift-" +"Tab` key." +msgstr "" + +msgid "" +"The methods with the ``grab_`` prefix set and query the input grab, which " +"directs all input events to a single widget." +msgstr "" + +msgid "" +"Set a local grab on this widget. A grab confines pointer events to this " +"widget and its descendants: while the pointer is outside the widget's " +"subtree, button presses and releases and pointer motion are reported to the " +"grab widget, and windows outside the subtree become insensitive until the " +"grab is released. A local grab affects only the grabbing application. Any " +"grab previously set by this application on the widget's display is " +"automatically released. Setting a grab is the usual way to make a dialog " +"modal: while the grab is in effect the user cannot interact with the other " +"windows of the application." +msgstr "" + +msgid "" +"Set a global grab on this widget. A global grab is like the local grab set " +"by :meth:`grab_set`, but it locks out all other applications on the screen, " +"so that only this widget's subtree is sensitive to pointer events, and it " +"also grabs the keyboard. Use with caution: it is easy to render a display " +"unusable with a global grab, since other applications stop receiving events " +"until it is released." +msgstr "" + +msgid "Release the grab on this widget if there is one; otherwise do nothing." +msgstr "" + +msgid "" +"Return the widget that currently holds the grab in this application for this " +"widget's display, or ``None`` if there is no such widget." +msgstr "" + +msgid "" +"Return ``None`` if no grab is currently set on this widget, ``\"local\"`` if " +"a local grab is set, or ``\"global\"`` if a global grab is set." +msgstr "" + +msgid "" +"The methods with the ``selection_`` prefix retrieve and manage the X " +"selection." +msgstr "" + +msgid "" +"Clear the X selection, so that no window owns it anymore. The selection to " +"clear is given by the keyword argument *selection*, an atom name such as " +"``'PRIMARY'`` or ``'CLIPBOARD'``; it defaults to ``PRIMARY``. The " +"*displayof* keyword argument names a widget that determines the display on " +"which to operate, and defaults to this widget." +msgstr "" + +msgid "" +"This is overridden by the :class:`Entry`, :class:`Listbox` " +"and :class:`Spinbox` widgets, where :meth:`!selection_clear` clears the " +"widget's own selection instead." +msgstr "" + +msgid "" +"Return the contents of the current X selection. The keyword argument " +"*selection* names the selection and defaults to ``PRIMARY``. The keyword " +"argument *type* specifies the form in which the data is to be returned (the " +"desired conversion target), an atom name such as ``'STRING'`` or " +"``'FILE_NAME'``; it defaults to ``STRING``, except on X11, where " +"``UTF8_STRING`` is tried first and ``STRING`` is used as a fallback. The " +"*displayof* keyword argument names a widget that determines the display from " +"which to retrieve the selection, and defaults to this widget." +msgstr "" + +msgid "" +"Register *command* as a handler to supply the X selection owned by this " +"widget when another application requests it. When the selection is " +"retrieved, *command* is called with two arguments, the starting character " +"offset and the maximum number of characters to return, and must return at " +"most that many characters of the selection starting at that offset; for very " +"long selections it is called repeatedly with increasing offsets. The keyword " +"argument *selection* names the selection (default ``PRIMARY``) and the " +"keyword argument *type* gives the form of the selection that the handler " +"supplies (such as ``'STRING'`` or ``'FILE_NAME'``, default ``STRING``)." +msgstr "" + +msgid "" +"Make this widget the owner of the X selection on its display. The previous " +"owner, if any, is notified that it has lost the selection. The keyword " +"argument *selection* names the selection and defaults to ``PRIMARY``." +msgstr "" + +msgid "" +"Return the widget in this application that owns the X selection on the " +"display containing this widget, or ``None`` if no widget in this application " +"owns the selection. The keyword argument *selection* names the selection and " +"defaults to ``PRIMARY``. The *displayof* keyword argument names a widget " +"that determines the display to query, and defaults to this widget." +msgstr "" + +msgid "The methods with the ``clipboard_`` prefix manage the clipboard." +msgstr "" + +msgid "" +"Append *string* to the Tk clipboard and claim ownership of the clipboard on " +"this widget's display. Before appending, the clipboard should be emptied " +"with :meth:`clipboard_clear`; all appends should be completed before " +"returning to the event loop so that the clipboard is updated atomically. The " +"keyword argument *type* specifies the form of the data, an atom name such as " +"``'STRING'`` or ``'FILE_NAME'`` (default ``STRING``), and the keyword " +"argument *format* specifies the representation used to transmit it (default " +"``STRING``). The *displayof* keyword argument names a widget that determines " +"the target display, and defaults to this widget. The contents can be " +"retrieved with :meth:`clipboard_get` or :meth:`selection_get`." +msgstr "" + +msgid "" +"Claim ownership of the clipboard on this widget's display and remove any " +"previous contents. The *displayof* keyword argument names a widget that " +"determines the target display, and defaults to this widget." +msgstr "" + +msgid "" +"Retrieve data from the clipboard on this widget's display. The keyword " +"argument *type* specifies the form in which the data is to be returned, an " +"atom name such as ``'STRING'`` or ``'FILE_NAME'``; it defaults to " +"``STRING``, except on X11, where ``UTF8_STRING`` is tried first and " +"``STRING`` is used as a fallback. The *displayof* keyword argument names a " +"widget that determines the display, and defaults to the root window of the " +"application. This is equivalent to ``selection_get(selection='CLIPBOARD')``." +msgstr "" + +msgid "" +"The methods with the ``option_`` prefix query and modify the Tk option " +"database." +msgstr "" + +msgid "" +"Add an option to the Tk option database that associates *value* with " +"*pattern*. *pattern* consists of names and/or classes separated by asterisks " +"or dots, in the usual X format. *priority* is an integer between 0 and 100, " +"or one of the symbolic names ``'widgetDefault'`` (20), ``'startupFile'`` " +"(40), ``'userDefault'`` (60), or ``'interactive'`` (80); it defaults to " +"``interactive``." +msgstr "" + +msgid "" +"Clear the Tk option database. Default options from the :envvar:`!" +"RESOURCE_MANAGER` property or the :file:`.Xdefaults` file are reloaded " +"automatically the next time an option is added to or removed from the " +"database." +msgstr "" + +msgid "" +"Return the value of the option matching this widget under *name* and " +"*className* from the Tk option database, or an empty string if there is no " +"matching entry. When several entries match, the one with the highest " +"priority is returned, and among entries of equal priority the most recently " +"added one." +msgstr "" + +msgid "" +"Read the file named *fileName*, which should have the standard format for an " +"X resource database such as :file:`.Xdefaults`, and add all the options it " +"specifies to the Tk option database. *priority* is interpreted as " +"for :meth:`option_add` and defaults to ``interactive``." +msgstr "" + +msgid "" +"Ring the bell on the display for this widget, using the display's current " +"bell-related settings, and reset the screen saver for the screen. If " +"*displayof* is given as a widget, the bell is rung on that widget's display " +"instead." +msgstr "" + +msgid "" +"Set a new color scheme for all Tk widget elements. Existing widgets are " +"updated and the option database is changed so that future widgets use the " +"new colors. A single color argument is taken as the normal background color, " +"from which a complete palette is computed. Alternatively, the arguments may " +"be given as keyword *name*/*value* pairs naming individual options in the " +"option database. The recognized option names are ``activeBackground``, " +"``activeForeground``, ``background``, ``disabledForeground``, " +"``foreground``, ``highlightBackground``, ``highlightColor``, " +"``insertBackground``, ``selectColor``, ``selectBackground``, " +"``selectForeground``, and ``troughColor``; reasonable defaults are computed " +"for any that are not specified." +msgstr "" + +msgid "" +"Restore the application's colors to the light brown (bisque) color scheme " +"used in Tk 3.6 and earlier versions. Provided for backward compatibility." +msgstr "" + +msgid "" +"Query or set whether Tk's look and feel should strictly adhere to Motif. A " +"true *boolean* value enables strict Motif compliance (for example, no color " +"change when the mouse passes over a slider). Return the resulting setting." +msgstr "" + +msgid "" +"The methods with the ``busy_`` prefix manage the busy state of a window, " +"which shows a busy cursor and ignores user input." +msgstr "" + +msgid "" +"Make this widget appear busy. A transparent window is placed in front of the " +"widget, so that it and all of its descendants in the widget hierarchy are " +"blocked from pointer events and display a busy cursor. " +"Normally :meth:`update` should be called immediately afterwards to ensure " +"that the hold operation is in effect before the application starts its " +"processing." +msgstr "" + +msgid "" +"The only supported configuration option is *cursor*, the cursor to be " +"displayed while the widget is busy; it may have any of the values accepted " +"by :meth:`!configure`." +msgstr "" + +msgid "" +":meth:`busy_hold`, :meth:`busy` and :meth:`tk_busy` are aliases of :meth:`!" +"tk_busy_hold`." +msgstr "" + +msgid "" +"Query or modify the configuration options of the busy window. The widget " +"must have been previously made busy by :meth:`tk_busy_hold`. With no " +"arguments, return a dictionary describing all of the available options; if " +"*cnf* is the name of an option, return a tuple describing that one option. " +"Otherwise set the given options to the given values. Options may have any of " +"the values accepted by :meth:`tk_busy_hold`." +msgstr "" + +msgid "" +"The option database is referenced through the widget name or class. For " +"example, if a :class:`Frame` widget named ``frame`` is to be made busy, the " +"busy cursor can be specified for it by either of the calls::" +msgstr "" + +msgid "" +"w.option_add('*frame.busyCursor', 'gumby')\n" +"w.option_add('*Frame.BusyCursor', 'gumby')" +msgstr "" + +msgid "" +":meth:`busy_configure`, :meth:`busy_config` and :meth:`tk_busy_config` are " +"aliases of :meth:`!tk_busy_configure`." +msgstr "" + +msgid "" +"Return the current value of the busy configuration *option*. The widget must " +"have been previously made busy by :meth:`tk_busy_hold`, and *option* may " +"have any of the values accepted by that method." +msgstr "" + +msgid ":meth:`busy_cget` is an alias of :meth:`!tk_busy_cget`." +msgstr "" + +msgid "" +"Make this widget no longer busy, releasing the resources (including the " +"transparent window) allocated when it was made busy. User events will again " +"be received by the widget. These resources are also released when the widget " +"is destroyed." +msgstr "" + +msgid ":meth:`busy_forget` is an alias of :meth:`!tk_busy_forget`." +msgstr "" + +msgid "Return ``True`` if the widget is currently busy, ``False`` otherwise." +msgstr "" + +msgid ":meth:`busy_status` is an alias of :meth:`!tk_busy_status`." +msgstr "" + +msgid "" +"Return a list of widgets that are currently busy. If *pattern* is given, " +"only busy widgets whose path names match the pattern are returned." +msgstr "" + +msgid ":meth:`busy_current` is an alias of :meth:`!tk_busy_current`." +msgstr "" + +msgid "" +"The methods with the ``winfo_`` prefix retrieve information about windows " +"managed by Tk." +msgstr "" + +msgid "" +"Return the integer identifier for the atom whose name is *name*, creating a " +"new atom if none exists. If *displayof* is given, the atom is looked up on " +"the display of that window; otherwise it is looked up on the display of the " +"application's main window." +msgstr "" + +msgid "" +"Return the textual name for the atom whose integer identifier is *id*. This " +"is the inverse of :meth:`winfo_atom`. If *displayof* is given, the " +"identifier is looked up on the display of that window; otherwise it is " +"looked up on the display of the application's main window." +msgstr "" + +msgid "Return the number of cells in the colormap for the widget." +msgstr "" + +msgid "" +"Return a list containing the widgets that are children of the widget, in " +"stacking order from lowest to highest. Toplevel windows are returned as " +"children of their logical parents." +msgstr "" + +msgid "Return the class name of the widget." +msgstr "" + +msgid "" +"Return ``True`` if the colormap for the widget is known to be full, " +"``False`` otherwise." +msgstr "" + +msgid "" +"Return the widget containing the point given by *rootX* and *rootY*, or " +"``None`` if no window in this application contains the point. The " +"coordinates are in screen units in the coordinate system of the root window. " +"If *displayof* is given, the coordinates refer to the screen containing that " +"window; otherwise they refer to the screen of the application's main window." +msgstr "" + +msgid "Return the depth of the widget, that is, the number of bits per pixel." +msgstr "" + +msgid "Return true if the widget exists, false otherwise." +msgstr "" + +msgid "" +"Return a floating-point value giving the number of pixels in the widget " +"corresponding to the screen distance *number* (for example, ``\"2.0c\"`` or " +"``\"1i\"``). The result may be fractional; for a rounded integer value " +"use :meth:`winfo_pixels`." +msgstr "" + +msgid "" +"Return the geometry of the widget, in the form ``widthxheight+x+y``. All " +"dimensions are in pixels. The position is relative to the parent widget; " +"use :meth:`winfo_rootx` and :meth:`winfo_rooty` for the position on the " +"screen. An offset can be negative; see :meth:`~Wm.geometry`." +msgstr "" + +msgid "" +"Return the height of the widget in pixels. When a window is first created " +"its height is 1 pixel; it is eventually changed by a geometry manager. See " +"also :meth:`winfo_reqheight`." +msgstr "" + +msgid "" +"Return a low-level platform-specific identifier for the widget. On Unix this " +"is the X window identifier, and on Windows it is the window handle." +msgstr "" + +msgid "" +"Return a tuple of the names of all Tcl interpreters currently registered for " +"a particular display. If *displayof* is given, the return value refers to " +"the display of that window; otherwise it refers to the display of the " +"application's main window." +msgstr "" + +msgid "Return true if the widget is currently mapped, false otherwise." +msgstr "" + +msgid "" +"Return the name of the geometry manager currently responsible for the " +"widget, or an empty string if it is not managed by any geometry manager." +msgstr "" + +msgid "" +"Return the widget's name within its parent, as opposed to its full path name." +msgstr "" + +msgid "" +"Return the path name of the widget's parent, or an empty string if the " +"widget is the main window of the application." +msgstr "" + +msgid "" +"Return the path name of the window whose identifier is *id*. If *displayof* " +"is given, the identifier is looked up on the display of that window; " +"otherwise it is looked up on the display of the application's main window." +msgstr "" + +msgid "" +"Return the number of pixels in the widget corresponding to the screen " +"distance *number* (for example, ``\"2.0c\"`` or ``\"1i\"``). The result is " +"rounded to the nearest integer; for a fractional result " +"use :meth:`winfo_fpixels`." +msgstr "" + +msgid "" +"Return the pointer's *x* coordinate, in pixels, relative to the screen's " +"root window (or virtual root, if one is in use). Return ``-1`` if the " +"pointer is not on the same screen as the widget." +msgstr "" + +msgid "" +"Return the pointer's coordinates as an ``(x, y)`` tuple, in pixels, relative " +"to the screen's root window (or virtual root, if one is in use). Both " +"coordinates are ``-1`` if the pointer is not on the same screen as the " +"widget." +msgstr "" + +msgid "" +"Return the pointer's *y* coordinate, in pixels, relative to the screen's " +"root window (or virtual root, if one is in use). Return ``-1`` if the " +"pointer is not on the same screen as the widget." +msgstr "" + +msgid "" +"Return the widget's requested height in pixels. This is the value used by " +"the widget's geometry manager to compute its geometry." +msgstr "" + +msgid "" +"Return the widget's requested width in pixels. This is the value used by the " +"widget's geometry manager to compute its geometry." +msgstr "" + +msgid "" +"Return an ``(r, g, b)`` tuple of the red, green, and blue intensities, in " +"the range 0 to 65535, that correspond to *color* in the widget. *color* may " +"be specified in any of the forms acceptable for a color option." +msgstr "" + +msgid "" +"Return the *x* coordinate, in the root window of the screen, of the upper-" +"left corner of the widget's border (or of the widget itself if it has no " +"border)." +msgstr "" + +msgid "" +"Return the *y* coordinate, in the root window of the screen, of the upper-" +"left corner of the widget's border (or of the widget itself if it has no " +"border)." +msgstr "" + +msgid "" +"Return the name of the screen associated with the widget, in the form " +"``displayName.screenIndex``." +msgstr "" + +msgid "" +"Return the number of cells in the default colormap for the widget's screen." +msgstr "" + +msgid "" +"Return the depth of the root window of the widget's screen, that is, the " +"number of bits per pixel." +msgstr "" + +msgid "Return the height of the widget's screen in pixels." +msgstr "" + +msgid "Return the height of the widget's screen in millimeters." +msgstr "" + +msgid "Return the width of the widget's screen in millimeters." +msgstr "" + +msgid "" +"Return the default visual class for the widget's screen, one of " +"``\"directcolor\"``, ``\"grayscale\"``, ``\"pseudocolor\"``, " +"``\"staticcolor\"``, ``\"staticgray\"``, or ``\"truecolor\"``." +msgstr "" + +msgid "Return the width of the widget's screen in pixels." +msgstr "" + +msgid "" +"Return a string containing information about the server for the widget's " +"display. The exact format of this string may vary from platform to platform." +msgstr "" + +msgid "" +"Return the top-of-hierarchy window containing the widget. In standard Tk " +"this is always a :class:`Toplevel` widget." +msgstr "" + +msgid "" +"Return true if the widget and all of its ancestors up through the nearest " +"toplevel window are mapped, false otherwise." +msgstr "" + +msgid "" +"Return the visual class for the widget, one of ``\"directcolor\"``, " +"``\"grayscale\"``, ``\"pseudocolor\"``, ``\"staticcolor\"``, " +"``\"staticgray\"``, or ``\"truecolor\"``." +msgstr "" + +msgid "Return the X identifier for the visual for the widget." +msgstr "" + +msgid "" +"Return a list describing the visuals available for the widget's screen. Each " +"item consists of a visual class (see :meth:`winfo_visual`) followed by an " +"integer depth. If *includeids* is true, the X identifier for the visual is " +"also included." +msgstr "" + +msgid "" +"Return the height of the virtual root window associated with the widget if " +"there is one; otherwise return the height of the widget's screen." +msgstr "" + +msgid "" +"Return the width of the virtual root window associated with the widget if " +"there is one; otherwise return the width of the widget's screen." +msgstr "" + +msgid "" +"Return the *x* offset of the virtual root window associated with the widget, " +"relative to the root window of its screen. This is normally zero or " +"negative, and is ``0`` if there is no virtual root window." +msgstr "" + +msgid "" +"Return the *y* offset of the virtual root window associated with the widget, " +"relative to the root window of its screen. This is normally zero or " +"negative, and is ``0`` if there is no virtual root window." +msgstr "" + +msgid "" +"Return the width of the widget in pixels. When a window is first created its " +"width is 1 pixel; it is eventually changed by a geometry manager. See " +"also :meth:`winfo_reqwidth`." +msgstr "" + +msgid "" +"Return the *x* coordinate, in the widget's parent, of the upper-left corner " +"of the widget's border (or of the widget itself if it has no border)." +msgstr "" + +msgid "" +"Return the *y* coordinate, in the widget's parent, of the upper-left corner " +"of the widget's border (or of the widget itself if it has no border)." +msgstr "" + +msgid "" +"Return the Tcl/Tk patch level as a named tuple with the same five fields " +"as :data:`sys.version_info`: *major*, *minor*, *micro*, *releaselevel* and " +"*serial*. *releaselevel* is ``'alpha'``, ``'beta'`` or ``'final'``. " +"Converting it to a string gives the version in the usual Tcl/Tk notation, " +"for example ``'9.0.3'`` for a final release or ``'9.1b2'`` for a pre-release." +msgstr "" + +msgid "" +"The :class:`!Wm` mixin provides access to the window manager, allowing an " +"application to control such things as the title, geometry and icon of a top-" +"level window, the way it is resized, and how it responds to window manager " +"protocols. It is mixed into :class:`Tk` and :class:`Toplevel`, so its " +"methods are available on every top-level window. Each method has two " +"equivalent spellings: a short name and a ``wm_``-prefixed name (for " +"example, :meth:`title` and :meth:`wm_title`). See also :ref:`tkinter-window-" +"manager`." +msgstr "" + +msgid "" +"Constrain the aspect ratio (the ratio of width to height) of the window. If " +"all four arguments are given, the window manager keeps the ratio between " +"``minNumer/minDenom`` and ``maxNumer/maxDenom``; passing empty strings " +"removes any existing restriction. With no arguments, return a tuple of the " +"four current values, or ``None`` if no aspect restriction is in " +"effect. :meth:`wm_aspect` is an alias of :meth:`!aspect`." +msgstr "" + +msgid "" +"Query or set platform-specific attributes of the window. With no arguments, " +"return the platform-specific flags and their values; pass " +"*return_python_dict* as true to get them as a dictionary. A single option " +"name such as ``'alpha'`` returns the value of that option, and options are " +"set using keyword arguments (``alpha=0.5``)." +msgstr "" + +msgid "The available attributes differ by platform. All platforms support:" +msgstr "" + +msgid "*alpha*" +msgstr "" + +msgid "" +"The window's opacity, from ``0.0`` (fully transparent) to ``1.0`` (opaque). " +"Where transparency is unsupported the value stays at ``1.0``." +msgstr "" + +msgid "*appearance*" +msgstr "" + +msgid "" +"Whether the window is rendered in dark mode on Windows and macOS: " +"``'auto'``, ``'light'`` or ``'dark'`` (this has no effect on X11)." +msgstr "" + +msgid "*fullscreen*" +msgstr "" + +msgid "Whether the window takes up the entire screen and has no borders." +msgstr "" + +msgid "*topmost*" +msgstr "" + +msgid "Whether the window is displayed above all other windows." +msgstr "" + +msgid "Windows additionally supports:" +msgstr "" + +msgid "*disabled*" +msgstr "" + +msgid "Whether the window is in a disabled state." +msgstr "" + +msgid "*toolwindow*" +msgstr "" + +msgid "Whether the window uses the tool window style." +msgstr "" + +msgid "*transparentcolor*" +msgstr "" + +msgid "The color that is made fully transparent, or an empty string for none." +msgstr "" + +msgid "macOS additionally supports:" +msgstr "" + +msgid "*class*" +msgstr "" + +msgid "" +"Whether the underlying Aqua window is an ``nswindow`` or an ``nspanel``; " +"this can only be set before the window is created." +msgstr "" + +msgid "*modified*" +msgstr "" + +msgid "" +"The modification state shown by the window's close button and proxy icon." +msgstr "" + +msgid "*notify*" +msgstr "" + +msgid "Whether the application's dock icon bounces to request attention." +msgstr "" + +msgid "*stylemask*" +msgstr "" + +msgid "" +"The style mask of the underlying Aqua window, given as a list of bit names " +"such as ``titled`` or ``resizable``." +msgstr "" + +msgid "*tabbingid*" +msgstr "" + +msgid "The identifier of the tab group that the window belongs to." +msgstr "" + +msgid "*tabbingmode*" +msgstr "" + +msgid "" +"Whether the window may be opened as a tab: ``'auto'``, ``'preferred'`` or " +"``'disallowed'``." +msgstr "" + +msgid "*titlepath*" +msgstr "" + +msgid "The path of the file represented by the window's proxy icon." +msgstr "" + +msgid "*transparent*" +msgstr "" + +msgid "" +"Whether the content area is transparent and the window shadow is turned off." +msgstr "" + +msgid "X11 additionally supports:" +msgstr "" + +msgid "*type*" +msgstr "" + +msgid "" +"The window type, or a list of types in order of preference, that the window " +"manager should use to interpret the window, such as ``'dialog'`` or " +"``'splash'``." +msgstr "" + +msgid "*zoomed*" +msgstr "" + +msgid "Whether the window is maximized." +msgstr "" + +msgid "" +"Tk 8.6 added the *type* attribute, and Tk 9.0 added the *appearance*, " +"*class*, *stylemask*, *tabbingid* and *tabbingmode* attributes." +msgstr "" + +msgid "" +"On X11 changes are applied asynchronously, so a queried value may not yet " +"reflect the most recent request. :meth:`wm_attributes` is an alias " +"of :meth:`!attributes`." +msgstr "" + +msgid "" +"A single attribute may now be queried by name without the leading ``-``, and " +"attributes may be set using keyword arguments. The *return_python_dict* " +"parameter was added." +msgstr "" + +msgid "" +"Setting an attribute by passing the option name (with a leading ``-``) and " +"its value as two positional arguments, as in ``w.attributes('-alpha', " +"0.5)``, is deprecated; use keyword arguments instead." +msgstr "" + +msgid "" +"Store *name*, which should be the name of the host on which the application " +"is running, in the window's ``WM_CLIENT_MACHINE`` property for use by the " +"window or session manager. An empty string deletes the property. With no " +"argument, return the last name set, or an empty string. :meth:`wm_client` is " +"an alias of :meth:`!client`." +msgstr "" + +msgid "" +"Manipulate the ``WM_COLORMAP_WINDOWS`` property, which tells the window " +"manager about windows that have private colormaps. If *wlist* is given, " +"overwrite the property with those windows (their order is a priority order " +"for installing colormaps). With no arguments, return the list of windows " +"currently named in the property. :meth:`wm_colormapwindows` is an alias " +"of :meth:`!colormapwindows`." +msgstr "" + +msgid "" +"Store *value* in the window's ``WM_COMMAND`` property for use by the window " +"or session manager; it should be a list giving the words of the command used " +"to invoke the application. An empty string deletes the property. With no " +"argument, return the last value set, or an empty string. :meth:`wm_command` " +"is an alias of :meth:`!command`." +msgstr "" + +msgid "" +"Display the window in normal (non-iconified) form by mapping it. If the " +"window has never been mapped, this ensures it appears de-iconified when it " +"is first mapped. On Windows the window is also raised and given the " +"focus. :meth:`wm_deiconify` is an alias of :meth:`!deiconify`." +msgstr "" + +msgid "" +"Set or query the focus model for the window. *model* is either ``'active'`` " +"(the window claims the input focus for itself or its descendants, even when " +"the focus is in another application) or ``'passive'`` (the window relies on " +"the window manager to give it the focus). With no argument, return the " +"current model. The default is ``'passive'``, which is what the :meth:`!" +"focus` command assumes. :meth:`wm_focusmodel` is an alias of :meth:`!" +"focusmodel`." +msgstr "" + +msgid "" +"Unmap *window* from the screen so that it is no longer managed by the window " +"manager. A :class:`Toplevel` is then treated like a :class:`Frame`, although " +"its ``-menu`` configuration is remembered and the menu reappears if the " +"widget is managed again. :meth:`wm_forget` is an alias of :meth:`!forget`." +msgstr "" + +msgid "Not to be confused with :meth:`Pack.forget`." +msgstr "" + +msgid "" +"Return the platform-specific window identifier for the outermost decorative " +"frame containing the window, if the window manager has reparented it into " +"such a frame; otherwise return the identifier of the window " +"itself. :meth:`wm_frame` is an alias of :meth:`!frame`." +msgstr "" + +msgid "" +"Set or query the geometry of the window. *newGeometry* has the form " +"``=widthxheight+x+y``, where any of ``=``, ``widthxheight`` and the ``+x+y`` " +"position may be omitted. *width* and *height* are in pixels (or grid units " +"for a gridded window); a position preceded by ``+`` is measured from the " +"left or top edge of the screen and one preceded by ``-`` from the right or " +"bottom edge. An offset can be negative, as in ``'200x100+-9+-8'``, when the " +"window edge is positioned beyond the corresponding screen edge. An empty " +"string cancels any user-specified geometry, letting the window revert to its " +"natural size. With no argument, return the current geometry as a string of " +"the form ``'200x200+10+10'``. :meth:`wm_geometry` is an alias of :meth:`!" +"geometry`." +msgstr "" + +msgid "" +"Manage the window as a gridded window and define the relationship between " +"grid units and pixels. *baseWidth* and *baseHeight* are the numbers of grid " +"units for the window's internally requested size, and *widthInc* and " +"*heightInc* are the pixel sizes of a horizontal and vertical grid unit. " +"Empty strings turn off gridded management. With no arguments, return a tuple " +"of the four current values, or ``None`` if the window is not " +"gridded. :meth:`wm_grid` is an alias of :meth:`!grid`." +msgstr "" + +msgid "Not to be confused with the grid geometry manager :meth:`Grid.grid`." +msgstr "" + +msgid "" +"Set or query the leader of a group of related windows. *pathName* gives the " +"path name of the group leader; the window manager may, for example, unmap " +"all windows in the group when the leader is iconified. An empty string " +"removes the window from any group. With no argument, return the path name of " +"the current group leader, or an empty string. :meth:`wm_group` is an alias " +"of :meth:`!group`." +msgstr "" + +msgid "" +"Set or query the bitmap used by the window manager for the window's icon. " +"*bitmap* names a bitmap in one of the standard forms accepted by Tk; an " +"empty string cancels the current icon bitmap. With no argument, return the " +"name of the current icon bitmap, or an empty string. On Windows the " +"*default* argument names an icon (for example an ``.ico`` file) applied to " +"all top-level windows that have no icon of their own. :meth:`wm_iconbitmap` " +"is an alias of :meth:`!iconbitmap`." +msgstr "" + +msgid "" +"Iconify the window. If the window has not yet been mapped for the first " +"time, arrange for it to appear in the iconified state when it is eventually " +"mapped. :meth:`wm_iconify` is an alias of :meth:`!iconify`." +msgstr "" + +msgid "" +"Set or query the bitmap used as a mask for the icon " +"(see :meth:`iconbitmap`). Where the mask is zero no icon is displayed; where " +"it is one, the corresponding bits of the icon bitmap are shown. An empty " +"string cancels the current mask. With no argument, return the name of the " +"current icon mask, or an empty string. :meth:`wm_iconmask` is an alias " +"of :meth:`!iconmask`." +msgstr "" + +msgid "" +"Set or query the name displayed by the window manager inside the window's " +"icon. With no argument, return the current icon name, or an empty string if " +"none has been set (in which case the window manager normally displays the " +"window's title). :meth:`wm_iconname` is an alias of :meth:`!iconname`." +msgstr "" + +msgid "" +"Set the titlebar icon for the window from one or more :class:`PhotoImage` " +"objects given in *images*. Several images of different sizes (for example " +"16x16 and 32x32) may be supplied so that the window manager can choose an " +"appropriate one. The image data is taken as a snapshot at the time of the " +"call; later changes to the images are not reflected. If *default* is true, " +"the icon is also applied to all top-level windows created in the future. On " +"macOS only the first image is used. :meth:`wm_iconphoto` is an alias " +"of :meth:`!iconphoto`." +msgstr "" + +msgid "" +"Set or query a hint to the window manager about where the window's icon " +"should be positioned. Empty strings cancel an existing hint. With no " +"arguments, return a tuple of the two current values, or ``None`` if no hint " +"is in effect. :meth:`wm_iconposition` is an alias of :meth:`!iconposition`." +msgstr "" + +msgid "" +"Set or query the window used as the icon for the window. When the window is " +"iconified, *pathName* is mapped to serve as its icon and unmapped again when " +"it is de-iconified. An empty string cancels the association. With no " +"argument, return the path name of the current icon window, or an empty " +"string. Not all window managers support icon windows, and the concept is " +"meaningless on non-X11 platforms. :meth:`wm_iconwindow` is an alias " +"of :meth:`!iconwindow`." +msgstr "" + +msgid "" +"Make *widget* a stand-alone top-level window, decorated by the window " +"manager with a title bar and so on. Only :class:`Frame`, :class:`LabelFrame` " +"and :class:`Toplevel` widgets may be used (the :mod:`tkinter.ttk` versions " +"are **not** accepted); passing any other widget type raises an " +"error. :meth:`wm_manage` is an alias of :meth:`!manage`." +msgstr "" + +msgid "" +"Set or query the maximum permissible dimensions of the window, in pixels (or " +"grid units for a gridded window). The window manager restricts the window to " +"be no larger than *width* and *height*. With no arguments, return a tuple of " +"the current maximum width and height. The maximum size defaults to the size " +"of the screen. :meth:`wm_maxsize` is an alias of :meth:`!maxsize`." +msgstr "" + +msgid "" +"Set or query the minimum permissible dimensions of the window, in pixels (or " +"grid units for a gridded window). The window manager restricts the window to " +"be no smaller than *width* and *height*. With no arguments, return a tuple " +"of the current minimum width and height. The minimum size defaults to one " +"pixel in each dimension. :meth:`wm_minsize` is an alias of :meth:`!minsize`." +msgstr "" + +msgid "" +"Set or query the override-redirect flag for the window. When this flag is " +"set, the window is ignored by the window manager: it is not reparented into " +"a decorative frame and the user cannot manipulate it through the usual " +"window manager controls. With no argument, return a boolean indicating " +"whether the flag is set, or ``None`` if it has not been set. The flag is " +"reliably honored only when the window is first mapped or remapped from the " +"withdrawn state. :meth:`wm_overrideredirect` is an alias of :meth:`!" +"overrideredirect`." +msgstr "" + +msgid "" +"Set or query the source of the window's current position. *who* is either " +"``'program'`` or ``'user'`` and indicates whether the position was requested " +"by the program or by the user; an empty string cancels the current source. " +"With no argument, return the current source, or an empty string if none has " +"been set. Tk automatically sets the source to ``'user'`` " +"when :meth:`geometry` is called, unless it has been set explicitly to " +"``'program'``. :meth:`wm_positionfrom` is an alias of :meth:`!positionfrom`." +msgstr "" + +msgid "" +"Register *func* as the handler for the window manager protocol *name*, an " +"atom such as ``'WM_DELETE_WINDOW'``, ``'WM_SAVE_YOURSELF'`` or " +"``'WM_TAKE_FOCUS'``; *func* is then called whenever the window manager sends " +"a message of that protocol. Tk installs a default ``WM_DELETE_WINDOW`` " +"handler that destroys the window, which this method can replace. If *func* " +"is an empty string, the handler is removed. With only *name*, return the " +"name of its registered handler command, or an empty string if none is set " +"(the default ``WM_DELETE_WINDOW`` handler is not reported); with no " +"arguments, return a tuple of the protocols that currently have " +"handlers. :meth:`wm_protocol` is an alias of :meth:`!protocol`." +msgstr "" + +msgid "" +"Control whether the user may interactively resize the window. *width* and " +"*height* are boolean values that determine whether the window's width and " +"height may be changed. With no arguments, return a tuple of two ``0``/``1`` " +"values indicating whether each dimension is currently resizable. By default " +"a window is resizable in both dimensions. :meth:`wm_resizable` is an alias " +"of :meth:`!resizable`." +msgstr "" + +msgid "" +"Set or query the source of the window's current size. *who* is either " +"``'program'`` or ``'user'`` and indicates whether the size was requested by " +"the program or by the user; an empty string cancels the current source. With " +"no argument, return the current source, or an empty string if none has been " +"set. :meth:`wm_sizefrom` is an alias of :meth:`!sizefrom`." +msgstr "" + +msgid "" +"Set or query the state of the window. With no argument, return the current " +"state: one of ``'normal'``, ``'iconic'``, ``'withdrawn'``, ``'icon'`` or, on " +"Windows and macOS only, ``'zoomed'``. ``'iconic'`` refers to a window that " +"has been iconified, while ``'icon'`` refers to a window serving as the icon " +"for another window (see :meth:`iconwindow`); the ``'icon'`` state cannot be " +"set. :meth:`wm_state` is an alias of :meth:`!state`." +msgstr "" + +msgid "" +"Not to be confused with :meth:`ttk.Widget.state `." +msgstr "" + +msgid "" +"Set or query the title for the window, which the window manager should " +"display in the window's title bar. With no argument, return the current " +"title. The title defaults to the window's name. :meth:`wm_title` is an alias " +"of :meth:`!title`." +msgstr "" + +msgid "" +"Mark the window as a transient window (such as a pull-down menu or dialog) " +"working on behalf of *master*, the path name of another top-level window. An " +"empty string clears the transient status. With no argument, return the path " +"name of the current master, or an empty string. A transient window mirrors " +"state changes in its master and may be decorated differently by the window " +"manager; it is an error to make a window a transient of " +"itself. :meth:`wm_transient` is an alias of :meth:`!transient`." +msgstr "" + +msgid "" +"Withdraw the window from the screen, unmapping it and causing the window " +"manager to forget about it. If the window has never been mapped, it is " +"instead mapped in the withdrawn state. It is sometimes necessary to withdraw " +"a window and then re-map it (for example with :meth:`deiconify`) to make " +"some window managers notice changes to window " +"attributes. :meth:`wm_withdraw` is an alias of :meth:`!withdraw`." +msgstr "" + +msgid "" +"Geometry manager that arranges widgets by packing them against the sides of " +"their container. The :class:`!Pack` mix-in is inherited by all widgets " +"(through :class:`Widget`) and provides the methods for managing a widget " +"with the *pack* geometry manager. See also :ref:`tkinter-geometry-" +"management`." +msgstr "" + +msgid "" +":class:`Pack`, :class:`Place` and :class:`Grid` all define the short method " +"names :meth:`!forget`, :meth:`!info`, :meth:`!slaves`, :meth:`!content` " +"and :meth:`!propagate`. On a widget the bare names resolve to the *pack* " +"manager's versions, since :class:`Pack` and :class:`Misc` " +"precede :class:`Place` and :class:`Grid` in the method resolution order, " +"whatever manager actually manages the widget; and :meth:`!configure`/:meth:`!" +"config` configure the widget's options, not its geometry. Use the explicit " +"``pack_*``, ``grid_*`` and ``place_*`` methods (and ``pack``, ``grid``, " +"``place`` for geometry configuration) to act on a specific geometry manager." +msgstr "" + +msgid "" +"Pack the widget inside its container, positioning it relative to the " +"siblings already packed there. The supported options are:" +msgstr "" + +msgid "*side*" +msgstr "" + +msgid "" +"Which side of the container to pack the widget against: ``'top'`` (the " +"default), ``'bottom'``, ``'left'`` or ``'right'``." +msgstr "" + +msgid "*fill*" +msgstr "" + +msgid "" +"Whether to stretch the widget to fill its parcel: ``'none'`` (the default), " +"``'x'``, ``'y'`` or ``'both'``." +msgstr "" + +msgid "*expand*" +msgstr "" + +msgid "" +"Whether the widget should expand to consume any extra space in its container " +"(a boolean, default false)." +msgstr "" + +msgid "*anchor*" +msgstr "" + +msgid "" +"Where to position the widget in its parcel when the parcel is larger than " +"the widget: an anchor such as ``'n'`` or ``'sw'`` (default ``'center'``)." +msgstr "" + +msgid "*ipadx*, *ipady*" +msgstr "" + +msgid "" +"Internal padding added on the left and right (*ipadx*) or top and bottom " +"(*ipady*) of the widget, as a screen distance (default ``0``)." +msgstr "" + +msgid "*padx*, *pady*" +msgstr "" + +msgid "" +"External padding left on the left and right (*padx*) or top and bottom " +"(*pady*) of the widget, as a screen distance or a pair of two distances for " +"the two sides (default ``0``)." +msgstr "" + +msgid "*after*" +msgstr "" + +msgid "" +"Pack the widget after the given widget in the packing order, using the same " +"container." +msgstr "" + +msgid "*before*" +msgstr "" + +msgid "" +"Pack the widget before the given widget in the packing order, using the same " +"container." +msgstr "" + +msgid "*in_*" +msgstr "" + +msgid "" +"The container in which to pack the widget; it defaults to the parent widget." +msgstr "" + +msgid "" +":meth:`pack`, :meth:`configure` and :meth:`config` are aliases of :meth:`!" +"pack_configure`." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the packing order, forgetting its " +"packing options. It can be packed again later " +"with :meth:`pack_configure`. :meth:`forget` is an alias of :meth:`!" +"pack_forget`, except on :class:`PanedWindow`, :class:`ttk.Notebook " +"` and :class:`ttk.PanedWindow " +"`, which provide their own :meth:`!forget` method." +msgstr "" + +msgid "Not to be confused with :meth:`Wm.forget`." +msgstr "" + +msgid "" +"Return a dictionary of the widget's current packing options. :meth:`info` is " +"an alias of :meth:`!pack_info`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.pack_propagate`, treating this widget as a container: " +"enable or disable geometry propagation. :meth:`propagate` is an alias " +"of :meth:`!pack_propagate`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.pack_slaves`: return the list of widgets packed in this " +"widget. :meth:`slaves` is an alias of :meth:`!pack_slaves`." +msgstr "" + +msgid "" +"Geometry manager that places widgets at explicit positions and sizes within " +"their container. The :class:`!Place` mix-in is inherited by all widgets " +"(through :class:`Widget`). See also :ref:`tkinter-geometry-management`." +msgstr "" + +msgid "" +"Place the widget inside its container at an absolute or relative position. " +"The supported options are:" +msgstr "" + +msgid "*x*, *y*" +msgstr "" + +msgid "" +"The absolute horizontal and vertical position of the widget's anchor point, " +"as a screen distance (default ``0``)." +msgstr "" + +msgid "*relx*, *rely*" +msgstr "" + +msgid "" +"The horizontal and vertical position of the widget's anchor point as a " +"fraction of the container's width and height, where ``0.0`` is the left or " +"top edge and ``1.0`` is the right or bottom edge. If both the absolute and " +"the relative option are given, their values are summed." +msgstr "" + +msgid "" +"Which point of the widget is placed at the given position: an anchor such as " +"``'n'`` or ``'se'`` (default ``'nw'``)." +msgstr "" + +msgid "*width*, *height*" +msgstr "" + +msgid "" +"The absolute width and height of the widget, as a screen distance. By " +"default the widget's requested size is used." +msgstr "" + +msgid "*relwidth*, *relheight*" +msgstr "" + +msgid "" +"The width and height of the widget as a fraction of the container's width " +"and height. If both the absolute and the relative option are given, their " +"values are summed." +msgstr "" + +msgid "*bordermode*" +msgstr "" + +msgid "" +"How the container's border affects placement: ``'inside'`` (the default) " +"measures the area inside the border, ``'outside'`` measures the area " +"including the border, and ``'ignore'`` uses the official X area." +msgstr "" + +msgid "" +"The container relative to which the widget is placed; it must be the " +"widget's parent or a descendant of the parent, and defaults to the parent." +msgstr "" + +msgid "" +":meth:`place`, :meth:`configure` and :meth:`config` are aliases of :meth:`!" +"place_configure`." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the placement, forgetting its place " +"options." +msgstr "" + +msgid "Return a dictionary of the widget's current place options." +msgstr "" + +msgid "" +"Same as :meth:`Misc.place_slaves`: return the list of widgets placed in this " +"widget." +msgstr "" + +msgid "" +"Geometry manager that arranges widgets in a two-dimensional grid of rows and " +"columns within their container. The :class:`!Grid` mix-in is inherited by " +"all widgets (through :class:`Widget`). See also :ref:`tkinter-geometry-" +"management`." +msgstr "" + +msgid "Position the widget in a cell of its container's grid." +msgstr "" + +msgid "Not to be confused with :meth:`Wm.grid`." +msgstr "" + +msgid "The supported options are:" +msgstr "" + +msgid "*row*, *column*" +msgstr "" + +msgid "" +"The row and column of the cell to place the widget in, counting from ``0``. " +"*column* defaults to the column after the previous widget placed in the " +"same :meth:`!grid_configure` call (or ``0``), and *row* defaults to the next " +"empty row." +msgstr "" + +msgid "*rowspan*, *columnspan*" +msgstr "" + +msgid "The number of rows and columns the widget should span (default ``1``)." +msgstr "" + +msgid "*sticky*" +msgstr "" + +msgid "" +"How to position or stretch the widget when its cell is larger than the " +"widget: a string containing zero or more of the characters ``'n'``, ``'s'``, " +"``'e'`` and ``'w'``, naming the cell sides the widget sticks to. Specifying " +"both ``'n'`` and ``'s'`` (or ``'e'`` and ``'w'``) stretches the widget to " +"fill the height (or width) of the cell. The default is ``''``, which centers " +"the widget at its requested size." +msgstr "" + +msgid "" +"The container in whose grid to place the widget; it defaults to the parent " +"widget." +msgstr "" + +msgid "" +":meth:`grid`, :meth:`configure` and :meth:`config` are aliases of :meth:`!" +"grid_configure`." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the grid, forgetting its grid options." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the grid, but remember its grid options " +"so that it is restored to the same cell if it is gridded again." +msgstr "" + +msgid "Return a dictionary of the widget's current grid options." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_bbox`. :meth:`bbox` is an alias of :meth:`!" +"grid_bbox`, except " +"on :class:`Canvas`, :class:`Listbox`, :class:`Spinbox`, :class:`Text`, :class:`ttk.Entry " +"` and :class:`ttk.Treeview `, which " +"provide their own :meth:`!bbox` method." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_columnconfigure`: query or set the options (such as " +"*weight*, *minsize*, *pad* and *uniform*) of a grid " +"column. :meth:`columnconfigure` is an alias of :meth:`!grid_columnconfigure`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_rowconfigure`: query or set the options of a grid " +"row. :meth:`rowconfigure` is an alias of :meth:`!grid_rowconfigure`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_location`: return the ``(column, row)`` of the cell " +"that covers the pixel at *x*, *y*. :meth:`location` is an alias of :meth:`!" +"grid_location`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_size`: return a ``(columns, rows)`` tuple giving " +"the size of the grid. :meth:`size` is an alias of :meth:`!grid_size`, except " +"on the :class:`Listbox` widget, which provides its own :meth:`!size` method." +msgstr "" + +msgid "Same as :meth:`Misc.grid_propagate`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_slaves`: return the widgets managed in the grid, " +"optionally restricted to a *row* and/or *column*." +msgstr "" + +msgid "" +"Mix-in providing the horizontal-scrolling interface shared by widgets such " +"as :class:`Entry`, :class:`Canvas`, :class:`Listbox`, :class:`Text` " +"and :class:`Spinbox`. A widget's :meth:`xview` method is registered as the " +"*command* of a horizontal :class:`Scrollbar`." +msgstr "" + +msgid "" +"Query or change the horizontal position of the view. With no arguments, " +"return a tuple ``(first, last)`` of two fractions between 0 and 1 giving the " +"portion of the document that is currently visible. Otherwise the arguments " +"are passed to the Tk ``xview`` widget command and are usually generated by a " +"scrollbar; :meth:`xview_moveto` and :meth:`xview_scroll` provide a more " +"convenient interface." +msgstr "" + +msgid "" +"Adjust the view so that *fraction* of the total width of the document is off-" +"screen to the left. *fraction* is a number between 0 and 1." +msgstr "" + +msgid "" +"Shift the view left or right by *number* units. *what* is either ``'units'`` " +"or ``'pages'``; a negative *number* scrolls left and a positive one scrolls " +"right. The :class:`Text` widget accepts also ``'pixels'``, and then *number* " +"can be a screen distance, such as ``'1i'``." +msgstr "" + +msgid "" +"Mix-in providing the vertical-scrolling interface shared by widgets such " +"as :class:`Canvas`, :class:`Listbox` and :class:`Text`. A " +"widget's :meth:`yview` method is registered as the *command* of a " +"vertical :class:`Scrollbar`." +msgstr "" + +msgid "" +"Query or change the vertical position of the view. With no arguments, return " +"a tuple ``(first, last)`` of two fractions between 0 and 1 giving the " +"portion of the document that is currently visible. Otherwise the arguments " +"are passed to the Tk ``yview`` widget command, usually generated by a " +"scrollbar; :meth:`yview_moveto` and :meth:`yview_scroll` provide a more " +"convenient interface." +msgstr "" + +msgid "" +"Adjust the view so that *fraction* of the total height of the document is " +"off-screen above the top. *fraction* is a number between 0 and 1." +msgstr "" + +msgid "" +"Shift the view up or down by *number* units. *what* is either ``'units'`` or " +"``'pages'``; a negative *number* scrolls up and a positive one scrolls down. " +"The :class:`Text` widget accepts also ``'pixels'``, and then *number* can be " +"a screen distance, such as ``'1i'``." +msgstr "" + +msgid "" +"Internal base class for all widgets. It inherits from :class:`Misc` and adds " +"the machinery that creates the underlying Tk widget; application code " +"normally uses :class:`Widget` or a concrete widget class rather than " +"instantiating :class:`!BaseWidget` directly." +msgstr "" + +msgid "" +"Destroy this widget and all of its children, removing the corresponding Tk " +"widgets and deleting the associated Tcl commands." +msgstr "" + +msgid "" +"Internal base class for the standard widgets. It " +"combines :class:`BaseWidget` with the geometry-manager mix-" +"ins :class:`Pack`, :class:`Place` and :class:`Grid`, so that every widget " +"can be managed by any of the three geometry managers. The concrete widget " +"classes (:class:`Button`, :class:`Label`, and so on) derive from :class:`!" +"Widget`." +msgstr "" + +msgid "Toplevel widgets" +msgstr "" + +msgid "" +"Construct a toplevel Tk widget, which is usually the main window of an " +"application, and initialize a Tcl interpreter for this widget. Each " +"instance has its own associated Tcl interpreter. Inherits from :class:`Misc` " +"and :class:`Wm`." +msgstr "" + +msgid "" +"To create a Tcl interpreter without initializing the Tk subsystem, use " +"the :func:`Tcl` factory function instead." +msgstr "" + +msgid "" +"The :class:`Tk` class is typically instantiated using all default values. " +"However, the following keyword arguments are currently recognized:" +msgstr "" + +msgid "*screenName*" +msgstr "" + +msgid "" +"When given (as a string), sets the :envvar:`DISPLAY` environment variable. " +"(X11 only)" +msgstr "" + +msgid "*baseName*" +msgstr "" + +msgid "" +"Name of the profile file. By default, *baseName* is derived from the " +"program name (``sys.argv[0]``)." +msgstr "" + +msgid "*className*" +msgstr "" + +msgid "" +"Name of the widget class. Used as a profile file and also as the name with " +"which Tcl is invoked (*argv0* in *interp*)." +msgstr "" + +msgid "*useTk*" +msgstr "" + +msgid "" +"If ``True``, initialize the Tk subsystem. The :func:`tkinter.Tcl() ` " +"function sets this to ``False``." +msgstr "" + +msgid "*sync*" +msgstr "" + +msgid "" +"If ``True``, execute all X server commands synchronously, so that errors are " +"reported immediately. Can be used for debugging. (X11 only)" +msgstr "" + +msgid "*use*" +msgstr "" + +msgid "" +"Specifies the *id* of the window in which to embed the application, instead " +"of it being created as an independent toplevel window. *id* must be " +"specified in the same way as the value for the -use option for toplevel " +"widgets (that is, it has a form like that returned " +"by :meth:`~Misc.winfo_id`)." +msgstr "" + +msgid "" +"Note that on some platforms this will only work correctly if *id* refers to " +"a Tk frame or toplevel that has its -container option enabled." +msgstr "" + +msgid "" +":class:`Tk` reads and interprets profile files, named :file:`." +"{className}.tcl` and :file:`.{baseName}.tcl`, into the Tcl interpreter and " +"calls :func:`exec` on the contents of :file:`.{className}.py` and :file:`." +"{baseName}.py`. The path for the profile files is the :envvar:`HOME` " +"environment variable or, if that isn't defined, then :data:`os.curdir`." +msgstr "" + +msgid "" +"On Windows, creating a Tcl interpreter (by instantiating :class:`Tk` or " +"calling :func:`Tcl`) sets the :envvar:`HOME` environment variable for the " +"process, if it is not already set, to ``%HOMEDRIVE%%HOMEPATH%`` " +"(or :envvar:`USERPROFILE`, or ``c:\\``). This is done by Tcl and can affect " +"other code that reads :envvar:`HOME`." +msgstr "" + +msgid "" +"The Tk application object created by instantiating :class:`Tk`. This " +"provides access to the Tcl interpreter. Each widget that is attached the " +"same instance of :class:`Tk` has the same value for its :attr:`tk` attribute." +msgstr "" + +msgid "" +"The widget object that contains this widget. For :class:`Tk`, the :attr:`!" +"master` is :const:`None` because it is the main window. The terms *master* " +"and *parent* are similar and sometimes used interchangeably as argument " +"names; however, calling :meth:`~Misc.winfo_parent` returns a string of the " +"widget name whereas :attr:`!master` returns the object. *parent*/*child* " +"reflects the tree-like relationship while *master* (or *container*)/" +"*content* reflects the container structure." +msgstr "" + +msgid "" +"The immediate descendants of this widget as a :class:`dict` with the child " +"widget names as the keys and the child instance objects as the values." +msgstr "" + +msgid "" +"Destroy this and all descendant widgets and, for the main window, end the " +"connection to the underlying Tcl interpreter." +msgstr "" + +msgid "" +"Finish loading and initializing the Tk subsystem. This is needed only when " +"the interpreter was created without Tk (for example through :func:`Tcl`); it " +"is called automatically when *useTk* is true." +msgstr "" + +msgid "" +"Read and source the user's profile files :file:`.{className}.tcl` " +"and :file:`.{baseName}.tcl` into the Tcl interpreter, and execute the " +"corresponding :file:`.{className}.py` and :file:`.{baseName}.py` files. This " +"is called during initialization; see the description of the constructor " +"above." +msgstr "" + +msgid "" +"Report a callback exception. This is called when an exception propagates out " +"of a Tkinter callback; *exc*, *val* and *tb* are the exception type, value " +"and traceback as returned by :func:`sys.exc_info`. The default " +"implementation prints a traceback to :data:`sys.stderr`. It can be " +"overridden to customize error handling, for example to display the traceback " +"in a dialog." +msgstr "" + +msgid "" +"A :class:`!Toplevel` widget is a top-level window, similar to " +"a :class:`Frame` except that its X parent is the root window of a screen " +"rather than its logical parent. Its primary purpose is to serve as a " +"container for dialog boxes and other collections of widgets; its only " +"visible features are its background and an optional 3-D border. Notable " +"options include *menu*, which installs a :class:`Menu` as the window's " +"menubar. Inherits from :class:`BaseWidget` and :class:`Wm`, so a toplevel is " +"managed by the window manager. Refer to the Tk ``toplevel`` manual page for " +"the full list of options." +msgstr "" + +msgid "Widget classes" +msgstr "" + +msgid "" +"A :class:`!Button` widget displays a textual string, bitmap or image and " +"invokes a command when the user presses it (by clicking mouse button 1 over " +"the button or, when the button has focus, by pressing the space key). " +"Inherits from :class:`Widget`. In addition to the standard widget options, a " +"button accepts the options documented in the Tk ``button`` manual page, such " +"as *command* (the callback invoked when the button is pressed), " +"*textvariable*, *state* and *default*." +msgstr "" + +msgid "" +"Invoke the command associated with the button, if there is one, and return " +"its result, or an empty string if no command is associated with the button. " +"This is ignored if the button's state is ``disabled``." +msgstr "" + +msgid "" +"Flash the button by redisplaying it several times, alternating between the " +"active and normal colors. At the end of the flash the button is left in the " +"same normal or active state as when the method was called. This is ignored " +"if the button's state is ``disabled``." +msgstr "" + +msgid "" +"A :class:`!Canvas` widget implements structured graphics. It displays any " +"number of *items*, such as arcs, lines, ovals, polygons, rectangles, text, " +"bitmaps, images and embedded windows, which may be drawn, moved, re-colored " +"and bound to events. Inherits from :class:`Widget`, :class:`XView` " +"and :class:`YView`, so the view can be scrolled horizontally and vertically " +"with :meth:`~XView.xview` and :meth:`~YView.yview`. Refer to the Tk " +"``canvas`` manual page for the full list of widget and item options." +msgstr "" + +msgid "" +"Each item has a unique integer *id*, assigned when it is created, and zero " +"or more string *tags*. A tag is an arbitrary string that does not have the " +"form of an integer; the same tag may be shared by many items, which makes " +"tags convenient for grouping items. The special tag ``'all'`` matches every " +"item in the canvas, and ``'current'`` matches the topmost item under the " +"mouse pointer. Most methods take a *tagOrId* argument that may be an integer " +"id naming a single item, or a tag naming zero or more items; as described in " +"the Tk ``canvas`` manual page, a tag may also be a logical expression of " +"tags combined with the operators ``&&``, ``||``, ``^``, ``!`` and " +"parentheses. When a method that operates on a single item is given a " +"*tagOrId* matching several items, it normally uses the lowest matching item " +"in the display list." +msgstr "" + +msgid "" +"The items are kept in a *display list* that determines drawing order: items " +"later in the list are drawn on top of earlier ones. A newly created item is " +"placed at the top of the list; the order can be changed " +"with :meth:`tag_raise` and :meth:`tag_lower`." +msgstr "" + +msgid "" +"Create a new item of the corresponding type and return its integer id. Each " +"method is called as ``create_TYPE(coord..., **options)``: the leading " +"positional arguments give the coordinates that define the item (as separate " +"numbers, as a single sequence of numbers, or as coordinate pairs), and the " +"keyword arguments set item-specific options. Coordinates and screen " +"distances may be given as numbers (interpreted as pixels) or as strings with " +"a unit suffix (``'m'``, ``'c'``, ``'i'`` or ``'p'`` for millimetres, " +"centimetres, inches or printer's points), but are always stored and returned " +"in pixels." +msgstr "" + +msgid "" +"The item types are: ``arc`` (an arc-shaped region that is a section of an " +"oval, defined by two diagonally opposite corners ``x1, y1, x2, y2`` of the " +"enclosing rectangle); ``bitmap`` (a two-color bitmap positioned at a point " +"``x, y``); ``image`` (a Tk image positioned at a point ``x, y``); ``line`` " +"(a line or curve through the points ``x1, y1, ..., xn, yn``); ``oval`` (a " +"circle or ellipse inscribed in the rectangle ``x1, y1, x2, y2``); " +"``polygon`` (a closed polygon through the points ``x1, y1, ..., xn, yn``); " +"``rectangle`` (a rectangle with corners ``x1, y1, x2, y2``); ``text`` (a " +"string of text positioned at a point ``x, y``); and ``window`` (a child " +"widget embedded in the canvas at a point ``x, y``, specified with the " +"*window* option)." +msgstr "" + +msgid "" +"Most item types accept a common set of *standard item options*, plus a few " +"options specific to each type. Option names are passed as keyword arguments, " +"without the leading hyphen." +msgstr "" + +msgid "The standard item options are:" +msgstr "" + +msgid "" +"The color used to fill the item's interior, or to draw a *line* item or the " +"characters of a *text* item. An empty string (the default for all types " +"except *line* and *text*) leaves the item unfilled." +msgstr "" + +msgid "*outline*" +msgstr "" + +msgid "" +"The color used to draw the item's outline. An empty string draws no outline." +msgstr "" + +msgid "*width*" +msgstr "" + +msgid "" +"The width of the outline, defaulting to ``1.0``. Has no effect if *outline* " +"is empty." +msgstr "" + +msgid "*dash*" +msgstr "" + +msgid "" +"A dash pattern for the outline, given either as a sequence of segment " +"lengths in pixels or as a string of the characters ``'.'``, ``','``, " +"``'-'``, ``'_'`` and space. An empty pattern (the default) draws a solid " +"outline." +msgstr "" + +msgid "*dashoffset*" +msgstr "" + +msgid "" +"The starting offset in pixels into the *dash* pattern. Ignored if there is " +"no *dash* pattern." +msgstr "" + +msgid "*stipple*" +msgstr "" + +msgid "" +"A bitmap used as a stipple pattern when filling the item. Only well " +"supported on X11." +msgstr "" + +msgid "*outlinestipple*" +msgstr "" + +msgid "" +"A bitmap used as a stipple pattern when drawing the outline. Has no effect " +"if *outline* is empty." +msgstr "" + +msgid "*offset*, *outlineoffset*" +msgstr "" + +msgid "" +"The offset of the fill and outline stipple patterns, given as ``'x,y'`` or " +"as a side such as ``'n'``, ``'se'`` or ``'center'``. Stipple offsets are " +"only supported on X11." +msgstr "" + +msgid "*state*" +msgstr "" + +msgid "" +"Overrides the canvas state for this item; one of ``'normal'``, " +"``'disabled'`` or ``'hidden'``." +msgstr "" + +msgid "*tags*" +msgstr "" + +msgid "" +"A single tag or a sequence of tags to associate with the item, replacing any " +"existing tags." +msgstr "" + +msgid "" +"Many of these options have *active...* and *disabled...* variants (such as " +"*activefill*, *disabledfill*, *activewidth*, *disableddash*, " +"*activeoutline*, *disabledstipple*) that override the base option when the " +"item is the active item (under the mouse pointer) or is in the disabled " +"state." +msgstr "" + +msgid "The following item types support additional options." +msgstr "" + +msgid "For ``arc`` items:" +msgstr "" + +msgid "*start*" +msgstr "" + +msgid "" +"The start of the arc's angular range, in degrees measured counter-clockwise " +"from the 3-o'clock position." +msgstr "" + +msgid "*extent*" +msgstr "" + +msgid "" +"The size of the angular range, in degrees counter-clockwise from *start*." +msgstr "" + +msgid "*style*" +msgstr "" + +msgid "" +"How the arc is drawn: ``'pieslice'`` (the default), ``'chord'`` or ``'arc'``." +msgstr "" + +msgid "For ``line`` items:" +msgstr "" + +msgid "*arrow*" +msgstr "" + +msgid "" +"Where to draw arrowheads: ``'none'`` (the default), ``'first'``, ``'last'`` " +"or ``'both'``." +msgstr "" + +msgid "*arrowshape*" +msgstr "" + +msgid "A sequence of three distances describing the shape of the arrowheads." +msgstr "" + +msgid "*capstyle*" +msgstr "" + +msgid "" +"How line ends are drawn: ``'butt'`` (the default), ``'projecting'`` or " +"``'round'``." +msgstr "" + +msgid "*joinstyle*" +msgstr "" + +msgid "" +"How line vertices are drawn: ``'round'`` (the default), ``'bevel'`` or " +"``'miter'``." +msgstr "" + +msgid "*smooth*" +msgstr "" + +msgid "" +"The smoothing method: a false value (the default) for no smoothing, or " +"``'true'``/``'bezier'`` or ``'raw'`` to draw the line as a curve." +msgstr "" + +msgid "*splinesteps*" +msgstr "" + +msgid "" +"The number of line segments approximating each spline when *smooth* is " +"enabled." +msgstr "" + +msgid "For ``polygon`` items:" +msgstr "" + +msgid "*joinstyle*, *smooth*, *splinesteps*" +msgstr "" + +msgid "As for ``line`` items, applied to the polygon's outline." +msgstr "" + +msgid "For ``text`` items:" +msgstr "" + +msgid "*text*" +msgstr "" + +msgid "The string to display; newline characters start new lines." +msgstr "" + +msgid "*font*" +msgstr "" + +msgid "The font used for the text." +msgstr "" + +msgid "*justify*" +msgstr "" + +msgid "" +"How lines are justified: ``'left'`` (the default), ``'right'`` or " +"``'center'``." +msgstr "" + +msgid "" +"How the text is positioned relative to its point, defaulting to ``'center'``." +msgstr "" + +msgid "The maximum line length; if non-zero, lines are wrapped at spaces." +msgstr "" + +msgid "*angle*" +msgstr "" + +msgid "" +"How many degrees to rotate the text counter-clockwise about its positioning " +"point, from ``0.0`` to ``360.0`` (default ``0.0``)." +msgstr "" + +msgid "*underline*" +msgstr "" + +msgid "The index of a character to underline, or ``-1`` for none." +msgstr "" + +msgid "For ``bitmap`` items:" +msgstr "" + +msgid "*bitmap*" +msgstr "" + +msgid "The bitmap to display." +msgstr "" + +msgid "How the bitmap is positioned relative to its point." +msgstr "" + +msgid "*background*, *foreground*" +msgstr "" + +msgid "" +"The colors used for the bitmap's ``0`` and ``1`` pixels; an empty " +"*background* makes the ``0`` pixels transparent. Both have *active...* and " +"*disabled...* variants, and *bitmap* has *activebitmap* and *disabledbitmap* " +"variants." +msgstr "" + +msgid "For ``image`` items:" +msgstr "" + +msgid "*image*" +msgstr "" + +msgid "The Tk image to display, previously created with the image protocols." +msgstr "" + +msgid "How the image is positioned relative to its point." +msgstr "" + +msgid "" +"Both options have *active...* and *disabled...* variants (*activeimage*, " +"*disabledimage*) used in the active and disabled states." +msgstr "" + +msgid "For ``window`` items:" +msgstr "" + +msgid "*window*" +msgstr "" + +msgid "" +"The widget to embed; it must be a child of the canvas or of one of its " +"ancestors, and may not be a top-level window." +msgstr "" + +msgid "How the window is positioned relative to its point." +msgstr "" + +msgid "" +"The size to assign to the window; if zero (the default), the window is given " +"its requested size." +msgstr "" + +msgid "" +"``oval`` and ``rectangle`` items have no type-specific options; they use " +"only the standard item options." +msgstr "" + +msgid "Tk 8.6 added the *angle* option for ``text`` items." +msgstr "" + +msgid "" +"Query or modify the coordinates of an item. With only *tagOrId*, return a " +"list of the floating-point coordinates of the item given by *tagOrId* (the " +"first matching item if it matches several). Given new coordinates, replace " +"the coordinates of that item with them; like the ``create_*`` methods, the " +"coordinates may be given as separate numbers, as a single sequence, or as " +"coordinate pairs. The returned coordinates are always in pixels, regardless " +"of the units used to specify them; for rectangles, ovals and arcs they are " +"ordered left, top, right, bottom." +msgstr "" + +msgid "" +"The arguments are now flattened: the coordinates may be given as separate " +"arguments, as a single sequence, or grouped in pairs, like the ``create_*`` " +"methods." +msgstr "" + +msgid "" +"Move each of the items given by *tagOrId* in the canvas coordinate space by " +"adding *xAmount* to every x-coordinate and *yAmount* to every y-coordinate " +"of the item." +msgstr "" + +msgid "" +"Move the items given by *tagOrId* so that the first coordinate pair (the " +"upper-left corner of the bounding box) of the lowest matching item is at " +"position (*x*, *y*). *x* or *y* may be an empty string, in which case the " +"corresponding coordinate is unchanged. All matching items keep their " +"positions relative to each other." +msgstr "" + +msgid "" +"Rescale the coordinates of all items given by *tagOrId* in canvas coordinate " +"space. Each x-coordinate is adjusted so that its distance from *xOrigin* " +"changes by a factor of *xScale*, and each y-coordinate so that its distance " +"from *yOrigin* changes by a factor of *yScale* (a factor of ``1.0`` leaves " +"the coordinate unchanged)." +msgstr "" + +msgid "Delete each of the items given by the *tagOrIds* arguments." +msgstr "" + +msgid "" +"Delete from each of the items given by *tagOrId* the characters (for text " +"items) or coordinates (for line and polygon items) in the range from *first* " +"to *last* inclusive; *last* defaults to *first*. Items that do not support " +"indexing ignore this operation." +msgstr "" + +msgid "" +"Insert *string* into each of the items given by *tagOrId* just before the " +"character or coordinate whose index is *beforeThis*. For line and polygon " +"items *string* must be a valid sequence of coordinates." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the item " +"given by *tagOrId* (the lowest matching item if it matches several). This is " +"like :meth:`~Misc.cget` but applies to an individual item." +msgstr "" + +msgid "" +"Query or modify the configuration options of the items given by *tagOrId*. " +"This mirrors :meth:`~Misc.configure`, except that it applies to individual " +"items rather than to the canvas as a whole. With no options, it returns a " +"dictionary describing the current options of the first matching item; " +"otherwise it sets the given options on every matching item. The legal " +"options are those accepted by the corresponding ``create_*`` " +"method. :meth:`itemconfig` is an alias of :meth:`!itemconfigure`." +msgstr "" + +msgid "" +"Return the type of the item given by *tagOrId* (the first matching item if " +"it matches several), such as ``'rectangle'`` or ``'text'``, or ``None`` if " +"*tagOrId* does not match any item." +msgstr "" + +msgid "" +"Return a tuple of the tags associated with the item given by *tagOrId* (the " +"first matching item in display-list order if it matches several). Return an " +"empty tuple if no item matches or the item has no tags." +msgstr "" + +msgid "" +"Remove the tag *tagToDelete* (which defaults to *tagOrId*) from each of the " +"items given by *tagOrId*. Items that do not have that tag are unaffected." +msgstr "" + +msgid "" +"Add the tag *newtag* to each item selected by the search specification " +"*searchSpec* (and any further *args*). *searchSpec* is one of ``'above'``, " +"``'all'``, ``'below'``, ``'closest'``, ``'enclosed'``, ``'overlapping'`` or " +"``'withtag'``; the ``addtag_*`` methods below are convenient wrappers that " +"supply each of these forms." +msgstr "" + +msgid "" +"Add the tag *newtag* to the item just above (after) *tagOrId* in the display " +"list." +msgstr "" + +msgid "Add the tag *newtag* to all items in the canvas." +msgstr "" + +msgid "" +"Add the tag *newtag* to the item just below (before) *tagOrId* in the " +"display list." +msgstr "" + +msgid "" +"Add the tag *newtag* to the item closest to the point (*x*, *y*). If *halo* " +"is given, any item within that distance of the point is treated as " +"overlapping it. If *start* is given (a tag or id), select the topmost " +"closest item that lies below *start* in the display list, which can be used " +"to step through all the closest items." +msgstr "" + +msgid "" +"Add the tag *newtag* to every item completely enclosed within the rectangle " +"(*x1*, *y1*, *x2*, *y2*), where *x1* <= *x2* and *y1* <= *y2*." +msgstr "" + +msgid "" +"Add the tag *newtag* to every item that overlaps or is enclosed within the " +"rectangle (*x1*, *y1*, *x2*, *y2*), where *x1* <= *x2* and *y1* <= *y2*." +msgstr "" + +msgid "Add the tag *newtag* to every item given by *tagOrId*." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items selected by the search specification " +"*searchSpec* (and any further *args*), in stacking order with the lowest " +"item first. The search specification has any of the forms accepted " +"by :meth:`addtag`. The ``find_*`` methods below are more convenient wrappers " +"around it." +msgstr "" + +msgid "" +"Return a tuple containing the id of the item just above *tagOrId* in the " +"display list." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items in the canvas, in stacking order." +msgstr "" + +msgid "" +"Return a tuple containing the id of the item just below *tagOrId* in the " +"display list." +msgstr "" + +msgid "" +"Return a tuple containing the id of the item closest to the point (*x*, " +"*y*). *halo* and *start* are interpreted as for :meth:`addtag_closest`." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items completely enclosed within the " +"rectangle (*x1*, *y1*, *x2*, *y2*)." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items that overlap or are enclosed within " +"the rectangle (*x1*, *y1*, *x2*, *y2*)." +msgstr "" + +msgid "Return a tuple of the ids of all items given by *tagOrId*." +msgstr "" + +msgid "" +"Move all items given by *tagOrId* to a new position in the display list just " +"above the item given by *aboveThis*, or to the top of the display list if " +"*aboveThis* is omitted. When several items are moved their relative order is " +"preserved. This has no effect on embedded window items, whose stacking order " +"is controlled by :meth:`Misc.tkraise` and :meth:`Misc.lower` " +"instead. :meth:`lift` and :meth:`tkraise` are aliases of :meth:`!tag_raise`." +msgstr "" + +msgid "" +"Move all items given by *tagOrId* to a new position in the display list just " +"below the item given by *belowThis*, or to the bottom of the display list if " +"*belowThis* is omitted. When several items are moved their relative order is " +"preserved. This has no effect on embedded window items. :meth:`lower` is an " +"alias of :meth:`!tag_lower`." +msgstr "" + +msgid "" +"On a :class:`Canvas`, :meth:`tkraise`/:meth:`lift` and :meth:`lower` restack " +"canvas items, shadowing the inherited :meth:`Misc.tkraise`/:meth:`Misc.lift` " +"and :meth:`Misc.lower` methods that restack the widget itself, which are " +"therefore not available." +msgstr "" + +msgid "" +"Bind the callback *func* to the event *sequence* for all items given by " +"*tagOrId*, so that *func* is invoked whenever that event occurs for one of " +"the items. This is like :meth:`Widget.bind ` but operates on " +"canvas items rather than on whole widgets; only mouse, keyboard and virtual " +"events may be bound. Mouse events are directed to the current item and " +"keyboard events to the focus item (see :meth:`focus`). If *add* is true the " +"new binding is added to any existing bindings for the same sequence, rather " +"than replacing them. Return the identifier of the bound function, which can " +"be passed to :meth:`tag_unbind`." +msgstr "" + +msgid "" +"Remove for all items given by *tagOrId* the binding for the event " +"*sequence*. If *funcid* is given, only that callback (as returned " +"by :meth:`tag_bind`) is unbound and deregistered." +msgstr "" + +msgid "If *funcid* is given, only that callback is unbound." +msgstr "" + +msgid "" +"Return a 4-tuple ``(x1, y1, x2, y2)`` giving an approximate bounding box, in " +"pixels, that encloses all the items given by *tagOrId* and any further " +"*tagOrIds*. The result may overestimate the true bounding box by a few " +"pixels. Return ``None`` if no item matches or the matching items have " +"nothing to display." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`!Misc.bbox`; use :meth:`~Misc.grid_bbox` " +"for the grid bounding box." +msgstr "" + +msgid "" +"Given a window x-coordinate *screenx*, return the canvas x-coordinate " +"displayed at that location. If *gridspacing* is given, the result is rounded " +"to the nearest multiple of *gridspacing* units." +msgstr "" + +msgid "" +"Given a window y-coordinate *screeny*, return the canvas y-coordinate " +"displayed at that location. If *gridspacing* is given, the result is rounded " +"to the nearest multiple of *gridspacing* units." +msgstr "" + +msgid "" +"With *tagOrId*, set the keyboard focus for the canvas to the first item " +"given by *tagOrId* that supports the insertion cursor; the focus is left " +"unchanged if no such item exists. If *tagOrId* is an empty string, reset the " +"focus so that no item has it. With no argument, return the id of the item " +"that currently has the focus, or an empty string if none does. An item only " +"displays the insertion cursor when both it is the focus item and its canvas " +"has the input focus." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`!Misc.focus`; use :meth:`~Misc.focus_set` " +"to focus the widget itself." +msgstr "" + +msgid "" +"Set the insertion cursor of the items given by *tagOrId* to just before the " +"character given by *index*. Items that do not support an insertion cursor " +"are unaffected. The cursor is only displayed when the item has the focus, " +"but its position may be set at any time." +msgstr "" + +msgid "" +"Return as an integer the numerical index within *tagOrId* corresponding to " +"*index*, which is a textual description of a position (for text items an " +"index into the characters, for line and polygon items an index into the " +"coordinates). If *tagOrId* matches several items, the first one that " +"supports indexing is used." +msgstr "" + +msgid "" +"Adjust the end of the selection in *tagOrId* nearest to *index* so that it " +"is at *index*, and make the other end the anchor point for " +"future :meth:`select_to` calls. If the selection is not currently in " +"*tagOrId*, this behaves like :meth:`select_to`." +msgstr "" + +msgid "Clear the selection if it is in this canvas; otherwise do nothing." +msgstr "" + +msgid "" +"Set the selection anchor point to just before the character given by *index* " +"in the item given by *tagOrId*. This does not change the selection itself; " +"it sets the fixed end for future :meth:`select_to` calls." +msgstr "" + +msgid "" +"Return the id of the item that holds the selection, or ``None`` if the " +"selection is not in this canvas. Unlike :meth:`find` and the ``find_*`` " +"methods, this returns the id as a string rather than an integer." +msgstr "" + +msgid "" +"Set the selection to the characters of *tagOrId* between the selection " +"anchor point and *index*, inclusive of *index*. The anchor point is the one " +"set by the most recent :meth:`select_adjust` or :meth:`select_from` call." +msgstr "" + +msgid "" +"Record *x*, *y* and the current view, for use with later :meth:`scan_dragto` " +"calls. This is typically bound to a mouse button press in the widget." +msgstr "" + +msgid "" +"Scroll the canvas by *gain* times the difference between *x*, *y* and the " +"coordinates passed to the last :meth:`scan_mark` call. This is typically " +"bound to mouse motion events in the widget, producing the effect of dragging " +"the canvas at high speed through its window." +msgstr "" + +msgid "" +"Generate a PostScript (Encapsulated PostScript, version 3.0) representation " +"of part or all of the canvas. If the *file* or *channel* option is given, " +"the PostScript is written there and an empty string is returned; otherwise " +"it is returned as a string. By default only the area currently visible in " +"the window is generated, so it is usually necessary either to " +"call :meth:`~Misc.update` first or to use the *width* and *height* options. " +"Supported options include *colormap*, *colormode*, *file*, *fontmap*, " +"*height*, *pageanchor*, *pageheight*, *pagewidth*, *pagex*, *pagey*, " +"*rotate*, *width*, *x* and *y*." +msgstr "" + +msgid "" +"A :class:`!Checkbutton` widget displays a textual string, bitmap or image " +"together with a square indicator, and toggles a boolean selection when " +"pressed. It has all the behavior of a simple button and, in addition, can be " +"selected: when selected the indicator is drawn with a check mark and the " +"associated variable is set to the ``onvalue``, and when deselected the " +"indicator is drawn empty and the variable is set to the ``offvalue``. " +"Inherits from :class:`Widget`. In addition to the standard widget options, a " +"checkbutton accepts the options documented in the Tk ``checkbutton`` manual " +"page, such as *variable*, *onvalue*, *offvalue* and *command*." +msgstr "" + +msgid "" +"Do just what would happen if the user pressed the checkbutton with the " +"mouse: toggle the selection state of the button and invoke the associated " +"command, if there is one. Return the result of the command, or an empty " +"string if no command is associated with the checkbutton. This is ignored if " +"the checkbutton's state is ``disabled``." +msgstr "" + +msgid "" +"Select the checkbutton and set the associated variable to its ``onvalue``." +msgstr "" + +msgid "" +"Deselect the checkbutton and set the associated variable to its ``offvalue``." +msgstr "" + +msgid "" +"Toggle the selection state of the button, redisplaying it and modifying its " +"associated variable to reflect the new state." +msgstr "" + +msgid "" +"Flash the checkbutton by redisplaying it several times, alternating between " +"the active and normal colors. At the end of the flash the checkbutton is " +"left in the same normal or active state as when the method was called. This " +"is ignored if the checkbutton's state is ``disabled``." +msgstr "" + +msgid "" +"An :class:`!Entry` widget displays a single line of text and lets the user " +"edit it. Inherits from :class:`Widget` and :class:`XView`; since entries can " +"hold strings too long to fit in the window, they support horizontal " +"scrolling through :meth:`~XView.xview`." +msgstr "" + +msgid "" +"In addition to the standard widget options, an entry accepts the options " +"documented in the Tk ``entry`` manual page. Notable ones are *textvariable* " +"(the name of a variable kept in sync with the entry's contents), *show* (if " +"set, each character is displayed as the given character rather than its true " +"value, useful for password entry), *validate* and *validatecommand* (which " +"together let a callback accept or reject edits), and *state* (one of " +"``'normal'``, ``'disabled'`` or ``'readonly'``)." +msgstr "" + +msgid "" +"Many of the methods below take an *index* argument that selects a character " +"in the entry's string. As described in the Tk ``entry`` manual page, *index* " +"may be a number (counting from 0), ``'insert'`` (the character just after " +"the insertion cursor), ``'end'`` (just after the last character), " +"``'anchor'`` (the selection anchor point), ``'sel.first'`` and " +"``'sel.last'`` (the ends of the selection), or ``@x`` (the character " +"covering pixel x-coordinate *x* in the window). Out-of-range indices are " +"rounded to the nearest legal value." +msgstr "" + +msgid "" +"Delete the characters from index *first* up to but not including index " +"*last*. If *last* is omitted, only the single character at *first* is " +"deleted." +msgstr "" + +msgid "Return the entry's current string." +msgstr "" + +msgid "Insert *string* just before the character given by *index*." +msgstr "" + +msgid "" +"Arrange for the insertion cursor to be displayed just before the character " +"given by *index*." +msgstr "" + +msgid "Return the numerical index corresponding to *index*." +msgstr "" + +msgid "" +"Locate the end of the selection nearest to the character given by *index*, " +"and adjust that end to be at *index* (including but not going beyond it); " +"the other end becomes the anchor point for future :meth:`selection_to` " +"calls. If there is no selection in the entry, a new one is created between " +"*index* and the most recent anchor point, inclusive. :meth:`select_adjust` " +"is an alias of :meth:`!selection_adjust`." +msgstr "" + +msgid "" +"Clear the selection if it is currently in this widget. If the selection is " +"not in this widget the method has no effect. :meth:`select_clear` is an " +"alias of :meth:`!selection_clear`." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.selection_clear`, which clears the X " +"selection; that method is not available on an :class:`Entry`." +msgstr "" + +msgid "" +"Set the selection anchor point to just before the character given by " +"*index*, without changing the selection. :meth:`select_from` is an alias " +"of :meth:`!selection_from`." +msgstr "" + +msgid "" +"Return ``True`` if there are characters selected in the entry, ``False`` " +"otherwise. :meth:`select_present` is an alias of :meth:`!selection_present`." +msgstr "" + +msgid "" +"Set the selection to include the characters starting with the one indexed by " +"*start* and ending with the one just before *end*. If *end* refers to the " +"same character as *start* or an earlier one, the selection is " +"cleared. :meth:`select_range` is an alias of :meth:`!selection_range`." +msgstr "" + +msgid "" +"Set the selection between the anchor point and *index*: if *index* is before " +"the anchor point, the selection runs from *index* up to but not including " +"the anchor; if *index* is after it, from the anchor up to but not including " +"*index*; if they coincide, nothing happens. The anchor point is the one set " +"by the most recent :meth:`selection_from` or :meth:`selection_adjust` call. " +"If there is no selection in the entry, a new one is created using the most " +"recent anchor point. :meth:`select_to` is an alias of :meth:`!selection_to`." +msgstr "" + +msgid "" +"Record *x* and the current view in the entry window, for use with " +"later :meth:`scan_dragto` calls. Typically associated with a mouse button " +"press in the widget." +msgstr "" + +msgid "" +"Compute the difference between *x* and the *x* given to the " +"last :meth:`scan_mark` call, and adjust the view left or right by 10 times " +"that difference. Typically associated with mouse motion events, to produce " +"the effect of dragging the entry at high speed through the window." +msgstr "" + +msgid "" +"A :class:`!Frame` widget is a simple container. Its primary purpose is to " +"act as a spacer or container for complex window layouts; its only features " +"are its background and an optional 3-D border to make the frame appear " +"raised or sunken. Inherits from :class:`Widget`. Refer to the Tk ``frame`` " +"manual page for the full list of options." +msgstr "" + +msgid "" +"A :class:`!Label` widget displays a non-interactive textual string, bitmap " +"or image. The displayed text is set with the *text* option or linked to a " +"variable through *textvariable*, and an image can be shown using the *image* " +"option. Text must all be in a single font but may occupy multiple lines, and " +"one character may be underlined with the *underline* option. Inherits " +"from :class:`Widget`. Refer to the Tk ``label`` manual page for the full " +"list of options." +msgstr "" + +msgid "" +"A :class:`!LabelFrame` widget is a container that has the features of " +"a :class:`Frame` plus the ability to display a label. The label text is set " +"with the *text* option and positioned with *labelanchor*, or an arbitrary " +"widget may be used as the label by giving it as the *labelwidget* option. " +"Inherits from :class:`Widget`. Refer to the Tk ``labelframe`` manual page " +"for the full list of options." +msgstr "" + +msgid "" +"A :class:`!Listbox` widget displays a list of single-line text items, one " +"per line, of which the user can select one or more. The way the selection " +"behaves is governed by the *selectmode* option, which is one of ``browse`` " +"(the default; at most one item, which may be dragged with the mouse), " +"``single`` (at most one item), ``multiple`` (any number of items, toggled " +"individually), or ``extended`` (any number of items, including discontiguous " +"ranges, selected by clicking and dragging). Inherits " +"from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be " +"scrolled horizontally and vertically with :meth:`~XView.xview` " +"and :meth:`~YView.yview`. Refer to the Tk ``listbox`` manual page for the " +"full list of options." +msgstr "" + +msgid "" +"Many of the methods take an *index* argument identifying a particular item. " +"As described in the Tk ``listbox`` manual page, *index* may be a numeric " +"index (counting from 0 at the top), ``'active'`` (the item with the location " +"cursor, set with :meth:`activate`), ``'anchor'`` (the selection anchor, set " +"with :meth:`selection_anchor`), ``'end'`` (the last item, or " +"for :meth:`index` and :meth:`insert` the position just after it), or " +"``@x,y`` (the item covering pixel coordinates *x*, *y* in the listbox " +"window). Arguments named *first* and *last* are indices of the same forms." +msgstr "" + +msgid "" +"Insert the given *elements* as new items just before the item given by " +"*index*. If *index* is ``'end'``, the new items are appended to the end of " +"the list." +msgstr "" + +msgid "" +"Delete the items in the range from *first* to *last* inclusive. If *last* is " +"omitted, it defaults to *first*, so that a single item is deleted." +msgstr "" + +msgid "" +"If *last* is omitted, return the contents of the item given by *first*, or " +"an empty string if *first* refers to a non-existent item. If *last* is " +"given, return a tuple of all the items in the range from *first* to *last* " +"inclusive." +msgstr "" + +msgid "Return the total number of items in the listbox." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`!Misc.size`; use :meth:`~Misc.grid_size` " +"for the grid size." +msgstr "" + +msgid "" +"Return the integer index value corresponding to *index*, or ``None`` if " +"*index* is out of range. If *index* is ``'end'``, the result is a count of " +"the number of items in the listbox (not the index of the last item)." +msgstr "" + +msgid "" +"Return a tuple ``(x, y, width, height)`` describing the bounding box, in " +"pixels relative to the widget, of the text of the item given by *index*. " +"Return ``None`` if no part of that item is visible on the screen, or if " +"*index* refers to a non-existent item; if the item is only partly visible, " +"the result still gives the full area of the item, including the parts that " +"are not visible." +msgstr "" + +msgid "" +"Given a y-coordinate within the listbox window, return the index of the " +"visible item nearest to that y-coordinate." +msgstr "" + +msgid "" +"Adjust the view so that the item given by *index* is visible. If the item is " +"already visible the method has no effect; if it is near an edge of the " +"window the listbox scrolls just enough to bring it into view at that edge, " +"otherwise the listbox scrolls to center the item." +msgstr "" + +msgid "" +"Set the active item to the one given by *index*. If *index* is outside the " +"range of items, the closest item is activated instead. The active item is " +"drawn as specified by the *activestyle* option when the widget has the input " +"focus, and its index may be retrieved with the ``'active'`` index." +msgstr "" + +msgid "" +"Return a tuple containing the numerical indices of all of the items that are " +"currently selected, or an empty tuple if no items are selected." +msgstr "" + +msgid "" +"Set the selection anchor to the item given by *index*. If *index* refers to " +"a non-existent item, the closest item is used. The selection anchor is the " +"end of the selection that is fixed while dragging out a selection with the " +"mouse, and may afterwards be referred to with the ``'anchor'`` " +"index. :meth:`select_anchor` is an alias of :meth:`!selection_anchor`." +msgstr "" + +msgid "" +"Deselect any of the items in the range from *first* to *last* inclusive that " +"are selected. The selection state of items outside this range is not " +"changed. :meth:`select_clear` is an alias of :meth:`!selection_clear`." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.selection_clear`, which clears the X " +"selection; that method is not available on a :class:`Listbox`." +msgstr "" + +msgid "" +"Return ``True`` if the item given by *index* is currently selected, " +"``False`` otherwise. :meth:`select_includes` is an alias of :meth:`!" +"selection_includes`." +msgstr "" + +msgid "" +"Select all of the items in the range from *first* to *last* inclusive, " +"without affecting the selection state of items outside that " +"range. :meth:`select_set` is an alias of :meth:`!selection_set`." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the item " +"given by *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the item given by *index*. This " +"mirrors :meth:`~Misc.configure`, except that it applies to an individual " +"item rather than to the listbox as a whole. With no options, it returns a " +"dictionary describing the current options of the item; otherwise it sets the " +"given options. The supported item options are *background*, *foreground*, " +"*selectbackground* and *selectforeground*. :meth:`itemconfig` is an alias " +"of :meth:`!itemconfigure`." +msgstr "" + +msgid "" +"Scroll the listbox by 10 times the difference between *x*, *y* and the " +"coordinates passed to the last :meth:`scan_mark` call. This is typically " +"bound to mouse motion events in the widget, producing the effect of dragging " +"the list at high speed through the window." +msgstr "" + +msgid "" +"A :class:`!Menu` widget displays a column of entries, each of which may be a " +"command, a checkbutton, a radiobutton, a cascade (which posts an associated " +"submenu) or a separator. Menus are used as the menubar of a toplevel window, " +"as pulldown menus posted from a cascade entry or menubutton, and as popup " +"menus. Inherits from :class:`Widget`." +msgstr "" + +msgid "" +"Many of the entry methods take an *index* argument that selects which entry " +"to operate on. As described in the Tk ``menu`` manual page, *index* may be a " +"numeric index (counting from 0 at the top), ``'active'`` (the currently " +"active entry), ``'end'`` or ``'last'`` (the bottommost entry), ``'none'`` " +"(no entry at all, written ``{}`` in Tcl), ``@y`` (the entry covering pixel y-" +"coordinate *y* in the menu window), or a pattern matched against the labels " +"of the entries from the top down." +msgstr "" + +msgid "" +"Add a new entry to the bottom of the menu. *itemType* is one of " +"``'command'``, ``'cascade'``, ``'checkbutton'``, ``'radiobutton'`` or " +"``'separator'`` and determines the type of the new entry; the remaining " +"options configure it. The :meth:`!add_command`, :meth:`!" +"add_cascade`, :meth:`!add_checkbutton`, :meth:`!add_radiobutton` and :meth:`!" +"add_separator` convenience methods call this method with the corresponding " +"*itemType*." +msgstr "" + +msgid "" +"The entry is configured by the following options, although not every option " +"applies to every entry type (a separator accepts none of them):" +msgstr "" + +msgid "*label*" +msgstr "" + +msgid "The text to display in the entry." +msgstr "" + +msgid "*command*" +msgstr "" + +msgid "" +"The function to call when the entry is invoked (command, checkbutton and " +"radiobutton entries)." +msgstr "" + +msgid "*accelerator*" +msgstr "" + +msgid "" +"A string displayed at the right of the entry to advertise an accelerator " +"keystroke; it does not itself create the binding." +msgstr "" + +msgid "" +"The index of a character in the label to underline for keyboard traversal." +msgstr "" + +msgid "One of ``'normal'``, ``'active'`` or ``'disabled'``." +msgstr "" + +msgid "An image to display instead of, or together with, the text label." +msgstr "" + +msgid "*compound*" +msgstr "" + +msgid "" +"Where to show the image relative to the text: ``'none'`` (the default), " +"``'text'``, ``'image'``, ``'top'``, ``'bottom'``, ``'left'`` or ``'right'``." +msgstr "" + +msgid "A bitmap to display instead of the text label." +msgstr "" + +msgid "The font to use for the text." +msgstr "" + +msgid "" +"The entry's background and foreground colors in its normal state (ignored on " +"macOS)." +msgstr "" + +msgid "*activebackground*, *activeforeground*" +msgstr "" + +msgid "" +"The background and foreground colors used when the entry is active (ignored " +"on macOS)." +msgstr "" + +msgid "*columnbreak*" +msgstr "" + +msgid "" +"If true, the entry starts a new column instead of being placed below the " +"previous entry." +msgstr "" + +msgid "*hidemargin*" +msgstr "" + +msgid "" +"If true, the standard margin around the entry is omitted, which is useful " +"when a menu is used as a palette." +msgstr "" + +msgid "*menu*" +msgstr "" + +msgid "The submenu posted by a cascade entry; it must be a child of this menu." +msgstr "" + +msgid "*variable*" +msgstr "" + +msgid "The variable associated with a checkbutton or radiobutton entry." +msgstr "" + +msgid "*onvalue*, *offvalue*" +msgstr "" + +msgid "" +"The values stored in *variable* when a checkbutton entry is selected or " +"cleared." +msgstr "" + +msgid "*value*" +msgstr "" + +msgid "The value stored in *variable* when a radiobutton entry is selected." +msgstr "" + +msgid "*indicatoron*" +msgstr "" + +msgid "Whether to display the indicator of a checkbutton or radiobutton entry." +msgstr "" + +msgid "*selectcolor*" +msgstr "" + +msgid "" +"The color of the indicator of a checkbutton or radiobutton entry when it is " +"selected." +msgstr "" + +msgid "*selectimage*" +msgstr "" + +msgid "" +"The image displayed when a checkbutton or radiobutton entry is selected and " +"*image* is also given." +msgstr "" + +msgid "" +"Add a new cascade entry to the bottom of the menu. A cascade entry has an " +"associated submenu, given by its *menu* option, which must be a child of " +"this menu; posting the entry posts the submenu next to it." +msgstr "" + +msgid "" +"Add a new checkbutton entry to the bottom of the menu. When invoked, a " +"checkbutton entry toggles between its *onvalue* and *offvalue*, storing the " +"result in its associated *variable*, and displays an indicator showing " +"whether it is selected." +msgstr "" + +msgid "" +"Add a new command entry to the bottom of the menu. A command entry behaves " +"much like a button: when it is invoked, the callback given by its *command* " +"option is called." +msgstr "" + +msgid "" +"Add a new radiobutton entry to the bottom of the menu. Radiobutton entries " +"sharing the same *variable* form a group of which only one may be selected " +"at a time; selecting an entry stores its *value* in the variable." +msgstr "" + +msgid "" +"Add a separator to the bottom of the menu. A separator is displayed as a " +"horizontal dividing line and cannot be activated or invoked." +msgstr "" + +msgid "" +"Same as :meth:`add`, except that the new entry is inserted just before the " +"entry given by *index* instead of being appended to the end of the menu. " +"*itemType* is one of ``'command'``, ``'cascade'``, ``'checkbutton'``, " +"``'radiobutton'`` or ``'separator'``. The :meth:`!insert_command`, :meth:`!" +"insert_cascade`, :meth:`!insert_checkbutton`, :meth:`!insert_radiobutton` " +"and :meth:`!insert_separator` convenience methods call this method with the " +"corresponding *itemType*." +msgstr "" + +msgid "" +"Insert a new cascade entry before the entry given by *index* " +"(see :meth:`add_cascade`)." +msgstr "" + +msgid "" +"Insert a new checkbutton entry before the entry given by *index* " +"(see :meth:`add_checkbutton`)." +msgstr "" + +msgid "" +"Insert a new command entry before the entry given by *index* " +"(see :meth:`add_command`)." +msgstr "" + +msgid "" +"Insert a new radiobutton entry before the entry given by *index* " +"(see :meth:`add_radiobutton`)." +msgstr "" + +msgid "" +"Insert a separator before the entry given by *index* " +"(see :meth:`add_separator`)." +msgstr "" + +msgid "" +"Delete all of the menu entries between *index1* and *index2* inclusive. If " +"*index2* is omitted, it defaults to *index1*, so that a single entry is " +"deleted. Attempts to delete a tear-off entry are ignored; remove it by " +"changing the *tearoff* option instead." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the entry " +"given by *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the entry given by *index*. " +"This mirrors :meth:`~Misc.configure`, except that it applies to an " +"individual entry rather than to the menu as a whole. With no options, it " +"returns a dictionary describing the current options of the entry; otherwise " +"it sets the given options. The supported options are those accepted " +"by :meth:`add` for the entry's type. :meth:`entryconfig` is an alias " +"of :meth:`!entryconfigure`." +msgstr "" + +msgid "" +"Return the numerical index corresponding to *index*, or ``None`` if *index* " +"selects no entry." +msgstr "" + +msgid "" +"Return the type of the entry given by *index*: one of ``'command'``, " +"``'cascade'``, ``'checkbutton'``, ``'radiobutton'``, ``'separator'`` or " +"``'tearoff'`` (for the tear-off entry)." +msgstr "" + +msgid "" +"Make the entry given by *index* the active entry, redisplaying it with its " +"active colors, and deactivate any previously active entry. If *index* " +"selects no entry, or the selected entry is disabled, the menu ends up with " +"no active entry." +msgstr "" + +msgid "" +"Invoke the action of the entry given by *index*, as if it had been clicked. " +"Nothing happens if the entry is disabled. If the entry has a *command* " +"associated with it, the result of that command is returned; otherwise the " +"result is an empty string." +msgstr "" + +msgid "" +"Display the menu on the screen at the root-window coordinates *x* and *y*, " +"adjusting them if necessary so that the whole menu is visible. If the " +"*postcommand* option has been specified, it is evaluated before the menu is " +"posted." +msgstr "" + +msgid "" +"Post the menu as a popup at the root-window coordinates *x* and *y*. If " +"*entry* is given, the menu is positioned so that this entry is displayed " +"under the pointer." +msgstr "" + +msgid "" +"Unmap the menu so that it is no longer displayed, also unposting any posted " +"lower-level cascaded submenu. This has no effect on Windows and macOS, which " +"manage the unposting of menus themselves." +msgstr "" + +msgid "" +"Return the x-coordinate, within the menu window, of the leftmost pixel of " +"the entry given by *index*." +msgstr "" + +msgid "" +"Return the y-coordinate, within the menu window, of the topmost pixel of the " +"entry given by *index*." +msgstr "" + +msgid "" +"A :class:`!Menubutton` widget displays a textual string, bitmap or image and " +"posts an associated :class:`Menu`, given by its *menu* option, when the user " +"presses it. Like a :class:`Label` it can show *text*, a *textvariable*, or " +"an *image*, and the *direction* option controls where the menu appears " +"relative to the button. Inherits from :class:`Widget`. Refer to the Tk " +"``menubutton`` manual page for the full list of options." +msgstr "" + +msgid "" +"A :class:`!Message` widget displays a non-interactive textual string, given " +"by the *text* option or linked to a variable through *textvariable*. Unlike " +"a :class:`Label`, it breaks the string into multiple lines in order to " +"produce a given aspect ratio, choosing line breaks at word boundaries, and " +"it can justify the text left, centered or right. Inherits " +"from :class:`Widget`. Refer to the Tk ``message`` manual page for the full " +"list of options." +msgstr "" + +msgid "" +"A helper subclass of :class:`Menubutton` that displays a pop-up menu of " +"mutually exclusive choices. *variable* is a :class:`Variable` kept in sync " +"with the selection, *value* is the initial choice, and *values* are the " +"remaining menu entries. The keyword argument *command* may be given a " +"callback that is invoked with the selected value, and the keyword argument " +"*name* sets the Tk widget name." +msgstr "" + +msgid "Destroy the widget, also cleaning up the associated pop-up menu." +msgstr "" + +msgid "Added support for the *name* keyword argument." +msgstr "" + +msgid "" +"A :class:`!PanedWindow` is a geometry-manager widget that arranges any " +"number of child *panes* in a row (when *orient* is ``'horizontal'``) or a " +"column (when *orient* is ``'vertical'``). Each pane holds one widget, and " +"each pair of adjacent panes is separated by a movable *sash* that the user " +"can drag with the mouse to resize the widgets on either side of it. Inherits " +"from :class:`Widget`." +msgstr "" + +msgid "" +"The *orient* option selects the layout direction, *sashwidth* sets the width " +"of each sash and *sashrelief* its relief. When *showhandle* is true a small " +"handle is drawn on each sash that the user can grab to drag it. Refer to the " +"Tk ``panedwindow`` manual page for the full list of options." +msgstr "" + +msgid "" +"Add *child* to the panedwindow as a new pane, placed after any existing " +"panes. The keyword arguments specify per-pane management options for " +"*child*; they may be any of the options accepted by :meth:`paneconfigure`." +msgstr "" + +msgid "" +"Remove the pane containing *child* from the panedwindow. All geometry " +"management options for *child* are forgotten. :meth:`forget` is an alias " +"of :meth:`!remove`. This shadows the inherited geometry-manager :meth:`!" +"forget`; use :meth:`~Pack.pack_forget`, :meth:`~Grid.grid_forget` " +"or :meth:`~Place.place_forget` to remove the widget itself from its manager." +msgstr "" + +msgid "" +"Return a tuple of the widgets managed by the panedwindow, one per pane, in " +"order." +msgstr "" + +msgid "" +"Return the current value of the management option *option* for the pane " +"containing *child*. *option* may be any value allowed " +"by :meth:`paneconfigure`." +msgstr "" + +msgid "" +"Query or modify the management options of the pane containing the widget " +"*tagOrId*. With no options, it returns a dictionary describing all of the " +"available options for the pane; given a single option name as a string, it " +"returns a description of that one option; otherwise it sets the given " +"options. The supported options include *after* and *before* (insert the pane " +"after or before another managed window), *height* and *width* (the outer " +"dimensions of the window, including any border), *minsize* (the minimum size " +"in the paned dimension), *padx* and *pady* (extra space to leave on each " +"side of the window), *sticky* (position or stretch the window within an " +"oversized pane, using a string of the characters ``n``, ``s``, ``e`` and " +"``w``), *hide* (hide the pane while keeping it in the list of panes) and " +"*stretch* (how extra space is allocated to the pane: one of ``'always'``, " +"``'first'``, ``'last'``, ``'middle'`` or ``'never'``). :meth:`paneconfig` is " +"an alias of :meth:`!paneconfigure`." +msgstr "" + +msgid "" +"Identify the panedwindow component underneath the point given by *x* and " +"*y*, in window coordinates. If the point is over a sash or a sash handle, " +"the result is a two-element tuple containing the index of the sash or handle " +"and a word indicating whether it is over a sash or a handle, such as ``(0, " +"'sash')`` or ``(2, 'handle')``. If the point is over any other part of the " +"panedwindow, the result is an empty string." +msgstr "" + +msgid "" +"Query or change the position of the sashes in the panedwindow. This is a " +"thin wrapper around the Tk ``sash`` subcommand; the convenience " +"methods :meth:`sash_coord`, :meth:`sash_mark` and :meth:`sash_place` should " +"normally be used instead." +msgstr "" + +msgid "" +"Return the current x and y coordinate pair for the sash given by *index*, " +"which must be an integer between 0 and one less than the number of panes in " +"the panedwindow. The coordinates returned are those of the top left corner " +"of the region containing the sash." +msgstr "" + +msgid "" +"Record the current mouse position for the sash given by *index*, for use " +"together with later sash-drag operations to move the sash." +msgstr "" + +msgid "Place the sash given by *index* at the coordinates *x* and *y*." +msgstr "" + +msgid "" +"Query or change the position of the sash proxy, the \"ghost\" sash shown " +"while a sash is being dragged with non-opaque resizing. This is a thin " +"wrapper around the Tk ``proxy`` subcommand; the convenience " +"methods :meth:`proxy_coord`, :meth:`proxy_forget` and :meth:`proxy_place` " +"should normally be used instead." +msgstr "" + +msgid "" +"Return a tuple containing the x and y coordinates of the most recent proxy " +"location." +msgstr "" + +msgid "Remove the proxy from the display." +msgstr "" + +msgid "Place the proxy at the coordinates *x* and *y*." +msgstr "" + +msgid "" +"A :class:`!Radiobutton` widget displays a textual string, bitmap or image " +"together with a diamond or circular indicator, and selects one choice out of " +"several. It has all the behavior of a simple button and, in addition, can be " +"selected: typically several radiobuttons share a single *variable*, and " +"selecting one sets that variable to the radiobutton's *value*; each " +"radiobutton also monitors the variable and automatically selects or " +"deselects itself when the variable changes. Inherits from :class:`Widget`. " +"In addition to the standard widget options, a radiobutton accepts the " +"options documented in the Tk ``radiobutton`` manual page, such as " +"*variable*, *value* and *command*." +msgstr "" + +msgid "" +"Do just what would happen if the user pressed the radiobutton with the " +"mouse: select the button and invoke the associated command, if there is one. " +"Return the result of the command, or an empty string if no command is " +"associated with the radiobutton. This is ignored if the radiobutton's state " +"is ``disabled``." +msgstr "" + +msgid "" +"Select the radiobutton and set the associated variable to the value " +"corresponding to this widget." +msgstr "" + +msgid "" +"Deselect the radiobutton and set the associated variable to an empty string. " +"If this radiobutton was not currently selected, this has no effect." +msgstr "" + +msgid "" +"Flash the radiobutton by redisplaying it several times, alternating between " +"the active and normal colors. At the end of the flash the radiobutton is " +"left in the same normal or active state as when the method was called. This " +"is ignored if the radiobutton's state is ``disabled``." +msgstr "" + +msgid "" +"A :class:`!Scale` widget lets the user select a numerical value by moving a " +"slider along a trough. It can be oriented vertically or horizontally and can " +"optionally display a label and the current value. Inherits " +"from :class:`Widget`." +msgstr "" + +msgid "" +"In addition to the standard widget options, a scale accepts the options " +"documented in the Tk ``scale`` manual page, such as *from_*, *to*, " +"*resolution*, *orient*, *tickinterval*, *variable* and *command*. As " +"elsewhere in :mod:`!tkinter`, the leading ``-`` of the Tk option name is " +"dropped; *from* is spelled ``from_`` because :keyword:`from` is a Python " +"keyword." +msgstr "" + +msgid "" +"With a non-integer *resolution*, see :ref:`numeric values and the locale " +"`." +msgstr "" + +msgid "" +"Return the current value of the scale. The result is an integer if the " +"scale's *resolution* yields whole numbers, and a float otherwise." +msgstr "" + +msgid "" +"Set the scale to *value*, moving the slider accordingly. This has no effect " +"if the scale is disabled." +msgstr "" + +msgid "" +"Return a tuple ``(x, y)`` giving the pixel coordinates, relative to the " +"widget, of the point on the centerline of the trough that corresponds to " +"*value*. If *value* is omitted, the scale's current value is used." +msgstr "" + +msgid "" +"Return a string describing the part of the scale at the pixel coordinates " +"*x*, *y*: ``'slider'``, ``'trough1'`` (the part of the trough above or to " +"the left of the slider), ``'trough2'`` (below or to the right of the " +"slider), or an empty string if the point is not over any of these elements." +msgstr "" + +msgid "" +"A :class:`!Scrollbar` widget displays a slider and two arrows that let the " +"user scroll an associated widget, such as " +"a :class:`Listbox`, :class:`Text`, :class:`Canvas` or :class:`Entry`. It is " +"connected to the scrolled widget by setting that widget's *xscrollcommand* " +"or *yscrollcommand* option to the scrollbar's :meth:`set` method, and the " +"scrollbar's *command* option to the scrolled widget's :meth:`~XView.xview` " +"or :meth:`~YView.yview` method. Inherits from :class:`Widget`." +msgstr "" + +msgid "" +"Return the current scrollbar settings as a tuple ``(first, last)`` of two " +"fractions between 0 and 1, describing the portion of the document that is " +"currently visible, as last passed to :meth:`set`." +msgstr "" + +msgid "" +"Set the scrollbar. *first* and *last* are fractions between 0 and 1 giving " +"the positions of the start and end of the visible portion of the associated " +"document. This method is normally registered as the scrolled widget's " +"*xscrollcommand* or *yscrollcommand* and called by that widget." +msgstr "" + +msgid "" +"Mark the element *index* (one of ``'arrow1'``, ``'slider'`` or ``'arrow2'``) " +"as active, displaying it according to the *activebackground* and " +"*activerelief* options. If *index* is omitted, return the name of the " +"currently active element, or ``None`` if no element is active." +msgstr "" + +msgid "The *index* argument is now optional." +msgstr "" + +msgid "" +"Return a float indicating the fractional change in the scrollbar setting " +"that corresponds to moving the slider by *deltax* pixels horizontally (for " +"horizontal scrollbars) or *deltay* pixels vertically (for vertical " +"scrollbars)." +msgstr "" + +msgid "" +"Return a float between 0 and 1 indicating where the point at pixel " +"coordinates *x*, *y* lies in the trough: 0 corresponds to the top or left of " +"the trough and 1 to the bottom or right." +msgstr "" + +msgid "" +"Return the name of the element under the pixel coordinates *x*, *y* (such as " +"``'arrow1'``), or an empty string if the point does not lie in any element " +"of the scrollbar." +msgstr "" + +msgid "" +"A :class:`!Spinbox` widget is an :class:`Entry`-like widget with a pair of " +"up/down arrow buttons that let the user step through a range of values in " +"addition to editing the value directly. The set of values may be a numeric " +"range given by the *from_*, *to* and *increment* options, or an explicit " +"list of strings given by the *values* option (which takes precedence over " +"the range). Each time an arrow is invoked the *command* callback, if any, is " +"called; the boolean *wrap* option controls whether stepping past either end " +"of the range wraps around to the other end; the *format* option specifies " +"how numeric values are formatted; and the *validate* option enables " +"validation of the entered text. Inherits from :class:`Widget` " +"and :class:`XView`." +msgstr "" + +msgid "" +"With a non-integer *increment*, see :ref:`numeric values and the locale " +"`." +msgstr "" + +msgid "" +"Many of the methods take an *index* argument identifying a character in the " +"spinbox's string. As described in the Tk ``spinbox`` manual page, *index* " +"may be a numeric index (counting from 0), ``'anchor'`` (the selection anchor " +"point), ``'end'`` (just after the last character), ``'insert'`` (the " +"character just after the insertion cursor), ``'sel.first'`` or " +"``'sel.last'`` (the ends of the selection), or ``@x`` (the character " +"covering pixel x-coordinate *x* in the window)." +msgstr "" + +msgid "Return the spinbox's string." +msgstr "" + +msgid "" +"Insert the characters of the string *s* just before the character given by " +"*index*." +msgstr "" + +msgid "" +"Delete one or more characters of the spinbox. *first* is the index of the " +"first character to delete, and *last* is the index of the character just " +"after the last one to delete. If *last* is omitted, a single character at " +"*first* is deleted." +msgstr "" + +msgid "Return the numerical index corresponding to *index*, as a string." +msgstr "" + +msgid "" +"Return a tuple of four integers ``(x, y, width, height)`` describing the " +"bounding box of the character given by *index*. *x* and *y* are the pixel " +"coordinates of the upper-left corner of the character relative to the " +"widget, and *width* and *height* are its size in pixels. The bounding box " +"may refer to a region outside the visible area of the window." +msgstr "" + +msgid "" +"Return the name of the window element at the pixel coordinates *x*, *y*: one " +"of ``'buttondown'``, ``'buttonup'``, ``'entry'`` or ``'none'``." +msgstr "" + +msgid "" +"Invoke the spin button given by *element*, either ``'buttonup'`` or " +"``'buttondown'``, triggering the action associated with it." +msgstr "" + +msgid "" +"A thin wrapper around the Tk ``scan`` widget subcommand, used to implement " +"fast dragging of the view: ``scan('mark', x)`` records *x* and the current " +"view, and ``scan('dragto', x)`` adjusts the view relative to that mark. " +"The :meth:`scan_mark` and :meth:`scan_dragto` methods wrap the two forms." +msgstr "" + +msgid "" +"Record *x* and the current view in the spinbox window, for use with a " +"later :meth:`scan_dragto` call. This is typically associated with a mouse " +"button press in the widget." +msgstr "" + +msgid "" +"Adjust the view by 10 times the difference between *x* and the *x* passed to " +"the last :meth:`scan_mark` call. This is typically associated with mouse " +"motion events, producing the effect of dragging the spinbox at high speed " +"through the window." +msgstr "" + +msgid "" +"A thin wrapper around the Tk ``selection`` widget subcommand, used to adjust " +"the selection within the spinbox. It has several forms depending on the " +"first argument, such as ``selection('adjust', index)``, " +"``selection('clear')``, ``selection('element', ?elem?)``, " +"``selection('from', index)``, ``selection('present')``, ``selection('range', " +"start, end)`` and ``selection('to', index)``. " +"The :meth:`selection_adjust`, :meth:`selection_clear`, :meth:`selection_element`, :meth:`selection_from`, :meth:`selection_present`, :meth:`selection_range` " +"and :meth:`selection_to` methods wrap these forms." +msgstr "" + +msgid "" +"Locate the end of the selection nearest to the character given by *index* " +"and adjust that end of the selection to be at *index* (including but not " +"going beyond *index*). The other end becomes the anchor point for " +"future :meth:`selection_to` calls. If the selection is not currently in the " +"spinbox, a new selection is created to include the characters between " +"*index* and the most recent anchor point, inclusive." +msgstr "" + +msgid "" +"Clear the selection if it is currently in this widget. If the selection is " +"not in this widget, the method has no effect." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.selection_clear`, which clears the X " +"selection; that method is not available on a :class:`Spinbox`." +msgstr "" + +msgid "" +"Set or get the currently selected element. If *element* (one of " +"``'buttonup'``, ``'buttondown'`` or ``'none'``) is given, that spin button " +"is selected and displayed depressed; otherwise the name of the currently " +"selected element is returned." +msgstr "" + +msgid "" +"Set the selection anchor point to just before the character given by " +"*index*, without changing the selection itself." +msgstr "" + +msgid "" +"Return ``True`` if there are characters selected in the spinbox, ``False`` " +"otherwise." +msgstr "" + +msgid "" +"Set the selection to include the characters starting with the one indexed by " +"*start* and ending with the one just before *end*. If *end* refers to the " +"same character as *start* or an earlier one, the selection is cleared." +msgstr "" + +msgid "" +"Set the selection between *index* and the anchor point. If *index* is before " +"the anchor point, the selection runs from *index* up to but not including " +"the anchor point; if it is after, the selection runs from the anchor point " +"up to but not including *index*; if it is the same, nothing happens. The " +"anchor point is the one set by the most recent :meth:`selection_from` " +"or :meth:`selection_adjust` call. If the selection is not in this widget, a " +"new selection is created using the most recent anchor point." +msgstr "" + +msgid "" +"A :class:`!Text` widget displays and edits multi-line text. Portions of the " +"text may be styled with **tags**, particular positions may be annotated with " +"floating **marks**, and arbitrary images and other widgets may be embedded " +"in the text. The widget also provides an unlimited undo/redo mechanism and " +"supports peer widgets that share the same underlying data. Inherits " +"from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be " +"scrolled horizontally and vertically with :meth:`~XView.xview` " +"and :meth:`~YView.yview`. Refer to the Tk ``text`` manual page for the full " +"list of options." +msgstr "" + +msgid "" +"Most of the methods take one or more *index* arguments that identify a " +"position within the text. As described in the Tk ``text`` manual page, an " +"index is a string consisting of a base, optionally followed by one or more " +"modifiers. The base may be ``'line.char'`` (line *line*, character *char*, " +"where lines are counted from 1 and characters within a line from 0; " +"``'line.end'`` refers to the newline ending the line), ``'end'`` (the " +"position just after the last newline), the name of a mark, ``'tag.first'`` " +"or ``'tag.last'`` (the first character tagged with *tag*, or the position " +"just after the last such character), the name of an embedded image or " +"window, or ``@x,y`` (the character covering pixel coordinates *x*, *y* in " +"the widget). A modifier such as ``'+5 chars'``, ``'-3 lines'``, " +"``'linestart'``, ``'lineend'``, ``'wordstart'`` or ``'wordend'`` adjusts the " +"index relative to its base; several modifiers may be combined and are " +"applied from left to right, for example ``'insert wordstart - 1 c'``." +msgstr "" + +msgid "" +"Insert the string *chars* just before the character at *index* (if *index* " +"is ``'end'``, just before the final newline). By default the new text " +"inherits any tags present on both sides of the insertion point. If *args* is " +"given, it consists of alternating *tagList*, *chars* values: the preceding " +"*chars* receives exactly the tags listed (a tag list may be a single tag " +"name or a sequence of names), overriding the surrounding tags." +msgstr "" + +msgid "" +"Delete the range of characters from *index1* up to but not including " +"*index2*. If *index2* is omitted, the single character at *index1* is " +"deleted. The widget always keeps a newline as its last character, so a " +"deletion that would remove it is adjusted accordingly." +msgstr "" + +msgid "" +"Replace the range of characters from *index1* up to but not including " +"*index2* with *chars*. This is equivalent to a :meth:`delete` followed by " +"an :meth:`insert` at *index1*; *args* is interpreted as for :meth:`insert`." +msgstr "" + +msgid "" +"Return the text from *index1* up to but not including *index2* as a string. " +"If *index2* is omitted, return the single character at *index1*. Embedded " +"images and windows are omitted from the result." +msgstr "" + +msgid "" +"Return the position corresponding to *index* in the canonical " +"``'line.char'`` form." +msgstr "" + +msgid "" +"Compare the positions of *index1* and *index2* using the relational operator " +"*op*, which must be one of ``'<'``, ``'<='``, ``'=='``, ``'>='``, ``'>'`` or " +"``'!='``, and return the boolean result." +msgstr "" + +msgid "" +"Count the number of items of the requested kinds between *index1* and " +"*index2*; the count is negative if *index1* is after *index2*. Each of " +"*options* names a kind of item to count: ``'chars'``, ``'displaychars'``, " +"``'displayindices'``, ``'displaylines'``, ``'indices'``, ``'lines'``, " +"``'xpixels'`` or ``'ypixels'`` (the default, used when no option is given, " +"is ``'indices'``). The pseudo-option ``'update'`` forces any out-of-date " +"layout information to be recalculated before the following options are " +"evaluated. When *return_ints* is true and a single counting option is given, " +"return a plain integer; otherwise return a tuple with one integer per " +"counting option (or ``None`` if the result is empty)." +msgstr "" + +msgid "Added the *return_ints* parameter." +msgstr "" + +msgid "" +"Adjust the view so that the character given by *index* is visible. If it is " +"already visible the method has no effect; if it is a short distance out of " +"view the widget scrolls just enough to bring it to the nearest edge, " +"otherwise it scrolls to center *index* in the window." +msgstr "" + +msgid "" +"Return a tuple ``(x, y, width, height)`` giving the bounding box, in pixels, " +"of the visible part of the character at *index*, or ``None`` if that " +"character is not visible on the screen." +msgstr "" + +msgid "" +"Return a tuple ``(x, y, width, height, baseline)`` describing the display " +"line that contains *index*: the first four values give the bounding box of " +"the line in pixels and *baseline* gives the offset of the baseline measured " +"down from the top of the area. Return ``None`` if that display line is not " +"visible on the screen." +msgstr "" + +msgid "" +"Set the mark named *markName* to the position just before the character at " +"*index*, creating the mark if it does not already exist. A mark created this " +"way has right gravity by default." +msgstr "" + +msgid "" +"Remove each of the marks named in *markNames*. The special ``insert`` and " +"``current`` marks may not be removed." +msgstr "" + +msgid "Return a tuple of the names of all marks currently set in the widget." +msgstr "" + +msgid "" +"If *direction* is omitted, return the gravity of mark *markName*, either " +"``'left'`` or ``'right'``. Otherwise set its gravity to *direction*. The " +"gravity determines on which side of the mark text inserted at the mark's " +"position appears: a mark with right gravity (the default) stays to the right " +"of such text." +msgstr "" + +msgid "" +"Return the name of the first mark at or after *index*, or ``None`` if there " +"is none. When *index* is the name of a mark, the search starts just after " +"that mark." +msgstr "" + +msgid "" +"Return the name of the last mark at or before *index*, or ``None`` if there " +"is none. When *index* is the name of a mark, the search starts just before " +"that mark." +msgstr "" + +msgid "" +"Add the tag *tagName* to the range of characters from *index1* up to but not " +"including the next index in *args*. Further pairs of indices may follow in " +"*args* to tag additional ranges; a trailing single index tags just the " +"character at that index." +msgstr "" + +msgid "" +"Remove the tag *tagName* from the characters from *index1* up to but not " +"including *index2* (or from the single character at *index1* if *index2* is " +"omitted). The tag itself continues to exist even if no characters carry it." +msgstr "" + +msgid "" +"Delete each of the tags named in *tagNames*, removing them from all " +"characters and discarding their options and bindings." +msgstr "" + +msgid "" +"Query or modify the configuration options of the tag *tagName*. This " +"mirrors :meth:`~Misc.configure`, except that it applies to a tag rather than " +"to the widget as a whole: with no options it returns a dictionary describing " +"the current options, otherwise it sets the given options. Defining a tag " +"this way also gives it a priority higher than any existing tag." +msgstr "" + +msgid "" +"The supported tag options, all controlling the appearance of the tagged " +"text, are:" +msgstr "" + +msgid "*foreground*" +msgstr "" + +msgid "The color to use for the text." +msgstr "" + +msgid "*background*" +msgstr "" + +msgid "The color to use for the area behind the text." +msgstr "" + +msgid "*fgstipple*, *bgstipple*" +msgstr "" + +msgid "" +"Bitmaps used to stipple the foreground (text) and the background; only well " +"supported on X11." +msgstr "" + +msgid "*borderwidth*" +msgstr "" + +msgid "" +"The width of the border drawn around the text according to *relief* (default " +"``0``)." +msgstr "" + +msgid "*relief*" +msgstr "" + +msgid "" +"The 3-D appearance of the text's border: ``'flat'`` (the default), " +"``'raised'``, ``'sunken'``, ``'ridge'``, ``'groove'`` or ``'solid'``." +msgstr "" + +msgid "*offset*" +msgstr "" + +msgid "" +"How far the text is raised above (or, if negative, lowered below) the " +"baseline, for superscripts and subscripts." +msgstr "" + +msgid "Whether to underline the text (a boolean)." +msgstr "" + +msgid "*underlinefg*" +msgstr "" + +msgid "The color of the underline; it defaults to the text color." +msgstr "" + +msgid "*overstrike*" +msgstr "" + +msgid "Whether to draw a line through the middle of the text." +msgstr "" + +msgid "*overstrikefg*" +msgstr "" + +msgid "The color of the overstrike line; it defaults to the text color." +msgstr "" + +msgid "*elide*" +msgstr "" + +msgid "Whether the text is elided (hidden)." +msgstr "" + +msgid "" +"How to justify the first character of a display line: ``'left'`` (the " +"default), ``'right'`` or ``'center'``." +msgstr "" + +msgid "*wrap*" +msgstr "" + +msgid "" +"How to wrap lines that are too long: ``'char'``, ``'word'`` or ``'none'``." +msgstr "" + +msgid "*lmargin1*, *lmargin2*" +msgstr "" + +msgid "" +"The indentation, in pixels, of the first display line of a logical line and " +"of the remaining display lines." +msgstr "" + +msgid "*lmargincolor*" +msgstr "" + +msgid "The color of the left margin area." +msgstr "" + +msgid "*rmargin*" +msgstr "" + +msgid "The right-hand margin, in pixels." +msgstr "" + +msgid "*rmargincolor*" +msgstr "" + +msgid "The color of the right margin area." +msgstr "" + +msgid "*spacing1*, *spacing2*, *spacing3*" +msgstr "" + +msgid "" +"Extra space, in pixels, above the first display line of a logical line, " +"between its display lines, and below its last display line." +msgstr "" + +msgid "*tabs*" +msgstr "" + +msgid "The set of tab stops, in the same form as the widget's *tabs* option." +msgstr "" + +msgid "*tabstyle*" +msgstr "" + +msgid "How tab stops are interpreted: ``'tabular'`` or ``'wordprocessor'``." +msgstr "" + +msgid "*selectbackground*, *selectforeground*" +msgstr "" + +msgid "" +"The background and foreground colors used for the text while it is selected." +msgstr "" + +msgid "" +"Tk 8.6 added the *lmargincolor*, *overstrikefg*, *rmargincolor*, " +"*selectbackground*, *selectforeground* and *underlinefg* options." +msgstr "" + +msgid ":meth:`tag_config` is an alias of :meth:`!tag_configure`." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the tag " +"*tagName*." +msgstr "" + +msgid "" +"If *index* is omitted, return a tuple of the names of all tags defined in " +"the widget; otherwise return only the names of the tags applied to the " +"character at *index*. The names are ordered from lowest to highest priority." +msgstr "" + +msgid "" +"Return a tuple of indices describing all ranges of text tagged with " +"*tagName*. The result alternates start and end indices, so that elements " +"``2*i`` and ``2*i+1`` bound the *i*-th range." +msgstr "" + +msgid "" +"Search forward from *index1* (up to *index2* if given) for the first range " +"of characters tagged with *tagName*, and return a two-element tuple of its " +"start and end indices, or an empty tuple if there is no such range." +msgstr "" + +msgid "" +"Search backward from *index1* (down to *index2* if given) for the nearest " +"preceding range of characters tagged with *tagName*, and return a two-" +"element tuple of its start and end indices, or an empty tuple if there is no " +"such range." +msgstr "" + +msgid "" +"Raise the priority of tag *tagName* so that it is just above the priority of " +"*aboveThis*, or to the highest priority of all tags if *aboveThis* is " +"omitted. When the display options of overlapping tags conflict, the higher-" +"priority tag wins." +msgstr "" + +msgid "" +"Lower the priority of tag *tagName* so that it is just below the priority of " +"*belowThis*, or to the lowest priority of all tags if *belowThis* is omitted." +msgstr "" + +msgid "" +"Bind the event *sequence* on characters tagged with *tagName* to the " +"callback *func*, so that *func* is invoked when that event occurs over such " +"a character. If *add* is true the binding is added alongside any existing " +"bindings for *sequence*, otherwise it replaces them. Works " +"like :meth:`~Misc.bind` and returns the identifier of the new binding." +msgstr "" + +msgid "" +"Remove the bindings of the event *sequence* on characters tagged with " +"*tagName*. If *funcid* is given, only that binding (as returned " +"by :meth:`tag_bind`) is removed and its callback is unregistered." +msgstr "" + +msgid "" +"Embed an image at *index* and return the name assigned to this image " +"instance, which may then be used as an index or passed to the other " +"``image_*`` methods. The options, given in *cnf* and *kw*, include *image* " +"(the Tk image to display), *name* (a base name for the instance), *align*, " +"*padx* and *pady*." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the " +"embedded image at *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the embedded image at *index*, " +"like :meth:`~Misc.configure` but applied to that image." +msgstr "" + +msgid "Return a tuple of the names of all images embedded in the widget." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.image_names`, which returns the names " +"of all images in the Tcl interpreter; that method is not available on " +"a :class:`Text`." +msgstr "" + +msgid "" +"Embed a window (any widget) at *index*. The options, given in *cnf* and " +"*kw*, include *window* (the widget to embed), *create* (a callback that " +"creates the widget on demand), *align*, the boolean *stretch* (whether the " +"widget is stretched vertically to the height of the line), *padx* and " +"*pady*. The embedded widget must be a descendant of the text widget's parent." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the " +"embedded window at *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the embedded window at *index*, " +"like :meth:`~Misc.configure` but applied to that window." +msgstr "" + +msgid ":meth:`window_config` is an alias of :meth:`!window_configure`." +msgstr "" + +msgid "Return a tuple of the names of all windows embedded in the widget." +msgstr "" + +msgid "" +"Low-level wrapper around the Tk ``edit`` widget command that controls the " +"undo/redo mechanism and the modified flag; *args* is the ``edit`` subcommand " +"and its arguments. The :meth:`!edit_\\*` methods below are thin wrappers " +"around it and are usually more convenient." +msgstr "" + +msgid "" +"If *arg* is omitted, return the current state of the modified flag as true " +"or false; the flag is set automatically whenever the text is inserted or " +"deleted. Otherwise set the flag to the boolean *arg*." +msgstr "" + +msgid "" +"Undo the most recent edit action, that is, all the inserts and deletes " +"recorded on the undo stack since the previous separator, and move it to the " +"redo stack. Raises :exc:`TclError` if the undo stack is empty. Has no effect " +"unless the *undo* option is true. Since Tk 9.0, returns a tuple of indices " +"delimiting the ranges of text that were changed." +msgstr "" + +msgid "" +"Reapply the most recently undone edit action, provided no further edits have " +"been made since, and move it back to the undo stack. Raises :exc:`TclError` " +"if the redo stack is empty. Has no effect unless the *undo* option is true. " +"Since Tk 9.0, returns a tuple of indices delimiting the ranges of text that " +"were changed." +msgstr "" + +msgid "Clear the undo and redo stacks." +msgstr "" + +msgid "" +"Push a separator onto the undo stack, marking a boundary between edit " +"actions for undo and redo. Has no effect unless the *undo* option is true. " +"Separators are inserted automatically when the *autoseparators* option is " +"true." +msgstr "" + +msgid "" +"Search for *pattern* starting at *index* and return the index of the first " +"character of the first match, or an empty string if there is no match. " +"Searching stops at *stopindex* if given; otherwise it wraps around the ends " +"of the text until the starting position is reached again. The following " +"boolean keyword flags control the search: *forwards* or *backwards* select " +"the direction (forward is the default); *exact* (the default) or *regexp* " +"select literal or regular-expression matching; *nocase* makes the match case-" +"insensitive; and *elide* causes hidden text to be searched as well. If " +"*count* is a :class:`Variable`, the number of index positions in the match " +"is stored in it." +msgstr "" + +msgid "" +"Scroll the widget by 10 times the difference between *x*, *y* and the " +"coordinates passed to the last :meth:`scan_mark` call. This is typically " +"bound to mouse motion events, producing the effect of dragging the text at " +"high speed through the window." +msgstr "" + +msgid "" +"If *boolean* is omitted, return whether internal consistency checks of the B-" +"tree data structure are enabled. Otherwise enable or disable them. The " +"setting is shared by all text widgets and may noticeably slow down widgets " +"holding large amounts of text." +msgstr "" + +msgid "" +"Return the contents of the widget from *index1* up to but not including " +"*index2* (or just the segment at *index1* if *index2* is omitted), including " +"text and information about marks, tags, images and windows. The result is a " +"list of ``(key, value, index)`` triples, where *key* is one of ``'text'``, " +"``'mark'``, ``'tagon'``, ``'tagoff'``, ``'image'`` or ``'window'``. By " +"default all kinds are reported; passing any of the keyword arguments *all*, " +"*text*, *mark*, *tag*, *image* or *window* as true restricts the dump to the " +"selected kinds. If *command* is given, it is called once per triple with the " +"three values as arguments and nothing is returned." +msgstr "" + +msgid "" +"Create a peer text widget with the path name *newPathName* that shares this " +"widget's underlying data (text, marks, tags, images and the undo stack). " +"Changes made through any peer are reflected in all of them. By default the " +"peer covers the same lines as this widget; standard text options, including " +"*startline* and *endline*, may be given to override this." +msgstr "" + +msgid "" +"Return a tuple of the path names of this widget's peers, not including the " +"widget itself." +msgstr "" + +msgid "" +"Adjust the view so that the location given by *what* is visible. This is an " +"obsolete equivalent of :meth:`see`, which should be used instead." +msgstr "" + +msgid "Variable classes" +msgstr "" + +msgid "" +"The base class for the Tk variable wrappers. A Tk variable is a value stored " +"in the Tcl interpreter that can be linked to widgets through their " +"*variable* or *textvariable* options (see :ref:`coupling-widget-variables`), " +"so that changes propagate both ways: updating the variable updates every " +"widget bound to it, and a user editing such a widget updates the variable." +msgstr "" + +msgid "" +"*master* is the widget whose Tcl interpreter owns the variable; if omitted, " +"the default root window is used. *value* is the initial value; if omitted, a " +"type-specific default is used. *name* is the name of the variable in the Tcl " +"interpreter; if omitted, a unique name of the form ``'PY_VARnum'`` is " +"generated. If *name* matches an existing variable and *value* is omitted, " +"the existing value is retained." +msgstr "" + +msgid "" +"In most cases you should use one of the typed subclasses below " +"-- :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar` " +"or :class:`BooleanVar` -- rather than :class:`!Variable` directly." +msgstr "" + +msgid "" +"When a :class:`!Variable` is garbage collected, its Tcl variable is unset. " +"Keep a reference to it for as long as a widget is linked to it, for example " +"by storing it as an attribute rather than in a local variable. Otherwise Tk " +"recreates the Tcl variable to keep the widget working, but it is never unset " +"again, leaking one Tcl variable per dropped wrapper." +msgstr "" + +msgid "" +"Two variables now compare equal (``==``) only when they have the same name, " +"are of the same class, and belong to the same Tcl interpreter." +msgstr "" + +msgid "" +"Return the current value of the variable. For the base class the value is " +"returned as a string; the typed subclasses convert it to the appropriate " +"Python type." +msgstr "" + +msgid "" +"Set the variable to *value*. :meth:`initialize` is an alias of :meth:`!set`." +msgstr "" + +msgid "The *initialize* spelling." +msgstr "" + +msgid "" +"Register *callback* to be called when the variable is accessed according to " +"*mode*. *mode* is one of the strings ``'array'``, ``'read'``, ``'write'`` or " +"``'unset'``, or a list or tuple of such strings." +msgstr "" + +msgid "" +"When triggered, *callback* is called with three arguments: the name of the " +"Tcl variable, an index (or an empty string if the variable is not an element " +"of an array), and the *mode* that triggered the call." +msgstr "" + +msgid "" +"Return the internal name of the registered callback, which can be passed " +"to :meth:`trace_remove`." +msgstr "" + +msgid "" +"Remove a trace callback from the variable. *mode* must match the *mode* that " +"was passed to :meth:`trace_add`, and *cbname* is the callback name returned " +"by :meth:`trace_add`." +msgstr "" + +msgid "" +"Return a list of ``(modes, cbname)`` pairs describing all traces currently " +"set on the variable, where *modes* is a tuple of mode strings and *cbname* " +"is the internal callback name." +msgstr "" + +msgid "" +"Register *callback* to be called when the variable is accessed according to " +"*mode*. *mode* is one of the strings ``'r'``, ``'w'`` or ``'u'``, for read, " +"write or unset. Return the internal name of the registered " +"callback. :meth:`trace` is an alias of :meth:`!trace_variable`." +msgstr "" + +msgid "" +"Use :meth:`trace_add` instead. This method wraps a Tcl feature that was " +"removed in Tcl 9.0." +msgstr "" + +msgid "" +"Remove the trace callback named *cbname* registered for *mode* " +"with :meth:`trace_variable`." +msgstr "" + +msgid "" +"Use :meth:`trace_remove` instead. This method wraps a Tcl feature that was " +"removed in Tcl 9.0." +msgstr "" + +msgid "" +"Return a list of ``(mode, cbname)`` pairs for all traces set on the variable " +"with :meth:`trace_variable`." +msgstr "" + +msgid "" +"Use :meth:`trace_info` instead. This method wraps a Tcl feature that was " +"removed in Tcl 9.0." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds a string. The default value is " +"``''``." +msgstr "" + +msgid "Return the value of the variable as a :class:`str`." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds an integer. The default value is " +"``0``." +msgstr "" + +msgid "Return the value of the variable as an :class:`int`." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds a float. The default value is " +"``0.0``." +msgstr "" + +msgid "Return the value of the variable as a :class:`float`." +msgstr "" + +msgid "" +"A floating-point value is always parsed with a period (``.``) as the decimal " +"separator, but :class:`Spinbox`, :class:`Scale` and :class:`ttk.Spinbox " +"` format it according to the ``LC_NUMERIC`` locale. " +"Under a locale that uses a comma they produce a value that :meth:`get` " +"cannot read, raising :exc:`TclError`. Set ``LC_NUMERIC`` to a locale that " +"uses a period (such as ``'C'``) to avoid this." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds a boolean. The default value is " +"``False``." +msgstr "" + +msgid "" +"Return the value of the variable as a :class:`bool`. Raise " +"a :exc:`ValueError` if the value cannot be interpreted as a boolean." +msgstr "" + +msgid "" +"Set the variable to *value*, converting it to a boolean. :meth:`initialize` " +"is an alias of :meth:`!set`." +msgstr "" + +msgid "Image classes" +msgstr "" + +msgid "" +"Base class for Tk images. *imgtype* is the Tk image type, one of ``'photo'`` " +"or ``'bitmap'``. An image is a named object that can be displayed by widgets " +"through their *image* option; deleting all references to the :class:`!Image` " +"object deletes the underlying Tk image. Usually you create " +"a :class:`PhotoImage` or :class:`BitmapImage` rather than an :class:`!Image` " +"directly." +msgstr "" + +msgid "" +"The image's configuration options are given by *cnf* and *kw* and may be " +"queried and changed later with the mapping protocol (using ``image[key]``) " +"or with the :meth:`configure` method." +msgstr "" + +msgid "" +"Modify one or more configuration options of the image. The valid options " +"depend on the image type; see :class:`PhotoImage` " +"and :class:`BitmapImage`. :meth:`config` is an alias of :meth:`!configure`." +msgstr "" + +msgid "Return the height of the image, in pixels." +msgstr "" + +msgid "Return the width of the image, in pixels." +msgstr "" + +msgid "" +"Return the type of the image, that is the value of *imgtype* with which it " +"was created (for example ``'photo'`` or ``'bitmap'``)." +msgstr "" + +msgid "" +"A full-color image (the Tk ``photo`` image type), stored internally with a " +"varying degree of transparency per pixel. It can read and write GIF, PPM/PGM " +"and (in Tk 8.6 and later) PNG files, read SVG files (in Tk 9.0 and later), " +"and be drawn in widgets. Inherits from :class:`Image`." +msgstr "" + +msgid "" +"The configuration options include *data* (the image contents as a string), " +"*file* (the name of a file to read the contents from), *format* (the name of " +"the file format handler), *width* and *height* (the size of the image, used " +"when building it up piece by piece), *gamma* and *palette*." +msgstr "" + +msgid "" +"Blank the image; that is, set the entire image to have no data, so that it " +"is displayed as transparent and the background of whatever window it is " +"displayed in shows through." +msgstr "" + +msgid "Return the current value of the configuration option *option*." +msgstr "" + +msgid "Return a new :class:`PhotoImage` with a copy of this image." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular sub-region of the source image to be " +"copied. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, " +"y2)``. ``(x1, y1)`` and ``(x2, y2)`` specify diagonally opposite corners of " +"the rectangle. If *x2* and *y2* are not specified, they default to the " +"bottom-right corner of the source image. The pixels copied include the left " +"and top edges of the rectangle but not the bottom or right edges. If " +"*from_coords* is not given, the whole source image is copied." +msgstr "" + +msgid "" +"If *zoom* or *subsample* are specified, the image is transformed as in " +"the :meth:`zoom` or :meth:`subsample` methods. The value must be a single " +"integer or a pair of integers." +msgstr "" + +msgid "Added the *from_coords*, *zoom* and *subsample* parameters." +msgstr "" + +msgid "" +"Copy a region from *sourceImage* (which must be a :class:`PhotoImage`) into " +"this image, possibly with pixel zooming and/or subsampling. If no options " +"are specified, the whole of *sourceImage* is copied into this image, " +"starting at coordinates ``(0, 0)``." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular sub-region of the source image to be " +"copied, as in the :meth:`copy` method." +msgstr "" + +msgid "" +"*to* specifies a rectangular sub-region of the destination image to be " +"affected. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, " +"y2)``. If *x2* and *y2* are not specified, they default to ``(x1, y1)`` plus " +"the size of the source region (after subsampling and zooming, if specified). " +"If *x2* and *y2* are specified, the source region is replicated if necessary " +"to fill the destination region in a tiled fashion." +msgstr "" + +msgid "" +"If *shrink* is true, the size of the destination image is reduced, if " +"necessary, so that the region being copied into is at the bottom-right " +"corner of the image." +msgstr "" + +msgid "" +"*compositingrule* specifies how transparent pixels in the source image are " +"combined with the destination image. With ``'overlay'`` (the default), the " +"old contents of the destination image remain visible, as if the source image " +"were printed on a piece of transparent film and placed over the top of the " +"destination. With ``'set'``, the old contents of the destination image are " +"discarded and the source image is used as-is." +msgstr "" + +msgid "Return the image data." +msgstr "" + +msgid "" +"*format* specifies the name of the image file format handler to use. If it " +"is not given, the data is returned as a tuple (one element per row) of " +"strings containing space-separated (one element per pixel/column) colors in " +"``#RRGGBB`` format." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular region of the image to be returned. It " +"must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only " +"*x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the " +"bottom-right corner of the image. If all four coordinates are given, they " +"specify diagonally opposite corners of the region, including ``(x1, y1)`` " +"and excluding ``(x2, y2)``. If *from_coords* is not given, the whole image " +"is returned." +msgstr "" + +msgid "" +"If *background* is specified, the data does not contain any transparency " +"information; in all transparent pixels the color is replaced by the " +"specified color." +msgstr "" + +msgid "" +"If *grayscale* is true, the data does not contain color information; all " +"pixel data is transformed into grayscale." +msgstr "" + +msgid "" +"Return the color of the pixel at coordinates (*x*, *y*) as an ``(r, g, b)`` " +"tuple of three integers between 0 and 255, representing the red, green and " +"blue components respectively." +msgstr "" + +msgid "" +"Set pixels of the image to the colors given in *data*, which must be a " +"string or a nested sequence of horizontal rows of pixel colors (for example " +"``\"{red green} {blue yellow}\"``)." +msgstr "" + +msgid "" +"*to* specifies the coordinates of the region of the image into which the " +"data are copied. It must be a tuple or a list of 2 or 4 integers ``(x1, " +"y1)`` or ``(x1, y1, x2, y2)`` giving the top-left corner, and optionally the " +"bottom-right corner, of the region. The default position is ``(0, 0)``." +msgstr "" + +msgid "Read image data from the file named *filename* into the image." +msgstr "" + +msgid "*format* specifies the format of the image data in the file." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular sub-region of the image file data to " +"be copied to the destination image. It must be a tuple or a list of 1 to 4 " +"integers ``(x1, y1, x2, y2)``. If only *x1* and *y1* are specified, the " +"region extends from ``(x1, y1)`` to the bottom-right corner of the image in " +"the file. If all four coordinates are given, they specify diagonally " +"opposite corners of the region. If *from_coords* is not given, the whole of " +"the image in the file is read." +msgstr "" + +msgid "" +"*to* specifies the coordinates of the top-left corner of the region of the " +"image into which the data are read. The default is ``(0, 0)``." +msgstr "" + +msgid "" +"If *shrink* is true, the size of the image is reduced, if necessary, so that " +"the region into which the file data are read is at the bottom-right corner " +"of the image." +msgstr "" + +msgid "" +"Return a new :class:`PhotoImage` based on this image but using only every " +"*x*-th pixel in the X direction and every *y*-th pixel in the Y direction. " +"If *y* is not given, it defaults to the same value as *x*." +msgstr "" + +msgid "Added the *from_coords* parameter." +msgstr "" + +msgid "" +"Return ``True`` if the pixel at coordinates (*x*, *y*) is fully transparent, " +"``False`` otherwise." +msgstr "" + +msgid "" +"Make the pixel at coordinates (*x*, *y*) fully transparent if *boolean* is " +"true, fully opaque otherwise." +msgstr "" + +msgid "Write image data from the image to the file named *filename*." +msgstr "" + +msgid "" +"*format* specifies the name of the image file format handler to use. If it " +"is not given, the format is guessed from the file extension." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular region of the image to be written. It " +"must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only " +"*x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the " +"bottom-right corner of the image. If all four coordinates are given, they " +"specify diagonally opposite corners of the region. If *from_coords* is not " +"given, the whole image is written." +msgstr "" + +msgid "Added the *background* and *grayscale* parameters." +msgstr "" + +msgid "" +"Return a new :class:`PhotoImage` with this image magnified by a factor of " +"*x* in the X direction and *y* in the Y direction. If *y* is not given, it " +"defaults to the same value as *x*." +msgstr "" + +msgid "" +"A two-color image (the Tk ``bitmap`` image type) created from an X11 bitmap. " +"Each pixel displays a foreground color, a background color, or nothing " +"(producing a transparent effect). Inherits from :class:`Image`." +msgstr "" + +msgid "" +"The configuration options are *data* or *file* (the source bitmap, given as " +"a string in X11 bitmap format or as the name of a file in that format), " +"*maskdata* or *maskfile* (the mask bitmap, in the same forms), and " +"*foreground* and *background* (the two colors). For pixels where the mask is " +"zero the image displays nothing; for other pixels it displays the foreground " +"color where the source is one and the background color where the source is " +"zero. If *background* is set to an empty string, the background pixels are " +"transparent." +msgstr "" + +msgid "" +":class:`!BitmapImage` has no methods of its own beyond those inherited " +"from :class:`Image`." +msgstr "" + +msgid "Other classes" +msgstr "" + +msgid "" +"A container for the attributes of an event passed to a callback bound " +"with :meth:`Misc.bind`. An :class:`!Event` instance has the following " +"attributes, each corresponding to a field of the underlying Tk event; " +"depending on the event type, some attributes may be set to the string " +"``'??'`` to indicate that they are not meaningful. See :ref:`bindings-and-" +"events`." +msgstr "" + +msgid "The serial number of the event." +msgstr "" + +msgid "The mouse button that was pressed or released (for button events)." +msgstr "" + +msgid "Whether the window has the focus (for ``Enter`` and ``Leave`` events)." +msgstr "" + +msgid "" +"The new height and width of the window (for ``Configure`` and ``Expose`` " +"events)." +msgstr "" + +msgid "The keycode of the key that was pressed or released." +msgstr "" + +msgid "" +"The state of the event, as a number (for most events) or a string (for " +"``Visibility`` events)." +msgstr "" + +msgid "The timestamp of the event, in milliseconds." +msgstr "" + +msgid "The pointer position relative to the widget, in pixels." +msgstr "" + +msgid "" +"The pointer position relative to the top-left corner of the screen, in " +"pixels." +msgstr "" + +msgid "The character typed, as a string (for key events)." +msgstr "" + +msgid "``True`` if the event was sent by another application." +msgstr "" + +msgid "The symbolic name of the key that was pressed or released." +msgstr "" + +msgid "The numeric value of :attr:`keysym`." +msgstr "" + +msgid "The :class:`EventType` of the event." +msgstr "" + +msgid "The widget on which the event occurred." +msgstr "" + +msgid "The amount the mouse wheel was rotated (for ``MouseWheel`` events)." +msgstr "" + +msgid "" +"An :class:`enum.StrEnum` enumerating the Tk event types, used as the value " +"of :attr:`Event.type`. Its members include, among others, ``KeyPress``, " +"``KeyRelease``, ``ButtonPress``, ``ButtonRelease``, ``Motion``, ``Enter``, " +"``Leave``, ``FocusIn``, ``FocusOut``, ``Configure``, ``Map``, ``Unmap``, " +"``Expose``, ``Destroy`` and ``MouseWheel``." +msgstr "" + +msgid "" +"Internal helper that wraps a Python callback so that it can be invoked from " +"Tcl. *func* is the Python function, *subst* is an optional function that pre-" +"processes the Tcl arguments, and *widget* is the widget used for error " +"reporting. Instances are created automatically by :meth:`Misc.register`; " +"this class is not normally used directly." +msgstr "" + +msgid "Module-level functions" +msgstr "" + +msgid "" +"The :func:`Tcl` function is a factory function which creates an object much " +"like that created by the :class:`Tk` class, except that it does not " +"initialize the Tk subsystem. This is most often useful when driving the Tcl " +"interpreter in an environment where one doesn't want to create extraneous " +"toplevel windows, or where one cannot (such as Unix/Linux systems without an " +"X server). An object created by the :func:`Tcl` object can have a Toplevel " +"window created (and the Tk subsystem initialized) by calling " +"its :meth:`~Tk.loadtk` method." +msgstr "" + +msgid "" +"Inhibit the creation of an implicit default root window. Afterwards :mod:`!" +"tkinter` no longer creates a shared default root automatically, and " +"operations that rely on one --- such as constructing a widget without an " +"explicit *master* --- raise a :exc:`RuntimeError`. Call this early in larger " +"applications to make the root window explicit." +msgstr "" + +msgid "" +"Run the Tk main event loop on the default root window until all windows are " +"destroyed. Equivalent to calling :meth:`Misc.mainloop` on the default root." +msgstr "" + +msgid "" +"Convert the Tcl boolean string *s* (one of ``'1'``, ``'true'``, ``'yes'``, " +"``'on'`` and similar, or their false counterparts) to a " +"Python :class:`bool`. Raise :exc:`ValueError` for an invalid value." +msgstr "" + +msgid "" +"Convert *s* to a floating-point number. This is the built-in :class:`float`." +msgstr "" + +msgid "Convert *s* to an integer. This is the built-in :class:`int`." +msgstr "" + +msgid "" +"Return the names of all existing images in the default root's interpreter." +msgstr "" + +msgid "" +"Return the available image types (such as ``'photo'`` and ``'bitmap'``) in " +"the default root's interpreter." +msgstr "" + +msgid "File handlers" +msgstr "" + +msgid "" +"Tk allows you to register and unregister a callback function which will be " +"called from the Tk mainloop when I/O is possible on a file descriptor. Only " +"one handler may be registered per file descriptor. Example code::" +msgstr "" + +msgid "" +"import tkinter\n" +"widget = tkinter.Tk()\n" +"mask = tkinter.READABLE | tkinter.WRITABLE\n" +"widget.tk.createfilehandler(file, mask, callback)\n" +"...\n" +"widget.tk.deletefilehandler(file)" +msgstr "" + +msgid "This feature is not available on Windows." +msgstr "" + +msgid "" +"Since you don't know how many bytes are available for reading, you may not " +"want to use the :class:`~io.BufferedIOBase` " +"or :class:`~io.TextIOBase` :meth:`~io.BufferedIOBase.read` " +"or :meth:`~io.IOBase.readline` methods, since these will insist on reading a " +"predefined number of bytes. For sockets, the :meth:`~socket.socket.recv` " +"or :meth:`~socket.socket.recvfrom` methods will work fine; for other files, " +"use raw reads or ``os.read(file.fileno(), maxbytecount)``." +msgstr "" + +msgid "" +"Registers the file handler callback function *func*. The *file* argument may " +"either be an object with a :meth:`~io.IOBase.fileno` method (such as a file " +"or socket object), or an integer file descriptor. The *mask* argument is an " +"ORed combination of any of the three constants below. The callback is called " +"as follows::" +msgstr "" + +msgid "callback(file, mask)" +msgstr "" + +msgid "Unregisters a file handler." +msgstr "" + +msgid "Constants used in the *mask* arguments." +msgstr "" + +msgid "Constants" +msgstr "Stały" + +msgid "" +"The following symbolic constants are available in both the :mod:`!tkinter` " +"and :mod:`!tkinter.constants` namespaces." +msgstr "" + +msgid "Truthy values, all equal to the integer ``1``." +msgstr "" + +msgid "Falsy values, all equal to the integer ``0``." +msgstr "" + +msgid "" +"Compass directions (``'n'``, ``'s'``, ``'e'``, ``'w'`` and the diagonals and " +"edges) plus ``CENTER`` (``'center'``), used as values for the *anchor* and " +"*sticky* options and by methods such as :meth:`Misc.grid_anchor`." +msgstr "" + +msgid "" +"Sides for the *side* option of the packer (see :meth:`Pack.pack_configure`)." +msgstr "" + +msgid "" +"Values for the *fill* option of the packer: ``'x'``, ``'y'``, ``'both'`` or " +"``'none'``." +msgstr "" + +msgid "Values for the *relief* option, which controls a widget's 3-D border." +msgstr "" + +msgid "" +"Values for the *orient* option of widgets such " +"as :class:`Scale`, :class:`Scrollbar` and :class:`PanedWindow`." +msgstr "" + +msgid "" +"Values for the *wrap* option of the :class:`Text` widget, selecting line " +"wrapping on character or word boundaries." +msgstr "" + +msgid "The text-alignment value ``'baseline'``." +msgstr "" + +msgid "" +"Values for the *bordermode* option of the placer " +"(see :meth:`Place.place_configure`)." +msgstr "" + +msgid "" +"Symbolic indices used by the :class:`Text`, :class:`Entry`, :class:`Listbox` " +"and :class:`Canvas` widgets, such as ``'insert'`` (the insertion cursor), " +"``'current'``, ``'end'``, ``'anchor'`` and the bounds of the selection " +"(``'sel.first'`` and ``'sel.last'``)." +msgstr "" + +msgid "" +"The special tag ``'all'``, which matches every item of a :class:`Canvas` or " +"every character of a :class:`Text` (for example ``canvas.delete(ALL)``)." +msgstr "" + +msgid "Values for the *state* option of various widgets and items." +msgstr "" + +msgid "" +"Menu entry types, used as the *itemType* argument of :meth:`Menu.add` " +"and :meth:`Menu.insert`." +msgstr "" + +msgid "Values for the *selectmode* option of the :class:`Listbox` widget." +msgstr "" + +msgid "Values for the *style* option of :class:`Canvas` arc items." +msgstr "" + +msgid "" +"Values for the *capstyle* (``'butt'``, ``'projecting'``, ``'round'``) and " +"*joinstyle* (``'round'``, ``'bevel'``, ``'miter'``) options " +"of :class:`Canvas` line items." +msgstr "" + +msgid "" +"Values for the *arrow* option of :class:`Canvas` line items, indicating " +"which ends have arrowheads." +msgstr "" + +msgid "" +"The first argument passed by a :class:`Scrollbar` to the :meth:`XView.xview` " +"or :meth:`YView.yview` method of the scrolled widget." +msgstr "" + +msgid "" +"Values for the *what* argument of :meth:`XView.xview_scroll` " +"and :meth:`YView.yview_scroll`." +msgstr "" + +msgid "Other option values: ``'underline'``, ``'numeric'`` and ``'dotbox'``." +msgstr "" + +msgid "geometry management (widgets)" +msgstr "" + +msgid "packing (widgets)" +msgstr "" + +msgid "window manager (widgets)" +msgstr "" + +msgid "Tk Option Data Types" msgstr "" msgid "bind (widgets)" diff --git a/library/tkinter.scrolledtext.po b/library/tkinter.scrolledtext.po index 8a7e82d999..9c626017f6 100644 --- a/library/tkinter.scrolledtext.po +++ b/library/tkinter.scrolledtext.po @@ -39,9 +39,9 @@ msgstr "" msgid "" "The text widget and scrollbar are packed together in a :class:`Frame`, and " "the methods of the :class:`Grid` and :class:`Pack` geometry managers are " -"acquired from the :class:`Frame` object. This allows the :class:" -"`ScrolledText` widget to be used directly to achieve most normal geometry " -"management behavior." +"acquired from the :class:`Frame` object. This allows " +"the :class:`ScrolledText` widget to be used directly to achieve most normal " +"geometry management behavior." msgstr "" msgid "" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po index 86337cd7e7..b02ee16168 100644 --- a/library/tkinter.ttk.po +++ b/library/tkinter.ttk.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# python-doc bot, 2025 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-04-27 15:43+0000\n" -"PO-Revision-Date: 2025-09-16 00:01+0000\n" -"Last-Translator: python-doc bot, 2025\n" +"POT-Creation-Date: 2026-10-25 18:12+0000\n" +"PO-Revision-Date: 2026-05-08 17:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,9 +31,9 @@ msgstr "**Kod źródłowy:** :source:`Lib/tkinter/ttk.py`" msgid "" "The :mod:`!tkinter.ttk` module provides access to the Tk themed widget set, " -"introduced in Tk 8.5. It provides additional benefits including anti-aliased " -"font rendering under X11 and window transparency (requiring a composition " -"window manager on X11)." +"introduced in Tk 8.5. Its widgets adapt their appearance to the platform's " +"native theme, giving an application a better and more consistent look and " +"feel than the classic :mod:`tkinter` widgets, whose appearance is fixed." msgstr "" msgid "" @@ -43,10 +43,19 @@ msgid "" msgstr "" msgid "" -"`Tk Widget Styling Support `_" +"Ttk widgets are used just like the classic :mod:`tkinter` widgets and share " +"the same machinery: the widget hierarchy, the geometry managers, variable " +"coupling and event binding. Those foundational concepts are covered in " +"the :mod:`tkinter` documentation and are not repeated here." msgstr "" -msgid "A document introducing theming support for Tk" +msgid "" +"`Tk Widget Styling Support (TIP #48) `_" +msgstr "" + +msgid "" +"The Tcl Improvement Proposal that introduced the themed widget styling " +"engine." msgstr "" msgid "Using Ttk" @@ -68,43 +77,36 @@ msgid "" msgstr "" msgid "" -"That code causes several :mod:`!tkinter.ttk` widgets (:class:`Button`, :" -"class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, :class:" -"`LabelFrame`, :class:`Menubutton`, :class:`PanedWindow`, :class:" -"`Radiobutton`, :class:`Scale` and :class:`Scrollbar`) to automatically " -"replace the Tk widgets." +"That code causes several :mod:`!tkinter.ttk` widgets " +"(:class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, :class:`LabelFrame`, :class:`Menubutton`, :class:`OptionMenu`, :class:`PanedWindow`, :class:`Radiobutton`, :class:`Scale`, :class:`Scrollbar` " +"and :class:`Spinbox`) to automatically replace the Tk widgets." +msgstr "" + +msgid "" +"Overriding the classic widgets with ``from tkinter.ttk import *`` is " +"convenient for adapting existing code, but new code is usually clearer if it " +"imports the module as ``from tkinter import ttk`` and refers to the themed " +"widgets explicitly, such as ``ttk.Button``." msgstr "" msgid "" "This has the direct benefit of using the new widgets which gives a better " "look and feel across platforms; however, the replacement widgets are not " "completely compatible. The main difference is that widget options such as " -"\"fg\", \"bg\" and others related to widget styling are no longer present in " -"Ttk widgets. Instead, use the :class:`ttk.Style` class for improved " +"``fg``, ``bg`` and others related to widget styling are no longer present in " +"Ttk widgets. Instead, use the :class:`ttk.Style